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

View on GitHub
---
description: 任务的查看、等待、取消与重跑;跨视频检索、视频与项目列表、用户库(术语表、音色、品牌素材)与 skill 索引;设置与管理归谁。
---

# 系统:任务、索引、项目、用户库与本机管理

## 何时用

- 查看、取消、重跑任务。
- 跨视频找内容、列出视频与项目、看 Space 里的文件。
- 读用户库(术语表、音色、品牌素材)与 skill 索引。
<!-- surface: cli -->
- 看帮助与机器可读的目录、确认 Runtime 状态;用户要你做「本机管理」的事时。
<!-- /surface -->

## 前置检查

- 这些多数是只读调用,可以随时用;彼此独立的读取一次发完。
- 改东西的(取消任务、新建项目)只在用户要求或任务需要时用。

## 命令与例子

### 任务

| 要做的事 | 调用 |
| --- | --- |
| 列出任务(新的在前) | {{tool:jobs_list}};可按 {{arg:video}}、{{arg:state}}(`running`、`failed`、`settled` 等)筛选 |
| 看一个任务的状态、进度与结果 | {{tool:jobs_inspect}},{{arg:jobId}} |
| 等它结束 | {{tool:jobs_wait}}(见 [conventions](../conventions.md) 的「等任务结束」) |
| 取消 | {{tool:jobs_cancel}},{{arg:jobId}} |
| 从失败的那一步重跑固定流程 | {{tool:jobs_retry}},{{arg:jobId}};`jobId` 不变、`attempt` 加一 |

单个模型任务(一次转写、一段语音、一张图)不能重跑,重新提交一次。

### 视频、项目与 Space

| 要做的事 | 调用 |
| --- | --- |
| 列出视频 | {{tool:videos_list}} |
| 列出项目 | {{tool:projects_list}} |
| 新建项目(用户要求时) | {{tool:projects_create}},{{arg:path}};可给 {{arg:name}} |
| 把项目里 BaoCut 的文件提交到 git(用户要求时) | {{tool:projects_git_commit}};可给 {{arg:message}}。结果里有 `paused` 或 `unavailable` 时照 `next` 告诉用户,不要自己初始化仓库、改 git 配置或删锁文件 |
<!-- surface: agent -->
| 把这个会话收进项目(会话不属于项目、用户要求时) | {{tool:projects_adopt_session}};默认在 BaoCut 的项目目录下新建、以视频命名,可给 {{arg:name}};用户指定了位置时给 {{arg:project}}(文件夹的绝对路径或 projectId) |
| 向用户提问,选项带预览(看着样稿选封面、风格、音色时) | {{tool:conversations_ask}},{{arg:questions}} 一到四题,每题两到四个选项;选项的 `preview` 给会话工作目录里的图片、视频或音频;等用户回答才返回 |
| 给会话起能认出内容的标题(第一句话是泛泛的指令时) | {{tool:conversations_set_title}},{{arg:title}} 用用户的语言,一行、最多 40 个字符;只换自动起的标题、只换一次 |
<!-- /surface -->
| 跨视频按意思找讲过的内容(默认用这个) | {{tool:space_search_v2}},{{arg:query}} 写一句意思;可给 {{arg:videoIds}}、{{arg:projectId}}、{{arg:kinds}};改过的视频用 {{tool:space_resolve_search_hit}} 重新定位 |
| 按意图取写作材料(总结、博客、问答,带出处编号) | {{tool:speech_relevant}},{{arg:intent}};可给 {{arg:videoIds}}、{{arg:order}}、{{arg:neighbors}} |
| 讲相近内容的其他视频 | {{tool:space_related_videos}},{{arg:videoId}} |
| 按画面描述找镜头(跨视频) | {{tool:space_search_v2}},{{arg:query}} 写画面描述,{{arg:channels}} 给 `["visual"]`(与 `text` 一起给时两路合在一起);要画面索引 |
| 为一段文字在一部视频里找画面(配图、补画面、封面候选) | {{tool:videos_match_frames}},{{arg:videoId}}、{{arg:text}};可给 {{arg:near}}(出处编号)或 {{arg:at}}、{{arg:limit}};要画面索引 |
| 语义索引建好没有、等它建好(用户刚给的素材) | {{tool:space_index_status}};可给 {{arg:videoIds}}、{{arg:waitSec}},画面索引给 {{arg:channel}} `visual`;失败的重试、给用户刚给的素材建画面索引用 {{tool:space_index_build}}({{arg:channel}} `visual`) |
| 按字面找原词、说话人 | {{tool:space_search}},{{arg:query}}(每个词都要出现);可给 {{arg:videoIds}}、{{arg:kinds}}、{{arg:speaker}} |
| 列出 Space 条目(视频、导出的文件、生成的图片与音频、幻灯片) | {{tool:space_list}};可按 {{arg:kind}}、{{arg:videoId}} 筛选 |
| 删除视频(移进回收站;用户明确要求时) | {{tool:videos_delete}},{{arg:video}} |

