让 Direct GUI 回合落下有界行为审计账本
Project CI / Repository checks (pull_request) Failing after 3m49s
Project CI / Frontend tests (pull_request) Successful in 4m6s
Project CI / Backend tests (pull_request) Successful in 8m6s
Project CI / Native shell tests (pull_request) Successful in 17m50s

- 新增 DirectCodexTurnAudit,把 item/completed 抽成项目内 jsonl 与 agent.db 摘要
- GUI Direct 回合记录 sidecar 路径、native 读/MCP/写文件、offeredRead 与 firstDesign
- 不落 stdout、patch、MCP result,不进聊天 jsonl,失败不阻断做游戏
- 补充技术方案、decision-log 与文档索引
This commit is contained in:
2026-08-31 10:21:04 +00:00
parent 1cb8e92e17
commit 0951bb2013
11 changed files with 1955 additions and 46 deletions
@@ -25,6 +25,14 @@
---
## 2026-08-31 Direct 回合把 Codex item 落成有界行为账本
- 背景:sidecar 已让模型看见本轮附件路径,但 native 读 / MCP / 写文件只存在于隔离 `CODEX_HOME` 的瞬时 stdout,回合结束即删。无法判断「没读附件」还是「读了仍走默认收集类」。
- 决策:GUI DirectProject 每个 `clientTurnId` 追加 `.agent/runtime/direct-codex/turns/<id>.jsonl`,并在 `agent.db` 写一条 `direct.codex.turn` 摘要。记 sidecar 提供的路径与文件 hash、`item/completed` 的 Read/List/Search/MCP/写文件(不含 stdout、patch、MCP result),以及 `offeredRead` / `firstDesign`。审计 fail-open,不阻断做游戏。Home、CLI、Supervisor 收据模型不接。不灌附件正文,不强制读取,不为 GDD 开特例。
- 影响范围:`direct_codex_audit.rs`、Direct GUI command 边界、Codex collect 循环;前端 / jsonl 气泡 / sidecar 文案不变。
- 验证方式:Rust fixture 覆盖 turn_start hash、绝对路径相对化、stdout/diff 不落盘、art brief 保留、list/search 不算已读、firstDesign 顺序、256 条截断、写盘失败不 panic;sidecar 渲染与 Direct 活动词测试保持通过。
- 关联文档:`docs/technical/【技术方案】Direct回合行为审计账本-2026-08-31.md`、issue #212。
## 2026-08-31 Direct 本轮附件只映射路径,不灌正文、不区别 GDD
- 背景:issue #212。首页附件已经复制到 `assets/uploads/` 并登记,但 Direct 首轮只把用户原文发给 Codex,原文件名不是磁盘路径,模型会另起一套玩法。
@@ -25,9 +25,10 @@ AI 游戏创作 / DirectProject / UI workflow:
2. `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md`
3. `docs/technical/【技术方案】立项策划Agent(Fast GDD)-2026-08-10.md`
4. `docs/technical/【技术方案】DirectProject本轮附件路径映射-2026-08-31.md`
5. `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`
6. `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md`
7. UI 编辑器、宿主壳和当前测试专题文档
5. `docs/technical/【技术方案】Direct回合行为审计账本-2026-08-31.md`
6. `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`
7. `docs/【技术方案】UI工作流资源桥接与Runtime执行-2026-08-24.md`
8. UI 编辑器、宿主壳和当前测试专题文档
图片画布 / 媒体生成: