Skill: ivy-ting/southeast-asia-arrival-card (version 1.0.4)

--- name: southeast-asia-arrival-card description: 全球出行助手。帮助中国护照持有者完成全球各国出行手续，包括签证申请（申根签、电子签证、落地签、贴纸签）、入境卡填写（QR码、电子申报）、免签政策查询。能判断所需手续类型，提供最新官方数据（多源验证）、详细操作文档，并对可自动化流程提供 agent-browser 执行。当用户提到"入境卡"、"签证"、"申根签"、"出行手续"、"去XX国家需要什么"、"免签"、"落地签"、"电子签"时使用。 --- # 🌍 全球出行助手 帮助用户快速完成全球各国出行手续。数据优先来自官方大使馆网站，支持多源验证。 ## 💬 回复风格 - 友好鼓励，消除焦虑，避免冷冰冰的官方语气 - 结构清晰，使用标题、表格、emoji 增强可读性 - 每个字段提供说明和示例，不只列字段名 - 用 ⚠️ 标记重要提醒，粗体突出关键信息 - 提供保存凭证、自助通关等贴心提示 ## 🔍 工作流程 ### Step 0：智能文档识别（可选） 用户上传护照/机票/酒店订单图片时自动触发，使用 `read_image` 提取信息。 详细说明：[#reference:reference/smart-document-recognition.md] ### Step 1：出行类型判断（必须） **先判断中国护照前往该国需要什么手续**，再给出对应操作路径： | 判断结果 | 下一步操作 | |---------|----------| | 免签 | 查询入境卡要求，给填写指南 | | 落地签 | 说明落地签流程 + 入境卡要求 | | 电子签证（e-Visa） | 提供在线申请操作文档 | | 贴纸签证（大使馆） | 给材料清单 + 线下办理建议 | | 申根签证 | 调用申根签专项指南 | 搜索方式：`web_search "{国家名} 中国护照 免签 签证 2026"` ### Step 2：提供材料清单 根据目的地和手续类型，提供材料清单。 通用清单参考：[#reference:reference/materials-checklist.md] ### Step 3：询问需要什么帮助 - **A：详细填写指南** — 逐步操作说明 - **B：自动化执行** — 调用 agent-browser 实际填写（仅限在线入境卡） - **C：解答问题** — 针对具体问题解答 - **D：国家对比** — 多国游办理顺序建议 ### Step 4：执行对应服务 ## 📚 预置指南 ### 亚洲入境卡（8国） | 国家 | 入境卡 | 官网 | 时间限制 | |------|--------|------|---------| | 🇲🇾 马来西亚 | MDAC | https://imigresen-online.imi.gov.my/mdac/main | 无 | | 🇹🇭 泰国 | TDAC | https://extranet.immigration.go.th/fn/TM6/ | 无 | | 🇸🇬 新加坡 | SG Arrival Card | https://eservices.ica.gov.sg/sgarrivalcard/ | 入境前3天内 | | 🇮🇩 印尼 | All Indonesia | https://allindonesia.imigrasi.go.id/ | 入境前3天内 | | 🇻🇳 越南 | 入境申报表 | https://dichvucong.bocongan.gov.vn/ | 无 | | 🇵🇭 菲律宾 | eTravel | https://etravel.gov.ph/ | 出发前72小时内 | | 🇯🇵 日本 | Visit Japan Web | https://www.vjw.digital.go.jp/ | 建议提前1-2周 | | 🇰🇷 韩国 | K-ETA + e-Arrival | https://www.k-eta.go.kr/ | K-ETA提前72小时 | 详细指南： - 🇲🇾🇹🇭🇸🇬：[#reference:reference/country-guides.md] - 🇮🇩：[#reference:reference/indonesia-guide.md] - 🇻🇳：[#reference:reference/vietnam-guide.md] - 🇵🇭：[#reference:reference/philippines-guide.md] - 🇯🇵：[#reference:reference/japan-guide.md] - 🇰🇷：[#reference:reference/korea-guide.md] ### 欧美签证（5个国家/地区） | 国家/地区 | 类型 | 中国护照 | 指南 | |----------|------|---------|------| | 🇪🇺 申根区（27国） | 申根签证 | ❌ 需签证 | [#reference:reference/schengen-guide.md] | | 🇺🇸 美国 | B1/B2签证 | ❌ 需签证 | [#reference:reference/major-countries-guide.md] | | 🇬🇧 英国 | 标准访客签证 | ❌ 需签证 | [#reference:reference/major-countries-guide.md] | | 🇦🇺 澳大利亚 | 旅游签证600 | ❌ 需签证 | [#reference:reference/major-countries-guide.md] | | 🇨🇦 加拿大 | TRV签证 | ❌ 需签证 | [#reference:reference/major-countries-guide.md] | ### 其他国家（多源验证动态查询） 使用 **web_search** 至少查询 3 个来源（P0：大使馆官网 > P1：中国驻外使馆 > P2：权威平台），标注查询日期和来源。 ## 🤖 自动化执行 ### 可操作性分类 | 手续类型 | 可操作性 | AI 操作 | |---------|---------|--------| | 在线入境卡（MDAC、eTravel等） | 🤖 可自动化 | agent-browser 实际执行 | | 电子签证（在线申请） | 📝 可辅助 | 逐步操作文档 | | 大使馆签证（申根、美签等） | 🏢 必须线下 | 材料清单 + 时间规划 | ### 马来西亚 MDAC 自动化 触发条件：用户说"帮我填写马来西亚入境卡"或"自动填写 MDAC" 执行前确认用户已提供：护照号、姓名、出生日期、邮箱、入境日期、航班号、马来西亚地址 ```bash agent-browser open https://imigresen-online.imi.gov.my/mdac/main agent-browser wait --load networkidle && agent-browser snapshot -i # 点击注册 → 填写表单 → 提交 → 截图确认 ``` 专项 Skill：taoyou-hyt--arrival-card-automation 详细框架：[#reference:reference/automation-framework.md] ## 📋 通用注意事项 [#reference:reference/common-notes.md] | [#reference:reference/faq.md] | [#reference:reference/country-comparison.md] - ⚠️ 姓名使用护照英文拼音，全大写 - ⚠️ 邮箱必须真实有效（部分国家发送确认邮件） - ⚠️ 所有信息必须与护照完全一致 - ⚠️ 注意各国时间限制（新加坡3天内、菲律宾72小时内） - ⚠️ 签证政策随时变化，以官方大使馆网站为准 祝您旅途愉快！🌏✈️

path: README.md
content: # 🌍 全球出行助手

一个专业的 OpenClaw Skill，帮助用户快速、准确地完成**全球各国**的出行手续，包括签证申请、入境卡填写、免签政策查询等。数据来源优先使用官方大使馆网站，支持多源验证确保信息准确。

## 📚 支持范围

### 🤖 可自动化执行（在线入境卡）

| 国家 | 入境卡类型 | 自动化方式 | 费用 |
|------|-----------|----------|------|
| 🇲🇾 马来西亚 | MDAC 数字入境卡 | agent-browser 自动填写 | 免费 |
| 🇵🇭 菲律宾 | eTravel | agent-browser 自动填写 | 免费 |
| 🇸🇬 新加坡 | SG Arrival Card | agent-browser 自动填写 | 免费 |
| 🇮🇩 印尼 | All Indonesia | agent-browser 自动填写 | 免费 |
| 🇹🇭 泰国 | TDAC 电子入境卡 | agent-browser 自动填写 | 免费 |
| 🇻🇳 越南 | 入境申报表 | agent-browser 辅助填写 | 免费 |
| 🇯🇵 日本 | Visit Japan Web | 部分自动化 | 免费 |
| 🇰🇷 韩国 | K-ETA + e-Arrival Card | 部分自动化 | K-ETA: 55元 |

### 🏢 预置详细指南（需线下办理的签证）

| 国家/地区 | 签证类型 | 中国护照政策 | 指南 |
|----------|---------|------------|------|
| 🇪🇺 申根区（27国） | 申根签证（C类） | ❌ 需要签证 | [schengen-guide.md](reference/schengen-guide.md) |
| 🇺🇸 美国 | B1/B2 旅游商务签证 | ❌ 需要签证 | [major-countries-guide.md](reference/major-countries-guide.md) |
| 🇬🇧 英国 | 标准访客签证 | ❌ 需要签证 | [major-countries-guide.md](reference/major-countries-guide.md) |
| 🇦🇺 澳大利亚 | 旅游签证 subclass 600 | ❌ 需要签证 | [major-countries-guide.md](reference/major-countries-guide.md) |
| 🇨🇦 加拿大 | 临时居民签证 TRV | ❌ 需要签证 | [major-countries-guide.md](reference/major-countries-guide.md) |

### 🌐 全球其他国家（多源验证动态查询）

对于不在上述预置指南中的任何国家，本 Skill 支持**多源验证动态查询**：
- 优先查询目标国大使馆官网（P0来源）
- 交叉验证至少 3 个来源
- 标注信息查询日期和置信度
- 自动判断签证类型并给出对应操作路径

## 🌟 核心功能

### 1. 🔍 出行类型智能判断

自动判断中国护照持有者前往目标国需要什么手续：
- **免签**：直接查询入境卡要求
- **落地签**：说明落地签流程 + 入境卡要求
- **电子签证**：提供在线申请操作文档
- **贴纸签证/大使馆签证**：提供材料清单 + 线下办理建议
- **申根签证**：参考申根签专项指南

### 2. 🤖 自动化执行

对于可自动化的在线入境卡，使用 `agent-browser` 实际执行：
- 自动打开官方网站
- 自动填写表单字段
- 截图确认每个步骤
- 提交并保存确认信息

### 3. 📸 智能文档识别

支持自动识别和提取以下文档信息：
- 📘 **护照识别**：自动识别护照信息页和 MRZ 区域
- ✈️ **机票识别**：提取航班号、日期、出发地、目的地等信息
- 🏨 **酒店订单识别**：提取酒店名称、地址、入住日期等信息

### 4. 📊 多源数据验证

- 优先使用大使馆官网（P0来源）
- 至少查询 3 个来源交叉验证
- 标注信息时效性和置信度
- 来源冲突时以官方为准并提示用户核实

### 5. 📋 详细操作文档

每个国家/手续类型的指南包含：
- 📋 材料清单（逐项说明要求）
- 🌐 官方入口（防钓鱼提示）
- 📝 详细操作步骤（带示例）
- ⚠️ 重要提醒和常见错误
- ❓ 常见问题解答
- 📞 官方联系方式

## 📁 项目结构

```
asia-arrival-card/
├── SKILL.md                          # 主 Skill 文档
├── README.md                         # 项目说明文档
└── reference/                        # 参考文档目录
    ├── country-guides.md             # 马来西亚、泰国、新加坡详细指南
    ├── indonesia-guide.md            # 印尼详细指南
    ├── vietnam-guide.md              # 越南详细指南
    ├── philippines-guide.md          # 菲律宾详细指南
    ├── japan-guide.md                # 日本详细指南
    ├── korea-guide.md                # 韩国详细指南
    ├── schengen-guide.md             # 申根签证完整指南（欧洲27国）⭐ 新增
    ├── major-countries-guide.md      # 美英澳加签证指南 ⭐ 新增
    ├── country-comparison.md         # 国家对比与选择建议
    ├── materials-checklist.md        # 材料清单
    ├── common-notes.md               # 通用注意事项
    ├── faq.md                        # 常见问题解答
    ├── automation-framework.md       # 自动化框架
    └── smart-document-recognition.md # 智能文档识别技术说明
```

## 🚀 快速开始

### 安装到 OpenClaw

1. 克隆本仓库到 OpenClaw skills 目录：

```bash
cd ~/.openclaw/workspace/skills/
git clone https://github.com/ivy-ting/asia-arrival-card.git
```

2. 验证安装：

```bash
openclaw skills info global-travel-assistant
```

### 使用示例

在钉钉中 @你的 OpenClaw 机器人：

```
@机器人 帮我自动填写马来西亚入境卡
@机器人 我要去法国旅游，需要办什么签证？
@机器人 去美国需要什么材料？
@机器人 我要去泰国，中国护照需要签证吗？
@机器人 马来西亚、新加坡、泰国三国游，应该按什么顺序办理？
```

## 📊 各国关键信息速查

### 亚洲入境卡（可自动化）

| 国家 | 时间限制 | 邮件验证 | 需要打印 | 办理难度 | 预计耗时 | 自动化 |
|------|---------|---------|---------|---------|---------|--------|
| 🇲🇾 马来西亚 | 无 | ✅ 需要 | ✅ 推荐 | ⭐⭐⭐ 中等 | 10-15分钟 | 🤖 可自动化 |
| 🇹🇭 泰国 | 无 | ❌ 不需要 | ⚠️ 可选 | ⭐⭐ 简单 | 5-10分钟 | 🤖 可自动化 |
| 🇸🇬 新加坡 | 入境前3天内 | ✅ 需要 | ❌ 不需要 | ⭐⭐ 简单 | 5-10分钟 | 🤖 可自动化 |
| 🇮🇩 印尼 | 入境前3天内 | ✅ 需要 | ✅ 推荐 | ⭐⭐⭐ 中等 | 10-15分钟 | 🤖 可自动化 |
| 🇻🇳 越南 | 无 | ❌ 不需要 | ⚠️ 可选 | ⭐⭐ 简单 | 5-10分钟 | 🤖 可自动化 |
| 🇵🇭 菲律宾 | 出发前72小时内 | ✅ 需要 | ✅ 推荐 | ⭐⭐⭐ 中等 | 10-15分钟 | 🤖 可自动化 |
| 🇯🇵 日本 | 建议提前1-2周 | ✅ 需要 | ✅ 推荐 | ⭐⭐⭐⭐ 较难 | 15-20分钟 | ⚠️ 部分 |
| 🇰🇷 韩国 | K-ETA需提前72小时 | ✅ 需要 | ✅ 推荐 | ⭐⭐⭐⭐ 较难 | 20-30分钟 | ⚠️ 部分 |

### 欧美主要签证（需线下办理）

| 国家/地区 | 签证费 | 处理时间 | 需要面试 | 难度 |
|----------|--------|---------|---------|------|
| 🇪🇺 申根区 | 90欧元 | 5-15工作日 | ❌ 无需 | ⭐⭐⭐⭐ 较难 |
| 🇺🇸 美国 | 185美元 | 面试后3-5天（等面试可能数月） | ✅ 必须 | ⭐⭐⭐⭐⭐ 最难 |
| 🇬🇧 英国 | 115英镑 | 约3周 | ❌ 无需 | ⭐⭐⭐⭐ 较难 |
| 🇦🇺 澳大利亚 | 190澳元 | 1-4周 | ❌ 无需 | ⭐⭐⭐ 中等 |
| 🇨🇦 加拿大 | 100加元 | 2-8周 | ❌ 无需 | ⭐⭐⭐ 中等 |

## 💡 特色功能

### 🤖 真正的自动化执行

不只是提供伪代码，而是使用 `agent-browser` 工具**实际执行**：
- 打开官方网站
- 自动填写所有表单字段
- 截图确认每个步骤
- 提交并保存确认信息

### 🔍 多源数据验证

- 优先查询大使馆官网（P0来源）
- 至少 3 个来源交叉验证
- 标注信息时效性
- 冲突时以官方为准

### 📸 智能文档识别

- 自动识别护照 MRZ 区域
- 提取机票航班信息
- 解析酒店订单详情
- 信息整合与一致性检查

## 🗺️ 当前功能状态

### ✅ 已实现功能

#### 1. 出行类型智能判断
用户说"我要去 XX 国家"，AI 自动判断中国护照需要什么手续：
- 免签 → 直接给入境卡填写指南
- 落地签 → 说明落地签流程 + 入境卡
- 电子签证 → 提供在线申请操作文档
- 贴纸签证/大使馆签证 → 给材料清单 + 线下办理建议
- 申根签证 → 调用专项申根签指南

#### 2. 预置详细指南（13个国家/地区）

| 类型 | 覆盖范围 |
|------|---------|
| 🤖 在线入境卡（含自动化指导） | 马来西亚、泰国、新加坡、印尼、越南、菲律宾、日本、韩国 |
| 🏢 签证详细指南 | 申根区（欧洲27国）、美国、英国、澳大利亚、加拿大 |

每份指南包含：官方网站、材料清单、详细步骤、时间规划、常见问题、官方联系方式。

#### 3. 多源数据验证策略
- 优先查询目标国大使馆官网（P0来源）
- 至少交叉验证 3 个来源
- 标注信息查询日期，提示政策时效性
- 来源冲突时以官方为准并提示用户核实

#### 4. 全球其他国家动态查询
对于不在预置指南中的任何国家，实时搜索并按统一格式返回：
- 签证政策（免签/落地签/电子签/贴纸签）
- 所需手续和材料
- 可操作性分类（能自动化/能辅助/必须线下）

#### 5. 智能文档识别
上传护照照片、机票截图、酒店订单，自动提取信息：
- 护照：识别 MRZ 机读区，提取姓名、护照号、有效期、国籍等
- 机票：提取航班号、日期、出发地、目的地、PNR
- 酒店：提取酒店名称、地址、入住/退房日期
- 多文档信息整合 + 一致性交叉验证

#### 6. 自动化执行框架（agent-browser）
对于可自动化的在线入境卡，提供完整的 agent-browser 执行指导：
- 打开官方网站并截图确认
- 逐字段填写表单
- 提交并截图保存确认结果
- 马来西亚 MDAC 有专项自动化 Skill（taoyou-hyt--arrival-card-automation）

---

### ⚠️ 当前限制

