分章节

章节是给观众跳着看用的：拖进度条的人看一眼章节名，就知道要去哪一段；看过的人想回头找某个地方，也靠它。所以章节的标题要说清这一段讲什么，起点要落在话题真正开始的地方，一个章节对应一个话题。

最容易做坏的样子有两种。一种是按时间平均切：每五分钟一章，起点落在一句话的中间，标题是「第一部分」「继续讨论」，观众看了等于没看。另一种是标题太像总结：一章一句长话，章节列表反而读不动。章节名是路标，不是摘要；摘要另有一句话的位置。

1. 取材料

1. 用 videos_inspect 看视频：时长、已有的章节（chapters）、文档。没有转写（kind 为 speech 的文档）时先转写，告诉用户转写在进行。从链接导入的素材另有 assets[].source：chapters 是作者的章节（平台给的结构化章节，或从简介里的时间戳大纲解析出来的），没有时是 []；description 是截断的简介。
2. 带时间码的文稿：export（kind transcript、format md、timestamps true；有几份文稿时按它列出的候选用 documentId 指定），jobs_inspect 等到 completed，读 outputs 里的文件。它按段落给出剪辑后时间线上的时间，章节的时间就取段落开头的这个时间码，不要自己估算。
3. 视频已经有章节时，先问用户是要替换、调整还是保留；用户只说「加章节」而已有的章节是新的，不要覆盖。

2. 有作者章节或用户给了大纲时

作者自己分过的章节通常比你分的更贴近他的意图，照它来，不自己分，也不手工对时间。来源素材自带章节（assets[].source.chapters 不为空），或用户贴来一份带时间的大纲（0:00 开场、1:02:03 问答 这类）时，用 chapters_adopt：