Chengfeng Videocut Skills

chengfeng-videocut

给 Codex 用的中文口播剪辑 Marketplace 插件。

Plugin 根入口、四个业务入口和两个支持入口组成；共同规则是内部 reference，不占用户 Skill：

Plugin 根名  -> 安装与 UI 群组名，不是同名 Skill
剪口播      -> 已复核的删词账本
字幕        -> subtitles.json
画面        -> visuals.json + HTML 模块
导出        -> 成片.mp4
上报 Bug    -> 脱敏草稿 -> 用户确认 -> GitHub Issue URL
检查更新    -> Marketplace 快照 -> 来源证明 -> 用户确认 -> 复读版本
共同规则    -> references/，不注册为 Skill

插件不复制剪辑产品本体。四个业务 Skill 负责判断和编排，确定性动作由 `chengfeng-videocut` Runtime 的 CLI / API 执行；只有进入人工审核阶段且 Studio 能力匹配时才打开界面。Bug 支持 Skill 不安装 Runtime、不启动 Studio，也不改项目。

安装

一行命令装插件（挂市场 + materialize 精确快照 + 安装，`&&` 串联，前一步成功才继续）。 播放器 / Studio 不需要单独装：第一次让 Agent 真正干活（剪口播、导出等）时， 「检查更新」的就绪检查会自动从固定版本的 GitHub Release 下载、SHA-256 校验并安装， 只是那一次任务要先等几分钟安装。

**系统要求：macOS**（Apple Silicon / Intel）**或 Windows 10/11**。 Windows 支持自 Runtime v0.4.2 起正式可用（真机验收：安装、常驻服务、崩溃自愈、 重启自启、建档、导出成片全链通过）。虚拟机里试用 Windows 11 24H2+ 需先关 VBS： `bcdedit /set {default} hypervisorlaunchtype off`（物理机不受影响）。

推荐安装桌面预览包：它自带 Runtime、Bun、FFmpeg 与 FFprobe，并把它们安装到 `~/.chengfeng-videocut` 的统一受管目录；Plugin 与桌面 App 复用同一个稳定 CLI 和 后台服务，不需要把这些可执行文件加入系统 PATH。

桌面路径仍需要 Node.js 运行 Skill 脚本 / MCP Server，需要 Chrome 导出字幕和动画。 只使用 Plugin + CLI 便携包时，还需自行准备 Bun 与 FFmpeg：

依赖	用途	要求
Bun	运行产品 Runtime；桌面包已内置	≥ 1.2
Node.js	Skill 脚本、MCP Server 与 Runtime 安装器	≥ 20
ffmpeg	剪辑与导出；桌面包已内置	≥ 6（含 ffprobe）
Google Chrome	导出成片时渲染字幕和动画	桌面版

# 仅 Plugin + CLI 路径需要手工补齐这些依赖
# macOS
brew install oven-sh/bun/bun node ffmpeg      # Chrome 从官网装
# Windows（装完新开一个终端，PATH 才生效）
winget install Oven-sh.Bun OpenJS.NodeJS.LTS Gyan.FFmpeg Google.Chrome

**Runtime 装不上时，Agent 应停在安装指引上**——用自制审核页/播放器替代产品属于违反 Skill 合同的行为（真实发生过：Runtime 缺失时 Agent 手搓了一个"审片台"，产出与产品 完全不兼容）。遇到这种情况，把 Agent 的报错原文发 Issue。

本次待发布 Plugin 是 `0.10.8`。内容提交 A 为 `a513462f65b6f50083a20ac8da6ec3c32d2ddcde`，带 provenance 的 Marketplace 快照 B 为 `1487e02b1c0c39ea74d079e8ce45da56bf59bc32`；Bootstrap manifest 永久固定 到 B。候选验证环境可使用 Codex Marketplace 安装：

codex plugi