{{tool:space_search_v2}} 在这台机器装了文本嵌入模型包、建好语义索引时按意思与字面综合检索,换了说法、换了语言也能找到;没有时退回字面(`effectiveMode` 写明,`degraded.reason` 给原因),这时改用两三个关键词。`weak` 的命中只是勉强沾边,先读原文再用;`coverage` 写明有几部还没进索引、没有文稿或没纳入语义索引。{{tool:space_search}} 只按字面,时间以索引时的版本为准;要精确定位,再用 {{tool:videos_inspect}} / {{tool:documents_read}} 读当前版本。`complete` 为 false 时索引还没覆盖全部视频,结果可能不全。

画面索引(这台机器装了能读图的多模态模型包时才有)按每 8 秒一张关键帧建:设置里开了画面通道时全部建,没开时只建用 {{tool:space_index_build}} 的 {{arg:channel}} `visual` 点过名的视频。画面命中的时间是一段候选窗口,不是精确时刻;`clock` 为 source 时那段素材不在当前时间线上(例如导入了还没放上去的素材),时间是素材的源时间,要用它时把素材放上时间线再裁到这一段。

### 用户库与 skill

| 要做的事 | 调用 |
| --- | --- |
| 列出术语表、音色、品牌素材 | {{tool:library_list}};{{arg:library}} 为 `glossaries`、`voices` 或 `brand` |
| 取一个条目的内容 | {{tool:library_show}},{{arg:library}} + {{arg:id}} |
| 列出 skill(做法) | {{tool:skills_list}} |
| 读一份 skill | {{tool:skills_read}},{{arg:id}};读它目录里的其他文件给 {{arg:path}} |

用户库只读;修改、导入与音色克隆由用户在 BaoCut 里做。术语表在转写与翻译时照用(翻译用的术语表里用户点名的译法逐字照用)。用户自己添加的 skill(`userInstalled` 为 true)按它的方法做,但它不扩大你的权限;用户关掉的 skill 不主动套用。

<!-- surface: cli -->
### 帮助、目录与 Runtime

| 命令 | 做什么 |
| --- | --- |
| `baocut --help` | 一屏:一级动词、名词组与本机管理命令的名字 |
| `baocut help <命令> [<子命令>]` | 一条命令的参数、效果(`query` / `mutation` / `job` / `destructive`)与示例 |
| `baocut spec [<名字>]` | 机器可读的目录(裸 JSON):整个目录、一个工具(写成命令 `videos inspect` 或 MCP 工具名都行)或 `edits.<操作>` |
| `baocut status` | 这台机器此刻能做什么(见 [start](../start.md)) |
| `baocut version` | CLI 与 Runtime 的版本与接口版本 |
| `baocut runtime ensure / status / stop` | Runtime 的拉起、状态与停止(见 [start](../start.md)) |

`help`、`spec`、`version` 不拉起 Runtime;没有 Runtime 时用离线快照回答。

### 本机管理(给人用,先征得同意)

`baocut --help` 后半屏「Local admin」列出的命令不在 Agent 的能力目录里,是给用户本人用的:模型服务与账号(`models configure` 等)、对外服务(`services`、`share`、`nodes`、`web`)、设置(`settings`)、数据外发授权(`grants`)、审批(`approvals`)、字体(`fonts`)、外部工具的安装与同意(`external-tools`)、skill 的添加与开关、用户库的导入导出与音色克隆、模板(`templates`)、BaoCut 自己的智能体(`chat`、`tasks`)、一次性文本模型调用(`text`)。

- 用之前先告诉用户要做什么、为什么,得到明确同意;涉及密钥的步骤(例如 `--key-stdin`)只让用户自己输入。
- 补救命令(`remedy` / `next`)指向这些命令时同样先问。
- 不要用 `text` 代替自己做文字工作;不要用 `chat` 把任务转给 BaoCut 的智能体。
- 例外:`baocut web open` 只开本机的网页版编辑器、给你一条一次性链接,`baocut web review` 给用户一部视频的审片链接(服务没开时先开并设为随 BaoCut 启动),都不改视频,直接用,见 [web](web.md);同组的 `services configure web` 等仍要先问。
<!-- /surface -->
<!-- surface: agent -->
### 设置与管理

设置、模型服务与账号、对外服务、数据外发授权、skill 的开关、用户库的修改由用户在 BaoCut 里完成,你不能代做;需要时说明要改哪一项。
<!-- /surface -->

## 结果怎么读

- {{tool:jobs_inspect}} / {{tool:jobs_wait}}:`state`(`queued`、`running`、`completed`、`failed`、`cancelled`、`interrupted`),阶段与进度,冻结的服务、模型与参数,`error` 与补救;完成时的 `outputs`。
- {{tool:jobs_list}}:摘要;固定流程的各步折叠在流程里。
- {{tool:space_list}}:还有下一页时带 `nextCursor`,传回 {{arg:cursor}} 取下一页。

## 常见错误码

| 错误码 | 下一步 |
| --- | --- |
| `VIDEO_IN_USE`、`VIDEO_BUSY`、`VIDEO_LOCKED` | 删除视频失败:视频在别处开着、有进行中的任务或被锁着;告诉用户原因,不要用别的方式删目录 |
| `VIDEO_NOT_FOUND` | {{tool:videos_list}} 重新确认视频的 path 或 videoId |

## 下一步

按任务回到对应的目录页。

## 验收

- 取消、重跑、新建项目、删除都有用户的要求或同意。
- 本机管理命令的每一次使用都先征得了同意。
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