From 6ce4a68ece1a5279f065427e5ec076ef90cfb922 Mon Sep 17 00:00:00 2001 From: AIGameCreator App Date: Fri, 3 Jul 2026 18:28:44 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E8=AF=95=E7=8E=A9=E4=BA=A4?= =?UTF-8?q?=E4=BB=98=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 新增 /share 试玩交付清单摘要 补充 /next 与 /help 的交付入口覆盖 同步 AI 游戏创作 App 技术方案和决策记录 校准项目权限确认提示测试 --- apps/ai-game-creator-shell/src/App.tsx | 101 ++++++++++++++++++ .../tests/appSurface.test.ts | 99 ++++++++++++++++- .../shared-memory/decision-log.md | 3 +- ...案】AI游戏创作智能体App实施计划-2026-06-24.md | 5 +- 4 files changed, 205 insertions(+), 3 deletions(-) diff --git a/apps/ai-game-creator-shell/src/App.tsx b/apps/ai-game-creator-shell/src/App.tsx index 1f83bfea0..7b0f26e57 100644 --- a/apps/ai-game-creator-shell/src/App.tsx +++ b/apps/ai-game-creator-shell/src/App.tsx @@ -1886,6 +1886,7 @@ const chatCommandHelp = [ '/publish：查看发布准备清单', '/playtest：查看试玩状态与下一步', '/feedback：准备试玩反馈和修改说明', + '/share：准备试玩交付清单', '/open-project：在系统文件管理器中显示项目目录', '/switch-project：回到项目启动器切换工作区', '/index：刷新本地项目索引', @@ -3157,6 +3158,83 @@ function summarizeProjectFeedbackPrompt( }; } +function summarizeProjectShareHandoff( + nextManifest: GameCreationAppManifest, + nextProjectPath: string, + trace: GameCreationAgentRunTrace | null, +) { + const tracePassed = isAgentRunTracePassed(trace); + const blockedTrace = + trace?.lifecycleStatus === 'killed' || + trace?.status === 'failed' || + trace?.status === 'needs-revision' || + trace?.stopReason === 'max-passes-exhausted'; + const preview = nextManifest.preview; + const previewRunning = preview?.status === 'running' && preview.url; + const previewSummary = previewRunning + ? `运行中 ${preview.url}` + : preview + ? previewStatusLabels[preview.status] + : '未启动'; + const commandRuns = nextManifest.commandRuns ?? []; + const latestExportCommand = + [...commandRuns] + .reverse() + .find( + (commandRun) => commandRun.commandId === 'project.export_package', + ) ?? null; + const packageSummary = + latestExportCommand?.status === 'completed' + ? '最近导出完成 · /exports' + : latestExportCommand?.status === 'failed' + ? '最近导出失败 · /logs' + : tracePassed + ? '待导出 · /export' + : '等待最近 run 通过'; + + let draftCommand = '/next'; + let draftCommandLabel = '查看下一步'; + if (blockedTrace) { + draftCommand = '/review'; + draftCommandLabel = '查看评审'; + } else if (!trace) { + draftCommand = '/next'; + draftCommandLabel = '查看下一步'; + } else if (!tracePassed) { + draftCommand = '/trace'; + draftCommandLabel = '查看 trace'; + } else if (latestExportCommand?.status === 'completed') { + draftCommand = '/exports'; + draftCommandLabel = '查看试玩包'; + } else { + draftCommand = '/export'; + draftCommandLabel = '导出试玩包'; + } + + return { + text: [ + '试玩交付：', + `- 项目：${nextManifest.name}`, + `- 目录：${nextProjectPath}`, + `- 原型：${ + tracePassed + ? `最近 run 已通过 ${trace?.runId ?? ''}`.trim() + : trace + ? `最近 run 未通过 ${trace.status} / ${trace.stopReason}` + : '暂无最近 run' + }`, + `- 本地预览：${previewSummary}${previewRunning ? ' · /open-preview' : ' · /run'}`, + `- 本地试玩包：${packageSummary}`, + '- 给测试者：玩法目标 / 操作 / 胜负 / 重开口径见 /rules', + '- 反馈收集：/feedback', + '- 交付边界：本地 ZIP 和本地预览；不上传云端；不生成公开分享链接', + `- 建议：${draftCommand}`, + ].join('\n'), + draftCommand, + draftCommandLabel, + }; +} + function summarizeProjectQualityCheck( nextManifest: GameCreationAppManifest, trace: GameCreationAgentRunTrace | null, @@ -3412,6 +3490,7 @@ function summarizeNextProjectActions( addSuggestion('查看发布准备清单', '/publish'); addSuggestion('查看试玩状态', '/playtest'); addSuggestion('准备试玩反馈', '/feedback'); + addSuggestion('准备试玩交付清单', '/share'); addSuggestion('查看最近 run 预算', '/budget'); addSuggestion('查看评审和返工焦点', '/review'); addSuggestion('查看生成上下文来源', '/context'); @@ -7304,6 +7383,28 @@ export function App() { return; } + if (prompt === '/share') { + const nextProjectPath = requireChatProjectForUserAction(); + if (!nextProjectPath) { + return; + } + const summary = summarizeProjectShareHandoff( + manifest, + nextProjectPath, + 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 1e446330e..446c254d6 100644 --- a/apps/ai-game-creator-shell/tests/appSurface.test.ts +++ b/apps/ai-game-creator-shell/tests/appSurface.test.ts @@ -3135,6 +3135,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect(screen.getByText(/查看发布准备清单：\/publish/)).not.toBeNull(); expect(screen.getByText(/查看试玩状态：\/playtest/)).not.toBeNull(); expect(screen.getByText(/准备试玩反馈：\/feedback/)).not.toBeNull(); + expect(screen.getByText(/准备试玩交付清单：\/share/)).not.toBeNull(); expect(screen.getByText(/查看最近 run 预算：\/budget/)).not.toBeNull(); expect(screen.getByText(/查看评审和返工焦点：\/review/)).not.toBeNull(); expect(screen.getByText(/查看生成上下文来源：\/context/)).not.toBeNull(); @@ -3352,6 +3353,101 @@ describe('AI 游戏创作 App 界面边界', () => { ), ).toHaveLength(commandCountsBeforeFeedback.exportPackage); + const commandCountsBeforeShare = { + 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, + }; + submitChat('/share'); + const shareMessages = await screen.findAllByText(/试玩交付：/); + const shareMessage = shareMessages[shareMessages.length - 1]; + expect(shareMessage.textContent).toContain('项目：未命名游戏原型'); + expect(shareMessage.textContent).toContain('目录：/tmp/authorized-game'); + expect(shareMessage.textContent).toContain( + '原型：最近 run 已通过 run-main-shortcut-trace', + ); + expect(shareMessage.textContent).toContain('本地预览：未启动 · /run'); + expect(shareMessage.textContent).toContain('本地试玩包：待导出 · /export'); + expect(shareMessage.textContent).toContain( + '给测试者：玩法目标 / 操作 / 胜负 / 重开口径见 /rules', + ); + expect(shareMessage.textContent).toContain('反馈收集：/feedback'); + expect(shareMessage.textContent).toContain( + '交付边界：本地 ZIP 和本地预览；不上传云端；不生成公开分享链接', + ); + expect(shareMessage.textContent).toContain('建议：/export'); + const shareMessageList = document.querySelector('.message-list'); + expect(shareMessageList).not.toBeNull(); + const shareDraftButtons = within( + shareMessageList as HTMLElement, + ).getAllByRole('button', { name: '导出试玩包' }); + fireEvent.click(shareDraftButtons[shareDraftButtons.length - 1]); + expect(screen.getByLabelText('创作想法')).toHaveProperty( + 'value', + '/export', + ); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'get_local_game_manifest', + ), + ).toHaveLength(commandCountsBeforeShare.manifestRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'read_local_project_file', + ), + ).toHaveLength(commandCountsBeforeShare.fileRead); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_files', + ), + ).toHaveLength(commandCountsBeforeShare.fileList); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'run_limited_local_command', + ), + ).toHaveLength(commandCountsBeforeShare.runLocal); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'start_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeShare.startPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'open_local_game_preview', + ), + ).toHaveLength(commandCountsBeforeShare.openPreview); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'export_local_project_package', + ), + ).toHaveLength(commandCountsBeforeShare.exportPackage); + expect( + invoke.mock.calls.filter( + ([command]) => command === 'list_local_project_export_packages', + ), + ).toHaveLength(commandCountsBeforeShare.exportList); + fireEvent.click(screen.getByRole('button', { name: '权限' })); expect( await screen.findByText(/策略：\.agent\/policy\.json/), @@ -9134,6 +9230,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect( screen.getByText(/\/feedback：准备试玩反馈和修改说明/), ).not.toBeNull(); + expect(screen.getByText(/\/share：准备试玩交付清单/)).not.toBeNull(); expect( screen.getByText(/\/run-files：列出 Agent 运行辅助文件读取命令/), ).not.toBeNull(); @@ -11806,7 +11903,7 @@ describe('AI 游戏创作 App 界面边界', () => { expect( await screen.findByText( - '当前仅支持确认 project.index、project.status、project.checkpoint、project.diff、project.restore、file.list、file.read、memory.read、memory.write、memory.delete、asset.register、asset.list、task.list、agent.run_status、agent.kill、agent.retry、agent.resume、agent.audit、agent.trace_read、preview.status、preview.start、preview.open、preview.stop、canvas.project_sync、canvas.asset_import、canvas.asset_generate、canvas.export_import、conversation.read 和 conversation.write。', + '当前仅支持确认 project.index、project.status、project.checkpoint、project.diff、project.restore、project.export_package、project.export_list、file.list、file.read、memory.read、memory.write、memory.delete、asset.register、asset.list、task.list、agent.run_status、agent.kill、agent.retry、agent.resume、agent.audit、agent.trace_read、preview.status、preview.start、preview.open、preview.stop、canvas.project_sync、canvas.asset_import、canvas.asset_generate、canvas.export_import、conversation.read 和 conversation.write。', ), ).not.toBeNull(); expect(screen.queryByText('project.policy_write')).toBeNull(); diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 7045a1af9..57d680783 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -3890,7 +3890,8 @@ - 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`、`/rules`、`/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 调整：普通用户通过聊天输入 `/share` 准备试玩交付清单，只基于当前 manifest、授权项目路径、最近 run trace、preview 状态和 manifest.commandRuns 汇总原型通过状态、本地预览、本地试玩包、测试者说明和反馈收集方向，并提供 `/export`、`/exports`、`/trace`、`/review` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得导出试玩包、不得列出历史包、不得上传云端、不得生成公开分享链接，也不得新增普通用户分享面板。 +- 2026-07-03 调整：普通用户通过聊天输入 `/next` 触发下一步建议入口，只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议，列出 `/goal`、`/mvp`、`/rules`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/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 b961e895d..12a3888cc 100644 --- a/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md +++ b/docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md @@ -111,6 +111,7 @@ game-project/ - 聊天输入 `/qa` 可在普通聊天消息里查看质量检查清单，不读取 trace 或日志文件、不启动或打开预览，也不新增普通用户 QA 面板。 - 聊天输入 `/changes` 可在普通聊天消息里查看最近生成变更，不读取产物或日志文件、不执行 checkpoint diff，也不新增普通用户变更面板。 - 聊天输入 `/feedback` 可在普通聊天消息里准备试玩反馈和修改说明，不读取文件、不启动预览、不直接继续 run，也不新增普通用户反馈面板。 +- 聊天输入 `/share` 可在普通聊天消息里准备试玩交付清单，不导出试玩包、不列出历史包、不上传云端，也不新增普通用户分享面板。 - 聊天输入 `/passes` 可在普通聊天消息里列出最近 run trace 中 `.agent/passes/` 轮次产物读取命令，不直接读取轮次文件，也不新增普通用户轮次面板。 - 生成代码和资产进入用户本地项目目录。 - 本地 HTTP 预览能启动，并在外部浏览器展示可玩原型。 @@ -138,6 +139,7 @@ game-project/ - `/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、不新增普通用户反馈面板。 +- `/share` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、授权项目路径、最近 run trace、preview 状态和 manifest.commandRuns 汇总原型通过状态、本地预览、本地试玩包、测试者说明和反馈收集方向，提供 `/export`、`/exports`、`/trace`、`/review` 或 `/next` 草稿，不触发 Tauri 读写、不导出试玩包、不列出历史包、不上传云端、不生成公开分享链接、不新增普通用户分享面板。 - `/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 读写或新增普通用户面板。 @@ -224,12 +226,13 @@ 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`、`/rules`、`/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 读写、不启动或打开预览、不读取文件，用户必须再发送草稿并按原命令权限流继续。 +- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要，在聊天里给出下一步建议，列出 `/goal`、`/mvp`、`/rules`、`/tasks`、`/criteria`、`/groups`、`/balance`、`/budget`、`/qa`、`/changes`、`/trace`、`/review`、`/context`、`/timeline`、`/playtest`、`/feedback`、`/share`、`/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 试玩反馈：` 并走原确认流。 +- 聊天输入 `/share` 只使用主窗口当前已加载的 manifest、授权项目路径、最近 run trace、preview 状态和 manifest.commandRuns，在聊天里列出原型通过状态、本地预览、本地试玩包、给测试者的简短说明和反馈收集方向；该命令不调用 Tauri 读写、不导出试玩包、不列出历史包、不上传云端、不生成公开分享链接、不新增普通用户分享面板，真正导出或查看试玩包仍由用户发送 `/export` 或 `/exports` 并走原权限流。 - 聊天输入 `/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` 并走确认流。