1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | travel-plan-viz | GitHub 独立仓库名 |
| 作者/维护者 | zexuanw958-svg（个人开发者，抖音号“泽轩604”） | GitHub API + 仓库 README |
| 来源链接 | https://github.com/zexuanw958-svg/travel-plan-viz | — |
| 许可证 | MIT（仓库根目录含完整 LICENSE 文件） | GitHub API + 仓库文件核实 |
| GitHub Stars / Forks | 291 / 10 | GitHub API（认证取数） |
| 最新版本 | 未发布正式 Release，持续更新 main 分支 | GitHub API |
| 安装方式 | 软链接到 Claude Code / Codex 的 skills 目录 | 官方 README |
2. 功能介绍与亮点
travel-plan-viz（自述项目名“Migo·旅行领航”）把一句话旅行需求变成一个可离线阅读的单文件交互 HTML 页面：
- 两种入口：只给目的地和天数即可从零规划；也可以把已有的文字或旧版 HTML 行程直接转成页面。
- 交互地图：基于 Leaflet 与免费地图瓦片（无需任何地图 API Key），景点按序编号连线，并能一键跳转手机端 iOS/Android 原生导航，境内点位自动把高德/腾讯的 GCJ-02 坐标纠偏为标准 WGS-84 坐标，避免地图偏移。
- 出发前提醒：按出发日期倒推“几号前该订什么”，在页面顶部自动生成待办清单。
- 机械校验：生成页面后自带
validate.js脚本，自动检查数据字段缺失、坐标越界等问题，不依赖模型“自觉不出错”。 - 可持续迭代：完整行程数据以 JSON 内嵌在页面里，把生成后的 HTML 文件重新丢给 Agent 说“把第三天挪到第四天”即可修改并重渲染，不会丢字段。
- 软依赖设计：若用户另装了
frontend-design等设计类 Skill，会自动调用以提升视觉效果；若装了飞猪、高德等官方旅行类 Skill，会调用它们补充实时航班/酒店数据；两者都未安装时，靠内置美学准则与联网调研兜底，不影响页面完整性。
3. 适用场景
所属分类：前端与设计
适合自由行游客、旅行内容创作者和希望把行程整理成可分享成片的用户——尤其是想要一份“手机随时能打开、没网也能看文字行程”的可视化行程页，而不是一段普通的文字攻略。不适用于需要实时机票/酒店比价、代订票据或多语言界面的场景，作者在文档中明确将这些划为本 Skill 的能力边界之外。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | README 提供 ln -sfn 软链接到 ~/.claude/skills/ 的具体安装命令 |
| Codex | 原生支持 | README 提供软链接到 ~/.codex/skills/ 的具体安装命令 |
| OpenClaw | 未验证 | 已抓取材料未点名 OpenClaw 适配，仅泛泛声明“平台无关、可将 SKILL.md 当指令喂给任意 Agent” |
| Hermes Agent | 未验证 | 已抓取材料未点名 Hermes 适配 |
5. 推荐理由
多数“AI 做旅行攻略”停留在生成一段文字或一次性网页，核心的坐标纠偏、订票倒推提醒这类容易出错的机械逻辑，每次都要模型重新“猜对”。travel-plan-viz 把这些逻辑固化成本地 JS 引擎并配了生成后自动校验，模型只负责调研与排程判断，工程正确性不再依赖模型当次发挥；同时不需要任何地图或第三方 API Key，装完即可用，产出的又是可离线阅读、可反复回传修改的单文件页面，对普通旅行者是一个直接能用起来的实用工具。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 291 stars、10 forks，仓库创建约 6 周内积累到当前规模，增长态势明显；已有真实第三方用户开 Issue 反馈与登记第三方目录收录，但未检索到独立于项目自身的第三方渠道具名深度讨论 |
| 可用性 | 9 | 一条软链接命令即可安装；README + 零基础安装教程 + 4 份现成样例网页；不依赖任何付费 API 或地图 Key；近 10 天内仍有代码推送 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合评分 | 7.7 | 三项均值 |
安全检查清单：
| 检查项 | 结果 |
|---|---|
| ① Shell 命令与权限范围 | 仅在生成页面后本地执行 node validate.js 做字段/坐标校验，范围明确、脚本可审计 |
| ② 运行时联网外发 | 联网仅用于按用户指定目的地调研坐标、图片、天气等公开信息，未发现向其他目标外发用户数据 |
| ③ API Key/凭据 | 明确无需任何地图或第三方 API Key |
| ④ 可疑指令排查 | 已抓取 SKILL.md 全文及本地 JS 引擎逻辑说明，未发现 prompt injection 或混淆代码迹象 |
| ⑤ 作者/组织信誉 | 个人开发者出品，提交历史公开（58 次提交）、Star/Fork 比例正常，无刷星迹象 |
| ⑥ License | MIT，条款清晰，仓库根目录含完整 LICENSE 文件 |
| ⑦ 最近维护 | 近 10 天内有代码推送 |
代码执行仅限本地校验脚本，联网范围透明、无凭据依赖，检查清单各项结果良好；作者为个人开发者而非官方机构，故未给满分。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本 skill 的差异 |
|---|---|---|
| travel-planner（ErlebnisW） | 多 Agent 编排型旅行规划 Skill，用 5 个专项子 Agent（行程、美食、交通住宿、安全文化、预算）并行调研，产出结构化 Markdown 文档 | 侧重“调研深度”，产出是给人阅读的 Markdown 报告；travel-plan-viz 侧重“可用成片”，产出是带交互地图与订票提醒的单文件 HTML，可离线打开、可回传继续编辑 |
| 第三方 Skill 市场收录的通用 “Travel Planner”（AI-Labs 出品，被 mcpmarket、Awesome Skills 等目录收录） | 定位为通用旅行搜索与调研助手，聚焦信息检索与建议 | 不生成可视化成片，交付形式仍是对话文本；travel-plan-viz 额外提供地图、时间轴、机械校验的工程化产出层 |
核心差异化：同类工具普遍停在“调研得更全”或“文字建议更准”，travel-plan-viz 额外把坐标纠偏、订票倒推提醒这类易错环节固化成本地引擎并做生成后校验，交付的是一份可离线阅读、可回传迭代的可视化成片，而不只是一段文字。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价，仓库自身收到过真实用户提交的功能反馈 Issue，以及被第三方项目目录 CodeGuilds 收录登记的记录。
9. 其他补充
仓库提供中英双语 README，并附有从“什么是 GitHub”讲起的零基础安装教程（INSTALL.md），面向不熟悉命令行的旅行用户。
10. 安装使用方式
# Claude Code
ln -sfn "$(pwd)/travel-plan-viz" ~/.claude/skills/travel-plan-viz
# OpenAI Codex
ln -sfn "$(pwd)/travel-plan-viz" ~/.codex/skills/travel-plan-viz安装后无需重启，下次对话即可触发。使用方式：直接对 Agent 说“帮我做香港 4 天 3 晚的旅行计划”从零规划，或把已有文字/旧版 HTML 行程贴给它直接转成页面；生成后把 HTML 文件回传并描述修改需求（如“把第三天的 X 挪到第四天”）即可在原结构上迭代。
11. 注意事项
- 价格、营业时间、班次等时效性信息仍需以官方渠道核实，页面自带免责声明并引导用户前往官方 App 确认，Skill 本身不做实时比价或代订票。
- 地图与图片需要联网加载，无网络时会优雅降级为纯文字行程，不会显示破损图片。
- 目前只验证了 Claude Code 与 Codex 平台的使用体验，OpenClaw、Hermes Agent 等其他 Agent 生态的兼容性尚未验证。