同福客栈文档分类方案与迁移清单

形成时间：2026-06-23
本轮目标：只产出分类方案、建议目录、迁移清单和冻结边界；不做大规模 rename，不改源码，不改今天功能线程依赖的设计路径。

1. 本轮结论

当前 docs/ 里的内容不是“一个 design 文件夹 + 一堆散文档”这么简单，而是混着四种角色：

1. 规范 / 规则
2. 计划 / 进度
3. 系统 / 玩法设计
4. 资产 / 素材 / 储备池

如果现在直接按文件名大搬家，会和今天的开发线程冲突，尤其是：

• 强时间文档正在被主协调线程使用
• 多个 design 路径已经写进今日计划
• 竖屏、事件表、代码拆分这些规则文档已经被其他文档引用

所以本轮采用“先建分类方案，后按波次迁移”的策略。

2. 当前项目进度判断

这份判断来自当前仓库文档与代码现状，只用于文档归类，不作为产品验收结论。

2.1 已有代码基线的系统

• 时间系统 / 营业阶段：已落地
• 昼夜约束：已落地
• 故事事件元数据与拆表基线：已落地
• 失败终局与复盘：已落地
• 终局存读档解释层：已落地
• 江湖简报面板与生成逻辑：已落地
• 区域扩建：已落地
• 擂台赛：已落地到活动化基线
• 羁绊系统：已落地到首批闭环
• 员工深度状态：已有实现基线

2.2 正在开发的系统

• 账号 / 多周目
• Buff / 客栈状态
• 官府抄缴库房竞标会

2.3 后续储备 / 预研

• 成就系统
• 更完整的 P2P 联机玩法扩展
• 部分剧情素材池
• 素材补图计划

3. 建议目录结构

后续正式迁移时，建议把 docs/ 收成下面三层主结构：

docs/
  README.md
  specs/
    engineering/
    ui/
    data/
    workflow/
  plans/
    active/
    completed/
    backlog/
    daily/
  design/
    completed/
      systems/
      gameplay/
      narrative/
    active/
      systems/
      gameplay/
      ui/
    backlog/
      systems/
      gameplay/
      narrative/
      assets/

4. 分类规则

4.1 什么算规范

满足下面任一条，就进 docs/specs/：

• 定义硬约束、统一口径、字段规则、分层规则
• 用于协作执行，而不是描述某个玩法本身
• 其他文档或线程会把它当成“必须遵守的边界”

4.2 什么算计划

满足下面任一条，就进 docs/plans/：

• 明确记录时间、优先级、派发、当前顺序
• 描述“现在做什么、做完了什么、后面做什么”
• 版本、日计划、资源补齐、执行拆分都属于计划层

4.3 什么算设计

满足下面任一条，就进 docs/design/：

• 描述某个系统或玩法怎么工作
• 关注玩家体验、系统结构、状态流或交互方式
• 可以按“已落地 / 进行中 / 后续储备”分状态

4.4 状态定义

• 已落地：仓库里已有明确代码基线，文档主要作为说明与后续扩展入口
• 进行中：当前已有文档与部分实现，但还在被今天或近期线程继续开发
• 后续储备：仍以设想、素材池、预研、扩展提案为主

5. 高风险冻结文件

这些文件本轮只允许新增入口引用，不建议 rename 或改语义：

5.1 强时间文档

• docs/daily-plans/2026-06-23.md
• docs/development-roadmap.md
• docs/version-history.md

原因：

• 今天的 PM 协调口径已经写死这三份文件
• 它们互相引用
• 其他线程可能按当前路径直接回看

5.2 今日计划直接引用的设计路径

• docs/design/账号体系以及多周目设计/《同福客栈》本地化账号与多周目系统设计文档（V1.0 落地版）.md
• docs/design/玩法：客栈经营状态以及buff设计/《同福客栈》经营状态与核心数值体系设计文档（V2.0 优化落地版）.md
• docs/design/玩法：客栈经营状态以及buff设计/《同福客栈》经营状态与核心数值体系设计文档 —— Buff系统子文档（V1.0 架构版）.md
• docs/design/玩法：官府抄缴库房竞标会/官府抄缴库房竞标会.md

原因：

• docs/daily-plans/2026-06-23.md 已直接写入这些相对路径
• 当前代码收口线程仍可能把这些文档当实现依据

5.3 已被其他文档引用的执行规则

• docs/mobile-portrait-rulebook.md
• docs/event-table-index-v1.md
• docs/event-execution-checklist-v1.md
• docs/code-structure-splitting-rules-v1.md

原因：

• 这些文件已经是“规则入口”
• 一旦路径变化，需要连带改多处引用

6. 分类方案

下面是建议分类与未来目标路径。注意：这里是“目标路径”，不是本轮实际迁移。

6.1 规范 / 规则

工程与协作规范

• docs/bugfix-playbook.md
  • 类型：规范
  • 状态：稳定使用
  • 目标路径：docs/specs/engineering/bugfix-playbook.md
