Skip to content

JimLiu/baocut / skills/baocut

baocut

Flagged

用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。

FileKindSize
SKILL.mdskill md46.5 KB
built-in-skills/README.mdmarkdown9.6 KB
references/catalog/editing.mdmarkdown24.4 KB
references/catalog/export.mdmarkdown6.6 KB
references/catalog/media.mdmarkdown45.1 KB
references/catalog/models.mdmarkdown7.9 KB
references/catalog/music.mdmarkdown17.1 KB
references/catalog/subtitles.mdmarkdown20.8 KB
references/catalog/system.mdmarkdown9.6 KB
references/catalog/voice-gemini-tts.mdmarkdown2.6 KB
references/catalog/voice-language-rates.mdmarkdown6.5 KB
references/catalog/voice.mdmarkdown12.3 KB
references/catalog/web.mdmarkdown10.9 KB
references/conventions.mdmarkdown16.1 KB
references/craft/.gitkeepother0 B
references/craft/README.mdmarkdown480 B
references/craft/character-animation.mdmarkdown6.8 KB
references/craft/character-animation/examples/mini-film/art.example.jsonconfig918 B
references/craft/character-animation/examples/mini-film/index.htmlother628 B
references/craft/character-animation/examples/mini-film/scene.jsscript2.1 KB
references/craft/character-animation/references/art.mdmarkdown4.6 KB
references/craft/character-animation/references/checks.mdmarkdown2.6 KB
references/craft/character-animation/references/rig.mdmarkdown5.3 KB
references/craft/character-animation/references/style-and-story.mdmarkdown5.0 KB
references/craft/character-animation/references/timing-and-sound.mdmarkdown3.1 KB
references/craft/character-animation/rig-kit/rig-kit.jsscript33.0 KB
references/craft/character-animation/scripts/cutout.mjsscript26.9 KB
references/craft/character-animation/scripts/jump-scan.mjsscript3.2 KB
references/craft/character-animation/scripts/place-sfx.mjsscript5.1 KB
references/craft/character-animation/scripts/rig-check.mjsscript8.9 KB
references/craft/clip-montage.mdmarkdown11.5 KB
references/craft/clip-montage/references/assembly.mdmarkdown5.0 KB
references/craft/clip-montage/references/sourcing.mdmarkdown6.3 KB
references/craft/clip-montage/references/structure.mdmarkdown3.8 KB
references/craft/cover-and-title.mdmarkdown5.6 KB
references/craft/cross-video-qa.mdmarkdown5.8 KB
references/craft/design-system.mdmarkdown18.5 KB
references/craft/design-system/references/cover.mdmarkdown6.9 KB
references/craft/design-system/references/craft.mdmarkdown8.8 KB
references/craft/design-system/references/demo.jsonconfig161.1 KB
references/craft/design-system/references/format.mdmarkdown18.6 KB
references/craft/design-system/references/from-code.mdmarkdown11.5 KB
references/craft/design-system/references/from-design-tool.mdmarkdown16.2 KB
references/craft/design-system/references/sample-seazar-tokens.jsonconfig11.0 KB
references/craft/design.mdmarkdown19.3 KB
references/craft/design/references/brand-colors.mdmarkdown2.4 KB
references/craft/design/references/brand-typography.mdmarkdown1.7 KB
references/craft/design/references/craft.mdmarkdown15.4 KB
references/craft/design/references/design-system-components.mdmarkdown11.8 KB
references/craft/design/references/diagrams.mdmarkdown10.1 KB
references/craft/design/references/format.mdmarkdown11.8 KB
references/craft/design/references/print.mdmarkdown5.6 KB
references/craft/design/references/questions.mdmarkdown4.7 KB
references/craft/design/references/view-state.mdmarkdown5.7 KB
references/craft/docs.mdmarkdown19.9 KB
references/craft/docs/references/comments.mdmarkdown4.4 KB
references/craft/docs/references/editing.mdmarkdown12.9 KB
references/craft/docs/references/tabs.mdmarkdown4.7 KB
references/craft/docs/references/uploads.mdmarkdown1.7 KB
references/craft/explainer-video.mdmarkdown23.4 KB
references/craft/explainer-video/references/3d.mdmarkdown5.9 KB
references/craft/explainer-video/references/footage.mdmarkdown9.6 KB
references/craft/explainer-video/references/length-and-pace.mdmarkdown6.7 KB
references/craft/explainer-video/references/script.mdmarkdown14.7 KB
references/craft/explainer-video/references/subject.mdmarkdown12.5 KB
references/craft/history-video.mdmarkdown20.6 KB
references/craft/history-video/references/brief.mdmarkdown5.1 KB
references/craft/history-video/references/forms.mdmarkdown11.2 KB
references/craft/history-video/references/old-recordings.mdmarkdown12.4 KB
references/craft/history-video/references/self-check.mdmarkdown5.3 KB
references/craft/history-video/references/sources.mdmarkdown5.9 KB
references/craft/motion-graphics.mdmarkdown17.3 KB
references/craft/motion-graphics/exemplars/big-number/16x9.htmlother11.4 KB
references/craft/motion-graphics/exemplars/big-number/9x16.htmlother11.5 KB
references/craft/motion-graphics/exemplars/callout-pin/16x9.htmlother11.6 KB
references/craft/motion-graphics/exemplars/callout-pin/9x16.htmlother11.6 KB
references/craft/motion-graphics/exemplars/keyword-caption/16x9.htmlother11.3 KB
references/craft/motion-graphics/exemplars/keyword-caption/9x16.htmlother11.3 KB
references/craft/motion-graphics/exemplars/logo-sting/16x9.htmlother12.1 KB
references/craft/motion-graphics/exemplars/logo-sting/9x16.htmlother12.1 KB
references/craft/motion-graphics/exemplars/lower-third/16x9.htmlother11.2 KB
references/craft/motion-graphics/exemplars/lower-third/9x16.htmlother11.2 KB
references/craft/motion-graphics/references/audio-backdrop.mdmarkdown22.9 KB
references/craft/motion-graphics/references/grammar.mdmarkdown11.1 KB
references/craft/motion-graphics/scaffold.htmlother9.0 KB
references/craft/motion-graphics/scripts/build-bundle.mjsscript25.2 KB
references/craft/narration.mdmarkdown11.1 KB
references/craft/polish-transcript.mdmarkdown13.8 KB
references/craft/production-scripts.mdmarkdown15.7 KB
references/craft/production-scripts/references/pipeline.mdmarkdown37.8 KB
references/craft/production-scripts/scene-kit/geo110.jsscript27.3 KB
references/craft/production-scripts/scene-kit/scene-kit.jsscript38.3 KB
references/craft/production-scripts/scripts/align.mjsscript11.6 KB
references/craft/production-scripts/scripts/assemble.mjsscript26.4 KB
references/craft/production-scripts/scripts/build.mjsscript18.1 KB
references/craft/production-scripts/scripts/captions.mjsscript18.6 KB
references/craft/production-scripts/scripts/clips.example.jsonconfig3.2 KB
references/craft/production-scripts/scripts/coverage.mjsscript10.0 KB
references/craft/production-scripts/scripts/envelope.mjsscript2.9 KB
references/craft/production-scripts/scripts/explainer.example.jsonconfig2.2 KB
references/craft/production-scripts/scripts/fonts.mjsscript7.0 KB
references/craft/production-scripts/scripts/frames.mjsscript7.7 KB
references/craft/production-scripts/scripts/gaps.mjsscript11.3 KB
references/craft/production-scripts/scripts/host.mjsscript14.8 KB
references/craft/production-scripts/scripts/legibility.mjsscript5.7 KB
references/craft/production-scripts/scripts/level.mjsscript9.2 KB
references/craft/production-scripts/scripts/lib.mjsscript19.3 KB
references/craft/production-scripts/scripts/overlay.mjsscript34.7 KB
references/craft/production-scripts/scripts/preview.mjsscript4.6 KB
references/craft/production-scripts/scripts/quotes.mjsscript7.4 KB
references/craft/production-scripts/scripts/sources.mjsscript6.2 KB
references/craft/production-scripts/scripts/srt.mjsscript5.8 KB
references/craft/production-scripts/scripts/voice.mjsscript7.7 KB
references/craft/shorts-segments.mdmarkdown30.8 KB
references/craft/slides.mdmarkdown13.8 KB
references/craft/slides/references/design-system.mdmarkdown6.3 KB
references/craft/slides/references/design.mdmarkdown9.3 KB
references/craft/slides/references/format.mdmarkdown12.2 KB
references/craft/slides/references/images.mdmarkdown4.2 KB
references/craft/speaker-labeling.mdmarkdown6.6 KB
references/craft/subtitle-workflow.mdmarkdown13.1 KB
references/craft/talking-head-cut.mdmarkdown9.3 KB
references/craft/talking-head-cut/references/picture-and-sound.mdmarkdown10.1 KB
references/craft/titles-and-description.mdmarkdown5.2 KB
references/craft/titles-and-description/references/description.mdmarkdown5.1 KB
references/craft/titles-and-description/references/titles.mdmarkdown5.5 KB
references/craft/titles-and-description/references/writing-baseline.mdmarkdown11.9 KB
references/craft/translate-subtitles.mdmarkdown13.4 KB
references/craft/video-blog.mdmarkdown17.1 KB
references/craft/video-blog/references/writing-baseline.mdmarkdown11.9 KB
references/craft/video-chapters.mdmarkdown9.7 KB
references/craft/video-production.mdmarkdown31.9 KB
references/craft/video-production/examples/bundle-preview.htmlother17.7 KB
references/craft/video-production/examples/post-fx.jsscript7.5 KB
references/craft/video-production/references/code-scenes.mdmarkdown31.9 KB
references/craft/video-production/references/shot-plan.mdmarkdown5.1 KB
references/craft/video-production/references/sound-design.mdmarkdown4.4 KB
references/craft/video-production/references/visuals.mdmarkdown19.7 KB
references/craft/video-summary.mdmarkdown22.8 KB
references/craft/video-summary/references/writing-baseline.mdmarkdown11.9 KB
references/craft/virtual-host.mdmarkdown14.9 KB
references/craft/virtual-host/examples/character-partmap.example.jsonconfig600 B
references/craft/virtual-host/examples/character.example.jsonconfig336 B
references/craft/virtual-host/references/art.mdmarkdown22.1 KB
references/craft/virtual-host/references/hosts.mdmarkdown4.4 KB
references/craft/virtual-host/references/lipsync.mdmarkdown10.1 KB
references/craft/virtual-host/scripts/lipsync.mjsscript39.8 KB
references/craft/virtual-host/scripts/pinyin-table.mjsscript83.2 KB
references/craft/virtual-host/scripts/puppet-build.mjsscript48.6 KB
references/craft/virtual-host/scripts/puppet-mask.mjsscript3.0 KB
references/craft/virtual-host/scripts/puppet/align.mjsscript4.1 KB
references/craft/virtual-host/scripts/puppet/brows.mjsscript17.2 KB
references/craft/virtual-host/scripts/puppet/edits.mjsscript4.3 KB
references/craft/virtual-host/scripts/puppet/expression-labels.jsonconfig1.1 KB
references/craft/virtual-host/scripts/puppet/expreyes.mjsscript35.9 KB
references/craft/virtual-host/scripts/puppet/eyes.mjsscript8.6 KB
references/craft/virtual-host/scripts/puppet/fill.mjsscript10.5 KB
references/craft/virtual-host/scripts/puppet/layers.mjsscript5.7 KB
references/craft/virtual-host/scripts/puppet/mapbuild.mjsscript50.4 KB
references/craft/virtual-host/scripts/puppet/ops.mjsscript7.4 KB
references/craft/virtual-host/scripts/puppet/pack.mjsscript10.2 KB
references/craft/virtual-host/scripts/puppet/partmap.mjsscript8.5 KB
references/craft/virtual-host/scripts/puppet/parts.mjsscript7.0 KB
references/craft/virtual-host/scripts/puppet/png.mjsscript5.8 KB
references/craft/virtual-host/scripts/puppet/seg.mjsscript21.6 KB
references/craft/virtual-host/scripts/puppet/segment.mjsscript26.6 KB
references/craft/virtual-host/scripts/puppet/zip.mjsscript2.0 KB
references/craft/virtual-host/scripts/visemes.mjsscript21.4 KB
references/craft/vlog-from-clips.mdmarkdown13.2 KB
references/craft/vlog-from-clips/references/footage-log.mdmarkdown3.3 KB
references/mcp.mdmarkdown8.9 KB
references/start.mdmarkdown6.3 KB
references/workflows.mdmarkdown29.8 KB

