diff --git a/apps/ai-game-creator-shell/src/App.tsx b/apps/ai-game-creator-shell/src/App.tsx index 05a95b7d7..4fcf07d92 100644 --- a/apps/ai-game-creator-shell/src/App.tsx +++ b/apps/ai-game-creator-shell/src/App.tsx @@ -1891,6 +1891,7 @@ const chatCommandHelp = [ '/publish:查看发布准备清单', '/listing:准备作品页文案清单', '/playtest:查看试玩状态与下一步', + '/test-plan:准备手动测试计划', '/feedback:准备试玩反馈和修改说明', '/share:准备试玩交付清单', '/open-project:在系统文件管理器中显示项目目录', @@ -3715,6 +3716,93 @@ function summarizeProjectPlaytestState( }; } +function summarizeProjectManualTestPlan( + nextManifest: GameCreationAppManifest, + trace: GameCreationAgentRunTrace | null, +) { + const tasks = taskRowsFromManifest(nextManifest); + const traceTasks = trace?.taskGraph.tasks ?? []; + const taskRows = tasks.map( + (task) => traceTasks.find((traceTask) => traceTask.id === task.id) ?? task, + ); + const taskLines = ['preview-readiness', 'preview-playtest'] + .map((taskId) => taskRows.find((task) => task.id === taskId)) + .filter((task): task is NonNullable => Boolean(task)) + .map( + (task) => + `- ${task.id}:${taskGroupLabels[task.group]} / ${task.role} ${task.title} · ${taskStatusLabels[task.status]}`, + ); + 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'; + const goal = + nextManifest.goal?.trim() || + trace?.goal?.trim() || + trace?.taskGraph.goal?.trim() || + '暂无'; + const hasGameArtifact = + trace?.artifacts.some( + (artifact) => + artifact.path === 'game/index.html' || artifact.path === 'game/', + ) ?? false; + const latestPlaytestStep = + trace?.steps.filter(isPlaytestTraceStep).slice(-1)[0] ?? null; + + let draftCommand = '/next'; + let draftCommandLabel = '查看下一步'; + if (blockedTrace) { + draftCommand = '/review'; + draftCommandLabel = '查看评审'; + } else if (trace && !tracePassed) { + draftCommand = '/trace'; + draftCommandLabel = '查看 trace'; + } else if (previewRunning) { + draftCommand = '/open-preview'; + draftCommandLabel = '打开预览'; + } else if (tracePassed) { + draftCommand = '/run'; + draftCommandLabel = '启动试玩'; + } + + return { + text: [ + '手动测试计划:', + `- 项目:${nextManifest.name}`, + `- 目标:${goal}`, + `- 当前证据:${ + tracePassed + ? `最近 run 已通过${trace?.runId ? ` ${trace.runId}` : ''}` + : trace + ? `最近 run 未通过 ${trace.status} / ${trace.stopReason}` + : '暂无最近 run' + };预览 ${previewSummary};入口 ${hasGameArtifact ? '已生成' : '未见 trace 产物'}`, + '- 用例:\n1. 启动预览:/run 后确认首屏不空白\n2. 30 秒理解:目标、操作、得分/失败和重开可见\n3. 输入验证:键盘/点击/触屏至少一种可完成核心动作\n4. 结局验证:胜利或失败后可重开\n5. 回归检查:/mobile;/accessibility;/performance;/audio', + taskLines.length > 0 + ? `- 关联任务:\n${taskLines.join('\n')}` + : '- 关联任务:暂无', + `- 最近试玩证据:${ + latestPlaytestStep + ? `${latestPlaytestStep.agent} #${latestPlaytestStep.pass} · ${latestPlaytestStep.status} · ${latestPlaytestStep.summary}` + : '暂无' + }`, + '- 记录反馈:/feedback', + `- 建议:${draftCommand}`, + ].join('\n'), + draftCommand, + draftCommandLabel, + }; +} + function summarizeProjectFeedbackPrompt( nextManifest: GameCreationAppManifest, trace: GameCreationAgentRunTrace | null, @@ -4103,6 +4191,7 @@ function summarizeNextProjectActions( addSuggestion('查看发布准备清单', '/publish'); addSuggestion('准备作品页文案清单', '/listing'); addSuggestion('查看试玩状态', '/playtest'); + addSuggestion('准备手动测试计划', '/test-plan'); addSuggestion('准备试玩反馈', '/feedback'); addSuggestion('准备试玩交付清单', '/share'); addSuggestion('查看最近 run 预算', '/budget'); @@ -8151,6 +8240,23 @@ export function App() { return; } + if (prompt === '/test-plan') { + if (!requireChatProjectForUserAction()) { + return; + } + const summary = summarizeProjectManualTestPlan(manifest, agentRunTrace); + setMessages((current) => [ + ...current, + { + role: 'assistant', + text: summary.text, + draftCommand: summary.draftCommand, + draftCommandLabel: summary.draftCommandLabel, + }, + ]); + return; + } + if (prompt === '/feedback') { if (!requireChatProjectForUserAction()) { return; diff --git a/apps/ai-game-creator-shell/tests/appSurface.test.ts b/apps/ai-game-creator-shell/tests/appSurface.test.ts index 0830cf1e2..849cf515d 100644 --- a/apps/ai-game-creator-shell/tests/appSurface.test.ts +++ b/apps/ai-game-creator-shell/tests/appSurface.test.ts @@ -3791,6 +3791,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/查看发布准备清单:\/publish/)).not.toBeNull(); expect(screen.getByText(/准备作品页文案清单:\/listing/)).not.toBeNull(); expect(screen.getByText(/查看试玩状态:\/playtest/)).not.toBeNull(); + expect(screen.getByText(/准备手动测试计划:\/test-plan/)).not.toBeNull(); expect(screen.getByText(/准备试玩反馈:\/feedback/)).not.toBeNull(); expect(screen.getByText(/准备试玩交付清单:\/share/)).not.toBeNull(); expect(screen.getByText(/查看最近 run 预算:\/budget/)).not.toBeNull(); @@ -4032,6 +4033,103 @@ describe('AI 游戏创作 App 界面边界', () => { ), ).toHaveLength(openPreviewCountBeforePlaytest); + const commandCountsBeforeTestPlan = { + 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('/test-plan'); + const testPlanMessages = await screen.findAllByText(/手动测试计划:/); + const testPlanMessage = testPlanMessages[testPlanMessages.length - 1]; + expect(testPlanMessage.textContent).toContain('项目:未命名游戏原型'); + expect(testPlanMessage.textContent).toContain('目标:做一个厨房弹幕游戏'); + expect(testPlanMessage.textContent).toContain( + '当前证据:最近 run 已通过 run-main-shortcut-trace;预览 未启动;入口 未见 trace 产物', + ); + expect(testPlanMessage.textContent).toContain( + '1. 启动预览:/run 后确认首屏不空白', + ); + expect(testPlanMessage.textContent).toContain( + '2. 30 秒理解:目标、操作、得分/失败和重开可见', + ); + expect(testPlanMessage.textContent).toContain( + '3. 输入验证:键盘/点击/触屏至少一种可完成核心动作', + ); + expect(testPlanMessage.textContent).toContain( + '4. 结局验证:胜利或失败后可重开', + ); + expect(testPlanMessage.textContent).toContain( + '5. 回归检查:/mobile;/accessibility;/performance;/audio', + ); + expect(testPlanMessage.textContent).toContain( + 'preview-readiness:程序组 / Preview 执行静态自检 · 待处理', + ); + expect(testPlanMessage.textContent).toContain( + 'preview-playtest:程序组 / Playtest 预览并试玩验收 · 待处理', + ); + expect(testPlanMessage.textContent).toContain('记录反馈:/feedback'); + expect(testPlanMessage.textContent).toContain('建议:/run'); + const testPlanMessageList = document.querySelector('.message-list'); + expect(testPlanMessageList).not.toBeNull(); + const testPlanDraftButtons = within( + testPlanMessageList as HTMLElement, + ).getAllByRole('button', { name: '启动试玩' }); + fireEvent.click(testPlanDraftButtons[testPlanDraftButtons.length - 1]); + expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run'); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ), + ).toHaveLength(commandCountsBeforeTestPlan.manifestRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ), + ).toHaveLength(commandCountsBeforeTestPlan.fileRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ), + ).toHaveLength(commandCountsBeforeTestPlan.fileList); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ), + ).toHaveLength(commandCountsBeforeTestPlan.runLocal); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeTestPlan.startPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeTestPlan.openPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ), + ).toHaveLength(commandCountsBeforeTestPlan.exportPackage); + const commandCountsBeforeFeedback = { manifestRead: invoke.mock.calls.filter( ([command]) => command === 'get_local_game_manifest', @@ -9999,6 +10097,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/\/publish:查看发布准备清单/)).not.toBeNull(); expect(screen.getByText(/\/listing:准备作品页文案清单/)).not.toBeNull(); expect(screen.getByText(/\/playtest:查看试玩状态与下一步/)).not.toBeNull(); + expect(screen.getByText(/\/test-plan:准备手动测试计划/)).not.toBeNull(); expect( screen.getByText(/\/feedback:准备试玩反馈和修改说明/), ).not.toBeNull(); diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 4ce60a22a..c4587269a 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -3885,6 +3885,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-04 调整:普通用户通过聊天输入 `/test-plan` 准备手动测试计划,只基于主窗口当前已加载的 manifest、最近 run trace 和 preview 状态汇总手动用例、关联 Preview / Playtest 任务和最近试玩证据,并提供 `/run`、`/open-preview`、`/trace`、`/review` 或 `/next` 草稿;该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得直接继续 run,也不得新增普通用户测试面板。 - 2026-07-03 调整:普通用户通过聊天输入 `/feedback` 准备试玩反馈和修改说明,只基于当前 manifest、最近 run trace 和 preview 状态列出反馈方向、反馈模板和参考命令,并提供 `/run`、`/agent-resume 试玩反馈:`、`/review` 或 `/next` 草稿;该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得直接继续 run,也不得新增普通用户反馈面板。 - 2026-07-03 调整:普通用户通过聊天输入 `/listing` 准备作品页文案清单,只基于当前 manifest、最近 run trace、发布组任务和资产清单汇总标题、一句话卖点、标签口径、封面素材、发布说明和最近运营步骤,并提供 `/read exports/README.md`、`/review`、`/art`、`/publish` 或 `/next` 草稿;该入口不得触发 Tauri 读写、不得读取发布说明、不得上传云端、不得发布作品,也不得新增普通用户作品页面板。 - 2026-07-03 调整:普通用户通过聊天输入 `/handoff` 生成当前项目交接摘要,只基于主窗口当前已加载的 manifest、授权项目路径、最近 run trace、Agent 状态和已加载 run 历史生成交接信息,并提供 `/next` 后续草稿;该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览,也不得新增普通用户面板。 @@ -3898,7 +3899,7 @@ - 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 调整:普通用户通过聊天输入 `/share` 准备试玩交付清单,只基于当前 manifest、授权项目路径、最近 run trace、preview 状态和 manifest.commandRuns 汇总原型通过状态、本地预览、本地试玩包、测试者说明和反馈收集方向,并提供 `/export`、`/exports`、`/trace`、`/review` 或 `/next` 草稿;该入口不得触发 Tauri 读写、不得导出试玩包、不得列出历史包、不得上传云端、不得生成公开分享链接,也不得新增普通用户分享面板。 -- 2026-07-03 调整,2026-07-04 更新:普通用户通过聊天输入 `/next` 触发下一步建议入口,只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议,列出 `/goal`、`/mvp`、`/pitch`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/listing`、`/run`、`/open-preview`、`/assets`、`/credits`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向,并提供一个首选草稿;该命令不得直接执行 Tauri 读写、启动或打开预览、读取本地文件,也不得绕过原有命令确认和 `file.read` 权限流。 +- 2026-07-03 调整,2026-07-04 更新:普通用户通过聊天输入 `/next` 触发下一步建议入口,只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议,列出 `/goal`、`/mvp`、`/pitch`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/share`、`/listing`、`/run`、`/open-preview`、`/assets`、`/credits`、`/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 087f25321..ae2fcdf49 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -116,6 +116,7 @@ game-project/ - 聊天输入 `/budget` 可在普通聊天消息里查看最近 run 轮次和工具调用预算,不读取 trace 文件,也不新增普通用户预算面板。 - 聊天输入 `/qa` 可在普通聊天消息里查看质量检查清单,不读取 trace 或日志文件、不启动或打开预览,也不新增普通用户 QA 面板。 - 聊天输入 `/changes` 可在普通聊天消息里查看最近生成变更,不读取产物或日志文件、不执行 checkpoint diff,也不新增普通用户变更面板。 +- 聊天输入 `/test-plan` 可在普通聊天消息里准备手动测试计划,不读取文件、不启动或打开预览、不直接继续 run,也不新增普通用户测试面板。 - 聊天输入 `/feedback` 可在普通聊天消息里准备试玩反馈和修改说明,不读取文件、不启动预览、不直接继续 run,也不新增普通用户反馈面板。 - 聊天输入 `/share` 可在普通聊天消息里准备试玩交付清单,不导出试玩包、不列出历史包、不上传云端,也不新增普通用户分享面板。 - 聊天输入 `/listing` 可在普通聊天消息里准备作品页文案清单,不读取发布说明、不上传云端、不发布作品,也不新增普通用户作品页面板。 @@ -151,6 +152,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 读写、预览启动 / 打开或新增普通用户试玩面板。 +- `/test-plan` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace 和 preview 状态准备手动测试用例、关联任务和试玩证据,提供 `/run`、`/open-preview`、`/trace`、`/review` 或 `/next` 草稿,不触发 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户测试面板。 - `/feedback` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace 和 preview 状态列出反馈方向、反馈模板和参考命令,提供 `/run`、`/agent-resume 试玩反馈:`、`/review` 或 `/next` 草稿,不触发 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户反馈面板。 - `/share` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、授权项目路径、最近 run trace、preview 状态和 manifest.commandRuns 汇总原型通过状态、本地预览、本地试玩包、测试者说明和反馈收集方向,提供 `/export`、`/exports`、`/trace`、`/review` 或 `/next` 草稿,不触发 Tauri 读写、不导出试玩包、不列出历史包、不上传云端、不生成公开分享链接、不新增普通用户分享面板。 - `/listing` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 manifest、最近 run trace、发布组任务和资产清单汇总作品页标题、卖点、标签口径、封面素材、发布说明和最近运营步骤,提供 `/read exports/README.md`、`/review`、`/art`、`/publish` 或 `/next` 草稿,不触发 Tauri 读写、不读取发布说明、不上传云端、不发布作品、不新增普通用户作品页面板。 @@ -246,11 +248,12 @@ game-project/ - 聊天输入 `/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`、`/pitch`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/listing`、`/run`、`/export`、`/exports`、`/open-preview`、`/assets`、`/credits`、`/art`、`/audio`、`/publish`、`/artifacts`、`/run-artifacts`、`/passes`、`/run-files`、`/internals`、`/logs`、`/agent-resume ` 等安全命令草稿方向,并提供一个首选草稿;该命令不调用 Tauri 读写、不启动或打开预览、不读取文件,用户必须再发送草稿并按原命令权限流继续。 +- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要,在聊天里给出下一步建议,列出 `/goal`、`/mvp`、`/pitch`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/test-plan`、`/feedback`、`/share`、`/listing`、`/run`、`/export`、`/exports`、`/open-preview`、`/assets`、`/credits`、`/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` 并走原确认流。 +- 聊天输入 `/test-plan` 只使用主窗口当前已加载的 manifest、最近 run trace 和 preview 状态,在聊天里列出手动测试用例、Preview / Playtest 任务和最近试玩证据;该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户测试面板,真正运行、打开预览或记录反馈仍由用户发送对应草稿并走原权限流。 - 聊天输入 `/feedback` 只使用主窗口当前已加载的 manifest、最近 run trace 和 preview 状态,在聊天里列出反馈方向、反馈模板和参考命令;该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不直接继续 run、不新增普通用户反馈面板,真正提交反馈仍由用户发送 `/agent-resume 试玩反馈:` 并走原确认流。 - 聊天输入 `/share` 只使用主窗口当前已加载的 manifest、授权项目路径、最近 run trace、preview 状态和 manifest.commandRuns,在聊天里列出原型通过状态、本地预览、本地试玩包、给测试者的简短说明和反馈收集方向;该命令不调用 Tauri 读写、不导出试玩包、不列出历史包、不上传云端、不生成公开分享链接、不新增普通用户分享面板,真正导出或查看试玩包仍由用户发送 `/export` 或 `/exports` 并走原权限流。 - 聊天输入 `/listing` 只使用主窗口当前已加载的 manifest、最近 run trace、发布组任务和资产清单,在聊天里列出作品页标题、一句话卖点、发布任务、封面素材、说明文案、标签口径和最近运营步骤;该命令不调用 Tauri 读写、不读取发布说明、不上传云端、不发布作品、不新增普通用户作品页面板,真正读取发布说明或继续发布准备仍由用户发送 `/read exports/README.md` 或 `/publish` 并走原权限流。