feat(agent): 云端 Agent - 增加上下文预算、任务事实与终态恢复保障

docs/content/docs/progress/pending-test.mdx

@@ -5,6 +5,30 @@ description: 当前项目已实现功能的手工验证清单与未确认边界
 
 # 待测试
 
+## Agent 工具诊断与错误恢复
+
+针对交互日志中的字段误报、输出可引用状态被误认为输入缺失、已绑定任务无法诊断、展示字段导致审批快照失效等问题，调整工具的数据合同和共用准入规则。没有新增场景关键词路由、自动选参考图、自动重试生成或新的系统提示词规则；工具说明明确区分编辑画布和提交收费生成，去除具体广告场景例子。
+
+- [x] 后端 `go test ./internal/app -run 'TestCloudAgent' -count=1` 通过：操作字段错误与修正后的预览、失败/取消任务诊断及跨用户/画布隔离、敏感错误脱敏、已绑定任务拒绝、展示信息自动保存不阻断审批、实际内容变化仍阻断、取消来源只记录一次；使用临时 SQLite 和模拟任务，未调用收费模型。
+- [ ] 真实模型验收：相同画布分别请求“只连线”“只创建节点”“生成视频”，确认工具选择符合意图；读取失败视频时能区分产物不可引用与实际任务错误，按字段诊断修正参数，不自行换节点重复生成。
+- [ ] 发布后验证页面引用标签与任务错误可见性、审批期间移动/缩放节点及自动保存、取消后导出日志中的来源与关联任务。旧审批快照算法变化时需重新读取审批；未做线上部署或真实收费模型对比，不能以合同测试代替模型行为验收。
+
+## Agent 媒体提示词引用标签
+
+Agent 创建或续用未提交媒体草稿时，保留已有 `@图片N` / `@视频N` / `@音频N` 引用，为遗漏的已选画布素材补齐带名称的引用块。各类型独立编号，目标入边与任务参考数组顺序一致；草稿、审批与实际提交使用相同提示词。模型工具说明同步要求在对应描述中使用引用标签，编号越界和补齐后超长均在提交前报错。
+
+- [x] 后端媒体、画布阶段事件与审批专项通过，覆盖编号与顺序、已有引用不重复、无引用任务、临时标注图、长度上限、草稿持久化、审批后提交及重放不重复收费。
+- [x] 前端 11 项实际引用解析与生成上下文测试通过，覆盖图片/音频/文本混排、槽位编号、引用移除和再次提交。
+- [ ] 更新后端后，在真实页面验证 Agent 生成节点中的引用标签、缩略图/音频标识、刷新和续用草稿。本次未进行浏览器验收或线上部署；历史节点不自动补写。
+
+## MiniMax H3 视频失败原因透传
+
+MiniMax Hailuo Video V2 / H3 插件更新至 `2.0.1`，创建和查询均优先读取 `task.error.message`，并识别 `task.error.code`。参考图片尺寸不符合要求等具体错误通过已有任务错误字段返回，避免被替换成“上游返回失败状态”。补回该插件的可维护源码目录，并同步插件包和接口文档。
+
+- [x] 插件专项回归覆盖嵌套错误、缺少任务状态、具体错误优先级、已有错误格式和成功响应；相邻视频媒体角色测试通过。
+- [x] 后端模拟 HTTP 上游验证创建失败与轮询失败，具体原因进入任务错误文案，且不重复提交；前端实际错误格式化函数和画布失败元数据保留该原因。插件包与源码一致，其他请求、结果映射保持不变。
+- [ ] 更新线上插件后，以真实失败任务验收画布和任务详情的错误展示；本次未部署、未调用收费模型。历史失败任务已保存的通用错误不会自动改写。
+
 ## 模型展示名归组与管理员积分成本
 
 创作目录固定直接读取系统渠道模型，一级按模型展示名跨渠道分组，二级按各模型的渠道展示名展示；删除渠道级“前台名称”，不反查逻辑模型。成本配置限定在管理员价格档编辑，按下单快照核算，后台请求记录与 CSV 显示销售价、成本价；普通用户目录、报价和账单不返回成本字段。
@@ -2253,6 +2277,12 @@ v2（用户反馈首版难看后重做）：菜单改用 antd Dropdown（placeme
 
 ## 云端 Agent Skills 选择与 Token 预算（2026-09-13）
 
+文本 Agent 已改为按所选文本模型能力计算上下文预算：渠道模型读取 `contextWindowTokens` / `maxOutputTokens`，逻辑模型按候选线路取安全交集，旧配置回退 128K / 16K；前端发送前检查与后端轮次预算使用同一语义。1M 模型可配置更大输入预算，运行 checkpoint 的 512KB 持久化上限保持独立。后端上下文压缩保留任务、生成、审批、计费、取消和回写事实，只移除可重新读取正文。
+
+- [x] 后端按能力合同计算 Token 预算、输出预留和压缩阈值，移除生产路径固定 96KB/120KB/192KB 上下文窗口。
+- [x] provider 文本任务从能力合同读取 `maxOutputTokens`；前端模型能力编辑器支持上下文窗口和最大输出配置。
+- [ ] 使用真实 1M 模型 tokenizer 做大上下文压力测试，并验证多线路路由、SSE 断线恢复和费用估算在生产等价环境的一致性。
+
 Skills 选择器已扩大为固定高度面板，增加宽松留白、自定义多选状态、250ms 搜索防抖和服务端分页的滚动续载；Agent 输入恢复画布节点 `@` 候选，`/` 选择技能后保留可读技能名，不再显示内部 skill ID 或残留斜杠。Token 计费模型现可进入 Agent，账单会把预授权报价固化为最终扣费上限。前端生产构建、ESLint、29 项相关测试，以及后端 app/repository/database 测试通过，需浏览器和真实计费渠道验收：
 
 - [ ] 在明暗主题、窄窗口和低高度窗口打开 Skills，确认面板尺寸稳定、列表独立滚动、空态不缩高、选中态与焦点清晰。