设计文档（Design）

存放《同福客栈挂机游戏》的所有系统/玩法/UI 设计文档,按状态分桶。

当前真值在 active/;已落地但不再迭代的进 completed/; 等待开工的进 backlog/;草稿与早期方案各回各家。

子目录

| 目录 | 职责 | 文件数 | | :--- | :--- | ---: | | active/ | 当前真值,正在推进或等待玩家验收 | 61 | | backlog/ | 待办需求设计,未派发 | 8 | | completed/ | 已落地,不再迭代 | 30 | | buff/ | buff 系统专门区 | 9 | | technical/ | 技术方案(非玩法) | 3 | | drafts/ | 设计草稿,等待拍板 | 1 | | 6.25玩法/ | 6-25 玩法分册(历史) | 1 | | 6.26玩法/ | 6-26 玩法分册(历史) | 8 |

状态流转

drafts/  →  active/  →  completed/
 草稿        在途/验收    落地归档

(backlog/ 是独立通道:需求池,不一定经过 drafts/)

准入规则

满足以下任一条,放入 design/:

• 描述一个玩法机制、系统行为、UI 表现的设计细节
• 会被 plans/active/ 或 handoff/index.md 引用
• 写明设计意图 + 边界 + 验收口径
• 玩家能"看见或感受到"的成果

命名

• 系统:active/systems/<系统名>-v<版>.md(例:经济系统-v2.md)
• 玩法:active/gameplay/<玩法名>-v<版>.md(例:拍卖-v1.md)
• UI:active/ui/<页面名>-v<版>.md(例:官府竞标台-v1.md)

边界

• 设计真值 ≠ 代码真值。代码以 src/data/ src/utils/ src/components/ 为准。
• 当设计与代码冲突时,先在 handoff/index.md 提 issue,不要在 设计文档里写"已实现"——这是 closure 文档的责任。
• buff/ 是被高频引用的子域,保留独立目录;6.25玩法/ 6.26玩法/ 是 历史分册,不要把新方案塞进它们。

注意事项

• active/ 里的文档路径可能被 daily-plans/ 直接引用,移动前先 grep。
• completed/ 里的旧路径可能已被其他文档引用,删除前先 grep。
• backlog/ 的需求不代表已派发,只代表"想做的池子";真正派发以 handoff/index.md 为准。

看哪份最快入门

• 新加入:看 active/ 最近 30 天更新的 3-5 份
• 做某个模块:看 active/<domain>/ + completed/<domain>/(对比当前 vs 已落地)
• 数值 / 经济:看 active/systems/经济系统-v2.md + ../../economy-sim/
• 剧情相关:看 active/systems/剧情系统-v1.md(如有) + ../../story/主线故事/
• 联机 / 拍卖:看 active/systems/联机-v1.md active/systems/拍卖-v1.md