PandaStudio 是一款桌面视频编辑器,定位于 YouTube、Shorts、TikTok、Reels、LinkedIn 和 Loom 风格内容的制作。本技能用于让智能体在 PandaStudio 中执行视频编辑任务。
一、接口选择(优先判断运行环境) 在 PandaStudio 应用内部(即应用内置智能体,应用自身说明及 pandastudio MCP 工具已连接):每个动作都应调用 MCP 工具,并通过工具检索加载所需工具。单个调用不要通过 shell 运行 pandastudio CLI,因为每条命令可能等待用户审批,而 MCP 会把结果直接返回聊天。CLI 仅用于循环大量调用的脚本。 在应用外部(终端中的 Claude Code、Cursor、Codex):优先使用 pandastudio CLI(本地 HTTP),一个 bash 工具即可覆盖约 240 个动词,无需在上下文中携带逐工具的 schema。可用 command -v pandastudio 或 pandastudio system.status --json 探测一次。其次才是 MCP 服务器,工具前缀为 mcp__pandastudio__(1.89.4 之前的配置可能显示 mcp__writepanda__,是同一批工具),仅在 CLI 未安装时使用。CLI 动词转 MCP 工具只需把点换成下划线,例如 project.add-zoom 对应 project_add_zoom,参数名与行为一致。不要在文件系统中搜索 CLI。
二、版本与授权 本技能需要 @writepanda/cli 或 @writepanda/mcp 1.15.0 及以上;原生动效动词(关键帧、变速、蒙版、调整图层)需要应用 2.0。任何工具调用前先运行 pandastudio system.status --json 并读取 license:licensed 为 true 时功能完整;false 且 trialUsesRemaining 大于 0 为试用中,导出质量仅限 draft(720p);automationGated 为 true 表示试用过期且无授权,仅 system.* 与 window.focus 可用;agentEditing.allowed 为 false 表示 Solo 套餐(AppSumo 或 DealFuel 的 49 美元入门档)不含智能体编辑,其他命令会以 agent_not_in_plan 失败。
三、工作区与项目定位 v1.19+ 起,所有项目、导出、动态图形、字幕、音频查询都在当前工作区内运行。机构可为每个客户保留一个工作区,避免凭据、导出和 YouTube 连接混用。工作区数量上限:Starter/Trial 为 1,Creator 为 3,Team 无限制。给定项目 id 且无其他上下文时,先运行 project.locate --id=$PID;若 isInActiveWorkspace 为 false,应停止并询问后再切换。发布、图像生成、缩略图和 YouTube 账号使用当前工作区凭据。
四、主要能力 动态图形分两种模式:模式 A 是在素材之上叠加图形(口播或屏幕录制),功能性元素(姓名条、订阅/关注、数字、倒计时、片尾卡)默认使用内置模板(motion.list → motion.generate → job.wait → project.add-motion-graphic --fromJob);若模板不匹配具体表达,可用 motion.render-html 自行创作。模式 B 是从零构建视频(宣传片、发布、预告、应用广告、讲解、片头片尾、CTA),通过 motion.render-html 手工创作场景,遵循发布影片语法,并使用 lf-kit.js 原语。无脸视频属于模式 B,但由图像驱动:每个节拍一张生成图像加 Ken Burns 与配音。 其他能力包括:并发编辑保存冲突重试(仅重试冲突命令,最多三次),异步转写、配音、音频清理与渲染图形,人脸追踪与自动重构,下载素材放置。transcript.transcribe 支持显式指定语言与 provider(本地 Parakeet、cloud 的 deepgram/elevenlabs、Apple 设备端语音,Mac 专用)。 录制方面支持区域录制 recording.start,坐标以显示器本地点为单位,最小 32x32,支持 Free、16:9、9:16、1:1、4:3 预设,可通过 recording.list-sources、recording.stop 完成录制并生成项目。 clips.make 可对长视频文件一键完成导入、转写、取标题、寻找全片最强的自包含片段(按句对齐、0-100 评分),并分别派生为指定格式的项目(含字幕与人脸跟随构图),默认 15-30 秒、9:16、Glow Stack。
五、使用方式与限制 每次涉及项目变更的回合结束时,应用变更摘要告知用户:Changed(每项编辑及工具返回的计数)、Not changed(尝试后回退或跳过的内容及原因)、Left to do 或 done。破坏性操作(project.delete、workspace.delete、recipe.delete、memory.forget、export.delete、export.clear-thumbnail、youtube.disconnect、social.disconnect、instagram.disconnect)必须先明确询问用户,且只在其同意后调用,应用自身还会再次请求确认。不要在未询问的情况下切换转写 provider(会把音频发送给第三方并计费)。当语言为设备端模型较弱者(泰米尔语、泰卢固语、卡纳达语、马拉雅拉姆语)时应提前说明。
六、其他 工作区可保存品牌套件(颜色、字体、logo、声音)与 savedColors(最多 24 个十六进制颜色)以及品牌媒体资源,用于字幕、图形、下三分之一和缩略图;workspace.capture-brand --url=<site> 可从网站异步提取品牌。项目查找默认值、文件夹组织、重命名、转写语言设置、独立文件转写与预览代理等详情见相应参考文档。
未在资料中提供的功能、收费、价格、平台或效果信息暂未提供。