同福客栈 Docs 目录整理执行计划 v2
编制：2026-06-25 12:30 +08:00
承接 doc-organization-plan-2026-06-23.md，落地执行版本。
当前进度：Phase 0 ✅ → Phase 1 ✅ → Phase 2 ✅ → Phase 3 ✅ → Phase 4 ✅ → Phase 5 ✅（全部完成）
1. 目标
将 docs/ 从 33 个根文件 + 重叠子目录重组为清晰的三层结构：specs / plans / design。
2. 目标目录结构
docs/
├── README.md ← 总入口索引
│
├── specs/ ← 规范/规则（不可随意修改的协议）
│ ├── README.md
│ ├── engineering/ ← bugfix-playbook, code-splitting-rules
│ ├── ui/ ← mobile-portrait-rulebook, landscape spec
│ ├── data/ ← 数据结构与表格设计标准
│ └── workflow/ ← pm-agent-lean-efficiency
│
├── plans/ ← 计划/进度（强时间观念文档）
│ ├── README.md
│ ├── active/ ← 路线图、主计划、遗留分册、版本历史
│ ├── completed/ ← 已归档分册、已完成方案
│ ├── backlog/ ← 待办需求（UI 补齐等）
│ └── daily/ ← (将来从 daily-plans/ 迁移)
│
├── design/ ← 设计文档
│ ├── completed/ ← 已落地（代码基线存在）
│ │ ├── README.md
│ │ ├── systems/ ← 时间、昼夜、终局、存档、简报、扩建
│ │ ├── gameplay/ ← 擂台、羁绊、员工深度、官府竞标
│ │ └── narrative/ ← 故事事件节点
│ ├── active/ ← 进行中（线程依赖）
│ │ ├── README.md
│ │ ├── systems/
│ │ ├── gameplay/
│ │ └── ui/
│ └── backlog/ ← 后续储备（预研/设想）
│ ├── README.md
│ ├── systems/ ← serverless、账号成就系统
│ ├── gameplay/ ← P2P 联机、成就绘卷
│ ├── narrative/ ← story0-1 素材池
│ └── assets/ ← 素材补图
│
├── design/（保留现有） ← 6.23归档/、6.24玩法/、…、buff/、technical/
├── story/ ← 保留
├── uirefactor/ ← 保留
├── 竖版UI重构/ ← 保留
├── economy-sim/ ← 保留
├── handoff/ ← 保留
├── tools/ ← 保留
├── art/ ← 保留
└── daily-plans/ ← 保留 → 将来迁移
3. 准入规则
什么进 specs/
- 定义硬约束、统一口径、字段规则、分层规则
- 用于协作执行，不描述某个玩法本身
- 其他文档或线程把它当成"必须遵守的边界"
什么进 plans/
- 明确记录时间、优先级、派发、当前顺序
- 描述"现在做什么、做完了什么、后面做什么"
- 版本记录、日计划、资源补齐、执行拆分
什么进 design/
- 描述某个系统或玩法怎么工作
- 关注玩家体验、系统结构、状态流或交互方式
- 按"已落地 / 进行中 / 后续储备"分状态
4. 完整迁移清单
Phase 1 ✅ — 低风险迁移（已完成 2026-06-25）
| # | 源路径 | 目标路径 |
|---|--------|----------|
| 1 | p2p-multiplayer-playbook.md | design/backlog/gameplay/p2p-multiplayer-playbook.md |
| 2 | remaining-ui-requirements-2026-06-23.md | plans/backlog/remaining-ui-requirements-2026-06-23.md |
| 3 | remaining-ui-requirements-2026-06-24.md | plans/backlog/remaining-ui-requirements-2026-06-24.md |
| 4 | doc-organization-plan-2026-06-23.md | plans/completed/doc-organization-plan-2026-06-23.md |
| 5 | app-structure-splitting-plan-v1.md | plans/completed/app-structure-splitting-plan-v1.md |
| 6 | quest-event-loop-design-v1.md | design/completed/systems/quest-event-loop-design-v1.md |
| 7 | design/《同福客栈》无服务器…方案.md | design/backlog/systems/serverless-web-architecture-supplement.md |
| 8 | design/玩法：成就/…成就绘卷….md | design/backlog/gameplay/achievement-flavor-design.md |
| 9 | design/玩法：成就/…技术实现方案.md | design/backlog/systems/account-achievement-system.md |
Phase 1 ✅ — 去重删除（已完成）
| # | 删除位置 | 保留位置 |
|---|----------|----------|
| 1 | design/6.24玩法/Buff具体配置清单与实装细则.md | design/buff/ |
| 2 | design/6.24玩法/Buff系统实装与落地指南.md | design/buff/ |
| 3 | design/6.23归档/玩法：客栈…buff设计/V2.0 优化落地版.md | design/buff/ |
| 4 | design/6.23归档/玩法：客栈…buff设计/Buff系统子文档 V1.0 架构版.md | design/buff/ |
| — | 删除空目录 design/玩法：成就/ | — |
| — | 删除空目录 design/6.23归档/玩法：客栈经营状态以及buff设计/ | — |
Phase 2 ⏳ — 规范层迁移（待 6.26 执行）
| # | 源路径 | 目标路径 |
|---|--------|----------|
| 1 | bugfix-playbook.md | specs/engineering/bugfix-playbook.md |
| 2 | code-structure-splitting-rules-v1.md | specs/engineering/code-structure-splitting-rules-v1.md |
| 3 | pm-agent-lean-efficiency.md | specs/workflow/pm-agent-lean-efficiency.md |
| 4 | mobile-portrait-rulebook.md | specs/ui/mobile-portrait-rulebook.md |
| 5 | mobile-portrait-ui-iteration-spec.md | specs/ui/mobile-portrait-ui-iteration-spec.md |
| 6 | web-landscape-ui-iteration-spec.md | specs/ui/web-landscape-ui-iteration-spec.md |
| 7 | design/《同福客栈》数据结构与表格设计方案 (JSON TypeScript 规范).md | specs/data/tongfu-data-structure-and-table-spec.md |
Phase 3 ⏳ — 已落地设计迁移
| # | 源路径 | 目标路径 |
|---|--------|----------|
| 1 | time-system-v1.md | design/completed/systems/time-system-v1.md |
| 2 | day-night-design.md | design/completed/systems/day-night-design.md |
| 3 | day-night-tech-design.md | design/completed/systems/day-night-tech-design.md |
| 4 | day-night-endgame-playbook.md | design/completed/systems/day-night-endgame-playbook.md |
| 5 | endgame-save-load-design.md | design/completed/systems/endgame-save-load-design.md |
| 6 | failure-endgame-design.md | design/completed/systems/failure-endgame-design.md |
| 7 | jianghu-briefing-design.md | design/completed/systems/jianghu-briefing-design.md |
| 8 | inn-area-expansion-v1.md | design/completed/systems/inn-area-expansion-v1.md |
| 9 | martial-tournament-design.md | design/completed/gameplay/martial-tournament-design.md |
| 10 | bond-storylines-design.md | design/completed/gameplay/bond-storylines-design.md |
| 11 | staff-depth-economy-design.md | design/completed/gameplay/staff-depth-economy-design.md |
| 12 | story-event-nodes-v1.md | design/completed/narrative/story-event-nodes-v1.md |
| 13 | government-warehouse-auction-v1.md | design/completed/gameplay/government-warehouse-auction-v1.md |
Phase 4 ⏳ — 进行中设计整合
前置条件：6.25-6.26 线程完全收口。
- 将
design/6.23归档/子目录映射到design/active/或design/completed/ - 将
design/6.24玩法/（去重后 7 文件）分类 - 将
design/6.25玩法/分类 - 将
design/6.26玩法/分类
Phase 5 ⏳ — 计划层重构（最后）
| # | 源路径 | 目标路径 | 状态 |
|---|--------|----------|------|
| 1 | development-roadmap.md | plans/active/development-roadmap.md | 🔒 冻结 |
| 2 | version-history.md | plans/active/version-history.md | 🔒 冻结 |
| 3 | development-roadmap-archived.md | plans/completed/development-roadmap-archived.md | |
| 4 | development-roadmap-remaining.md | plans/active/development-roadmap-remaining.md | |
| 5 | development-master-plan.md | plans/active/development-master-plan.md | |
| 6 | event-table-index-v1.md | plans/active/event-table-index-v1.md | |
| 7 | event-execution-checklist-v1.md | plans/active/event-execution-checklist-v1.md | |
| 8 | daily-plans/ → | plans/daily/ | |
5. 冻结文件清单
| 文件 | 原因 | 解冻条件 |
|------|------|----------|
| development-roadmap.md | 被 3 个分册 + 日计划引用 | Phase 5 |
| version-history.md | 被所有日计划引用 | Phase 5 |
| daily-plans/2026-06-25.md | 今日活跃线程 | 6.25 线程收口 |
| daily-plans/2026-06-26.md | 明日线程 | 6.26 线程收口 |
| design/6.23归档/ 中被日计划引用的路径 | 线程依赖 | Phase 4 |
6. 引用追踪
迁移后需要全仓扫描更新的引用：
跨文档引用（已知）
development-master-plan.md→ 引用staff-depth-economy-design.md、bond-storylines-design.md等development-roadmap-remaining.md→ 引用daily-plans/、development-master-plan.md- 各日计划 → 引用
staff-depth-economy-design.md、design/6.24玩法/等 buff/README.md→ 引用Buff系统技术实现文档.md等
扫描命令
# 全仓 Markdown 链接扫描
grep -r '\[.*\](.*\.md)' docs/ --include="*.md"
7. 验收标准
- [x] Phase 0 骨架目录创建完成
- [x] Phase 1 9 个文件迁移完成，4 对重复删除
- [x]
docs/README.md重写为永久入口 - [ ] Phase 2 规范层迁移完成，引用更新
- [ ] Phase 3 已落地设计迁移完成，引用更新
- [ ] Phase 4 进行中设计整合完成
- [ ] Phase 5 计划层重构完成
- [ ]
docs/根目录仅保留README.md - [ ] 全仓 Markdown 链接无断链
8. 执行原则
- 先建骨架，再迁文件：每阶段先创建目标目录，再做 move
- 先改引用，再改路径：迁移前更新所有引用方
- 冻结文件最后动：等线程完全收口
- Git 跟踪所有变更：每步操作可回滚
- 不做大规模 rename：只做必要的文件移动和目录重组