- name
SKILL.md
File skill tetap berada di repositori penerbit.
Tempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add JimLiu/baocut --skill baocut -a cursor -yTempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add JimLiu/baocut --skill baocut -a claude-code -yTempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add JimLiu/baocut --skill baocut -a codex -yTempel perintah yang disalin di terminal. Perintah itu memasang SKILL.md ini ke agen tersebut.
npx skills add JimLiu/baocut --skill baocut -a grok -yKirim pesan yang disalin di chat Grok Bot. Bot mengambil SKILL.md ini dari GitHub dan menambahkannya ke skill yang dipakai bersama oleh semua Bot Anda.
Install this skill: https://github.com/JimLiu/baocut/tree/HEAD/skills/baocutDari penerbit
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
Unduh skills/baocut/SKILL.md dari penerbit, atau salin path-nya dan buka repositori. PlugMCP hanya mendaftar skill ini dan tidak meng-host filenya.
Penerbit menyimpannya di https://github.com/JimLiu/baocut.
Claude, Cursor, Codex, dan Grok Build bisa membaca SKILL.md yang Anda tambahkan dari repositori penerbit. Grok Bot memasangnya saat Anda mengirim tautan folder GitHub skill tersebut di chat.
| 用内置主播或生成一个卡通主播,跟着旁白自动对口型、眨眼、点头、换表情,常驻画面角落讲解或整镜出镜;有内置主播表、角色包打包与口型计算脚本 |
| {{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 的设置里完成,你只说明要改哪一项。