references/start.md

View on GitHub
# 启动:找到 CLI、版本门与预检

<!-- surface: agent -->
会话内不需要这一页:工具已经连好,Runtime 由 BaoCut 管。能做什么用 {{tool:models_capabilities}} 与 {{tool:models_list}} 查,见 [models](catalog/models.md)。
<!-- /surface -->
<!-- surface: cli -->
## 1. 找到 CLI

1. `command -v baocut`(Windows 上 `where baocut`)。找到就用它;不要把旧版 `bcut` 当成当前 CLI。没找到时再看 BaoCut 放命令的位置(你的 shell 未必读了用户的 PATH 配置):macOS 与 Linux 是 `~/.local/bin/baocut`,Windows 是 `%LOCALAPPDATA%\BaoCut\bin\baocut.cmd`。
2. 找不到时看环境变量 `BAOCUT_CLI`:它给出命令入口的完整路径,带空格时作为一个路径参数传入。
3. 仍没有时,只检查桌面包与独立 CLI 包的固定入口,不递归搜索:
   - macOS:`/Applications/BaoCut.app/Contents/MacOS/baocut-cli`,再看 `~/Applications/BaoCut.app/Contents/MacOS/baocut-cli`。
   - Windows:`%LOCALAPPDATA%\Programs\BaoCut\baocut.cmd`,再看 `%ProgramFiles%\BaoCut\baocut.cmd`。
   - 独立 CLI 包(不带桌面界面的 BaoCut 命令行):macOS 列出 `~/.local/share/baocut/versions/`,用 `state.json` 里 `current` 那个版本的 `BaoCut CLI.app/Contents/MacOS/baocut-cli`;Windows 是 `%LOCALAPPDATA%\BaoCut\cli\current\baocut.cmd`。