| 限制项 | 说明 |
|--------|------|
| 自动化未完整实测 | agent-browser 自动化流程已设计，但各国网站的实际 DOM 结构需要实测验证 |
| 无个人信息记忆 | 每次使用需重新输入护照信息，不支持跨会话保存 |
| 数据需手动更新 | 签证政策变化时需手动更新指南文档，暂无自动检测机制 |
| 预置指南覆盖有限 | 仅覆盖 13 个常用国家/地区，其他国家依赖动态查询 |

---

### 🔮 规划中功能

- **个人信息记忆**：加密保存护照信息，下次出行直接复用
- **行程规划联动**：输入多国行程，自动生成按时间排序的手续办理计划
- **签证状态追踪**：记录申请进度，主动提醒出结果时间
- **更多国家预置指南**：阿联酋、土耳其、俄罗斯、南非等热门目的地
- **数据自动更新**：定期检测大使馆官网政策变化，自动更新指南

---

## 📝 贡献指南

欢迎贡献！如果你想添加新的国家指南或改进现有内容：

1. Fork 本仓库
2. 创建你的特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交你的更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启一个 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 🙏 致谢

- 感谢所有贡献者
- 感谢 OpenClaw 团队提供的平台
- 感谢各国移民局提供的官方信息

## 📞 联系方式

如有问题或建议，请：
- 提交 Issue
- 发起 Pull Request
- 联系维护者

---

**祝您旅途愉快！** 🌏✈️


path: reference/common-notes.md
content: # 通用注意事项

## 填写前准备

### ✅ 必备材料
- 有效护照（有效期至少 6 个月）
- 往返机票或行程单
- 酒店预订确认单
- 有效邮箱地址
- 手机号码（部分国家需要）

### ✅ 信息准确性
- 所有信息必须与护照完全一致
- 姓名使用护照拼音，通常全大写
- 日期格式注意区分（DD/MM/YYYY 或 YYYY-MM-DD）
- 航班号格式：航空公司代码 + 数字

### ✅ 时间规划
- 提前了解目的地国家的时间限制
- 预留充足时间处理邮件验证
- 避免在出发前最后一刻填写

## 常见错误避免

### ❌ 错误 1：日期格式错误
- 不同国家要求不同，注意区分 DD/MM/YYYY 和 YYYY-MM-DD
- 护照有效期、出生日期、入境日期都要仔细核对

### ❌ 错误 2：姓名填写错误
- 姓和名的顺序要与护照一致
- 注意大小写要求（通常全大写）
- 不要包含中文字符

### ❌ 错误 3：邮箱填写错误
- 使用常用邮箱，避免使用临时邮箱
- 检查拼写，避免漏字母或多字母
- 及时查收邮件，包括垃圾邮件文件夹

### ❌ 错误 4：超过时间限制
- 新加坡必须在入境前 3 天内填写
- 菲律宾必须在出发前 72 小时内填写
- 过早或过晚填写都可能导致无效

### ❌ 错误 5：未保存确认信息
- 提交后务必保存确认邮件、QR 码或 PDF
- 建议同时保存电子版和打印纸质版
- 入境时可能需要出示

## 入境时注意事项

### 📋 需要携带的材料
- 护照原件
- 往返机票
- 酒店预订单
- 入境卡确认（QR 码、PDF 或纸质版）
- 足够的现金或信用卡

### 📋 入境流程
1. 下飞机后跟随"Arrivals"标识
2. 前往入境检查柜台
3. 出示护照和入境卡确认
4. 回答入境官员问题（如有）
5. 盖章后前往行李提取处
6. 通过海关检查

### 📋 常见问题应对
- 如果入境卡信息有误，主动向入境官员说明
- 如果未提前填写，部分国家可在机场现场填写
- 保持冷静，如实回答入境官员问题


path: reference/country-guides-new.md
content: # 各国入境卡详细填写指南

本文档包含东南亚 6 个国家 + 日本、韩国共 8 个国家的详细入境卡填写指南。

---

## 目录

