60 lines
3.3 KiB
Markdown
60 lines
3.3 KiB
Markdown
# 文档地图与阅读索引
|
||
|
||
更新时间：`2026-08-31`
|
||
|
||
## 阅读顺序
|
||
|
||
通用复杂任务：
|
||
|
||
1. `AGENTS.md`
|
||
2. `docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md`
|
||
3. `docs/README.md`
|
||
4. `docs/project-memory/shared-memory/`
|
||
5. 与任务匹配的当前专题合同
|
||
|
||
后端 / 数据真相 / SpacetimeDB：
|
||
|
||
1. `docs/【后端架构】server-rs与SpacetimeDB数据契约-2026-05-15.md`
|
||
2. `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
3. `server-rs/crates/api-server/src/app.rs`、`server-rs/crates/api-server/src/modules.rs` 与对应 crate README / 源码
|
||
4. `docs/openapi/genarrative-external-v1.openapi.json`（涉及 External v1 时）
|
||
|
||
AI 游戏创作 / DirectProject / UI workflow：
|
||
|
||
1. `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`
|
||
2. `docs/technical/【技术方案】策划会话RuntimeV2接入与旧链路退役-2026-09-03.md`
|
||
3. `docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md`
|
||
4. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
|
||
5. `docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md`（仅存量旧链路）
|
||
2. `docs/technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md`
|
||
3. `docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md`
|
||
4. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
|
||
5. `docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md`
|
||
6. `docs/technical/【技术方案】DirectProject本轮附件路径映射-2026-08-31.md`
|
||
7. `docs/technical/【技术方案】Direct回合行为审计账本-2026-08-31.md`
|
||
8. `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`
|
||
9. `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md`
|
||
10. UI 编辑器、宿主壳和当前测试专题文档
|
||
|
||
图片画布 / 媒体生成：
|
||
|
||
1. `docs/technical/【技术方案】客户端素材创作无限画布阶段一合同-2026-08-05.md`
|
||
2. `docs/【编辑器】图片画布结构化持久化与迁移回滚方案-2026-07-19.md`
|
||
3. `docs/technical/【后端架构】编辑器生成结果原子提交与幂等重放方案-2026-08-06.md`
|
||
4. `docs/【编辑器】画板音乐生成入口设计-2026-06-18.md`
|
||
|
||
生产部署 / 服务器 / Jenkins：
|
||
|
||
1. `docs/【开发运维】本地开发验证与生产运维-2026-05-15.md`
|
||
2. `docs/technical/【开发运维】Jenkins容器预览部署控制面技术方案-2026-08-15.md`
|
||
3. `deploy/` 当前脚本、systemd unit、Nginx README 和实际主机状态
|
||
|
||
## 生命周期规则
|
||
|
||
- `docs/README.md` 是人工阅读入口；代码和当前专题冲突时，以代码和最新专题为准。
|
||
- `shared-memory/` 只保留稳定事实、唯一决策、通用流程和已验证坑点。
|
||
- `plans/` 只保留正在执行且有明确下一门禁的计划；完成或作废后删除或融合。
|
||
- `todos/` 只保留真实开放、有人负责且有关闭条件的事项；退役对象不保留未来准入 TODO。
|
||
- 一次性实施记录、阶段测试数字、分支历史和旧方案不进入长期入口，追溯使用 Git 历史。
|
||
- 新增 Markdown 文件名使用 `【标签名】中文标题-YYYY-MM-DD.md`；不为历史文件做无关批量重命名。
|