Multi City Planner

多目的地行程规划与比价工具。支持多程航班、缺口程、往返组合等多种方案对比，自动优化同国家城市连续游玩，输出标准 HTML 网页报告。

Security Scan

The package appears to implement the described multi-city travel planner, but there are inconsistencies (an undeclared flyai API token requirement and a mismatch between the SKILL.md 'do not reveal internal details' rule and the scripts/HTML which print the skill name and script paths) that warrant caution and inspection before use.

Purpose & Capability

The skill's name/description (multi-city itinerary comparison, HTML output) align with the included JavaScript scripts and HTML templates. Requiring Node.js and referencing flyai-cli in docs is consistent with a runtime that calls an external flight data provider. However, the SKILL metadata lists no required environment variables while README/SKILL.md instruct users to configure FLYAI_API_KEY for flyai-cli — that mismatch is notable.

Instruction Scope

SKILL.md explicitly forbids exposing the skill name, script paths, tool calls, and internal technical details in generated output. Yet plan.js prints the selected script name ('使用脚本：…') before executing, and several supplied HTML files contain footer lines revealing the skill name and version. The scripts are executed via child_process.execSync (plan.js) which can run arbitrary local JS files; the runtime instructions and actual code diverge on what output is allowed to expose.

Install Mechanism

No remote install spec is provided (no downloads or archive extraction). The skill is provided as local JS files and templates and requires Node.js to run — which is proportionate. There are no installer URLs or non-standard install actions in the manifest.

Credentials

The documentation and README instruct installing flyai-cli and setting FLYAI_API_KEY, but the skill metadata declares no required env vars. Requiring an API key for a flight-data service would be reasonable, but it should be declared in requires.env and primaryEnv. The absent declaration makes it easy for that credential requirement to be overlooked or for the skill to attempt to use undocumented credentials. No other unrelated credentials are requested in the files.

Persistence & Privilege

Flags show always:false and no special OS restrictions. The skill does not request to be permanently included or to modify system/global agent configuration. It executes local scripts in its own directory and does not request elevated platform-wide privileges in the manifest.

What to consider before installing

Summary of issues and recommended next steps before installing or running: 1) Expect to need a flyai API key: the docs instruct configuring FLYAI_API_KEY for flyai-cli but the skill metadata doesn't declare it. If you plan to use live flight data, create an API key on the provider and verify how the scripts consume it. Ask the author to declare required env vars. 2) Inspect the executable scripts before running: plan.js uses child_process.execSync to run scripts under scripts/*. Those scripts may call flyai-cli or make network requests — review them for any hard-coded endpoints, credentials, telemetry, or filesystem access you don’t want shared. Run the code only after manual review or in a sandbox. 3) Note the documentation/code mismatch about hiding internal details: SKILL.md forbids showing skill name/script paths/tool calls, but plan.js prints which script it runs and some HTML files include the skill name/version. If you require strict non-disclosure of the tooling/runtime details, verify and remove those printouts/footers. 4) Run in an isolated environment first: use a sandbox/container or non-privileged account, and avoid running on machines with sensitive credentials. Monitor network traffic on first runs to see what external endpoints are contacted. 5) Ask for clarifications or fixes from the publisher: request the author update the skill metadata to list required env vars (e.g., FLYAI_API_KEY), remove contradictions between SKILL.md and code output, and provide a short security/privacy note describing what data is transmitted to external services. If you want, I can: (a) scan the scripts directory for network calls and suspicious filesystem access, (b) point out exact lines that print internal info, or (c) propose minimal changes to make the metadata and SKILL.md consistent with the code.

Multi-City Planner - 多目的地行程规划与比价

基于 flyai 的多城市旅行规划工具，自动搜索和比较多种行程方案，支持火车/飞机/大巴等多种交通方式对比，输出标准 HTML 网页报告。

核心能力

1. 多方案对比

