文档总览
docs/ 现在按主题拆成了 6 类；旧后端路线文档开始聚合和删除，后续实现以 Rust / SpacetimeDB 当前基线为准。
快速入口
- 经验沉淀：项目开发经验、UI 交接、历史实现经验。
- 审计与复盘：工程审查、文本/乱码审计、专项落地审计。
- 系统设计：玩法、关系、物品与对话设计。
- 技术方案：动画、服务端、外部产品形态拆解。
- 规划与优先级：当前阶段的迭代排序与落地优先级。
- 参考目录：脚本/Function 速查入口。 重点补充：RPG 创作与运行时脚本职责地图见 RPG_CREATION_AND_RUNTIME_SCRIPT_RESPONSIBILITY_MAP_2026-04-28.md。
- 埋点查询：埋点原始事件与聚合投影的本地 SQL 查询。
- 运营查询：任务、领奖、钱包对账等后台核查查询。
- PRD：产品需求与阶段计划；后台管理独立前端工程见 ADMIN_WEB_CONSOLE_PRD_2026-04-30.md，新增 RPG 开场动画方案见 AI_NATIVE_RPG_OPENING_ANIMATION_PRD_2026-04-25.md，新增抓大鹅 Match3D 玩法方案见 AI_NATIVE_MATCH3D_CREATOR_AND_GAMEPLAY_SYSTEM_PRD_2026-04-30.md，方洞挑战创作、发布与试玩闭环见 AI_NATIVE_SQUARE_HOLE_CREATOR_AND_GAMEPLAY_SYSTEM_PRD_2026-05-04.md。
生产部署切换到 systemd + Nginx + SpacetimeDB 自托管的总方案见 PRODUCTION_DEPLOYMENT_PLAN_2026-05-02.md，该文档也是当前生产 Jenkinsfile 的唯一入口。SpacetimeDB 表结构变更、自动迁移边界和保留旧数据的分阶段迁移流程见 SPACETIMEDB_SCHEMA_CHANGE_CONSTRAINTS.md；private 表迁移 JSON 导入导出、HTTP 413 分片导入和旧数据库迁移流水线经验见 SPACETIMEDB_JSON_STRING_MIGRATION_PROCEDURE_2026-04-27.md 与 JENKINS_SPACETIMEDB_DATABASE_MIGRATION_PIPELINES_2026-04-29.md；后台管理独立前端工程技术方案见 ADMIN_WEB_CONSOLE_TECHNICAL_SOLUTION_2026-04-30.md。
SpacetimeDB 表结构变更、自动迁移边界和保留旧数据的分阶段迁移流程见 SPACETIMEDB_SCHEMA_CHANGE_CONSTRAINTS.md。
创作 Agent 问答流式失败时保留已显示回复、并透出更具体上游错误的契约见 CREATION_AGENT_STREAM_FAILURE_RETENTION_FIX_2026-05-05.md。
maincloud 相关脚本、环境变量、测试名和文档要求已统一判定为历史残留，后续禁止新增、运行或引用；当前后端 smoke 使用 npm run api-server 与 /healthz，详细规则见 MAINCLOUD_REFERENCE_REMOVAL_POLICY_2026-05-06.md。
推荐阅读顺序
- 先看 经验沉淀，快速建立这个项目的开发共识。
- 再看 工程审查总览 和 文本审计总览，了解当前风险。
- 需要排期时看 规划与优先级。
- 需要补方案时进入 系统设计 / 技术方案；涉及后端先看 当前后端实现基线，涉及生产发布链路先看 生产部署计划，涉及 SpacetimeDB 表结构变更时再看 表结构变更约束。
- 需要对齐目标边界时再进入 PRD。
分类规则
experience/：偏方法论、交接经验、长期有效的开发结论。audits/：偏“现状扫描 / 问题定位 / 是否达标”的审查类文档。design/：偏玩法机制、叙事关系、系统结构设计。technical/：偏技术选型、实现路线、竞品/产品形态拆解。planning/：偏阶段优先级与推进顺序。reference/：偏目录、速查、检索辅助。tracking/：偏埋点原始事实和聚合投影查询，不放任务进度或钱包对账。operations/：偏后台运营核查、对账和排障查询。