GenarrativeAI/Genarrative
11
0
Fork 0
Code Issues 15 Pull Requests 3 Actions Packages Projects 3 Releases Wiki Activity

补充复玩观察聊天入口

Browse Source 
新增 /retention 首轮复玩和留存观察摘要

补充 /next 与 /help 的复玩观察入口覆盖

验证 /retention 不触发文件读取、运行、预览、导出或写入

同步 AI 游戏创作 App 技术方案和决策记录
This commit is contained in:
AIGameCreator App
2026-07-04 14:05:08 +08:00
parent 14e92e477f
commit 608764d974
4 changed files with 252 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/ai-game-creator-shell/src/App.tsx
+130
View File
@@ -1917,6 +1917,7 @@ const chatCommandHelp = [
'/playtest：查看试玩状态与下一步',
'/test-plan：准备手动测试计划',
'/feedback：准备试玩反馈和修改说明',
'/retention：准备首轮复玩/留存观察清单',
'/share：准备试玩交付清单',
'/open-project：在系统文件管理器中显示项目目录',
'/switch-project：回到项目启动器切换工作区',
@@ -5874,6 +5875,114 @@ function summarizeProjectFeedbackPrompt(
};
}
function summarizeProjectRetentionSignals(
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 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 latestExportCommand =
[...commandRuns]
.reverse()
.find(
(commandRun) => commandRun.commandId === 'project.export_package',
) ?? null;
const packageSummary =
latestExportCommand?.status === 'completed'
? '最近导出完成'
: latestExportCommand?.status === 'failed'
? '最近导出失败'
: tracePassed
? '待导出'
: '等待原型通过';
const goal =
nextManifest.goal?.trim() ||
trace?.goal?.trim() ||
trace?.taskGraph.goal?.trim() ||
'暂无';
const latestPlaytestStep =
trace?.steps.filter(isPlaytestTraceStep).slice(-1)[0] ?? null;
const hasReleaseNotes =
trace?.artifacts.some((artifact) => artifact.path === 'exports/README.md') ??
false;
let draftCommand = '/next';
let draftCommandLabel = '查看下一步';
if (blockedTrace) {
draftCommand = '/review';
draftCommandLabel = '查看评审';
} else if (trace && !tracePassed) {
draftCommand = '/trace';
draftCommandLabel = '查看 trace';
} else if (tracePassed && !previewRunning) {
draftCommand = '/run';
draftCommandLabel = '启动试玩';
} else if (trace) {
draftCommand = '/feedback';
draftCommandLabel = '准备反馈';
}
return {
text: [
'复玩观察：',
`- 项目：${nextManifest.name}`,
`- 目标：${goal}`,
`- 当前状态：${
tracePassed
? `最近 run 已通过${trace?.runId ? ` ${trace.runId}` : ''}`
: trace
? `最近 run 未通过 ${trace.status} / ${trace.stopReason}`
: '暂无最近 run'
}；预览 ${previewSummary}；自检 ${
staticSmokePassed ? '已通过' : '未见通过'
}；试玩包 ${packageSummary}`,
'- 首轮样本：3-5 名测试者；每人 5-10 分钟；先不解释玩法，观察是否能自己完成首局',
'- 复玩信号：是否主动重开；失败后是否理解原因；第二局是否更快进入目标；是否愿意换难度/角色/关卡；是否能说出想保留的一点',
`- 资产与包装：素材 ${nextManifest.assets.length} 个；发布说明 ${
hasReleaseNotes ? '已生成' : '未见 trace 产物'
}`,
`- 最近试玩证据：${
latestPlaytestStep
? `${latestPlaytestStep.agent} #${latestPlaytestStep.pass} · ${latestPlaytestStep.status} · ${latestPlaytestStep.summary}`
: '暂无'
}`,
'- 记录模板：保留 1 项；调弱/调强 1 项；新增 1 项；必须修 1 项；是否愿意再玩一局',
'- 暂不做：真实埋点；留存报表；用户画像；A/B 实验；排行榜或账号留存',
'- 参考：/playtest；/feedback；/survey；/share；/known-issues',
'- 边界：只准备复玩观察清单；不读取文件；不启动或打开预览；不导出试玩包；不上传云端；不发布作品；不写项目',
`- 建议：${draftCommand}`,
].join('\n'),
draftCommand,
draftCommandLabel,
};
}
function summarizeProjectShareHandoff(
nextManifest: GameCreationAppManifest,
nextProjectPath: string,
@@ -6239,6 +6348,7 @@ function summarizeNextProjectActions(
addSuggestion('查看试玩状态', '/playtest');
addSuggestion('准备手动测试计划', '/test-plan');
addSuggestion('准备试玩反馈', '/feedback');
addSuggestion('准备复玩观察清单', '/retention');
addSuggestion('准备试玩交付清单', '/share');
addSuggestion('查看最近 run 预算', '/budget');
addSuggestion('查看评审和返工焦点', '/review');
@@ -10745,6 +10855,26 @@ export function App() {
return;
}
if (prompt === '/retention') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeProjectRetentionSignals(
manifest,
agentRunTrace,
);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/share') {
const nextProjectPath = requireChatProjectForUserAction();
if (!nextProjectPath) {
apps/ai-game-creator-shell/tests/appSurface.test.ts
+117
View File
@@ -5019,6 +5019,7 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(screen.getByText(/查看试玩状态：\/playtest/)).not.toBeNull();
expect(screen.getByText(/准备手动测试计划：\/test-plan/)).not.toBeNull();
expect(screen.getByText(/准备试玩反馈：\/feedback/)).not.toBeNull();
expect(screen.getByText(/准备复玩观察清单：\/retention/)).not.toBeNull();
expect(screen.getByText(/准备试玩交付清单：\/share/)).not.toBeNull();
expect(screen.getByText(/查看最近 run 预算：\/budget/)).not.toBeNull();
expect(screen.getByText(/查看评审和返工焦点：\/review/)).not.toBeNull();
@@ -6855,6 +6856,119 @@ describe('AI 游戏创作 App 界面边界', () => {
),
).toHaveLength(commandCountsBeforeFeedback.exportPackage);
const commandCountsBeforeRetention = {
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('/retention');
const retentionMessages = await screen.findAllByText(/复玩观察：/);
const retentionMessage = retentionMessages[retentionMessages.length - 1];
expect(retentionMessage.textContent).toContain('项目：未命名游戏原型');
expect(retentionMessage.textContent).toContain(
'目标：做一个厨房弹幕游戏',
);
expect(retentionMessage.textContent).toContain(
'当前状态：最近 run 已通过 run-main-shortcut-trace；预览 未启动；自检 已通过；试玩包 待导出',
);
expect(retentionMessage.textContent).toContain(
'首轮样本：3-5 名测试者；每人 5-10 分钟；先不解释玩法，观察是否能自己完成首局',
);
expect(retentionMessage.textContent).toContain(
'复玩信号：是否主动重开；失败后是否理解原因；第二局是否更快进入目标；是否愿意换难度/角色/关卡；是否能说出想保留的一点',
);
expect(retentionMessage.textContent).toContain(
'资产与包装：素材 2 个；发布说明 已生成',
);
expect(retentionMessage.textContent).toContain('最近试玩证据：暂无');
expect(retentionMessage.textContent).toContain(
'记录模板：保留 1 项；调弱/调强 1 项；新增 1 项；必须修 1 项；是否愿意再玩一局',
);
expect(retentionMessage.textContent).toContain(
'暂不做：真实埋点；留存报表；用户画像；A/B 实验；排行榜或账号留存',
);
expect(retentionMessage.textContent).toContain(
'参考：/playtest；/feedback；/survey；/share；/known-issues',
);
expect(retentionMessage.textContent).toContain(
'边界：只准备复玩观察清单；不读取文件；不启动或打开预览；不导出试玩包；不上传云端；不发布作品；不写项目',
);
expect(retentionMessage.textContent).toContain('建议：/run');
const retentionMessageList = document.querySelector('.message-list');
expect(retentionMessageList).not.toBeNull();
const retentionDraftButtons = within(
retentionMessageList as HTMLElement,
).getAllByRole('button', { name: '启动试玩' });
fireEvent.click(retentionDraftButtons[retentionDraftButtons.length - 1]);
expect(screen.getByLabelText('创作想法')).toHaveProperty('value', '/run');
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(commandCountsBeforeRetention.manifestRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(commandCountsBeforeRetention.fileRead);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_files',
),
).toHaveLength(commandCountsBeforeRetention.fileList);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(commandCountsBeforeRetention.runLocal);
expect(
invoke.mock.calls.filter(
([command]) => command === 'start_local_game_preview',
),
).toHaveLength(commandCountsBeforeRetention.startPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'open_local_game_preview',
),
).toHaveLength(commandCountsBeforeRetention.openPreview);
expect(
invoke.mock.calls.filter(
([command]) => command === 'export_local_project_package',
),
).toHaveLength(commandCountsBeforeRetention.exportPackage);
expect(
invoke.mock.calls.filter(
([command]) => command === 'list_local_project_export_packages',
),
).toHaveLength(commandCountsBeforeRetention.exportList);
expect(
invoke.mock.calls.filter(([command]) => command === 'control_agent_run'),
).toHaveLength(commandCountsBeforeRetention.controlAgentRun);
const commandCountsBeforeShare = {
manifestRead: invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
@@ -12777,6 +12891,9 @@ describe('AI 游戏创作 App 界面边界', () => {
expect(
screen.getByText(/\/feedback：准备试玩反馈和修改说明/),
).not.toBeNull();
expect(
screen.getByText(/\/retention：准备首轮复玩\/留存观察清单/),
).not.toBeNull();
expect(screen.getByText(/\/share：准备试玩交付清单/)).not.toBeNull();
expect(
screen.getByText(/\/run-files：列出 Agent 运行辅助文件读取命令/),
docs/project-memory/shared-memory/decision-log.md
+2 -1
View File
@@ -3911,6 +3911,7 @@
- 2026-07-04 调整：普通用户通过聊天输入 `/release-notes` 准备试玩更新说明，只基于主窗口当前已加载的 manifest、最近 run trace、preview、资产和发布说明状态汇总本轮变化、主要产物、玩家可见说明和已知限制，并提供 `/run`、`/media-kit`、`/review`、`/trace`、`/read exports/README.md` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得导出试玩包、不得上传云端、不得发布作品、不得写项目，也不得新增普通用户更新说明面板。
- 2026-07-04 调整：普通用户通过聊天输入 `/known-issues` 准备已知问题清单，只基于主窗口当前已加载的 manifest、最近 run trace、preview 和任务状态汇总已知问题、试玩限制、反馈入口和发送前检查，并提供 `/run`、`/share`、`/review`、`/trace` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得导出试玩包、不得上传云端、不得发布作品、不得写项目，也不得新增普通用户已知问题面板。
- 2026-07-03 调整：普通用户通过聊天输入 `/feedback` 准备试玩反馈和修改说明，只基于当前 manifest、最近 run trace 和 preview 状态列出反馈方向、反馈模板和参考命令，并提供 `/run`、`/agent-resume 试玩反馈：`、`/review` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得直接继续 run，也不得新增普通用户反馈面板。
- 2026-07-04 调整：普通用户通过聊天输入 `/retention` 准备首轮复玩/留存观察清单，只基于当前 manifest、最近 run trace、preview、最近试玩证据、素材数量、发布说明和导出状态汇总测试者样本、复玩信号、记录模板和暂不做事项，并提供 `/run`、`/feedback`、`/review`、`/trace` 或 `/next` 草稿；该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览、不得导出试玩包、不得上传云端、不得发布作品、不得写项目，也不得新增普通用户留存面板；首版不做真实埋点、留存报表、用户画像、A/B 实验、排行榜或账号留存。
- 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 读写、不得读取文件、不得启动或打开预览，也不得新增普通用户面板。
- 2026-07-03 调整：普通用户通过聊天输入 `/runs` 查看已加载 Run 历史读取命令，只基于主窗口当前已加载的 latest trace 和最多 100 个历史 run 中已经载入的批次生成 `/trace` 或 `/read .agent/runs/...` 草稿；该入口不得额外触发 Tauri 读取、不得滚动加载更多历史、不得启动或打开预览，也不得新增普通用户面板。
@@ -3923,7 +3924,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`、`/compatibility`、`/accessibility`、`/localization`、`/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`、`/localization`、`/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`、`/retention`、`/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 读写，也不得新增普通用户轮次面板。
docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md
+3 -1
View File
@@ -142,6 +142,7 @@ game-project/
- 聊天输入 `/release-notes` 可在普通聊天消息里准备试玩更新说明，不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目，也不新增普通用户更新说明面板。
- 聊天输入 `/known-issues` 可在普通聊天消息里准备已知问题清单，不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目，也不新增普通用户已知问题面板。
- 聊天输入 `/feedback` 可在普通聊天消息里准备试玩反馈和修改说明，不读取文件、不启动预览、不直接继续 run，也不新增普通用户反馈面板。
- 聊天输入 `/retention` 可在普通聊天消息里准备首轮复玩/留存观察清单，不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目，也不新增普通用户留存面板；首版不做真实埋点、留存报表、用户画像、A/B 实验、排行榜或账号留存。
- 聊天输入 `/share` 可在普通聊天消息里准备试玩交付清单，不导出试玩包、不列出历史包、不上传云端，也不新增普通用户分享面板。
- 聊天输入 `/listing` 可在普通聊天消息里准备作品页文案清单，不读取发布说明、不上传云端、不发布作品，也不新增普通用户作品页面板。
- 聊天输入 `/passes` 可在普通聊天消息里列出最近 run trace 中 `.agent/passes/` 轮次产物读取命令，不直接读取轮次文件，也不新增普通用户轮次面板。
@@ -192,6 +193,7 @@ game-project/
- `/invite` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 和 preview 状态准备测试者邀请对象、邀请文案、发送前检查和收反馈口径，提供 `/run`、`/feedback`、`/review`、`/trace` 或 `/next` 草稿，并在 `/next` 与 `/help` 暴露入口；不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不写项目、不新增普通用户邀请面板。
- `/bug-report` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 和 preview 状态准备问题一句话、复现步骤、期望 / 实际、设备 / 输入方式、严重度和附件口径，提供 `/run`、`/agent-resume 缺陷修复：`、`/review`、`/trace` 或 `/next` 草稿，并在 `/next` 与 `/help` 暴露入口；不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不写项目、不新增普通用户缺陷面板。
- `/survey` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace 和 preview 状态准备首批测试者问卷、五个核心问题、记录格式和追踪方式，提供 `/run`、`/invite`、`/review`、`/trace` 或 `/next` 草稿，并在 `/next` 与 `/help` 暴露入口；不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不写项目、不新增普通用户问卷面板。
- `/retention` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview、最近试玩证据、素材数量、发布说明和导出状态准备首轮复玩/留存观察清单，提供 `/run`、`/feedback`、`/review`、`/trace` 或 `/next` 草稿，并在 `/next` 与 `/help` 暴露入口；不触发 Tauri 读写、不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目、不新增普通用户留存面板，也不做真实埋点、留存报表、用户画像、A/B 实验、排行榜或账号留存。
- `/cover` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和资产状态准备封面与缩略图候选、用途尺寸、选择口径和补齐路径，提供 `/run`、`/art`、`/listing`、`/review`、`/trace` 或 `/next` 草稿，并在 `/next` 与 `/help` 暴露入口；不触发 Tauri 读写、不截屏、不裁剪、不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不发布作品、不写项目、不新增普通用户封面面板。
- `/screenshots` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和资产状态准备宣传截图目标、拍摄顺序、命名建议和作品页搭配，提供 `/run`、`/listing`、`/review`、`/trace` 或 `/next` 草稿，并在 `/next` 与 `/help` 暴露入口；不触发 Tauri 读写、不截屏、不读取文件、不启动或打开预览、不导出试玩包、不写项目、不新增普通用户截图面板。
- `/trailer` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖：只基于当前已加载 manifest、最近 run trace、preview 和资产状态准备 15 秒试玩短视频结构、镜头清单、口播节奏和录制提示，提供 `/run`、`/share`、`/review`、`/trace` 或 `/next` 草稿，并在 `/next` 与 `/help` 暴露入口；不触发 Tauri 读写、不录屏、不读取文件、不启动或打开预览、不导出试玩包、不上传云端、不写项目、不新增普通用户录屏面板。
@@ -305,7 +307,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`、`/compatibility`、`/accessibility`、`/localization`、`/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`、`/localization`、`/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`、`/retention`、`/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 或历史仍由用户发送对应草稿并走原权限流。