验证
使用能证明请求结果的最低验证等级:
| 等级 | 所需证据 |
|---|---|
| L0 | 静态检查,例如聚焦的验证脚本、npx tsc --noEmit、测试和构建。 |
| L1 | 针对 localhost:5199 编辑器的真实 Agent 运行,随后提供结构性和渲染后的证据。 |
| L2 | 打包的桌面应用完成用户场景,包括在自动化不足时进行人工视觉审查。 |
运行时行为变更需要 L0 + L1。发布和仅桌面端的更改在打包应用是测试行为时也需要 L2。
优先使用两个信号:
read_project用于查看结构:资源、轨道、项目、帧放置、时间线时长。- 用于在精确帧上渲染证据的视觉捕获路径。
使用 view_timeline_frames 获取合成时间线证明。这会验证已编辑的 OpenChatCut 时间线:修剪、图层、字幕、特效、标记、占位符、裁剪、转场和布局。
对于原始源资源帧检查,根据字节所在位置选择最经济的路径:
- 此构建中的 Agent 无本地文件系统访问权限;所有源字节位于项目媒体存储(
/media/uploads/)中。使用view_asset_frames并传入项目资源 ID —— 服务器会自动采用 ffmpeg 联系表快速路径,因此它已经是代价最低的源帧路径。 view_timeline_frames渲染合成时间线(编辑器真实性检查);view_asset_frames采样原始源帧。根据您要验证的内容进行选择。- 此构建中没有单独的
get_contact_sheet工具 —— 联系表正是view_asset_frames/view_timeline_frames已经返回的内容。
仅将本地/远程源帧工件用于源理解、时刻选择和粗略修剪决策,而不是作为编辑后的输出或时间线证明。
对于仅本地或上传中的媒体,合成时间线证明可能被阻塞,直到资源有可供渲染器使用的字节。只要资源的字节在磁盘上(/media/uploads/),view_asset_frames 源帧检查仍然有效。
如果两个视觉证明路径都被阻塞,请让用户直接检查 OpenChatCut 编辑器,并明确记录阻塞原因。
有用的检查:
- 导入后:
read_project({ "view": "assets", "assetId": "<前缀>" }) - 移动/修剪后:
read_project({ "view": "timeline" }) - 在任何时间线媒体上添加视觉叠加或动态图形后:
view_timeline_frames({ "frames": [30, 45, 75] }),然后查看返回的帧。 - 对于用户请求的源选择或视觉时刻选取:使用
view_asset_frames采样静态图像并进行检查。仅用于选择源文件、时刻和粗略修剪。将可见编辑构建为 OpenChatCut 时间线项目。不要将原始源检查视为时间线验证或允许在其他地方生成编辑后的视频。 - 对于源帧检查:在
read_project({"view":"assets"})确认资源 ID/类型后,调用view_asset_frames({"assetId":"...","sourceTimesMs":[...]})。优先于要求用户重新附加文件。 - 对于仅本地的视觉验证:在依赖连接器视觉证明之前,上传/注册云可读媒体。
- 对于无源验证:确认工具清单公开了您使用的参数,然后在跟踪日志中记录可见证明。
当谈论秒时,从 read_project 验证 fps 或使用内部解析 fps 的适配器工具。
当报告时间线项目位置时,仅使用最新的 read_project 结构来获取轨道别名、项目 ID、起点、持续时间和资源 ID。不要报告计划/默认轨道或工具调用意图作为已验证的放置。
当用户询问编辑器是否反映了结果时,不要仅将命令行 JSON 响应视为充分证据。在实际可行时使用编辑器 URL 或视觉证据。
真实 Agent 聊天记录检查
每次 L1 Agent 运行后,在报告成功之前检查完整的聊天记录:
- 读取最终的助手响应以及由该运行创建的每一个工具行。
- 展开失败或警告行并记录确切的错误。
- 检查是否有中断的轮次、重复的重试、过时的提议、未完成的作业以及最终响应错误地描述为成功的工具结果。
- 将最新的
read_project结果与可见的时间线进行比对。 - 对于视觉编辑,检查返回的时间线帧,而不是信任助手摘要。
一个时间线看起来正确但存在未报告的工具错误的运行不是干净的通过。修复原因或明确报告剩余的错误。
如果验证失败,在更改工具之前对差距进行分类:
- 工具描述或模式不够充分
- 技能指令缺少了一个步骤
read_project未暴露足够的状态- 编辑器授权未完成
- 媒体/转录管道失败
- 云渲染/编辑器观察被阻塞