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/catalog/models.md

View on GitHub
---
description: 模型能力的机制:各能力可用的服务、模型与限制,本地模型包的安装与检查,能力没配置或要授权时怎么处理。遇到这类错误或要装模型包时读。
---

# 模型能力:查询、本地模型包与「没配置」的处理

## 何时用

- 动手前确认转写、语音合成、图片生成、音乐生成能不能用、限制是多少。
- 本机模型没装,要装或检查本地模型包。
- 收到 `CAPABILITY_NOT_CONFIGURED`、`GRANT_REQUIRED` 等要用户做事的错误。

## 前置检查

能力有六种:转写(`transcribe`)、语音合成(`synthesizeSpeech`)、图片生成(`generateImage`)、音乐生成(`generateMusic`)、文本生成(`generateText`)、人声与背景分离(`separateAudio`)。

- **文本生成与你无关。** 它是工具页与固定流程({{tool:translate}} 这类)用的文本模型;翻译、润色、总结由你自己做,它没配置不影响你,也不能经它调用别的模型。
- 人声分离只在本机,只给翻译配音的「分离背景声」用。
- 音乐生成只在本机(已安装的音乐模型包加 audio.cpp 引擎),没有在线服务;能力与安装见下文「音乐生成」,用法见 [music](music.md)。

## 命令与例子

| 要做的事 | 调用 |
| --- | --- |
| 看各能力可用的服务、模型、限制与默认值 | {{tool:models_capabilities}};只看一种给 {{arg:capability}} |
| 看本机模型包装没装、状态 | {{tool:models_list}} |
| 装本机模型包 | {{tool:models_install}};不给 {{arg:bundleId}} 时装这台机器默认的转写模型包,本机语音合成、生图与音乐生成必须给 |
| 检查装好的模型包能不能用 | {{tool:models_test}},{{arg:bundleId}} |

{{tool:models_install}} 下载几百 MB 到几 GB:

<!-- surface: cli -->
- 不带 `--yes` 时只报模型包与大小、不下载,以退出码 4 返回。先把大小告诉用户,同意后再带 `--yes`。
- 下载可能很久:按 [conventions](../conventions.md) 的「等任务结束」给等待设上限。
<!-- /surface -->
<!-- surface: agent -->
- 提交前 BaoCut 会把大小告诉用户并按访问模式确认;你不要替用户同意。
<!-- /surface -->
- 已经装好时不下载(`jobId` 为 null);之前没下完的会续传。不要重复提交。

## 结果怎么读

{{tool:models_capabilities}} 的每种能力:

- `effective`:不指定服务时实际会用的;为 null 时不指定服务的调用会以 `CAPABILITY_NOT_CONFIGURED` 拒绝。
- 每个服务与模型:是否可用及原因、限制(文本长度 `maxInputChars`、提示词长度、尺寸、张数、音色、格式、语速范围、接不接受语气说明 `acceptsInstructions`、音乐的时长上限 `maxDurationSec` 与编排选项 `local.planning`)、默认值。
- 本机服务的「模型」就是本地模型包:转写在 `transcribe` 下,合成在 `synthesizeSpeech` 下,生图在 `generateImage` 下,音乐生成在 `generateMusic` 下。

{{tool:models_list}} 的每个模型包:`bundleId`、能力、状态(`not-installed`、`downloading`、`installed`、`ready` 等)与原因、下载大小的估计、最近一次检查(`selfTest`)。

{{tool:models_install}}:返回 `jobId` 与大小(`downloadBytes`;未知时看 `estimatedBytes`),等到 `completed` 才算装好。之后再提交转写;本机合成与音乐生成没有出厂默认,生图不指定服务时可能先用 Codex(出厂顺序见 {{tool:image}}),所以要用这个模型包,提交 {{tool:speak}}、{{tool:image}} 或 {{tool:music}} 时带上 {{arg:provider}} `local` 与 {{arg:model}}(这个模型包)。

{{tool:models_test}}:`completed` 是通过;`failed` 时 `error.details.check` 是原因。

## 音乐生成(`generateMusic`)

只有本机的服务:模型是已安装的音乐模型包(目前是 `yue2-3b@audio-cpp-q8`,YuE2 3B,下载约 4.6 GB),由 audio.cpp 引擎(`audiocpp_cli`)在本机执行,不联网,没有在线服务,也没有出厂默认。先 {{tool:models_capabilities}}(能力 `generateMusic`)看有没有可用的模型、时长上限(`maxDurationSec`,YuE2 为 300 秒)、默认预算(`defaultDurationSec`)、编排选项(`local.planning.options` 与默认值)与风格、歌词的字数上限(`maxStyleChars`、`maxLyricsChars`)。