• 多程联订: 一次购买所有航段，管理方便
• 缺口程 (Open-Jaw): 国际段分别购买，中间段灵活选择
• 往返 + 中间: 往返票改签灵活
• 三个单程: 最灵活，每段可单独改签

2. 交通方式对比

• ✈️ 飞机: 价格便宜，时间短
• 🚄 火车/新干线: 风景优美，市中心到市中心
• 🚌 大巴: 最便宜，适合短途

3. 智能优化

• 同国家城市连续玩: 自动将同一国家的城市安排在一起
• 不走回头路: 优化路线，避免重复路程
• 价格对比: 自动排序，显示差价

4. 标准 HTML 输出

• 响应式设计，支持手机和电脑
• 完整方案对比表
• 交通方式对比卡片
• 详细行程建议
• 预算估算
• 完整注意事项（10 大类）

输出格式规范（严格执行）

HTML 报告必须包含以下模块：

1. 头部信息

• 标题：出发地 → 目的地城市列表
• 副标题：区域 + 完整方案对比
• 国旗 emoji 标识
• 日期范围 + 天数

2. 方案价格对比表

列名	说明
排名	1-7 名，带金/银/铜牌 emoji
方案类型	多程联订/缺口程 (飞机)/缺口程 (火车) 等
路线	完整飞行路线，意大利/同国家城市连续玩路线绿色加粗
总价格	红色加粗显示
差价	第 1 名显示"-"，其他显示"+¥XXX"
特点	简短描述方案特点

3. 交通方式对比卡片（3 种）

• ✈️ 飞机：价格、时间、航司、优缺点
• 🚄 火车：价格、时间、运营、优缺点
• 🚌 大巴：价格、时间、运营、优缺点

4. 推荐方案详情（至少 2 个）

每个方案包含：

• 路线（绿色加粗标注同国家连续玩）
• 国家顺序（带国旗 emoji）
• 航班详情表格（航段、日期、时间、航班、价格）
• 优缺点对比（绿色优点框 + 红色缺点框）

5. 详细行程建议

• 按天列出（Day 1-12）
• 每天包含：日期、城市、交通方式、景点推荐
• 使用卡片式布局

6. 预算估算表

项目	费用
国际 + 境内机票	¥X,XXX
酒店（X 晚）	¥X,XXX-X,XXX
餐饮	¥X,XXX-X,XXX
境内交通	¥X,XXX-X,XXX
门票/活动	¥X,XXX-X,XXX
签证费	¥XXX
旅游保险	¥XXX-X,XXX
总计	¥XX,XXX-XX,XXX

7. 完整注意事项（10 大类，必须全部包含）

类别	内容要点
📋 出行前准备	签证、护照、保险、机票、酒店、货币
🎒 行李准备	证件、电器、衣物、药品、其他
✈️ 交通注意事项	廉航行李、机场交通、火车订票、市内交通
🏨 住宿注意事项	入住时间、城市税、安全、民宿
🍽️ 餐饮注意事项	用餐时间、小费、饮用水、美食
🎫 景点注意事项	提前预订、免费日、城市通票、着装
🔒 安全注意事项	防盗、地铁、景点骗局、紧急电话、大使馆
📱 通讯与网络	漫游、WiFi、APP 推荐
💡 其他实用提示	时差、电压、退税、周日营业、语言
⚠️ 特别提示	针对目的地的特殊注意事项

8. 推荐总结

• 推荐方案名称
• 总价格（大号字体）
• 比第 2 名省多少钱
• 比最贵省多少钱
• 行程类型说明
• 城市/国家顺序
• 推荐指数（⭐⭐⭐⭐⭐）
• 亮点说明
• 备选方案

9. 页脚

• 数据来源说明
• 生成时间

禁止内容

• ❌ 不显示使用的 skill 名称
• ❌ 不显示脚本路径
• ❌ 不显示工具调用过程
• ❌ 不显示内部技术细节

脚本列表