4. 非标准安装位置让用户给出入口路径或设置 `BAOCUT_CLI`。桌面包的启动器使用包内的 Electron,不需要系统 Node。用入口的完整路径跑通即可。App 第一次启动时会自己把 `baocut` 装到第 1 步说的位置,用户移除过或那里原本就有别的文件时不装;用户想在终端里直接打 `baocut` 时,征得同意后用这个入口跑一次 `cli install`(放到第 1 步说的位置,不要管理员权限),它会说明还要不要把那个目录加进 PATH。
5. 入口仍不存在:说明所装桌面包没有 CLI,请用户更新到含该入口的桌面包,或使用与 App 匹配的源码 CLI。不要把旧版 Homebrew `bcut` 当成匹配安装方式,不要自己下载安装包或去其他目录翻找。

下文统一写 `baocut`,按找到的实际路径替换。

## 2. 版本门

```text
baocut version
```

输出裸 JSON:CLI 与(正在跑时)Runtime 的版本、两边的工具接口版本,以及是否一致。它不会拉起 Runtime。

- 一致,或 Runtime 还没在跑:继续。
- 不一致:之后任何要连 Runtime 的命令都会以退出码 3(`INTERFACE_VERSION_MISMATCH` / `PROTOCOL_MISMATCH`)拒绝。告诉用户哪一边要更新(通常是把 BaoCut 更新到同一版本;入口在独立 CLI 包里时,征得同意后用 `baocut update`),停在这里。不要换旧参数、不要绕过。

