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/export.md

View on GitHub
---
description: 导出的机制:字幕、文稿、音频、成片、便携包与工程文件的种类与参数,范围与输出位置,交付前检查。导出文件之前读。
---

# 导出:字幕、文稿、音频、成片与便携包

## 何时用

- 用户要文件:字幕文件、文稿、音频、成片(mp4、webm)。
- 切好的几段短视频各出一个文件。
- 把整个视频打成便携包交给别人,或导出给 Premiere / Resolve 的工程文件。

## 前置检查

- {{tool:videos_inspect}}:要导出的文档(转写、译文、字幕层)在不在;只要译文的字幕文件时,画面上要已有这种语言的字幕层(先 {{tool:captions_create}})。
- 成片要 ffmpeg 与编码器;缺了会在提交前就被拒(`EXPORT_TOOL_MISSING`)。
- 素材都在:链接的原文件被移动、删除或改过时提交前就被拒(`ASSET_MISSING` / `ASSET_CHANGED`)。
- 画幅、时长、语言按用户确认的来;横屏视频要出竖屏时先问清是加黑边还是重新取景(重新取景是剪辑,见 [editing](editing.md))。

## 命令与例子

{{tool:export}}:{{arg:video}} + {{arg:kind}} + {{arg:format}}。

| 要的文件 | 关键参数 |
| --- | --- |
| 原文字幕 | {{arg:kind}} `subtitles`,{{arg:format}} `srt` / `vtt` / `ass` / `json`(带词时间) |
| 双语字幕 | 同上加 {{arg:bilingual}}(主文档是转写、副文档是译文,每句一条) |
| 只要译文的字幕 | {{arg:kind}} `subtitles`,{{arg:language}} 给译文语言 |
| 文稿 | {{arg:kind}} `transcript`,{{arg:format}} `md` / `txt` / `json`;段末时间码 {{arg:timestamps}},章节小标题 {{arg:chapters}},Markdown 文首元信息 {{arg:frontmatter}};说话人默认写({{arg:speakers}} `false` 不写);默认跳过剪掉的部分,要整份原文给 {{arg:skipCut}} `false` |
| 音频 | {{arg:kind}} `audio`,{{arg:format}} `wav` / `mp3` / `m4a`;按时间线混音 |
| 成片 | {{arg:kind}} `video`,{{arg:format}} `mp4` / `webm` |
| 便携包 | {{arg:kind}} `portable`,{{arg:format}} `baocut`:整个视频连同素材一个文件,别处的 BaoCut 能打开 |
| 工程文件 | {{arg:kind}} `project`,{{arg:format}} `xmeml`:素材按本机路径引用,表达不了的逐项记成警告 |

通用选项:

- 用途:只为内部取帧、检查字幕排版或试听而导出时,必须给 {{arg:purpose}} `preview`;这类文件保留在后台任务里,不进入会话视频卡、「产物」与 Space,不给目录时写到工作目录下的 `.baocut-out/exports/`。交给用户的文件(包括用户要求的预览、短片与分段)用 `deliverable`,也是省略时的默认值。不要按时长或文件名猜用途。
- 范围:{{arg:range}} 只导出时间线上的一段;{{arg:ranges}} 给几段、每段一个文件(切短视频用它)。时间是剪辑后时间线上的秒。
- 文档:有几份可选时 {{arg:documentId}} 指定主文档,或 {{arg:language}} 按语言挑。
- 位置:{{arg:dir}} 输出目录(要已存在),{{arg:fileName}} 文件名(只出一个文件时);同名已存在时默认拒绝,用户同意替换才给 {{arg:overwrite}}。不给时写到工作目录下的 `exports/`(`preview` 的见上),名字是「视频名.种类.扩展名」,重名加序号。
- 字幕的行宽:{{arg:maxCharsPerLine}}(全角字算 2,默认 42)。

成片的画面与声音:

- 尺寸:{{arg:width}} / {{arg:height}};只给一边时另一边按画布比例。两边都给且比例与画布不同时是**加黑边**放进去,不裁切、不重排。
- 编码与质量:{{arg:codec}}(mp4 默认 h264,可选 hevc;webm 是 vp9),{{arg:crf}} 或 {{arg:videoBitrateKbps}} 二选一,{{arg:fps}} 改帧率。
- 字幕:{{arg:burnCaptions}} 默认把时间线上的字幕画进成片;用户要「干净画面 + 外挂字幕」时关掉,再单独导出字幕文件。
- 声音:{{arg:loudness}} 做响度标准化(发布到平台前建议开);{{arg:source}} 只要原声或只要某一组配音(只影响这次导出,不改视频)。
- 画不出来的内容:{{arg:onUnsupported}} 默认 `fail`(拒绝并逐项列出);`skip` 会整层不画、效果不施加、转场按硬切,**只在用户同意后用**。便携包缺素材的 {{arg:missingAssets}} 同理。

## 结果怎么读

- 提交时冻结视频的当前版本:之后的修改不影响这次导出;改完要重新导出。
- 完成时 `outputs` 里每个文件有 `path` 与校验结果。把 `path` 原样告诉用户,不自己拼路径。
- 内部检查文件不当成交付,也不把它们列在完成回复里;检查发现的问题按实际结果报告。
- 成片的进度按帧(`progress.unit` 为 `frames`)。
- 任务警告(跳过的内容、工程文件里表达不了的元素)要转告用户。

## 常见错误码

导出在提交前做预检,以下错误不建任务:

| 错误码 | 下一步 |
| --- | --- |
| `EXPORT_SOURCE_AMBIGUOUS` | 文档不止一份:用 `candidates` 里的 documentId 指定 |
| `EXPORT_NOTHING_TO_EXPORT`、`EXPORT_SOURCE_NOT_FOUND` | 没有可导出的文档:先转写或建字幕层 |
| `EXPORT_RANGE_EMPTY` | 范围里没有内容:核对时间线上的秒 |
| `EXPORT_DESTINATION_EXISTS` | 目标文件已存在:换名字,或问用户后给 {{tool:export}} 加 {{arg:overwrite}} |
| `EXPORT_DESTINATION_UNWRITABLE`、`EXPORT_INSUFFICIENT_SPACE` | 目录写不了或空间不够:告诉用户 |
| `ASSET_MISSING`、`ASSET_CHANGED` | 素材缺失或改过:请用户放回原文件;不要擅自换素材 |
| `EXPORT_TOOL_MISSING` | 缺 ffmpeg 或编码器:照 `remedy` 转告用户 |
| `EXPORT_UNSUPPORTED_CONTENT` | 成片里有画不出来的内容:把 `items` 告诉用户,问是否用 `skip` |

## 下一步

- 成片导出完:按下面的验收核对,再交付。
- 要给别人接着编辑:导出便携包;对方用打开便携包的方式建成新视频(见 [media](media.md))。

## 验收(交付前检查)

- 文件真实存在,路径取自 `outputs`。
- 量出来的:时长、分辨率、帧率、文件大小、字幕条数与用户的要求对得上(读任务结果与文件的媒体事实)。
- 看过的:取帧({{tool:videos_frames}})只能核对时间线上的素材画面,不含字幕、文字与叠加的元素;字幕位置、挡没挡人脸要在成片里看,自己看不了就请用户看,报告里写明没看。
- 要人听的:配音、配乐与人声的平衡,剪点顺不顺。
- 画幅、时长、语言、交付物与用户确认的一致;没有为凑时长重复画面或变速。
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