用途
本技能用于检查智能体的编辑结果是否真正反映在 OpenChatCut 项目与编辑器当中。它适合在需要确认“修改已生效”的场景使用，尤其是涉及时间线内容、渲染效果和打包桌面应用行为的验证任务。
验证分级
使用能够证明所需结果的最低验证级别：
- L0：静态检查，例如聚焦验证脚本、
npx tsc --noEmit、测试和构建。 - L1：针对 localhost:5199 上的编辑器进行真实 Agent 运行，随后收集结构与渲染证据。
- L2：打包桌面应用完成用户场景，包括在自动化不足时进行人工视觉审核。
运行时行为变更要求 L0 + L1。发布以及仅桌面端的变更，当打包应用本身是被测行为时，还需要 L2。
主要能力与使用方式
优先使用两个信号：
- 用
read_project确认结构：素材（assets）、轨道（tracks）、片段（items）、帧放置（frame placement）、时间线时长。 - 用视觉捕获路径获取指定帧的渲染证据。
用 view_timeline_frames 获取合成时间线的证明，用于验证编辑后的 OpenChatCut 时间线：裁剪、图层、字幕、特效、标记、占位符、裁剪框、转场和布局。
对于原始源素材帧检查，根据字节所在位置选择最省成本的路径：
- 本构建中的智能体没有本地文件系统访问权限；所有源字节都位于项目媒体存储（
/media/uploads/）中。使用view_asset_frames并传入项目素材 id —— 服务器会自动走 ffmpeg contact-sheet 快速路径，因此它已经是成本最低的源帧路径。
view_timeline_frames 渲染合成后的时间线（编辑器真值检查）；view_asset_frames 采样原始源帧。按你要验证的对象来选择。
本构建中没有单独的 get_contact_sheet 工具——contact sheet 就是 view_asset_frames / view_timeline_frames 已经返回的内容。
本地/远程源帧产物仅用于源理解、时刻选择和粗略裁剪决策，不能当作编辑后输出或时间线证明。
对于仅本地或上传中的媒体，在素材字节可供渲染器使用之前，合成时间线证明可能被阻塞。只要素材字节已在磁盘上（/media/uploads/），通过 view_asset_frames 进行的源帧检查仍然可用。
如果两条视觉证明路径都被阻塞，请让用户直接检查 OpenChatCut 编辑器，并明确记录阻塞点。
常用检查
- 导入后：
read_project({ "view": "assets", "assetId": "<prefix>" }) - 移动/裁剪后：
read_project({ "view": "timeline" }) - 任何时间线媒体上的视觉叠加或 MG 后：
view_timeline_frames({ "frames": [30, 45, 75] })，然后查看返回的帧。
对于用户要求的源选择或视觉时刻挑选：用 view_asset_frames 采样静帧并检查。仅用于选择源文件、时刻和粗略裁剪。可见编辑要构建为 OpenChatCut 时间线片段。不要把原始源检查当作时间线验证，也不要把它当作在其他地方产出成片的许可。
源帧检查：在 read_project({ "view": "assets" }) 确认素材 id/类型后，调用 view_asset_frames({"assetId":"...","sourceTimesMs":[...]})。优先使用此方式，而不是让用户重新附加文件。
仅本地视觉验证：在依赖连接器视觉证明之前，先上传/注册云端可读的媒体。
无源验证：确认工具清单暴露了你所使用的参数，然后把可见证据记录到 trace log 中。
谈到秒数时，从 read_project 验证 fps，或使用内部解析 fps 的适配器工具。
报告时间线片段位置时，只使用最新的 read_project 结构中的轨道别名、片段 id、开始时间、时长和素材 id。不要将计划中的/默认的轨道或工具调用意图报告为已验证的放置。
当用户询问编辑器是否反映了结果时，不要仅凭命令行 JSON 响应就认定足够。在可行时使用编辑器 URL 或视觉证明。
真实 Agent 对话记录检查
每次 L1 Agent 运行后，在报告成功之前检查完整对话记录：
- 阅读最终助手响应以及本次运行创建的每一行工具调用。
- 展开失败或警告行，记录确切的错误。
- 检查是否存在中止的轮次、重复重试、过期提案、未完成的任务，以及最终响应错误描述为成功的工具结果。
- 将最新的
read_project结果与可见时间线对比。 - 对于视觉编辑，检查返回的时间线帧，而不是信任助手摘要。
时间线看起来正确但有未报告工具错误的运行不算干净通过。修复原因或明确报告剩余错误。
失败分类
如果验证失败，在更换工具之前先对差距进行分类：
- 工具描述或 schema 不足
- 技能说明缺少某个步骤
read_project未暴露足够状态- 编辑器授权未完成
- 媒体/转录流水线失败
- 云端渲染/编辑器观测被阻塞
限制
本技能针对 OpenChatCut 编辑器环境，依赖其特定工具（read_project、view_timeline_frames、view_asset_frames）。智能体在本构建中没有本地文件系统访问权限；本地或上传中的媒体可能无法获得合成时间线证明。两条视觉证明路径都被阻塞时，只能请求用户自行检查编辑器。技能本身未提供独立的收费、价格或平台信息。