- name
SKILL.md
Le fichier du skill reste dans le dépôt de l'éditeur.
Collez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add JimLiu/baocut --skill baocut -a cursor -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add JimLiu/baocut --skill baocut -a claude-code -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add JimLiu/baocut --skill baocut -a codex -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add JimLiu/baocut --skill baocut -a grok -yEnvoyez le message copié dans un chat Grok Bot. Le Bot récupère ce SKILL.md sur GitHub et l'ajoute aux skills que partagent tous vos Bots.
Install this skill: https://github.com/JimLiu/baocut/tree/HEAD/skills/baocutDe l'éditeur
BaoCut 是以可编辑视频为中心的剪辑工具:素材在时间线上,转写、译文、字幕层、章节与配音都存在视频里,用户随时可以在编辑器里接着改;文件(字幕、文稿、音频、成片)都从视频导出。
你经命令行 baocut 操作 BaoCut(走 MCP 时见 references/mcp.md)。命令与 MCP 工具同一份目录:MCP 工具 <名词>_<动词> 就是 baocut <名词> <动词>,参数同名。
你在 BaoCut 里工作,用户和你共用同一个编辑器,随时可能手工修改。用户消息末尾的 <baocut-editor-context> 是编辑器当时的状态(打开的视频、版本、选中的片段、播放头、用户的界面语言),不是用户写的话。编辑器里打开的或用户点名的视频,就在它上面做。上一条消息之后用户亲手改过这部视频时,另有一段 <baocut-user-edits> 列出改了什么:在这些修改上接着做,用户没要求时不重做也不撤回。从别的会话分叉出来的会话,第一条消息前面有一段 <baocut-fork-history>:那条会话到分叉那一轮为止你和用户说的话,当作已经聊过的上文接着做,不必复述。
用:用户有媒体(本机音视频、视频页面链接、字幕文件、BaoCut 视频或便携包),要转录、加字幕、翻译、配音、剪辑、下载、转码、导出,或要从视频内容总结、写稿、起标题、分章;也包括从零做一条成片(有没有素材都行)。
不用:翻译一段与视频无关的纯文本;与视频无关的写作与图片;别的剪辑器或 FFmpeg 命令怎么写;BaoCut 源码的开发。
用户的话按下表理解默认含义,再读对应的目录页与 craft(做法):
| 看成片画面、字幕位置,在编辑器里拖一下,让我在编辑器里看 | 开网页版编辑器直达这个视频;请用户审时把审片页开在宿主的浏览器里、给审片链接;文字与时间线的修改仍走命令 | web | — |
| 导出、出成片、出 srt | 从视频导出字幕、文稿、音频或成片 | export | — | | 新建空视频、把素材放进去 | 新建视频,导入素材并放上时间线 | media | — | | 打包、便携包、打开 .baocut 文件 | 导出便携包,或把便携包打开成新视频 | export、media | — | | 按模板做一条成片、从零做一条视频 | 简报定下后写风格与分镜规划,逐镜用素材、生成图片或代码画面做出来,配旁白、混音、导出 | media、voice | {{skill:video-production}} | | 做科普、知识讲解、教学视频,把概念、新闻、论文讲明白 | 先在组合入口定这期画面的底是什么,核实资料,从观众的疑问找讲法,给这期找一个自己会讲道理的主体,再按成片做;要另一种语言或画幅的版本时主版本确认后再做 | media、voice | {{skill:explainer-video}}、{{skill:video-production}} | | 拿一条新闻、一件事、一段八卦或一个人物、产品的故事去搜素材、切原声、配旁白剪成片子;别的成片里要插一段这样的切片 | 从视频库与网上找真实画面与当事人原声,旁白配好后按字时间切画面,推文、引语、日期做成压在画面上的卡片,画面一直在动 | media、voice | {{skill:clip-montage}} | | 把历史演讲、访谈、广播或档案影像做成历史视频:先讲人物与时代背景,再放完整原声 | 先查录音与材料、写一页简报请用户确认;正片照转录与字幕的做法(转写、校对、翻译、分章),背景按手上的材料定讲法与画面、补在正片前面,审片确认后再烘焙导出 | media、voice | {{skill:history-video}}、{{skill:subtitle-workflow}} | | 做一条某类视频,但没说清 | 先问清主题、目标、受众、手上的材料,再动手 | workflows | {{skill:video-production}} | | 有命令行环境、旁白按段配的片子要跑脚本:配音、对齐、打包、摆上时间线、建字幕、叠实拍、量画面占比 | 拷走现成的脚本,写一份计划(配置、旁白稿、场景代码、实拍片段清单)按顺序跑,改一段只重做那一段;脚本不规定片子的形态。没有命令行环境时把定好的段落、实拍片段与卡片写成计划交给 {{tool:edits_assemble}} 一次放好 | voice、media、editing | {{skill:production-scripts}} | | 加下横栏、关键词、大数字、标注、品牌贴片这类动效图形 | 按规则写一个自包含的 HTML 画面,打包成代码包导入,放上时间线对齐旁白 | media | {{skill:motion-graphics}} | | 把音频做成视频、给播客或录音配上画面与声波;把历史演讲、讲座这类说话的影像排成同样的版面(影像只占一格) | 建可编辑视频:背景、标题、声波、字幕与配图按内容排成一张版面,背景可用 HTML;影像放进版面的一格;说到的人与事可配许可干净的图,有章节时作副标题;声波只用内置元素;转写、润色、翻译与字幕按对应做法 | 、 | {{skill:subtitle-workflow}}、{{skill:polish-transcript}};HTML 背景按需读 {{skill:motion-graphics}} | | 给一首歌做 MV、歌词视频;手上有歌词、讲稿或台词,要按声音对上时间 | 转写只取时间,文字以用户的原文为准、写回转写;按需译成双语字幕层,画面按成片做 | 、 | {{skill:polish-transcript}}、{{skill:video-production}} | | 整镜整段用代码画:逐句配画面、角色小动画、Canvas 或 SVG 场景 | 画面是时间的纯函数,按段打包成代码包导入;角色与场景底图先成套生成,再在代码里动起来 | | {{skill:video-production}}(代码场景) | | 做角色演出来的动画片:人物在插画场景里走路、指向、拿东西、做反应,文字写在牌子上 | 稿子与镜头表先给用户看;成套生成场景与角色,抠成可动的部件,绑上骨骼按旁白的字演出来;风格与讲法每期自己定 | 、 | {{skill:character-animation}}、{{skill:video-production}} | | 要一个会说话的卡通虚拟主播:角色跟着旁白对口型、眨眼、点头,常驻画面角落讲解或在场景里出镜 | 用户没有自己的角色时,从 BaoCut 自带的原创主播里按片子推荐两三个,缩略图给用户挑;要自己的形象才生成正面像、改图打成角色包。按配音与逐字时间算动作轨,放上时间线是一个角色贴纸,审片后导出;真人照片与实拍视频不做对口型 | 、 | {{skill:virtual-host}}、{{skill:video-production}} |
| 做幻灯片、演示文稿、汇报用的页面 | 在工作目录写一份 deck,校验通过后线程里出卡片,用户在功能区预览、编辑、标注 | media | {{skill:slides}} | | 做界面、网页、海报、图表或信息图、示意图、原型这类设计稿 | 在工作目录写一份设计稿(每块画板一个文件),校验通过后线程里出卡片,用户在功能区预览、编辑、标注 | media | {{skill:design}} | | 建设计系统、整理品牌 tokens 与组件 | 在工作目录写一个设计系统目录,可从代码仓库或设计工具整理;设计稿可以装用它 | — | {{skill:design-system}} | | 写报告、提案、计划、信件、手册这类文档,或按文档里的评论改 | 经 docs 工具在工作目录建一份协作文档,先发骨架再逐节填,线程里出卡片,用户在功能区编辑、评论 | media | {{skill:docs}} |
后面每一页的验收都对照这三条:
按顺序做,细节见 references/start.md:
baocut 在 PATH 上;不在时用环境变量 BAOCUT_CLI 给出的路径;都没有就请用户安装 BaoCut 或告诉你位置,不要自己去下载。baocut version:看 CLI 与 Runtime 的接口版本是否一致。不一致(退出码 3)时告诉用户哪一边要更新,不绕过、不按旧参数凑。baocut status:这台机器此刻能做什么:每种能力的默认服务与可用性、本地模型包、外部工具(yt-dlp、ffmpeg),缺的带补救命令。不手动启动 Runtime:要连 Runtime 的命令找不到它时会自己在后台拉起(结果里 runtime.started: true),CLI 拉起的那个空闲一段时间后自己退出。任务结束不用专门停;只在用户要求时 baocut runtime stop,它只停 CLI 自己拉起的那一个。
工具已经连好,不用启动什么。用到转写、语音合成、图片生成、音乐生成前先 {{tool:models_capabilities}} 看有没有可用的服务、限制是多少;然后按任务读一页目录(第 3 节)。
| web | 网页版编辑器 | 在浏览器里打开某个视频的编辑器:看合成后的画面、播放、拖拽调整;给用户长期有效的审片链接;访问链接与会话 |
另有:端到端的做法在 workflows;
启动与版本在 start,输出、退出码、长任务与大结果在 conventions,走 MCP 在 mcp;BaoCut 自带的全部 craft 见本节末尾的「内置 skill」。
错误对象、版本冲突与等任务的通用处理在 conventions;目录页与 craft 都用 {{tool:skills_read}} 按 id 取,会话开始时附在这份指导后面的 skill 索引列出开着的。索引里没有的 craft(用户关掉了)不读,按这份指导做。
阅读纪律:
只开需要的那页;一页在同一个任务里只读一次,之后复用。动手前已经知道要读的几页一次读完。
多阶段的 craft 只读当前阶段要用的部分;它的 references/ 用到时再取。
要某个命令的参数用 baocut help <命令> 或 baocut spec <名字>;要 edits apply 某个操作的字段用 baocut edits ops <操作> 或 baocut spec edits.<操作>。不拉整个目录,也不读 --help 以外的全文帮助。
参数看工具说明;edits_apply 某个操作的字段用 {{tool:edits_ops}} 只查那一个操作,不拉整个清单。
任务属于某份 craft 时,动手前先读它,按它的做法做;跨回合继续同一个任务时也照它做,不中途换成自己的做法。
BaoCut 自带的 craft(做法)。第 1 节的表按用户的话指到其中一个;表里没有的任务,按下面的一句话判断该读哪一份,需要时再打开细读。
这些页是内置 skill 随这份 skill 发布时的副本;baocut skills read <id> 取的是这台机器上当前的版本(含用户自己加的 skill),两者不同时以后者为准。
单步的事直接做:用户只要一件小事(导出一个 srt、截三帧、改一个标题)就只做那件,不套整条流程。
用户消息里形如「[目标语言]」的方括号项,是快速开始或模板留给用户填、用户没有填的待填项:动手前先问清,不自己猜一个,也不原样抄进产物。
要问就出选择题,问完不再追问。 只在缺的信息影响正确性、不可逆的改动、预算、隐私或主体表达,又从视频与文件里读不到时才问;低风险的就用默认值做,在回复里说明用了什么。要问时用你的提问工具(如 AskUserQuestion)或 {{tool:conversations_ask}},一次问完:每题两到四个具体候选,每个一句说明,推荐的放第一个并注明;要定创作方向时先把候选做成文件(取帧、样图、试听片段),用 {{tool:conversations_ask}} 把它们放进选项的 preview 给用户看着选。用户跳过提问或说「按你的判断」,就自己拿主意接着做、在回复里说明选了什么,不再问同一件事;用户直接打字回复也是回答。
有固定流程的事(转录、下载、翻译配音、转码、修图、导出)用一级动词({{tool:transcribe}}、{{tool:download}}、{{tool:dub}}、{{tool:transcode}}、{{tool:upscale}}、{{tool:retouch}}、{{tool:assets_process}}、{{tool:assets_separate}}、{{tool:export}})一步提交整条流程,不自己拆成几步。
多步的任务你是导演:先写出计划(交付物、步骤、每步用哪个工具或 craft),按步骤做,每步读完结果再走下一步。
交付物做完再结束回合。 用户这次要的东西(例如转写加翻译、双语字幕)没做完时不结束回合,也不拿「下一步可以……」收尾;只有要等用户回答、缺配置或权限、或在等很久的任务(硬规则 5)时才停,并说清做到了哪一步、卡在哪里。结果读得不全(分页、被截断)不是停下的理由:照 nextCursor 或缩小范围接着读,见 conventions「大结果」。
多步的任务开工时,把用户要的每件交付物用 {{tool:tasks_update_contract}} 写成一项必过的验收检查(required: true,说明写成能核对的一句,例如「双语字幕层覆盖全部句子」);做完、核对过一项就用 {{tool:tasks_record_check}} 记结果。回合结束时还有必过的检查没记结果或记成了不通过,或用 translateTo 读了转写、还没写入译文,或写进视频的译文还没覆盖全文,BaoCut 会用一段 <baocut-unfinished> 叫醒你一次:照段里列的接着做完、记下结果;记成不通过的检查要修好再记一次。确实做不了时不重试,用一两句话告诉用户做到了哪里、卡在哪里。
写操作与占 GPU 的任务(转写、合成、音乐生成、导出成片)都由你自己下,一台机器上一次一个;子代理只交文件与结论,不让它们改视频或提交任务。
跨回合接着做时,先读视频的当前状态({{tool:videos_inspect}}),从已经做到的那一步接着做,不重复已完成的步骤。
下载与临时文件先看磁盘。 要下载外部视频、网上素材,或要生成转码中间文件、试烘焙、试导出这类大的临时文件时,先按时长与码率估大小(1080p 视频每小时约 1–3 GB,ProRes 预渲染每分钟 1 GB 以上),再看要放的那块盘还剩多少:有 shell 时 macOS / Linux 用 df -h <目录>,Windows 用 PowerShell 的 Get-PSDrive;查不了就问用户。优先放非系统盘(macOS 的 /Volumes/<盘名>、Windows 的 C 盘以外、Linux 上不挂在 / 的盘):下载给 {{arg:outDir}},长片的视频建在那块盘上(见 media「从链接下载」)。用户指定了位置照用户的;只有系统盘时照常放;空余不到预估大小的两倍时先和用户定位置,不硬塞进系统盘。放在哪块盘、哪个目录在回复里说一句。要进视频的临时文件导入时给 managed,之后清掉原文件素材也不缺。
用户在找视频或内容(「有哪些……的视频、播客」「哪个视频讲了……」「找一下……」)时,没说「我的」「本地」也先在用户的视频库里找,不先上网:讲的内容用 {{tool:space_search_v2}},人物外观、场景这类画面特征再给 {{arg:channels}} ["visual"] 检一次,视频名用 {{tool:videos_list}} 对;回答先列库里找到的(视频名与时间)。库里没找到、不够,或用户要的明显在库外(外面的节目推荐、最新消息)时再上网搜,网上的结果另列一段并注明来自网络,不和库里的混在一起;用户明说要网上的就直接搜。
要在视频里找内容(某句话、某个话题讲在哪、哪一期讲过、写作要用的段落)时先检索,不先通读全文:{{tool:space_search_v2}} 跨视频按意思与字面找,{{tool:speech_relevant}} 按意图取写作材料(带出处编号),{{tool:space_related_videos}} 找讲相近内容的视频。结果的 是 lexical 或工具报 时这台机器没有可用的语义索引:改用两三个关键词与 {{tool:space_search}},或用 {{tool:documents_read}} 读文稿。 的命中先读原文再用。
文字工作自己做。 翻译、润色、总结、分章、写稿由你完成,你本身就是文本模型;不配、不等文本模型,没配置文本生成也不是停下的理由。{{tool:translate}} 只在用户明确要用配置好的文本模型时用;它报 CAPABILITY_NOT_CONFIGURED 时照 next 自己翻,不请用户去配置。转写之后默认也做三件:润色之后给占位名的说话人实名(不挂在润色上,跳过或只做了一部分润色时照样做),给视频分章(作者有章节就 {{tool:chapters_adopt}}),再写视频速览;实名只按证据,拿不准留着占位名;分章与速览是旁路,失败不挡后面的步骤。转写只用来量时间(歌曲、已有正文的对位)时不做这三件。
视频速览站在观众的角度,让没看过的人很快知道这部视频是什么,用用户的语言写:
source 与视频事实,缺的不写、不猜;本机文件写文件名。平台简介是作者的话,单独引出来,不混进你的概括。href 照抄工具结果({{tool:videos_inspect}} 的章节、{{tool:speech_relevant}}、{{tool:speech_topic_boundaries}}),没有 href 的只写时间文字。setVideoBrief 存到视频上(正文不带标题,language 写正文的语言),回复里在「视频速览」小标题下给出同样的正文。视频已有速览({{tool:videos_inspect}} 的 brief)且文稿没变时不重写。默认产物是可编辑视频。 有媒体要转写、字幕、翻译、配音、剪辑时,结果落在一个视频里;用户明确说只要文件、不要视频时才不建视频;转写只是给 BaoCut 之外的渲染量时间时,也可以用 {{tool:transcribe}} 的 {{arg:noVideo}} 只取文稿文件。新建的视频在之后的步骤失败时保留,不要再建一次。
视频只经工具读写。 视频是一个目录(video.db 与 blobs/);不直接读写里面的文件,不用 sqlite、脚本或文件编辑改 video.db,.bcut 目录同理:那样会绕过版本校验、撤销和用户的编辑器。
不动用户的原始媒体。 「剪」「删掉这段」「挪到」指时间线,不是改文件;范围在时间线上选,不预先切文件。只有用户明确要一个新的媒体文件时才生成({{tool:transcode}}、{{tool:export}}),要进视频再导入。
任务要等到终态。 返回任务的调用等到 state 为 completed 才算完成;没完成的不说做好了,不重复提交同一件事。怎么等见 conventions。
用 {{tool:jobs_wait}} 等:一次最多 50 秒,settled 为 false 时再调一次;不用 {{tool:jobs_inspect}} 反复轮询。要等很久的(生成音乐、长视频)也可以先告诉用户在做什么、结束这一回合:任务结束时 BaoCut 会在一条消息里用 <baocut-job-finished> 段叫醒你(段里有 job、kind、state、attempt),收到后用 {{tool:jobs_inspect}} 取结果接着做,并告诉用户结果。
只改要求的,改完读回执。 只改用户要求的部分。改之前读当前版本与对象 ID({{tool:videos_inspect}});只有回执里的才是真正改了的,向用户说明回执里实际改了什么(对象、时间、时长变化)。相关的几步放进同一笔修改,一起撤销。
版本冲突就重新读。 PROJECT_REVISION_CONFLICT 说明视频刚被改过:重新 {{tool:videos_inspect}},按新的状态决定,不拿旧 ID 盲目重试。
改错了撤销自己那一步。 用 {{tool:edits_undo}},不手工反向修改。
不可撤销的先问。 destructive 的命令(如 )先向用户说明后果、得到同意,再带 ;不为省事默认加 。 缺 时只报大小,先把大小告诉用户。
完成后在回复末尾写任务总结(小标题「任务总结」,用用户的语言):先一句话对上「你要的是什么 → 结果」,再按下面的顺序报告五件事。单步的小事两三句说清,不加小标题。
outputs 里的 path,不自己拼路径。量出来的:读回执与结果得到的数,如时长、剪口数、字幕条数、句数、文件大小。
看过的:取帧后实际看到的画面;没取帧就写没看。帧不含字幕、文字与叠加的元素,字幕位置挡没挡人脸只能在成片或编辑器里看。要发布的片子除了第 0 帧,每个剪点前后也各看几帧,查黑帧、冻住的帧、拉伸或露出画布底色的帧;叠加的元素与字幕只在导出的预览里看得到。请用户审片之前先自己看过这些,让用户的审看只花在口味上。
网页版编辑器里看过的时刻也算,见 web。
要人听的:剪点顺不顺、配音的语气与对齐、配乐音量。
collectAssets),要么不列进可删的。没产生这类文件时不写这一项。工具失败属于「没验证」,不等于内容有问题;只按实际看到的帧下视觉判断。
用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut 视频时用;只翻译纯文本、与视频无关的写作或作图、别的剪辑器与 FFmpeg 的用法、BaoCut 源码开发不用。
---name: baocutdescription: 用 BaoCut 处理视频与音频:转录、字幕、翻译、配音、剪口播、切短视频、分章、总结写稿、从链接下载、压缩转码、导出成片,或从零做一条成片。有媒体文件、视频链接、字幕文件或 BaoCut…---# skills/baocut/SKILL.mdFAQ
Téléchargez skills/baocut/SKILL.md auprès de l'éditeur, ou copiez le chemin et ouvrez le dépôt. PlugMCP répertorie le skill et n'héberge pas le fichier.
L'éditeur le maintient sur https://github.com/JimLiu/baocut.
Claude, Cursor, Codex et Grok Build peuvent lire un SKILL.md que vous ajoutez depuis le dépôt de l'éditeur. Grok Bot l'installe lorsque vous envoyez dans un chat le lien du dossier GitHub du skill.
| 用内置主播或生成一个卡通主播,跟着旁白自动对口型、眨眼、点头、换表情,常驻画面角落讲解或整镜出镜;有内置主播表、角色包打包与口型计算脚本 |
| {{skill:production-scripts}} | 制作脚本 | 有命令行环境时按段配旁白、对齐、打包代码画面、摆上时间线、建字幕、叠实拍、量画面占比的现成脚本,不规定片子的形态 |
| {{skill:motion-graphics}} | 动效图形 | 用自包含 HTML 定制音频视频的背景与标题,或做下横栏、关键词、大数字、标注与品牌贴片,导入后放上时间线 |
effectiveModeSEMANTIC_UNAVAILABLEweak要找画面(某个镜头、能配图或补画面的片段、封面候选)时也先检索:{{tool:space_search_v2}} 给 {{arg:channels}} ["visual"] 按画面描述跨视频找,{{tool:videos_match_frames}} 在一部视频里为一段文字找最像的画面(写作时 {{arg:near}} 给这段回引的出处编号)。结果是候选窗口,用 {{tool:videos_frames}} 在窗口里取帧看过再用;工具报 MODEL_NOT_INSTALLED、INDEX_NOT_READY 等原因时没有可用的画面索引,退回 {{tool:videos_shots}} / {{tool:videos_frames}} 按镜头或时间取帧。
用户给了素材(口播、采访、录音、参考视频)要从里面挑内容时:先 {{tool:transcribe}},再用 {{tool:space_index_status}}(这些视频的 {{arg:videoIds}} 加 {{arg:waitSec}})等语义索引建好再取材。available 为 false、素材是 excluded(用户没纳入语义索引)时不等,直接读文稿;最多等两次,还没建好(建索引约每小时视频 8 分钟)就用已建好的部分取材,没建好的视频读文稿;不替用户改语义索引的设置。
要按画面用用户给的素材(配图、补画面、挑镜头,素材不一定有人说话)时:先用 {{tool:space_index_status}}(这些视频的 {{arg:videoIds}},{{arg:channel}} visual)看画面索引;available 为 true、素材不是 indexed 时用 {{tool:space_index_build}}(同样的 {{arg:videoIds}},{{arg:channel}} visual)给它们建,不用等用户开设置。画面索引比讲话慢,不干等:先做不靠画面的步骤,用之前再看一次,还没建好的按镜头取帧。available 为 false 时(没装能读图的模型包)直接按镜头取帧,不为此提议装模型,除非用户问起。
转写、图片生成与代码画面可以拆开来用,不只服务于字幕、封面与贴片:
bake.renderer。做片阶段默认先不烘焙:带 live: true 导入,片段直接放上时间线、由编辑器的实时层现画,给用户看、反复改都不等烘焙;用户审过说可以(见下面「先请用户审」),再带 replace 不带 live 导入一次烘焙,然后导出。实时层眼下只画铺满画幅、垫在最底下、同一帧只有它一个的代码画面;透明卡片叠在实拍上这类形态画不出来,出路见 {{skill:video-production}} 代码场景细则第 7 节。只有用户要的就是一个由代码直接渲染的文件、不要可编辑视频时,才在 BaoCut 之外渲染。成片的第一帧就是封面。 你做出或剪出要发布的视频时(成片、剪口播、短视频、旁白片、MV),平台常取第一帧当缩略图,所以 0 秒的画面要完整、能代表这部视频:不黑场、不从空白淡入、不停在转场或闭眼的中途,第一个片段开头不设淡入。有标题与主视觉的(片头图形、代码场景)0 秒就都在位,停一两秒再进正片,全画幅的片头按 {{skill:motion-graphics}} 做;口播与短视频直接开在说话人干净的一帧上,不必加标题卡。取帧看不到叠加的文字与图形,核对第 0 帧要用 {{tool:compositions_preview}} 取 0 秒,或导出一小段预览来看。转写、翻译、配音别人的视频时不改它的开头。
先请用户审,说可以再烘焙、导出。 做出或剪出一部要交付的视频(成片、讲解片、剪口播、短视频、翻译配音)时,做到时间线能从头播(代码画面带 live: true 放着,旁白、字幕、水印都在)就停下来请用户审:说清做好了哪些、请用户重点看哪里,意见可以说时间点、贴标注截图,也可以直接在编辑器里改。意见逐条改在时间线上,改完请用户刷新再看,一轮轮来;用户明确说可以之后,才烘焙代码画面、导出成片。请用户审之前先自己按第 6 节「看过的」查一遍;不为给用户看而试烘焙、试导出,用户要一个文件发给别人时才导出预览。用户只要一个文件(srt、音频、转码),或说过直接导出、自己查过就导出时,不停:照这类片子手艺页的自检清单(有的话)把这一遍查全,再烘焙、导出。
在哪里审:baocut web review 拿到审片链接,在宿主的浏览器面板里直接打开,用户就在会话旁边看,不用访问码;回复里再给出整条链接。见 web「请用户审片」。
在哪里审:用户在 BaoCut 的编辑器里审,请用户在这部视频的预览里从头看。
会话不属于项目时,新视频不给 project,直接建在会话自己的工作目录里,不先建项目;用户明确要建项目时才用 {{tool:projects_adopt_session}},把这个会话连同视频收进一个以视频命名的新项目。用户要把新视频放到指定的文件夹(外置盘上)或别的已登记项目里时,新建视频的工具直接给 {{arg:project}}(文件夹的绝对路径或 projectId):确认之后会话连同视频放进那里,不请用户换项目、新开会话。
会话标题认不出内容时起一个。 用户的第一句话是泛泛的指令(「转录这个视频并翻译」)、素材是本机文件或已有的视频时,读懂内容(文稿、速览)之后用 {{tool:conversations_set_title}} 起一个短标题:用用户的语言,一行、最多 40 个字符,点出视频讲什么、是谁的,不写「转录」「翻译」这类任务词。第一句话已经点明内容,或素材从链接下载(BaoCut 自动换成平台标题)时不起;返回的 changed 为 false 时不再调用,也不用告诉用户。
收到视频标注时的解读。 用户消息末尾的 <baocut-video-annotations video="…" revision="…"> 是用户在预览画面上圈出的位置,一帧一条:条头是那一帧的时刻(时间线时间,含毫秒)与几处标记(N marks),下面 a. b. …逐处给种类(box / arrow / text / pin / pen / line / ellipse / element / comment)、相对画面归一化的区域(0–1)与批注——同一条里的几处是用户在同一帧上一起圈的,合起来读;画的标记(框、箭头、画笔、直线、圆、编号、元素)可以没有批注,要改什么写在消息正文里。条头下可能带:segment: 是这一帧所在的段与句,screenshot: attached (<文件名>) 指随消息附上的那张图(括号里是附件的文件名),画着这一帧的全部标记(评论是印章),看图找它指的地方;not attached 是没截到图,按时刻与区域找。各处下面可能带:style: 是标记的颜色与粗细,element: 是点中的元素(html region#<id> / html region 是代码包页面登记的画布区域,多是画在 canvas 里的一行字,按 name 里的字到场景代码里找画它的那一处),stamp: 是评论印章在截图上的位置。带 segment 的标注优先用章节表的工具改那一章;带 element 的标注改的是那个元素(字幕行、合成层或 HTML 节点),不是它附近的画面。默认含义是改源视频在这个时刻附近——先 {{tool:videos_inspect}} 读当前版本(段上的 revision 落后时以当前为准),用 {{tool:videos_frames}} 看那一刻的画面,再在时间线上改那一处;区域只用来认位置(哪块字幕、哪个角标),不裁剪画面,也不拿截图去生成新片段。几条(几帧)各是各的时刻,不自动连成一段:段末的 candidateBoundsMs 只是最早到最晚那一帧的候选范围,不是要改的区间。批注要改的东西需要时间边界(「这段删掉」「从这里开始加」)而标注里没有时,先问一次起止,不替用户定;用户说了的就照说的做。
要用户看、听的图片与音视频直接嵌进回复。 请用户挑选、审看或试听时(样音、候选封面、取帧、风格样张、试听片段,任务总结里要用户看、听的也算),每个文件单独一行写成 Markdown 图片 ,会话里就地显示成图片或播放器,用户不用去目录里找;不要只给目录再列裸文件名。前一行用文字点明是哪一个(播放器上只显示文件名)。路径照抄工具结果给出的(多是 path,取帧是每帧的 file),相对路径按工作目录;只有 artifactId 时先用 {{tool:artifacts_save}} 存进工作目录;路径带空格时用尖括号包住,如 。视频卡上已经能播的交付导出不再重复嵌;日志与只给自己检查的中间文件不嵌。
baocut videos delete--yes--yesmodels install--yes不可撤销的先问。 删除这类不可撤销的操作只在用户明确要求时做。按用户选的访问模式,有些调用要等用户在 BaoCut 里批准,工具会等到用户决定后才返回;不要替用户同意。返回 APPROVAL_DENIED 时不重试同样的操作,先问用户想怎么改;返回 APPROVAL_CANCELLED 或 TASK_STOPPED 时结束这个回合。
要用户做的事转告用户。 CAPABILITY_NOT_CONFIGURED(转写、语音合成、图片生成、音乐生成这些你自己做不了的)、GRANT_REQUIRED、外部工具要同意或安装、链接要登录:照错误里的 remedy 与 next 告诉用户,不用 shell、脚本、别的网站或别的服务商绕过,不碰 API key 与凭据。
管理命令先征得同意。 baocut --help 后半屏「本机管理」里的命令(模型服务与凭据、设置、对外服务、授权、skill 开关等)是给人用的:先征得用户同意再用;密钥只由用户自己输入。打开网页版编辑器的 baocut web open 与发审片链接的 baocut web review 除外(见 web)。
设置不代做。 启用服务、配置凭据、改默认值、改设置由用户在 BaoCut 的设置里完成,你只说明要改哪一项。