suzmii
c2b851cc36
- PRD §3.3：栏目页改为纵向滚动网格，顺序由 sidecar 记录的 (y, x, resourceId) 读序推出，新增列数控件与栏目内拖拽排序条文 - PRD §3.3.1：三阶段改写为当前形态（本体卡保留；阶段二改为栏目分页网格；阶段三改为未排序栏目的初始顺序派生） - PRD §3.3.2：可见性预取口径改为以栏目滚动容器为交叉根 - PRD §5.2：实现状态与字段语义改为「x / y 只承载栏目内顺序」，新增顺序阶梯、已排序栏目新资源追加末尾、列数偏好与关系说明条文 - PRD §5.2.4：删除 viewport、wheel、拖动改写坐标等画布条文，改为网格、列数与拖拽排序 - PRD §5.2.5：手动拖动合同改为拖拽排序合同 - PRD §5.2.6：删除资源依赖关系图层整节 - PRD §7.2：验收改为顺序持久化；§7.3 依赖关系图验收整节删除；§7.5 重写为栏目分页纵向网格验收，新增「纵向滚动无横向溢出」与「列数被记住」两条判据 - PRD §6/§8：分阶段范围与非目标同步 - 技术方案：原《GameAgent资源自由画板与快速编辑》改名为《AGC资源管理页纵向网格与排序》，重写为当前形态（页面形态、栏目内顺序、列数偏好、拖拽排序、关系说明），保留权威数据、焦点竞态与派生编辑条文 - 实施计划：资源卡与资源管理页边界改为栏目网格、顺序落盘、列数偏好与滚动容器可见性 - decision-log：新增 2026-09-11 决策（含用户明确判断优于 PRD 的事实依据，以及有意推翻 1da7dc62a） - pitfalls：整体改写「AGC 资源管理页真正自制的交互面」条目 - docs/README.md 与 document-map.md：更新改名后的专题文档入口
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/【技术方案】AGC资源管理页纵向网格与排序-2026-09-11.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`；不为历史文件做无关批量重命名。
|