• docs/code-structure-splitting-rules-v1.md
  • 类型：规范
  • 状态：稳定使用
  • 目标路径：docs/specs/engineering/code-structure-splitting-rules-v1.md
• docs/pm-agent-lean-efficiency.md
  • 类型：规范
  • 状态：稳定使用
  • 目标路径：docs/specs/workflow/pm-agent-lean-efficiency.md

UI / 体验规范

• docs/mobile-portrait-rulebook.md
  • 类型：规范
  • 状态：稳定使用
  • 目标路径：docs/specs/ui/mobile-portrait-rulebook.md
• docs/mobile-portrait-ui-iteration-spec.md
  • 类型：规范
  • 状态：稳定使用
  • 目标路径：docs/specs/ui/mobile-portrait-ui-iteration-spec.md
• docs/web-landscape-ui-iteration-spec.md
  • 类型：规范
  • 状态：稳定使用
  • 目标路径：docs/specs/ui/web-landscape-ui-iteration-spec.md

数据规范

• docs/design/《同福客栈》数据结构与表格设计方案 (JSON TypeScript 规范).md
  • 类型：规范
  • 状态：稳定使用
  • 目标路径：docs/specs/data/tongfu-data-structure-and-table-spec.md

6.2 计划 / 进度

Active

• docs/development-roadmap.md
  • 类型：进度主入口
  • 状态：进行中
  • 目标路径：docs/plans/active/development-roadmap.md
  • 本轮：冻结
• docs/version-history.md
  • 类型：版本记录
  • 状态：进行中
  • 目标路径：docs/plans/active/version-history.md
  • 本轮：冻结
• docs/daily-plans/2026-06-23.md
  • 类型：日计划
  • 状态：进行中
  • 目标路径：docs/plans/daily/2026-06-23.md
  • 本轮：冻结
• docs/event-table-index-v1.md
  • 类型：执行索引
  • 状态：进行中
  • 目标路径：docs/plans/active/event-table-index-v1.md
  • 本轮：冻结
• docs/event-execution-checklist-v1.md
  • 类型：执行清单
  • 状态：进行中
  • 目标路径：docs/plans/active/event-execution-checklist-v1.md
  • 本轮：冻结

Backlog

• docs/asset-gap-list.md
  • 类型：资源补齐计划
  • 状态：后续储备
  • 目标路径：docs/plans/backlog/asset-gap-list.md

6.3 设计文档

Completed / systems

• docs/time-system-v1.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/time-system-v1.md
• docs/day-night-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/day-night-design.md
• docs/day-night-tech-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/day-night-tech-design.md
• docs/day-night-endgame-playbook.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/day-night-endgame-playbook.md
• docs/endgame-save-load-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/endgame-save-load-design.md
• docs/failure-endgame-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/failure-endgame-design.md
• docs/jianghu-briefing-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/jianghu-briefing-design.md
• docs/inn-area-expansion-v1.md
  • 状态：已落地
  • 目标路径：docs/design/completed/systems/inn-area-expansion-v1.md

Completed / gameplay

• docs/martial-tournament-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/gameplay/martial-tournament-design.md
• docs/bond-storylines-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/gameplay/bond-storylines-design.md
• docs/staff-depth-economy-design.md
  • 状态：已落地
  • 目标路径：docs/design/completed/gameplay/staff-depth-economy-design.md
• docs/story-event-nodes-v1.md
  • 状态：已落地
  • 目标路径：docs/design/completed/narrative/story-event-nodes-v1.md

Active / gameplay

• docs/government-warehouse-auction-v1.md
  • 状态：进行中
  • 目标路径：docs/design/active/gameplay/government-warehouse-auction-v1.md
  • 本轮：冻结
• docs/design/玩法：官府抄缴库房竞标会/官府抄缴库房竞标会.md
  • 状态：进行中
  • 目标路径：docs/design/active/gameplay/government-warehouse-auction-design.md
  • 本轮：冻结
• docs/design/玩法：官府抄缴库房竞标会/auctiontab.tsx.md
  • 状态：进行中
  • 目标路径：docs/design/active/ui/auction-panel-ui-notes.md
  • 本轮：冻结

Active / systems

• docs/design/账号体系以及多周目设计/《同福客栈》本地化账号与多周目系统设计文档（V1.0 落地版）.md
  • 状态：进行中
  • 目标路径：docs/design/active/systems/account-playthrough-core.md
  • 本轮：冻结
• docs/design/账号体系以及多周目设计/《同福客栈》存读档与多周目交互设计规范 (UIUX).md
  • 状态：进行中
  • 目标路径：docs/design/active/ui/account-playthrough-save-load-uiux.md
  • 本轮：冻结
• docs/design/账号体系以及多周目设计/《同福客栈》双币循环经济体系设计文档.md
  • 状态：进行中
  • 目标路径：docs/design/active/systems/dual-currency-economy.md
  • 本轮：冻结
