课程与演示长视频剪辑
交付完整、易跟上的课程。围绕教学过程轻剪，不把长课改造成短视频，也不重排论述或补写台词。录屏、PPT、操作画面、样片播放和讲师窗口都可以是有效教学内容；不能仅凭横屏尺寸转去访谈剪辑。
按外部 个人配置 读取工具、字体、既有字幕参考、热词和工程位置。已点名本成员直接执行；尚未分流的自媒体请求由 yl-media → yl-video 分流一次。用户当前授权、已确认风格与版本优先，不重复索取确认。
三个判断维度
| 维度 | 判断 | 处理 |
|---|---|---|
| 表达 | 口误、失败重启、卡壳、无功能重复 | 删除失败部分；强调、递进、必要解释保留 |
| 时间与教学动作 | 当前是在讲解、演示、展示结果，还是无效等待 | 保留教学因果和可辨认的操作；等待、准备、离席及无关浏览删除或压缩 |
| 呈现与声音 | 字幕是否可靠、样片声是否突然跳大 | 单行固定样式；讲师与播放声分别处理，重叠段专门复核 |
ASR 无词只是复核候选，不是删除证据。 有声无词可能是咳嗽、键盘，也可能是识别失败、示例播放或叠声。画面变化可能是演示，也可能是加载动画。结合连续帧、完整上下文和原声判断，不能批量把无词段全部切掉或静音。
具体剪留规则和候选处置读 editorial.md。含样片、背景声或叠声时先读 audio.md。使用本地工具读 runtime.md；转写、字幕、渲染依赖按实际环境探测，不假定 ChatCut、GPU 或模型存在。
执行流程
- 盘点并分课。 探测每个源文件的时长、帧率、尺寸、音轨及声道；抽帧看布局。标题提供分课线索，最终边界由内容确定。一个文件可跨两课，一课可接多个文件；登记源区间与章节顺序。保留原片，工程在外部工作目录，交付目录只放可用成果。
- 完整转写与核名。 分析用 16k 单声道，成片保留原立体声。复用相同源版本已有词级转写，补查识别缺口。热词先用已有外部表，专名靠屏幕和上下文核定，项目修正与通用热词分开；不把猜测加进热词。
- 全粒度候选与逐条判断。 扫叠字、词和短语重复、填充、失败重启、长间隙、断续拖时长及无词段。
scripts/course_edit.py scan只给候选。每项记录cut/keep/compress/subtitle_only、理由、源时间；全文复核仍必做。长无词段看连续屏幕帧和讲师窗口，未知身份/内容保留待核。 - 冻结本轮剪点。 明确词删除与仅字幕处置，记录必要无声演示；不要把无法识别的叠声字幕删除变成音画删除。后续只补本轮指定修改，不能每次全量推翻已认可剪辑。半自动时按本轮要求先交完整原稿、标记稿；全自动可直接完成。
- 用唯一时间轴生成字幕和渲染。 帧网格量化只做一次，所有音画、字幕、静音区间、倍速与源片映射共用量化后的实际保留段。映射必须绑定源版本和最终文件，不能用后来修改的 keeps 解释旧成品。字幕修正后切句，保护完整中文词与英文名称；不得跨剪点冻结数秒，不能用缩小字号救超宽句。
- 平衡播放声。 以讲师讲话段为参考，单独调整示例播放声。独立音轨优先；混合轨先查立体声及原样片，必要时做已验证的对齐消减。不能给整个重叠段降低增益后声称讲师没变。具体方法、测量结果与分离边界都留在工程中。
- 导出与检查。 本地 FFmpeg 是课程长片的首选实现。已有风格和授权则沿用；没有既定选择时默认轻剪、白色粗体单行字幕、整体 1.1 倍速、无额外包装。倍速只从原声应用一次；修成片音量时复制视频轨，不再倍速、不改字幕。用户自定参数优先。
scripts/course_edit.py prepare/render/verify 提供便携的时间轴检查、单行 ASS 和本地导出；不是自动教学判断或声源分离器。大批任务先出短样确认实际字体和编码，再按课程独立导出。只合并用户要求的章节，不默认额外生成总合集。
完成标准
- 候选逐条处置，无未解释的有效词丢失；必要演示可看懂，课程顺序正确。
- 已知字幕误写残留检查；完整名称、单行、字号、宽度、安全区及显示时长检查，并渲染看实际效果。样片自带字幕与课程字幕冲突时避免堆叠，叠声只标可靠内容。
- 成片完整解码，时长和流信息符合计划；每个拼接源段抽查画面与音频对应，剪点检查吞字、爆音、重复和声画偏移。
- 各播放起止与重叠段比较修前/修后响度和峰值，确认讲师不被误压。机器测量、抽帧/抽查、实际听审及用户反馈分别记状态；没有听审不能写已逐秒听审。
- 版本文件名、最终 SHA-256、源与成片映射、实际字幕全文、剪留/音量处置和检查边界写入外部工程及简短交付记录。未完成项不得被本地打包成功掩盖。
交付可点击成片及简短变化说明。原片和已批准版本可恢复。验收与本轮预览结束后，默认交 yl-video-archive 按 去重收尾 清理本批临时副本、未采用导出及项目可再生缓存，不依赖个人约定或额外清理口令；原始输入、用户要求的可编辑工程、唯一/付费母带及未完成听审或回改所需材料保留。默认收尾不授权上传课程、发布平台、同步私人稿件或清理历史批次。Skill 只封装通用方法与工具，媒体、真实课程、模型、字体和个人热词留在包外。
用户确认成果并说“归档”时，按 确认归档清场 清除本批历轮工程与过程文件，只保留正式初始文件、最终成果及用户明确要求的交付；本成员一般性的工程/增强中间件保留条款不再构成额外保留理由。
防熵增收尾
课程原片和确认结果留正式课程目录，说明、已有逐字稿、最终PPT/PDF及封面按本轮交付保留；日常制作不备份。确认结果后清理本批全部制作轮次工程与过程，母带可用于重剪，不额外保留增强中间母版。
通用原则与独立磁盘排查汇总见 yl-anti-entropy；本成员上面的专项归档/清理步骤继续保留。
SkillHub 独立安装
运行前先读 安装与依赖说明。本包不会自动安装同级依赖；缺少必需成员或外部工具时停止相应分支并列明待办，不能跳过原流程而报告完成。
