mater1996/travel-planning

面向 Codex 的旅行研究与行程交付插件。它会先比较路线并让用户确认，再按需查询地图、交通、住宿、天气和社区体验，最后生成带来源的 itinerary.json 与可独立打开的响应式 itinerary.html。 查看兰州一日游示例，可直接体验最终行程页面的路线图、逐日时间轴、关键信息一览和移动端布局。 Demo 用于展示插件的页面交付形态，其中的开放时间、价格、天气和交通状态属于生成时的快照，不能作为当前出行确认依据。 插件不会代订、占座、付款、发送消息或修改订单。价格、余票、库存、开放时间和天气等动态信息只表示查询时点的快照，最终下单前仍需回到官方或供应商页面确认。 当前已验证的安装主路径是 Codex 本地 marketplace。仓库同时保留 Claude Code 与通用宿主所需的清单，方便后续适配，但不把它们表述成已经验收的一键安装流程。 插件统一的是安装、能力发现、权限边界和旅行编排。各数据源仍使用最合适的官方 CLI、MCP 或公开 API，并不会为了形式统一而重写成同一种协议。 请先准备： Node.js 22.14.0 覆盖了高德、飞猪和飞常准三个 Node Provider 的运行要求。小红书的预编译工具目前支持 macOS Apple Silicon 和 Linux x8664；不使用小红书时不影响其他能力。 拿到本仓库或发布包并进入它的根目录。该目录下应同时存在 .agents/plugins/marketplace.json 和 plugins/travel-planning/。 检查安装结果： 列表中应出现 travel-planning@local，状态为 installed, enabled。安装或升级后请新建一个 Codex 会话，让新 Skill 与 MCP 配置从干净上下文加载。 如果 local marketplace 已经注册，无需重复执行 marketplace add。拉取新版仓库或替换发布包后，重新执行 codex plugin add travel-planning@local --json，然后新建会话即可。 数据源按需启用，不必一次配齐。OpenStreetMap 和 Open-Meteo 无需 Key；高德、飞猪和飞常准分别只接收自己的凭证。 推荐把配置放在用户目录，避免凭证进入仓库或分发包： 编辑 /.config/travel-planning/sources.local.env，只填写需要启用的项目： 凭证申请入口： 如需使用其他文件，可在启动 Codex 前设置 TRAVELSOURCESCONFIG=/absolute/path/to/sources.local.env。源码开发时也可使用 plugins/travel-planning/config/sources.local.env；该文件已被 Git 忽略，且不会进入安装包。 小红书使用固定版本的本机 HTTP MCP 和独立浏览器，不依赖 Chrome 扩展。首次使用时运行： login 会打开上游登录工具，扫码和账号确认必须由用户本人完成。二进制、Cookie、日志与进程状态保存在 /.local/share/travel-planning/xiaohongshu-mcp/，不会写入插件源码。 后续常用命令： 先查看本机具备哪些来源，再执行一次真实协议和上游探测： 未配置的可选来源会明确显示为不可用或降级，不会阻止其他来源工作。若某次行程必须依赖特定来源，可重复添加 --require；任何必需来源失败时，命令都会以非零状态退出。 capabilities 只用于了解配置，不能代替 preflight。后者会实际执行 MCP initialize、tools/list 和只读上游探测。 完整行程优先调用主…