• docs/design/账号体系以及多周目设计/《同福客栈》游戏启动与多周目系统 UIUX 设计文档 (V1.0).md
  • 状态：进行中
  • 目标路径：docs/design/active/ui/account-playthrough-launch-uiux.md
  • 本轮：冻结
• docs/design/玩法：客栈经营状态以及buff设计/《同福客栈》经营状态与核心数值体系设计文档（V2.0 优化落地版）.md
  • 状态：进行中
  • 目标路径：docs/design/active/systems/inn-status-core-design.md
  • 本轮：冻结
• docs/design/玩法：客栈经营状态以及buff设计/《同福客栈》经营状态与核心数值体系设计文档 —— Buff系统子文档（V1.0 架构版）.md
  • 状态：进行中
  • 目标路径：docs/design/active/systems/buff-system-subdesign.md
  • 本轮：冻结

Backlog / gameplay

• docs/design/玩法：成就/《同福客栈》市井江湖成就绘卷（纯玩法设计）.md
  • 状态：后续储备
  • 目标路径：docs/design/backlog/gameplay/achievement-flavor-design.md
• docs/design/玩法：成就/《同福客栈》账号成就系统设计与技术实现方案.md
  • 状态：后续储备
  • 目标路径：docs/design/backlog/systems/account-achievement-system.md
• docs/p2p-multiplayer-playbook.md
  • 状态：后续储备
  • 目标路径：docs/design/backlog/gameplay/p2p-multiplayer-playbook.md
• docs/story/story0-1
  • 状态：后续储备
  • 目标路径：docs/design/backlog/narrative/story0-1-material-pool.md

Backlog / systems

• docs/design/《同福客栈》无服务器 Web 端经营体系补充方案（联机与存储专题）.md
  • 状态：后续储备
  • 目标路径：docs/design/backlog/systems/serverless-web-architecture-supplement.md

7. 下一阶段可安全迁移顺序

这里说的是“建议顺序”，不是本轮实际执行。

Phase 0：本轮已做

• 只新增入口文档
• 不改旧路径
• 不碰源码

Phase 1：最低风险迁移

前提：当天执行线程结束，确认没有线程继续直接引用旧路径。

优先迁移这些“引用相对少、语义相对独立”的文档：

1. docs/asset-gap-list.md
2. docs/p2p-multiplayer-playbook.md
3. docs/story/story0-1
4. docs/design/玩法：成就/*
5. docs/design/《同福客栈》无服务器 Web 端经营体系补充方案（联机与存储专题）.md

Phase 2：规范层迁移

在全仓统一更新引用后，再迁移这些规范文档：

1. docs/bugfix-playbook.md
2. docs/code-structure-splitting-rules-v1.md
3. docs/pm-agent-lean-efficiency.md
4. docs/mobile-portrait-rulebook.md
5. docs/mobile-portrait-ui-iteration-spec.md
6. docs/web-landscape-ui-iteration-spec.md
7. docs/design/《同福客栈》数据结构与表格设计方案 (JSON TypeScript 规范).md

原因：

• 这些文档很适合归档到 specs/
• 但它们被多份文档引用，迁移前必须先改链路

Phase 3：已落地设计迁移

这批内容的实现基线已经比较稳，适合在规范层迁完后集中归位：

1. time-system-v1.md
2. day-night-design.md
3. day-night-tech-design.md
4. day-night-endgame-playbook.md
5. story-event-nodes-v1.md
6. failure-endgame-design.md
7. endgame-save-load-design.md
8. jianghu-briefing-design.md
9. inn-area-expansion-v1.md
10. martial-tournament-design.md
11. bond-storylines-design.md
12. staff-depth-economy-design.md

Phase 4：进行中设计迁移

必须等今天的功能线程彻底收口，再动：

1. 账号 / 多周目整组
2. Buff / 客栈状态整组
3. 官府竞标会整组
4. government-warehouse-auction-v1.md

原因：

• 这些文档现在不是纯归档，它们还是活跃实现依据

Phase 5：计划层重构

最后再处理强时间文档与执行清单：

1. development-roadmap.md
2. version-history.md
3. daily-plans/*
4. event-table-index-v1.md
5. event-execution-checklist-v1.md

原因：

• 这批文件链接最多
• 一旦动路径，会连带影响最大
• 适合在整个 docs 新结构稳定后再迁

8. 迁移执行注意事项

后续真的开始迁移时，建议严格按下面顺序做：

1. 先新增目标目录和入口 README
2. 再补旧路径到新路径的索引映射
3. 再全仓改链接
4. 最后做 rename
5. rename 后跑一次全仓 Markdown 链接扫描

9. 本轮实际动作边界

本轮允许：

• 新增 docs/README.md
• 新增本方案文档

本轮不做：

• 大规模 rename
• 修改 docs/daily-plans/2026-06-23.md 语义
• 修改 docs/development-roadmap.md 语义
• 修改 docs/version-history.md 语义
• 修改源码
• 提交、发布