一句话剪完一条口播视频：Pireel 让 Codex 和 Claude Code 直接当剪辑师
编辑标准与来源政策: 编辑标准, 团队. 内容均链至原始来源，见 方法论.
Last checked: 2026-07-23
Pireel 把视频剪辑暴露为 MCP 工具：用户可以让 Codex、Claude Code 或其他 MCP Agent 读取口播转录，删除片段，做 storyboard、插入设计图形、生成字幕、切主题并导出。所谓“一句话剪完”不是模型只调用一次，而是 Agent 把一句目标拆成一串可观察操作，再把结果实时写到 Pireel Studio 画布或离线云项目。
截至 2026-07-23，Pireel Studio 主仓库约有 552 stars、42 forks，前端以 TypeScript 为主，编辑、预览和 WebCodecs 导出可在浏览器本地运行。主仓库当前明确采用 AGPL-3.0-only，不是旧规格里曾记录的 Apache-2.0。团队在部署、分发、修改或商用集成前必须再次核对仓库 LICENSE 和法律义务，不能依据旧截图批准上线。
图片来源：Pireel Studio GitHub 仓库，访问 2026-07-23。它证明当日主仓库描述与 AGPL-3.0-only 状态，不证明未来许可证不变，也不替代法律审查。
从安装到 OAuth：Agent 先要连上编辑器
Pireel Agent 仓库提供多种安装路径。通用方式是 npx skills add pireel/pireel-agent，再让 Agent 执行 “set up Pireel”。Codex 可以添加 plugin marketplace、安装 pireel 并运行 codex mcp login pireel；Claude Code 可用 HTTP transport 把 MCP 地址指向 https://pireel.com/api/studio/mcp。首次连接都需要在浏览器完成 OAuth。
# Codex
codex plugin marketplace add https://github.com/pireel/pireel-agent
codex plugin install pireel
codex mcp login pireel
# Claude Code
claude mcp add --transport http pireel https://pireel.com/api/studio/mcp
安装后先调用 get_state。返回 composition snapshot 代表已连接打开的 Studio tab；返回 OFFLINE MODE代表连接有效但正在直接处理最近的云项目；返回 no cloud project则需要先导入视频。这个状态检查应成为每个自动任务的前置，而不是等到写完计划才发现没有项目。
| 状态 | 能做什么 | 关键限制 | 决策 |
|---|---|---|---|
| Live canvas | 修改立即出现在打开的 Studio | 浏览器 tab 必须保持可用 | 适合交互精修 |
| Offline mode | 数据层工具可操作云项目 | 依赖视频画面的工具会要求打开 tab | 适合脚本化粗剪 |
| 本地开源 Studio | 浏览器本地编辑与 WebCodecs 导出 | 生成/转录 provider 需自行接入 | 适合隐私与二次开发 |
| 无项目 | 只能完成连接检查 | 没有媒体与时间线 | 先导入并验元数据 |
| OAuth 失效 | MCP 不应继续写项目 | 可能出现部分工具失败 | 重新认证并确认项目 ID |
图片来源：Pireel 官方网站，访问 2026-07-23。它证明产品界面与能力呈现，不证明任意输入都能自动得到发布级成片。
Live 和 offline 不是同一种编辑体验
打开 Studio tab 时，Agent 的编辑会实时进入画布，用户能看到删除、字幕、graphics 和主题变化。这适合在每个重要操作后目视确认。离线模式能继续对云项目做数据级操作，例如读取状态、调整已结构化的片段或计划；需要实际视频帧、浏览器预览或某些导出操作时，工具会要求打开 tab。
因此自动化脚本要按能力分类，而不是把 offline 当成“完全没有浏览器依赖”。任务开始记录模式，切模式时重新读取状态和 revision。若用户在画布手动修改，Agent 应先刷新项目状态，避免用旧时间线覆盖新改动。
开源 Studio 本身强调 backend-free：draft 在 localStorage，视频 bytes 在 OPFS，编辑与 Chromium WebCodecs 导出在客户端。生成 block composition、narration planning、transcription、云媒体库、跨设备同步和图像/视频生成需要注入 providers 或使用托管路径。主仓库 shell 默认 unavailableProviders()，并不是 clone 后所有云能力立即可用。
转录、分镜、字幕与素材导入的正确顺序
一个可靠口播流程先 probe 媒体：时长、分辨率、帧率、音轨、旋转信息和文件哈希。导入 helper 要求 Node 20+、单文件不超过 2 GB；本地存在 ffmpeg 时会探测元数据并转录音频。2 GB 是导入边界，不代表浏览器在低内存设备上能顺畅编辑接近上限的 4K 长视频。
转录完成后，先冻结“必须保留的 claims”和禁删词，再按 transcript 的字词时间戳标记 filler、重复、停顿和候选句。粗剪先只删有明确文本边界的段落。第二步生成 storyboard，把每个保留 claim 映射到 shot、caption 和 graphic；第三步应用主题和 kinetic captions；最后逐切口检查音频是否削掉词头词尾。
字幕不是把转录全文直接铺上屏。竖屏需要控制每行字符数、断句、停留时间、底部安全区和中英混排。caption drift 通常来自编辑后仍使用旧时间戳，因此删除或移动片段后要重新映射。任何无法回到原始音频片段的字幕，都应标为待人工确认。
图片来源：Pireel Agent 连接指南，访问 2026-07-23。它证明官方流程与工具边界，不证明每个生成 provider 免费或在离线开源 shell 可用。
收费边界必须在执行前显示
官方 Agent README 说明，使用自己的 Agent subscription 进行 orchestrate，以及 compose_block_brief -> generate -> apply_block、plan_brief -> submit_plan、visual_brief -> submit_visual等 BYO 流程，不消耗 Pireel credits。只有工具描述带 […CHARGES…]标记的动作收取 Pireel credits，例子包括图像/视频生成和 Pireel-LLM fallback。
这一区分要在自动执行器里变成硬规则：调用 charged 工具前显示动作、预计次数、项目和成本单位，并要求显式批准；失败重试不能偷偷再次收费。日志保存工具名、charge marker、批准人、调用时间和结果。若某工具的收费标记缺失或与账单不一致，任务立即暂停。
许可证也按仓库范围记录。Pireel Studio 主仓在 2026-07-23 为 AGPL-3.0-only。MCP Agent、托管服务、依赖包和生成内容可能另有条款，不能用一个仓库的许可证替代整条供应链审查。尤其是把修改后的 Studio 部署给网络用户、嵌入商业产品或分发客户端时，应让法律团队按实际架构复核 AGPL 义务。
14 分钟口播压成 90 秒竖版成片
内容制作人提供一段 14 分钟、1920×1080、30fps 的中文口播，大小 860 MB，并写出五个必须保留的产品 claims。目标是 90 秒、1080×1920 竖版、带烧录字幕和一份 review export。Agent 先导入、验证哈希和时长，再输出 transcript；制作人批准必须保留句与不可改写数字后，Agent 才能粗剪。
剪辑预算为：开头 hook 8 秒，五个 claims 合计 62 秒，转场和呼吸 12 秒，结尾 CTA 8 秒。Agent 删除 filler、重复解释和无信息停顿，把横版人物裁切到安全区，为每个 claim 建一个 storyboard block，字幕每行不超过 16 个汉字。所有生成素材先用 placeholder，避免在结构尚未批准前触发收费工具。
验收要求：最终时长 88 至 92 秒；五个 claims 在 transcript diff 中逐字可追溯；数字、专名不改；所有切口前后各听 500ms，不能削词；字幕和语音漂移不超过 120ms；画布、导出均为 9:16；只生成一个 review 版本。上传失败、转录缺失超过 1%、caption drift、任何 claim 消失、宽高比错误，或未标记 charged action 都是暂停信号。
制作人收到的不只是 mp4，还包括源文件哈希、编辑前后 transcript diff、保留 claims 清单、时间线 revision、收费调用日志和失败样本。这样“一句话剪完”才是可审核工作流，而不是无法解释的黑箱成片。
失败处理与回滚
导入失败先检查 2 GB、Node 版本、OAuth、网络和 ffmpeg，不应反复上传同一大文件。content-addressed upload 可用哈希避免重复。转录为空时保留原媒体并单独重跑音频，不要创建一条全空时间线。浏览器 tab 断开时，先读取 offline state；不能执行的视频工具排队但不自动循环。
每轮批量修改前保存 revision，应用后检查项目 ID、duration、track 数和必保 claim。若字幕漂移或切口破坏语义，回滚到上一 revision，而不是在错误时间线上继续叠加。导出失败保留项目状态和诊断，不重新生成 storyboard。
想比较更多 AI 产品工作流，可继续阅读 2026 年 AI 圈最受关注的创新应用。
常见问题 FAQ
Pireel 真能只用一句话剪视频吗？
一句话可以定义目标，但 Agent 会调用多个 MCP 工具完成导入、转录、剪切、分镜、字幕和导出。关键步骤仍需要状态检查和验收。
Codex 和 Claude Code 都能连接吗？
可以。Codex 有 plugin marketplace 和 codex mcp login路径；Claude Code 可添加 HTTP MCP。两者首次连接都涉及 OAuth。
不打开浏览器也能剪吗？
offline mode 支持数据层工具，但依赖实际视频画面、实时预览或特定导出的工具可能要求 Studio tab。不能把 offline 写成完全无浏览器依赖。
所有 Agent 操作都收费吗？
不是。BYO Agent 编排和文档列出的 BYO flow 使用自己的 Agent subscription；带 […CHARGES…]标记的生成或 fallback 工具才消耗 Pireel credits。执行前仍要检查当前描述。
Pireel 是什么许可证？
截至 2026-07-23，Pireel Studio 主仓库为 AGPL-3.0-only。部署、分发、修改和商用前必须复核当前 LICENSE、具体组件与服务条款。
来源 Sources
- GitHub：pireel/pireel，访问 2026-07-23。
- Pireel Studio LICENSE，访问 2026-07-23，主仓库标为 AGPL-3.0-only。
- GitHub：pireel/pireel-agent，访问 2026-07-23。
- Pireel Agent connect guide，访问 2026-07-23。
- Pireel Studio，访问 2026-07-23。