From 6dd0dc00cc66148450afc71dc757e93a07b5ed03 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= Date: Mon, 5 Oct 2026 17:54:30 +0800 Subject: [PATCH] =?UTF-8?q?=E5=9B=9E=E5=86=99=E6=9C=AA=E9=80=82=E9=85=8D?= =?UTF-8?q?=E5=85=A5=E5=8F=A3=E4=B8=8E=E5=A4=B1=E8=B4=A5=E5=8D=A1=E7=89=87?= =?UTF-8?q?=E4=B8=89=E5=90=91=E5=88=86=E6=B4=BE?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 主规范：说明未适配结论只在注册表读回来之后下、提示卡片自带入队按钮、失败卡片按 action 分派适配/修/重试，同一时刻只有一张卡片一个入口。 - 实施计划与里程碑：补提交、前端 vitest 口径改为 18 例（新增 14 + 既有 4），并把 14 例覆盖到的内容逐项列出。 --- .../【实施计划】导出产物面板与小红书小工具导出-2026-10-05.md | 3 ++- .../【里程碑】导出产物面板与小红书小工具导出-2026-10-05.md | 2 +- .../【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md | 2 +- 3 files changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/project-memory/plans/【实施计划】导出产物面板与小红书小工具导出-2026-10-05.md b/docs/project-memory/plans/【实施计划】导出产物面板与小红书小工具导出-2026-10-05.md index 0f8c6ce9a..7b9ae1e71 100644 --- a/docs/project-memory/plans/【实施计划】导出产物面板与小红书小工具导出-2026-10-05.md +++ b/docs/project-memory/plans/【实施计划】导出产物面板与小红书小工具导出-2026-10-05.md @@ -56,8 +56,9 @@ - `95323ce54` skill 的 `--zip-out` 与 AGC 接入契约（manifest `2026-08-26.41`）；`3369f76b1` `.export` 快照同步排除；`faa93929b` 文档回写。 - `5e2426c8a` 导出收尾判据抽成 `conclude(...)` 并补 5 例确定性用例（非零退出 / 超时 / 产物缺失 / 空产物 / 成功），同时去掉 `XHSMiniToolExportRunResult.exitCode` 这个恒为 0 的死字段；`463341c4b` 导出成功后把脚本输出尾部报给用户；`b3be3ee71` 证据口径修正；`5dd158ee1` 补默认 ignore 的真实起进程用例。 - `1b7741ac6` 适配与修复指令补上「包根在 game/ 时落点写成 `../.export/xhs-minitool.zip`」，skill 契约同步（manifest `2026-08-26.42`）；`f8ed4e898` 保存对话框的默认文件名收进下载助手并复用既有取文件名工具；`90f651ddf` 刷新时先撤掉待触发的自动保存（附回归用例）。 +- `ac666daad` 之后：未适配提示改成带入队按钮的卡片、失败卡片按变体分派适配/修/重试、提示只在注册表读回来之后出现（同一时刻只有一张卡片、一个入口）。 -已验证：Rust `export::` 49 例（`export::draft::xhs_minitool` 33 例）、`export_bindings` 115 例、`project_snapshot` 22 例、`check:generated-bindings`（117 个文件）、前端 vitest 16 例（新增 12 + 既有 4）、`ai-game-creator-shell:typecheck`、`agc:skill-pack:check`、`check:doc-index`、`check:encoding`、`git diff --check`。 +已验证：Rust `export::` 49 例（`export::draft::xhs_minitool` 33 例）、`export_bindings` 115 例、`project_snapshot` 22 例、`check:generated-bindings`（117 个文件）、前端 vitest 18 例（新增 14 + 既有 4）、`ai-game-creator-shell:typecheck`、`agc:skill-pack:check`、`check:doc-index`、`check:encoding`、`git diff --check`。 未验证（唯一开口项）：真实 vite 项目上的首轮适配闭环——agent 跑通 `build:xhs-minitool`、产出可上传 zip、二次导出零 agent 调用；以及 `.export/` 换机后重新适配的体感。宿主侧这一段已尽力自动化：`build.rs` 的 `executes_the_project_script_and_requires_a_non_empty_artifact_each_time`（`#[ignore]`）会真起进程执行项目脚本，覆盖「第一次产出 → 删掉产物再跑一次重新产出 → 脚本成功但没产出报 artifactMissing」。本机尝试运行被容器环境挡下，读日志时注意两点、别误判成 bug： - 子进程输出里的 `running 1 test` 是**预期现象**：命令沙箱的垫片就是当前可执行文件本身（`desktop.rs` 按 `--command-sandbox-trampoline` 分流），编译到测试态时 `sandbox_trampoline_arguments()` 会改成 `--exact ...trampoline_child_fixture --ignored`，所以垫片进程是测试二进制在跑那一个 fixture 用例。 diff --git a/docs/project-memory/plans/【里程碑】导出产物面板与小红书小工具导出-2026-10-05.md b/docs/project-memory/plans/【里程碑】导出产物面板与小红书小工具导出-2026-10-05.md index f3dbf8eb9..5e61b6497 100644 --- a/docs/project-memory/plans/【里程碑】导出产物面板与小红书小工具导出-2026-10-05.md +++ b/docs/project-memory/plans/【里程碑】导出产物面板与小红书小工具导出-2026-10-05.md @@ -51,7 +51,7 @@ - 自动化（已落）： - Rust `cargo test ... --bin genarrative-ai-game-creator-shell export::` 49 例，其中 `export::draft::xhs_minitool` 33 例：注册表自动建空表单、格式漂移静默吸收、严格解析拒绝、表单首错、icon 越界/符号链接/扩展名、`hasScript` 现算、`contentHash` 冲突、产物路径守卫，以及构建收尾判据的逐条映射（脚本缺失、非零退出带退出码与输出尾部、超时无退出码、产物缺失、空产物不算、成功回输出尾部）。 - `export_bindings` 115 例 + `npm run check:generated-bindings`（117 个生成文件）通过。 - - 前端 `npx vitest run tests/xhsMinitoolExport.test.tsx`（12 例）与既有 `tests/artifactsPanel.test.tsx`（4 例）通过；`npm run ai-game-creator-shell:typecheck` 通过。其中 12 例覆盖：指令正文三条硬契约与 game/ 落点、失败现场拼装、失败变体人话映射、表单复制、icon 与 zip 下载、冲突逐字段二选一、自动保存的 `baseHash` 回传、刷新不把待保存旧值写回、导出把脚本输出尾部报给用户、以及「只有适配/修复才叫 agent」。 + - 前端 `npx vitest run tests/xhsMinitoolExport.test.tsx`（14 例）与既有 `tests/artifactsPanel.test.tsx`（4 例）通过；`npm run ai-game-creator-shell:typecheck` 通过。其中 14 例覆盖：指令正文三条硬契约与 game/ 落点、失败现场拼装、失败变体人话映射与三向 action 分派（适配 / 修 / 重试）、未适配卡片自带入队按钮且按钮行不重复、注册表读回来之前不下「还没适配」结论、表单复制、icon 与 zip 下载、冲突逐字段二选一、自动保存的 `baseHash` 回传、刷新不把待保存旧值写回、导出把脚本输出尾部报给用户、以及「只有适配/修复才叫 agent」。 - `.export/` 快照排除有定向用例：`project_snapshot::tests::project_snapshot_sync_policy_keeps_agent_state_and_still_blocks_credentials` 同时钉住「同步排除」与「通用口径不排除（Agent 仍可写）」。 - `npm run agc:skill-pack:sync` → `agc:skill-pack:check` 通过（`manifest.json` 版本 `2026-08-26.41`，文件数不变，仍 36 条）。 - 运行时（**未验证**，本里程碑唯一开口项）：在真实 vite 项目上由 agent 完成首轮适配、产出可人工上传的 zip、二次导出零 agent 调用；`.export/` 换机后需重新适配的体感也需一并确认。宿主侧这一段已有默认 `#[ignore]` 的真起进程用例（`executes_the_project_script_and_requires_a_non_empty_artifact_each_time`：第一次产出 → 删掉产物重跑必须重新产出 → 脚本成功但没产出报 artifactMissing），一键复跑命令见实施计划；本次尝试被容器环境的 npm/沙箱解析挡下，不是代码问题。 diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md index 56feb5a3a..10ca8676b 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -8,7 +8,7 @@ - 表单：`name`、`introduction` 各 ≤14 个 Unicode 字符且非空；`iconPath` 必须存在、是项目内普通文件、不是符号链接、扩展名 ∈ {png, jpg, jpeg}、≤5 MiB。上限来自小红书平台上传表单，宿主**硬校验**（不是提示）；不支持的格式先直接拒绝，格式转换工具是后续事项（代码处留 TODO）。表单不是构建输入——zip 规范里没有任何 app 元数据；它的唯一用途是让用户复制粘贴到平台上传页。 - 注册表：首次打开该目标时由宿主自动创建，**所有字段为空字符串**。注册表不存 status、不存「是否已适配」、不存经验文本；agent 的经验写在它自己拷进项目的脚本注释里。「有没有脚本」永远现场从 npm 包的 `package.json` scripts 读取（`hasScript`），不落盘。 - 构建契约：项目 npm 包里存在脚本 `build:xhs-minitool`（冒号形式是既有 `command.exec` 白名单 `build:*` 的要求），由宿主负责运行；跑完必须存在 `.export/xhs-minitool.zip`。脚本内部怎么 `vite build`、怎么调 `pack.mjs`、用什么中间目录由 agent 决定并写进脚本；**每次导出都重新构建 zip**，不做「产物已存在」的短路。 -- 首次适配：用户点显式按钮 → 前端组装适配指令（正文在 `view/project-development/export/state/xhsMinitoolInstruction.ts`，纯函数 + 契约常量）→ 经 `useDirectProjectChatController` 的 `chat.submit` 入队（该链路自带会话写权限门与 clientTurnId），进的就是同一个项目主 Direct 会话，不另开「直接调 agent」的旁路。不自动跑构建、不自动刷新；agent 回合结束后由用户点「刷新」重读状态、点「导出」由宿主跑脚本；失败卡片上的「让 code agent 修」发的是同一份契约加宿主失败现场。 +- 首次适配：用户点显式按钮 → 前端组装适配指令（正文在 `view/project-development/export/state/xhsMinitoolInstruction.ts`，纯函数 + 契约常量）→ 经 `useDirectProjectChatController` 的 `chat.submit` 入队（该链路自带会话写权限门与 clientTurnId），进的就是同一个项目主 Direct 会话，不另开「直接调 agent」的旁路。不自动跑构建、不自动刷新；agent 回合结束后由用户点「刷新」重读状态、点「导出」由宿主跑脚本。没有构建脚本时，「还没适配」的结论只由注册表读回来之后下（`hasScript` 初值是 `false`，读取中不下结论），提示卡片自带那颗入队按钮，按钮行里就不再重复一颗；失败卡片按变体的 `action` 分派三颗按钮——`adapt` 发首次适配指令（还没适配，修复指令会引用一份还不存在的适配说明）、`repair` 发同一份契约加宿主失败现场、`retry` 只重试，同一时刻只有一张卡片、一个入口。 - 冲突：注册表可被 agent（改文件）与用户（面板编辑）两方写入。宿主读注册表时返回 `contentHash`，保存时带 `baseHash`；宿主重读比对，hash 不同再逐字段 diff，只要有字段真的不同就判冲突，**绝不覆盖**，返回两侧值让前端逐字段选择；纯格式化改动静默吸收。注册表内不存 revision / updatedAt 之类 token。 - 权限与副作用：跑脚本复用 `command.exec` 的权限口径（只查 deny，UI 按钮即用户确认），**不新增** `GAME_CREATION_APP_COMMANDS` 条目；导出链路**不拿项目写锁、不推进全局 revision**（`.export/` 不进 manifest、素材、UI State 或客户端投影）。发布包是白名单收集，`.export/` 不会进入。 - 非目标：平台自动上传（无 API）、PNG/JPG 之外的 icon 格式转换、宿主侧 zip 结构校验、非 vite 项目、第二个导出目标，以及 `GAME_CREATION_APP_COMMANDS` / `shared-contracts` / SpacetimeDB / OpenAPI 的任何改动。