- [🇲🇾 马来西亚 MDAC](#-马来西亚-mdac-填写流程)
- [🇹🇭 泰国 TDAC](#-泰国-tdactm6电子入境卡填写流程)
- [🇸🇬 新加坡 SG Arrival Card](#-新加坡-sg-arrival-card-填写流程)
- [🇮🇩 印尼 All Indonesia](#-印尼-all-indonesia-arrival-card-填写指南)
- [🇻🇳 越南入境申报表](#-越南入境申报表填写指南)
- [🇵🇭 菲律宾 eTravel](#-菲律宾-etravel-入境申报完整指南)
- [🇯🇵 日本 Visit Japan Web](#-日本-visit-japan-web-填写指南)
- [🇰🇷 韩国 K-ETA + e-Arrival Card](#-韩国-k-eta--e-arrival-card-填写指南)

---

## 🇲🇾 马来西亚 MDAC 填写流程

填写马来西亚电子入境卡（MDAC）是入境前的必要步骤。别担心，流程并不复杂，我为你整理了一份详细的填写指南，你跟着一步步操作就行。

---

### 📋 填写前准备

在开始填写前，请确保你已经准备好以下信息，这样填写起来会更顺畅：

- **护照**：有效期需在 6 个月以上
- **航班信息**：准确的航班号和出发地
- **在马来西亚的住址**：建议提前预订好酒店，并准备好酒店的英文全称和详细地址
- **电子邮箱**：用于接收确认邮件和 PIN 码
- **填写时间**：最早可在出发前 3 天（含出发当天）填写

---

### 🌐 官方填写入口

⚠️ **请务必通过马来西亚移民局官方网站进行填写，谨防钓鱼网站。**

**官方网站**：https://imigresen-online.imi.gov.my/mdac/main

---

### 📝 详细填写步骤

整个流程分为 **"注册填写"** 和 **"验证下载"** 两个部分。

#### 第一步：注册并填写信息 (REGISTER)

1. 进入官网后，点击红色的 **REGISTER** 按钮开始填写
2. 根据页面提示，如实填写个人信息和旅行信息
3. ⚠️ **所有信息建议使用英文大写字母填写**

**详细填写表格**：

| 填写项目 | 说明与示例 |
|---------|-----------|
| **个人信息 (Personal Information)** | |
| 姓名 (Name) | 与护照信息页一致，姓和名之间用空格隔开<br>例如：`ZHANG SAN` |
| 护照号 (Passport No.) | 填写护照右上角的号码<br>例如：`E12345678` |
| 国籍 (Nationality) | 选择 `CHINA` |
| 出生日期 (Date of Birth) | 按照 **日/月/年** 的格式填写<br>例如：`01/01/1990` |
| 性别 (Sex) | 男性选 `MALE`，女性选 `FEMALE` |
| 护照有效期 (Date of Passport Expiry) | 按照护照信息页填写<br>例如：`31/12/2030` |
| 电子邮箱 (Email Address) | 填写一个常用且能正常接收邮件的邮箱<br>例如：`[REDACTED_SECRET]` |
| 手机号码 (Mobile No.) | 填写你的中国手机号，前面加上国家代码 `+86`<br>例如：`+86 138 0000 0000` |
| **旅行信息 (Traveling Information)** | |
| 抵达日期 (Date of Arrival) | 你抵达马来西亚的日期<br>例如：`15/04/2026` |
| 旅行方式 (Mode of Travel) | 飞机入境选择 `AIR` |
| 离开日期 (Date of Departure) | 你离开马来西亚的日期<br>例如：`22/04/2026` |
| 出发地 (Last Port of Embarkation) | 你登机前的最后一个国家<br>例如：`CHINA` |
| 航班号 (Flight No.) | 填写你的航班号<br>例如：`MH370` |
| 住宿类型 (Accommodation of Stay) | 住酒店选择 `HOTEL/MOTEL/RESTHOUSE` |
| 酒店地址 (Address in Malaysia) | 填写酒店的英文全称和街道地址<br>例如：`Grand Hyatt Kuala Lumpur, 12 Jalan Pinang` |
| 州/城市/邮编 (State/City/Postcode) | 根据酒店所在地选择或填写，常用城市邮编见下方参考 |

**常用城市及邮编参考**：

| 城市 | 州 (State) | 城市 (City) | 邮编 (Postcode) |
|------|-----------|------------|----------------|
| 吉隆坡 (Kuala Lumpur) | WP KUALA LUMPUR | KUALA LUMPUR | 50000 |
| 槟城 (Penang) | PULAU PINANG | GEORGE TOWN | 11600 |
| 仙本那 (Semporna) | SABAH | SEMPORNA | 91308 |
| 马六甲 (Malacca) | MELAKA | MELAKA | 75000 |
| 新山 (Johor Bahru) | JOHOR | JOHOR BAHRU | 80000 |
| 兰卡威 (Langkawi) | KEDAH | LANGKAWI | 07000 |

4. 确认所有信息无误后，点击 **SUBMIT** 提交

---

#### 第二步：验证并下载确认信 (CHECK REGISTRATION)

1. 提交后，系统会提示你一封确认邮件已发送至你的邮箱。**请立刻登录邮箱查收**
2. 在邮件中找到并复制 **PIN 码**
3. 返回 MDAC 官网首页，点击 **CHECK REGISTRATION** 按钮
4. 依次输入：
   - 你的护照号
   - 国籍 (`CHINA`)
   - 刚刚收到的 PIN 码
5. 完成人机验证后点击 **SUBMIT**
6. 页面会显示你填写的完整信息，在页面底部找到下载图标，点击即可下载 **PDF 格式的正式入境卡确认信**

---

### ⚠️ 重要提醒

#### 📄 保存凭证
- ✅ **务必将下载好的 PDF 确认信打印一份纸质版随身携带**
- ✅ **同时也在手机里保存好电子版**
- 入境时移民官员可能会要求出示

#### 🚪 自助通关
- 持有 6 个月以上有效期护照的中国公民
- 在吉隆坡国际机场等指定口岸可以使用自助通关闸门（Autogate）入境
- 非常便捷，节省排队时间

#### ✈️ 转机情况
- 如果你的航班在马来西亚转机，且需要更换航站楼或重新托运行李
- 也算作入境，同样需要填写 MDAC

#### 🆓 豁免人群
以下人群可豁免填写：
- 持有马来西亚长期通行证
- 马来西亚永久居民
- 新加坡、文莱等特定国家护照的人员

---

### 🔧 常见问题处理

#### Q1: 没有收到 PIN 码邮件怎么办？
**A:** 
1. 检查垃圾邮件箱
2. 确认填写的邮箱地址正确
3. 等待 5-10 分钟后重新检查
4. 如仍未收到，可以重新提交一次

#### Q2: 填写错误可以修改吗？
**A:** 
- 提交前：可以随时修改
- 提交后：需要重新填写一份新的，使用新的 PIN 码下载

#### Q3: 可以提前多久填写？
**A:** 
- 没有明确的提前时间限制
- 建议在确定行程后再填写
- 最晚在出发前完成即可

#### Q4: 入境时需要出示什么？
**A:** 
- PDF 确认信（纸质版或电子版）
- 护照
- 往返机票
- 酒店预订单（可能抽查）

---

[由于内容过长，我会分多个文件创建。让我先创建包含前 3 个国家的文件，然后继续添加其他国家]


path: reference/japan-guide.md
content: # 🇯🇵 日本 Visit Japan Web 填写指南

欢迎前往日本！日本政府推出了 **Visit Japan Web** 在线入境申报系统，让入境流程更加便捷。我为你整理了这份详细的填写指南。

---

## 📋 什么是 Visit Japan Web？

**Visit Japan Web** 是日本政府推出的在线入境申报系统，整合了以下三项服务：
1. **入境审查**（Immigration）
2. **海关申报**（Customs Declaration）
3. **检疫快速通道**（Fast Track）

通过提前在线填写，可以大幅缩短入境时的排队时间。

---

## 📝 填写前准备

在开始填写前，请确保你已经准备好以下信息：

- **护照**：有效期需在 6 个月以上
- **航班信息**：准确的航班号和抵达日期
- **在日本的住址**：建议提前预订好酒店，并准备好酒店的英文全称和详细地址
- **电子邮箱**：用于注册账户和接收确认信息
- **疫苗接种证明**（如有）：虽然目前不强制要求，但建议准备
- **填写时间**：建议在出发前 1-2 周完成

---

## 🌐 官方填写入口

⚠️ **请务必通过日本政府官方网站进行填写，谨防钓鱼网站。**

**官方网站**：https://www.vjw.digital.go.jp/

**支持语言**：
- 日语
- 英语
- 中文（简体/繁体）
- 韩语

---

## 📝 详细填写步骤

### 第一步：注册账户

1. 访问 Visit Japan Web 官网
2. 点击 **"新規アカウント作成"**（创建新账户）
3. 输入电子邮箱地址
4. 设置密码（至少 8 位，包含大小写字母和数字）
5. 验证邮箱（点击邮件中的验证链接）

---

### 第二步：填写个人信息

登录后，需要填写以下个人信息：

| 字段名称 | 说明与示例 |
|---------|-----------|
| **基本信息** | |
| 姓名（英文） | 与护照完全一致<br>例如：`ZHANG SAN` |
| 姓名（日文假名） | 可选，如不会填写可跳过 |
| 出生日期 | 格式：YYYY/MM/DD<br>例如：`1990/01/01` |
| 性别 | 男性/女性 |
| 国籍 | 选择 `中国` 或 `CHINA` |
| **护照信息** | |
| 护照号码 | 填写护照右上角的号码<br>例如：`E12345678` |
| 护照签发国 | 选择 `中国` |
| 护照有效期 | 格式：YYYY/MM/DD<br>例如：`2030/12/31` |

---

### 第三步：填写入境信息

| 字段名称 | 说明与示例 |
|---------|-----------|
| **航班信息** | |
| 航空公司 | 选择你的航空公司<br>例如：`中国国际航空`、`全日空` |
| 航班号 | 填写你的航班号<br>例如：`CA183` |
| 出发地 | 填写出发机场<br>例如：`北京首都国际机场` |
| 抵达机场 | 选择日本入境机场<br>例如：`成田国际机场`、`羽田机场` |
| 抵达日期 | 格式：YYYY/MM/DD<br>例如：`2026/04/15` |
| **住宿信息** | |
| 住宿类型 | 选择 `酒店`、`民宿`、`亲友家` 等 |
| 酒店名称 | 填写酒店的日文或英文名称<br>例如：`東京ヒルトンホテル` 或 `Tokyo Hilton Hotel` |
| 酒店地址 | 填写完整地址<br>例如：`〒160-0023 東京都新宿区西新宿6-6-2` |
| 酒店电话 | 填写酒店电话号码<br>例如：`03-1234-5678` |
| **联系方式** | |
| 在日本的联系电话 | 如有日本手机号可填写，否则填写酒店电话 |
| 紧急联系人 | 填写国内紧急联系人姓名和电话 |

---

### 第四步：填写海关申报

**需要申报的物品**：

| 申报项目 | 说明 |
|---------|------|
| **现金** | 携带现金或有价证券超过 100 万日元（约 5 万人民币）需申报 |
| **酒类** | 免税额度：3 瓶（每瓶 760ml） |
| **香烟** | 免税额度：400 支（或雪茄 100 支，或烟丝 500g） |
| **香水** | 免税额度：2 盎司（约 56ml） |
| **其他物品** | 总价值超过 20 万日元需申报 |
| **禁止物品** | 毒品、枪支、刀具、假冒商品、肉类制品等 |

**特别注意**：
- ⚠️ **肉类制品**（包括火腿、香肠、肉干等）**严禁携带**
- ⚠️ **新鲜水果**需要检疫证明
- ⚠️ **药品**需要符合日本药事法规定

---

### 第五步：健康申报（Fast Track）

虽然目前日本已取消大部分疫情相关限制，但仍需填写健康申报：

| 申报项目 | 说明 |
|---------|------|
| 健康状况 | 确认过去 14 天内未出现发热、咳嗽等症状 |
| 疫苗接种情况 | 如有接种可填写（非强制） |
| 过去 14 天旅行史 | 列出访问过的国家/地区 |

---

### 第六步：提交并获取 QR 码

1. 确认所有信息无误后，点击 **"提交"**
2. 系统会生成 **3 个 QR 码**：
   - **入境审查用 QR 码**（蓝色）
   - **海关申报用 QR 码**（黄色）
   - **检疫用 QR 码**（绿色，如适用）
3. **务必截图或下载保存所有 QR 码**
4. 入境时分别在对应窗口出示相应的 QR 码

---

## 🏙️ 常用城市和机场参考

### 主要入境机场

| 机场名称 | 机场代码 | 所在城市 | 说明 |
|---------|---------|---------|------|
| 成田国际机场 | NRT | 东京 | 东京主要国际机场 |
| 羽田机场 | HND | 东京 | 东京市区机场 |
| 关西国际机场 | KIX | 大阪 | 大阪主要国际机场 |
| 中部国际机场 | NGO | 名古屋 | 名古屋主要机场 |
| 新千岁机场 | CTS | 札幌 | 北海道主要机场 |
| 福冈机场 | FUK | 福冈 | 九州主要机场 |
| 那霸机场 | OKA | 冲绳 | 冲绳主要机场 |

### 常用城市日文地址格式

**东京地址示例**：
- `〒160-0023 東京都新宿区西新宿6-6-2`
- `〒100-0005 東京都千代田区丸の内1-9-1`

**大阪地址示例**：
- `〒530-0001 大阪府大阪市北区梅田3-1-1`
- `〒542-0086 大阪府大阪市中央区西心斎橋1-4-3`

**京都地址示例**：
- `〒600-8216 京都府京都市下京区東塩小路町721-1`

---

## ⚠️ 重要提醒

### 📄 保存 QR 码
- ✅ **务必将所有 QR 码截图保存在手机相册中**
- ✅ **建议同时保存到云端备份**
- ✅ **如有条件，建议打印纸质版**
- 入境时需要分别出示不同的 QR 码

### ⏰ 填写时间建议
- **建议在出发前 1-2 周完成**
- **最晚在出发前 24 小时完成**
- 填写后可随时修改，直到入境前

### 💰 费用说明
- **Visit Japan Web 完全免费**
- 如遇到要求付费的网站，请立即停止

### 👨‍👩‍👧‍👦 家庭申报
- 每位家庭成员都需要单独注册账户
- 每人都需要获取自己的 QR 码
- 未成年人可由家长代为填写

### 🚨 入境流程
1. **检疫**（如适用）：出示绿色 QR 码
2. **入境审查**：出示蓝色 QR 码 + 护照
3. **提取行李**
4. **海关检查**：出示黄色 QR 码

---

## ❓ 常见问题处理

### Q1：Visit Japan Web 是强制的吗？
**A**：不是强制的，但强烈推荐使用。使用 Visit Japan Web 可以：
- 大幅缩短入境排队时间
- 避免填写纸质表格
- 使用专用快速通道

### Q2：填写错误可以修改吗？
**A**：可以。在入境前，你可以随时登录账户修改信息并重新生成 QR 码。

### Q3：QR 码有效期多久？
**A**：QR 码在你填写的入境日期前后都有效，但建议在入境当天使用最新生成的 QR 码。

### Q4：可以用纸质版 QR 码吗？
**A**：可以。手机截图或打印纸质版都可以，但要确保 QR 码清晰可扫描。

### Q5：忘记截图 QR 码怎么办？
**A**：可以重新登录 Visit Japan Web 账户，查看并下载之前生成的 QR 码。

### Q6：没有日本手机号怎么填联系电话？
**A**：可以填写酒店电话号码，或者留空（部分字段可选）。

### Q7：携带药品需要申报吗？
**A**：
- 个人使用的处方药（1-2 个月用量）通常不需要申报
- 大量药品或特殊药品需要提前申请《药监证明》
- 建议携带医生处方和药品说明书

### Q8：可以携带肉类制品吗？
**A**：❌ **严禁携带**任何肉类制品（包括火腿、香肠、肉干、肉松等），违者将被没收并可能罚款。

### Q9：入境时需要出示哪些文件？
**A**：
- 护照（有效期 6 个月以上）
- Visit Japan Web 的 QR 码（3 个）
- 往返机票（可能抽查）
- 酒店预订单（可能抽查）
- 足够的旅费证明（可能抽查）

### Q10：转机需要填写吗？
**A**：
- 如果在日本转机**不出境**（国际转国际），不需要填写
- 如果需要**入境日本**再转机，必须填写

---

## 📞 紧急联系方式

如遇到紧急情况，可以联系以下机构：

- **日本报警电话**：110
- **日本急救电话**：119
- **中国外交部全球领事保护热线**：+86-10-12308
- **驻日本使馆领事保护电话**：+81-3-3403-3065
- **驻大阪总领馆领事保护电话**：+81-6-6445-9481
- **驻札幌总领馆领事保护电话**：+81-11-513-5335
- **驻福冈总领馆领事保护电话**：+81-92-713-1121
- **驻长崎总领馆领事保护电话**：+81-95-849-3311
- **驻名古屋总领馆领事保护电话**：+81-52-932-1098

---

## 🌟 最后的小建议

1. **提前准备**：在出发前 1-2 周完成填写
2. **核对信息**：填写完成后仔细核对，特别是护照号、航班号
3. **多渠道保存**：QR 码同时保存在手机、云端，最好打印一份
4. **了解禁忌**：提前了解日本海关禁止携带的物品
5. **保持耐心**：入境时配合官员检查，保持礼貌

---

祝你日本之旅愉快！🗾✈️


path: reference/major-countries-guide.md
content: # 🌍 主要国家签证指南（美国/英国/澳大利亚/加拿大）

> 📅 信息更新时间：2026年4月 | 数据来源：各国驻华大使馆官网（P0来源）
> ⚠️ 签证政策随时可能变化，出发前请务必通过官方渠道确认最新要求

---

## 🇺🇸 美国签证（B1/B2 旅游商务签证）

### 基本信息

| 项目 | 说明 |
|------|------|
| **中国护照政策** | ❌ 需要签证 |
| **签证类型** | B1（商务）/ B2（旅游）/ B1/B2（综合） |
| **最长停留** | 通常 6 个月（由入境官员决定） |
| **签证费** | 185 美元（约 1,350 人民币） |
| **处理时间** | 面试后通常 3-5 个工作日；等待面试时间视城市而定（可能数月） |
| **有效期** | 通常 10 年多次入境 |
| **可操作性** | 🏢 必须线下办理（需要面试） |

### 官方网站

- **美国驻华大使馆**：https://china.usembassy-china.org.cn/zh/visas-zh/
- **DS-160 申请表**：https://ceac.state.gov/genniv/
- **预约面试**：https://www.ustraveldocs.com/cn_zh/

### 申请材料清单

| 材料 | 要求 |
|------|------|
| **护照原件** | 有效期超过计划离开美国后 6 个月 |
| **DS-160 确认页** | 在线填写后打印，带条形码 |
| **面试预约确认单** | 打印版 |
| **签证照片** | 5cm×5cm，白底彩色，近 6 个月内 |
| **签证费缴费收据** | 通过 ustraveldocs.com 缴费 |
| **在职证明/营业执照** | 证明有稳定工作和收入 |
| **银行存款证明** | 近 3-6 个月流水 |
| **房产证/车辆证** | 证明在国内有资产（可选但有帮助） |
| **行程单** | 详细的美国行程安排 |
| **酒店预订单** | 覆盖全程住宿 |
| **往返机票预订单** | — |

### 申请流程

```
第一步：填写 DS-160 申请表
  → 访问 https://ceac.state.gov/genniv/
  → 选择使领馆城市（北京/上海/广州/成都/沈阳）
  → 在线填写，完成后打印确认页（保存申请编号！）

第二步：缴纳签证费
  → 访问 https://www.ustraveldocs.com/cn_zh/
  → 缴纳 185 美元签证费
  → 保存缴费收据

第三步：预约面试
  → 在 ustraveldocs.com 预约面试时间
  → 选择最近的使领馆（北京/上海/广州/成都/沈阳）
  → 等待面试日期（旺季可能需要等待数月）

第四步：参加面试
  → 携带所有材料
  → 面试官会用中文或英文提问
  → 面试通常 5-10 分钟

第五步：等待审核
  → 面试后通常 3-5 个工作日出结果
  → 可在 ceac.state.gov 查询状态
```

### ⚠️ 重要提醒

- ⚠️ DS-160 申请编号必须妥善保存，后续所有步骤都需要
- ⚠️ 面试时如实回答，不要夸大或隐瞒信息
- ⚠️ 旺季（暑假、春节前）面试等待时间可能长达 3-6 个月，请提前规划
- ⚠️ 签证被拒不退费，且拒签记录会影响后续申请

---

## 🇬🇧 英国签证（标准访客签证）

### 基本信息

| 项目 | 说明 |
|------|------|
| **中国护照政策** | ❌ 需要签证（英国不在申根区） |
| **签证类型** | 标准访客签证（Standard Visitor Visa） |
| **最长停留** | 6 个月 |
| **签证费** | 115 英镑（约 1,050 人民币） |
| **处理时间** | 标准：3 周；加急：5 个工作日（额外收费） |
| **有效期** | 通常 6 个月、2 年或 5 年 |
| **可操作性** | 📝 可在线申请（无需面试，但需递交材料） |

### 官方网站

- **英国政府签证官网**：https://www.gov.uk/apply-to-come-to-the-uk
- **VFS Global 英国签证中心**：https://www.vfsglobal.com/en/individuals/united-kingdom.html

### 申请材料清单

| 材料 | 要求 |
|------|------|
| **护照原件** | 有效期超过计划离开英国后 6 个月 |
| **在线申请确认单** | 在 gov.uk 完成在线申请后打印 |
| **照片** | 符合英国签证照片要求 |
| **银行流水** | 近 6 个月，证明有足够资金 |
| **在职证明** | 注明职位、薪资、假期批准 |
| **行程单** | 英国行程安排 |
| **酒店预订单** | 或邀请函（探亲） |
| **往返机票预订单** | — |

### 申请流程

```
第一步：在线填写申请
  → 访问 https://www.gov.uk/apply-to-come-to-the-uk
  → 选择"标准访客签证"
  → 在线填写申请表并缴费（115 英镑）

第二步：预约递交材料
  → 在 VFS Global 预约递交材料时间
  → 选择最近的签证申请中心

第三步：递交材料
  → 携带所有材料到签证中心
  → 采集指纹和照片
  → 获取收据

第四步：等待审核
  → 标准处理：约 3 周
  → 可在 VFS 官网查询进度
```

### ⚠️ 重要提醒

- ⚠️ 英国不在申根区，申根签证无法用于入境英国
- ⚠️ 英国签证申请全程在线，但仍需到签证中心递交护照和采集生物信息
- ⚠️ 银行存款建议每天至少 100 英镑

---

## 🇦🇺 澳大利亚签证（旅游签证 subclass 600）

### 基本信息

| 项目 | 说明 |
|------|------|
| **中国护照政策** | ❌ 需要签证 |
| **签证类型** | 旅游签证（Visitor Visa subclass 600） |
| **最长停留** | 通常 3 个月（可申请 6 个月或 12 个月） |
| **签证费** | 约 190 澳元（约 900 人民币） |
| **处理时间** | 在线申请：通常 1-4 周；纸质申请更长 |
| **有效期** | 通常 12 个月（多次入境） |
| **可操作性** | 📝 可完全在线申请（ImmiAccount） |

### 官方网站

- **澳大利亚移民局**：https://immi.homeaffairs.gov.au/
- **ImmiAccount 在线申请**：https://online.immi.gov.au/lusc/login

### 申请材料清单

| 材料 | 要求 |
|------|------|
| **护照扫描件** | 信息页清晰扫描 |
| **近期照片** | 数字格式，符合要求 |
| **银行流水** | 近 3-6 个月 |
| **在职证明** | 英文版 |
| **行程单** | 澳大利亚行程安排 |
| **酒店预订单** | — |
| **往返机票预订单** | — |

### 申请流程

```
第一步：注册 ImmiAccount
  → 访问 https://online.immi.gov.au/lusc/login
  → 注册账号并登录

第二步：在线填写申请
  → 选择"Visitor Visa (subclass 600)"
  → 填写个人信息、行程信息
  → 上传所有材料（数字格式）

第三步：缴纳签证费
  → 约 190 澳元，在线支付

第四步：等待审核
  → 通常 1-4 周
  → 审核通过后签证直接发送到邮箱（电子签证）
  → 无需贴纸，入境时系统自动核验
```

### ⚠️ 重要提醒

- ✅ 澳大利亚签证为**电子签证**，无需贴纸，入境时系统自动核验
- ⚠️ 申请时需要提供真实的行程和住宿信息
- ⚠️ 首次申请建议提前 4-6 周

---

## 🇨🇦 加拿大签证（临时居民签证 TRV）

### 基本信息

| 项目 | 说明 |
|------|------|
| **中国护照政策** | ❌ 需要签证 |
| **签证类型** | 临时居民签证（Temporary Resident Visa, TRV） |
| **最长停留** | 通常 6 个月（由入境官员决定） |
| **签证费** | 100 加元（约 530 人民币） |
| **处理时间** | 在线申请：通常 2-8 周 |
| **有效期** | 通常 10 年或护照有效期（多次入境） |
| **可操作性** | 📝 可完全在线申请（IRCC 官网） |

### 官方网站

- **加拿大移民局（IRCC）**：https://www.canada.ca/en/immigration-refugees-citizenship/services/visit-canada.html
- **在线申请入口**：https://www.canada.ca/en/immigration-refugees-citizenship/services/application/account.html

### 申请材料清单

| 材料 | 要求 |
|------|------|
| **护照扫描件** | 所有有效护照的信息页 |
| **数字照片** | 符合加拿大签证照片要求 |
| **银行流水** | 近 3-6 个月 |
| **在职证明** | 英文版，注明薪资和假期 |
| **行程单** | 加拿大行程安排 |
| **酒店预订单** | 或邀请函（探亲） |
| **往返机票预订单** | — |
| **家庭关系证明** | 如有家庭成员在加拿大 |

### 申请流程

```
第一步：创建 IRCC 账号
  → 访问 IRCC 官网
  → 创建 GCKey 账号或使用 Sign-In Canada

第二步：填写申请
  → 选择"Visitor Visa"
  → 填写个人信息、旅行历史、家庭信息
  → 上传所有材料

第三步：缴纳签证费
  → 100 加元，在线支付

第四步：生物信息采集（如需要）
  → 首次申请通常需要到签证申请中心采集指纹
  → 北京/上海/广州等城市有 VFS Global 加拿大签证中心

第五步：等待审核
  → 通常 2-8 周
  → 审核通过后签证贴纸邮寄或到签证中心取回
```

### ⚠️ 重要提醒

- ⚠️ 加拿大签证需要采集生物信息（指纹），必须本人到场
- ⚠️ 旅行历史越丰富（尤其是美国、欧洲签证记录），申请成功率越高
- ⚠️ 建议提前 8-12 周申请

---

## 📊 四国签证对比

| 对比项 | 🇺🇸 美国 | 🇬🇧 英国 | 🇦🇺 澳大利亚 | 🇨🇦 加拿大 |
|--------|---------|---------|------------|---------|
| **签证费** | 185 美元 | 115 英镑 | 190 澳元 | 100 加元 |
| **处理时间** | 面试后 3-5 天（等面试可能数月） | 3 周 | 1-4 周 | 2-8 周 |
| **是否需要面试** | ✅ 必须面试 | ❌ 无需面试 | ❌ 无需面试 | ❌ 无需面试 |
| **是否需要到场** | ✅ 必须本人到场 | ✅ 递交材料需到场 | ❌ 全程在线 | ✅ 生物信息需到场 |
| **签证类型** | 贴纸签证 | 贴纸签证 | 电子签证 | 贴纸签证 |
| **有效期** | 通常 10 年 | 通常 2-5 年 | 通常 12 个月 | 通常 10 年 |
| **难度** | ⭐⭐⭐⭐⭐ 最难 | ⭐⭐⭐⭐ 较难 | ⭐⭐⭐ 中等 | ⭐⭐⭐ 中等 |

---

## 📞 官方联系方式

| 国家 | 驻华大使馆 | 签证官网 |
|------|-----------|---------|
| 🇺🇸 美国 | https://china.usembassy-china.org.cn/zh/ | https://www.ustraveldocs.com/cn_zh/ |
| 🇬🇧 英国 | https://www.gov.uk/world/china | https://www.gov.uk/apply-to-come-to-the-uk |
| 🇦🇺 澳大利亚 | https://china.embassy.gov.au/bjng/home.html | https://immi.homeaffairs.gov.au/ |
| 🇨🇦 加拿大 | https://www.canada.ca/en/immigration-refugees-citizenship.html | https://www.canada.ca/en/immigration-refugees-citizenship/services/visit-canada.html |


path: reference/faq.md
content: # 常见问题 FAQ

## 通用问题

### Q1: 多个国家都需要填写入境卡，应该按什么顺序办理？
**A:** 建议按以下优先级：
1. 有时间限制的（新加坡 3 天内、菲律宾 72 小时内）
2. 需要邮件验证的（马来西亚、印尼、菲律宾）
3. 可在线预填的（泰国、越南）

### Q2: 如果忘记填写入境卡怎么办？
**A:** 
- 泰国、越南：可在飞机上填写纸质版
- 马来西亚、新加坡、菲律宾：必须在线填写，建议提前办理
- 印尼：虽非强制但强烈推荐，未填写可能需要现场排队

### Q3: 入境卡填写错误可以修改吗？
**A:** 大部分国家提交后无法修改，需要重新填写（可能需要使用不同邮箱）

### Q4: 需要打印纸质版吗？
**A:** 
- 必须打印：无
- 强烈推荐：马来西亚、印尼、菲律宾
- 可选：泰国、越南
- 不需要：新加坡（系统已记录）

### Q5: 可以代他人填写吗？
**A:** 可以，但需要对方的真实护照和行程信息，且信息必须准确无误

## 国家特定问题

### Q6: 马来西亚 MDAC 的 PIN 码一直收不到怎么办？
**A:** 
1. 检查垃圾邮件文件夹
2. 确认邮箱地址正确
3. 等待 10 分钟后重新注册

### Q7: 新加坡入境卡可以提前一周填写吗？
**A:** 不可以，必须在入境前 3 天内填写，过早填写无效

### Q8: 菲律宾 eTravel 的 72 小时是从什么时候开始算？
**A:** 从出发时间（航班起飞时间）开始倒推 72 小时

### Q9: 泰国 TM6 在线预填和飞机上填写有什么区别？
**A:** 在线预填可以节省入境排队时间，但飞机上填写也完全可以

### Q10: 印尼 e-Arrival Card 不填写会怎样？
**A:** 虽非强制，但未填写可能需要在机场现场填写，排队时间较长


path: reference/vietnam-guide.md
content: # 🇻🇳 越南入境申报表填写指南

填写越南入境申报表是入境前的必要步骤。别担心，流程并不复杂，我为你整理了一份详细的填写指南，你跟着一步步操作就行。

---

## 📋 填写前准备

在开始填写前，请确保你已经准备好以下信息，这样填写起来会更顺畅：

- **护照**：有效期需在 6 个月以上
- **签证信息**：电子签证（E-Visa）批准函或落地签批准函
- **航班信息**：准确的航班号和入境口岸
- **在越南的住址**：建议提前预订好酒店，并准备好酒店的英文全称和详细地址
- **电子邮箱**：用于接收确认邮件（如果使用电子签证）
- **照片**：2 张 4x6cm 白底彩照（仅落地签需要）

---

## 🌐 官方填写入口

⚠️ **请务必通过越南公安部公共服务官方网站进行填写，谨防钓鱼网站。**

**官方网站**：https://dichvucong.bocongan.gov.vn/

**填写方式**：
- ✅ **在线预填**：提前在官网填写健康申报和入境信息（推荐）
- ✅ **飞机上填写**：在飞机上领取纸质表格填写
- ✅ **机场填写**：抵达机场后在柜台领取表格填写

---

## 📝 详细填写步骤

### 📌 填写方式说明

越南入境申报主要有以下几种情况：

| 入境方式 | 需要填写的表格 | 填写时机 | 备注 |
|---------|--------------|---------|------|
| **电子签证（E-Visa）** | 在线申请时已包含 | 出发前在线填写 | 申请时已提交所有信息 |
| **落地签（Visa on Arrival）** | NA1 申请表 + 入境申报表 | 机场填写 | 需要填写 NA1 表格和照片 |
| **免签入境** | 入境申报表 | 飞机上或机场填写 | 需要填写纸质表格 |

---

### 📌 情况一：电子签证（E-Visa）在线申请

如果你已经申请了电子签证，大部分信息在申请时已经填写，抵达越南时只需出示电子签证即可，无需额外填写表格。

**电子签证申请网站**：https://evisa.xuatnhapcanh.gov.vn/

---

### 📌 情况二：落地签（Visa on Arrival）填写 NA1 表格

如果你选择落地签，需要在越南机场填写 **NA1 签证申请表**。以下是详细的填写说明：

#### **表格 NA1 详细字段说明**

| 字段名称 | 英文/越南文 | 说明与示例 |
|---------|------------|-----------| 
| **照片粘贴处** | Photo | 粘贴 1 张 4x6cm 白底彩照 |
| **护照号码** | Passport Number / Số hộ chiếu | 填写护照右上角的号码<br>例如：`E12345678` |
| **国籍** | Nationality / Quốc tịch | 填写 `CHINA` 或 `CHINESE` |
| **出生日期** | Date of Birth / Ngày sinh | 按照护照信息页填写<br>格式：`DD/MM/YYYY`<br>例如：`01/01/1990` |
| **出生地点** | Place of Birth / Nơi sinh | 填写出生城市<br>例如：`BEIJING` |
| **性别** | Sex / Giới tính | 男性填 `M`，女性填 `F` |
| **姓名** | Full Name / Họ và tên | 与护照完全一致，全大写<br>例如：`ZHANG SAN` |
| **护照类型** | Type of Passport | 普通护照填 `P` |
| **签发日期** | Date of Issue | 按照护照信息页填写<br>例如：`01/01/2020` |
| **护照有效期** | Date of Expiry | 按照护照信息页填写<br>例如：`31/12/2030` |
| **签发地** | Place of Issue | 护照签发城市<br>例如：`BEIJING` |
| **职业** | Occupation / Nghề nghiệp | 填写职业<br>例如：`TEACHER`、`ENGINEER`、`STUDENT` |
| **永久居住地址** | Permanent Residential Address | 你在中国的永久地址<br>例如：`123 BEIJING ROAD, SHANGHAI, CHINA` |
| **越南临时居住地址** | Intended Temporary Residential Address in Vietnam | 填写第一晚酒店的完整英文地址<br>例如：`23-25 HANG THIEC STREET, HOAN KIEM DISTRICT, HANOI, VIETNAM` |
| **入境口岸** | Port of Entry / Cửa khẩu nhập cảnh | 你抵达越南的机场<br>例如：`NOI BAI INTERNATIONAL AIRPORT` |
| **入境日期** | Intended Date of Entry / Ngày nhập cảnh dự kiến | 你抵达越南的日期<br>例如：`15/04/2026` |
| **停留天数** | Duration of Stay / Thời gian lưu trú | 预计停留天数<br>例如：`7 DAYS` |
| **入境目的** | Purpose of Entry / Mục đích nhập cảnh | 填写 `TOURISM`（旅游）或 `BUSINESS`（商务） |
| **签证类型** | Type of Visa / Loại visa | 选择 `1 MONTH`（1个月）或 `3 MONTHS`（3个月）<br>`SINGLE ENTRY`（单次）或 `MULTIPLE ENTRY`（多次） |
| **上一次入境越南日期** | Previous Entry Date | 如第一次入境则留空 |
| **担保人信息** | Guarantor Information | 如有担保人填写，否则留空 |

---

### 📌 情况三：飞机上填写入境申报表

如果你持有电子签证或免签入境，在飞机上会收到空乘人员分发的**入境申报表**（通常为中英文对照）。以下是填写说明：

#### **入境申报表详细字段说明**

| 字段名称 | 说明与示例 |
|---------|-----------| 
| **个人信息 (Personal Information)** | |
| 姓名 (Full Name) | 与护照完全一致，全大写<br>例如：`ZHANG SAN` |
| 性别 (Sex) | 男性填 `M`，女性填 `F` |
| 出生日期 (Date of Birth) | 格式：`DD/MM/YYYY`<br>例如：`01/01/1990` |
| 国籍 (Nationality) | 填写 `CHINA` |
| 护照号码 (Passport Number) | 填写护照右上角的号码<br>例如：`E12345678` |
| 签证号码 (Visa Number) | 填写签证上的号码（如有） |
| **旅行信息 (Travel Information)** | |
| 航班号 (Flight Number) | 填写你的航班号<br>例如：`VN558` |
| 入境日期 (Date of Entry) | 你抵达越南的日期<br>例如：`15/04/2026` |
| 入境口岸 (Port of Entry) | 你抵达越南的机场<br>例如：`NOI BAI INTL AIRPORT` |
| 离境日期 (Date of Exit) | 你离开越南的日期<br>例如：`22/04/2026` |
| **住宿信息 (Accommodation Information)** | |
| 在越南的地址 (Address in Vietnam) | **必须填写具体的地址**，不能只填城市名<br>格式：`酒店名称, 街道地址, 区/省, 城市, 越南`<br>例如：`HANOI TOWER HOTEL, 49 HAI BA TRUNG STREET, HOAN KIEM DISTRICT, HANOI, VIETNAM` |
| **健康申报 (Health Declaration)** | |
| 是否有发热、咳嗽等症状 | 选择 `NO`（无）或 `YES`（有） |
| 过去 14 天是否去过特定国家 | 选择 `NO`（无）或 `YES`（有） |

---

## 🏨 常用城市英文名称参考

以下是越南常用城市的英文名称和机场代码，方便你填写：

| 中文名称 | 英文名称 | 机场代码 | 常用区/省 |
|---------|---------|---------|----------|
| **河内** | Hanoi | HAN | Hoan Kiem District, Ba Dinh District |
| **胡志明市** | Ho Chi Minh City | SGN | District 1, District 3, Phu Nhuan District |
| **岘港** | Da Nang | DAD | Hai Chau District, Son Tra District |
| **海防** | Hai Phong | HPH | Hong Bang District, Ngo Quyen District |
| **芽庄** | Nha Trang | NHA | Nha Trang City, Khanh Hoa Province |
| **会安** | Hoi An | DAD | Minh An Ward, Hoi An City |
| **富国岛** | Phu Quoc | PQC | Duong Dong Town, Phu Quoc Island |
| **大叻** | Da Lat | DLI | Da Lat City, Lam Dong Province |
| **顺化** | Hue | HUI | Hue City, Thua Thien Hue Province |
| **下龙湾** | Ha Long | HAN | Ha Long City, Quang Ninh Province |

---

## 🏨 常用酒店地址格式参考

以下是越南常用酒店地址的英文格式示例：

### 河内酒店地址示例

| 酒店名称 | 英文地址格式 |
|---------|-------------|
| 河内城堡饭店 | `23-25 Hang Thiec Street, Hoan Kiem District, Hanoi, Vietnam` |
| 河内索菲特传奇大都会酒店 | `15 Ngo Quyen Street, Hoan Kiem District, Hanoi, Vietnam` |
| 河内希尔顿歌剧院酒店 | `11 Le Thai To Street, Hoan Kiem District, Hanoi, Vietnam` |
| 河内洲际酒店 | `1A Nghi Tam, Tay Ho District, Hanoi, Vietnam` |

### 胡志明市酒店地址示例

| 酒店名称 | 英文地址格式 |
|---------|-------------|
| 胡志明市新世界酒店 | `76 Le Lai Street, District 1, Ho Chi Minh City, Vietnam` |
| 胡志明市洲际酒店 | `235 Dong Khoi Street, District 1, Ho Chi Minh City, Vietnam` |
| 胡志明市索菲特西贡广场酒店 | `17 Le Duan Street, District 1, Ho Chi Minh City, Vietnam` |
| 胡志明市万丽酒店 | `8-15 Dong Du Street, District 1, Ho Chi Minh City, Vietnam` |

### 岘港酒店地址示例

| 酒店名称 | 英文地址格式 |
|---------|-------------|
| 岘港索菲特酒店 | `150 Vo Nguyen Giap Street, My An Beach, Ngu Hanh Son District, Da Nang, Vietnam` |
| 岘港洲际阳光半岛度假村 | `Bac My An Beach, Ngu Hanh Son District, Da Nang, Vietnam` |
| 岘港铂尔曼酒店 | `96 Bach Dang Street, Hai Chau District, Da Nang, Vietnam` |

### 芽庄酒店地址示例

| 酒店名称 | 英文地址格式 |
|---------|-------------|
| 芽庄穆拉诺度假村 | `Tran Phu Street, Nha Trang City, Khanh Hoa Province, Vietnam` |
| 芽庄喜来登酒店 | `32-34 Tran Phu Street, Nha Trang City, Khanh Hoa Province, Vietnam` |
| 芽庄维尼酒店 | `72-74 Tran Phu Street, Nha Trang City, Khanh Hoa Province, Vietnam` |

---

## ⚠️ 重要提醒

### 📄 准备材料清单

| 材料 | 必需性 | 说明 |
|------|-------|------|
| **护照** | ✅ 必需 | 有效期需在 6 个月以上，至少有 2 页空白页 |
| **签证** | ✅ 必需 | 电子签证（E-Visa）或落地签批准函 |
| **往返机票** | ✅ 必需 | 可能抽查，建议打印备用 |
| **酒店预订单** | ✅ 必需 | 可能抽查，建议打印备用 |
| **照片** | ⚠️ 落地签必需 | 2 张 4x6cm 白底彩照（仅落地签需要） |
| **现金** | ✅ 必需 | 落地签签证费（25-50 美元） |
| **入境申报表** | ✅ 必需 | 飞机上填写或在线预填 |

---

### 📝 填写注意事项

#### ✅ 正确做法
- ✅ **所有信息必须使用英文大写字母填写**
- ✅ **所有信息必须与护照完全一致**
- ✅ **住宿地址必须具体完整**，不能只填城市名
- ✅ **提前准备好酒店英文地址**，建议从酒店官网复制
- ✅ **仔细核对所有信息后再提交**
- ✅ **保存确认邮件或 QR 码截图**

#### ❌ 常见错误
- ❌ **使用中文填写**（必须使用英文）
- ❌ **姓名拼写与护照不一致**
- ❌ **住宿地址只写城市名**（必须写完整地址）
- ❌ **日期格式错误**（应使用 DD/MM/YYYY）
- ❌ **忘记填写签证号码**（如有签证）
- ❌ **字迹潦草难辨**

---

### ⏰ 时间限制说明

- **电子签证**：建议在出发前 **3-5 个工作日** 申请
- **在线健康申报**：可在出发前任何时间填写
- **飞机上填写**：在飞行过程中完成，降落前交给空乘人员
- **落地签**：抵达机场后在签证柜台办理，预计耗时 **30-60 分钟**

---

### 💾 保存凭证

- **电子签证**：保存 PDF 文件并打印纸质版
- **在线申报 QR 码**：保存截图到手机相册
- **酒店预订单**：保存确认邮件并打印纸质版
- **往返机票**：保存电子票务信息并打印纸质版

---

### 🚨 入境时注意事项

1. **准备好所有材料**：护照、签证、机票、酒店订单
2. **出示入境申报表**：纸质表格或 QR 码
3. **配合海关检查**：如实申报携带物品
4. **现金申报**：携带超过 10,000 美元或 15,000,000 越南盾必须申报
5. **违禁品**：不要携带毒品、武器、受保护的动植物制品

---

## 🔧 常见问题处理

### Q1: 越南入境申报表是英文的吗？
**A**: 
- ✅ 是的，申报表有英文版
- ✅ 飞机上分发的表格通常是中英文对照
- ✅ 机场柜台也有示例，不懂可寻求工作人员帮助

---

### Q2: 停留时间短（如过境）也需要填写吗？
**A**: 
- ✅ **必须填写**，这是统一规则
- ✅ 无论停留时间长短，所有外国旅客都必须申报
- ✅ 过境旅客也需要填写入境申报表

---

### Q3: 填写错误可以修改吗？
**A**: 
- **纸质表格**：如果写错，可以向空乘人员或机场工作人员索要新表格重新填写
- **在线申报**：提交前可以随时修改，提交后可能需要重新申报
- **建议**：填写前仔细核对，避免错误

---

### Q4: 住朋友家，地址怎么填？
**A**: 
- ✅ 填写朋友家的完整英文地址
- ✅ 可以使用在线翻译工具将中文地址翻译成英文
- ✅ 建议提前向朋友索取准确的英文地址
- ✅ 地址格式：`街道地址, 区/省, 城市, 越南`

---

### Q5: 落地签需要准备什么？
**A**: 
- ✅ **提前申请落地签批准函**（通过旅行社或在线申请）
- ✅ **准备 2 张 4x6cm 白底彩照**
- ✅ **准备签证费用**（25-50 美元，现金）
- ✅ **填写 NA1 签证申请表**（机场填写）
- ✅ **准备入境申报表**（飞机上填写）
- ✅ **预计耗时 30-60 分钟**

---

### Q6: 电子签证和落地签有什么区别？
**A**: 

| 对比项 | 电子签证（E-Visa） | 落地签（Visa on Arrival） |
|-------|------------------|------------------------|
| **申请方式** | 在线申请 | 需提前申请批准函 |
| **申请时间** | 出发前 3-5 个工作日 | 出发前 1-2 周申请批准函 |
| **费用** | 25-50 美元（在线支付） | 25-50 美元（机场现金支付） |
| **入境流程** | 直接通关，无需额外办理 | 抵达后需在签证柜台办理 |
| **所需材料** | 护照、照片（在线上传） | 护照、照片、批准函、现金 |
| **耗时** | 快速通关 | 额外 30-60 分钟 |
| **推荐度** | ⭐⭐⭐⭐⭐ 高度推荐 | ⭐⭐⭐ 可以接受 |

---

### Q7: 一家人如何申请？
**A**: 
- **电子签证**：每位家庭成员都需要单独申请
- **落地签**：可以由一位代表统一办理，但每位成员都需要填写 NA1 表格
- **入境申报表**：每位家庭成员都需要单独填写
- **建议**：提前准备好所有家庭成员的信息

---

### Q8: 地址只写城市名可以吗？
**A**: 
- ❌ **不可以**，仅填写城市名是不够的
- ✅ **必须填写完整的酒店或住宿地址**
- ✅ **包括酒店名称、街道地址、区/省、城市**
- ✅ **建议从酒店官网复制准确的英文地址**

---

### Q9: 入境时需要出示什么？
**A**: 
- ✅ **护照**（有效期 6 个月以上）
- ✅ **签证**（电子签证 PDF 或落地签贴纸）
- ✅ **往返机票**（可能抽查）
- ✅ **酒店预订单**（可能抽查）
- ✅ **入境申报表**（纸质表格或 QR 码）

---

### Q10: 可以提前多久填写入境申报表？
**A**: 
- **在线健康申报**：可在出发前任何时间填写
- **飞机上填写**：在飞行过程中完成
- **电子签证申请**：建议出发前 3-5 个工作日申请
- **落地签批准函**：建议出发前 1-2 周申请

---

## 🎯 填写小贴士

1. **提前准备所有信息**，填写过程约 5-10 分钟
2. **所有信息必须使用英文大写字母填写**
3. **姓名必须与护照完全一致**，包括拼写顺序
4. **住宿地址必须具体完整**，不能只填城市名
5. **从酒店官网复制准确的英文地址**，避免翻译错误
6. **仔细核对所有信息后再提交**，避免错误
7. **保存确认邮件或 QR 码截图**，以备查询
8. **建议打印纸质版**，以防电子设备故障
9. **提前申请电子签证**，节省入境时间
10. **准备足够的现金**，用于支付落地签费用

---

## 📞 紧急联系方式

如果在填写或入境过程中遇到问题，可以联系以下机构：

- **越南驻华大使馆**：北京
- **越南驻上海总领事馆**：上海
- **越南驻广州总领事馆**：广州
- **越南驻南宁总领事馆**：南宁
- **越南驻昆明总领事馆**：昆明
- **越南移民局官网**：https://xuatnhapcanh.gov.vn/

---

祝您旅途愉快！🇻🇳✈️


path: reference/country-comparison.md
content: # 国家对比与选择建议

## 填写难度对比

| 国家 | 难度 | 耗时 | 是否需要邮件验证 | 是否需要打印 | 费用 |
|------|------|------|----------------|------------|------|
| 🇲🇾 马来西亚 | ⭐⭐⭐ 中等 | 10-15 分钟 | ✅ 需要 | ✅ 推荐 | 免费 |
| 🇹🇭 泰国 | ⭐⭐ 简单 | 5-10 分钟 | ❌ 不需要 | ⚠️ 可选 | 免费 |
| 🇸🇬 新加坡 | ⭐⭐ 简单 | 5-10 分钟 | ✅ 需要 | ❌ 不需要 | 免费 |
| 🇮🇩 印尼 | ⭐⭐⭐ 中等 | 10-15 分钟 | ✅ 需要 | ✅ 推荐 | 免费 |
| 🇻🇳 越南 | ⭐⭐ 简单 | 5-10 分钟 | ❌ 不需要 | ⚠️ 可选 | 免费 |
| 🇵🇭 菲律宾 | ⭐⭐⭐ 中等 | 10-15 分钟 | ✅ 需要 | ✅ 推荐 | 免费 |
| 🇯🇵 日本 | ⭐⭐⭐⭐ 较难 | 15-20 分钟 | ✅ 需要 | ✅ 推荐 | 免费 |
| 🇰🇷 韩国 | ⭐⭐⭐⭐ 较难 | 20-30 分钟 | ✅ 需要 | ✅ 推荐 | K-ETA: 55元 |

## 时间限制对比

| 国家 | 最早填写时间 | 最晚填写时间 | 有效期 | 备注 |
|------|------------|------------|--------|------|
| 🇲🇾 马来西亚 | 无限制 | 入境前 | 3 个月 | 建议出发前 1-2 天填写 |
| 🇹🇭 泰国 | 无限制 | 入境时 | 单次 | 可飞机上填写 |
| 🇸🇬 新加坡 | 入境前 3 天 | 入境前 | 30 天 | ⚠️ 严格时间限制 |
| 🇮🇩 印尼 | 入境前 3 天 | 入境前 | 单次 | ⚠️ 严格时间限制 |
| 🇻🇳 越南 | 无限制 | 入境时 | 单次 | 可飞机上填写 |
| 🇵🇭 菲律宾 | 出发前 72 小时 | 出发前 | 72 小时 | ⚠️ 严格时间限制 |
| 🇯🇵 日本 | 无限制 | 入境前 | 填写后可修改 | 建议出发前 1-2 周填写 |
| 🇰🇷 韩国 | K-ETA 需提前 72 小时 | 入境前 | K-ETA: 2年 | ⚠️ K-ETA 需审批时间 |

## 建议办理顺序

如果您计划多国游，建议按以下顺序办理：

### 1. 第一优先：需要提前审批的国家
- 🇰🇷 **韩国 K-ETA**（提前 1-2 周申请）
  - 需要审批时间（24-72 小时）
  - 有效期 2 年，可多次入境
  - 费用：55 元人民币

### 2. 第二优先：有严格时间限制的国家
按照出发时间倒推填写：
- 🇵🇭 **菲律宾**（出发前 72 小时内）
- 🇸🇬 **新加坡**（入境前 3 天内）
- 🇮🇩 **印尼**（入境前 3 天内）

### 3. 第三优先：需要邮件验证的国家
- 🇲🇾 **马来西亚**（需要等待邮件 PIN 码）
- 🇯🇵 **日本**（需要邮箱验证，建议提前 1-2 周）

### 4. 第四优先：可在线预填的国家
- 🇹🇭 **泰国**（可飞机上填写，但建议提前）
- 🇻🇳 **越南**（可飞机上填写，但建议提前）

## 入境难度评估

| 国家 | 入境卡复杂度 | 语言障碍 | 技术要求 | 综合难度 | 特殊要求 |
|------|------------|---------|---------|---------|---------|
| 🇲🇾 马来西亚 | 中等 | 低（英文） | 中等 | ⭐⭐⭐ | 需要 PIN 码验证 |
| 🇹🇭 泰国 | 简单 | 低（英文） | 低 | ⭐⭐ | 无特殊要求 |
| 🇸🇬 新加坡 | 简单 | 低（英文） | 低 | ⭐⭐ | 时间限制严格 |
| 🇮🇩 印尼 | 中等 | 低（英文/中文） | 中等 | ⭐⭐⭐ | 时间限制严格 |
| 🇻🇳 越南 | 简单 | 中（越南文/英文） | 低 | ⭐⭐ | 无特殊要求 |
| 🇵🇭 菲律宾 | 中等 | 低（英文） | 中等 | ⭐⭐⭐ | 时间限制严格 |
| 🇯🇵 日本 | 较难 | 低（日文/英文/中文） | 较高 | ⭐⭐⭐⭐ | 需要 3 个 QR 码 |
| 🇰🇷 韩国 | 较难 | 低（韩文/英文/中文） | 较高 | ⭐⭐⭐⭐ | K-ETA 需审批 + 付费 |

## 各国特色对比

### 🇲🇾 马来西亚 MDAC
- **优点**：流程清晰，中文支持
- **缺点**：需要等待 PIN 码邮件
- **建议**：提前 1-2 天填写，确保收到 PIN 码

### 🇹🇭 泰国 TDAC
- **优点**：最简单，可飞机上填写
- **缺点**：无
- **建议**：提前在线填写可节省时间

### 🇸🇬 新加坡 SG Arrival Card
- **优点**：流程简单，无需打印
- **缺点**：时间限制严格（3 天内）
- **建议**：按出发时间倒推填写

### 🇮🇩 印尼 All Indonesia
- **优点**：中文界面，整合海关申报
- **缺点**：时间限制严格（3 天内）
- **建议**：按出发时间倒推填写

### 🇻🇳 越南入境申报表
- **优点**：可飞机上填写
- **缺点**：地址必须完整详细
- **建议**：提前准备好酒店英文地址

### 🇵🇭 菲律宾 eTravel
- **优点**：完全免费
- **缺点**：时间限制最严格（72 小时内）
- **建议**：严格按时间窗口填写

### 🇯🇵 日本 Visit Japan Web
- **优点**：多语言支持，整合多项服务
- **缺点**：需要 3 个 QR 码，流程较复杂
- **建议**：提前 1-2 周填写，仔细保存 QR 码

### 🇰🇷 韩国 K-ETA + e-Arrival Card
- **优点**：K-ETA 有效期 2 年
- **缺点**：需要审批时间，K-ETA 需付费
- **建议**：提前 1-2 周申请 K-ETA

## 多国游最佳实践

### 东南亚 6 国游（马来西亚、泰国、新加坡、印尼、越南、菲律宾）

**推荐办理时间表**：

| 时间点 | 办理国家 | 原因 |
|-------|---------|------|
| 出发前 2 周 | 🇲🇾 马来西亚 | 预留邮件验证时间 |
| 出发前 1 周 | 🇹🇭 泰国、🇻🇳 越南 | 可提前填写，无时间限制 |
| 出发前 3 天 | 🇸🇬 新加坡、🇮🇩 印尼 | 按时间限制填写 |
| 出发前 72 小时 | 🇵🇭 菲律宾 | 严格按时间窗口填写 |

### 东亚 2 国游（日本、韩国）

**推荐办理时间表**：

| 时间点 | 办理国家 | 原因 |
|-------|---------|------|
| 出发前 2 周 | 🇰🇷 韩国 K-ETA | 需要审批时间（24-72 小时） |
| 出发前 1 周 | 🇯🇵 日本 Visit Japan Web | 预留时间处理可能的问题 |
| 出发前 3 天 | 🇰🇷 韩国 e-Arrival Card | 临近出发时填写 |

### 亚洲 8 国游（全部）

**推荐办理时间表**：

| 时间点 | 办理国家 | 原因 |
|-------|---------|------|
| 出发前 2 周 | 🇰🇷 韩国 K-ETA、🇯🇵 日本 | 需要审批或预留时间 |
| 出发前 1 周 | 🇲🇾 马来西亚、🇹🇭 泰国、🇻🇳 越南 | 预留邮件验证时间或提前填写 |
| 出发前 3 天 | 🇸🇬 新加坡、🇮🇩 印尼、🇰🇷 韩国 e-Arrival Card | 按时间限制填写 |
| 出发前 72 小时 | 🇵🇭 菲律宾 | 严格按时间窗口填写 |

## 常见问题

### Q1：如果行程变更怎么办？
**A**：
- **可修改**：日本、韩国 e-Arrival Card（登录账户修改）
- **需重新填写**：马来西亚、新加坡、印尼、菲律宾
- **无影响**：泰国、越南（可飞机上重新填写）

### Q2：哪些国家必须提前填写？
**A**：
- **必须提前**：韩国 K-ETA（需审批）、新加坡、印尼、菲律宾（有时间限制）
- **建议提前**：马来西亚、日本（需邮件验证）
- **可临时填写**：泰国、越南（可飞机上填写）

### Q3：哪些国家需要付费？
**A**：
- **需要付费**：韩国 K-ETA（55 元人民币）
- **完全免费**：其他所有国家

### Q4：哪些国家支持中文？
**A**：
- **完全中文**：印尼 All Indonesia
- **部分中文**：日本 Visit Japan Web、韩国 K-ETA + e-Arrival Card
- **仅英文**：马来西亚、泰国、新加坡、菲律宾
- **越南文/英文**：越南

### Q5：入境时需要出示什么？
**A**：
- **QR 码**：马来西亚、新加坡、印尼、菲律宾、日本（3个）、韩国
- **PDF 确认信**：马来西亚（推荐打印）
- **纸质表格**：泰国、越南（如飞机上填写）
- **K-ETA 批准通知**：韩国（电子版或纸质版）


path: reference/smart-document-recognition.md
content: # 智能文档识别功能说明

## 功能概述

智能文档识别功能允许用户通过上传护照、机票、酒店订单等文档，自动提取入境卡填写所需的信息，大大提升填写效率和准确性。

## 支持的文档类型

### 1. 📘 护照识别

#### 可提取信息
- 护照号码（Passport Number）
- 姓（Surname）
- 名（Given Name）
- 性别（Gender）
- 出生日期（Date of Birth）
- 国籍（Nationality）
- 护照签发国（Country of Issue）
- 护照有效期（Expiry Date）

#### 识别技术
- **MRZ 识别**：Machine Readable Zone（机器可读区）是护照底部的两行或三行字符，包含所有关键信息
- **OCR 技术**：光学字符识别，提取护照信息页的文字内容
- **AI 视觉理解**：使用 Claude 的视觉能力理解护照布局和内容

#### 最佳实践
```
✅ 推荐做法：
- 拍摄护照信息页（有照片的那一页）
- 确保光线充足，避免反光
- 护照平放，四个角都在画面内
- MRZ 区域（底部两行字符）清晰可读

❌ 避免：
- 模糊、倾斜的照片
- 部分遮挡或裁剪
- 过度曝光或阴影
```

#### 识别示例
```
输入：护照照片
输出：
✅ 已识别护照信息：
- 姓名：ZHANG SAN
- 护照号：E12345678
- 出生日期：01/01/1990
- 性别：Male
- 国籍：China
- 签发国：China
- 有效期：31/12/2030

MRZ 原始数据：
P<CHNZHANG<<SAN<<<<<<<<<<<<<<<<<<<<<<<<<<<<
E123456780CHN9001011M3012315<<<<<<<<<<<<<<06
```

---

### 2. ✈️ 机票识别

#### 可提取信息
- 航班号（Flight Number）
- 出发日期（Departure Date）
- 抵达日期（Arrival Date）
- 出发城市/机场（Departure City/Airport）
- 目的地城市/机场（Destination City/Airport）
- 航空公司（Airline）
- 订单号/PNR（Booking Reference）
- 乘客姓名（Passenger Name）

#### 识别技术
- **结构化数据提取**：识别电子机票的标准格式
- **关键字段定位**：定位航班号、日期、城市等关键信息
- **日期格式转换**：自动转换为标准格式（DD/MM/YYYY）

#### 支持的机票格式
- 电子机票 PDF
- 航空公司 APP 截图
- 邮件中的机票确认单
- 第三方订票平台（携程、飞猪等）的订单截图

#### 识别示例
```
输入：机票截图/PDF
输出：
✅ 已识别机票信息：

去程航班：
- 航班号：MH370
- 航空公司：Malaysia Airlines
- 出发：2026-04-15 10:30 Shanghai Pudong (PVG)
- 抵达：2026-04-15 16:45 Kuala Lumpur (KUL)
- 飞行时长：6小时15分钟

返程航班：
- 航班号：MH371
- 航空公司：Malaysia Airlines
- 出发：2026-04-22 18:00 Kuala Lumpur (KUL)
- 抵达：2026-04-23 00:15+1 Shanghai Pudong (PVG)

订单信息：
- PNR：ABC123
- 乘客：ZHANG/SAN
```

---

### 3. 🏨 酒店订单识别

#### 可提取信息
- 酒店名称（Hotel Name）
- 酒店地址（Hotel Address）
- 入住日期（Check-in Date）
- 退房日期（Check-out Date）
- 订单号（Confirmation Number）
- 预订人姓名（Guest Name）
- 房间类型（Room Type）
- 联系电话（Contact Number）

#### 识别技术
- **地址解析**：提取完整的酒店地址（街道、城市、国家）
- **日期识别**：识别入住和退房日期
- **多语言支持**：支持中英文混合的订单

#### 支持的订单格式
- Booking.com 确认单
- Agoda 订单
- 携程/去哪儿等国内平台订单
- 酒店官网预订确认邮件
- 酒店预订 APP 截图

#### 识别示例
```
输入：酒店订单截图/PDF
输出：
✅ 已识别酒店订单信息：

酒店信息：
- 名称：Grand Hyatt Kuala Lumpur
- 地址：12 Jalan Pinang, Kuala Lumpur, 50450, Malaysia
- 电话：+60 3-2182 1234

预订信息：
- 入住日期：2026-04-15（周二）
- 退房日期：2026-04-22（周二）
- 入住天数：7 晚
- 房间类型：Deluxe King Room
- 订单号：BKNG-123456789
- 预订人：Zhang San
```

---

## 信息整合与验证

### 自动整合流程

1. **文档分类**
   - 自动识别上传的文档类型（护照/机票/酒店）
   - 支持一次性上传多个文档

2. **信息提取**
   - 从每个文档中提取关键信息
   - 验证提取信息的格式和完整性

3. **数据整合**
   - 将多个文档的信息整合到统一的数据结构
   - 自动填充入境卡所需的字段
   - 标记已提取和待补充的字段

4. **信息确认**
   - 生成信息摘要供用户确认
   - 允许用户修正错误信息
   - 补充缺失的信息（如邮箱、手机号）

### 整合示例

```
📋 已自动提取的信息摘要：

✅ 护照信息（已完整）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
姓名：ZHANG SAN
护照号：E12345678
出生日期：01/01/1990
性别：Male
国籍：China
签发国：China
有效期：31/12/2030

✅ 行程信息（已完整）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
目的地国家：马来西亚 🇲🇾
航班号：MH370
入境日期：15/04/2026
出发城市：Shanghai (PVG)
返程航班：MH371
返程日期：22/04/2026

✅ 住宿信息（已完整）
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
酒店名称：Grand Hyatt Kuala Lumpur
酒店地址：12 Jalan Pinang, Kuala Lumpur, 50450, Malaysia
入住日期：15/04/2026
退房日期：22/04/2026

⚠️ 待补充信息
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📧 邮箱地址（必填）：用于接收入境卡确认邮件
📱 手机号码（推荐）：含国际区号，如 +86 138 0000 0000

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

请确认以上信息是否正确？
如有错误请告知，或提供待补充信息后说"继续"。
```

---

## 技术实现

### 使用的工具和技术

1. **read_image 工具**
   - 读取用户上传的图片
   - 支持 JPG、PNG、HEIC 等格式
   - 自动处理图片方向和大小

2. **Claude 视觉能力**
   - 理解文档布局和结构
   - 提取文字和关键信息
   - 验证信息的合理性

3. **MRZ 解析**
   - 解析护照 MRZ 区域
   - 验证校验位
   - 提取标准化信息

4. **正则表达式**
   - 验证护照号格式
   - 验证日期格式
   - 提取航班号、订单号等

### 识别准确性

| 文档类型 | 准确率 | 常见问题 | 解决方案 |
|---------|--------|---------|---------|
| 护照 | 95%+ | 模糊、反光 | 重新拍照，确保清晰 |
| 机票 | 90%+ | 格式多样 | 支持主流平台格式 |
| 酒店订单 | 85%+ | 地址不完整 | 人工补充完整地址 |

---

## 使用场景

### 场景 1：首次使用（完整流程）

```
用户：帮我填写马来西亚入境卡
      [上传护照照片]
      [上传机票截图]
      [上传酒店订单]

机器人：
✅ 已识别 3 个文档：
1. 护照信息（已提取）
2. 机票信息（已提取）
3. 酒店订单（已提取）

[显示信息摘要]

请提供邮箱地址和手机号码，或直接说"继续"。

用户：邮箱是 [REDACTED_SECRET]，手机是 +86 138 0000 0000

机器人：
✅ 信息已完整！

现在为您提供马来西亚 MDAC 入境卡的详细填写指南...
[后续流程]
```

### 场景 2：部分文档上传

```
用户：帮我填写泰国入境卡
      [只上传了护照照片]

机器人：
✅ 已识别护照信息
⚠️ 缺少行程信息

请提供以下信息：
- 航班号
- 入境日期
- 泰国住宿地址

或者上传机票和酒店订单，我可以自动提取。

用户：航班号 TG123，4月20日入境，住在曼谷的 ABC 酒店

机器人：
✅ 信息已完整！
[后续流程]
```

### 场景 3：信息修正

```
用户：[上传护照照片]

机器人：
✅ 已识别护照信息：
- 姓名：ZHANG SAN
- 护照号：E12345678
...

用户：护照号识别错了，应该是 E12345679

机器人：
✅ 已更正：
- 护照号：E12345679

请确认其他信息是否正确？
```

---

## 优势与限制

### ✅ 优势

1. **节省时间**
   - 无需手动输入 10+ 个字段
   - 一次上传，多次使用
   - 平均节省 5-10 分钟

2. **减少错误**
   - 避免手动输入的拼写错误
   - 避免日期格式错误
   - 避免姓名顺序错误

3. **提高准确性**
   - 直接从官方文档提取
   - 自动格式验证
   - 信息一致性检查

4. **用户体验好**
   - 操作简单，拍照即可
   - 即时反馈
   - 支持多文档批量上传

### ⚠️ 限制

1. **依赖文档质量**
   - 需要清晰的照片或扫描件
   - 模糊、倾斜的照片可能识别失败

2. **格式多样性**
   - 不同平台的机票、酒店订单格式不同
   - 可能需要人工补充或修正

3. **隐私考虑**
   - 护照等敏感信息需要安全处理
   - 建议使用后删除上传的文档

4. **网络依赖**
   - 需要上传文档到云端处理
   - 大文件可能上传较慢

---

## 安全与隐私

### 数据处理原则

1. **最小化原则**
   - 只提取必要的信息
   - 不保存原始文档
   - 处理完成后删除临时数据

2. **加密传输**
   - 文档上传使用 HTTPS 加密
   - 敏感信息不明文存储

3. **用户控制**
   - 用户可以选择不上传文档
   - 用户可以手动输入信息
   - 用户可以修正识别错误

4. **透明度**
   - 明确告知用户提取了哪些信息
   - 允许用户确认和修正
   - 提供信息删除选项

---

## 未来改进方向

### 短期改进（1-3 个月）

1. **支持更多文档格式**
   - 支持 PDF 直接解析
   - 支持邮件附件自动提取
   - 支持多页文档

2. **提高识别准确率**
   - 优化 MRZ 解析算法
   - 增加更多机票平台支持
   - 改进地址解析能力

3. **增强用户体验**
   - 实时识别反馈
   - 识别进度提示
   - 批量文档处理

### 中期改进（3-6 个月）

1. **智能表单填写**
   - 自动填充网页表单
   - 支持浏览器插件
   - 一键提交功能

2. **多语言支持**
   - 支持识别多语言文档
   - 自动翻译地址信息
   - 多语言界面

3. **历史记录管理**
   - 保存已识别的信息
   - 快速复用历史信息
   - 多次旅行管理

### 长期改进（6-12 个月）

1. **AI 智能助手**
   - 主动提醒填写时间
   - 智能推荐办理顺序
   - 异常情况预警

2. **全流程自动化**
   - 自动登录官网
   - 自动填写表单
   - 自动下载确认文件

3. **生态系统集成**
   - 与旅行 APP 集成
   - 与航空公司系统对接
   - 与酒店预订平台联动

---

## 常见问题

### Q1: 识别失败怎么办？
**A:** 如果识别失败，可以：
1. 重新拍照，确保清晰
2. 手动输入信息
3. 联系客服获取帮助

### Q2: 支持哪些语言的文档？
**A:** 目前主要支持：
- 中文
- 英文
- 中英文混合

### Q3: 识别需要多长时间？
**A:** 通常：
- 护照：2-5 秒
- 机票：3-8 秒
- 酒店订单：3-8 秒

### Q4: 我的信息安全吗？
**A:** 是的，我们：
- 使用加密传输
- 不保存原始文档
- 处理完成后删除数据
- 符合隐私保护法规

### Q5: 可以识别旧版护照吗？
**A:** 可以，只要：
- 护照信息页清晰
- MRZ 区域完整
- 照片光线充足

### Q6: 识别错误可以修正吗？
**A:** 可以，系统会：
- 显示识别结果供确认
- 允许用户手动修正
- 重新验证修正后的信息

### Q7: 支持批量处理吗？
**A:** 支持，可以：
- 一次上传多个文档
- 自动分类和提取
- 批量确认信息

### Q8: 需要特殊的拍照技巧吗？
**A:** 建议：
- 光线充足
- 护照平放
- 避免反光
- 四角完整
- 对焦清晰

---

## 总结

智能文档识别功能通过 AI 视觉技术，自动提取护照、机票、酒店订单中的关键信息，大大简化了入境卡填写流程。用户只需上传文档，系统即可自动提取并整合信息，节省时间、减少错误、提高准确性。

**核心价值**：
- 🚀 **效率提升**：节省 5-10 分钟填写时间
- ✅ **准确性高**：避免手动输入错误
- 😊 **体验优秀**：操作简单，即拍即用
- 🔒 **安全可靠**：加密传输，隐私保护

欢迎体验智能文档识别功能，让入境卡填写更轻松！


path: reference/country-guides.md
content: # 各国入境卡详细填写指南

## 🇲🇾 马来西亚 MDAC 填写流程

填写马来西亚电子入境卡（MDAC）是入境前的必要步骤。别担心，流程并不复杂，我为你整理了一份详细的填写指南，你跟着一步步操作就行。

---

### 📋 填写前准备

在开始填写前，请确保你已经准备好以下信息，这样填写起来会更顺畅：

- **护照**：有效期需在 6 个月以上
- **航班信息**：准确的航班号和出发地
- **在马来西亚的住址**：建议提前预订好酒店，并准备好酒店的英文全称和详细地址
- **电子邮箱**：用于接收确认邮件和 PIN 码
- **填写时间**：最早可在出发前 3 天（含出发当天）填写

---

### 🌐 官方填写入口

⚠️ **请务必通过马来西亚移民局官方网站进行填写，谨防钓鱼网站。**

**官方网站**：https://imigresen-online.imi.gov.my/mdac/main

---

### 📝 详细填写步骤

整个流程分为 **"注册填写"** 和 **"验证下载"** 两个部分。

#### 第一步：注册并填写信息 (REGISTER)

1. 进入官网后，点击红色的 **REGISTER** 按钮开始填写
2. 根据页面提示，如实填写个人信息和旅行信息
3. ⚠️ **所有信息建议使用英文大写字母填写**

**详细填写表格**：

| 填写项目 | 说明与示例 |
|---------|-----------|
| **个人信息 (Personal Information)** | |
| 姓名 (Name) | 与护照信息页一致，姓和名之间用空格隔开<br>例如：`ZHANG SAN` |
| 护照号 (Passport No.) | 填写护照右上角的号码<br>例如：`E12345678` |
| 国籍 (Nationality) | 选择 `CHINA` |
| 出生日期 (Date of Birth) | 按照 **日/月/年** 的格式填写<br>例如：`01/01/1990` |
| 性别 (Sex) | 男性选 `MALE`，女性选 `FEMALE` |
| 护照有效期 (Date of Passport Expiry) | 按照护照信息页填写<br>例如：`31/12/2030` |
| 电子邮箱 (Email Address) | 填写一个常用且能正常接收邮件的邮箱<br>例如：`[REDACTED_SECRET]` |
| 手机号码 (Mobile No.) | 填写你的中国手机号，前面加上国家代码 `+86`<br>例如：`+86 138 0000 0000` |
| **旅行信息 (Traveling Information)** | |
| 抵达日期 (Date of Arrival) | 你抵达马来西亚的日期<br>例如：`15/04/2026` |
| 旅行方式 (Mode of Travel) | 飞机入境选择 `AIR` |
| 离开日期 (Date of Departure) | 你离开马来西亚的日期<br>例如：`22/04/2026` |
| 出发地 (Last Port of Embarkation) | 你登机前的最后一个国家<br>例如：`CHINA` |
| 航班号 (Flight No.) | 填写你的航班号<br>例如：`MH370` |
| 住宿类型 (Accommodation of Stay) | 住酒店选择 `HOTEL/MOTEL/RESTHOUSE` |
| 酒店地址 (Address in Malaysia) | 填写酒店的英文全称和街道地址<br>例如：`Grand Hyatt Kuala Lumpur, 12 Jalan Pinang` |
| 州/城市/邮编 (State/City/Postcode) | 根据酒店所在地选择或填写，常用城市邮编见下方参考 |

**常用城市及邮编参考**：

| 城市 | 州 (State) | 城市 (City) | 邮编 (Postcode) |
|------|-----------|------------|----------------|
| 吉隆坡 (Kuala Lumpur) | WP KUALA LUMPUR | KUALA LUMPUR | 50000 |
| 槟城 (Penang) | PULAU PINANG | GEORGE TOWN | 11600 |
| 仙本那 (Semporna) | SABAH | SEMPORNA | 91308 |
| 马六甲 (Malacca) | MELAKA | MELAKA | 75000 |
| 新山 (Johor Bahru) | JOHOR | JOHOR BAHRU | 80000 |
| 兰卡威 (Langkawi) | KEDAH | LANGKAWI | 07000 |

4. 确认所有信息无误后，点击 **SUBMIT** 提交

---

#### 第二步：验证并下载确认信 (CHECK REGISTRATION)

1. 提交后，系统会提示你一封确认邮件已发送至你的邮箱。**请立刻登录邮箱查收**
2. 在邮件中找到并复制 **PIN 码**
3. 返回 MDAC 官网首页，点击 **CHECK REGISTRATION** 按钮
4. 依次输入：
   - 你的护照号
   - 国籍 (`CHINA`)
   - 刚刚收到的 PIN 码
5. 完成人机验证后点击 **SUBMIT**
6. 页面会显示你填写的完整信息，在页面底部找到下载图标，点击即可下载 **PDF 格式的正式入境卡确认信**

---

### ⚠️ 重要提醒

#### 📄 保存凭证
- ✅ **务必将下载好的 PDF 确认信打印一份纸质版随身携带**
- ✅ **同时也在手机里保存好电子版**
- 入境时移民官员可能会要求出示

#### 🚪 自助通关
- 持有 6 个月以上有效期护照的中国公民
- 在吉隆坡国际机场等指定口岸可以使用自助通关闸门（Autogate）入境
- 非常便捷，节省排队时间

#### ✈️ 转机情况
- 如果你的航班在马来西亚转机，且需要更换航站楼或重新托运行李
- 也算作入境，同样需要填写 MDAC

#### 🆓 豁免人群
以下人群可豁免填写：
- 持有马来西亚长期通行证
- 马来西亚永久居民
- 新加坡、文莱等特定国家护照的人员

---

### 🔧 常见问题处理

#### Q1: 没有收到 PIN 码邮件怎么办？
**A:** 
1. 检查垃圾邮件箱
2. 确认填写的邮箱地址正确
3. 等待 5-10 分钟后重新检查
4. 如仍未收到，可以重新提交一次

#### Q2: 填写错误可以修改吗？
**A:** 
- 提交前：可以随时修改
- 提交后：需要重新填写一份新的，使用新的 PIN 码下载

#### Q3: 可以提前多久填写？
**A:** 
- 没有明确的提前时间限制
- 建议在确定行程后再填写
- 最晚在出发前完成即可

#### Q4: 入境时需要出示什么？
**A:** 
- PDF 确认信（纸质版或电子版）
- 护照
- 往返机票
- 酒店预订单（可能抽查）

---

## 🇹🇭 泰国 TDAC（TM6）电子入境卡填写流程

填写泰国电子入境卡（TDAC）是入境前的必要步骤。别担心，流程并不复杂，我为你整理了一份详细的填写指南，你跟着一步步操作就行。

⚠️ **重要更新**：原来的纸质 TM6 入境卡已被泰国数字入境卡（Thailand Digital Arrival Card，简称 TDAC）取代，自 2025 年 5 月 1 日起生效。

---

### 📋 填写前准备

在开始填写前，请确保你已经准备好以下信息，这样填写起来会更顺畅：

| 材料 | 说明 | 备注 |
|------|------|------|
| **有效护照** | 用于填写个人资料 | 确保护照有效期在 6 个月以上 |
| **航班信息** | 抵达及离境航班编号 | 如：TG601、CA979 |
| **泰国住宿地址** | 酒店或住宿地的完整英文地址 | 不可仅填写酒店名称 |
| **电子邮箱** | 用于接收 TDAC 确认邮件和 QR Code | 建议使用常用邮箱 |
| **联系电话** | 个人有效的手机号码 | 国际格式，如：+86-138xxxxxxx |
| **旅行目的** | 选择旅游、商务等 | 根据实际情况选择 |

**填写时间要求**：
- ⏰ **必须在抵达泰国前 3 天（72 小时）内**完成填写
- ⚠️ 过早填写可能导致信息失效
- ⚠️ 超过时间限制可能被航空公司拒绝登机

---

### 🌐 官方填写入口

⚠️ **请务必通过泰国移民局官方网站进行填写，谨防钓鱼网站。**

**官方网站**：https://tdac.immigration.go.th/arrival-card/#/home

**重要提醒**：
- ✅ 这是泰国移民局官网，**申请完全免费**
- ⚠️ 请认准 `.gov.th` 后缀，谨防第三方收费网站
- ❌ 不要使用任何需要付费的代办服务

**网站语言选择**：
- 网站提供 **英文** 和 **简体中文** 版本
- 建议选择您熟悉的语言进行填写

---

### 📝 详细填写步骤

#### 第一步：开始填写

1. 访问官方网址 https://tdac.immigration.go.th/arrival-card/#/home
2. 系统会进行人机验证
3. 验证成功后，点击 **"Arrival Card"** 按钮开始填写

#### 第二步：填写个人资料（护照信息）

| 字段名称 | 填写说明 | 示例 |
|----------|----------|------|
| **英文姓名** | 必须与护照完全一致（大写） | ZHANG SAN |
| **国籍** | 选择您的国籍 | CHINESE |
| **护照号码** | 护照上的完整号码 | E12345678 |
| **出生日期** | 西元年-月-日 | 1990-01-15 |
| **性别** | 选择 Male 或 Female | Male |
| **护照签发日期** | 护照上的 Issue Date | 2020-05-10 |
| **护照有效期** | 护照上的 Expiry Date | 2030-05-09 |

**💡 小技巧**：
- 可以扫描护照底部的 **MRZ（机器可读区）** 自动提取数据
- 也可以上传 MRZ 图片自动填写
- 确保所有信息与护照**完全一致**

#### 第三步：填写行程和住宿信息

| 字段名称 | 填写说明 | 示例 |
|----------|----------|------|
| **抵达航班号** | 飞往泰国的航班编号 | TG601 |
| **抵达日期** | 抵达泰国的日期 | 2026-04-05 |
| **离境航班号** | 离开泰国的航班编号 | TG602 |
| **离境日期** | 离开泰国的日期 | 2026-04-10 |
| **在泰国地址** | 完整的英文住宿地址 | 见下方地址格式 |
| **邮政编码** | 住宿地的邮政编码 | 10110 |
| **旅行目的** | 选择旅游/商务/其他 | Tourism |

**泰国地址填写格式**：

对于酒店，请按以下格式填写（仅限英文）：

```
第一行：酒店名称
第二行：街道地址
第三行：城市名称
```

**示例**：
```
Shangri-La Hotel Bangkok
89 Wireless Road, Lumpini, Pathum Wan
Bangkok 10330, Thailand
```

#### 第四步：健康状况信息

根据泰国卫生部的要求填写健康信息：
- 如果您在抵达前两周内访问过特定国家
- 如果您登机的国家被卫生部列出
- 如果您的国籍或航班被卫生部列出

系统会提示您输入必要的健康信息，如实填写即可。

#### 第五步：添加同行旅客（可选）

如果您有同行旅客：
1. 点击 **"Add Other Travelers"** 按钮
2. 重复步骤 2-4 填写每位旅客的详细信息
3. 如果行程和住宿信息相同，可以选择 **"与上一个旅客相同"**
4. 最多可同时申请 **10 人**（一个邮箱账号）

#### 第六步：预览和确认

1. 点击 **"Preview"** 查看所有信息
2. 仔细检查每个字段
3. 如有错误，点击 **"Edit"** 返回修改
4. 如需删除某位旅客，点击 **"Delete This Traveler"**

#### 第七步：提交申请

1. 输入您的**电子邮箱地址**
2. 勾选同意条款和条件
3. 点击 **"Submit"** 提交申请
4. 系统会发送确认邮件到您的邮箱

#### 第八步：获取 TDAC 凭证

1. 提交成功后，**立即下载泰国数字入境卡**
2. 也可以通过邮件链接下载或打印副本
3. **务必保存 QR Code**，入境时需要出示

---

### ⚠️ 重要提醒

#### ⏰ 时间限制

| 项目 | 要求 |
|------|------|
| **填写时间** | 抵达泰国前 3 天（72 小时）内 |
| **最佳填写时间** | 出发前 1-2 天 |
| **有效期** | 仅限单次入境使用 |

#### 📱 QR Code 保存
- ✅ **必须截屏保存 QR Code**
- ✅ 将确认邮件保存到手机或打印出来
- ✅ 入境时出示 QR Code 与护照
- ⚠️ 确保手机有足够电量或准备纸质备份

#### 👨‍👩‍👧‍👦 同行旅客
- ✅ 一家人可由一位代表同时申请
- ✅ 同一行程可填写相同住宿信息
- ⚠️ 一个邮箱最多可同时申请 10 人
- ⚠️ 入境时需在同一通关柜台排队

#### 💰 免费提醒
- ✅ 官方申请**完全免费**
- ❌ 警惕任何收费的代办服务
- ❌ 不要使用非官方的第三方网站

---

### 🏙️ 常用城市参考信息

#### 热门旅游城市代码与邮编

| 城市中文名 | 英文名 | 机场代码 | 常用地址示例 | 邮政编码 |
|------------|--------|----------|--------------|----------|
| 曼谷 | Bangkok | BKK | Siam Square / Khaosan Road | 10110 |
| 清迈 | Chiang Mai | CNX | Old City / Night Bazaar | 50000 |
| 清莱 | Chiang Rai | CEI | Night Bazaar area | 57000 |
| 普吉岛 | Phuket | HKT | Patong Beach / Old Town | 83000 |
| 芭提雅 | Pattaya | - | Beach Road / Walking Street | 20160 |
| 华欣 | Hua Hin | HHQ | Hua Hin Beach area | 77110 |
| 合艾 | Hat Yai | HDY | City Center | 90110 |

#### 曼谷热门区域地址参考

| 区域 | 常见地址示例 |
|------|--------------|
| 暹罗区 | Siam Square, Pathum Wan, Bangkok |
| 考山路 | Khaosan Road, Phra Nakhon, Bangkok |
| 素坤逸 | Sukhumvit Road, Khlong Toei, Bangkok |
| 沙吞 | Sathon Road, Bang Rak, Bangkok |
| 湄南河 | Riverside, Bangkok |

---

### 🔧 常见问题处理

#### Q1: 填写错了怎么办？
**A**: 
- 在提交前可以随时点击 **"Edit"** 修改
- 如果已经提交，需要重新申请一份新的 TDAC
- 建议仔细检查后再提交

#### Q2: 忘记保存 QR Code 怎么办？
**A**:
- 检查注册邮箱，查找确认邮件
- 邮件中包含 TDAC 和 QR Code 的下载链接
- 如未收到邮件，检查垃圾邮件文件夹

#### Q3: 可以提前多久填写？
**A**:
- 最早可提前 3 天填写
- 建议在出发前 1-2 天填写
- 不要过早填写，以免信息失效

#### Q4: 外交护照或机组人员需要填写吗？
**A**:
- 需要填写，只要不是泰国国籍都需要提交 TDAC
- 包括外交护照持有人和机组人员

#### Q5: 陆路或海路入境怎么办？
**A**:
- 空路入境填写航班号
- 陆路入境填写车牌号码
- 海路入境填写船名或班次

#### Q6: 健康申报需要填写什么？
**A**:
- 系统会根据您的行程自动判断
- 如果您访问过特定国家或航班被卫生部列出
- 会提示您填写必要的健康信息

#### Q7: 一家人如何申请？
**A**:
- 可由一位代表同时申请
- 添加同行旅客信息
- 入境时在同一通关柜台排队
- 出示所有成员的 QR Code

#### Q8: 地址只写城市名可以吗？
**A**:
- ❌ 不可以，仅填写城市名是不够的
- ✅ 必须填写完整的酒店或住宿地址
- ✅ 包括酒店名称、街道地址、城市、邮编

#### Q9: 落地签需要先填写 TDAC 吗？
**A**:
- 需要，在机场办理落地签前
- 先填写好 TDAC 入境卡
- 签证号码留白，由柜台人员填写

---

## 🇸🇬 新加坡 SG Arrival Card 填写流程

填写新加坡电子入境卡（SG Arrival Card，简称 SGAC）是入境前的必要步骤。别担心，流程并不复杂，我为你整理了一份详细的填写指南，你跟着一步步操作就行。

---

### 📋 填写前准备

在开始填写前，请确保你已经准备好以下信息，这样填写起来会更顺畅：

- **护照**：有效期需在 6 个月以上
- **航班信息**：准确的航班号和出发地
- **在新加坡的住址**：建议提前预订好酒店，并准备好酒店的英文全称和详细地址
- **电子邮箱**：用于接收确认邮件
- **手机号码**：含国家代码的中国手机号
- **填写时间**：⚠️ **必须在入境前 3 天（72 小时）内填写**

---

### 🌐 官方填写入口

⚠️ **请务必通过新加坡移民与关卡局官方网站进行填写，谨防钓鱼网站。**

**官方网站**：https://eservices.ica.gov.sg/sgarrivalcard/

---

### ⏰ 时间限制说明

**重要**：新加坡电子入境卡必须在入境前 3 天（72 小时）内填写，过早或过晚都无效。

**举例说明**：
- 如果你计划在 **4 月 15 日** 入境新加坡
- 最早可以在 **4 月 12 日** 填写（入境前 3 天，含入境当日）
- 建议在 **4 月 13-14 日** 填写，留出充足时间

---

### 📝 详细填写步骤

整个流程分为 **"填写信息"** 和 **"接收确认"** 两个部分。

#### 第一步：访问网站并选择语言

1. 进入官网 https://eservices.ica.gov.sg/sgarrivalcard/
2. 页面右上角选择语言为 **"简体中文"**，便于填写
3. 点击 **"提交新加坡入境卡"**（Submit SG Arrival Card）
4. 选择 **"外国旅客"**（Foreign Visitors）

#### 第二步：填写个人信息

**详细填写表格**：

| 填写项目 | 说明与示例 |
|---------|-----------|
| **个人信息 (Personal Information)** | |
| 护照号码 (Passport Number) | 填写护照右上角的号码<br>例如：`E12345678` |
| 国籍 (Nationality) | 选择 `CHINA` |
| 出生日期 (Date of Birth) | 按照护照信息页填写<br>例如：`01/01/1990` |
| 护照有效期 (Passport Expiry Date) | 按照护照信息页填写<br>例如：`31/12/2030` |
| **姓名信息 (Name Information)** | |
| 姓 (Surname) | 与护照信息页一致<br>例如：`ZHANG` |
| 名 (Given Name) | 与护照信息页一致<br>例如：`SAN` |
| 性别 (Gender) | 男性选 `Male`，女性选 `Female` |
| **联系信息 (Contact Information)** | |
| 电子邮箱 (Email Address) | 填写一个常用且能正常接收邮件的邮箱<br>例如：`[REDACTED_SECRET]` |
| 手机号码 (Mobile Number) | 填写你的中国手机号，前面加上国家代码 `+86`<br>例如：`+86 138 0000 0000` |

#### 第三步：填写行程信息

| 填写项目 | 说明与示例 |
|---------|-----------|
| **旅行信息 (Travel Information)** | |
| 抵达日期 (Date of Arrival) | 你抵达新加坡的日期<br>例如：`15/04/2026` |
| 交通方式 (Mode of Travel) | 飞机入境选择 `Air` |
| 航班号 (Flight/Vessel Number) | 填写你的航班号<br>例如：`SQ123` |
| 出发地 (Last City/Port of Embarkation) | 你登机前的最后一个城市<br>例如：`Shanghai` |
| 离开新加坡后的下一站 (Next City/Port of Disembarkation After Singapore) | 如果离开新加坡前往其他国家，填写该城市<br>例如：`Kuala Lumpur`<br>如果直接返回中国，可填写 `China` |
| 旅行目的 (Purpose of Visit) | 选择 `Tourism`（旅游）或 `Business`（商务）等 |

#### 第四步：填写住宿信息

| 填写项目 | 说明与示例 |
|---------|-----------|
| **住宿信息 (Accommodation Information)** | |
| 住宿类型 (Accommodation Type) | 选择 `Hotel`（酒店）或 `Residential`（住宅）或 `Others`（其他） |
| 新加坡住宿地址 (Address in Singapore) | **必须填写具体的地址**，不能只填 `Singapore`<br>酒店格式：`酒店名称, 街道地址, 邮编`<br>例如：`Marina Bay Sands, 10 Bayfront Avenue, 018956`<br>住宅格式：`街道地址, 邮编`<br>例如：`123 Orchard Road, 238874` |
| 停留天数 (Length of Stay) | 填写预计停留天数<br>例如：`7` |

**常见住宿地址格式参考**：

| 住宿类型 | 地址格式示例 |
|---------|-------------|
| **滨海湾金沙酒店** | `Marina Bay Sands, 10 Bayfront Avenue, 018956` |
| **圣淘沙香格里拉酒店** | `Shangri-La's Rasa Sentosa Resort & Spa, 101 Siloso Road, 098970` |
| **乌节路希尔顿酒店** | `Hilton Singapore Orchard, 581 Orchard Road, 238883` |
| **亲友住宅** | `123 Ang Mo Kio Avenue 4, 569888` |
| **Airbnb 民宿** | `456 Newton Road, 307964` |

#### 第五步：健康申报

| 填写项目 | 说明与示例 |
|---------|-----------|
| **健康申报 (Health Declaration)** | |
| 是否有发热、咳嗽等症状 | 选择 `No`（无）或 `Yes`（有） |
| 过去 14 天是否去过非洲或拉丁美洲国家 | 选择 `No`（无）或 `Yes`（有） |

#### 第六步：资料确认

1. 系统会显示所有填写的资料
2. **请务必仔细核对所有信息**，确保无误
3. 确认无误后，点击 **"下一页"**（Next）

#### 第七步：完成提交

1. 输入验证码
2. 点击 **"提交"**（Submit）完成
3. 页面会显示提交结果和 PDF 文件下载链接
4. 电子邮件也会收到结果通知

---

### ⚠️ 重要提醒

#### 📄 保存凭证
- ✅ **建议保存确认邮件或截图**
- ✅ **PDF 没有下载也没关系**，系统已记录你的信息
- 入境时无需出示纸质版，系统会自动验证

#### 🚪 自助通关
- 持有 6 个月以上有效期护照的中国公民
- 6 岁及以上且护照含晶片
- 可以使用自助通关闸门（Autogate）入境
- **非常便捷，节省排队时间**
- 只需插入护照、扫描面部、录入指纹即可

#### ⚠️ 时间限制
- **必须在入境前 3 天（72 小时）内填写**
- 过早填写无效，系统会拒绝
- 过晚填写可能导致无法顺利入境

#### ✈️ 航班延误或取消
- 如果航班延误，**不需要重填入境卡**，保留原本完成的入境卡资料即可
- 如果航班取消并改期到 3 天后，则需要重新填写

#### 🆓 费用说明
- 填写新加坡入境卡**完全免费**
- 任何要求付费的网站都是钓鱼网站，请特别小心

---

### 🔧 常见问题处理

#### Q1: 没有收到确认邮件怎么办？
**A:** 
1. 检查垃圾邮件箱
2. 确认填写的邮箱地址正确
3. 等待 5-10 分钟后重新检查
4. 如仍未收到，可以重新提交一次

#### Q2: 填写错误可以修改吗？
**A:** 
- 提交前：可以随时修改
- 提交后：可以通过 **"更新入境卡"**（Update SGAC）选项修改已有资料
- 如果只是航班号或日期变更，不需要完整重填

#### Q3: 可以提前多久填写？
**A:** 
- **最早只能在入境前 3 天填写**
- 例如：4 月 15 日入境，最早 4 月 12 日才能填写
- 建议在入境前 1-2 天填写

#### Q4: 入境时需要出示什么？
**A:** 
- 护照（有效期 6 个月以上）
- 往返机票（可能抽查）
- 酒店预订单（可能抽查）
- **入境卡无需出示**，系统已自动记录

#### Q5: 住朋友家，地址怎么填？
**A:** 
- 住宿类型选择 `Residential`（住宅）
- 填写朋友家的完整地址
- 可以填写朋友的租房地址，只要信息真实准确即可

#### Q6: 单日过境新加坡需要填写吗？
**A:** 
- 需要，所有外国旅客都必须填写
- 旅行目的选择 `Transit`（过境）
- 停留天数填写 `1`

#### Q7: 转机需要填写吗？
**A:** 
- 如果转机需要更换航站楼或重新托运行李，算作入境，需要填写
- 如果是同航站楼转机且不离开禁区，通常不需要填写

#### Q8: 小孩需要单独填写吗？
**A:** 
- 需要，所有旅客（包括小孩）都需要填写
- 可以在填写时选择 **"添加旅客"**（Add Traveller）一次性为多人填写

#### Q9: 邮箱大小写有关系吗？
**A:** 
- 没有关系，邮箱地址不区分大小写
- 网站上设置为大写，实际邮箱是小写也可以正常接收邮件

#### Q10: PDF 没下载成功怎么办？
**A:** 
- 没关系，PDF 不是必需的
- 只要提交成功，系统已记录你的信息
- 入境时系统会自动验证，无需出示纸质版

---

### 🎯 填写小贴士

1. **所有信息建议使用英文填写**
2. **姓名必须与护照完全一致**，包括拼写顺序
3. **住宿地址必须具体**，不能只填 "Singapore"
4. **手机号码要加国家代码 +86**
5. **提前准备好所有信息**，填写过程约 5-10 分钟
6. **仔细核对后再提交**，避免错误
7. **保存确认邮件截图**，以备查询

---

## 🇮🇩 印尼 e-Arrival Card 填写流程

### 目标网站信息
- **网站地址**：https://ecd.imigrasi.go.id/
- **推荐环境**：电脑浏览器或手机浏览器
- **流程类型**：注册 → 填写 → 提交 → 下载 PDF

### 节点一：注册账号

**操作步骤**：
1. 访问 https://ecd.imigrasi.go.id/
2. 点击"Register"注册
3. 填写邮箱和密码
4. 验证邮箱

**验证检查点**：
- ✅ 注册成功
- ✅ 邮箱验证完成
- ✅ 可以登录

### 节点二：填写入境卡信息

**操作步骤**：
1. 登录账号
2. 点击"New Arrival Card"
3. 填写护照信息
   - Passport Number（护照号码）
   - Nationality（国籍）
   - Date of Birth（出生日期）
   - Passport Expiry Date（护照有效期）

4. 填写个人信息
   - Full Name（全名）
   - Gender（性别）
   - Occupation（职业）

5. 填写行程信息
   - Flight Number（航班号）
   - Port of Entry（入境口岸）：如 Ngurah Rai Airport (Bali)
   - Date of Arrival（抵达日期）
   - Address in Indonesia（印尼住宿地址）

**验证检查点**：
- ✅ 所有必填字段已填写
- ✅ 入境口岸选择正确
- ✅ 日期格式正确

### 节点三：提交并下载

**操作步骤**：
1. 检查所有信息无误
2. 点击"Submit"提交
3. 系统生成 PDF 文件
4. 下载并保存 PDF
5. 打印纸质版（推荐）

**验证检查点**：
- ✅ 提交成功
- ✅ PDF 下载成功
- ✅ PDF 内容清晰完整

**重要提示**：
- 虽非强制，但强烈推荐填写，可大幅加快入境速度
- 入境时出示电子版或纸质版
- PDF 在 90 天内有效

---

## 🇻🇳 越南入境申报表填写流程

### 目标网站信息
- **网站地址**：https://dichvucong.bocongan.gov.vn/
- **推荐环境**：电脑浏览器或手机浏览器
- **流程类型**：在线预填 → 提交 → 保存 QR 码

### 节点一：访问网站并选择服务

**操作步骤**：
1. 访问 https://dichvucong.bocongan.gov.vn/
2. 选择"Khai báo y tế"（健康申报）
3. 选择"Nhập cảnh"（入境）

**验证检查点**：
- ✅ 页面正常加载
- ✅ 选择正确的申报类型

### 节点二：填写申报信息

**操作步骤**：
1. 填写护照信息
   - Số hộ chiếu（护照号码）
   - Quốc tịch（国籍）
   - Ngày sinh（出生日期）

2. 填写个人信息
   - Họ và tên（全名）
   - Giới tính（性别）
   - Email

3. 填写行程信息
   - Số chuyến bay（航班号）
   - Ngày nhập cảnh（入境日期）
   - Địa chỉ lưu trú（住宿地址）
   - Số visa（签证号码，如有）

4. 健康申报
   - 健康状况
   - 疫苗接种情况
   - 过去 14 天旅行史

**验证检查点**：
- ✅ 所有必填字段已填写
- ✅ 健康申报已完成
- ✅ 日期格式正确

### 节点三：提交并保存

**操作步骤**：
1. 检查所有信息无误
2. 点击"Gửi"（提交）
3. 系统生成 QR 码
4. 保存 QR 码截图

**验证检查点**：
- ✅ 提交成功
- ✅ 获得 QR 码
- ✅ 已保存截图

**重要提示**：
- 可在线预填或飞机上填写纸质版
- 入境时出示 QR 码或纸质版
- 建议提前在线填写

---

## 🇵🇭 菲律宾 eTravel 填写流程

### 目标网站信息
- **网站地址**：https://etravel.gov.ph/
- **推荐环境**：电脑浏览器或手机浏览器
- **流程类型**：注册 → 填写 → 提交 → 接收 QR 码
- **时间限制**：⚠️ 必须在出发前 72 小时内填写

### 节点一：注册账号

**操作步骤**：
1. 访问 https://etravel.gov.ph/
2. 点击"Register"注册
3. 填写邮箱、密码和手机号
4. 验证邮箱和手机

**验证检查点**：
- ✅ 注册成功
- ✅ 邮箱和手机验证完成
- ✅ 可以登录

### 节点二：填写 eTravel 信息

**操作步骤**：
1. 登录账号
2. 点击"New eTravel"
3. 填写护照信息
   - Passport Number（护照号码）
   - Nationality（国籍）
   - Date of Birth（出生日期）
   - Passport Expiry Date（护照有效期）

4. 填写个人信息
   - Surname（姓）
   - Given Name（名）
   - Gender（性别）
   - Occupation（职业）

5. 填写行程信息
   - Flight Number（航班号）
   - Date of Arrival（抵达日期）
   - Date of Departure（离境日期）
   - Address in Philippines（菲律宾住宿地址）
   - Port of Entry（入境口岸）

6. 健康和海关申报
   - 健康状况
   - 携带物品申报
   - 是否携带超过 10,000 美元现金

**验证检查点**：
- ✅ 所有必填字段已填写
- ✅ 日期在 72 小时内
- ✅ 健康和海关申报已完成

### 节点三：提交并接收 QR 码

**操作步骤**：
1. 检查所有信息无误
2. 点击"Submit"提交
3. 系统发送 QR 码到邮箱和手机
4. 保存 QR 码截图或打印

**验证检查点**：
- ✅ 提交成功
- ✅ 收到 QR 码
- ✅ 已保存电子版或打印

**重要提示**：
- ⚠️ 必须在出发前 72 小时内填写
- 入境时必须出示 QR 码（电子版或纸质版）
- QR 码在 72 小时内有效
- 包含健康和海关申报，入境时无需再填写其他表格


path: reference/automation-framework.md
content: # 自动化脚本设计（通用框架）

## 技术选型建议

| 技术方案 | 适用场景 | 优势 | 劣势 |
|---------|---------|------|------|
| Selenium WebDriver | 多国家自动化 | 稳定、跨浏览器、可处理复杂交互 | 需要环境配置 |
| Puppeteer | Node.js 环境 | 轻量、速度快、Chrome 原生支持 | 仅支持 Chrome 系 |
| Playwright | 跨浏览器自动化 | 现代化、支持多浏览器、API 友好 | 相对较新 |

## 通用自动化框架伪代码

**⚠️ 重要说明**：
- 以下伪代码仅为示例性质，展示多国家自动化流程的逻辑结构
- 实际实现时需要根据每个国家网站的实际 DOM 结构进行调整
- 网站界面可能随时更新，需要定期维护

```javascript
// 通用入境卡填写框架
class ArrivalCardAutomation {
  constructor(country, userInfo) {
    this.country = country
    this.userInfo = userInfo
    this.config = this.getCountryConfig(country)
  }
  
  // 获取国家配置
  getCountryConfig(country) {
    const configs = {
      'malaysia': {
        url: 'https://imigresen-online.imi.gov.my/mdac/main',
        dateFormat: 'DD/MM/YYYY',
        requiresEmailVerification: true,
        requiresPrint: true
      },
      'thailand': {
        url: 'https://extranet.immigration.go.th/fn/TM6/',
        dateFormat: 'DD/MM/YYYY',
        requiresEmailVerification: false,
        requiresPrint: false
      },
      'singapore': {
        url: 'https://eservices.ica.gov.sg/sgarrivalcard/',
        dateFormat: 'DD/MM/YYYY',
        requiresEmailVerification: true,
        requiresPrint: false,
        timeLimit: { days: 3, before: 'arrival' }
      },
      'indonesia': {
        url: 'https://ecd.imigrasi.go.id/',
        dateFormat: 'DD/MM/YYYY',
        requiresEmailVerification: true,
        requiresPrint: true
      },
      'vietnam': {
        url: 'https://dichvucong.bocongan.gov.vn/',
        dateFormat: 'DD/MM/YYYY',
        requiresEmailVerification: false,
        requiresPrint: false
      },
      'philippines': {
        url: 'https://etravel.gov.ph/',
        dateFormat: 'YYYY-MM-DD',
        requiresEmailVerification: true,
        requiresPrint: true,
        timeLimit: { hours: 72, before: 'departure' }
      }
    }
    return configs[country.toLowerCase()]
  }
  
  // 主流程
  async execute() {
    try {
      // 1. 检查时间限制
      if (this.config.timeLimit) {
        this.checkTimeLimit()
      }
      
      // 2. 访问网站
      await this.navigateToWebsite()
      
      // 3. 根据国家执行不同流程
      switch(this.country.toLowerCase()) {
        case 'malaysia':
          await this.fillMalaysia()
          break
        case 'thailand':
          await this.fillThailand()
          break
        case 'singapore':
          await this.fillSingapore()
          break
        case 'indonesia':
          await this.fillIndonesia()
          break
        case 'vietnam':
          await this.fillVietnam()
          break
        case 'philippines':
          await this.fillPhilippines()
          break
        default:
          throw new Error(`不支持的国家: ${this.country}`)
      }
      
      // 4. 处理邮件验证（如需要）
      if (this.config.requiresEmailVerification) {
        await this.handleEmailVerification()
      }
      
      // 5. 下载/保存确认信息
      await this.saveConfirmation()
      
      return {
        success: true,
        country: this.country,
        confirmationPath: this.confirmationPath
      }
    } catch (error) {
      return {
        success: false,
        country: this.country,
        error: error.message
      }
    }
  }
  
  // 检查时间限制
  checkTimeLimit() {
    const { timeLimit } = this.config
    const now = new Date()
    const arrivalDate = new Date(this.userInfo.arrival_date)
    
    if (timeLimit.before === 'arrival') {
      const daysBeforeArrival = (arrivalDate - now) / (1000 * 60 * 60 * 24)
      if (daysBeforeArrival > timeLimit.days) {
        throw new Error(`${this.country} 入境卡只能在入境前 ${timeLimit.days} 天内填写`)
      }
    } else if (timeLimit.before === 'departure') {
      const hoursBeforeDeparture = (arrivalDate - now) / (1000 * 60 * 60)
      if (hoursBeforeDeparture > timeLimit.hours) {
        throw new Error(`${this.country} 入境卡只能在出发前 ${timeLimit.hours} 小时内填写`)
      }
    }
  }
  
  // 格式化日期
  formatDate(dateString) {
    const date = new Date(dateString)
    const format = this.config.dateFormat
    
    if (format === 'DD/MM/YYYY') {
      return `${date.getDate().toString().padStart(2, '0')}/${(date.getMonth() + 1).toString().padStart(2, '0')}/${date.getFullYear()}`
    } else if (format === 'YYYY-MM-DD') {
      return `${date.getFullYear()}-${(date.getMonth() + 1).toString().padStart(2, '0')}-${date.getDate().toString().padStart(2, '0')}`
    }
  }
}

// 使用示例
const automation = new ArrivalCardAutomation('malaysia', {
  passport_number: 'E12345678',
  country_of_issue: 'China',
  passport_expiry: '31/12/2030',
  surname: 'ZHANG',
  given_name: 'SAN',
  gender: 'Male',
  date_of_birth: '01/01/1990',
  nationality: 'China',
  email: '[REDACTED_SECRET]',
  arrival_date: '15/04/2026',
  flight_number: 'MH370',
  address_in_malaysia: 'Hotel ABC, Kuala Lumpur'
})

const result = await automation.execute()
console.log(result)
```

## 实现建议

1. **模块化设计**：为每个国家创建独立的填写模块，便于维护
2. **配置管理**：使用配置文件管理不同国家的差异（日期格式、时间限制等）
3. **错误处理**：实现统一的错误处理和日志记录机制
4. **重试机制**：添加重试机制，应对网络不稳定
5. **定期维护**：定期测试和更新，因为网站可能会变化


path: reference/indonesia-guide.md
content: # 🇮🇩 印尼 All Indonesia Arrival Card 填写指南

欢迎前往美丽的印尼！从 2025 年 8 月起，印尼启用了全新的 **All Indonesia 入境申报系统**，将原本分开填写的入境卡、海关申报和健康声明整合在一起。别担心，流程很简单，我为你整理了这份详细的填写指南。

---

## 📋 填写前准备

在开始填写前，请确保你已经准备好以下信息：

- **护照**：有效期需在 6 个月以上
- **航班信息**：准确的航班号和抵达日期
- **在印尼的住址**：建议提前预订好酒店，并准备好酒店的英文全称和详细地址
- **签证信息**（如已办理）：落地签号或电子签号
- **电子邮箱**：用于接收确认信息
- **填写时间**：最早可在出发前 3 天（含出发当天）填写

---

## 🌐 官方填写入口

⚠️ **请务必通过印尼移民局官方网站进行填写，谨防钓鱼网站。**

**官方网站**：https://allindonesia.imigrasi.go.id/

**其他方式**：
- 扫描官方二维码
- 下载 APP "All Indonesia"

---

## 📝 详细填写步骤

整个流程分为 **"选择语言"**、**"填写信息"** 和 **"保存 QR Code"** 三个部分。

### 第一步：选择语言并进入填写页面

1. 进入官网后，点击右上角 **"Languages"** 菜单
2. 选择 **"中国"** 切换为简体中文界面（推荐）
3. 选择 **"外国访客"** 入口开始填写

---

### 第二步：填写个人信息

**详细填写表格**：

| 填写项目 | 说明与示例 |
|---------|-----------| 
| **个人信息 (Personal Information)** | |
| 姓名 (Name) | 与护照信息页一致，用拼音填写，姓和名之间用空格隔开<br>例如：`ZHANG SAN` |
| 护照号 (Passport No.) | 填写护照右上角的号码<br>例如：`E12345678` |
| 国籍 (Nationality) | 选择 `CHINA` |
| 出生日期 (Date of Birth) | 按照护照信息页格式填写<br>例如：`01/01/1990` |
| 性别 (Gender) | 男性选 `Male`，女性选 `Female` |
| 护照有效期 (Date of Passport Expiry) | 按照护照信息页填写<br>例如：`31/12/2030` |
| 签证号码 (Visa No.) | 如已办理落地签或电子签，填写签证号<br>例如：`1234567890` |
| 电子邮箱 (Email Address) | 填写一个常用且能正常接收邮件的邮箱<br>例如：`[REDACTED_SECRET]` |
| 手机号码 (Mobile No.) | 填写你的中国手机号，前面加上国家代码 `+86`<br>例如：`+86 138 0000 0000` |

💡 **小贴士**：系统支持护照扫描功能，可以选择"护照扫描"让系统自动识别信息，但建议核对后再提交。

---

### 第三步：填写旅行详情

| 填写项目 | 说明与示例 |
|---------|-----------| 
| **旅行信息 (Travel Details)** | |
| 抵达日期 (Date of Arrival) | 你抵达印尼的日期<br>例如：`15/04/2026` |
| 离开日期 (Date of Departure) | 你离开印尼的日期<br>例如：`22/04/2026` |
| **交通方式 (Transportation)** | |
| 交通方式 (Mode of Travel) | 飞机入境选择 `Air` |
| 航班号 (Flight No.) | 填写你的航班号<br>例如：`CZ303` |
| 抵达机场 (Airport of Arrival) | 填写机场代码或名称<br>常见机场见下方参考 |
| **住宿信息 (Accommodation)** | |
| 住宿类型 (Accommodation Type) | 住酒店选择 `Hotel`，住亲友家选择 `Home` |
| 酒店名称/地址 (Name/Address) | 填写酒店的英文全称和街道地址<br>例如：`Grand Hyatt Bali, Jalan Kayu Aya No. 1` |
| 城市/省份 (City/Province) | 根据酒店所在地填写<br>例如：`Bali / Bali` |

**常用机场代码参考**：

| 机场名称 | 机场代码 | 所在城市 | 省份 |
|---------|---------|---------|------|
| 伍拉·赖国际机场 | DPS | 登巴萨 | 巴厘岛 |
| 苏加诺-哈达国际机场 | CGK | 雅加达 | 雅加达特区 |
| 朱安达国际机场 | SUB | 泗水 | 东爪哇省 |
| 日惹国际机场 | YIA | 日惹 | 日惹特区 |
| 苏丹哈桑丁国际机场 | UPG | 望加锡 | 南苏拉威西省 |
| 瓜拉纳穆国际机场 | KNO | 棉兰 | 北苏门答腊省 |
| 龙目国际机场 | LOP | 龙目岛 | 西努沙登加拉省 |

---

### 第四步：填写海关申报

⚠️ **请仔细阅读申报要求，如实填写，避免违反印尼海关规定。**

**海关申报表格**：

| 申报项目 | 说明 |
|---------|------|
| **行李数量** | 填写托运行李和手提行李的总数量 |
| **需申报物品** | |
| 现金金额 | 如携带现金超过 1 亿印尼盾（约 5000 美元）**必须申报** |
| 酒精饮料 | 年满 21 岁可免税携带 1 升洋酒 |
| 香烟 | 年满 21 岁可免税携带 200 支香烟 |
| 电子产品 | 如携带多部电子产品用于商业用途需申报 |
| 食品 | 肉类、水果、蔬菜等动植物产品需申报 |
| **禁止携带物品** | 毒品、武器、色情物品、濒危动植物制品等 |

💡 **重要提示**：
- 印尼对毒品法律极其严格，携带毒品可判死刑
- 未申报现金超过限额将被罚款 10% 的携带金额
- 酒精超限将被没收，不允许补缴关税

---

### 第五步：健康声明

| 声明项目 | 说明 |
|---------|------|
| 健康状况 | 确认过去 14 天内未出现发热、咳嗽、呼吸困难等症状 |
| 接触史 | 确认过去 14 天内未接触过传染病患者 |
| 携带物品 | 确认未携带动植物、动植物产品、病原体等 |

---

### 第六步：提交并保存 QR Code

1. 确认所有信息无误后，点击 **"提交" (Submit)**
2. 系统会生成一个 **QR Code（二维码）**
3. **务必截图、下载或打印保存 QR Code**
4. 入境时向移民官员和海关人员出示 QR Code 即可

---

## ⚠️ 重要提醒

### 📄 保存 QR Code
- ✅ **务必将 QR Code 截图保存在手机相册中**
- ✅ **建议同时保存到云端备份（如 iCloud、Google Photos）**
- ✅ **如有条件，建议打印一份纸质版随身携带**
- 入境时移民官员和海关人员会扫描 QR Code

### ⏰ 填写时间限制
- **最早可在出发前 3 天（含出发当天）填写**
- **建议在出发前 1-2 天完成，避免临时忘记**
- 如未提前填写，也可在抵达印尼后入境前填写，但会增加排队等候时长

### 💰 费用说明
- **填写 All Indonesia Arrival Card 完全免费**
- 如在填写过程中系统要求付费，说明访问的不是官方网站，请立即停止
- 落地签（VoA）费用需单独支付，约 50 万印尼盾（约 35 美元）

### 👨‍👩‍👧‍👦 团体/家庭申报
- 团体或家庭可以共用一个二维码
- 点击"添加旅客"填写所有成员信息
- 入境时由主旅客出示二维码，但所有成员需一同入境

---

## ❓ 常见问题处理

### Q1：填写错误了怎么办？
**A**：如果发现填写错误，可以重新填写一份新的申报，系统会生成新的 QR Code。入境时使用最新的 QR Code 即可。

### Q2：QR Code 可以打印出来吗？
**A**：可以打印，但不是必须的。手机截图保存即可，入境时向官员出示手机屏幕上的 QR Code。建议将屏幕亮度调到最高。

### Q3：需要打印纸质版吗？
**A**：不是必须的，但建议打印一份备用。如果手机没电或网络问题，纸质版可以作为备用方案。

### Q4：填写后多久有效？
**A**：QR Code 在你填写的抵达日期当天有效。如果行程变更，需要重新填写。

### Q5：可以提前 4 天填写吗？
**A**：不可以。系统最早只允许在出发前 3 天填写，日期选择器会自动限制可选日期范围。

### Q6：填写了入境卡还需要签证吗？
**A**：需要。入境卡和签证是两个完全不同的手续。持有中国护照的游客需要办理落地签（VoA）或提前申请电子签（e-VOA）。

### Q7：海关申报物品忘记填了怎么办？
**A**：如实申报即可。如果不确定是否需要申报，建议选择申报。印尼海关对未申报物品的处罚很严格，罚款金额可能高达物品价值的数倍。

### Q8：入境时需要出示哪些文件？
**A**：
- 护照（有效期 6 个月以上）
- 签证（落地签或电子签）
- All Indonesia Arrival Card QR Code
- 酒店预订确认单（建议准备）
- 返程机票（建议准备）

### Q9：系统打不开或加载很慢怎么办？
**A**：
- 检查网络连接
- 尝试更换浏览器（推荐 Chrome、Safari）
- 尝试使用官方 APP "All Indonesia"
- 如仍无法解决，可在抵达印尼后在机场填写（但会增加排队时间）

### Q10：忘记截图 QR Code 了怎么办？
**A**：可以返回官网，点击"查询申报"（Check Registration），输入护照号和国籍，重新下载或截图 QR Code。

---

## 📞 紧急联系方式

如遇到紧急情况，可以联系以下机构：

- **印尼报警电话**：+62-110
- **印尼急救电话**：+62-119
- **中国外交部全球领事保护热线**：+86-10-12308 或 +86-10-65612308
- **驻印尼使馆领事保护电话**：+62-21-5764135
- **驻泗水总领馆领事保护电话**：+62-31-5678284
- **驻棉兰总领馆领事保护电话**：+62-8116137652
- **驻登巴萨总领馆领事保护电话**：+62-361-239902

---

## 🌟 最后的小建议

1. **提前准备**：在出发前 1-2 天完成填写，避免临时匆忙
2. **核对信息**：填写完成后仔细核对，特别是护照号、航班号等关键信息
3. **多渠道保存**：QR Code 同时保存在手机相册、云端，最好打印一份
4. **如实申报**：海关申报务必如实填写，避免因违规被罚款或没收物品
5. **保持耐心**：入境时可能会有排队等候，保持耐心，配合官员检查

---

祝你印尼之旅愉快！🌴✈️


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal:  | SkillSpector:  ()