JimLiu/baocut / skills/baocut
baocut
Flagged用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。
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 |
## 下一步
按任务回到对应的目录页。
## 验收
- 取消、重跑、新建项目、删除都有用户的要求或同意。
- 本机管理命令的每一次使用都先征得了同意。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| 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: 194k | Updated | Claude CodeCodex | Verified | Install |