SuperAPI AI 工具集

chatcut-media-guide

办公与效率

查看项目

更新于 10-15 17:33

技能介绍

用途:把本地或已下载的媒体文件导入 ChatCut 项目,或在媒体缺失时将其重新关联到已有资产,避免破坏既有资产与时间线引用。文件可能已导入时,先检查 browse_assets。

主要能力:同机编辑器导入与已有资产重关联。导入由脚本 scripts/serve-local-media.mjs 启动的本地回环服务完成,服务仅通过带令牌的 127.0.0.1 URL 提供所列文件,900 秒后退出。一次 import_media 调用可导入多个文件,文件数组形式为 {"action":"from_editor","files":[...]};每项需带 assetId、url、filename、sizeBytes,省略单项 action。每次 1 至 16 个文件,超过则分批,每批 16 个;最多 8 个并发,编辑器会把文件流入本地存储并显示传输进度。原顶层单文件参数仍可用。

必要用法:确认用户已选择要导入的文件;用 browserHandoff.url 或 editorUrl 打开目标项目,并保持恰好一个编辑器标签页,且该编辑器与本地 shell 在同一机器或同一网络命名空间(远程沙箱的 localhost 不是用户的 localhost)。使用 Node 18+ 启动助手的命令为:node <this-skill-dir>/scripts/serve-local-media.mjs --origin <editor-origin> /path/to/source.mp4。调用 MCP 时需用宿主的后台进程支持保持其存活。检查 results 中每一项:成功为 ok:true 且 status:"locally_imported",失败含 error;结果保持输入顺序并含 assetId、filename 与顶层 succeeded/failed 计数。仅重试失败文件且沿用相同 assetId。所有文件成功前保持助手存活,并保持编辑器打开以完成服务器同步、后台上传与转写。放置到时间线前用 browse_assets 验证;做转写或字幕前等待 track_progress 的 target:"transcription"。超时则检查 browse_assets 并用同一 assetId 重试;即使重启助手导致 URL 变化也保留该 ID。

重关联:缺失本地媒体时,先从 browse_assets 取现有 assetId 并找到对应原始源文件;按上述方式用脚本提供该文件;调用 import_media,传入助手的 url、filename、sizeBytes,设 action: "relink_from_editor",并用现有 assetId 替换生成的 ID。多文件用同一 files 数组形式,每项都填现有资产 ID。等到 status: "locally_relinked" 后再停止助手;上传或转写期间保持编辑器打开。重关联总是读取所提供文件,媒体类型必须匹配,且必须是原始对应文件而非替代编辑版本。若项目同步尚未把目标暴露给编辑器,可等待重试。失败的重关联不得退化为创建新资产。

限制与回退:若宿主无法运行助手、编辑器无法访问其回环 URL、浏览器本地网络访问不可用或宿主策略禁止传输,应停止并请用户在可见的目标项目编辑器中上传,不要尝试其它传输方式。不要编造 assetId 或 URL,不要上传用户未指明或未批准的文件。公共 URL 必须先下载为可读本地文件,再走同机路线。除后台上传外,不要等待上传,除非下一步操作明确需要云端字节。若编辑器无法触达助手,不得改用其它传输路线。