From 6d2e1ffb3af965d664d16a38032054fb46e0ff79 Mon Sep 17 00:00:00 2001 From: AIGameCreator App Date: Sat, 4 Jul 2026 13:47:53 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E5=85=BC=E5=AE=B9=E6=80=A7?= =?UTF-8?q?=E8=AF=B4=E6=98=8E=E8=81=8A=E5=A4=A9=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 /compatibility 兼容性说明摘要 补充 /next 与 /help 的兼容性入口覆盖 验证 /compatibility 不触发文件读取、运行、预览或导出 同步 AI 游戏创作 App 技术方案和决策记录 --- apps/ai-game-creator-shell/src/App.tsx | 105 ++++++++++++++++ .../tests/appSurface.test.ts | 119 ++++++++++++++++++ .../shared-memory/decision-log.md | 3 +- ...案】AI游戏创作智能体App实施计划-2026-06-24.md | 4 +- 4 files changed, 229 insertions(+), 2 deletions(-) diff --git a/apps/ai-game-creator-shell/src/App.tsx b/apps/ai-game-creator-shell/src/App.tsx index c908d262b..6118e1c68 100644 --- a/apps/ai-game-creator-shell/src/App.tsx +++ b/apps/ai-game-creator-shell/src/App.tsx @@ -1876,6 +1876,7 @@ const chatCommandHelp = [ '/rules：查看玩法操作与规则', '/tutorial：查看新手引导检查', '/mobile：查看移动试玩检查', + '/compatibility：准备兼容性说明', '/accessibility：查看可读性与无障碍检查', '/performance：查看性能与加载检查', '/polish：查看试玩前打磨清单', @@ -2653,6 +2654,89 @@ function summarizeProjectMobilePlaytestGuide( }; } +function summarizeProjectCompatibilityNotes( + 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'; + const goal = + nextManifest.goal?.trim() || + trace?.goal?.trim() || + trace?.taskGraph.goal?.trim() || + '暂无'; + const commandRuns = nextManifest.commandRuns ?? []; + const staticSmokePassed = + commandRuns.some( + (commandRun) => + commandRun.commandId === 'game.static_smoke' && + commandRun.status === 'completed', + ) || + Boolean( + trace?.steps.some((step) => + step.toolCalls.some( + (toolCall) => + toolCall.toolId === 'game.static_smoke' && toolCall.status === 'ok', + ), + ), + ); + const inputSummary = tracePassed + ? '键盘优先；触屏按 /mobile 复查' + : '待原型通过后复查键盘 / 触屏'; + + let draftCommand = '/mobile'; + let draftCommandLabel = '查看移动试玩'; + if (!trace) { + draftCommand = '/next'; + draftCommandLabel = '查看下一步'; + } else if (blockedTrace) { + draftCommand = '/review'; + draftCommandLabel = '查看评审'; + } else if (!tracePassed) { + draftCommand = '/trace'; + draftCommandLabel = '查看 trace'; + } else if (!previewRunning) { + draftCommand = '/run'; + draftCommandLabel = '启动试玩'; + } + + return { + text: [ + '兼容性说明：', + `- 项目：${nextManifest.name}`, + `- 目标：${goal}`, + `- 当前状态：${ + tracePassed + ? `最近 run 已通过${trace?.runId ? ` ${trace.runId}` : ''}` + : trace + ? `最近 run 未通过 ${trace.status} / ${trace.stopReason}` + : '暂无最近 run' + }；预览 ${previewSummary}`, + `- 自检：${staticSmokePassed ? 'game.static_smoke 已通过' : '未见静态自检通过'}`, + `- 输入兼容：${inputSummary}`, + '- 推荐环境：桌面 Chrome / Edge 最新版；本机 127.0.0.1 预览；移动浏览器只做早期体验', + '- 不承诺：旧浏览器、低端设备、离线模式、云存档、账号同步、手柄或多端数据一致', + '- 反馈口径：设备 / 浏览器 / 输入方式 / 截图或录屏；问题记录走 /bug-report', + '- 参考：/mobile；/accessibility；/performance；/known-issues', + '- 边界：只准备兼容性说明；不读取文件；不启动或打开预览；不导出试玩包；不上传云端；不发布作品；不写项目', + `- 建议：${draftCommand}`, + ].join('\n'), + draftCommand, + draftCommandLabel, + }; +} + function summarizeProjectAccessibilityGuide( nextManifest: GameCreationAppManifest, trace: GameCreationAgentRunTrace | null, @@ -5981,6 +6065,7 @@ function summarizeNextProjectActions( addSuggestion('查看玩法操作与规则', '/rules'); addSuggestion('查看新手引导检查', '/tutorial'); addSuggestion('查看移动试玩检查', '/mobile'); + addSuggestion('准备兼容性说明', '/compatibility'); addSuggestion('查看可读性与无障碍检查', '/accessibility'); addSuggestion('查看性能与加载检查', '/performance'); addSuggestion('查看试玩前打磨清单', '/polish'); @@ -9827,6 +9912,26 @@ export function App() { return; } + if (prompt === '/compatibility') { + if (!requireChatProjectForUserAction()) { + return; + } + const summary = summarizeProjectCompatibilityNotes( + manifest, + agentRunTrace, + ); + setMessages((current) => [ + ...current, + { + role: 'assistant', + text: summary.text, + draftCommand: summary.draftCommand, + draftCommandLabel: summary.draftCommandLabel, + }, + ]); + return; + } + if (prompt === '/accessibility' || prompt === '/a11y') { 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 8767b1dc1..fb650f77c 100644 --- a/apps/ai-game-creator-shell/tests/appSurface.test.ts +++ b/apps/ai-game-creator-shell/tests/appSurface.test.ts @@ -2955,6 +2955,123 @@ describe('AI 游戏创作 App 界面边界', () => { ), ).toHaveLength(commandCountsBeforeMobile.exportList); + const commandCountsBeforeCompatibility = { + 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, + exportList: invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_export_packages', + ).length, + controlAgentRun: invoke.mock.calls.filter( + ([command]) => command === 'control_agent_run', + ).length, + }; + submitChat('/compatibility'); + const compatibilityMessages = await screen.findAllByText(/兼容性说明：/); + const compatibilityMessage = + compatibilityMessages[compatibilityMessages.length - 1]; + expect(compatibilityMessage.textContent).toContain('项目：未命名游戏原型'); + expect(compatibilityMessage.textContent).toContain( + '目标：做一个厨房弹幕游戏', + ); + expect(compatibilityMessage.textContent).toContain( + '当前状态：最近 run 已通过 run-main-shortcut-trace；预览 未启动', + ); + expect(compatibilityMessage.textContent).toContain( + '自检：game.static_smoke 已通过', + ); + expect(compatibilityMessage.textContent).toContain( + '输入兼容：键盘优先；触屏按 /mobile 复查', + ); + expect(compatibilityMessage.textContent).toContain( + '推荐环境：桌面 Chrome / Edge 最新版；本机 127.0.0.1 预览；移动浏览器只做早期体验', + ); + expect(compatibilityMessage.textContent).toContain( + '不承诺：旧浏览器、低端设备、离线模式、云存档、账号同步、手柄或多端数据一致', + ); + expect(compatibilityMessage.textContent).toContain( + '反馈口径：设备 / 浏览器 / 输入方式 / 截图或录屏；问题记录走 /bug-report', + ); + expect(compatibilityMessage.textContent).toContain( + '参考：/mobile；/accessibility；/performance；/known-issues', + ); + expect(compatibilityMessage.textContent).toContain( + '边界：只准备兼容性说明；不读取文件；不启动或打开预览；不导出试玩包；不上传云端；不发布作品；不写项目', + ); + expect(compatibilityMessage.textContent).toContain('建议：/run'); + const compatibilityMessageList = document.querySelector('.message-list'); + expect(compatibilityMessageList).not.toBeNull(); + const compatibilityDraftButtons = within( + compatibilityMessageList as HTMLElement, + ).getAllByRole('button', { name: '启动试玩' }); + fireEvent.click( + compatibilityDraftButtons[compatibilityDraftButtons.length - 1], + ); + expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run'); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ), + ).toHaveLength(commandCountsBeforeCompatibility.manifestRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ), + ).toHaveLength(commandCountsBeforeCompatibility.fileRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ), + ).toHaveLength(commandCountsBeforeCompatibility.fileList); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ), + ).toHaveLength(commandCountsBeforeCompatibility.runLocal); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeCompatibility.startPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeCompatibility.openPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ), + ).toHaveLength(commandCountsBeforeCompatibility.exportPackage); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_export_packages', + ), + ).toHaveLength(commandCountsBeforeCompatibility.exportList); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'control_agent_run', + ), + ).toHaveLength(commandCountsBeforeCompatibility.controlAgentRun); + const commandCountsBeforeAccessibility = { manifestRead: invoke.mock.calls.filter( ([command]) => command === 'get_local_game_manifest', @@ -4726,6 +4843,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/查看玩法操作与规则：\/rules/)).not.toBeNull(); expect(screen.getByText(/查看新手引导检查：\/tutorial/)).not.toBeNull(); expect(screen.getByText(/查看移动试玩检查：\/mobile/)).not.toBeNull(); + expect(screen.getByText(/准备兼容性说明：\/compatibility/)).not.toBeNull(); expect( screen.getByText(/查看可读性与无障碍检查：\/accessibility/), ).not.toBeNull(); @@ -12466,6 +12584,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/\/rules：查看玩法操作与规则/)).not.toBeNull(); expect(screen.getByText(/\/tutorial：查看新手引导检查/)).not.toBeNull(); expect(screen.getByText(/\/mobile：查看移动试玩检查/)).not.toBeNull(); + expect(screen.getByText(/\/compatibility：准备兼容性说明/)).not.toBeNull(); expect( screen.getByText(/\/accessibility：查看可读性与无障碍检查/), ).not.toBeNull(); diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 8d8745470..33cd07f39 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -3874,6 +3874,7 @@ - 2026-07-03 调整：普通用户通过聊天输入 `/rules` 查看玩法操作与规则，只基于当前 manifest、最近 run trace.taskGraph、trace artifacts 和 steps 汇总玩法目标、操作 / 胜负 / 重开口径、设计与入口产物状态、相关任务和最近程序 / 试玩步骤，并提供 `/read game/game_design.md`、`/agent-resume 操作说明：...` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取设计文件、不得启动预览或继续 run，也不得新增普通用户规则面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/tutorial` 查看新手引导检查，只基于当前 manifest、最近 run trace、preview 和任务状态汇总首屏目标、首局 30 秒引导、原型证据、试玩任务、最近引导证据和补齐项，并提供 `/rules`、`/review`、`/agent-resume 新手引导：...`、`/open-preview` 或 `/run` 草稿；该入口不得触发 Tauri 读写、不得读取设计文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户引导面板。 - 2026-07-03 调整：普通用户通过聊天输入 `/mobile` 查看移动试玩检查，只基于当前 manifest、最近 run trace、preview 和任务状态汇总移动试玩目标、键盘 / 触屏输入口径、原型证据、移动检查项、关联任务和最近移动相关步骤，并提供 `/rules`、`/review`、`/agent-resume 移动试玩：...`、`/open-preview` 或 `/run` 草稿；该入口不得触发 Tauri 读写、不得读取代码文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户移动适配面板。 +- 2026-07-04 调整：普通用户通过聊天输入 `/compatibility` 准备兼容性说明，只基于当前 manifest、最近 run trace、preview 和静态自检状态汇总推荐环境、输入兼容、不承诺范围、反馈口径和参考命令，并提供 `/run`、`/mobile`、`/review`、`/trace` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得导出试玩包、不得上传云端、不得发布作品、不得写项目，也不得新增普通用户兼容性面板。 - 2026-07-04 调整：普通用户通过聊天输入 `/accessibility` 查看可读性与无障碍检查，只基于当前 manifest、最近 run trace、preview 和任务状态汇总文字可读、颜色对比、按钮 / 状态命名、键盘等价、可见焦点、非颜色唯一反馈和静音可玩检查，并提供 `/rules`、`/review`、`/agent-resume 可读性与无障碍：...`、`/open-preview` 或 `/run` 草稿；该入口不得触发 Tauri 读写、不得读取代码或 trace 文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户无障碍面板。 - 2026-07-04 调整：普通用户通过聊天输入 `/performance` 查看性能与加载检查，只基于当前 manifest、最近 run trace、preview、资产数量和 trace artifact 摘要汇总入口自包含、首屏不空白、素材体积、主循环稳定、无远程依赖和预览启动检查，并提供 `/run-artifacts`、`/review`、`/open-preview`、`/run` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取产物或日志文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户性能面板。 - 2026-07-04 调整：普通用户通过聊天输入 `/polish` 查看试玩前打磨清单，只基于当前 manifest、最近 run trace、preview、最近自检和资产数量汇总试玩前打磨范围、推荐检查顺序、关联任务和最近打磨相关步骤，并提供 `/agent-resume 打磨：...`、`/review`、`/feedback` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动预览、不得导出试玩包、不得写项目，也不得新增普通用户打磨面板。 @@ -3921,7 +3922,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`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/ready`、`/deps`、`/revise`、`/privacy`、`/audience`、`/invite`、`/bug-report`、`/survey`、`/cover`、`/screenshots`、`/trailer`、`/faq`、`/post`、`/store`、`/media-kit`、`/release-notes`、`/known-issues`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/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 调整，2026-07-04 更新：普通用户通过聊天输入 `/next` 触发下一步建议入口，只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议，列出 `/goal`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/compatibility`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/ready`、`/deps`、`/revise`、`/privacy`、`/audience`、`/invite`、`/bug-report`、`/survey`、`/cover`、`/screenshots`、`/trailer`、`/faq`、`/post`、`/store`、`/media-kit`、`/release-notes`、`/known-issues`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/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 dad1bb27d..2a8d108f2 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -109,6 +109,7 @@ game-project/ - 聊天输入 `/rules` 可在普通聊天消息里查看玩法操作与规则口径，不读取设计文件、不启动预览、不直接继续 run，也不新增普通用户规则面板。 - 聊天输入 `/tutorial` 可在普通聊天消息里查看新手引导检查，不读取设计文件、不启动或打开预览、不直接继续 run，也不新增普通用户引导面板。 - 聊天输入 `/mobile` 可在普通聊天消息里查看移动试玩检查，不读取代码文件、不启动或打开预览、不直接继续 run，也不新增普通用户移动适配面板。 +- 聊天输入 `/compatibility` 可在普通聊天消息里准备兼容性说明，不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目，也不新增普通用户兼容性面板。 - 聊天输入 `/accessibility` 可在普通聊天消息里查看可读性与无障碍检查，不读取代码或 trace 文件、不启动或打开预览、不直接继续 run，也不新增普通用户无障碍面板。 - 聊天输入 `/performance` 可在普通聊天消息里查看性能与加载检查，不读取产物或日志文件、不启动或打开预览、不直接继续 run，也不新增普通用户性能面板。 - 聊天输入 `/polish` 可在普通聊天消息里查看试玩前打磨清单，不读取文件、不启动预览、不导出试玩包、不写项目，也不新增普通用户打磨面板。 @@ -163,6 +164,7 @@ game-project/ - `/rules` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace.taskGraph、trace artifacts 和 steps 汇总玩法目标、操作 / 胜负 / 重开口径、设计与入口产物状态、相关任务和最近程序 / 试玩步骤，提供 `/read game/game_design.md`、`/agent-resume 操作说明：...` 或 `/next` 草稿，不触发 Tauri 读写、不读取设计文件、不启动预览或继续 run、不新增普通用户规则面板。 - `/tutorial` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和任务状态汇总首屏目标、首局 30 秒引导、原型证据、试玩任务、最近引导证据和补齐项，提供 `/rules`、`/review`、`/agent-resume 新手引导：...`、`/open-preview` 或 `/run` 草稿，不触发 Tauri 读写、不读取设计文件、不启动或打开预览、不直接继续 run、不新增普通用户引导面板。 - `/mobile` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和任务状态汇总移动试玩目标、键盘 / 触屏输入口径、原型证据、移动检查项、关联任务和最近移动相关步骤，提供 `/rules`、`/review`、`/agent-resume 移动试玩：...`、`/open-preview` 或 `/run` 草稿，不触发 Tauri 读写、不读取代码文件、不启动或打开预览、不直接继续 run、不新增普通用户移动适配面板。 +- `/compatibility` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和静态自检状态准备推荐环境、输入兼容、不承诺范围、反馈口径和参考命令，提供 `/run`、`/mobile`、`/review`、`/trace` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目、不新增普通用户兼容性面板。 - `/accessibility` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和任务状态汇总文字可读、颜色对比、按钮 / 状态命名、键盘等价、可见焦点、非颜色唯一反馈和静音可玩检查项，提供 `/rules`、`/review`、`/agent-resume 可读性与无障碍：...`、`/open-preview` 或 `/run` 草稿，不触发 Tauri 读写、不读取代码或 trace 文件、不启动或打开预览、不直接继续 run、不新增普通用户无障碍面板。 - `/performance` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、资产数量和 trace artifact 摘要汇总入口自包含、首屏不空白、素材体积、主循环稳定、无远程依赖和预览启动检查，提供 `/run-artifacts`、`/review`、`/open-preview`、`/run` 或 `/next` 草稿，不触发 Tauri 读写、不读取产物或日志文件、不启动或打开预览、不直接继续 run、不新增普通用户性能面板。 - `/polish` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、最近自检和资产数量汇总试玩前打磨范围、推荐检查顺序、关联任务和最近打磨相关步骤，提供 `/agent-resume 打磨：...`、`/review`、`/feedback` 或 `/next` 草稿，不触发 Tauri 读写、不读取文件、不启动预览、不导出试玩包、不写项目、不新增普通用户打磨面板。 @@ -301,7 +303,7 @@ game-project/ - 聊天输入 `/todo` 只使用主窗口当前已加载的 manifest 和最近 run trace，在聊天里列出下一轮优先小步，优先失败、active、carry 和 ready 任务，没有 trace 时回退当前 ready 任务，并提供 `/tasks`、`/review` 或 `/next` 草稿；该命令不调用 Tauri 读写、不读取任务文件、不启动 run、不修改项目、不新增普通用户小步面板，真正查看任务或继续修复仍由用户发送对应草稿并走原权限流。 - 聊天输入 `/handoff` 只使用主窗口当前已加载的 manifest、最近 run trace、Agent 状态和已载入历史 run 批次，在聊天里生成项目交接摘要，并提供 `/next` 作为后续草稿；该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。 - 聊天输入 `/runs` 只使用主窗口当前已加载的 latest trace 和已载入历史 run 批次，在聊天里列出 `/trace` 和 `/read .agent/runs/...` 读取草稿；该命令不调用 Tauri 读写、不滚动加载更多历史、不启动或打开预览、不新增普通用户面板，用户必须再发送草稿并按原命令权限流继续。 -- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要，在聊天里给出下一步建议，列出 `/goal`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/ready`、`/deps`、`/revise`、`/privacy`、`/audience`、`/invite`、`/bug-report`、`/survey`、`/cover`、`/screenshots`、`/trailer`、`/faq`、`/post`、`/store`、`/media-kit`、`/release-notes`、`/known-issues`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/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 读写、不启动或打开预览、不读取文件，用户必须再发送草稿并按原命令权限流继续。 +- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要，在聊天里给出下一步建议，列出 `/goal`、`/spec`、`/mvp`、`/pitch`、`/demo`、`/rules`、`/tutorial`、`/mobile`、`/compatibility`、`/accessibility`、`/performance`、`/polish`、`/blockers`、`/ready`、`/deps`、`/revise`、`/privacy`、`/audience`、`/invite`、`/bug-report`、`/survey`、`/cover`、`/screenshots`、`/trailer`、`/faq`、`/post`、`/store`、`/media-kit`、`/release-notes`、`/known-issues`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/todo`、`/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 或历史仍由用户发送对应草稿并走原权限流。