脚本	用途	城市数
search-multi-city.js	基础多城市对比	2
compare-complete.js	完整方案对比（含火车）	2-3
hokkaido-3cities.js	北海道三城	3
hokkaido-tokyo-4cities.js	北海道 + 东京	4
europe-3cities.js	欧洲三城	3
europe-4cities-complete.js	欧洲四城完整	4
plan.js	统一入口（自动选择脚本）	任意

使用方法

统一入口（推荐）

cd /Users/dansha/liuxiaokang/multi-city-planner

# 日本游
node plan.js --origin "北京" --cities "大阪，东京" --dep-date 2026-04-10 --return-date 2026-04-20

# 欧洲游
node plan.js --origin "北京" --cities "巴黎，罗马，米兰" --dep-date 2026-04-10 --return-date 2026-04-21 --region europe

# 北海道游
node plan.js --origin "北京" --cities "札幌，函馆，旭川" --dep-date 2026-04-10 --return-date 2026-04-20 --region japan

直接调用脚本

# 基础对比
node scripts/search-multi-city.js --origin "北京" --cities "大阪，东京" --dep-date 2026-04-10 --return-date 2026-04-20

# 完整对比（含火车）
node scripts/compare-complete.js --origin "北京" --cities "北海道，东京" --dep-date 2026-04-10 --return-date 2026-04-20

# 欧洲三城
node scripts/europe-3cities.js --origin "北京" --cities "巴黎，罗马，米兰" --dep-date 2026-04-10 --return-date 2026-04-21

生成 HTML 报告

# HTML 文件位置
/Users/dansha/liuxiaokang/multi-city-planner/目的地 - 行程.html

# 用浏览器打开
open /Users/dansha/liuxiaokang/multi-city-planner/beijing-europe-3cities.html

参数说明

参数	必填	说明	示例
--origin	✅	出发城市	"北京", "上海"
--cities	✅	目的地城市列表	"大阪，东京", "Paris,Rome"
--dep-date	✅	出发日期	2026-04-10
--return-date	✅	返回日期	2026-04-20
--region	❌	区域：auto/europe/japan	europe

依赖

• Node.js >= 14
• flyai-cli (全局安装)

# 安装 flyai-cli
npm install -g @fly-ai/flyai-cli

# 配置 API Token
flyai config set FLYAI_API_KEY "your-api-key"

文件结构

multi-city-planner/
├── SKILL.md                      # 技能定义
├── README.md                     # 使用说明
├── plan.js                       # 统一入口脚本
├── package.json                  # NPM 配置
├── _meta.json                    # 元数据
├── SKILL_SUMMARY.md              # 固化总结
├── scripts/                      # 脚本目录
│   ├── search-multi-city.js      # 基础多城市对比
│   ├── compare-complete.js       # 完整方案对比
│   ├── hokkaido-3cities.js       # 北海道三城
│   ├── hokkaido-tokyo-4cities.js # 北海道 + 东京
│   ├── europe-3cities.js         # 欧洲三城
│   └── europe-4cities-complete.js # 欧洲四城完整
├── references/
│   └── usage.md                  # 使用指南
└── *.html                        # 生成的 HTML 报告

注意事项

1. 价格时效性: 航班价格实时变动，搜索结果仅供参考
2. 行李政策: 廉航（瑞安、易捷、捷星等）不含托运行李
3. 签证要求: 提前确认目的地签证政策（申根/英国/日本等）
4. 火车选项: 欧洲境内火车风景优美，市中心到市中心
5. 同国家城市: 自动优化，同一国家城市连续游玩
6. HTML 格式: 严格按照输出格式规范生成

品牌露出

页脚统一显示：

基于实时航班数据生成 | 行程规划报告
生成时间：YYYY-MM-DD

版本历史

• v1.0.0 (2026-04-01):
  • 初始版本
  • 支持多程、缺口程、往返等多种方案
  • 支持飞机/火车/大巴对比
  • 支持 HTML 网页输出
  • 自动优化同国家城市连续游玩
  • 完整注意事项（10 大类）