travel-visa

# 旅行签证顾问 ## 何时使用 - 用户准备出境旅行，但不确定签证是否需要、办理材料或办理地点。 - 用户已确定目的地，想把签证办理与机票/住宿安排联动决策。 - 目标是输出可执行的签证办理与行前准备清单，而不是泛化旅行建议。 ## 输入/输出约定 - **最小输入**：`departure country/region`、`destination country/region`、`passport nationality`、`planned departure date`。 - **增强输入**：`stay duration`、`entry count`、`first arrival city`、`preferred processing city`。 - **最小输出**：结论摘要、办理路径、材料清单、时间线建议、领馆/签证中心信息。 - **链接约束**：酒店预订链接必须使用 `detailUrl`，其他场景链接使用 `jumpUrl`。 ## 快速开始 1. **安装 CLI**：`npm i -g @fly-ai/flyai-cli` 2. **验证环境**：执行 `flyai fliggy-fast-search --query "中国护照去日本旅游签证要求"` 并确认输出 JSON。 3. **查看命令**：执行 `flyai --help`。 4. **查看参数说明**：阅读 **`references/`** 中文档，确认问询模板、命令模板与兜底策略。 ## 配置说明 该工具可在无 API Key 情况下试用。若需要增强效果，可配置可选密钥： ``` flyai config set FLYAI_API_KEY "your-key" ``` ## 核心流程（最小可执行路径） 1. 核验签证政策与办理要求（自然语言检索）： - `flyai fliggy-fast-search --query "<国籍> 护照去 <目的地> 旅游签证要求 材料 办理时效"` 2. 锚定办理地点（领馆/签证中心 POI）： - `flyai search-poi --city-name "<办理城市>" --keyword "<目的地国家> 签证中心"` 3. 如需联动行程成本，补充住宿搜索： - `flyai search-hotels --dest-name "<办理城市>" --poi-name "<签证中心或领馆>" --check-in-date <yyyy-mm-dd> --check-out-date <yyyy-mm-dd> --sort distance_asc --max-price <budget>` ## 输出规则（强约束） - 使用 Markdown 标题、要点、检查清单和对比表。 - 若存在图片字段，先输出图片行：`` - 然后输出预订/跳转链接行： - `search-hotels` -> `[Click to book]({detailUrl})` - 其他 -> `[Click to book]({jumpUrl})` ## 详细参考 - 场景化方案与参数速查：`references/playbooks.md` - 问询清单、参数模板与输出模板：`references/templates.md` - 失败兜底与重试策略：`references/fallbacks.md` - 执行日志模板：`references/runbook.md`