用途 video-chapters 用于给视频分章节、加章节或做时间轴目录，把章节写进视频。它面向需要观众快速跳看定位的场景：观众拖动进度条时，凭借章节名称就能知道该去哪个段落。它也可以按照作者给出的时间大纲生成章节，或调整既有章节的粗细。它不用于只想在简介里列出已有章节（那是起标题与写简介的工作），也不用于给文章分节。
主要能力
- 读取视频信息：用 videos_inspect 查看时长、已有章节和文档，识别作者自带的章节（来自平台或简介中的时间戳大纲）。
- 导出带时间码的转写文稿（md 格式、timestamps true），章节时间取段落开头的时间码。
- 采用作者章节或用户贴来的带上时间的大纲（chapters_adopt），把每条吸到文稿中最近的段落或句子起点，清洗标题后整份写入；回执给出 matched、ambiguous、snapped、unanchored、offTimeline 等状态。
- 为无标题章节（Untitled Chapter N）依据下一章之前的转写补标题。
- 用 speech_topic_boundaries 探测话题转折候选（mode 为 topic），结合 before/after 原文确认；没有候选时读文稿自行判断（mode 为 model）。
- 一次写入整份章节（edits_apply 的 setChapters），也可只改一两章（upsertChapter、removeChapter）。
使用方式 先取材料：查看视频时长、已有章节与转写；没有转写时先转写。已有章节时先询问用户是替换、调整还是保留。有作者章节或用户大纲时优先采用，不自行重分、不手工对时间。需要自己分时，按粗细定目标章数（粗约 10 分钟一章、适合约 5 分钟、细约 2.5 分钟，至少 2 章、最多 20 章，超一小时按每小时 20 章放大），先通读文稿列出话题转换点，章节起点落在段落开头。每章写一个路标式标题和一句不超过约 20 词的摘要，标题避免“第一部分”“继续”这类无意义表述。最后用 setChapters 一次写入，按时间严格递增；只改少数章节时用 upsertChapter 或 removeChapter。
适用场景 给长视频、访谈、课程录制做可跳看的时间轴目录；按作者的时间大纲整理章节；为自动下载得到的无标题章节补标题；调整既有章节的粒度。
限制 必须要有视频转写；没有作者章节时返回 NO_SOURCE_CHAPTERS，素材不在时间线上时返回 ASSET_NOT_PLACED，需先处理。话题候选默认最多 24 条。章节固定在时间线时刻上：剪口播类剪辑会带动章节，移动、删除片段、波纹删除等不会，改时长时需提醒用户重新对照。不得按时间平均切分、不得把起点放在一句话中间、不得自行估算时间；不得覆盖用户已有章节；不硬凑目标章数。分章失败不影响转写和其他结果，最多重试一次。