pireel

Pireel Studio

Pireel Studio（https://pireel.com）是一款多源、多轨视频编辑器，可从一个项目中生成多个可独立编辑的剪辑。你的工具通过 pireel MCP 服务，在用户打开的工作室浏览器标签页中实时编辑合成内容；如果没有打开标签页，数据级工具会回退到针对用户最新项目的离线模式。

本技能涵盖整个产品。先浏览下面的要点，然后针对当前任务打开 references/ 中对应的文件——处理专门流程时不要凭记忆操作。

基本要点（适用于所有情况）

• 编辑内容。 由不同类型片段组成的轨道：主视频叙事主线（role=primary）、并行 B-roll / 画中画（role=broll）、图形轨道、旁白 / 音乐 / 音效音频轨道，以及一条托管式字幕轨道。片段类型：叙事（口述故事素材）、媒体（任意轨道上的视频或图像）、图形——即组件（目前运动图形是主要的组件类别）、音频和文本（使用 set_texts 设置的原生标题）。每个片段在时间线上占用整数帧 [start, end)，并以秒为单位保留自己的源素材时钟；媒体片段包含取景方式（full / punch-in / corner-* / split-* 处理方式，或通过 set_clip_framing 设置精确变换 / 裁剪）、速度、颜色滤镜和音频处理（set_clip_properties）。叙事主线片段之间默认采用硬切；如果时间、地点、章节或模式的变化适合添加转场，可使用 add_transition。
• 语音是一种编辑方式，而非入口。 如果素材包含语音，可通过转录稿使用 get_transcript + remove_words 进行编辑（不要按帧编辑）。如果不包含语音——例如 B-roll、产品素材、屏幕录制、音乐蒙太奇——则使用相同的片段工具（add_clips / insert_clips / split_clips / move_clips / ripple_delete_ranges / set_clip_properties / set_clip_framing / add_clips {role:"music"}），按时间、画面和声音编辑。编辑无语音素材前，绝不要索要脚本或转录稿；get_transcript 报告没有覆盖内容是有用信息，不是错误。
• 每个会话调用一次 get_state，之后根据增量更新。 每次变更都会返回增量（受影响的片段、移位规则、removedClipIds、removedSource、字幕变更）；只有在变更失败、切换输出/项目、撤销操作，或回执说明状态已过期时，才重新读取 get_state。片段 / 轨道 / 组件 / 帧 / 预设的 ID 来自 get_state、工具回执、manage_frame {action:"list"} 或字幕目录。绝不要虚构 ID。
• 两种时钟。 “编辑时间” = 时间线帧（startFrame / atFrame / fromFrame / toFrame / durationFrames——add_clips、split_clips、ripple_delete_ranges、move_clips、apply_component 按帧定位；get_state 会给出 fps，所有工具都会进行转换，切勿自行乘以 fps）。“源时间” = 片段自身源文件的秒数（源素材 [inSec, outSec]；转录稿使用其源素材自己的时钟标记，时间线剪辑不会改变它）。不要混淆两者。
• 自带生成完全免费。 你自行编写的文本 / 标记（组件合成内容、在工作上下文中保留的计划、视觉标签）使用用户自己的 Agent 订阅，不消耗 Pireel 点数。只有描述中带有 […CHARGES…] 标记的工具才会扣点（图像 / 视频 / 音频 / 语音生成，以及 apply_component {generate:true} 等 Pireel-LLM 后备方案）。优先使用自带方案。
• 实际任务中尽早展示编辑器。 调用 create_browser_handoff，并使用你自己的内置 / 嵌入式浏览器工具打开返回的 url——在 Codex 中，使用应用内的 Browser 运行时，而不是已连接的 Chrome。绝不要使用操作系统的 open / start / xdg-open、用户的默认浏览器，或主动使用已连接的外部 Chrome（单次使用票据，有效期约 60 秒）。在本轮结束后，仍保持该标签页可见且打开，并使用其保留 / 完成控件（详情见 references/pireel-basics.md）。绝不要打印交接 URL。

路由——根据任务阅读参考文档

用户想要……	阅读
安装、连接或设置 Pireel，或工具报告未连接	references/getting-started.md
深入了解模型与工具路由（首次编辑前阅读）	references/pireel-basics.md
使用账户的私有/社区 Studio Skill 或其绑定的语音	references/pireel-basics.md
使用本地视频或图像文件	references/asset-import.md
从头到尾编辑以语音为主的视频（访谈、课程、评论、播客、直面镜头）：清理、重组、B-roll、图形、声音	references/craft/talking-head-edit.md
仅清理原始的直面镜头 A-roll（重拍、填充词、空白）	references/talking-head-cleanup.md
根据一批素材剪辑蒙太奇（情绪、主题、节奏、声音）	references/craft/montage-edit.md，然后阅读 references/montage-variants.md 了解输出类别/变体
将多个片段剪辑成产品广告，或创建多个可编辑输出/变体	references/montage-variants.md
编辑没有语音的素材（B-roll、产品镜头、屏幕录制、以音乐为主的素材）	references/pireel-basics.md（片段工具）→ references/craft/montage-edit.md，用于有意编排
添加/匹配背景音乐、音效、单个片段的声音、转场，或与节拍对齐的剪辑	references/craft/audio-and-music.md
添加设计过的图形组件（自带标记）	references/compose-blocks.md
设计或执行完整的初剪/成片	references/storyboard-draft.md
添加/重新设置字幕样式	references/captions.md
导出 MP4	references/export.md
解答价格/额度/套餐/UI 问题	references/product-help.md
处理工具错误、超时或 apply_component lint 拒绝	references/known-errors.md

references/craft/ 原样保存了 Pireel 内置的创作技能——与 Studio 聊天使用的手册相同，也是 list_skills / read_skill 通过 MCP 提供的内容。请阅读本地副本（无需往返调用）；如果 MCP 服务公布的工作流基线与已安装的 VERSION 不同，请优先使用 read_skill 获取最新文本。

本地媒体导入辅助脚本位于 scripts/import-media.mjs（Node ≥ 20，无依赖项）。

定位参考文档。 上述每个路径（references/…、scripts/…）都相对于此技能自身的目录，即包含此 SKILL.md 的文件夹。如果 Agent 将技能目录交给你，直接读取其中的文件即可。如果没有，请先定位此技能，然后解析路径，例如 find ~ -path '*/skills/pireel/SKILL.md' 2>/dev/null（Codex/Claude Code 会将技能作为普通文件安装到磁盘上）；参考文档就在此文件旁边的 references/ 中，references/product-help/ 存放价格/UI 子文档。

计费

Agent 编排和所有自带流程均使用用户自己的 Agent 订阅，而非 Pireel 额度。Pireel 仅对媒体生成（图像/视频）以及音频/视觉处理流程（转录、视觉分析）收费。详情请见 references/product-help.md。

保持此工作流为最新版本

Plugin bundle 由其宿主更新——请跳过此步骤。如果宿主报告了 Plugin 身份，或此 SKILL.md 上两级目录中存在 plugin manifest，则你使用的就是 Plugin bundle。

否则，服务会公布其工作流基线，且此 SKILL.md 旁边的 VERSION 文件属于你。两者都是不透明的发布标记：只比较是否相等，切勿比较先后顺序。如果两者不同，请通过宿主的常规命令审批流程运行 npx skills update pireel（备用命令：npx skills add pireel/pireel-agent），然后重新阅读更新后的文件。尝试一次后——或机制不可用、或缺少 VERSION 文件时——提及一次并继续。两者匹配时不要反复提醒。