mcpField
E
export

export

github.com/chatcut-inc创意与媒体988151 次安装今天更新
代码仓库

关于 export

面向 ChatCut 的导出技能，用于生成用户要求的渲染或独立成品，并指导本地、云端渲染及文件交付。

主要功能

  1. 01提交并跟踪导出
  2. 02通过编辑器本地渲染
  3. 03经同意后使用云端渲染
  4. 04核验并交付完成的文件

适用场景

  1. 01导出最终视频或音频文件
  2. 02交付字幕或 NLE XML
  3. 03处理浏览器下载文件缺失

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/chatcut-inc/agent-plugin --skill export

安装后在 Claude Code 中输入/export确认已加载。

详细介绍

导出

只有在用户要求渲染、下载或最终独立交付物时才导出。评审检查点通常应保留为可编辑的 ChatCut 时间线。要检查自己的工作，请使用 preview_timeline 查看画面，并使用 format:"audio" 导出以试听声音；自检时切勿进行全分辨率导出（参见 verification）。

使用当前工具架构调用 submit_export。根据项目状态和用户意图确认目标时间线、范围、分辨率、编解码器和格式；不要猜测非活动时间线。为每次导出指定简短且有辨识度的 name。记录每次返回的 renderId 和 expectedFilename。

默认情况下，视频和音频都在本地渲染：省略 renderMode，由已连接的 ChatCut 编辑器标签页在用户设备上渲染时间线。通过插件基础技能中的浏览器交接流程打开项目，激活所需时间线，并保持该标签页打开，直到交付完成。如果没有连接兼容的编辑器，请解决报告的浏览器或时间线问题，然后重试本地渲染；不会自动重试云端渲染。编辑器已能读取的媒体，无需上传即可用于本地导出。

使用 track_export 查看浏览器和云端导出状态；不要使用生成/转录进度工具 track_progress。传入返回的 renderId，或使用最新渲染选项获取该项目最近一次导出。单次 wait 调用只会读取一次状态；请遵循其建议的回查间隔。如果提交超时或无法确定是否收到确认，请先检查最新导出，再重新提交，以免重复启动同一次导出。

交付

已完成的浏览器导出（source:"browser"）没有 downloadUrl：渲染标签页会将文件交给该浏览器的下载功能。完成并不代表文件已保存，因此只有找到文件后才能交付。

  1. 在用户的下载文件夹（通常为 ~/Downloads）中查找 expectedFilename，允许扩展名前带有浏览器后缀，例如 (1)。如果没有 expectedFilename，则查找已完成的 track_export 条目的 name（提交的名称加上 .mp4、.webm 或 .mp3），并选择提交后修改时间最新的匹配项。只搜索该名称；不要列出或读取其中的其他文件。如果无法读取用户电脑上的文件，请告知用户文件名。
  2. 找到后：提供文件路径和简洁的渲染元数据。在 Claude Code 中，还要提供本地文件预览链接；在 Codex 中，通过其常规文件交付方式显示本地文件。如果用户指定了文件夹，请将文件复制到该文件夹。
  3. 未找到：如果结果中有 deliveryGuidance，请按其中的说明，询问用户完成与渲染该文件的浏览器相对应的一步操作，然后再次查找：
    • Chrome：在地址栏的提示中允许“下载多个文件”（一次即可；此后该网站会保持允许状态），然后在编辑器的导出队列中点击 再次下载。
    • Claude 桌面版的 Browser 面板或 WorkBuddy：在保存对话框中点击 保存；默认位置为“下载”文件夹。
    • Codex 应用内浏览器：在编辑器的导出队列中点击 再次下载。
    • 其他情况：询问浏览器将文件保存到了哪里。

如果读取下载文件夹需要用户批准（macOS 隐私提示或主机权限提示），请告知用户你正在查找导出文件。如果状态显示导出文件已写入用户选择的位置，则该文件就是交付文件。不要跳过这些步骤转而使用云端，也绝不要仅为获取链接或检查自己的工作而使用云端。

如果用户表示无法完成本地步骤（打开编辑器或上述下载步骤），或者尝试后仍然失败，请用一句话说明本地受阻的原因，并询问是否要在云端导出；用户同意后，使用 renderMode:"cloud" 导出并交付其 downloadUrl。只有云端也无法完成时（例如 4K、仅存在于用户电脑上且无法上传的媒体，或云端渲染被拒绝或失败），才告知用户 ChatCut Desktop 会在其电脑上渲染。打开后，Desktop 会自动连接到 Codex、Claude Code 和 WorkBuddy；在 Codex 中，ChatCut Desktop 插件的 connect-chatcut-desktop 技能可用于安装。

包含 downloadUrl 的已完成结果（云端视频/音频、字幕、XML）：使用主机的常规文件/链接交付方式。如果用户指定了本地路径，请自行将文件下载到该路径。在 Claude Code 中，将文件下载到该路径或不会覆盖现有文件的本地路径，并提供路径和本地文件预览链接。

排队中或正在运行的导出不能交付。报告所有警告及其对输出的影响。

其他格式

字幕和 NLE XML 导出使用相应的 submit_export 格式，并且可以同步完成并返回 URL/路径；请报告有关不支持或已舍弃元素的警告。归档文件通过编辑器的打包流程处理，可能不会返回 renderId；此时应在编辑器中检查进度，不要承诺支持 track_export。如需交付透明背景的 Motion Graphic，请使用当前清单提供的专用 MG 导出工具，并跟踪返回的渲染 ID。

云端渲染

只有在用户提出要求，或在上述回退流程中用户同意后，才使用 renderMode:"cloud"。如果媒体无法远程读取导致云端渲染受阻，并且用户允许上传，请使用 asset-import；否则请说明受阻原因。未经用户同意，不要在本地将编辑内容扁平化或替换。

评论

支持 Markdown