k88936
876529e668
- 删除 ProjectSupervisorView、SupervisorChatOnlyView、ProjectWorkspaceChatPane、AgentConversationOverlay、DeveloperProjectPanels、DeveloperRuntimePanels 与 features/agent-runtime/panels.tsx - 删除 Supervisor 独立调试窗口：windows.rs 的 supervisor_chat_window_url / open_project_supervisor_chat_window、main.rs 的 invoke 注册、?supervisor-chat 与 ?agent-chat 前端入口、developer.json capability 和对应 Rust 用例 - 删除工作台壳的开发者 Agent 面板：DeveloperAgentPanel、useDeveloperAgentPanel、useDeveloperAgentState、developerAgentControls - App.tsx 删除只服务退役面板的 state/ref/effect/handler（agentConversation*、文件/记忆/资产/画板/预览面板处理、commandLog、llmConfigStatus、editorBaseUrl、回放历史与 trace 面板状态、selectedAgent 等）以及由此产生的空分支，并把 requestRuntimeConfigOpen 接回本地 RuntimeConfigDialog - 立项策划独立成模块：Design Agent 与 Planning V2 的容器和表现移到 view/project-development/planning/（PlanningChatView、PlanningUserInputCard、GddApprovalCard、DesignAgentSurface、PlanningLaneRuntimeStrip、planningLane、planningSessionV2、planningSessionContract） - 改名到中性概念：ProjectSupervisorComponentProps→ProjectChatComponentProps、WorkspaceLauncherShellProps.ProjectSupervisor→ProjectChat、ProjectDevelopmentView.supervisor→chat、orchestrationMode→agentDockVisible、initialSupervisorMessageClaims→initialTurnClaims、ProjectManifestSnapshotSource 'supervisor'→'chat'、CSS project-supervisor-*/project-planning-*→project-chat-* - 删除 PROJECT_SUPERVISOR_AGENT_ID 与 PROJECT_SUPERVISOR_PLAN_SOURCE 常量 - 工作台壳自己订阅 game-creator-manifest-invalidated，用 revision→清单→revision 配对读（source: asset-event）并入 currentProjectContext，且不重新检查项目目录；测试夹具改为按监听器集合广播该事件 - 删除只钉住退役界面的 appSurface 用例（旧调试窗口、开发者面板、Agent 对话浮层、运行历史面板） - 同步文档：ADR、DirectProject 聊天模块抽离实施计划与里程碑、Provider 推理里程碑、策划会话 RuntimeV2、AI 游戏创作实施计划，并在 decision-log 新增 2026-09-19 条 - 删除随退役面板失去调用方的模块与导出：projectSummaryCommands.ts（1054 行旧 Supervisor 斜杠命令处理器）、AGENT_RUN_HISTORY_* 常量、agent-runtime/model.ts 与 project-summary/agentPresentation.ts 里的死导出，以及 agentRunTrace / memoryCommands / projectCommandPolicy 中无调用方的校验与解析函数 - 更新 scripts/check-config.mjs 与 scripts/check-native-shells.mjs 的窗口与命令守卫
62 lines
3.5 KiB
Markdown
62 lines
3.5 KiB
Markdown
# 文档地图与阅读索引
|
||
|
||
更新时间：`2026-08-31`
|
||
|
||
## 阅读顺序
|
||
|
||
通用复杂任务：
|
||
|
||
1. `AGENTS.md`
|
||
2. `docs/【协作规范】Agent工作入口与执行准则-2026-06-22.md`
|
||
3. `docs/【协作规范】规范驱动开发工作流-2026-09-12.md`（跨模块或公开合同任务）
|
||
4. `docs/【协作规范】文档生命周期与现状索引-2026-09-12.md`
|
||
5. `docs/README.md`
|
||
6. `docs/project-memory/shared-memory/`
|
||
7. 与任务匹配的当前专题合同
|
||
|
||
后端 / 数据真相 / 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`（仅存量旧链路）
|
||
6. `docs/technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md`
|
||
7. `docs/technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md`
|
||
8. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
|
||
9. `docs/technical/【技术方案】立项策划Agent（Fast GDD）-2026-08-10.md`
|
||
10. `docs/technical/【技术方案】DirectProject本轮附件路径映射-2026-08-31.md`
|
||
11. `docs/technical/【技术方案】Direct回合行为审计账本-2026-08-31.md`
|
||
12. `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`
|
||
13. `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md`
|
||
14. 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`；不为历史文件做无关批量重命名。
|