给视频配乐与要一段音乐时怎么提交、风格怎么写、长视频怎么铺满、怎么放上配乐轨,见 [music](music.md)。这里只留能力本身的事实:

- **很慢**:一段要几分钟到十几分钟(CPU 更慢),提交一次,用 {{tool:jobs_wait}} 等,不重复提交。
- **许可**:YuE2 是 CC-BY-NC-4.0,只许非商业用途(`license.commercialUse: false`)。用户要商用时先告诉用户这一点,由用户决定。
- 没装模型包时 {{tool:models_install}} 给 {{arg:bundleId}} `yue2-3b@audio-cpp-q8`(先把大小告诉用户);装好了但找不到引擎时能力报 `unsupported`,处理见下节。

## 「没配置」与「要授权」怎么处理

| 情况 | 处理 |
| --- | --- |
| {{tool:translate}} 报 `CAPABILITY_NOT_CONFIGURED` | 自己翻译([subtitles](subtitles.md) 的自译路径),**不**请用户去配置 |
| 转写、语音合成、图片生成、音乐生成报 `CAPABILITY_NOT_CONFIGURED`,`remedy.action` 为 `install-model` | 本机模型包没装:告诉用户要装哪个、多大,同意后 {{tool:models_install}},装好再重提 |
| `generateMusic` 的模型包装好了,能力仍 `unavailableReason: 'unsupported'`,`detail` 说找不到 audio.cpp 引擎 | 引擎(`audiocpp_cli`)不在这台机器上:先告诉用户引擎要下载(约 30–70 MB,Apache-2.0,来自 audio.cpp 的发布页),同意后带 {{arg:bundleId}} `yue2-3b@audio-cpp-q8` 调 {{tool:models_install}},它在确认后安装引擎,用 {{tool:jobs_wait}} 等结果的 `engine.jobId`;`engine` 没有 `jobId` 而带 `reason` 时(`BAOCUT_AUDIOCPP_CLI` 指定的引擎不能运行、离线、这台机器没有包)照 `reason` 与 `remedy` 转告用户 |
| 同上,其他 `remedy` | 要用户启用一项在线服务或配置账号:照 `remedy` 与 `next` 告诉用户要在哪里启用哪项,停在这里(图片只是交付的一部分时,停下的只是画图这一步,见 [media](media.md) 的「生成图片」) |
| `GRANT_REQUIRED`、`GRANT_REVOKED` | 要把数据发给在线服务,但用户没有授权:照 `remedy` 转告用户 |
| `BUDGET_EXCEEDED`、`TASK_BUDGET_EXCEEDED` | 超了预算:转告用户,由用户决定 |
| `MODELS_DIR_MISSING` | 模型目录不在(例如外置盘没接上):请用户接上或改设置 |
| `MODEL_FILES_DAMAGED` | 模型文件损坏:请用户在 BaoCut 里修复 |
| `OFFLINE_STRICT` | 用户开了严格离线:只能用本机服务,告诉用户 |

无论哪种,都**不**用 shell、脚本、别的网站或别的服务商绕过,不碰 API key 与凭据,不替用户改设置。
<!-- surface: cli -->
启用服务、配置账号、设默认值属于「本机管理」命令(`baocut models configure` 等),给人用:要么请用户自己做,要么在用户明确同意后照 `next` 执行;密钥只由用户自己输入。
<!-- /surface -->
<!-- surface: agent -->
启用服务、配置账号、设默认值由用户在 BaoCut 的设置里完成,你只说明要改哪一项。
<!-- /surface -->

## 常见错误码

见上一节的表;其余照 [conventions](../conventions.md) 的「错误对象怎么用」。

## 下一步

- 能力就绪:回到原来的任务页([subtitles](subtitles.md)、[voice](voice.md)、[media](media.md)、[music](music.md))重新提交。
- 用户暂时不配置:告诉用户哪一步做不了,其余能做的照常做完。

## 验收

- 没有替用户配置、同意或输入密钥。
- 装模型包前把大小告诉了用户并得到同意;装好后用 {{tool:models_list}} 或 {{tool:models_test}} 确认状态。
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