From eb80a592c0c34b472f3516d8258f8b0f102c273b Mon Sep 17 00:00:00 2001
From: AIGameCreator App <dsk@genarrative.world>
Date: Fri, 3 Jul 2026 02:02:21 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85AI=E6=B8=B8=E6=88=8F=E5=88=9B?=
 =?UTF-8?q?=E4=BD=9C=E8=8D=89=E7=A8=BF=E5=BF=AB=E6=8D=B7=E5=85=A5=E5=8F=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

新增灵感草稿入口，仅填入创作需求不触发生成

新增预览和Agent状态权限确认草稿入口

补充主窗口草稿入口测试覆盖

同步AI游戏创作App文档和共享决策记录
---
 apps/ai-game-creator-shell/src/App.tsx        | 26 ++++++++++++++
 .../tests/appSurface.test.ts                  | 35 ++++++++++++++++++-
 .../shared-memory/decision-log.md             |  2 +-
 ...�案】AI游戏创作智能体App实施计划-2026-06-24.md |  3 +-
 4 files changed, 63 insertions(+), 3 deletions(-)

diff --git a/apps/ai-game-creator-shell/src/App.tsx b/apps/ai-game-creator-shell/src/App.tsx
index 539af1977..48c43e85d 100644
--- a/apps/ai-game-creator-shell/src/App.tsx
+++ b/apps/ai-game-creator-shell/src/App.tsx
@@ -9398,6 +9398,16 @@ export function App() {
           </div>
         </header>
         <div className="chat-quick-actions" aria-label="预览快捷操作">
+          <button
+            type="button"
+            onClick={() =>
+              prepareChatCommandDraft(
+                '像素风厨房弹幕小游戏：玩家用方向键躲避飞来的食材，收集调料加分，60 秒内尽量高分，失败后可一键重开。',
+              )
+            }
+          >
+            灵感草稿
+          </button>
           <button
             type="button"
             disabled={!localProject}
@@ -9453,6 +9463,22 @@ export function App() {
           >
             任务
           </button>
+          <button
+            type="button"
+            disabled={!localProject}
+            onClick={() => prepareChatCommandDraft('/policy-confirm preview.start')}
+          >
+            预览确认
+          </button>
+          <button
+            type="button"
+            disabled={!localProject}
+            onClick={() =>
+              prepareChatCommandDraft('/policy-confirm agent.run_status')
+            }
+          >
+            Agent确认
+          </button>
           <button
             type="button"
             disabled={!localProject}
diff --git a/apps/ai-game-creator-shell/tests/appSurface.test.ts b/apps/ai-game-creator-shell/tests/appSurface.test.ts
index 121b3f6fb..526750767 100644
--- a/apps/ai-game-creator-shell/tests/appSurface.test.ts
+++ b/apps/ai-game-creator-shell/tests/appSurface.test.ts
@@ -200,6 +200,10 @@ describe('AI 游戏创作 App 界面边界', () => {
     expect(screen.getByRole('button', { name: '配置' })).not.toBeNull();
     expect(screen.getByRole('button', { name: 'LLM状态' })).not.toBeNull();
     expect(screen.getByRole('button', { name: '显示目录' })).not.toBeNull();
+    expect(
+      (screen.getByRole('button', { name: '灵感草稿' }) as HTMLButtonElement)
+        .disabled,
+    ).toBe(false);
     expect(
       (screen.getByRole('button', { name: '项目状态' }) as HTMLButtonElement)
         .disabled,
@@ -235,6 +239,14 @@ describe('AI 游戏创作 App 界面边界', () => {
       (screen.getByRole('button', { name: '任务' }) as HTMLButtonElement)
         .disabled,
     ).toBe(true);
+    expect(
+      (screen.getByRole('button', { name: '预览确认' }) as HTMLButtonElement)
+        .disabled,
+    ).toBe(true);
+    expect(
+      (screen.getByRole('button', { name: 'Agent确认' }) as HTMLButtonElement)
+        .disabled,
+    ).toBe(true);
     expect(
       (screen.getByRole('button', { name: 'Trace' }) as HTMLButtonElement)
         .disabled,
@@ -352,6 +364,12 @@ describe('AI 游戏创作 App 界面边界', () => {
     ).toBe(true);
     fireEvent.click(screen.getByRole('button', { name: '打开画板' }));
     expect(composerInput).toHaveProperty('value', '/canvas ');
+    fireEvent.click(screen.getByRole('button', { name: '灵感草稿' }));
+    expect(composerInput).toHaveProperty(
+      'value',
+      '像素风厨房弹幕小游戏：玩家用方向键躲避飞来的食材，收集调料加分，60 秒内尽量高分，失败后可一键重开。',
+    );
+    expect(screen.queryByText('game.generate_draft')).toBeNull();
     fireEvent.click(screen.getByRole('button', { name: '白名单' }));
     expect(await screen.findByText(/可运行受限命令：/)).not.toBeNull();
     expect(screen.getByRole('button', { name: '切换项目' })).not.toBeNull();
@@ -1891,6 +1909,22 @@ describe('AI 游戏创作 App 界面边界', () => {
     expect(
       await screen.findByText(/策略：\.agent\/policy\.json/),
     ).not.toBeNull();
+    const composerInput = screen.getByLabelText('创作想法');
+    fireEvent.click(screen.getByRole('button', { name: '预览确认' }));
+    expect(composerInput).toHaveProperty(
+      'value',
+      '/policy-confirm preview.start',
+    );
+    fireEvent.click(screen.getByRole('button', { name: 'Agent确认' }));
+    expect(composerInput).toHaveProperty(
+      'value',
+      '/policy-confirm agent.run_status',
+    );
+    expect(screen.queryByText('project.policy_write')).toBeNull();
+    expect(invoke).not.toHaveBeenCalledWith(
+      'write_project_permission_policy',
+      expect.anything(),
+    );
 
     fireEvent.click(screen.getByRole('button', { name: '审计' }));
     expect(await screen.findByText(/Agent v1 审计：/)).not.toBeNull();
@@ -1904,7 +1938,6 @@ describe('AI 游戏创作 App 界面边界', () => {
         'uploaded · text/plain · uploaded',
       ),
     ).not.toBeNull();
-    const composerInput = screen.getByLabelText('创作想法');
     fireEvent.click(screen.getByRole('button', { name: '打开画板' }));
     expect(composerInput).toHaveProperty('value', '/canvas ');
     await waitFor(() => expect(document.activeElement).toBe(composerInput));
diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md
index 5a492300e..d85e5f768 100644
--- a/docs/project-memory/shared-memory/decision-log.md
+++ b/docs/project-memory/shared-memory/decision-log.md
@@ -21,7 +21,7 @@
 - 背景：AI 游戏创作 App 已有 Godcoder 式本地工程护栏、项目黑板、角色私有记忆、manifest 和 run trace；新增结构化对话记录、agent 状态列表和单 agent 对话入口时，需要避免引入平行状态源或提前承诺后台 runner 能力。
 - 决策：v1 结构化对话记录统一使用本地 `.agent/conversations/` append-only JSONL。普通聊天写 `.agent/conversations/project.jsonl`；从 agent 状态列表进入单个 agent 后，用户消息、agent 回复、工具建议和错误只写对应 `.agent/conversations/agents/<agentId>.jsonl`。Agent 状态列表从 `.agent/manifest.json` 的任务 / 角色清单和 `.agent/run.latest.json` / `.agent/runs/<runId>.json` 的 step、taskGraph、passPlans、lifecycleStatus 派生，并把 `taskGraph.tasks` 的任务状态与 active / carry-over / ready 编排标记显示在主窗口和单 agent 对话入口中；单 agent 最近证据里的安全相对输入 / 输出路径只填入 `/read <path>` 草稿，仍由用户发送并走既有 `file.read` / `agent.trace_read` 权限流。不新增独立状态数据库。项目黑板和角色私有记忆继续只保存稳定摘要，不承载原始对话流水。
 - 补充：App 启动先进入独立启动器窗口；用户选择工作区后，Tauri 关闭启动器并打开主窗口，主窗口读取该工作区的主 conversation、manifest 和 run trace。启动器“新建项目”先调用 `init_local_game_project` 初始化成功，默认项目名取目标文件夹名，再写最近项目并打开主窗口；遇到非空目录时先弹确认，取消或初始化失败则不打开主窗口、不写最近项目。最近工作区只保存在本机 WebView storage，可单项移除或清空，不进入项目文件或共享记忆；已初始化项目优先显示 manifest 项目名并保留路径副信息，`.agent/run.latest.json` 可读时显示最近 run 状态。最近项目路径缺失、不是目录、缺少可读 `.agent/manifest.json` 或检查失败时禁用打开，刷新只重新执行只读检查；“显示”只用系统文件管理器打开已确认存在的本地目录，未初始化但存在的目录也可显示，避免把历史路径误当新项目重建。
-- 补充：主窗口“显示目录”复用同一只读目录打开能力，只打开当前本地项目目录，不初始化项目、不写项目文件、不切换工作区；主窗口头部只读显示 manifest 项目名、项目路径、最近 `.agent/run.latest.json` 的 run 状态摘要和当前预览状态，并通过“刷新状态”重新读取同一 trace，不新增状态数据库。最近项目资产入口只读展示 localPath、kind、mediaType 和 source.kind，点击仍走原 `file.read` 权限流；旁边的“读取命令”只填入 `/read <path>` 草稿，不直接读取文件或绕过权限。主窗口“记到黑板”“覆盖黑板”“清空黑板”只填入项目黑板相关 `/remember`、`/memory-set` 和 `/forget-memory` 草稿，项目黑板写入或删除仍走聊天确认；Agent 状态栏的 output / activity / context bundle 入口也只填入 `/read` 草稿，不直接读取 run 辅助文件。
+- 补充：主窗口“显示目录”复用同一只读目录打开能力，只打开当前本地项目目录，不初始化项目、不写项目文件、不切换工作区；主窗口头部只读显示 manifest 项目名、项目路径、最近 `.agent/run.latest.json` 的 run 状态摘要和当前预览状态，并通过“刷新状态”重新读取同一 trace，不新增状态数据库。最近项目资产入口只读展示 localPath、kind、mediaType 和 source.kind，点击仍走原 `file.read` 权限流；旁边的“读取命令”只填入 `/read <path>` 草稿，不直接读取文件或绕过权限。主窗口“记到黑板”“覆盖黑板”“清空黑板”只填入项目黑板相关 `/remember`、`/memory-set` 和 `/forget-memory` 草稿，项目黑板写入或删除仍走聊天确认；Agent 状态栏的 output / activity / context bundle 入口也只填入 `/read` 草稿，不直接读取 run 辅助文件；灵感草稿和权限策略快捷入口同样只填入输入框，不提交、不写 `.agent/policy.json`、不调用 LLM。
 - 补充：启动器和主窗口共用同一个运行时配置弹窗，配置只读写 Tauri 应用配置目录中的 `game-creator.config.json`，不写入项目文件或对话历史。
 - 补充：启动器“打开”只进入已初始化且 `.agent/manifest.json` 可读的 AI 游戏项目；路径不存在、不是文件夹或只是普通文件夹时不打开主窗口、不创建目录，用户需要创建或初始化时走“新建项目”。
 - 影响范围：`apps/ai-game-creator-shell` 的主窗口 agent 状态列表、单 agent 对话入口、本地项目文件结构、共享契约和 AI 游戏创作 App 实施计划。
diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
index f565b68bb..1f0ce29c0 100644
--- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
+++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
@@ -111,7 +111,7 @@ game-project/
 
 ## v1 验收证据矩阵
 
-- `npm run ai-game-creator-shell:check`：覆盖壳 typecheck、聊天命令单测、用户 / 开发窗口 UI 边界 smoke、主窗口命令按钮复用 `/help` 命令列表、能力按钮复用 `/capabilities`、LLM状态按钮复用 `/llm-status`、项目状态按钮复用 `/status`、权限按钮复用 `/policy`、审计按钮复用 `/audit`、资产按钮复用 `/assets` 且资产结果可一键复用 `/read`、任务按钮复用 `/tasks`、Trace 按钮复用 `/trace`、文件按钮复用 `/files` 且文件结果可一键复用 `/read`、索引按钮复用 `/index`、记忆 / 短期记忆 / 黑板按钮复用 `/memory long|short|blackboard`、快照按钮复用 `/checkpoint`、快照列表按钮复用 `/checkpoints` 且 checkpoint 结果可一键复用 `/diff` / `/restore`、历史按钮复用 `/history`、受限命令白名单按钮复用 `/commands` 且无需项目初始化、静态自检快捷按钮复用 `/smoke`、预览状态快捷按钮复用 `/preview-status`、主窗口运行时配置面板读写 Tauri 配置目录中的 `game-creator.config.json`、支持全局与每个 agent 单独选择 LLM Provider 且不把 API Key 写入聊天、聊天侧 `/capabilities` 展示标准 Agent 能力清单且不打开开发面板、聊天侧 `/audit` 从 manifest / 本地文件 / `.agent/run.latest.json` 分别汇总用户面、6 组任务配置、6 组协作证据、任务编排、loop、记忆、本地产物、HTTP 预览、画板回流和权限日志证据且不打开开发面板；未生成 `.agent/run.latest.json` 前，`/audit` 只能标记任务配置通过，不能把 6 组协作证据误判为通过；trace 已存在但状态为 `failed`、`needs-revision`、`running`、`max-passes-exhausted` 或缺少 `Evaluator passed` 步骤时，`/audit` 不能把 loop 误判为通过。聊天侧 `/llm-status` 只显示 base_url / model / API Key 已读取状态且不泄露密钥本体、聊天侧长期记忆查看 / 追加 / 覆盖 / 删除的授权本地项目路径、上传资产写入后的 manifest 刷新和 `/assets` 聊天可见性、`/smoke` 聊天侧确认后只通过授权本地项目路径执行白名单 `game.static_smoke`、`/run` 聊天侧确认后通过授权本地项目路径执行 `game.static_smoke`、启动 `127.0.0.1` 本地预览并交给外部浏览器、`/preview` 聊天侧确认后通过授权本地项目路径启动 `127.0.0.1` 本地预览并交给外部浏览器、`/status` 聊天侧项目 / 任务 / 资产 / 预览 / 最近命令汇总、`/files` 聊天侧本地项目文件列表、`/read` 聊天侧文件读取的授权本地项目路径、`/tasks` 聊天侧任务拆分与下一步专业组展示的授权本地项目路径、聊天确认生成后实时展示 Planner / Orchestrator / 角色 brief / Generator / Evaluator / 写盘 / 自检进度，并自动读取 `.agent/run.latest.json` 在普通聊天消息里展示 Run、LLM 对话、loop 轮次、工具调用、active / carry-over 任务、返工焦点、编排轮次、最近步骤、画板同步建议命令和本地产物快照、`/trace` 聊天侧读取 `.agent/run.latest.json` 并展示 loop 轮次 / active 任务 / 返工路线 / dependency waves 的授权本地项目路径、`platform-agent` 编排测试、共享契约测试、Tauri 本地能力测试和无密钥本地 provider 端到端 smoke；用于证明独立 App、真实 LLM-compatible loop、本地落盘、自检和 HTTP 预览闭环，并覆盖 loop 跑满 3 轮失败时不会写入最终游戏产物。
+- `npm run ai-game-creator-shell:check`：覆盖壳 typecheck、聊天命令单测、用户 / 开发窗口 UI 边界 smoke、主窗口命令按钮复用 `/help` 命令列表、灵感草稿只填充输入框不提交、能力按钮复用 `/capabilities`、LLM状态按钮复用 `/llm-status`、项目状态按钮复用 `/status`、权限按钮复用 `/policy` 且策略草稿按钮只填入 `/policy-confirm preview.start` / `/policy-confirm agent.run_status`、审计按钮复用 `/audit`、资产按钮复用 `/assets` 且资产结果可一键复用 `/read`、任务按钮复用 `/tasks`、Trace 按钮复用 `/trace`、文件按钮复用 `/files` 且文件结果可一键复用 `/read`、索引按钮复用 `/index`、记忆 / 短期记忆 / 黑板按钮复用 `/memory long|short|blackboard`、快照按钮复用 `/checkpoint`、快照列表按钮复用 `/checkpoints` 且 checkpoint 结果可一键复用 `/diff` / `/restore`、历史按钮复用 `/history`、受限命令白名单按钮复用 `/commands` 且无需项目初始化、静态自检快捷按钮复用 `/smoke`、预览状态快捷按钮复用 `/preview-status`、主窗口运行时配置面板读写 Tauri 配置目录中的 `game-creator.config.json`、支持全局与每个 agent 单独选择 LLM Provider 且不把 API Key 写入聊天、聊天侧 `/capabilities` 展示标准 Agent 能力清单且不打开开发面板、聊天侧 `/audit` 从 manifest / 本地文件 / `.agent/run.latest.json` 分别汇总用户面、6 组任务配置、6 组协作证据、任务编排、loop、记忆、本地产物、HTTP 预览、画板回流和权限日志证据且不打开开发面板；未生成 `.agent/run.latest.json` 前，`/audit` 只能标记任务配置通过，不能把 6 组协作证据误判为通过；trace 已存在但状态为 `failed`、`needs-revision`、`running`、`max-passes-exhausted` 或缺少 `Evaluator passed` 步骤时，`/audit` 不能把 loop 误判为通过。聊天侧 `/llm-status` 只显示 base_url / model / API Key 已读取状态且不泄露密钥本体、聊天侧长期记忆查看 / 追加 / 覆盖 / 删除的授权本地项目路径、上传资产写入后的 manifest 刷新和 `/assets` 聊天可见性、`/smoke` 聊天侧确认后只通过授权本地项目路径执行白名单 `game.static_smoke`、`/run` 聊天侧确认后通过授权本地项目路径执行 `game.static_smoke`、启动 `127.0.0.1` 本地预览并交给外部浏览器、`/preview` 聊天侧确认后通过授权本地项目路径启动 `127.0.0.1` 本地预览并交给外部浏览器、`/status` 聊天侧项目 / 任务 / 资产 / 预览 / 最近命令汇总、`/files` 聊天侧本地项目文件列表、`/read` 聊天侧文件读取的授权本地项目路径、`/tasks` 聊天侧任务拆分与下一步专业组展示的授权本地项目路径、聊天确认生成后实时展示 Planner / Orchestrator / 角色 brief / Generator / Evaluator / 写盘 / 自检进度，并自动读取 `.agent/run.latest.json` 在普通聊天消息里展示 Run、LLM 对话、loop 轮次、工具调用、active / carry-over 任务、返工焦点、编排轮次、最近步骤、画板同步建议命令和本地产物快照、`/trace` 聊天侧读取 `.agent/run.latest.json` 并展示 loop 轮次 / active 任务 / 返工路线 / dependency waves 的授权本地项目路径、`platform-agent` 编排测试、共享契约测试、Tauri 本地能力测试和无密钥本地 provider 端到端 smoke；用于证明独立 App、真实 LLM-compatible loop、本地落盘、自检和 HTTP 预览闭环，并覆盖 loop 跑满 3 轮失败时不会写入最终游戏产物。
 - 主窗口最近 checkpoint 列表展示 checkpoint id、文件数、大小和创建时间，同时提供直接对比、填入 `/diff`、确认回滚和填入 `/restore`；回滚继续走 `project.restore` 确认卡，不直接写项目文件。
 - `npm run check:native-shells`：覆盖 AI 游戏创作壳的 release/dev 窗口边界、正式用户 App 不嵌入游戏预览 iframe、用户侧预览命令交给外部浏览器和 Tauri release `--no-bundle` 构建 smoke；用于证明正式发布只登记 `launcher` 启动器窗口，选择工作区后才关闭启动器并打开 `main` 主窗口，开发面板只在 debug/dev 路径打开，独立壳能完成 release 编译。
 - `npm run check:encoding` 与 `git diff --check`：覆盖中文文档、中文命令文案和补丁空白；用于避免乱码、尾随空白和无关格式漂移。
@@ -163,6 +163,7 @@ game-project/
 - 文件选择会生成待确认的 `asset.upload` 内置命令；用户确认后才把文件写入 `assets/uploads/` 并登记到 manifest。
 - `game.generate_draft` 会从 `.agent/manifest.json` 派生本地资产摘要，把已上传、已登记和画板回流资产的 id、类型、媒体类型、本地路径、来源和画板追踪 ID 注入 Planner / 组内角色 / Generator 共用的上下文；资产摘要排在长期记忆前，避免长期记忆过长时被 prompt 截断；不新增平行资产记忆文件。
 - 聊天输入 `/help` 会在聊天里列出当前可用内置命令，普通用户不需要打开任何开发面板来发现命令；`/capabilities` 会直接列出聊天 / 上传 / 内置命令、任务拆分、编排、Planner / Generator / Evaluator loop、工具预算、多智能体协作、组内角色协作、短期 / 长期记忆、本地产物、本地 HTTP 预览、画板同步、权限 gate 和 trace 日志等标准 Agent 能力；`/audit` 会只读聚合 manifest、文件列表和最近 run trace，逐项显示当前本地项目是否已经具备这些能力证据，并区分“6 组任务已配置”“最近 run trace 已实际覆盖 6 组协作”和“最近 loop 是否真正通过 Evaluator”。
+- 主窗口“灵感草稿”只把一条可编辑的小游戏需求写入聊天输入框，不提交、不创建项目、不调用 LLM；用户仍需自行发送并确认生成命令。
 - 聊天区待确认命令必须先记录 `permission.pending`，用户点击后再记录 `permission.confirm` 或 `permission.cancel`；已授权本地项目内的权限事件同步追加到 `.agent/logs/command.log`，待确认卡片显示本地写入目标路径。
 - 聊天输入 `/status` 会读取 `.agent/manifest.json` 并在聊天里汇总项目目录、任务状态、资产数量、预览状态和最近命令，不向普通用户暴露任务或文件面板。
 - 聊天输入 `/files` 会通过 `file.list` 只读列出本地项目内的文件摘要；主窗口最近项目文件可一键读取，也可一键填入 `/read` 或 `/asset-register` 草稿，但资产登记仍必须走聊天确认；`/checkpoints` 复用 `file.list` / `file.read` 只读列出最近 checkpoint id、文件数、大小和可复制的 `/diff` / `/restore` 命令，主窗口最近 checkpoint 列表也可填入对应草稿；普通用户仍不暴露文件读写面板。