## 3. 预检:这台机器能做什么

```text
baocut status
```

一次看清:

| 字段 | 看什么 |
| --- | --- |
| Runtime | 在不在跑、版本;没在跑时会自动拉起(`--no-start` 时只回答 `running: false`) |
| 能力 | 转写、语音合成、图片生成、音乐生成、文本生成、人声分离各自此刻用哪个服务、哪些服务能用;不可用的带原因与补救命令。这是摘要:要看各服务的模型、音色与限制,用 `baocut status --full` 或 `baocut models capabilities --capability <能力>` |
| 本地模型包 | 装了哪些、状态如何 |
| 外部工具 | yt-dlp(下载链接)与 ffmpeg(导出、转码)在不在 |

缺的东西照补救命令告诉用户怎么补。补救命令属于「本机管理」(模型服务、外部工具的安装与同意)时,先征得用户同意,有密钥的步骤只让用户自己做。本地模型包缺失可以按 [models](catalog/models.md) 的做法安装(要先报大小、得到同意)。

只读帮助与目录不需要 Runtime:`baocut --help`、`baocut help <命令>`、`baocut spec` 在没有 Runtime 时用随 CLI 带的离线快照回答。先看帮助、再决定要不要开工是可以的。

## 4. Runtime 归自己管

- **不手动起。** 每条要连 Runtime 的命令先找 `BAOCUT_HOME`(默认 `~/.baocut`)里正在跑的 Runtime;找不到就在后台拉起一个,结果信封里带 `runtime: { started: true }`。桌面端开着时直接用桌面端的那个;版本不同而后台那个是 CLI 拉起的、空闲时,CLI 会换成自己这一份的,忙着时以退出码 3 说明,等它做完再跑。
- `baocut runtime ensure`:显式做同一件事,打印 `started` 或 `reused`。想在长流程开头先把 Runtime 拉起来时用。
- `baocut runtime status`:进程、端口、版本、谁拉起的、有哪些连接与进行中的任务、多久后空闲退出;从不拉起。
- `baocut runtime stop`:只停 CLI 自己拉起的那个。桌面端或别人拉起的拒绝(`RUNTIME_NOT_OWNED`),有人在用或有任务没完时拒绝(`RUNTIME_IN_USE`),退出码都是 1,不要强停。
- CLI 拉起的 Runtime 在没有连接、没有任务、没有开着的服务满设置 `runtime.idleExitMinutes`(默认 10 分钟)后自己退出。所以任务做完**不用**专门停;只在用户要求时 `stop`。
- `--no-start`:不自动拉起,找不到就以退出码 3 返回(`RUNTIME_UNAVAILABLE`)。只想看状态、或用户不希望起后台进程时用。

