SlothTrip

SlothTrip Studio 是一个本地优先的可视化行程编排 Web 应用：用户导入标准 TripSpec 文件，在地图与日程视图中检查、调整并无损导出行程。

产品品牌为 SlothTrip，开放行程数据格式继续称为 TripSpec。两者分层，避免产品名称与可移植文件契约混在一起。

当前状态

M1（导入流水线）已完成并通过本地质量门禁。 二进制输入、安全解析、1.0→1.1 迁移、容错标准化、统一 Issue、业务校验、隔离预览、摘要和修复提示词均已就绪，可以开始 M2 工作区领域核心。

开工入口见 START-HERE.md，文档地图与权威边界见 docs/README.md。

目录

codex/       分里程碑实施与审查提示词
docs/        当前 PRD、架构、技术选型、迁移说明及历史归档
examples/    Schema 1.1.0 官方示例
planning/    P0 开发计划与机器可读任务板
prototype/   可直接预览的交互原型
schema/      TripSpec Schema 1.1.0 与校验记录

M0 已按架构建立 apps/、packages/、tooling/、工作区配置和 CI。

开始开发

1. 使用 Node.js 22 LTS（至少 22.12）和 pnpm 10。
2. 完整阅读 START-HERE.md 指定的规范源。
3. 查看已通过的 M1 审查记录。
4. 从 codex/02-domain-m2.md 开始 M2。

开发环境

项目已建立 pnpm workspace、Schema、Core、Importer、官方提示词、测试 fixtures、最小 Studio 壳和 CI。需要 Node.js 22.12+（22.x）与 pnpm 10：

pnpm install
pnpm check
pnpm build

常用命令还包括 pnpm dev、pnpm test:unit 和 pnpm test:e2e。M1 只生成隔离的 ImportPreview，不会写入工作区；编辑命令、Undo/Redo、导出、持久化、地图和 UI 属于后续里程碑。

原型

原型是交互和视觉参考，不是生产代码或数据契约。预览方法与目录说明见 prototype/README.md；地图优先版本见 prototype/map-first-v0.2。

历史资料

早期需求探索、Schema v1 草案和重复交付包已移入 docs/archive/。它们只用于追溯决策，发生冲突时不得覆盖当前规范源。