补充运行预算聊天入口

新增 /budget 运行预算摘要和后续草稿

补充 /next 与 /help 的预算入口覆盖

同步技术方案和项目决策记录
This commit is contained in:
AIGameCreator App
2026-07-03 17:24:42 +08:00
parent bb7ce9a1c8
commit a05e8e0365
4 changed files with 119 additions and 2 deletions
+65
View File
@@ -1871,6 +1871,7 @@ const chatCommandHelp = [
'/risks:查看当前项目风险',
'/criteria:查看当前任务验收标准',
'/groups:查看专业组进度',
'/budget:查看最近 run 预算',
'/review:查看 Evaluator 评审和返工焦点',
'/context:查看生成上下文来源',
'/timeline:查看项目活动时间线',
@@ -2312,6 +2313,52 @@ function summarizeProjectGroupProgress(
};
}
function summarizeAgentRunBudget(trace: GameCreationAgentRunTrace | null) {
if (!trace) {
return {
text: '运行预算:\n- 最近 Run:暂无\n- 建议:/next',
draftCommand: '/next',
draftCommandLabel: '查看下一步',
};
}
const remainingPasses = Math.max(trace.maxPasses - trace.passes, 0);
const remainingToolCalls = Math.max(
trace.maxToolCalls - trace.toolCallCount,
0,
);
const blocked =
trace.lifecycleStatus === 'killed' ||
trace.status === 'failed' ||
trace.status === 'needs-revision' ||
trace.stopReason === 'max-passes-exhausted' ||
remainingPasses === 0 ||
remainingToolCalls === 0;
const draftCommand = blocked
? '/review'
: isAgentRunTracePassed(trace)
? '/publish'
: '/trace';
return {
text: [
'运行预算:',
`- Run${trace.runId} · ${formatAgentRunStatus(trace)}`,
`- 轮次:已用 ${trace.passes}/${trace.maxPasses} · 剩余 ${remainingPasses}`,
`- 工具调用:已用 ${trace.toolCallCount}/${trace.maxToolCalls} · 剩余 ${remainingToolCalls}`,
`- 下一步:${trace.nextStep}`,
`- 建议:${draftCommand}`,
].join('\n'),
draftCommand,
draftCommandLabel:
draftCommand === '/review'
? '查看评审'
: draftCommand === '/publish'
? '查看发布准备'
: '查看 trace',
};
}
function isAgentRunTracePassed(trace: GameCreationAgentRunTrace | null) {
return (
trace?.status === 'passed' ||
@@ -2848,6 +2895,7 @@ function summarizeNextProjectActions(
if (trace) {
addSuggestion('查看发布准备清单', '/publish');
addSuggestion('查看试玩状态', '/playtest');
addSuggestion('查看最近 run 预算', '/budget');
addSuggestion('查看评审和返工焦点', '/review');
addSuggestion('查看生成上下文来源', '/context');
addSuggestion('查看项目活动时间线', '/timeline');
@@ -6473,6 +6521,23 @@ export function App() {
return;
}
if (prompt === '/budget') {
if (!requireChatProjectForUserAction()) {
return;
}
const summary = summarizeAgentRunBudget(agentRunTrace);
setMessages((current) => [
...current,
{
role: 'assistant',
text: summary.text,
draftCommand: summary.draftCommand,
draftCommandLabel: summary.draftCommandLabel,
},
]);
return;
}
if (prompt === '/review') {
if (!requireChatProjectForUserAction()) {
return;
@@ -2325,6 +2325,52 @@ describe('AI 游戏创作 App 界面边界', () => {
),
).toHaveLength(runLocalCountBeforeGroups);
const fileReadCountBeforeBudget = invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
).length;
const manifestReadCountBeforeBudget = invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
).length;
const runLocalCountBeforeBudget = invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
).length;
submitChat('/budget');
expect(await screen.findByText(/运行预算:/)).not.toBeNull();
const budgetMessages = screen.getAllByText(/运行预算:/);
const budgetMessage = budgetMessages[budgetMessages.length - 1];
expect(budgetMessage.textContent).toContain(
'Runrun-main-shortcut-trace · passed / done · 1/3 轮 · evaluator-passed',
);
expect(budgetMessage.textContent).toContain('轮次:已用 1/3 · 剩余 2');
expect(budgetMessage.textContent).toContain(
'工具调用:已用 1/128 · 剩余 127',
);
expect(budgetMessage.textContent).toContain('下一步:preview');
expect(budgetMessage.textContent).toContain('建议:/publish');
const budgetDraftButtons = screen.getAllByRole('button', {
name: '查看发布准备',
});
fireEvent.click(budgetDraftButtons[budgetDraftButtons.length - 1]);
expect(screen.getByLabelText('创作想法')).toHaveProperty(
'value',
'/publish',
);
expect(
invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
),
).toHaveLength(fileReadCountBeforeBudget);
expect(
invoke.mock.calls.filter(
([command]) => command === 'get_local_game_manifest',
),
).toHaveLength(manifestReadCountBeforeBudget);
expect(
invoke.mock.calls.filter(
([command]) => command === 'run_limited_local_command',
),
).toHaveLength(runLocalCountBeforeBudget);
const fileReadCountBeforeReview = invoke.mock.calls.filter(
([command]) => command === 'read_local_project_file',
).length;
@@ -2600,6 +2646,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(/查看最近 run 预算:\/budget/)).not.toBeNull();
expect(screen.getByText(/查看评审和返工焦点:\/review/)).not.toBeNull();
expect(screen.getByText(/查看生成上下文来源:\/context/)).not.toBeNull();
expect(screen.getByText(/查看项目活动时间线:\/timeline/)).not.toBeNull();
@@ -8496,6 +8543,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(/\/budget:查看最近 run 预算/)).not.toBeNull();
expect(
screen.getByText(/\/review:查看 Evaluator 评审和返工焦点/),
).not.toBeNull();
@@ -3869,6 +3869,7 @@
- 2026-07-03 调整:普通用户通过聊天输入 `/risks` 查看当前项目风险,只基于主窗口当前已加载的 manifest、最近 run trace、预览状态、任务状态、资产来源和最近命令派生风险摘要,并提供首个风险处理草稿;该入口不得触发 Tauri 读写、不得读取文件、不得启动或打开预览,也不得新增普通用户面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/criteria` 查看当前任务验收标准,只基于当前 manifest.tasks 和最近 run trace.taskGraph 汇总 active、carry、ready、失败或待处理任务的验收条件和产物,并提供 `/tasks` 草稿;该入口不得触发 Tauri 读写、不得读取任务文件或 trace 文件,也不得新增普通用户验收面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/groups` 查看专业组进度,只基于当前 manifest.tasks 和最近 run trace.taskGraph / passPlans 汇总六个专业组的完成、active、carry、ready、失败数量和下一步任务,并提供 `/tasks` 草稿;该入口不得触发 Tauri 读写、不得读取任务文件或 trace 文件,也不得新增普通用户专业组面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/budget` 查看最近 run 预算,只基于当前最近 run trace 汇总轮次、工具调用、stopReason 和下一步建议,并提供 `/review``/publish``/trace``/next` 草稿;该入口不得触发 Tauri 读写、不得读取 trace 文件,也不得新增普通用户预算面板。
- 2026-07-03 调整:普通用户通过聊天输入 `/review` 查看 Evaluator 评审状态,只基于主窗口当前已加载的最近 run trace 派生通过 / 需返工状态、返工焦点、返工路线和最近评审步骤,并提供 `/read .agent/findings.md``/agent-resume ` 草稿;该入口不得直接读取评审文件、不得触发 Tauri 读写,也不得新增普通用户评审面板。
- 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 文件,也不得新增普通用户时间线面板。
@@ -3882,7 +3883,7 @@
- 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 调整:主窗口新增常用生成产物读取入口,只把入口 HTML、设计、数值、美术清单、音频清单和发布说明对应的 `/read` 草稿填入聊天输入框;聊天命令 `/artifacts` 只列出同一组固定读取命令并提供首个读取草稿,`/run-artifacts` 只列出最近 trace 里的产物读取命令并提供首个 `/read` 草稿,`/logs` 只列出固定日志读取命令;实际读取仍走聊天侧 `file.read` 权限流,不直接读本地文件。
- 2026-07-03 调整:普通用户通过聊天输入 `/next` 触发下一步建议入口,只基于主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要生成聊天建议,列出 `/tasks``/criteria``/groups``/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 和最近命令摘要生成聊天建议,列出 `/tasks``/criteria``/groups``/budget``/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 调整:普通用户通过聊天输入 `/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 读写,也不得新增普通用户轮次面板。
@@ -103,6 +103,7 @@ game-project/
- 用户侧看到当前工作区项目名 / 路径、最近 run、预览状态、任务完成数 / ready 数、资产数量 / 来源分布、最近命令摘要、聊天框、上传入口、Agent 状态列表和单 Agent 对话;聊天输入 `/brief` 可在普通聊天消息里生成当前项目简报并提供 `/next` 草稿,不新增普通用户面板;聊天输入 `/risks` 可在普通聊天消息里查看当前项目风险并提供首个风险处理草稿,不新增普通用户面板;聊天输入 `/review` 可在普通聊天消息里查看 Evaluator 评审、返工焦点和返工路线并提供读取评审记录或继续修复草稿,不新增普通用户面板;聊天输入 `/context` 可在普通聊天消息里查看生成上下文来源并提供读取首个上下文或查看黑板草稿,不新增上下文面板;聊天输入 `/timeline` 可在普通聊天消息里查看项目活动时间线并提供最近日志、trace 或历史草稿,不新增时间线面板;聊天输入 `/playtest` 可在普通聊天消息里查看最近 run 是否可试玩、当前预览状态和 Playtest 任务状态并提供启动或打开预览草稿,不新增普通用户试玩面板;聊天输入 `/handoff` 可在普通聊天消息里生成当前项目交接摘要并提供 `/next` 草稿,不新增普通用户面板;聊天输入 `/runs` 可在普通聊天消息里列出已加载 Run 历史读取命令,不新增普通用户面板;聊天输入 `/run-files` 可在普通聊天消息里列出 Agent 运行辅助文件读取命令,不新增普通用户面板;聊天输入 `/internals` 可在普通聊天消息里列出项目内部真相源读取命令,不新增内部文件面板;聊天输入 `/art` 可基于当前 manifest 盘点美术素材并提供生成或读取草稿,不新增美术面板;聊天输入 `/audio` 可基于当前 manifest 盘点音频素材并提供登记或读取草稿,不新增音频生成系统;聊天输入 `/publish` 可基于当前 manifest 和最近 run 生成发布准备清单并提供运行、trace、继续或导出草稿,不新增发布面板;聊天输入 `/export` 确认后把当前可试玩原型导出为本地试玩 ZIP,聊天输入 `/exports` 可只读列出已导出的本地试玩包;Agent 状态列表和单 Agent 对话在 `/llm-status` 后显示该 agent 当前 LLM provider / 模型 / 流式 / API Key 读取状态,但不显示密钥本体;最近项目资产入口显示本地路径、kind、mediaType 和来源类型,并可一键填入 `/read` 草稿,开发环境通过独立窗口查看任务拆分、专业组细节、产物、文件面板、嵌入预览以及 `.agent/logs/command.log` / `preview.log` / `agent.log`
- 聊天输入 `/criteria` 可在普通聊天消息里查看当前任务验收标准和预期产物,不读取任务文件或 trace 文件,也不新增普通用户验收面板。
- 聊天输入 `/groups` 可在普通聊天消息里查看六个专业组进度和下一步任务,不读取任务文件或 trace 文件,也不新增普通用户专业组面板。
- 聊天输入 `/budget` 可在普通聊天消息里查看最近 run 轮次和工具调用预算,不读取 trace 文件,也不新增普通用户预算面板。
- 聊天输入 `/passes` 可在普通聊天消息里列出最近 run trace 中 `.agent/passes/` 轮次产物读取命令,不直接读取轮次文件,也不新增普通用户轮次面板。
- 生成代码和资产进入用户本地项目目录。
- 本地 HTTP 预览能启动,并在外部浏览器展示可玩原型。
@@ -118,6 +119,7 @@ game-project/
- `/risks` 聊天入口由 `appSurface.test.ts` 的主窗口 smoke 覆盖:只基于当前已加载的 manifest / trace / 预览 / 任务 / 资产 / 最近命令生成风险摘要,提供首个风险处理草稿,不触发 Tauri 读写、文件读取、预览启动或新增普通用户面板。
- `/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 文件、不新增普通用户专业组面板。
- `/budget` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载最近 run trace 汇总轮次、工具调用、stopReason 和下一步建议,提供 `/review``/publish``/trace``/next` 草稿,不触发 Tauri 读写、不读取 trace 文件或新增普通用户预算面板。
- `/review` 聊天入口由 `appSurface.test.ts` 主窗口 smoke 覆盖:只基于当前已加载 run trace 汇总 Evaluator 状态、返工焦点、返工路线和最近评审步骤,提供 `/read .agent/findings.md``/agent-resume ` 草稿,不直接读取评审文件、不触发 Tauri 读写或新增普通用户面板。
- `/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 文件、不新增普通用户时间线面板。
@@ -199,9 +201,10 @@ 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` 并走原读取流。
- 聊天输入 `/budget` 只使用主窗口当前已加载的最近 run trace,在聊天里列出轮次、工具调用、stopReason 和下一步建议,并提供 `/review``/publish``/trace``/next` 草稿;该命令不调用 Tauri 读写、不读取 trace 文件、不新增普通用户预算面板,真正查看完整 trace 仍由用户发送 `/trace` 并走原读取流。
- 聊天输入 `/handoff` 只使用主窗口当前已加载的 manifest、最近 run trace、Agent 状态和已载入历史 run 批次,在聊天里生成项目交接摘要,并提供 `/next` 作为后续草稿;该命令不调用 Tauri 读写、不读取文件、不启动或打开预览、不新增普通用户面板,用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/runs` 只使用主窗口当前已加载的 latest trace 和已载入历史 run 批次,在聊天里列出 `/trace``/read .agent/runs/...` 读取草稿;该命令不调用 Tauri 读写、不滚动加载更多历史、不启动或打开预览、不新增普通用户面板,用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/next` 只使用主窗口当前已加载的 manifest、最近 run trace 和最近命令摘要,在聊天里给出下一步建议,列出 `/tasks``/criteria``/groups``/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 和最近命令摘要,在聊天里给出下一步建议,列出 `/tasks``/criteria``/groups``/budget``/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 读写、不启动或打开预览、不读取文件,用户必须再发送草稿并按原命令权限流继续。
- 聊天输入 `/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 或历史仍由用户发送对应草稿并走原权限流。