## 5. Runtime 起不来时

起不来、连不上、钥匙串报错或读不到受保护位置的文件时,先跑 `baocut doctor`:只读,不拉起 Runtime,逐项给出 `ok` / `warn` / `fail` / `skip` 与补救命令,`next` 是第一个问题的补救。

| 现象 | 处理 |
| --- | --- |
| 退出码 3,`RUNTIME_START_FAILED` | 跑 `baocut doctor`,把 `error.message` 与 `fail`、`warn` 的项连同补救告诉用户;补救命令征得同意再跑。只有 doctor 指向只能在桌面端做的事(例如在系统设置里给 BaoCut.app 完全磁盘访问权限)时才请用户打开桌面端;不要自己去改 `BAOCUT_HOME` 里的文件 |
| 退出码 3,`RUNTIME_UNAVAILABLE` | 没带 `--no-start` 时重试一次;仍不行按上一行处理 |
| 退出码 3,`CATALOG_UNAVAILABLE` | 离线时既没有快照也没有 Runtime:CLI 安装不完整,请用户重新安装 |
| 退出码 3,版本不一致 | 见第 2 节 |

## 6. 开工

按任务读一页目录(SKILL.md 第 3 节),再按 [conventions](conventions.md) 的约定调用命令。
<!-- /surface -->
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall