tella

Tella 视频编辑器

使用 Tella MCP 来了解、编辑和验证视频。按用户指定的范围操作；用户要求分析并不代表允许编辑。

开始之前：连接 Tella MCP

此技能通过 https://api.tella.com/mcp 上的 MCP 服务驱动 Tella（Streamable HTTP、OAuth）。如果没有 get_timeline 等 Tella MCP 工具，请先连接服务：

• Claude Code：claude mcp add --transport http --scope user tella https://api.tella.com/mcp
• Codex：codex mcp add tella --url https://api.tella.com/mcp
• Cursor、Claude Desktop：添加一个运行 npx mcp-remote https://api.tella.com/mcp 的 mcpServers 条目
• 其他情况：使用任意 Streamable HTTP MCP 客户端；个人 API 密钥（tella_pk_…，可在 Tella 的 Settings → API Keys 中创建）可用作 bearer token

首次连接时，浏览器会打开 Tella，供你登录并选择工作区。完整工具参考见 https://www.tella.com/docs/mcp-server。

操作方法

要全面了解视频，请先调用 get_timeline 和一次或多次 get_storyboard。需要查看精确静帧时使用 get_video_frame；需要查看动态、音频、转场或剪辑衔接时使用 get_video_preview。GIF 帧仅供缩略图使用，不用于分析。只有实际打开并查看 MP4 后，返回的预览 URL 才能算作已验证。只检查任务要求和剩余疑问所需的内容。

根据用户希望达到的效果来理解非正式的编辑用语，不要将其视为固定预设。如果用户提出“完整编辑”“自动编辑”或“粗剪”等要求，但仍存在会显著影响处理方式的选择，请先检查视频，再提出建议的编辑方案及相关选项：节奏和可删减的内容；布局、缩放或裁剪；B-roll、文字或媒体叠加；音频、字幕或章节；以及适用时的格式，例如宽高比。描述方案会做什么，不要描述会省略什么：如果用户可能需要，可选择询问是否处理发布细节，例如元数据、缩略图、字幕交付或导出，而不要将其作为免责声明。对于“叠加”之类含义不明的词语，先予以澄清，然后在首次写入前请用户批准或调整范围。将用户的选择转化为工具操作，而不是让用户来设计编辑方案。将已批准的方案视为工作范围；如果要实质性偏离其预期节奏、时长或处理方式，必须再次确认。

范围明确后，在保留视频含义的前提下，完成连贯且可观看的初稿。将检测到的填充词和静音视为可考虑编辑的内容，而不是自动删除的对象：停顿可能表达思考、反应、等待或可见的系统行为。要查找并删除重录、起句失误及其他录制错误，请使用 tella-remove-mistakes 技能。用户要求一次性自动剪切或精简整段录制内容时，请使用 tella-auto-cut 技能：该技能无需事先询问，就会剪掉错误、填充词和静音，然后整理剪辑衔接。“用于 YouTube”表示面向受众的节奏和呈现方式，并非固定公式。

每个片段都有一个基础布局，地址为 layoutId: "base"：使用 update_layout 更改基础布局；使用带时间范围的 add_layout 仅更改片段中的某一部分。用户会使用编辑器选择器中的标签来命名布局，例如“Split Right Overlap”；应使用工具说明中与该标签对应的类型和样式，而不是最接近的默认变体。要自动布局片段，请使用 tella-auto-layouts 技能。

制作动态图形（动画文字、标题、示意图、数字标注、屏幕注释）时，先加载 tella-motion-design 技能以了解通用规则，然后加载相应图形的技能：tella-kinetic-type、tella-title-cards、tella-explainer-graphics、tella-data-callouts 或 tella-screen-callouts。

将“B-roll”视为辅助媒体，它通常应放在包含媒体的布局中，占据或共享主要画面区域。如果媒体需要浮在主场景上方，则使用叠加。 当用户要求其他格式，或其他格式明显更适合目标平台时，update_video 的尺寸可以改变输出画布和宽高比，例如，9:16 的移动视频可设为 1080×1920。非常规尺寸可能是有意设置的，包括 Tella 的 Auto 比例；除非用户要求或目标格式有此要求，否则不要将其规范化。更改尺寸会重新映射现有布局，而不是更改源素材，因此之后要检查并调整布局。

对于事件驱动的编辑，如果有可用的鼠标事件和转录时间等录制元数据，应优先使用，然后检查视频中相关片段，再放置效果。要制作衍生片段或短视频，请复制原视频，而不是直接改用原视频。要将视频转换为竖屏 Short、Reel 或 TikTok，请使用 tella-short skill。

编辑前先确定时间域：视频级检查使用累计视频播放时间；大多数片段编辑使用应用剪切后的片段本地播放时间；update_clip 的剪切定义使用原始录制时间。将同一播放状态下测得的剪切范围一起应用，剪切后重新读取时间线，再计算其他范围。

进行影响时间或构图的结构性更改后，先重新读取并检查结果，再放置依赖于此的缩放、叠加层、章节或缩略图。

如果某项设置同时存在于视频和片段级别，片段值会覆盖视频默认值或选择不沿用默认值。先检查现有值，然后只更新目标范围最小的层级，不要习惯性地同时写入两处。

如果写入结果不明确，请先重新读取当前状态，再重试；切勿盲目重复会新增内容或执行剪切的操作。有些更改会异步处理，因此请等待渲染结果完成后再进行评估。

编辑后，重新读取时间线，并使用适当的工具检查受影响的范围。持续迭代，直到呈现所请求的结果，且没有明显问题。报告所做的更改、检查实际确认的内容，以及任何尚存的不确定性。