From fde0a3ae805b47f4d4132c243a1afdff9c74b540 Mon Sep 17 00:00:00 2001 From: AIGameCreator App Date: Fri, 3 Jul 2026 18:09:11 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E8=AF=95=E7=8E=A9=E5=8F=8D?= =?UTF-8?q?=E9=A6=88=E4=B8=8E=E6=95=B0=E5=80=BC=E8=81=8A=E5=A4=A9=E5=85=A5?= =?UTF-8?q?=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 /feedback 试玩反馈摘要和修改说明草稿 新增 /balance 数值与难度口径摘要 补充 /next 与 /help 的入口覆盖 同步技术方案和项目决策记录 --- apps/ai-game-creator-shell/src/App.tsx | 168 ++++++++++++++++ .../tests/appSurface.test.ts | 184 ++++++++++++++++++ .../shared-memory/decision-log.md | 4 +- ...案】AI游戏创作智能体App实施计划-2026-06-24.md | 10 +- 4 files changed, 363 insertions(+), 3 deletions(-) diff --git a/apps/ai-game-creator-shell/src/App.tsx b/apps/ai-game-creator-shell/src/App.tsx index 59553d6ae..bc8deb2eb 100644 --- a/apps/ai-game-creator-shell/src/App.tsx +++ b/apps/ai-game-creator-shell/src/App.tsx @@ -1873,6 +1873,7 @@ const chatCommandHelp = [ '/risks：查看当前项目风险', '/criteria：查看当前任务验收标准', '/groups：查看专业组进度', + '/balance：查看数值与难度口径', '/budget：查看最近 run 预算', '/qa：查看质量检查清单', '/changes：查看最近生成变更', @@ -1883,6 +1884,7 @@ const chatCommandHelp = [ '/next：查看下一步建议', '/publish：查看发布准备清单', '/playtest：查看试玩状态与下一步', + '/feedback：准备试玩反馈和修改说明', '/open-project：在系统文件管理器中显示项目目录', '/switch-project：回到项目启动器切换工作区', '/index：刷新本地项目索引', @@ -2418,6 +2420,87 @@ function summarizeProjectGroupProgress( }; } +function summarizeProjectBalanceState( + nextManifest: GameCreationAppManifest, + trace: GameCreationAgentRunTrace | null, +) { + const manifestTasks = taskRowsFromManifest(nextManifest); + const traceTasks = trace?.taskGraph.tasks ?? []; + const tasks = manifestTasks.map( + (task) => traceTasks.find((traceTask) => traceTask.id === task.id) ?? task, + ); + const balanceTasks = tasks.filter( + (task) => task.group === 'balance' || task.id.startsWith('balance-'), + ); + const readyTaskIds = new Set( + trace + ? trace.taskGraph.readyTaskIds + : selectGameCreationAppReadyTasks({ tasks }).map((task) => task.id), + ); + const activeTaskIds = new Set(trace?.taskGraph.activeTaskIds ?? []); + const carriedTaskIds = new Set(trace?.taskGraph.carriedTaskIds ?? []); + const balanceArtifact = + trace?.artifacts.find( + (artifact) => artifact.path === 'game/balance.json', + ) ?? null; + const latestBalanceStep = + trace?.steps + .filter( + (step) => + step.group === 'balance' || step.taskId?.startsWith('balance-'), + ) + .slice(-1)[0] ?? null; + const taskLines = balanceTasks.map((task) => { + const markers = [taskStatusLabels[task.status]]; + if (readyTaskIds.has(task.id)) { + markers.push('ready'); + } + if (activeTaskIds.has(task.id)) { + markers.push('active'); + } + if (carriedTaskIds.has(task.id)) { + markers.push('carry'); + } + return `- ${task.id}：${task.role} ${task.title} · ${markers.join(' / ')}`; + }); + const criteriaLines = balanceTasks.flatMap((task) => + task.acceptanceCriteria.map((criterion) => `- ${task.id}：${criterion}`), + ); + + const draftCommand = balanceArtifact + ? '/read game/balance.json' + : trace + ? '/agent-resume 数值调整：前 30 秒更易上手；得分反馈更明显；失败后重开节奏更快' + : '/next'; + + return { + text: [ + '数值状态：', + `- 项目：${nextManifest.name}`, + taskLines.length > 0 + ? `- 数值任务：\n${taskLines.join('\n')}` + : '- 数值任务：暂无', + criteriaLines.length > 0 + ? `- 数值口径：\n${criteriaLines.join('\n')}` + : '- 数值口径：暂无', + `- 数值表：${balanceArtifact ? 'game/balance.json · 已生成' : 'game/balance.json · 待生成'}`, + `- 最近数值步骤：${ + latestBalanceStep + ? `${latestBalanceStep.agent} #${latestBalanceStep.pass} · ${latestBalanceStep.status} · ${latestBalanceStep.summary}` + : '暂无' + }`, + '- 试玩关联：/playtest；/feedback', + `- 建议：${draftCommand}`, + ].join('\n'), + draftCommand, + draftCommandLabel: balanceArtifact + ? '读数值表' + : trace + ? '填写数值反馈' + : '查看下一步', + }; +} + function summarizeAgentRunBudget(trace: GameCreationAgentRunTrace | null) { if (!trace) { return { @@ -2922,6 +3005,55 @@ function summarizeProjectPlaytestState( }; } +function summarizeProjectFeedbackPrompt( + nextManifest: GameCreationAppManifest, + trace: GameCreationAgentRunTrace | null, +) { + const preview = nextManifest.preview; + const previewRunning = preview?.status === 'running' && preview.url; + const previewSummary = previewRunning + ? `运行中 ${preview.url}` + : preview + ? previewStatusLabels[preview.status] + : '未启动'; + const tracePassed = isAgentRunTracePassed(trace); + const blockedTrace = + trace?.lifecycleStatus === 'killed' || + trace?.status === 'failed' || + trace?.status === 'needs-revision' || + trace?.stopReason === 'max-passes-exhausted'; + + let draftCommand = '/next'; + let draftCommandLabel = '查看下一步'; + if (blockedTrace) { + draftCommand = '/review'; + draftCommandLabel = '查看评审'; + } else if (tracePassed && !previewRunning) { + draftCommand = '/run'; + draftCommandLabel = '启动预览'; + } else if (trace) { + draftCommand = '/agent-resume 试玩反馈：'; + draftCommandLabel = '填写试玩反馈'; + } + + return { + text: [ + '试玩反馈：', + `- 项目：${nextManifest.name}`, + trace ? `- Run：${trace.runId} · ${formatAgentRunStatus(trace)}` : null, + `- 预览：${previewSummary}${previewRunning ? '' : ' · 建议 /run'}`, + '- 反馈方向：操作手感；胜负目标；难度；视觉 / 音效；重开路径', + '- 反馈模板：/agent-resume 试玩反馈：保留…；调整…；新增…', + '- 参考：/playtest；/qa；/changes', + `- 建议：${draftCommand}`, + ] + .filter(Boolean) + .join('\n'), + draftCommand, + draftCommandLabel, + }; +} + function summarizeProjectQualityCheck( nextManifest: GameCreationAppManifest, trace: GameCreationAgentRunTrace | null, @@ -3131,6 +3263,7 @@ function summarizeNextProjectActions( } addSuggestion('查看创作目标', '/goal'); addSuggestion('查看本轮 MVP 范围', '/mvp'); + addSuggestion('查看数值与难度口径', '/balance'); const readyTasks = selectGameCreationAppReadyTasks({ tasks: taskRowsFromManifest(nextManifest), @@ -3174,6 +3307,7 @@ function summarizeNextProjectActions( if (trace) { addSuggestion('查看发布准备清单', '/publish'); addSuggestion('查看试玩状态', '/playtest'); + addSuggestion('准备试玩反馈', '/feedback'); addSuggestion('查看最近 run 预算', '/budget'); addSuggestion('查看评审和返工焦点', '/review'); addSuggestion('查看生成上下文来源', '/context'); @@ -6834,6 +6968,23 @@ export function App() { return; } + if (prompt === '/balance') { + if (!requireChatProjectForUserAction()) { + return; + } + const summary = summarizeProjectBalanceState(manifest, agentRunTrace); + setMessages((current) => [ + ...current, + { + role: 'assistant', + text: summary.text, + draftCommand: summary.draftCommand, + draftCommandLabel: summary.draftCommandLabel, + }, + ]); + return; + } + if (prompt === '/budget') { if (!requireChatProjectForUserAction()) { return; @@ -7015,6 +7166,23 @@ export function App() { return; } + if (prompt === '/feedback') { + if (!requireChatProjectForUserAction()) { + return; + } + const summary = summarizeProjectFeedbackPrompt(manifest, agentRunTrace); + setMessages((current) => [ + ...current, + { + role: 'assistant', + text: summary.text, + draftCommand: summary.draftCommand, + draftCommandLabel: summary.draftCommandLabel, + }, + ]); + return; + } + if (prompt === '/index') { void queueOrExecuteProjectIndex(); return; diff --git a/apps/ai-game-creator-shell/tests/appSurface.test.ts b/apps/ai-game-creator-shell/tests/appSurface.test.ts index eb3868e3e..750b7e873 100644 --- a/apps/ai-game-creator-shell/tests/appSurface.test.ts +++ b/apps/ai-game-creator-shell/tests/appSurface.test.ts @@ -2465,6 +2465,101 @@ describe('AI 游戏创作 App 界面边界', () => { ), ).toHaveLength(runLocalCountBeforeGroups); + const commandCountsBeforeBalance = { + manifestRead: invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ).length, + fileRead: invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ).length, + fileList: invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ).length, + runLocal: invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ).length, + startPreview: invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ).length, + openPreview: invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ).length, + exportPackage: invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ).length, + }; + submitChat('/balance'); + expect(await screen.findByText(/数值状态：/)).not.toBeNull(); + const balanceMessages = screen.getAllByText(/数值状态：/); + const balanceMessage = balanceMessages[balanceMessages.length - 1]; + expect(balanceMessage.textContent).toContain('项目：未命名游戏原型'); + expect(balanceMessage.textContent).toContain( + 'balance-director：Director 确定数值口径 · 待处理', + ); + expect(balanceMessage.textContent).toContain( + 'balance-seed：Difficulty 生成初版数值 · 待处理', + ); + expect(balanceMessage.textContent).toContain( + '难度、节奏和得分口径可指导数值表', + ); + expect(balanceMessage.textContent).toContain( + '速度、生命、得分和难度参数可被程序组读取', + ); + expect(balanceMessage.textContent).toContain( + '数值表：game/balance.json · 待生成', + ); + expect(balanceMessage.textContent).toContain( + '试玩关联：/playtest；/feedback', + ); + expect(balanceMessage.textContent).toContain( + '建议：/agent-resume 数值调整：前 30 秒更易上手；得分反馈更明显；失败后重开节奏更快', + ); + const balanceMessageList = document.querySelector('.message-list'); + expect(balanceMessageList).not.toBeNull(); + const balanceDraftButtons = within( + balanceMessageList as HTMLElement, + ).getAllByRole('button', { name: '填写数值反馈' }); + fireEvent.click(balanceDraftButtons[balanceDraftButtons.length - 1]); + expect(screen.getByLabelText('创作想法')).toHaveProperty( + 'value', + '/agent-resume 数值调整：前 30 秒更易上手；得分反馈更明显；失败后重开节奏更快', + ); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ), + ).toHaveLength(commandCountsBeforeBalance.manifestRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ), + ).toHaveLength(commandCountsBeforeBalance.fileRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ), + ).toHaveLength(commandCountsBeforeBalance.fileList); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ), + ).toHaveLength(commandCountsBeforeBalance.runLocal); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeBalance.startPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeBalance.openPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ), + ).toHaveLength(commandCountsBeforeBalance.exportPackage); + const fileReadCountBeforeBudget = invoke.mock.calls.filter( ([command]) => command === 'read_local_project_file', ).length; @@ -2927,6 +3022,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/运行自检并启动本地预览：\/run/)).not.toBeNull(); expect(screen.getByText(/查看创作目标：\/goal/)).not.toBeNull(); expect(screen.getByText(/查看本轮 MVP 范围：\/mvp/)).not.toBeNull(); + expect(screen.getByText(/查看数值与难度口径：\/balance/)).not.toBeNull(); expect(screen.getByText(/查看 .* 个 ready 任务：\/tasks/)).not.toBeNull(); expect(screen.getByText(/查看当前任务验收标准：\/criteria/)).not.toBeNull(); expect(screen.getByText(/查看专业组进度：\/groups/)).not.toBeNull(); @@ -2935,6 +3031,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/查看美术素材：\/art/)).not.toBeNull(); expect(screen.getByText(/查看发布准备清单：\/publish/)).not.toBeNull(); expect(screen.getByText(/查看试玩状态：\/playtest/)).not.toBeNull(); + expect(screen.getByText(/准备试玩反馈：\/feedback/)).not.toBeNull(); expect(screen.getByText(/查看最近 run 预算：\/budget/)).not.toBeNull(); expect(screen.getByText(/查看评审和返工焦点：\/review/)).not.toBeNull(); expect(screen.getByText(/查看生成上下文来源：\/context/)).not.toBeNull(); @@ -3069,6 +3166,89 @@ describe('AI 游戏创作 App 界面边界', () => { ), ).toHaveLength(openPreviewCountBeforePlaytest); + const commandCountsBeforeFeedback = { + manifestRead: invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ).length, + fileRead: invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ).length, + fileList: invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ).length, + runLocal: invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ).length, + startPreview: invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ).length, + openPreview: invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ).length, + exportPackage: invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ).length, + }; + submitChat('/feedback'); + const feedbackMessages = await screen.findAllByText(/试玩反馈：/); + const feedbackMessage = feedbackMessages[feedbackMessages.length - 1]; + expect(feedbackMessage.textContent).toContain( + 'Run：run-main-shortcut-trace · passed / done · 1/3 轮 · evaluator-passed', + ); + expect(feedbackMessage.textContent).toContain('预览：未启动 · 建议 /run'); + expect(feedbackMessage.textContent).toContain( + '反馈方向：操作手感；胜负目标；难度；视觉 / 音效；重开路径', + ); + expect(feedbackMessage.textContent).toContain( + '反馈模板：/agent-resume 试玩反馈：保留…；调整…；新增…', + ); + expect(feedbackMessage.textContent).toContain( + '参考：/playtest；/qa；/changes', + ); + expect(feedbackMessage.textContent).toContain('建议：/run'); + const feedbackMessageList = document.querySelector('.message-list'); + expect(feedbackMessageList).not.toBeNull(); + const feedbackDraftButtons = within( + feedbackMessageList as HTMLElement, + ).getAllByRole('button', { name: '启动预览' }); + fireEvent.click(feedbackDraftButtons[feedbackDraftButtons.length - 1]); + expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run'); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ), + ).toHaveLength(commandCountsBeforeFeedback.manifestRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ), + ).toHaveLength(commandCountsBeforeFeedback.fileRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ), + ).toHaveLength(commandCountsBeforeFeedback.fileList); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ), + ).toHaveLength(commandCountsBeforeFeedback.runLocal); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeFeedback.startPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeFeedback.openPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ), + ).toHaveLength(commandCountsBeforeFeedback.exportPackage); + fireEvent.click(screen.getByRole('button', { name: '权限' })); expect( await screen.findByText(/策略：\.agent\/policy\.json/), @@ -8834,6 +9014,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/\/risks：查看当前项目风险/)).not.toBeNull(); expect(screen.getByText(/\/criteria：查看当前任务验收标准/)).not.toBeNull(); expect(screen.getByText(/\/groups：查看专业组进度/)).not.toBeNull(); + expect(screen.getByText(/\/balance：查看数值与难度口径/)).not.toBeNull(); expect(screen.getByText(/\/budget：查看最近 run 预算/)).not.toBeNull(); expect(screen.getByText(/\/qa：查看质量检查清单/)).not.toBeNull(); expect(screen.getByText(/\/changes：查看最近生成变更/)).not.toBeNull(); @@ -8846,6 +9027,9 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/\/next：查看下一步建议/)).not.toBeNull(); expect(screen.getByText(/\/publish：查看发布准备清单/)).not.toBeNull(); expect(screen.getByText(/\/playtest：查看试玩状态与下一步/)).not.toBeNull(); + expect( + screen.getByText(/\/feedback：准备试玩反馈和修改说明/), + ).not.toBeNull(); expect( screen.getByText(/\/run-files：列出 Agent 运行辅助文件读取命令/), ).not.toBeNull(); diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 051f03638..7ca9278f0 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -3878,6 +3878,7 @@ - 2026-07-03 调整：普通用户通过聊天输入 `/context` 查看生成上下文来源，只基于当前 manifest 和最近 run trace 列出项目对话、短期记忆、长期记忆、项目黑板、Agent 对话、Agent 私有记忆、manifest、最近 trace 和最近 LLM 输入路径，并提供 `/read` 或 `/memory blackboard` 草稿；该入口不得触发 Tauri 读写、不得读取上下文文件，也不得新增普通用户上下文面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/timeline` 查看项目活动时间线，只基于当前 manifest.commandRuns 和最近 run trace 汇总最近命令、日志读取草稿和最近 Agent 步骤，并提供 `/read`、`/trace` 或 `/history` 草稿；该入口不得触发 Tauri 读写、不得读取日志或 trace 文件，也不得新增普通用户时间线面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/playtest` 查看试玩状态，只基于主窗口当前已加载的 manifest、最近 run trace 和 preview 状态派生原型是否通过、预览是否运行、Playtest 任务状态、最近试玩步骤和预览日志读取命令，并提供 `/run`、`/open-preview`、`/trace` 或 `/review` 草稿；该入口不得触发 Tauri 读写、不得启动或打开预览、不得读取日志，也不得新增普通用户试玩面板。 +- 2026-07-03 调整：普通用户通过聊天输入 `/feedback` 准备试玩反馈和修改说明，只基于当前 manifest、最近 run trace 和 preview 状态列出反馈方向、反馈模板和参考命令，并提供 `/run`、`/agent-resume 试玩反馈：`、`/review` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户反馈面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/handoff` 生成当前项目交接摘要，只基于主窗口当前已加载的 manifest、授权项目路径、最近 run trace、Agent 状态和已加载 run 历史生成交接信息，并提供 `/next` 后续草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览，也不得新增普通用户面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/runs` 查看已加载 Run 历史读取命令，只基于主窗口当前已加载的 latest trace 和最多 100 个历史 run 中已经载入的批次生成 `/trace` 或 `/read .agent/runs/...` 草稿；该入口不得额外触发 Tauri 读取、不得滚动加载更多历史、不得启动或打开预览，也不得新增普通用户面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/run-files` 查看 Agent 运行辅助文件读取命令，只列出 `.agent/output.jsonl`、`.agent/activity.jsonl` 和 `.agent/context.bundle.json` 对应 `/read` 草稿并提供首个草稿；该入口不得直接读取辅助文件、不得触发 Tauri 读写，也不得新增普通用户面板。 @@ -3886,8 +3887,9 @@ - 2026-07-03 调整：单 Agent 对话面板允许用户把当前输入手动追加到该 agent 的 `memory/agents//.md` 私有记忆；写入复用 `memory.write` 项目策略、项目锁和 Tauri 本地目录能力，不把普通对话流水自动混入私有记忆；聊天侧 `/agent-conversations` 和 `/agent-memories` 只列出同一批 Agent 对话与私有记忆读取命令并提供首个 `/read` 草稿，不直接读取文件。 - 2026-07-03 调整：普通用户通过聊天输入 `/art` 查看美术素材，只基于当前 manifest 盘点图片、视频和序列帧素材的数量、来源、画板接入状态和路径，并提供 `/generate-art 首版核心美术素材` 或 `/read assets/manifest.art.json` 草稿；该入口不得触发 Tauri 读写、平台生成、画板同步或新增普通用户美术面板。 - 2026-07-03 调整：主窗口新增音效登记和画板音频导入快捷入口，只填入 `/asset-register assets/audio/sfx.wav audio audio/wav` 或 `/import-canvas-asset assets/audio/sfx.wav ` 草稿；聊天输入 `/audio` 只基于当前 manifest 盘点音频素材、来源和路径，并给出登记音效或读取 `assets/manifest.audio.json` 的草稿。音乐组仍复用现有资产登记 / 画板回流链路，不新增独立音频生成系统。 +- 2026-07-03 调整：普通用户通过聊天输入 `/balance` 查看数值与难度口径，只基于当前 manifest.tasks、最近 run trace.taskGraph、trace artifacts 和 steps 汇总数值组任务、验收口径、`game/balance.json` 状态和最近数值步骤，并提供 `/read game/balance.json` 或 `/agent-resume 数值调整：...` 草稿；该入口不得触发 Tauri 读写、不得读取数值表、不得启动预览或继续 run，也不得新增普通用户数值面板。 - 2026-07-03 调整：主窗口新增常用生成产物读取入口，只把入口 HTML、设计、数值、美术清单、音频清单和发布说明对应的 `/read` 草稿填入聊天输入框；聊天命令 `/artifacts` 只列出同一组固定读取命令并提供首个读取草稿，`/run-artifacts` 只列出最近 trace 里的产物读取命令并提供首个 `/read` 草稿，`/logs` 只列出固定日志读取命令；实际读取仍走聊天侧 `file.read` 权限流，不直接读本地文件。 -- 2026-07-03 调整：普通用户通过聊天输入 `/next` 触发下一步建议入口，只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议，列出 `/goal`、`/mvp`、`/tasks`、`/criteria`、`/groups`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/run`、`/open-preview`、`/assets`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不得直接执行 Tauri 读写、启动或打开预览、读取本地文件，也不得绕过原有命令确认和 `file.read` 权限流。 +- 2026-07-03 调整：普通用户通过聊天输入 `/next` 触发下一步建议入口，只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议，列出 `/goal`、`/mvp`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/run`、`/open-preview`、`/assets`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不得直接执行 Tauri 读写、启动或打开预览、读取本地文件，也不得绕过原有命令确认和 `file.read` 权限流。 - 2026-07-03 调整：普通用户通过聊天输入 `/publish` 生成发布准备清单，只基于主窗口当前已加载的 manifest、最近 run trace、预览状态、资产来源和最近命令摘要列出原型通过、预览、任务、资产、音频、包装说明和试玩包状态，并提供 `/run`、`/trace`、`/agent-resume ` 或 `/export` 草稿；该入口不得触发 Tauri 读写、不得启动或打开预览、不得读取文件，也不得新增普通用户发布面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/internals` 只列出 `.agent/manifest.json`、`.agent/run.latest.json`、`.agent/spec.md`、`.agent/findings.md`、`.agent/policy.json`、`.agent/project.index.json`、`.agent/agent.db` 和 `.agent/conversations/project.jsonl` 的 `/read` 草稿，并提供首个读取草稿；该入口不得直接读取内部文件、不得触发 Tauri 读写，也不得新增普通用户内部文件面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/passes` 只从当前已加载的最近 run trace artifacts 中筛选 `.agent/passes/` 轮次产物，列出 `/read` 草稿并提供首个读取草稿；该入口不得直接读取轮次文件、不得触发 Tauri 读写，也不得新增普通用户轮次面板。 diff --git a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md index 377896d62..cb5c56484 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -105,9 +105,11 @@ game-project/ - 聊天输入 `/mvp` 可在普通聊天消息里查看本轮最小可玩范围、当前状态、试玩包状态和暂不做事项，不读取文件、不启动预览、不导出试玩包，也不新增普通用户 MVP 面板。 - 聊天输入 `/criteria` 可在普通聊天消息里查看当前任务验收标准和预期产物，不读取任务文件或 trace 文件，也不新增普通用户验收面板。 - 聊天输入 `/groups` 可在普通聊天消息里查看六个专业组进度和下一步任务，不读取任务文件或 trace 文件，也不新增普通用户专业组面板。 +- 聊天输入 `/balance` 可在普通聊天消息里查看数值与难度口径，不读取数值表、不启动预览、不直接继续 run，也不新增普通用户数值面板。 - 聊天输入 `/budget` 可在普通聊天消息里查看最近 run 轮次和工具调用预算，不读取 trace 文件，也不新增普通用户预算面板。 - 聊天输入 `/qa` 可在普通聊天消息里查看质量检查清单，不读取 trace 或日志文件、不启动或打开预览，也不新增普通用户 QA 面板。 - 聊天输入 `/changes` 可在普通聊天消息里查看最近生成变更，不读取产物或日志文件、不执行 checkpoint diff，也不新增普通用户变更面板。 +- 聊天输入 `/feedback` 可在普通聊天消息里准备试玩反馈和修改说明，不读取文件、不启动预览、不直接继续 run，也不新增普通用户反馈面板。 - 聊天输入 `/passes` 可在普通聊天消息里列出最近 run trace 中 `.agent/passes/` 轮次产物读取命令，不直接读取轮次文件，也不新增普通用户轮次面板。 - 生成代码和资产进入用户本地项目目录。 - 本地 HTTP 预览能启动，并在外部浏览器展示可玩原型。 @@ -119,12 +121,13 @@ game-project/ ## v1 验收证据矩阵 -- `npm run ai-game-creator-shell:check`：覆盖壳 typecheck、聊天命令单测、用户 / 开发窗口 UI 边界 smoke、主窗口命令按钮复用 `/help` 命令列表、主窗口项目摘要从 manifest / trace 派生任务完成数、ready 数、资产来源分布和最近命令且未选项目时不显示、灵感草稿只填充输入框不提交、能力按钮复用 `/capabilities`、LLM状态按钮复用 `/llm-status` 且结果回填 Agent 状态列表、聊天侧 `/agents` 汇总和单 Agent 对话的 provider / 模型 / 流式 / API Key 读取状态、开发日志面板只读读取 `.agent/logs/command.log` / `preview.log` / `agent.log`、项目状态按钮复用 `/status`、权限按钮复用 `/policy` 且策略草稿按钮只填入 `/policy-confirm project.index` / `/policy-confirm asset.register` / `/policy-confirm memory.write` / `/policy-confirm preview.start` / `/policy-confirm preview.open` / `/policy-confirm preview.stop` / `/policy-confirm agent.run_status` / `/policy-confirm conversation.read` / `/policy-confirm conversation.write`、审计按钮复用 `/audit`、资产按钮复用 `/assets` 且资产结果可一键复用 `/read`、任务按钮复用 `/tasks`、聊天侧 `/agents` 汇总每个 Agent 的当前状态、聊天侧 `/agent-conversations` 列出 Agent 对话读取命令、聊天侧 `/agent-memories` 列出 Agent 私有记忆读取命令、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 写入聊天、单 Agent 对话面板可手动追加私有记忆且走 `memory.write` 策略、主窗口提供音效登记、画板音频导入和常用生成产物读取草稿入口，聊天侧 `/art` 可盘点美术素材且不直接触发平台生成或画板同步，聊天侧 `/context` 可盘点生成上下文来源且不直接读取上下文文件，聊天侧 `/timeline` 可汇总项目活动时间线且不直接读取日志或 trace 文件，聊天侧 `/artifacts` 可列出常用生成产物读取命令，聊天侧 `/run-artifacts` 可列出最近 run 产物读取命令，聊天侧 `/run-files` 可列出 Agent 运行辅助文件读取命令，聊天侧 `/logs` 可列出固定日志读取命令且不直接读取日志，聊天侧 `/brief` 只基于当前已加载的 manifest / 最近 run trace / 预览状态 / 资产数量 / 最近命令生成项目简报，聊天侧 `/goal` 只基于当前 manifest.goal / 最近 run goal / taskGraph.goal 汇总创作目标来源，提供 `/next` 或 `/agent-resume 细化目标：` 后续草稿且不直接触发 Tauri 读写、文件读取、预览启动或新增面板，聊天侧 `/mvp` 只基于当前 manifest / 最近 run trace / preview / 任务 / 资产 / 最近命令汇总本轮最小可玩范围，提供 `/run` 等后续草稿且不直接触发 Tauri 读写、文件读取、预览启动、导出或新增面板，聊天侧 `/next` 基于当前已加载的 manifest / 最近 run trace 输出下一步建议和 `/goal` / `/mvp` / `/tasks` / `/criteria` / `/groups` / `/budget` / `/qa` / `/changes` / `/trace` / `/run` / `/open-preview` / `/assets` / `/art` / `/context` / `/timeline` / `/artifacts` / `/run-artifacts` / `/run-files` / `/logs` / `/agent-resume ` 等安全命令草稿方向，提供一个首选草稿且不直接触发 Tauri 读写、预览启动或文件读取，聊天侧 `/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` 命令列表、主窗口项目摘要从 manifest / trace 派生任务完成数、ready 数、资产来源分布和最近命令且未选项目时不显示、灵感草稿只填充输入框不提交、能力按钮复用 `/capabilities`、LLM状态按钮复用 `/llm-status` 且结果回填 Agent 状态列表、聊天侧 `/agents` 汇总和单 Agent 对话的 provider / 模型 / 流式 / API Key 读取状态、开发日志面板只读读取 `.agent/logs/command.log` / `preview.log` / `agent.log`、项目状态按钮复用 `/status`、权限按钮复用 `/policy` 且策略草稿按钮只填入 `/policy-confirm project.index` / `/policy-confirm asset.register` / `/policy-confirm memory.write` / `/policy-confirm preview.start` / `/policy-confirm preview.open` / `/policy-confirm preview.stop` / `/policy-confirm agent.run_status` / `/policy-confirm conversation.read` / `/policy-confirm conversation.write`、审计按钮复用 `/audit`、资产按钮复用 `/assets` 且资产结果可一键复用 `/read`、任务按钮复用 `/tasks`、聊天侧 `/agents` 汇总每个 Agent 的当前状态、聊天侧 `/agent-conversations` 列出 Agent 对话读取命令、聊天侧 `/agent-memories` 列出 Agent 私有记忆读取命令、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 写入聊天、单 Agent 对话面板可手动追加私有记忆且走 `memory.write` 策略、主窗口提供音效登记、画板音频导入和常用生成产物读取草稿入口，聊天侧 `/art` 可盘点美术素材且不直接触发平台生成或画板同步，聊天侧 `/context` 可盘点生成上下文来源且不直接读取上下文文件，聊天侧 `/timeline` 可汇总项目活动时间线且不直接读取日志或 trace 文件，聊天侧 `/artifacts` 可列出常用生成产物读取命令，聊天侧 `/run-artifacts` 可列出最近 run 产物读取命令，聊天侧 `/run-files` 可列出 Agent 运行辅助文件读取命令，聊天侧 `/logs` 可列出固定日志读取命令且不直接读取日志，聊天侧 `/brief` 只基于当前已加载的 manifest / 最近 run trace / 预览状态 / 资产数量 / 最近命令生成项目简报，聊天侧 `/goal` 只基于当前 manifest.goal / 最近 run goal / taskGraph.goal 汇总创作目标来源，提供 `/next` 或 `/agent-resume 细化目标：` 后续草稿且不直接触发 Tauri 读写、文件读取、预览启动或新增面板，聊天侧 `/mvp` 只基于当前 manifest / 最近 run trace / preview / 任务 / 资产 / 最近命令汇总本轮最小可玩范围，提供 `/run` 等后续草稿且不直接触发 Tauri 读写、文件读取、预览启动、导出或新增面板，聊天侧 `/feedback` 只基于当前 manifest / 最近 run trace / preview 准备试玩反馈模板和修改说明草稿且不直接触发 Tauri 读写、预览启动或继续 run，聊天侧 `/next` 基于当前已加载的 manifest / 最近 run trace 输出下一步建议和 `/goal` / `/mvp` / `/tasks` / `/criteria` / `/groups` / `/budget` / `/qa` / `/changes` / `/trace` / `/run` / `/open-preview` / `/feedback` / `/assets` / `/art` / `/context` / `/timeline` / `/artifacts` / `/run-artifacts` / `/run-files` / `/logs` / `/agent-resume ` 等安全命令草稿方向，提供一个首选草稿且不直接触发 Tauri 读写、预览启动或文件读取，聊天侧 `/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 轮失败时不会写入最终游戏产物。 - `/risks` 聊天入口由 `appSurface.test.ts` 的主窗口 smoke 覆盖：只基于当前已加载的 manifest / trace / 预览 / 任务 / 资产 / 最近命令生成风险摘要，提供首个风险处理草稿，不触发 Tauri 读写、文件读取、预览启动或新增普通用户面板。 - `/goal` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.goal、最近 run goal 和 taskGraph.goal 汇总创作目标来源，提供 `/agent-resume 细化目标：` 或 `/next` 草稿，不触发 Tauri 读写、不读取 spec / 上下文 / trace 文件、不新增普通用户目标面板。 - `/mvp` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、任务、资产和最近命令汇总 MVP 内、当前状态、试玩包状态和暂不做事项，提供 `/review`、`/criteria`、`/trace`、`/run`、`/export`、`/exports` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不新增普通用户 MVP 面板。 - `/criteria` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.tasks 和最近 run trace.taskGraph 汇总 active、carry、ready、失败或待处理任务的验收条件和产物，提供 `/tasks` 草稿，不触发 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户验收面板。 - `/groups` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.tasks 和最近 run trace.taskGraph / passPlans 汇总六个专业组的完成、active、carry、ready、失败数量和下一步任务，提供 `/tasks` 草稿，不触发 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户专业组面板。 +- `/balance` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.tasks、最近 run trace.taskGraph、trace artifacts 和 steps 汇总数值组任务、验收口径、`game/balance.json` 状态和最近数值步骤，提供 `/read game/balance.json` 或 `/agent-resume 数值调整：...` 草稿，不触发 Tauri 读写、不读取数值表、不启动预览或继续 run、不新增普通用户数值面板。 - `/budget` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载最近 run trace 汇总轮次、工具调用、stopReason 和下一步建议，提供 `/review`、`/publish`、`/trace` 或 `/next` 草稿，不触发 Tauri 读写、不读取 trace 文件或新增普通用户预算面板。 - `/qa` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、最近命令和 preview 状态汇总 Evaluator、任务、静态自检、试玩和产物状态，提供 `/review`、`/tasks`、`/trace`、`/playtest`、`/publish` 或 `/next` 草稿，不触发 Tauri 读写、不读取 trace 或日志文件、不启动或打开预览、不新增普通用户 QA 面板。 - `/changes` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 的 artifacts / steps 和最近命令汇总可验产物、最近输出、当前资产和真实差异查看方向，提供 `/read <首个可验产物>` 或 `/run-artifacts` 草稿，不触发 Tauri 读写、不读取产物或日志文件、不执行 checkpoint diff、不新增普通用户变更面板。 @@ -132,6 +135,7 @@ game-project/ - `/context` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest 和最近 run trace 列出项目对话、短期 / 长期记忆、黑板、Agent 对话、Agent 私有记忆、manifest、最近 trace 和最近 LLM 输入路径，提供 `/read` 或 `/memory blackboard` 草稿，不触发 Tauri 读写、不读取上下文文件或新增普通用户面板。 - `/timeline` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest.commandRuns 和最近 run trace 汇总最近命令、日志读取草稿和最近 Agent 步骤，提供 `/read`、`/trace` 或 `/history` 草稿，不触发 Tauri 读写、不读取日志或 trace 文件、不新增普通用户时间线面板。 - `/playtest` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 和 preview 状态汇总是否可试玩、Playtest 任务状态和预览日志读取命令，提供 `/run`、`/open-preview`、`/trace` 或 `/review` 草稿，不触发 Tauri 读写、预览启动 / 打开或新增普通用户试玩面板。 +- `/feedback` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 和 preview 状态列出反馈方向、反馈模板和参考命令，提供 `/run`、`/agent-resume 试玩反馈：`、`/review` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户反馈面板。 - `/handoff` 聊天入口由 `appSurface.test.ts` 的主窗口 smoke 覆盖：只基于当前已加载的 manifest / trace / agent 状态 / run history 生成交接摘要，提供 `/next` 草稿，不触发 Tauri 读写、文件读取、预览启动或新增普通用户面板。 - `/runs` 聊天入口由 `appSurface.test.ts` 的主窗口 smoke 覆盖：只基于当前已加载的 latest trace 和已载入历史 run 批次生成 `/trace` 或 `/read .agent/runs/...` 草稿，不额外触发 Tauri 读取、不滚动加载更多历史、不新增普通用户面板。 - `/run-files` 聊天入口由 `appSurface.test.ts` 的主窗口 smoke 覆盖：只列出 `.agent/output.jsonl`、`.agent/activity.jsonl` 和 `.agent/context.bundle.json` 的 `/read` 草稿，不直接读取辅助文件、不触发 Tauri 读写或新增普通用户面板。 @@ -211,16 +215,18 @@ game-project/ - 聊天输入 `/risks` 只使用主窗口当前已加载的 manifest、最近 run trace、预览状态、任务状态、资产来源和最近命令摘要，在聊天里列出当前项目风险，并提供首个风险处理草稿；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。 - 聊天输入 `/criteria` 只使用主窗口当前已加载的 manifest.tasks 和最近 run trace.taskGraph，在聊天里列出 active、carry、ready、失败或待处理任务的验收条件和预期产物，并提供 `/tasks` 草稿；该命令不调用 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户验收面板，真正查看完整任务仍由用户发送 `/tasks` 并走原读取流。 - 聊天输入 `/groups` 只使用主窗口当前已加载的 manifest.tasks 和最近 run trace.taskGraph / passPlans，在聊天里列出六个专业组的完成、active、carry、ready、失败数量和下一步任务，并提供 `/tasks` 草稿；该命令不调用 Tauri 读写、不读取任务文件或 trace 文件、不新增普通用户专业组面板，真正查看完整任务仍由用户发送 `/tasks` 并走原读取流。 +- 聊天输入 `/balance` 只使用主窗口当前已加载的 manifest.tasks、最近 run trace.taskGraph、trace artifacts 和 steps，在聊天里列出数值组任务、验收口径、`game/balance.json` 状态、最近数值步骤和试玩关联；该命令不调用 Tauri 读写、不读取数值表、不启动预览、不直接继续 run、不新增普通用户数值面板，真正读取或提交数值反馈仍由用户发送对应草稿并走原权限流。 - 聊天输入 `/budget` 只使用主窗口当前已加载的最近 run trace，在聊天里列出轮次、工具调用、stopReason 和下一步建议，并提供 `/review`、`/publish`、`/trace` 或 `/next` 草稿；该命令不调用 Tauri 读写、不读取 trace 文件、不新增普通用户预算面板，真正查看完整 trace 仍由用户发送 `/trace` 并走原读取流。 - 聊天输入 `/qa` 只使用主窗口当前已加载的 manifest、最近 run trace、最近命令和 preview 状态，在聊天里列出 Evaluator、任务、静态自检、试玩、最近试玩步骤和产物数量，并提供 `/review`、`/tasks`、`/trace`、`/playtest`、`/publish` 或 `/next` 草稿；该命令不调用 Tauri 读写、不读取 trace 或日志文件、不启动或打开预览、不新增普通用户 QA 面板，真正运行自检或打开预览仍由用户发送对应草稿并走原确认流。 - 聊天输入 `/changes` 只使用主窗口当前已加载的 manifest、最近 run trace 的 artifacts / steps 和最近命令，在聊天里列出最近 run、可验产物数量、关键产物、最近输出、当前资产、全部产物读取入口、trace 入口和真实 diff 查看方向，并提供 `/read <首个可验产物>` 或 `/run-artifacts` 草稿；该命令不调用 Tauri 读写、不读取产物或日志文件、不执行 checkpoint diff、不新增普通用户变更面板，真正读取产物或对比 checkpoint 仍由用户发送对应草稿并走原权限流。 - 聊天输入 `/handoff` 只使用主窗口当前已加载的 manifest、最近 run trace、Agent 状态和已载入历史 run 批次，在聊天里生成项目交接摘要，并提供 `/next` 作为后续草稿；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。 - 聊天输入 `/runs` 只使用主窗口当前已加载的 latest trace 和已载入历史 run 批次，在聊天里列出 `/trace` 和 `/read .agent/runs/...` 读取草稿；该命令不调用 Tauri 读写、不滚动加载更多历史、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。 -- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要，在聊天里给出下一步建议，列出 `/goal`、`/mvp`、`/tasks`、`/criteria`、`/groups`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/run`、`/export`、`/exports`、`/open-preview`、`/assets`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不调用 Tauri 读写、不启动或打开预览、不读取文件，用户必须再发送草稿并按原命令权限流继续。 +- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要，在聊天里给出下一步建议，列出 `/goal`、`/mvp`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/run`、`/export`、`/exports`、`/open-preview`、`/assets`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向，并提供一个首选草稿；该命令不调用 Tauri 读写、不启动或打开预览、不读取文件，用户必须再发送草稿并按原命令权限流继续。 - 聊天输入 `/review` 只使用主窗口当前已加载的最近 run trace，在聊天里列出 Evaluator 通过 / 需返工状态、返工焦点、返工路线、下一步和最近评审步骤；该命令不调用 Tauri 读写、不读取 `.agent/findings.md`、不新增普通用户评审面板，真正读取评审记录仍由用户发送 `/read .agent/findings.md` 并走 `file.read` 权限流，需要返工时只填入 `/agent-resume ` 草稿。 - 聊天输入 `/context` 只使用主窗口当前已加载的 manifest 和最近 run trace，在聊天里列出项目对话、短期记忆、长期记忆、项目黑板、Agent 对话、Agent 私有记忆、manifest、最近 trace 和最近 LLM 输入路径；该命令不调用 Tauri 读写、不读取上下文文件、不新增普通用户上下文面板，真正查看上下文仍由用户发送 `/read` 或 `/memory blackboard` 并走原权限流。 - 聊天输入 `/timeline` 只使用主窗口当前已加载的 manifest.commandRuns 和最近 run trace，在聊天里列出最近命令、日志读取草稿、最近 Run 状态和最近 Agent 步骤；该命令不调用 Tauri 读写、不读取日志或 trace 文件、不新增普通用户时间线面板，真正查看日志、trace 或历史仍由用户发送对应草稿并走原权限流。 - 聊天输入 `/playtest` 只使用主窗口当前已加载的 manifest、最近 run trace 和 preview 状态，在聊天里列出原型是否已通过、预览是否运行、Playtest 任务状态、最近试玩步骤和 `.agent/logs/preview.log` 读取命令；该命令不调用 Tauri 读写、不启动或打开预览、不读取日志、不新增普通用户试玩面板，真正运行或打开仍由用户发送 `/run` 或 `/open-preview` 并走原确认流。 +- 聊天输入 `/feedback` 只使用主窗口当前已加载的 manifest、最近 run trace 和 preview 状态，在聊天里列出反馈方向、反馈模板和参考命令；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户反馈面板，真正提交反馈仍由用户发送 `/agent-resume 试玩反馈：` 并走原确认流。 - 聊天输入 `/passes` 只使用主窗口当前已加载的最近 run trace，从 `artifacts` 中筛选 `.agent/passes/` 相对路径，在聊天里列出轮次产物读取命令并提供首个 `/read` 草稿；该命令不调用 Tauri 读写、不读取文件、不新增普通用户轮次面板，真正读取仍由用户发送 `/read` 并走 `file.read` 权限流。 - 聊天输入 `/internals` 只列出项目内部真相源读取命令，覆盖 `.agent/manifest.json`、`.agent/run.latest.json`、`.agent/spec.md`、`.agent/findings.md`、`.agent/policy.json`、`.agent/project.index.json`、`.agent/agent.db` 和 `.agent/conversations/project.jsonl`；该命令不调用 Tauri 读写、不读取文件、不新增普通用户内部文件面板，真正读取仍由用户发送 `/read` 并走 `file.read` 权限流。 - 聊天输入 `/publish` 只使用主窗口当前已加载的 manifest、最近 run trace、预览状态、资产来源和最近命令摘要，在聊天里生成发布准备清单，列出原型通过状态、预览、任务、资产、音频、包装说明和试玩包导出状态，并提供 `/run`、`/trace`、`/agent-resume ` 或 `/export` 草稿；该命令不调用 Tauri 读写、不启动或打开预览、不读取文件、不新增普通用户面板，真正导出仍由用户发送 `/export` 并走确认流。