Script Writing Guidelines
脚本结构原则
脚本应该像自然对话一样流畅，不要用“开场/引言/正文/总结/CTA”这种模板化结构。按内容逻辑分段，每段用描述性标题。
正面案例
写脚本前先扫一眼 references/examples-tutorial.md - 这是用户认可的「教程 / 配置类视频」标准范本，包含 Hook 开篇结构、内嵌录制提示、节奏与判断的具体写法。
写作规则
- Hook 开篇结构：第一句话先做自我介绍 - “大家好，我是 {名字}”。紧跟一两句承接上期或引出本期主题。然后用一段「先点受众再讲技术」的引导（“对于注重 X 的朋友来说......”）解释这期为什么值得看。最后用“那现在我们就开始吧”类软过渡进入正文。不要把自我介绍埋到 hook 第三句之后、也不要写“今天 5 分钟讲清楚”这类时长承诺 - 让观众自己感受节奏。
- 按内容分段，不按模板：章节标题是描述性的（“安装配置”、“登录演示”），不是编号式的（“要点一”、“第三章”）。不要在章节标题里标注时间戳 - 节奏由作者录制时掌控，估算的时间戳只会成为噪音。
- 口语化：写出来的是要说的话，不是文章。用短句，用“先澄清一点”、“那为什么还要折腾”、“问题出在......上”这种口语表达。
- 制作备注三种格式：
- 屏上呈现 / 操作类用括号
（屏幕：……）- 每段开头（或切画面处）写明这段该在屏幕上放什么：（屏幕：切到官网 {url}，从 #hero 慢滚）、（屏幕：终端跑 npx … 的输出）、（屏幕：编辑器里 SKILL.md 的 Color 段）、（屏幕：A vs B 对比卡）。纯操作动作也可用（录屏开始）、（终端进入 ~/demo 目录）。 - 引用文档 / 卡片类（剪辑时要叠一张外部链接卡或截图）用内嵌 blockquote，写在对应口播句的紧下方 - 例如
> 这里分享 X 的官方文档 - https://...。blockquote 内联在段落里，剪辑时不会漏。 - 未确定的内容仍用
<!-- TODO: 补充... -->标记（录前核对命令名 / 输出 / 数字也写这里）。
- 屏上呈现 / 操作类用括号
- 结尾自然：不需要仪式感的“请点赞关注”。简短回顾，自然收束。
- 时间把控：中文口播约 200-250 字/分钟，英文约 130-150 词/分钟。根据目标时长控制篇幅。
- 节奏与排比：避免三连短句 staccato 堆叠开场（如 “零网络、零订阅、零账单。”）。把要点串成完整句子，多用「无论是 X，还是 Y，都......」整齐结构来枚举场景，而不是逗号串联的破碎枚举。例外 - 评论 / 拆解类视频可以适度提高 punch 密度；配置 / 教程类一律按这条来。
- 判断保留，工程裁判腔收掉：不要用“关键判断”、“端点直接搬回你机器”、“这就是好 skill 的样子”这种锋利短语充当过场。改成“大家根据自己的配置选”、“在演示中我选 X”、“诚实讲 X” 这种平视引导式。带判断的句子本身保留（“永远在你手上”、“该用本地的场景里它够用”）- 收的是裁判腔，不是判断。
- 诚实承认硬约束：碰到硬件、版本、上下文长度这类硬约束时，把限制和换算明摆出来（“24GB 跑不动 30B + 64k”），不要藏。这是教学视频比技术营销视频可信的关键差别。
- 屏上呈现推荐（逐段判断该放什么画面）：口播稿不只是「说什么」，还要告诉作者「屏幕上放什么」。作为 AI，逐段智能判断这段口播配什么画面最有说服力，写成内联
（屏幕：……）备注：- 讲概念 → 切对应网页 / 官网板块慢滚当 B-roll；演操作 → 终端 / 应用界面；要让观众看到「写死的规则 / 关键实现」→ 一段代码 / 文件；做对比 / 小结 / 速查 → 叠一张卡（对比卡 / 速查卡 / 总览卡）。
- 在脚本开头给一张「屏上呈现总则」表：先列本期画面来源（A 网页 / B 终端 / C 代码 / D 叠加卡，按需增减），再给一张「段 → 主画面 → 具体放哪一段」的逐段映射。正文每段再用
（屏幕：……）落到具体内容。 - 不是每段都要切画面 - 判断「需不需要」也是你的工作。纯口播段直接标「纯口播」，别硬塞画面；别让画面长时间停在一张静止图上。
- 引用具体网页锚点 / 命令 / 文件名时，提醒录前核对是否还在（写进
<!-- TODO -->），锚点 / 命令名变了别硬套。
- 照着念友好（写完默念一遍）：口播稿是作者照着念的，不是写给人读的文章。每句都要顺口 - 写完过一遍，最好默念，卡壳的地方就改。
- 要改：长定语套长定语、术语堆砌、嵌套从句、被动腔、书面连接词（“此外”“综上所述”“基于上述”）、一句话塞三四个信息点。
- 改成：短句、主动语态、口语连接（“那”“所以”“你看”“说白了”）、一句话一个意思、把长链拆成两三句。
- 判断标准：这句话你能不能一口气顺当念出来？念到一半要回头看才懂的句子，就是太书面，必须拆。带判断、带细节的内容保留，收的是书面腔，不是信息量。