同福客栈 — 文档中心
最后更新：2026-06-25 +08:00
本文档是
docs/目录的总入口。文档按 三层结构 组织：规范(specs)、计划(plans)、设计(design)。
快速导航
| 想看什么 | 去这里 | |----------|--------| | 项目总路线图 | → plans/active/project-landing-roadmap.md | | 开发进度与路线图 | → plans/active/development-roadmap.md | | 大方向开发计划 | → plans/active/development-master-plan.md | | 当日任务排程 | → daily-plans/2026-06-25.md | | 版本历史记录 | → plans/active/version-history.md | | 文档整理执行计划 | → plans/active/docs-reorganization-plan-v2.md |
三层结构
1. 规范 / 规则 → specs/
工程约束、UI 规范、数据口径、工作流约定。不可随意修改的协议。
| 子目录 | 内容 | |--------|------| | specs/engineering/ | bugfix-playbook、code-structure-splitting-rules | | specs/ui/ | mobile-portrait-rulebook、web-landscape、mobile-portrait-ui spec | | specs/data/ | 数据结构与表格设计方案 | | specs/workflow/ | pm-agent-lean-efficiency |
2. 计划 / 进度 → plans/
版本计划、路线图、执行清单。强时间观念文档。
| 子目录 | 内容 | |--------|------| | plans/active/ | 进行中的计划（路线图、主计划、version-history、event 清单、整理方案） | | plans/completed/ | 已归档（6.23 整理方案、app 拆分计划、archived roadmap） | | plans/backlog/ | 待办（UI 需求补齐、asset-gap-list） | | daily-plans/ | 日版本计划 6.23-6.26 |
3. 设计文档 → design/
系统/玩法/叙事设计。按状态分层。
| 子目录 | 内容 | |--------|------| | design/completed/systems/ | 已落地系统（时间、昼夜、存档、终局、江湖简报、客栈扩张、quest-event-loop） | | design/completed/gameplay/ | 已落地玩法（比武、羁绊、伙计深度、道具投放、官府竞标、成就、p2p） | | design/completed/narrative/ | 已落地叙事（story-event-nodes） | | design/6.25玩法/ | 进行中：角色深度与账号传承 | | design/6.26玩法/ | 后续储备：羁绊扩张与联机社交 | | design/buff/ | Buff 系统 canonical 目录 | | design/technical/ | 技术设计文档 | | design/backlog/ | 后端储备（serverless 架构、p2p multiplayer） |
其他资源目录
| 目录 | 用途 | |------|------| | story/ | 角色剧情分支 + 剧情模拟器 | | art/ | 美术资源清单与风格指南 | | uirefactor/ | UI 重构素材与优化方案 | | 竖版UI重构/ | 竖版 UI 实施蓝图 | | economy-sim/ | 经济系统模拟器 | | handoff/ | 工作任务交接体系 | | tools/ | 道具编辑器等开发工具 |
整理进度
| 阶段 | 内容 | 状态 | |------|------|------| | Phase 0 | 创建目标骨架目录 | ✅ 完成 | | Phase 1 | 低风险迁移 + 去重 | ✅ 完成 | | Phase 2 | 规范层迁移到 specs/ | ✅ 完成 | | Phase 3 | 已落地设计迁移到 design/completed/ | ✅ 完成 | | Phase 4 | 进行中设计整合（6.23归档 + 6.24玩法 → completed） | ✅ 完成 | | Phase 5 | 计划层重构 | ✅ 完成 |
全部完成。docs/ 根目录仅保留 README.md；daily-plans/ 保持原路径不变。
文档约定
- 时间口径：
Asia/Shanghai，格式YYYY-MM-DD +08:00 - 强时间文档（日计划、版本历史、路线图）必须显式写出时间
- 新增设计文档按状态放入
design/completed/、design/active/或design/backlog/ - 新增规范放入
specs/对应子目录 - 新增计划放入
plans/对应子目录