行程扭蛋是以 AI 为操作主体的旅行规划与记录组件。用户在对话中表达出行意图、补充条件和报告变化，AI 助手读取行程、核查信息、提出调整并解释结果；组件提供行程状态、规则校验、变更预览、保存与历史恢复。
2026 年 10 月 8 日，项目的使用方式从独立旅行 App 转向 AI 主导的行程组件。项目继续维护，本站旧独立网页版已下线，完整旧版保存在 legacy-web-final。
对话中的行程操作
AI 宿主负责理解意图、研究开放时间与预约条件、选择操作和解释取舍，并通过已有工具访问私有数据、外部服务和存储。组件不内置通用 AI 模型，核心离线运行；地图、天气、账户和订单的查询依赖宿主工具与权限。
一次调整从读取同一权威行程的最新版本开始。AI 将意图转为明确操作，检查受影响的活动、预约、住宿和约束，再展示变更预览。在用户授权范围内，本地行程文件由组件按版本校验保存；Library 等外部存储由宿主对同一文件执行版本校验替换，并读回确认。stage 生成的候选本身不代表外部保存成功。
组件能力
- 行程与约束：分别保留原始计划、当前安排和用户报告的实际执行，支持活动增删、移动、重排及时间和地点修改。日期、闭馆、冲突、天气和候选规则用于分析调整，已订、锁定、已确认或已完成的安排受到保护。
- 有来源的记录：在同一行程中保存事实、偏好、承诺、证据、决定、变更理由和未解决问题，区分预测、正式信息与实际报告。预约或计划记录不能证明实际完成。
- 历史与恢复：修改带版本、预览标识、幂等回执和理由；支持最新修改的撤销、存储格式迁移，以及显式采用可恢复的历史 checkpoint。更早的完整状态可能需要先前版本。
- 经验复盘：将亲历观察、调整理由、结果和评价关联到原行程与历史，在明确提供的旧行程中检索经验，并生成需要审阅的攻略草稿。
- 只读展示：从权威行程派生按日内容、当前与历史路线、按住宿夜晚组织的安排和旅行摘要，供宿主页面或报告呈现。展示刷新与权威存储保存由宿主分别处理。
规则分析用于发现已知冲突和未知项，不能证明现实中的行程可行性。决策期限与提醒对账输出建议或操作描述；通知、购票、预订、取消及退款由宿主另行执行和核实。
当前接入方式
| 入口 | 用途 |
|---|---|
tripctl CLI | AI 操作员的完整行程入口，支持 schema 发现、读取、分析、预览、保存和恢复。 |
tripctl-lib.mjs / TypeScript library | 直接调用同一核心、schema、文件存储与展示接口。 |
| 操作员 skill | 约定意图解释、主动核查、来源与不确定性、授权保存和读回流程。 |
| stdio MCP | 四个无状态 snapshot 工具：get_context、evaluate_plan、rank_candidates、preview_changes。调用者提供数据，工具返回分析或候选，不写入行程。 |
源码调用需要 Node.js >=22.13。npm run build 构建便携 CLI/library；dist/tripctl 包含运行文件、操作员 skill、契约文档和合成示例，运行时无需安装依赖。安装与具体操作见 README 和 CLI 文档。
旧网页版与数据交接
本站不再提供原 React 网页、浏览器同步或 PWA 入口。旧网页的源码、JSON 导入导出、浏览器存储与同步适配器保存在带注释的 legacy-web-final tag 中，也可从 GitLab 留档查看。需要检查或运行旧版时，可在独立目录检出留档，按其中的说明启动。
旧数据默认保存在原浏览器与 origin 的 localStorage 中，CLI/MCP 不会自动读取，下线部署也不会自动迁移个人数据。迁移前应从原环境显式导出并保留原始备份，再按实际 schema 准备输入、预览并审阅保存。旅行导出不含独立清单与天气缓存；完整工作区备份包含所有旅行与清单。新检出的旧网页也不会自动读取原浏览器与 origin 的数据。
组件仍提供宿主只读展示接口。旧网页的 driveStorage 是历史同步实现；当前操作员的外部存储流程需要宿主完成版本校验保存与读回，本站项目说明不承担行程存储。