GenarrativeAI/Genarrative
10
0
Fork 0
Code Issues 18 Pull Requests 6 Actions Packages Projects 1 Releases Wiki Activity

Merge remote-tracking branch 'refs/remotes/origin/master' into feat/log-the-dianosis
Project CI / AI game creator shell Rust crates (pull_request) Successful in 2m56s
Details
Project CI / AI game creator shell Rust smoke (pull_request) Successful in 3m49s
Details
Project CI / Backend tests (pull_request) Successful in 5m7s
Details
Project CI / AI game creator shell Rust lane 2/2 (pull_request) Successful in 9m13s
Details
Project CI / Native shell tests (pull_request) Successful in 6m34s
Details
Project CI / AI game creator shell Rust lane 1/2 (pull_request) Successful in 10m57s
Details
Project CI / Repository checks (pull_request) Successful in 2m25s
Details
Project CI / Frontend tests (pull_request) Successful in 3m39s
Details
Project CI / AI game creator shell web tests (pull_request) Successful in 3m46s
Details

Browse Source 
# Conflicts:
#	docs/project-memory/shared-memory/decision-log.md
#	docs/project-memory/shared-memory/pitfalls.md
This commit is contained in:
王德宇
2026-09-22 10:26:13 +08:00
parent 74e6ac90a7 6973a2cb45
commit a3586bc995
341 changed files with 15188 additions and 57766 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/README.md
+2
View File
@@ -39,6 +39,7 @@
- [策划会话 Runtime V2 接入与旧链路退役方案](./technical/【技术方案】策划会话RuntimeV2接入与旧链路退役-2026-09-03.md)：历史方案，仅用于追溯 V2 的实现与退役过程，不作为当前实现依据。
- [DirectProject Codex 原始历史与异常恢复](<./technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md>)：原始 Responses item 持久化、线程注入与异常回合收尾。
- [DirectProject 对话历史单一事实源](./adr/【ADR】DirectProject对话历史单一事实源-2026-09-16.md)：AGC 项目开发对话只以项目对话历史与运行态事件为真相源，聊天投影不落盘。
- [DirectProject 独立聊天容器与工作台钱包布局](./adr/【ADR】DirectProject独立聊天容器与工作台钱包布局-2026-09-18.md)：DirectProject 与 Supervisor 等路径分容器，钱包入口由项目工作台布局独立承载。
- [GameAgent 对话工具调用卡片](./technical/【技术方案】GameAgent对话工具调用卡片-2026-09-14.md)：把右侧对话里的执行命令 / 写文件投影成 Codex 风格可折叠卡片，含采集、独立历史文件、事件字段与回读契约。
- [DirectProject 客户端 Skill 与 MCP 扩展导入方案](./technical/【技术方案】DirectProject客户端Skill与MCP扩展导入方案-2026-08-31.md)：客户端扩展导入、按独立 Skill/MCP 拆分、命名、启用和启动时注入边界。
- [AGC 通用插件宿主与编辑器适配](./technical/【技术方案】AGC通用插件宿主与编辑器适配-2026-09-09.md)：通用插件宿主、SDK、权限审计、UI 挂载和 Cocos 编辑器适配边界。
@@ -48,6 +49,7 @@
- [AGC 客户端更新检查与下载](./technical/【技术方案】AGC客户端更新检查与下载-2026-08-31.md)：启动版本检测、固定 dev 服务、OSS 清单与官网最新客户端下载。
- [AGC 总版本号与发号](./technical/【技术方案】AGC总版本号与发号-2026-09-20.md)：客户端版本号收口到 OSS `agc/global-version.json`，统一构建一次发号供各渠道共用，渠道高水位降级为断言。
- [AGC 模板库与模板建项](./technical/【技术方案】AGC模板库与模板建项-2026-09-17.md)：`templates/` 前缀的模板库契约、下载安装与「用模板建项目」链路。
- [AGC 模板包组织指南](./【模板规范】AGC模板包组织指南-2026-09-21.md)：模板 ZIP 的根目录结构、Cocos 工程保留项、禁止放入的内容、封面与体积上限、版本不可变与发布前自检。
- [DirectProject 本轮附件路径映射](./technical/【技术方案】DirectProject本轮附件路径映射-2026-08-31.md)：Direct 首轮只映射附件原名与项目相对路径，不灌正文、不区别 GDD。
- [Direct 回合行为审计账本](./technical/【技术方案】Direct回合行为审计账本-2026-08-31.md)：Direct GUI 回合把 native 读 / MCP / 写文件落成项目内有界时间线，用于判断有没有打开本轮附件。
- [项目开发工作台 PRD](./prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md)：当前工作台页面和验收边界。
docs/adr/【ADR】DirectProject独立聊天容器与工作台钱包布局-2026-09-18.md
+26
View File
@@ -0,0 +1,26 @@
# DirectProject 独立聊天容器与工作台钱包布局
状态：已接受
AGC 项目开发工作台的普通项目固定使用 DirectProject；它不再作为 `ProjectSupervisorView` 的条件分支，而由 `view/project-development/chat/` 下的 `DirectProjectChatView` 与 controller 拥有自己的订阅、历史、发送、队列、附件和中止生命周期。Supervisor 前端链路（独立调试窗口、纯聊天容器、工作台壳里的 Supervisor 运行态与专业 Agent 面板）已整体退役，项目对话只保留 DirectProject 与立项策划两条产品路径；立项策划当前只有 Design Agent（策划 Agent V1/V2 的会话、专用命令、审批卡与展示适配已于 2026-09-20 退役，见 shared-memory 决策记录）。行为中立的 Composer、消息、工具卡片和设置基础表现可以复用，但不同产品路径不共享行为容器，也不保留运行时 feature flag、兼容别名、Direct fallback 或双跑路径。
项目工作台布局拥有跨面板的账户/钱包入口。钱包不再作为 `walletEntry` 传入 DirectProject 聊天上下文或聊天设置浮层，而是在 `ProjectDevelopmentView` 的布局级头部/工具栏独立渲染；本次只改变布局归属与嵌套关系，保留钱包入口本身的可用性。
这项边界选择是为了让 DirectProject 的事实源与生命周期可以独立测试和演进，同时避免把工作台级账户状态与聊天状态耦合；一次性替换通过 Git revert 回滚，不增加运行时开关、兼容别名或条件兼容分支。
## 模块结构
公开入口只有 `view/project-development/chat/DirectProjectChatView.tsx`，内部按职责分层：
- `components/`：表现层，一个组件一个目录，组件自己的逻辑与表现同目录（`components/ToolCallGroup/` 放 `ToolCallGroup.tsx` 与 `toolCallGroupPresentation.ts`；`components/DirectProjectComposer/` 放 `DirectProjectComposer.tsx`、`ComposerControls.tsx`、`chatComposerQueue.ts`、`chatComposerVoice.ts`）。
- `controller/`：会话控制器 `useDirectProjectChatController`、项目清单订阅 `useDirectProjectManifest`，以及线程订阅与聊天 reducer 的独立 hook `useDirectThreadChatSubscription`。
- `conversation/`、`history/`：纯模块（条目投影、历史分页、订阅锚点闸门、附件映射）。
- `generated/`：Rust 侧 ts-rs 导出的 Direct 契约，不在前端手抄形状。
`useDirectThreadChatSubscription` 持有 `subscribe → consume → notify` 单飞循环与聊天 reducer 状态，是 DirectProject 运行态的唯一事实源；控制器只读它投影后的条目与回合忙态，历史分页通过同一个 reducer 并入。
工作台壳要把运行/预览这类工作台级动作的结果说给用户时，只通过 `DirectProjectChatView` 的 `ref` 句柄（`announce`）交给聊天自己的本地消息流；壳不持有 Direct 的聊天消息。
立项策划（当前只有 Design Agent）的容器与表现与 DirectProject 并列放在 `view/project-development/planning/`（`PlanningChatView`、`DesignAgentSurface`）；两条产品路径共享的只有无行为真相的表现组件：输入盒的模型 / 推理档控件（`features/project-workspace/ConversationModelSelect.tsx` 与 `chat/components/DirectProjectComposer/ComposerControls.tsx` 的 `ComposerReasoningEffortSelect`）和思考折叠入口（`chat/components/AgentReasoning/AgentReasoning.tsx`，折叠态单行纯文本预览、展开态安全 Markdown）。共享的只是表现，回合、会话与配置写回仍由各自入口负责。
`game-creator-manifest-invalidated` 由工作台壳与 DirectProject 聊天各自订阅：壳做一次配对读（`revision → 清单 → revision`，`source: 'asset-event'`）把运行态落盘的新资源并入 `currentProjectContext`，这次刷新**不**重新检查项目目录；聊天侧仍由 `useDirectProjectManifest` 刷新自己的 `@` 引用清单。
docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md
+2 -2
View File
@@ -1,6 +1,6 @@
# AI 游戏创作项目开发工作台 PRD
更新时间：`2026-09-21`（2026-09-20 音频生成并入图片类那份后台任务账本、派生/修改类任务并入同一「生成任务」侧栏，2026-09-21 卡片浮层改为「提交即关」、**「生成任务」侧栏从画布左侧贴边改为画布右上角锚点（开关常驻）**、**资源卡可拖到对话栏批量 @ 引用**、**替换面板改为非模态浮层并支持在画布上点选目标**（验收现场两条修正：任务锚点改挂画布那一格、展开后开关让位），见 §3.10 / §5.3 / §7.8 / §7.9 与 [`【功能说明】AGC聊天素材引用`](../【功能说明】AGC聊天素材引用-2026-09-08.md)；2026-09-14 图片类生成后台化：入口 IPC 为 `start_local_project_asset_generation` + 项目内任务账本 + 本地排队 + 非模态「生成任务」面板；2026-09-13 新增的功能画布底部工具栏入口矩阵 §3.10 / §7.9，以及右侧 Supervisor 对话气泡、可访问对比度与过程卡布局收口，资源卡预览、分区布局、非破坏性资源编辑、资源替换与 Godot 双根合同保持不变）
更新时间：`2026-09-21`（2026-09-20 音频生成并入图片类那份后台任务账本、派生/修改类任务并入同一「生成任务」侧栏，2026-09-21 卡片浮层改为「提交即关」、**「生成任务」侧栏从画布左侧贴边改为画布右上角锚点（开关常驻）**、**资源卡可拖到对话栏批量 @ 引用**、**替换面板改为非模态浮层并支持在画布上点选目标**（验收现场两条修正：任务锚点改挂画布那一格、展开后开关让位），见 §3.10 / §5.3 / §7.8 / §7.9 与 [`【功能说明】AGC聊天素材引用`](../【功能说明】AGC聊天素材引用-2026-09-08.md)；2026-09-14 图片类生成后台化：入口 IPC 为 `start_local_project_asset_generation` + 项目内任务账本 + 本地排队 + 非模态「生成任务」面板；2026-09-13 新增的功能画布底部工具栏入口矩阵 §3.10 / §7.9，以及右侧 Supervisor 对话气泡、可访问对比度与过程卡布局收口，资源卡预览、分区布局、非破坏性资源编辑、资源替换与 Godot 双根合同保持不变；2026-09-21 Godot 工作区发现放宽：一层多命中按目录名排序取第一个，`project.godot` 允许是链接/reparse point/硬链接，见 §3.8）
## 1. 产品定位
@@ -136,7 +136,7 @@
### 3.8 现有 Godot 项目
- 首页和项目组统一使用“打开项目”，不提供独立 Godot 按钮。用户选择的目录作为工作区根；系统先检查根目录，再检查一层直接子目录中的普通文件 `project.godot`。根目录命中优先；一层发现多个 Godot 工程时必须提示歧义，不猜测目标。
- 首页和项目组统一使用“打开项目”，不提供独立 Godot 按钮。用户选择的目录作为工作区根；系统先检查根目录，再检查一层直接子目录中的 `project.godot`。根目录命中优先；一层命中多个 Godot 工程时按目录名排序取第一个，不再因为存在第二个工程而失败或要求用户改选。`project.godot` 本身是符号链接、Windows reparse point 或硬链接时按链接目标判定，解析后是文件即命中；目录与悬空链接仍不算命中。
- 工作区根始终绑定文件读取、修改、命令 cwd、对话、Runtime 和最近项目记录；`.agent/`、Agent DB 与日志也只写在这里。`project.godot` 所在目录额外以 `godotProjectRoot` 记录为相对工作区的 `.` 或单层目录名，不把项目作用域切到 Godot 子目录。
- 首次打开只在工作区根创建 `.agent/` 元数据；已有 `.agent/manifest.json` 时读取并按当前唯一文件布局校准 `godotProjectRoot`。Godot 源码、场景、资源和项目配置继续使用原目录结构，不复制工程，也不建立 `game/`、`assets/`、`memory/`、`exports/` 平行目录。
- Godot 项目使用 `standard` Run Profile，避免套用 Web 原型的 `game/index.html`、本地 HTTP 预览和自主 Web 游戏完成门；本期不提供 Godot 内嵌运行预览。
docs/project-memory/plans/【实施计划】AGC模板库客户端接入-2026-09-17.md
-59
View File
@@ -1,59 +0,0 @@
# AGC 模板库客户端接入实施计划
Version: 1.0
Status: active
Date: 2026-09-17
Milestone Spec: `docs/project-memory/plans/【里程碑】AGC模板库客户端接入-2026-09-17.md`
## 步骤
1. **OSS 库布局与契约**
- 在 `agc-dev` 落地 `templates/` 前缀：`index.json`、`v1/<id>/{template.json,template.zip,cover.*}`。
- 清单补齐 `tags`、`coverKey/coverWidth/coverHeight/coverSha256`，正文改为 zip（zip 根 == 项目根）。
- 模板源落在 `apps/ai-game-creator-shell/template-library/v1/<id>/{meta.json,project/**,cover.*}`；zip 由 `scripts/agc-template-library-publish.mjs` 现场打包（不落仓库）。
- 交付：发布脚本（校验 + 打包 + 上传 + 回读校验，支持 `--dry-run` / `--prune`）、`templates/README.md`，以及 5 个模板（3 个空白 + 2 个起步工程）。
- 验收：匿名 `GET templates/index.json` 可读，每个 `zipKey` 回读 SHA-256 与清单一致。
2. **Rust 模板库模块**
- 新增 `src-tauri/src/template_library.rs`：清单解析与校验、受信任 base、缓存/安装目录、zip 安全解压、安装记录、由模板建项目。
- 注册命令 `fetch_game_template_library`、`download_game_template`、`create_automatic_local_game_project_from_template`。
- 交付：模块内 8 项单测（schema/重复模板、键前缀、base 校验、解压逃逸、摘要与大小、安装记录、建项目与失败清理）。
- 验收：`cargo test --bin genarrative-ai-game-creator-shell template_library` 全绿。
3. **前端状态链路**
- `src/features/template-library/templateLibraryModel.ts`（类型与搜索/筛选纯函数）与 `useTemplateLibrary.ts`（拉取、下载、建项目、就地更新已下载状态）。
- `useHomeProjectCreation` 增加 `enterCreatedTemplateProject`，复用既有进项目通道。
- 交付：9 项模型单测。
- 验收：`npx vitest run src/features/template-library` 全绿。
4. **界面接入**
- 新增 `src/view/template-library/index.tsx` 全屏页；`LauncherView` 增加 `template-library`；左侧导航加模板库入口。
- 首页「灵感推荐」替换为 `TemplateRecommendations`；删除 `InspirationGallery.tsx` 与 `assets/inspiration/`。
- `tauri.conf.json` 的 `img-src` 放行受信任 OSS 主机以加载封面。
- 验收：模板库页可搜索、筛选、下载、显示已下载并成功建项目；首页推荐位可跳转。
5. **文档与共享记忆**
- 主规范 `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`，并在 `docs/README.md` 建索引。
- 本里程碑与实施计划；`decision-log.md` 记录库路径、清单 schema、缓存目录与 CSP 约定。
- 验收：`node scripts/check-doc-index.mjs` 通过。
## 验证命令
```bash
cargo check --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml
cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell template_library
cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell template_library -- --ignored
cd apps/ai-game-creator-shell && npx tsc -p tsconfig.json --noEmit
npx vitest run apps/ai-game-creator-shell/tests/templateLibraryModel.test.ts apps/ai-game-creator-shell/tests/templateLibraryView.test.tsx
node scripts/agc-template-library-publish.mjs --source <dir> --dry-run
npm run check:encoding
node scripts/check-doc-index.mjs
git diff --check
```
## 风险与回退
- **封面走 WebView 直连**：仅放行受信任 OSS 主机；若日后改用后端签名，清单的 `coverKey` 不变。
- **模板包体积**：下载上限 512 MiB、解压文件数 4096、单文件 256 MiB；超限直接拒绝，不落盘。
- **清单漂移**：客户端只信「受信任主机 + 对象键」，清单中的地址字段不参与请求。
- **回退**：清空 `templates/` 前缀即回到空模板库；客户端保留错误与空态展示，不阻断其它功能。
docs/project-memory/plans/【实施计划】AGC渠道安装身份隔离-2026-09-21.md
+49
View File
@@ -0,0 +1,49 @@
# 【实施计划】AGC 渠道安装身份隔离
| 字段 | 值 |
| --- | --- |
| Milestone | `docs/project-memory/plans/【里程碑】AGC渠道安装身份隔离-2026-09-21.md` |
| Status | ready |
| Owner | 当前 Agent |
## 修改边界
- 允许修改：
- `apps/ai-game-creator-shell/scripts/channel-identity.mjs`（新增，渠道身份单点定义）
- `apps/ai-game-creator-shell/scripts/build-release.mjs`、`build-macos-ci.mjs`、`check-config.mjs`、`agent-swarm-test-chat.mjs`
- `apps/ai-game-creator-shell/src-tauri/src/main.rs`、`src-tauri/src/windows.rs`、`src-tauri/src/config.rs`
- 对应测试：`build-release.test.mjs`、`prepare-macos-codex.test.mjs`
- 文档：AGC 更新主规范、共享记忆与本计划对
- 明确不修改：OSS 分区布局、官网下载接口与页面、Jenkins Job 参数、渠道版本发行逻辑、Apple 签名/公证、移动壳。
## 实现顺序
1. 抽出 `channel-identity.mjs`：渠道校验、渠道显示名、`resolveChannelInstallIdentity()`；`build-release.mjs` 复用并再导出渠道校验。
2. 渠道 `--config` 同时注入 `productName` 与 `identifier`；macOS 发布入口按发布渠道解析产品名（`.app`、updater 归档、DMG 卷名与文件名）。
3. Rust：主窗口/工作区/启动器窗口标题取构建期产品名；AGC 自有 AppData 目录的 ACL managed 识别覆盖 `<基线>` 与 `<基线>.<渠道>`。
4. 门禁与测试：`check-config.mjs` 断言基线等于默认渠道身份、非默认渠道身份隔离；`build-release.test.mjs` 增补身份与首装包用例；`prepare-macos-codex.test.mjs` 改断言为消费渠道身份。
5. 文档：更新 AGC 更新主规范与共享记忆，登记决策与踩坑。
## 验证命令
1. `node --check apps/ai-game-creator-shell/scripts/channel-identity.mjs apps/ai-game-creator-shell/scripts/build-release.mjs apps/ai-game-creator-shell/scripts/build-macos-ci.mjs apps/ai-game-creator-shell/scripts/check-config.mjs`
2. `node --test apps/ai-game-creator-shell/scripts/build-release.test.mjs apps/ai-game-creator-shell/scripts/release-oss.test.mjs apps/ai-game-creator-shell/scripts/prepare-macos-codex.test.mjs apps/ai-game-creator-shell/scripts/cargo-features.test.mjs`
3. `node apps/ai-game-creator-shell/scripts/check-config.mjs`
4. `cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell -- config::tests:: --test-threads=1`
5. `npm run check:encoding`、`npm run check:doc-index`、`git diff --check`
## 验证结果
- `node --test build-release.test.mjs release-oss.test.mjs prepare-macos-codex.test.mjs cargo-features.test.mjs`：64/64 通过（新增渠道身份、身份注入与渠道 DMG 首装选择三条用例）。
- `node apps/ai-game-creator-shell/scripts/check-config.mjs`、`npm --prefix apps/ai-game-creator-shell run typecheck`：通过。
- `cargo test --locked --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml --bin genarrative-ai-game-creator-shell -- config::private_path_elevation_policy_tests`：12/12 通过。
- `AGC_UPDATE_CHANNEL=release npm --prefix apps/ai-game-creator-shell run build -- --no-bundle --debug`：Tauri 接受派生的 `productName` / `identifier` 并完成构建；产物字符串实测 `陶泥儿 Release` × 1、`agc/release-win/latest.json` × 1、`world.genarrative.ai-game-creator.release` × 1、`agc/dev-win/latest.json` × 0。
- `cargo fmt --check`（AGC 壳）、`npm run check:encoding`、`npm run check:doc-index`、`git diff --check`：通过。
- 未执行：真实渠道打包（需要签名私钥与发号/上传授权）、双渠道真机安装与并存、macOS 节点实跑。
## 风险与回滚点
- 风险：默认渠道身份若被改动，既有安装目录、卸载项与升级链会断。回滚点：基线 `tauri.conf.json` 与默认渠道映射不变，门禁用例钉住。
- 风险：非默认渠道首次以新身份安装，老 `dev` 用户不会自动迁移本地数据。回滚点：渠道身份只影响非默认渠道构建，撤销该渠道的构建产物即可，仓库侧无数据迁移。
- 风险：窗口标题改为构建期产品名后，标题不再等于配置里的字面量。回滚点：去掉 `main.rs` 的标题覆盖调用，行为回到配置标题。
- 风险：ACL managed 识别放宽到前缀族。回滚点：`is_game_creator_packaged_app_data_leaf` 收紧回单一直线值，但非默认渠道的提权修复会重新失败关闭。
docs/project-memory/plans/【实施计划】AGC画布交互稳定性修复-2026-09-16.md
+9 -9
View File
@@ -26,15 +26,15 @@
## 问题状态
| 编号 | 问题 | 状态与证据 |
| --- | --- | --- |
| B01 | 刷新后首次进入画布元素抖动 | 已优化；用户在本轮反馈未再复现，按用户要求更新状态。不宣称所有布局/动画原因均已排除。 |
| B02 | 初次进入双指平移无效，整理后恢复 | 已优化；用户在本轮反馈未再复现，按用户要求更新状态。隔离组件连续平移通过。 |
| B03 | 快速平移触发更新深度错误 | 已修复已确认的窗口 Context 反馈循环，回归验证收敛；真实操作继续观察。 |
| B04 | 资源选中后运行不可用提示消失 | 已修复，提示与选择解耦，自动化验证通过。 |
| B05 | 对话记录偶发丢失 | 已定位历史分页卡点，尚未修改。只读复验用户提供的历史：558 条合法原始记录中有 44 条聊天消息；首屏原始 20 条只投影出一条助手消息，下一页原始 20 条没有聊天消息，按消息计算的游标不推进。已存用户提问和最终回答因此无法继续翻出；不能凭该文件排除其它未落盘记录。 |
| B06 | JSON 文档未正确识别展示 | 已按用户确认完成本地修复：合法 UI State 由原生完整校验，卡片显示 UI 设计并进入现有编辑器；普通 JSON 显示 JSON 并可代码预览。自动化验证通过，待重建原生客户端验收；详见 JSON 语义识别实施计划。 |
| C01 | 右键平移，保留左键框选 | 已实现，卡片左键拖动、框选、指针取消/失焦/捕获丢失及控件边界测试通过。 |
| 编号 | 问题 | 状态与证据 |
| ---- | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| B01 | 刷新后首次进入画布元素抖动 | 已优化；用户在本轮反馈未再复现，按用户要求更新状态。不宣称所有布局/动画原因均已排除。 |
| B02 | 初次进入双指平移无效，整理后恢复 | 已优化；用户在本轮反馈未再复现，按用户要求更新状态。隔离组件连续平移通过。 |
| B03 | 快速平移触发更新深度错误 | 已修复已确认的窗口 Context 反馈循环，回归验证收敛；真实操作继续观察。 |
| B04 | 资源选中后运行不可用提示消失 | 已修复，提示与选择解耦，自动化验证通过。 |
| B05 | 对话记录偶发丢失 | 已定位历史分页卡点，尚未修改。只读复验用户提供的历史：558 条合法原始记录中有 44 条聊天消息；首屏原始 20 条只投影出一条助手消息，下一页原始 20 条没有聊天消息，按消息计算的游标不推进。已存用户提问和最终回答因此无法继续翻出；不能凭该文件排除其它未落盘记录。 |
| B06 | JSON 文档未正确识别展示 | 已按用户确认完成本地修复：合法 UI State 由原生完整校验，卡片显示 UI 设计并进入现有编辑器；普通 JSON 显示 JSON 并可代码预览。自动化验证通过，待重建原生客户端验收；详见 JSON 语义识别实施计划。 |
| C01 | 右键平移，保留左键框选 | 已实现，卡片左键拖动、框选、指针取消/失焦/捕获丢失及控件边界测试通过。 |
## 已取得证据与剩余门禁
docs/project-memory/plans/【实施计划】DirectProject Skill提及输入提示-2026-09-15.md
+27
View File
@@ -0,0 +1,27 @@
# 【实施计划】DirectProject Skill 提及输入提示
| 字段 | 值 |
| --------- | ----------------------------------------------------------------------------------- |
| Milestone | `docs/project-memory/plans/【里程碑】DirectProject Skill提及输入提示-2026-09-15.md` |
| Status | in-progress |
| Owner | Codex |
## 代码边界
- 前端：`features/project-workspace/ResourceReferenceInput.tsx`、`ResourceReferenceNode.tsx`、`resourceReferences.ts`、生成绑定及聊天入口透传。
- Rust：`agent/direct_codex_user_item/model.rs`、`validation.rs`、`wire.rs`、`codex_app_server/mod.rs` 与对应测试。
- 文档：父规范与本里程碑/实施计划。
## 小切片顺序
1. 先扩展前端 Skill catalog/节点/草稿 content，保持素材行为不变并补前端测试。
2. 扩展 canonical Rust part 与 ts-rs 绑定，补序列化和失败校验测试。
3. 接通 Codex wire `type: skill` 转换和受控路径解析，补历史/重放测试。
4. 完成入口透传、定向验证和文档证据；每个切片单独中文提交。
## 验证与回滚
- `npm --prefix apps/ai-game-creator-shell run typecheck`
- 相关 Vitest 与 `cargo test --manifest-path apps/ai-game-creator-shell/src-tauri/Cargo.toml direct_codex`
- `npm run check:encoding`、`npm run check:doc-index`、`git diff --check`
- 每个切片只改计划列出的文件；若 Codex wire 协议或 Skill catalog 来源不确定，停在该切片并先更新规范。
docs/project-memory/plans/【实施计划】DirectProject Thread Manager事件订阅-2026-09-15.md
+4 -4
View File
@@ -1,10 +1,10 @@
# 【实施计划】DirectProject Thread Manager 事件订阅
| 字段 | 值 |
| --- | --- |
| 字段 | 值 |
| --------- | ---------------------------------------------------------------------------------------- |
| Milestone | `docs/project-memory/plans/【里程碑】DirectProject Thread Manager事件订阅-2026-09-15.md` |
| Status | ready |
| Owner | Codex |
| Status | ready |
| Owner | Codex |
## 修改边界
docs/project-memory/plans/【实施计划】DirectProject canonical content严格边界-2026-09-16.md
+42
View File
@@ -0,0 +1,42 @@
# 【实施计划】DirectProject canonical content 严格边界
| 字段 | 值 |
| --------- | ------------------------------------------------------------------------------------------- |
| Milestone | `docs/project-memory/plans/【里程碑】DirectProject canonical content严格边界-2026-09-16.md` |
| Status | implemented |
| Owner | Codex |
## 实施顺序
1. 先把主转换函数改为原样传递 `draft.content`，并在 content-only 测试中覆盖空白 part 保留。
2. 将最终 content 有效性判断抽为纯函数，接入普通提交、队列入队和其它 Direct Codex 入口。
3. 删除 Direct Codex 的 `userItem` fallback；首页首轮和队列出队直接构造 canonical user item。
4. 收敛策略确认重试为复用同一 canonical user item；旧 Supervisor/Planning caller 加 TODO，不改变其非 Direct Codex 行为。
5. 迁移现有测试 fixture，删除旧字段构造，不增加“字段不存在”测试。
## 落地结果
- `chatComposerDraftToDirectCodexUserItem` 原样传递 `draft.content`；新增 `directCodexUserItemFromContent` 供 caller 直接构造 canonical item。
- `ChatComposerDraft` 只保留 `content`；`ResourceReferenceInput` 的对外草稿、`chatPromptDraftKey`、`QueuedChatTurn` 全部改为 content-only。
- 首页首轮、普通聊天提交、运行中队列出队、策略确认重试都携带同一个 canonical user item；`executeChatAgentReply` 的 `userItem` 兜底分支已删除。
- 旧 Planner / legacy Supervisor caller 显式构造纯文本 item 并留下迁移 TODO。
## 修改边界
- 允许修改：AGC shell 前端 `resourceReferences`、`App`、聊天队列、Direct Codex 相关测试和当前里程碑文档。
- 不修改：Rust user item schema、附件 DTO、SpacetimeDB、HTTP API、用户已有 `.env` / `package-lock.json` 修改。
- 不引入：`text` / `references` 到 canonical Direct Codex item 的任何兼容 fallback。
## 验证命令
- `npm run test -- apps/ai-game-creator-shell/tests/resourceReferences.test.ts apps/ai-game-creator-shell/tests/resourceReferenceInput.test.tsx apps/ai-game-creator-shell/tests/chatPromptPolish.test.tsx apps/ai-game-creator-shell/tests/appSurface/project-conversation.suite.ts`
- `npm run ai-game-creator-shell:typecheck`
- `npm run check:encoding`
- `npm run check:doc-index`
- `git diff --check`
## 风险与回滚点
- 空白 `input_text` 不再前端删除，需确保最终有效性判断只拒绝全空 content，不改变其它 part。
- Direct caller 漏传 user item 时应在类型检查或明确错误分支暴露，不能静默重建。
- 共享工作树含用户未提交修改；提交时只 stage 本计划和本次代码 hunk。
docs/project-memory/plans/【实施计划】DirectProject composer canonical content闭环-2026-09-21.md
+64
View File
@@ -0,0 +1,64 @@
# 【实施计划】DirectProject composer canonical content 闭环
| 字段 | 值 |
| --------- | --- |
| Milestone | `docs/project-memory/plans/【里程碑】DirectProject composer canonical content闭环-2026-09-21.md` |
| Status | implemented |
| Owner | Codex |
## 交付结果
删除 Direct composer 的 `text + references` 回写事实源，改为完整 `content[]` 的单向读写；同时修复附件在 editor root 重建、润色回填和提交合并中的丢失窗口。Planning V2 / 快速编辑只保留明确的非 Direct adapter，不进入 Direct canonical 发送路径。
## 实施顺序
1. **锁定当前失败面**：补一个最小回归测试，先证明 `applyDraftToRoot` 对含 `agc_attachment_reference` 的 root 重建会丢附件，并记录 Direct 当前的三份并行状态与附件 sidecar 合并点。
2. **收窄编辑器接口**：把 `ChatComposerDraft` 改成 content-only；将 `ResourceReferenceInput` 的受控恢复改为 `initialContent` / `content` 语义，删除 Direct 使用的 `value` + `references` 同步 effect。保留 `ChatReference` 仅用于 picker 节点创建和只读投影。
3. **替换所有 root 写入**：删除 `buildDraftSegments` / `applyDraftToRoot` 的 Direct 调用；提供一个完整的 `applyContentToRoot`（或同等深模块接口），保留文本换写、引用和附件的顺序与字段。AI 润色改为“读取 content → 对回包文本按 token 扫描 → 原位换回真 part；被改写的 part 末尾补位”，引用与附件同一套口径。
4. **收口 Direct controller**：以 `content[]` 作为草稿事实源；上传完成的附件在一个明确的 `append`/`merge` seam 合并，不再长期维护 `chatInput`、`chatReferences`、`chatContent` 三份状态。prompt 只在调用边界派生，队列和策略重试保留原 user item。
5. **隔离非 Direct caller**：Planning V2 和资源快速编辑按各自需求选择 content-only 或独立文本 adapter；不得为了兼容它们把旧字段放回共享 Direct 接口。若快速编辑只需要文本，使用不承诺引用/附件语义的窄接口。
6. **补齐验收证据并清理**：删除无调用方的旧 helper、字段和注释；更新测试 fixture、专题文档和本计划状态。完成后把稳定结论合并回功能说明/共享记忆，并删除已完成的临时计划。
## 重点修改边界
- `apps/ai-game-creator-shell/src/features/project-workspace/ResourceReferenceInput.tsx`
- `apps/ai-game-creator-shell/src/features/project-workspace/resourceReferences.ts`
- `apps/ai-game-creator-shell/src/features/project-workspace/usePromptPolish.ts` / `chatPromptPolish.ts`（仅在需要支持 content 变换时）
- `apps/ai-game-creator-shell/src/view/project-development/chat/controller/useDirectProjectChatController.ts`
- `apps/ai-game-creator-shell/src/view/project-development/chat/components/DirectProjectComposer/`
- `apps/ai-game-creator-shell/src/view/project-development/planning/PlanningChatView.tsx` 与 `App.tsx` 中 Planning adapter
- `apps/ai-game-creator-shell/src/view/project-development/index.tsx` 的快速编辑输入 adapter
- 对应 `resourceReferences`、`resourceReferenceInput`、`chatPromptPolish`、Direct composer/appSurface 测试
## 关键不变量
- `content[]` 是唯一可发送事实；任何 `prompt`、label、chip 文案都是派生值。
- `agc_attachment_reference` 不属于 `ChatReference`，不能借 `references` 传递。
- 润色回包只按 token 反解析引用与附件（`draftScanToken` 与出站 `directCodexContentToPromptText` 同口径）；token 被删掉时不猜位置，只把该 part 补在末尾，保证不丢。
- Direct 初始首轮、普通提交、队列、权限确认重试都使用同一个 `DirectCodexUserItem` 语义。
## 验证命令
```bash
npm run test -- apps/ai-game-creator-shell/tests/resourceReferences.test.ts apps/ai-game-creator-shell/tests/resourceReferenceInput.test.tsx apps/ai-game-creator-shell/tests/chatPromptPolish.test.tsx apps/ai-game-creator-shell/tests/appSurface/chat-composer.suite.ts apps/ai-game-creator-shell/tests/appSurface/project-conversation.suite.ts
npm run ai-game-creator-shell:typecheck
npm run check:encoding
npm run check:doc-index
git diff --check
```
## 风险与回滚点
- `ResourceReferenceInput` 当前同时服务 Direct、Planning、快速编辑；先建立 adapter seam，再删除旧 props，避免一次性把策划链路打坏。
- 附件目前在 Direct controller 里作为待发 sidecar，若直接移入编辑器必须同步处理上传失败、移除、清空和项目切换；任何阶段都不能把附件只留在展示 chip 而未进入 user item。
- 润色服务只返回文本，不能让其响应覆盖原 content；失败时保留原 content。回滚使用 Git revert，不增加运行时开关或兼容分支。
- 工作树已有用户未提交修改，实施时只 stage 本里程碑涉及的 hunk。
## 落地结果
- 编辑器接口收窄为 content-only：`ResourceReferenceInput` 只接 `initialContent` / `onChange`，`ChatComposerDraft` 只剩 `content`；`applyDraftToRoot` 与受控 `value` / `references` 同步 effect 均删除。
- 所有 root 写入统一走 `applyContentToRoot`；润色走 `applyPolishedTextToRoot`，对引用与附件做同一套 token 扫描并在原位置换回真 part，被改写的 part 末尾补位。
- Direct controller 去掉 `chatInput` / `chatReferences` / `chatContent`，附件在提交边界合成进同一份 canonical content；Planning 与其它 legacy 消费方改用 `directCodexContentToLegacyContentDto` 单向取文本。
- 删除无调用方的 `EMPTY_CHAT_COMPOSER_DRAFT`。
- 回归证据：`resourceReferenceInput`（含附件 round-trip、润色原位恢复、润色末尾补位）、`resourceReferences`、`chatPromptPolish`、`usePromptPolish`、`resourceCanvasAssetGenerationReferences`、全量 `appSurface`、AGC typecheck、`check:encoding`、`git diff --check`。
- 遗留 TODO：润色服务把 token 一起删掉时无法反推原位置；需要精确恢复时由产品补带位置信息的润色协议。
docs/project-memory/plans/【实施计划】DirectProject用户ResponseItem输入-2026-09-15.md
+6 -5
View File
@@ -1,15 +1,16 @@
# 【实施计划】DirectProject 用户 Response item 输入
| 字段 | 值 |
| --- | --- |
| 字段 | 值 |
| --------- | ------------------------------------------------------------------------------------- |
| Milestone | `docs/project-memory/plans/【里程碑】DirectProject用户ResponseItem输入-2026-09-15.md` |
| Status | in-progress |
| Owner | Codex |
| Status | in-progress |
| Owner | Codex |
## 修改边界
- 允许修改：AGC 壳 Rust agent 输入合同、DirectProject 历史适配、前端聊天引用模型、ts-rs 生成配置、当前聊天素材文档。
- 明确不修改：assistant 返回协议、工具 activity、附件/图片协议、SpacetimeDB、HTTP API。
- 明确不修改：assistant 返回协议、工具 activity、附件/图片上传 DTO、SpacetimeDB、HTTP API；上传 DTO 仅在入口转换为 canonical `content[]`，不再以 sidecar 文本追加。
- 本切片明确：不根据 MIME 类型判断图片，不生成 `agc_image_reference`；所有上传文件统一映射为 `agc_attachment_reference`。
## 实现顺序
docs/project-memory/plans/【实施计划】DirectProject聊天模块抽离-2026-09-18.md
+95
View File
@@ -0,0 +1,95 @@
# 【实施计划】DirectProject 聊天模块抽离
| 字段 | 值 |
| --------- | ----------------------------------------------------------------------------- |
| Milestone | `docs/project-memory/plans/【里程碑】DirectProject聊天模块抽离-2026-09-18.md` |
| Status | implemented |
| Owner | Codex |
## 修改边界
### 允许修改
- `apps/ai-game-creator-shell/src/App.tsx`：删除 DirectProject 专属状态、ref、effect、订阅/历史/发送/队列/附件/中止处理和 Direct 专属 JSX 接线；保留项目开发工作台壳与 DirectProject / 立项策划两条入口的选择。
- `apps/ai-game-creator-shell/src/view/project-development/chat/DirectProjectChatView.tsx`、`useDirectProjectChatController.ts` 与 `generated/`：新增 DirectProject 表现容器、controller 及其 ts-rs 契约目录；共享 reducer/分页/队列模块只引用这份 Direct 契约，不复制类型。
- `view/project-development/chat/` 与 `view/project-development/planning/`：普通项目的对话归 `DirectProjectChatView`，Design Agent 与 Planning V2 归 `PlanningChatView`；行为中立的公共表现组件按需复用或抽出。
- `DirectProjectSettingsDialog` 与 `ProjectDevelopmentView`：移除聊天侧钱包注入和聊天设置中的钱包行，在工作台布局头部/工具栏独立渲染钱包入口，保留账户入口功能。
- 现有 DirectProject 测试文件：按新模块责任迁移 import、测试入口和 harness，不新增场景或断言集合。
- 当前 ADR、里程碑和实施计划文档，以及必要的 `CONTEXT.md` 术语。
### 明确不修改
- Rust、Tauri 命令、共享 DTO、Thread Manager、Codex app-server 和 `.agent/conversations/project.jsonl` / 运行态事件合同。
- DirectProject 的路由判定语义、模型配置语义、聊天投影规则、历史锚点与分页协议。
- DirectProject、Design Agent、Planning V2 的正式行为与页面入口。
- 任何运行时 feature flag、兼容别名、双跑路径或旧行为墓碑代码。
## 实现顺序
1. 以当前测试为基线，标记 DirectProject 断言归属：纯 reducer/投影/分页/附件测试归内部模块，Composer 的队列/恢复/中止断言归 Direct 容器 harness，项目开发页面只保留入口接线断言；不增加新测试场景。
2. 建立 `direct-project-chat/` 私有模块边界，复用现有 `directThreadChat`、`directHistoryPaging`、`directHistoryAnchorGate`、`directTurnPresentation`、`chatComposerQueue` 与附件映射，不复制第二套事实源或 reducer。
3. 将 DirectProject 生命周期整体搬入 `DirectProjectChat`：项目切换清理、订阅 bootstrap/notify/consume、首屏锚点、历史连拉、用户回合预写、Direct invoke、鉴权重试、FIFO 出队、附件上传、中止 released 分支和 manifest 刷新均由该容器管理。
4. 将 Direct 专属 JSX 从工作台聊天宿主移入 Direct 表现模块：Direct 回合分区、运行中过程卡、Direct Composer、队列、附件、模型/推理选择、语音、中止、Direct 设置；共享组件只保留无行为真相的视觉表现。
5. 项目开发工作台固定挂载 `DirectProjectChat`；立项策划（Design Agent、Planning V2）进入 `PlanningChatView`；删除 `directCodex` 作为共享组件行为开关及所有只服务它的 props，不保留 Direct fallback 或运行时 feature flag。
6. 将钱包从聊天树移到 `ProjectDevelopmentView` 的工作台头部/工具栏：删除 `cloneElement` 对聊天元素的注入，删除 `DirectProjectSettingsDialog` 的钱包行和 Direct 上下文字段；钱包入口仍由布局直接渲染。
7. 把现有测试按所有权迁移并运行定向验证；若发现行为差异，只修复抽离造成的回归，不扩展产品范围。完成后删除旧 Direct 分支与无 caller 的兼容代码。
## 测试迁移映射
| 现有测试 | 新归属 |
| --------------------------------------------------------------------------------------- | ------------------------------------------- |
| `directThreadChat.test.ts` | Direct 事件/历史状态模块 |
| `directHistoryPaging.test.ts` | Direct 历史分页模块 |
| `directHistoryAnchorGate.test.ts` | Direct 订阅锚点模块 |
| `directTurnPresentation.test.ts` | Direct 聊天投影表现模块 |
| `directCodexTurnAttachments.test.ts` | Direct 附件模块 |
| `chat-composer.suite.ts` 的 FIFO、恢复出队、终止与竞态用例 | Direct 容器/发送队列 harness |
| `project-development.suite.ts` 的 Direct 入口、历史、工具卡片、运行态隔离和连续回合用例 | Direct 容器接线；仅迁移测试入口，不新增场景 |
## 验证命令
1. `npx vitest run apps/ai-game-creator-shell/tests/directThreadChat.test.ts apps/ai-game-creator-shell/tests/directHistoryPaging.test.ts apps/ai-game-creator-shell/tests/directHistoryAnchorGate.test.ts apps/ai-game-creator-shell/tests/directTurnPresentation.test.ts apps/ai-game-creator-shell/tests/directCodexTurnAttachments.test.ts`
2. `npx vitest run apps/ai-game-creator-shell/tests/appSurface/chat-composer.suite.ts apps/ai-game-creator-shell/tests/appSurface/project-development.suite.ts`
3. `npx tsc -p apps/ai-game-creator-shell/tsconfig.json --noEmit`
4. `npm run check:doc-index`
5. `npm run check:encoding`
6. `git diff --check`
## 风险与回滚点
- **状态遗漏**：任何 Direct 专属 state/ref/effect 留在 `App.tsx` 都会形成双重所有权；以 `rg` 扫描 Direct 专属符号和 `directCodex` props 作为删除检查。
- **事实源漂移**：不得在新容器里重新维护 messages、turn-stream 或 tool-calls 副本；继续只使用项目对话历史、运行态事件和聊天投影。
- **竞态回归**：重点检查 subscribe 回执前 notify 欠账、首屏锚点闸门、`turn.completed` 与 invoke finally 的 FIFO 出队窗口、提交早于 `turn.started` 的中止以及项目切换时附件/队列清理。
- **布局回归**：钱包必须在工作台布局头部/工具栏出现，且聊天设置不再包含钱包行；账户入口功能不能因聊天抽离丢失。
- **回滚**：本次采用一次性替换；失败时整体 Git revert，不保留旧/新双路径或运行时 fallback。
## 实施记录（2026-09-19）
### 模块落位
`apps/ai-game-creator-shell/src/view/project-development/chat/` 最终结构：
| 目录 | 内容 |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `DirectProjectChatView.tsx` | 唯一公开入口：项目路径、入口首轮需求、两条权限门，以及对壳的 `announce` 句柄 |
| `components/` | 表现层，一个组件一个目录、逻辑与组件同目录：`DirectProjectChatHeader/`、`DirectProjectComposer/`（含 `ComposerControls.tsx`、`chatComposerQueue.ts`、`chatComposerVoice.ts`）、`DirectProjectConversation/`（含 `DirectProjectTurn.tsx`）、`DirectProjectSettingsDialog/`、`ToolCallGroup/`（含 `toolCallGroupPresentation.ts`） |
| `controller/` | `useDirectProjectChatController`（发送/队列/附件/中止/历史分页）、`useDirectProjectManifest`（清单与 `projectId` 订阅）、`useDirectThreadChatSubscription`（`subscribe → consume → notify` 单飞循环 + 聊天 reducer 状态） |
| `conversation/` | `directThreadChat.ts`（reducer）、`directThreadItemProjection.ts`、`directTurnPresentation.ts`、`directCodexConversation.ts`、`directCodexSession.ts`、`directCodexTurnAttachments.ts` |
| `history/` | `directHistoryPaging.ts`、`directHistoryAnchorGate.ts` |
| `generated/` | Rust ts-rs 导出的 Direct 契约 |
### 关键取舍
- 线程订阅与聊天 reducer 状态从控制器里提成独立 hook `useDirectThreadChatSubscription`：运行态事实源只有它一份，控制器只读投影结果，历史分页仍并入同一个 reducer。
- 工作台级动作（如 `game.run_local` 的预览结果）不再写 `App.tsx` 的 `messages`：壳通过 `DirectProjectChatHandle.announce` 把这句话交给聊天的本地消息流，壳不持有 Direct 聊天消息。
### 验证结果
- `npx vitest run` 五个 Direct 纯模块测试：40 通过。
- `npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts -t "direct"`：15 通过 / 4 失败，且 4 条在本次改动前（`HEAD` 的 `/tmp` worktree 基线）同样失败（用例期望 `chat_with_game_creator_direct_codex` 被调用，但 harness 未桩 `read_game_creator_app_config`，模型可用性校验把提交挡在 invoke 之前；另两条是既有交互断言）。基线同口径为 14 通过 / 5 失败，本次净增 1 条通过。
- `npx vitest run apps/ai-game-creator-shell/tests/appSurface.test.ts` 全量：153 失败 / 307 通过 / 17 跳过；`HEAD` 基线同口径 155 失败 / 305 通过。
- `npx tsc -p apps/ai-game-creator-shell/tsconfig.json --noEmit`、`npx eslint --ext .ts,.tsx`、`npx prettier --check` 通过。
### 本计划外的后续项
- Supervisor 前端链路已随本计划之后的变更整体退役（Supervisor 独立调试窗口、纯聊天容器、工作台壳的 Supervisor 运行态与专业 Agent 面板、`App.tsx` 里只服务它们的 state/ref/effect/handler 全部删除），项目对话只保留 DirectProject 与立项策划两条产品路径；见 [decision-log](../shared-memory/decision-log.md) 2026-09-19 条。
docs/project-memory/plans/【实施计划】DirectProject聊天真相源收敛-2026-09-16.md
+4 -4
View File
@@ -1,10 +1,10 @@
# 【实施计划】DirectProject 聊天真相源收敛
| 字段 | 值 |
| --- | --- |
| 字段 | 值 |
| --------- | ------------------------------------------------------------------------------- |
| Milestone | `docs/project-memory/plans/【里程碑】DirectProject聊天真相源收敛-2026-09-16.md` |
| Status | implemented |
| Owner | Codex |
| Status | implemented |
| Owner | Codex |
## 修改边界
docs/project-memory/plans/【实施计划】后台模板上传-2026-09-21.md
+40
View File
@@ -0,0 +1,40 @@
# 后台模板上传实施计划
| 字段 | 值 |
| --- | --- |
| Version | 1.0 |
| Status | in-progress |
| Date | 2026-09-21 |
| Milestone Spec | `docs/project-memory/plans/【里程碑】后台模板上传-2026-09-21.md` |
## 修改边界与顺序
1. **领域规则（`module-assets/template_library.rs`）**：新增「导入准备」函数——按 ID 合并清单条目（新增默认上架、已存在就地更新并保留 `enabled` 与未知字段），校验 ID / 版本 / entry / runtime / 显示字段上限，产出待提交的清单与 `template.json` 字节；不接触存储。
2. **存储（复用 `platform-oss/template_library.rs`）**：只使用既有 `begin_publish` / `read_index` / `put_immutable` / `commit_index` / `finish`；如缺少「读单个对象作元数据基线」的能力，再补最小只读方法，不改锁与提交语义。
3. **契约（`shared-contracts/admin.rs` + `apps/admin-web/src/api/adminApiTypes.ts`）**：新增导入请求（manifest）与导入结果 DTO；错误体沿用现有 `AppError` + 逐项原因结构。
4. **接口（`api-server/admin_templates.rs` + `modules/admin.rs`）**：新增 multipart handler，按「解析 manifest → 校验每个 ZIP / 封面 → 取锁 → CAS → 写内容寻址对象并回读 → 提交清单 → 释放锁」顺序实现；路由套 `require_admin_auth` 与 256 MiB body 上限，并同步路由契约测试与页签权限矩阵测试。
5. **后台页面（`AdminAgcTemplatesPage.tsx` + `adminApiClient.ts`）**：新增「上传模板」入口与弹窗（多选 ZIP、逐行元数据、批量提交、逐行错误、写入确认），沿用既有 `useAdminWriteConfirm` 与刷新语义。
6. **文档**：主规范新增「后台模板上传」章节；决策记录补一条；主规范中「本轮只允许…不上传 ZIP」改为指向新章节。
## 验证命令
```bash
cargo test --locked -p module-assets --manifest-path server-rs/Cargo.toml -- template_library
cargo test --locked -p api-server --manifest-path server-rs/Cargo.toml -- agc_template
cargo fmt --all --manifest-path server-rs/Cargo.toml -- --check
npm run admin-web:typecheck
npx vitest run apps/admin-web/src/pages/AdminAgcTemplatesPage.test.tsx apps/admin-web/src/api/adminApiClient.test.ts
npm run check:encoding
npm run check:doc-index
git diff --check
```
接口 smoke：`npm run dev:api-server`（本地 8082）+ `npm run dev:admin-web`，先用未授权/无页签权限请求确认失败关闭，再以隔离存储替身或用户显式确认的 dev bucket 做一次真实导入。
## 时间盒与风险
- **风险：真实发布不可逆**。导入会写公共 bucket 且不提供删除，因此默认只在本地用替身验证；对 dev bucket 的写验证必须由用户显式确认，测试用模板需可在事后下架。
- **风险：ZIP 原字节发布与 CLI 确定性打包不一致**。同一模板可能被两条路径写成不同字节；由「同 ID 同版本字节必须一致」的门禁兜住，导入失败时提示改用 CLI 或递增版本。
- **风险：大文件内存**。ZIP（≤64 MiB）与封面在内存中校验，单批上限 20；需要更大模板时走 CLI。
- **风险：批量部分写入**。所有对象在清单提交前写入且不删除；中途失败时清单不变、已写对象成为未被引用的历史对象，由后续同键复用。
- **回退**：下线路由与页面入口即可停止使用；已发布内容按既有 CLI / 后台下架流程处理，历史对象保留。
docs/project-memory/plans/【实施计划】图集切片模式显式决策-2026-09-17.md
+4 -4
View File
@@ -1,10 +1,10 @@
# 【实施计划】图集切片模式显式决策
| 字段 | 值 |
| --- | --- |
| 字段 | 值 |
| --------- | ------------------------------------------------------------------------ |
| Milestone | `docs/project-memory/plans/【里程碑】图集切片模式显式决策-2026-09-17.md` |
| Status | ready |
| Owner | Codex |
| Status | ready |
| Owner | Codex |
## 修改边界
docs/project-memory/plans/【实施计划】平台会话身份与凭据分离-2026-09-16.md
+4 -4
View File
@@ -1,10 +1,10 @@
# 【实施计划】平台会话身份与凭据分离
| 字段 | 值 |
| --- | --- |
| 字段 | 值 |
| --------- | -------------------------------------------------------------------------- |
| Milestone | `docs/project-memory/plans/【里程碑】平台会话身份与凭据分离-2026-09-16.md` |
| Status | done（待验收复核） |
| Owner | Codex |
| Status | done（待验收复核） |
| Owner | Codex |
## 修改边界
docs/project-memory/plans/【里程碑】AGC模板库客户端接入-2026-09-17.md
+15 -1
View File
@@ -1,7 +1,7 @@
# AGC 模板库客户端接入
Version: 1.0
Status: active
Status: accepted（2026-09-21 复核：7 条验收项均有定向、前端与线上真连证据）
Date: 2026-09-17
Parent Spec: `docs/technical/【技术方案】AGC模板库与模板建项-2026-09-17.md`
@@ -38,3 +38,17 @@ AGC 客户端能读取公共 OSS 上的游戏模板库，并把「浏览 → 筛
- 现有自动工作区建项链路（`create_automatic_local_game_project_at` / `init_local_game_project_at`）。
- 现有 AGC 更新通道使用的受信任 OSS 主机与 CSP 白名单口径。
- 仓库 OSS 凭据（本机 `.env.secrets.local` 的 `ALIYUN_OSS_*`）与 `scripts/agc-template-library-publish.mjs`。
## 验收证据（2026-09-21）
| 验收项 | 证据 |
| --- | --- |
| 1 读清单 + 合并已安装状态 + 远端不可用回退缓存并标 `source=cache` | `template_library::tests::template_index_*` 5 项（网络优先并标 `network`、远端失败回退缓存并标 `cache`、无缓存暴露远端错误、远端正文非法不用缓存掩盖、缓存损坏失败关闭）；`fetches_the_live_template_library_index` 真连通过 |
| 2 下载拒绝字节数 / SHA-256 / 越界键 / 非 `templates/` 前缀，且不落半成品 | `rejects_archive_when_size_or_digest_do_not_match_the_index`（含新增断言：拒绝后无安装目录、无已下载判据）、`rejects_object_keys_outside_the_templates_prefix`、`rejects_template_base_url_outside_trusted_oss`；`downloads_and_installs_a_live_template` 真连通过 |
| 3 解压拒绝绝对路径 / `..` / 盘符 / 符号链接；安装完成才写 `installed.json` | `rejects_archive_entries_that_escape_the_destination`（含新增断言：失败后不产生安装记录）、`installs_template_archive_and_reports_it_as_installed`、`parses_content_addressed_objects_without_changing_the_template_contract` |
| 4 建项具备模板文件 + `.agent` + 标准目录，失败不留项目目录 | `creates_project_from_installed_template_without_leaking_install_marker`、`installs_official_cocos_templates_and_creates_native_projects`、新增 `failed_project_creation_removes_the_partial_project_directory`、`refuses_to_create_project_when_template_is_not_installed`；`downloads_and_creates_live_cocos_templates` 真连通过 |
| 5 页面筛选 / 卡片 / 已下载徽标 / 更新入口 / 浮层提示 / 版本落后先重下 | `templateLibraryView.test.tsx` 12 项、`templateLibraryModel.test.ts` 9 项、`templateLibraryGrid.test.ts` 6 项、`useTemplateLibrary.test.tsx` 11 项 |
| 6 首页推荐位与左侧导航入口 | `appSurface.test.ts` 首页模板用例 2 项：灰度外隐藏入口与推荐位、点击推荐位进入模板库且不建项目 |
| 7 定向用例 + 类型 / 编码 / 文档检查 + 可选真连 | Rust 24 项 + 线上 3 项、前端 38 项 + `appSurface` 2 项、AGC `typecheck`、`check:encoding`、`check:doc-index`、`git diff --check` 全部通过；匿名 `GET templates/index.json` 返回 200（`schemaVersion=agc-template-library.v1`、9 个模板） |
仍未验证：Creator 内场景运行；真机 iOS / Android 观感。持久结论已并入主规范 [`【技术方案】AGC模板库与模板建项-2026-09-17.md`](../../technical/【技术方案】AGC模板库与模板建项-2026-09-17.md)，本里程碑的实施计划已按工作流删除。
docs/project-memory/plans/【里程碑】AGC渠道安装身份隔离-2026-09-21.md
+44
View File
@@ -0,0 +1,44 @@
# 里程碑：AGC 渠道安装身份隔离
| 字段 | 值 |
| --- | --- |
| Version | 1.0 |
| Status | 代码与源码级验收已落地，等待真机双渠道安装验收 |
| Date | 2026-09-21 |
| Parent Spec | `docs/technical/【技术方案】AGC客户端更新检查与下载-2026-08-31.md` |
## 目标
不同渠道的 AGC 包体在同一台设备上并存：安装、运行、客户端数据与更新互不覆盖、互不顶掉。
## 范围
- 构建期按渠道产出安装身份（`productName` / `identifier`），默认渠道 `dev` 身份保持不变。
- 渠道产物命名、首装包选择、macOS 发布入口与配置门禁都消费同一份渠道身份。
- 同机并存的可见区分（窗口标题）与 AGC 自有 AppData 目录的提权 ACL 识别范围。
## 不在范围内
- 不迁移、不共享既有本地项目、工程快照、模板、登录态与诊断数据。
- 不新增渠道，不改 OSS 分区布局、官网下载页与后端接口。
- 不做 Apple 代码签名/公证，不恢复 Intel 架构。
## 依赖与前置条件
- 渠道与更新端点合同已落地（`<channel>-win` / `<channel>-mac` 分区与 Tauri updater 端点）。
- 构建入口统一在 Tauri 构建前注入渠道 `--config`。
## 验收标准
- [x] 默认渠道的 `productName` / `identifier` 与基线配置逐字一致，既有安装与升级链不断（`check-config.mjs` + 渠道身份用例）。
- [x] `release` 与自定义渠道派生独立 `productName` 与 `identifier`，与 `dev` 可在同一台设备并存（源码级；真机安装见下方未完成项）。
- [x] 渠道产物（NSIS `.exe`、`.app.tar.gz`、DMG）与首装包选择跟随渠道身份且唯一匹配（发布脚本用例）。
- [x] 非默认渠道的客户端数据目录、WebView2 目录与窗口标题跟随渠道身份（构建产物字符串实测 + 运行期标题取产品名）。
- [x] AGC 自有 AppData 目录的 ACL managed 范围覆盖全部渠道身份，且不扩大到相似前缀目录（Rust 定向 12/12）。
- [ ] 真机：同一台设备同时安装 `dev` 与 `release`，二者可并存、可各自原地更新。
## 证据要求
- 自动化：`build-release.test.mjs`、`release-oss.test.mjs`、`prepare-macos-codex.test.mjs`、`check-config.mjs` 与 Rust `config::tests::` 定向测试。
- 运行时：单渠道 `--no-bundle` 构建烟测；真机双渠道安装、并存与各自更新。
- 边界：非法渠道失败关闭；默认渠道身份不变；相似前缀目录不进入 managed 赋权范围。
docs/project-memory/plans/【里程碑】DirectProject Skill提及输入提示-2026-09-15.md
+43
View File
@@ -0,0 +1,43 @@
# 【里程碑】DirectProject Skill 提及输入提示
| 字段 | 值 |
| ----------- | ------------------------------------------------ |
| Version | 1.0 |
| Status | in-progress |
| Date | 2026-09-15 |
| Parent Spec | `docs/【功能说明】AGC聊天素材引用-2026-09-08.md` |
## 目标
在现有 Lexical `ResourceReferenceInput` 中增加 Codex 风格 `$skill-name` 提及。用户选择 Skill 后，编辑器保留与文本相对顺序一致的原子节点；DirectProject canonical user item 保存稳定 Skill 名称，Rust 只允许当前已启用且 app-server 已发现的 Skill，并在 `turn/start` 转换为 Codex 原生 `type: "skill"` 输入项。
## 范围
- Skill 候选数据从当前 DirectProject 的已启用 Skill catalog 派生。
- `$` typeahead 菜单、键盘选择、鼠标选择、Esc/Enter 交互与现有 `@` 菜单一致。
- Skill inline 节点和 `content[]` 顺序恢复。
- canonical `agc_skill_reference` part 的 ts-rs 类型、Rust 校验、历史写入与 Codex wire 转换。
- 现有素材、运行区域、assistant、附件和工具 activity 行为保持不变。
## 不在范围内
- Skill 导入、启用、禁用、重命名和 app-server `skills/list` 生命周期改造。
- 普通自然语言自动分类 Skill；只支持显式 `$skill-name` 选择。
- Skill 正文预加载、Skill 内容编辑或新的权限/工具能力。
- SpacetimeDB、HTTP API 和 assistant item 协议变更。
## 验收标准
- [ ] 输入 `$` 可显示并过滤可用 Skill，候选项显示名称和描述。
- [ ] 选择 Skill 后插入原子 `$name` chip，文本与素材/运行区域的相对顺序保持不变。
- [ ] canonical user item 只保存 Skill 稳定名称，不保存正文、凭据或宿主私密路径。
- [ ] Rust 拒绝未知、禁用、未发现或名称非法的 Skill；失败时不写历史、不启动回合。
- [ ] 合法 Skill 在 Codex wire input 中生成 `type: "skill"`、`name`、受控 `path`，顺序与 canonical content 一致。
- [ ] 无 Skill 的旧消息、素材引用和标准 `response_item` 读取行为不变。
## 证据要求
- 前端：Lexical 草稿顺序、候选过滤、chip 原子性与 `$`/`@` 共存测试。
- Rust：模型序列化、Skill catalog 校验、wire 转换、失败关闭和历史重放测试。
- 运行时：DirectProject app-server smoke（环境可用时）。
- 门禁：相关 Vitest、AGC Rust 定向测试、`npm run check:encoding`、`npm run check:doc-index`、`git diff --check`。
docs/project-memory/plans/【里程碑】DirectProject Thread Manager事件订阅-2026-09-15.md
+5 -5
View File
@@ -1,10 +1,10 @@
# 【里程碑】DirectProject Thread Manager 事件订阅
| 字段 | 值 |
| --- | --- |
| Version | 1.0 |
| Status | ready |
| Date | 2026-09-15 |
| 字段 | 值 |
| ----------- | -------------------------------------------------------------------------------- |
| Version | 1.0 |
| Status | ready |
| Date | 2026-09-15 |
| Parent Spec | `docs/technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md` |
## 目标
docs/project-memory/plans/【里程碑】DirectProject canonical content严格边界-2026-09-16.md
+51
View File
@@ -0,0 +1,51 @@
# 【里程碑】DirectProject canonical content 严格边界
| 字段 | 值 |
| ----------- | ------------------------------------------------ |
| Version | 1.0 |
| Status | implemented |
| Date | 2026-09-16 |
| Parent Spec | `docs/【功能说明】AGC聊天素材引用-2026-09-08.md` |
## 目标
让 DirectProject 的用户消息只以 `content[]` 作为 canonical 输入：转换函数原样传递编辑器草稿的 content part，不做二次预过滤；只在最终 content 上判断是否存在有效输入；所有 Direct Codex caller 必须显式提供完整 `userItem`。
## 范围
- 移除 `chatComposerDraftToDirectCodexUserItem` 对纯空白 `input_text` 的预过滤。
- Direct Codex 发送前只做最终 content 的有效性判断，不改写 content。
- 删除 `executeChatAgentReply` 在 `userItem` 缺失时的构造兜底。
- 删除 `ChatComposerDraft` 的 `text` / `references` 字段，草稿只保留 canonical `content`。
- 修正首页首轮、队列出队和其它 Direct Codex caller，使其直接构造 canonical user item。
- 将队列与策略确认重试按 canonical user item 传递，避免拆回 `text` / `references`。
- 仍在使用的旧 Supervisor/Planning caller 保持非 Direct Codex 行为，并添加后续迁移 TODO。
## 不在范围内
- 不保留从 `draft.text` / `draft.references` 重建 Direct Codex content 的兼容分支。
- 不新增断言 legacy 字段“不存在”的测试；现有测试直接迁移到 content-only 输入。
- 不修改 Rust user item schema、SpacetimeDB schema、HTTP API 或历史迁移。
## 验收标准
- `chatComposerDraftToDirectCodexUserItem` 输出与输入 `draft.content` 顺序和值完全一致。
- 只有当最终 content 不含非空文本且不含任何非文本 part 时，发送入口才拒绝本轮。
- Direct Codex 路径不存在 `userItem ?? ...` 或等价 fallback。
- `ChatComposerDraft` 只有 `content` 一个字段；`text` / `references` 不再是草稿契约的一部分。
- 首页首轮、普通聊天、队列出队、策略确认重试均发送同一个 canonical user item 语义。
- 旧 Supervisor/Planning caller 上有明确 TODO，且不进入 Direct Codex canonical 发送路径。
## 实现结论
- 前端不再做任何空白过滤：Lexical 投影层原样透传编辑器节点，段落分隔符（root 子节点之间补的 `\n`）、软换行、chip 后的分隔空格都各自成 part，既不丢弃也不与相邻 part 合并 —— 前端不替用户改写他输入的内容。
- 有效输入只判整条 content：有一段非空白文本或任何一个非文本 part 就算有效输入，单个纯空白 `input_text` 合法。前端 `hasMeaningfulDirectCodexContent` 与 Rust `validate_direct_codex_user_item`（`content_has_meaningful_input`）同口径，Rust 侧不再逐个 part 拒绝空文本；`wire.rs` 的「不能转换为空 prompt」只作兜底。
- 显示文本、队列 chip 文案、草稿持久化和润色判据统一由 `directCodexContentToPromptText(content, assets)` 从 content 派生，不再维护并行的 `text` 字段；`assets`（当前项目 manifest）必填，`agc_resource_reference` 按 `@显示名` 展开，消息正文与队列 chip 因此逐字一致。
- 需要文本草稿的旧入口（`replaceText`、快速编辑）仍由编辑器把文本 + 引用重建为 content，方向是「文本 → content」，不存在「legacy 字段 → content」的回退。
## 证据
- `apps/ai-game-creator-shell/tests/resourceReferences.test.ts`：content 原样传递、空白 part 保留、有效性判断、文本派生。
- `apps/ai-game-creator-shell/tests/resourceReferenceInput.test.tsx`（含「引用后面的段落分隔原样落进 content」）、`chatPromptPolish.test.tsx`、`tests/appSurface/*.suite.ts`：草稿读取、提醒判据、队列与 caller 迁移到 content-only，并按逐字投影断言 content。
- `apps/ai-game-creator-shell/src-tauri/src/agent/direct_codex_user_item/`：`validation.rs` 的「只有整条 content 全空白才算空输入」与 `wire.rs` 的「单个纯空白 part 通过校验、整条全空白拒绝」用例。
- AGC shell 类型检查、定向 Vitest、`npm run check:encoding`、`git diff --check` 通过。
docs/project-memory/plans/【里程碑】DirectProject composer canonical content闭环-2026-09-21.md
+65
View File
@@ -0,0 +1,65 @@
# 【里程碑】DirectProject composer canonical content 闭环
| 字段 | 值 |
| ----------- | --- |
| Version | 1.0 |
| Status | implemented |
| Date | 2026-09-21 |
| Parent Spec | `docs/【功能说明】AGC聊天素材引用-2026-09-08.md` |
| Related ADR | `docs/adr/【ADR】DirectProject独立聊天容器与工作台钱包布局-2026-09-18.md` |
| Supersedes | `docs/project-memory/plans/【实施计划】DirectProject canonical content严格边界-2026-09-16.md` 的已实现边界清理，补齐其遗漏的编辑器回写路径 |
## 问题确认
上一里程碑把 Direct 发送、队列和 Rust user item 收口到了 `content[]`，但输入编辑器仍保留一条旧的派生状态接口：
- `ChatComposerDraft` 仍包含 `text`、`references`、`content` 三个字段。
- `ResourceReferenceInput` 仍接收 `value` + `references`，并在受控同步 effect 中调用 `applyDraftToRoot(value, references)`。
- `replaceText` 与 `usePromptPolish` 的 `applyPromptText` 也调用 `applyDraftToRoot(text, current.references)`。
- `applyDraftToRoot` 只重建文本和 `ChatReference` 节点，不能表达 `agc_attachment_reference`，会在任何包含附件节点的 editor root 重建中丢附件。
- Direct controller 仍把同一份 `content` 拆成 `chatContent`、`chatInput`、`chatReferences` 三份状态；提交时又把附件 sidecar 追加回 `content`，导致编辑器 canonical content 与本轮完整 canonical user content 不是同一份事实源。
## 目标
让 DirectProject 的 composer 从读取、润色、受控恢复、队列、附件到提交都只围绕一份有序 `content[]` 运作：
1. 编辑器对外草稿类型只有 `content`。
2. 文本展示、提醒、队列 chip 和 prompt 参数全部由 `content[]` 派生。
3. 任意编辑器回写只能接收完整 `content[]`；不能用文本和引用列表重建 root。
4. `agc_attachment_reference` 在恢复、润色回写、队列和提交中保持顺序和值，不得丢失、搬移或重复。
5. DirectProject 不再维护 `chatInput` / `chatReferences` / `chatContent` 并行事实源；待发上传附件也必须在进入提交前显式合并为同一 canonical content。
## 边界与非目标
- 保留 `directCodexContentToPromptText` 作为只读展示投影，不把它反向解析成 content。
- 保留 `ChatReference` 作为 picker/UI 的候选与节点显示模型；它不是 Direct 草稿或发送模型。
- Planning V2 与资源快速编辑若仍需要文本 props，只能通过明确的 adapter/独立表象接口接入，不能让这些 legacy props 继续成为 Direct composer 的接口。
- 不修改 Rust user item schema、SpacetimeDB、HTTP API 或附件协议字段。
- 不引入兼容 alias、`text + references → content` fallback、隐式附件 sidecar 拼接或双写状态。
## 验收标准
- `ChatComposerDraft`、`ResourceReferenceInput` 的 Direct 使用面和 Direct composer props 不再暴露 `text` / `references` 双轨草稿。
- 代码中不存在 Direct 路径对 `applyDraftToRoot(value, references)`、`replaceText(text)` 或等价 legacy 重建器的调用。
- `content[]` 中交错的文本、资源引用、运行区域引用、Skill 和附件经过：初始恢复 → 读取 → 润色回写 → 再读取，part 一个不少。
- 润色回包还留着 `@显示名` / `$名称` / `@附件名` 时，对应 chip 在原位置复活；token 被整体改写掉的 part 补在末尾，不丢。
- 附件-only、文本+附件、资源引用+附件、文本+资源引用+附件四类提交均只生成一份 canonical user item，附件字段完整保留。
- 队列入队、出队、策略确认重试复用同一份 `userItem.content`，不从 prompt 文本重建。
- Direct 提交清理草稿后，待发附件和 editor content 同时清空；失败或取消不会悄悄丢失待发附件。
- Planning/快速编辑的迁移或隔离有明确类型接口和定向测试，不再借 Direct 的双轨 props。
## 证据要求
- ResourceReferenceInput 纯投影/回写测试：包含附件节点的 round-trip 与润色回写不丢附件。
- Direct composer appSurface：四类 content 组合、队列、策略重试及清理语义。
- 类型检查、定向 Vitest、`npm run check:encoding`、`npm run check:doc-index`、`git diff --check`。
## 落地结果
- `ChatComposerDraft` 只剩 `content`；`ResourceReferenceInput` 的对外接口是 `initialContent` + `onChange` + `getDraft()`，受控 `value` / `references` 与 `applyDraftToRoot` 已删除。
- 编辑器 root 回写只剩 `applyContentToRoot`（完整 content，含附件）一条路径；清空、初始恢复、润色回写都走它。
- Direct composer 提交时把 editor content 与待发附件 sidecar 合成同一份 canonical content；controller 不再持有 `chatInput` / `chatReferences` / `chatContent`。
- Planning 提交与 legacy 消费方通过单向 `directCodexContentToLegacyContentDto` 取文本，不回写编辑器。
- 润色回写（`applyPolishedTextToRoot`）对引用与附件用同一套 token 扫描（`draftScanToken`）：token 存活则原位换回真 part，被改写的 part 末尾补位；附件不再丢出 canonical content。
- 遗留 TODO：润色服务整体改写文本、连 token 一起删掉时，前端无法反推原位置，只能末尾补位；需要精确恢复时由产品补带位置信息的润色协议。
- 收口扩展（2026-09-21，栏目画布图片类生成浮层）：面板 state、重开草稿 `ResourceCanvasAssetGenerationPanelDraft`、重试身份判据与提交载荷全部只有一份 `content[]`；`directCodexContentToLegacyContentDto` 只在任务落账这一个出站边界派生，账本回草稿走同一套 token 反解析（`legacyContentDtoToContent`）。token 扫描实现从 `ResourceReferenceInput` 提到 `resourceReferences`，润色回写与 legacy 翻译共用一份；无从解析的资源引用合成 `kind: unknown` 占位而不再被静默丢弃。详见 `decision-log.md` 同名条目。
docs/project-memory/plans/【里程碑】DirectProject用户ResponseItem输入-2026-09-15.md
+8 -8
View File
@@ -1,10 +1,10 @@
# 【里程碑】DirectProject 用户 Response item 输入
| 字段 | 值 |
| --- | --- |
| Version | 1.0 |
| Status | proposed |
| Date | 2026-09-15 |
| 字段 | 值 |
| ----------- | ------------------------------------------------ |
| Version | 1.0 |
| Status | proposed |
| Date | 2026-09-15 |
| Parent Spec | `docs/【功能说明】AGC聊天素材引用-2026-09-08.md` |
## 目标
@@ -19,13 +19,13 @@
- `agc_runtime_region_reference` 保留运行区域语义摘要。
- Rust 在持久化前完成白名单、manifest 与路径校验。
- 现有标准 `response_item` 原样兼容；legacy conversation 行不提供 fallback。
- 保持 assistant 返回、工具 activity、附件/图片协议不变。
- 保持 assistant 返回、工具 activity 与上传 DTO 不变；DirectProject canonical user item 不再保存附件 sidecar，所有本地上传文件（包括图片）统一作为 `content[]` 中按顺序排列的 `agc_attachment_reference`。
## 不在范围内
- assistant item 前端投影或 Tauri 返回值改造。
- 工具 item、reasoning、file change、MCP item 的 UI 模型化。
- 附件/图片 content part。
- 不新增图片专用 content part；上传 DTO 只作为输入适配，不作为历史事实源。
- SpacetimeDB schema 或 HTTP API 变更。
## 依赖与前置条件
@@ -42,7 +42,7 @@
- [x] 未知 part、失效资源或非法路径在持久化前失败关闭。
- [x] canonical item 以 `response_item` 写入历史，标准旧 item 原样可读。
- [x] Codex wire input 不含 AGC 私有 part，且顺序与 canonical content 一致。
- [ ] assistant、附件和工具链路行为无变化。
- [x] assistant、附件和工具链路行为无变化；所有上传文件按 content 顺序内联，附件-only 输入也能进入 DirectProject prompt。
## 证据要求
docs/project-memory/plans/【里程碑】DirectProject聊天模块抽离-2026-09-18.md
+50
View File
@@ -0,0 +1,50 @@
# 【里程碑】DirectProject 聊天模块抽离
| 字段 | 值 |
| ----------- | ---------------------------------------------------------------------- |
| Version | 1.0 |
| Status | proposed |
| Date | 2026-09-18 |
| Parent Spec | `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md` |
## 目标
把普通项目的 DirectProject 聊天从 `App.tsx` 与工作台聊天宿主中抽出为独立产品容器（`view/project-development/chat/`），并把项目级钱包入口提升到工作台布局层；立项策划（Design Agent、Planning V2）随后收敛到 `view/project-development/planning/`。
## 范围
- 公开入口只有一个 `DirectProjectChat`；内部可按状态、订阅/历史、发送/队列、附件和表现职责拆成私有模块。
- DirectProject 容器拥有项目对话历史、运行态事件、聊天投影、首屏锚点、历史分页、发送回合、FIFO 队列、附件、中止和项目切换清理。
- `App.tsx` 保留通用项目壳状态，只传窄项目上下文与布局同步出口；不再拥有 Direct 专属 state/ref/effect/handler。
- 立项策划只由 `PlanningChatView` 承载；共享 Composer、消息、Markdown、工具卡片和通用设置表现可以复用，但不共享产品行为容器。
- 钱包入口由项目工作台布局（`ProjectDevelopmentView` 的布局级头部/工具栏）独立渲染，不进入聊天上下文或聊天设置浮层。
## 不在范围内
- 不改变 DirectProject 的 Tauri/Rust 命令、DTO、Thread Manager、Codex app-server、持久化事实源或运行态事件语义。
- 不改变 DirectProject 的路由选择条件、发送/队列/附件/中止/历史锚点/投影行为；钱包仅按已确认的布局归属调整。
- 不合并 DirectProject、Design Agent、Planning V2；不新增通用 Agent 聊天框架。
- 不新增测试场景或 Provider E2E；现有测试按新模块所有权迁移。
- 不保留 Direct 旧条件分支、alias、feature flag、双跑或兼容 fallback。
## 依赖与前置条件
- 现有 DirectProject 真相源收敛与 Thread Manager 事件订阅已作为当前行为合同。
- 现有 DirectProject 纯模块测试与 `chat-composer.suite.ts`、`project-development.suite.ts` 页面断言作为迁移基线。
- `ProjectDevelopmentView` 已是钱包插槽注入与项目布局的外层边界，可移除向聊天元素的 `cloneElement` 注入。
## 验收标准
- [x] DirectProject 只通过独立 `DirectProjectChat` 入口渲染，不再作为工作台聊天宿主里的条件分支。
- [ ] DirectProject 的订阅、历史、投影、发送、队列、附件、中止和项目切换状态不再由 `App.tsx` 持有。
- [x] Design Agent 与 Planning V2 的入口和行为不被 Direct 抽离改变（策划链路已在后续变更中收敛到 `PlanningChatView`）。
- [ ] 钱包入口由项目工作台布局独立渲染，聊天组件和聊天设置不接收或渲染 `walletEntry`。
- [ ] 现有 DirectProject 测试断言按新模块所有权迁移，测试场景与覆盖范围不减少，也不新增场景。
- [ ] 代码中不存在 Direct 旧 fallback、feature flag、兼容 alias 或共享行为条件分支。
## 证据要求
- 自动化：迁移后的 Direct 纯模块测试、现有 Composer/项目开发页面测试、非 Direct 现有测试与 TypeScript 检查。
- 文档：`npm run check:doc-index`、`npm run check:encoding`、`git diff --check`。
- 边界：Thread Manager 订阅回执竞态、首屏锚点、历史连拉、实时/历史合并、FIFO 出队、附件清理、中止 released 分支和项目切换。
- 未验证项：真实 Provider/app-server 运行时不因本次结构重构新增验收范围；若现有环境无法运行，记录为未验证而不添加替代兼容路径。
docs/project-memory/plans/【里程碑】DirectProject聊天真相源收敛-2026-09-16.md
+5 -5
View File
@@ -1,10 +1,10 @@
# 【里程碑】DirectProject 聊天真相源收敛
| 字段 | 值 |
| --- | --- |
| Version | 1.0 |
| Status | implemented（自动化验收通过，运行时验收待补） |
| Date | 2026-09-16 |
| 字段 | 值 |
| ----------- | -------------------------------------------------------------------------------- |
| Version | 1.0 |
| Status | implemented（自动化验收通过，运行时验收待补） |
| Date | 2026-09-16 |
| Parent Spec | `docs/technical/【技术方案】DirectProject Codex原始历史与异常恢复-2026-09-04.md` |
## 目标

Some files were not shown because too many files have changed in this diff Show More