feat(agent): 审美分析 - 接入费用确认与阶段任务恢复

docs/content/docs/plugins/ai-art-critique.mdx

@@ -7,7 +7,7 @@ description: 面向图片创作的 AI 视觉分析、问题定位和修改建议
 
 > 状态：MVP 已实现，当前审美标准为 `2026-08-v1`。
 
-执行入口已统一到 `art-critique-execution`：手动分析各阶段通过后台文本任务提交，原图使用资源引用，节点记录阶段任务 ID。一次分析最多 9 个不同模型阶段，不自动重复提交。停止观察不等于取消后台任务，已提交阶段仍可在任务中心查看；自动费用审批及整条管线刷新恢复仍待接入。Agent 当前支持准备输入和读取已有报告，尚未开放自动启动收费分析。
+执行入口已统一到 `art-critique-execution`：手动分析和 Agent 发起分析共用原插件面板。各阶段先取得后台真实报价，用户确认当前费用卡后才提交；后续阶段按已有结果另行报价。原图使用资源引用，一轮最多 9 个不同模型阶段。节点记录报价运行、模型及阶段任务 ID，图片和模型未变时可“继续上次分析”，复用已提交任务和结果，不自动付费重试失败阶段。停止观察不等于取消后台任务；关页后尚未提交的阶段不会自动运行。Agent 可通过 `canvas_start_art_critique` 准备报价，通过 `canvas_read_plugin_node` 读取报告；完整合同见[Agent 能力接入](../../../design/agent-capabilities.mdx)。
 
 ## 1. 先说结论
 
@@ -41,6 +41,7 @@ description: 面向图片创作的 AI 视觉分析、问题定位和修改建议
 图片节点
   -> 创建或连接“AI 审美批改”节点
   -> 点击“开始批改”
+  -> 核对本批费用并确认（后续阶段按实际结果另行报价）
   -> AI 看图并返回结构化结果
   -> 本地校验和整理结果
   -> 在原图上绘制标注

docs/design/agent-capabilities.mdx

@@ -49,10 +49,16 @@ agentActions: [{
 
 ## 当前边界与后续接入
 
-审美分析的手动入口已接入 `art-critique-execution` 统一执行边界。各阶段通过现有后台文本任务运行，原图先准备为资源引用，任务正文不内嵌媒体。最多提交 9 个不同阶段，不自动重复提交同一阶段；节点保存 `stageTaskIds`，任务元数据记录节点、执行和阶段标识。底层 pipeline 支持注入阶段执行器，费用审批可在这一入口接入，不复制审美判断与解析逻辑。
+审美分析的手动入口和 `canvas_start_art_critique` 共用原插件面板及 `art-critique-execution`。Agent 准备输入后可打开分析并准备报价；已有当前图片的完整报告直接复用。只有用户明确要求重新分析时传 `retry=true`。打开面板后暂停本轮工具循环，同批后续操作不执行，避免等待费用确认期间重复调用模型；分析完成后用户可让 Agent 读取报告继续。这次接入使用原插件弹窗展示费用卡，尚未把费用卡嵌入聊天消息或完成后自动唤醒会话。
 
-停止观察不代表后台任务取消或未收费。已提交任务保留在任务中心；本批没有自动恢复整条管线或重新提交失败阶段。画布输入改变后停止后续观察，不将旧结果写到新输入。Agent 目前仍不能自动启动该收费分析，须先接通具体阶段报价、用户批准和任务接续。
+`ApprovedToolExecution` 复用已有 `creation-runs` 报价、批准和幂等执行接口。各阶段先准备真实请求，再展示费用；确认按钮只批准当时费用卡列出的提交 ID，后来到达的阶段继续等待。首批为场景理解及四个独立视觉分析，后续聚合、定位、复核和提示词按前面的实际结果报价，不预先虚构后续输入。按用量收费的金额是估算，不是封顶；自定义渠道另行标注外部费用。
+
+各阶段通过现有后台文本任务运行，原图先准备为资源引用，任务正文不内嵌媒体。每轮最多 9 个不同阶段；节点保存 `billingRunId`、`lastRunId`、`lastRunModel` 和 `stageTaskIds`，任务元数据记录节点、执行和阶段标识。底层 pipeline 注入批准后的阶段执行器，不复制审美判断与解析逻辑。工具调用仍进入原会话历史；费用记录由服务端创作运行保存，节点保存恢复入口。
+
+关闭面板或停止观察不代表后台任务取消或未收费。重新打开后，在图片、节点和模型未变时可选择“继续上次分析”：同阶段相同请求找回原报价或任务，已提交阶段沿用原任务 ID，已完成结果重新参与本地管线计算，未批准阶段继续等确认。报价过期且未提交时更新报价并重新确认；刷新后旧费用卡不能批准新报价。请求内容变化时后端拒绝复用，需重新开始，不静默新增收费阶段。
+
+执行控制或报价错误会中止其他待确认阶段，不能被当作部分模型结果降级后宣称成功。已提交阶段的模型失败保留原管线的部分报告处理，不自动付费重试；整轮重新分析走新报价。当前仍是浏览器驱动的管线，关页后已提交后台任务继续，尚未提交的后续阶段不会自动运行。画布输入或账号变化、插件停用会阻止继续提交或回写旧结果。
 
 本批接入在线画布助手。首页尚未改造成通用工具循环，本机 Agent 仍使用原技能包交付机制。现有插件只有声明而没有 `agentActions` 时，可发现贡献并创建节点，不宣称能自动执行它的专用分析、编辑或导出。
 
-已补齐画风预设的模型选择与项目同步、分镜专用增删改。审美批改与肖像排查的新分析仍通过插件自己的入口执行：前者涉及多次模型调用，后者涉及本机任务，尚未接入统一 Agent 费用和任务编排。后续继续接通这些执行器，以及首页与本机端的同一能力目录。不得以任意 `metadata` 更新替代具有业务校验和费用语义的执行接口。
+已补齐画风预设的模型选择与项目同步、分镜专用增删改，以及 Agent 发起审美分析报价。肖像排查涉及本机任务，仍使用插件自己的执行入口；后续接通该执行器，以及首页与本机端的同一能力目录。不得以任意 `metadata` 更新替代具有业务校验和费用语义的执行接口。