feat(video): 《拆解 Claude Code》、Pipeline Series、B 型信源取证基建

[ThreeFish-AI]

背景

• 本次变更要解决的问题：把开源课程 Learn Claude Code 的「工具与执行」四章（s01 Agent Loop / s02 Tool Use / s03 Permission / s04 Hooks）做成一集面向普通人的科普视频。这是**新系列「Claude Code 通俗全解」**的首集，与已有的自进化三集完全独立。为承载「独立新系列」与「非论文信源」两个新维度，公共管线需同步扩展。
• 关联上下文：media/series.md（两系列总览）· 公共管线 · 新记录 ISSUE-164 / 165 / 166（issue.md）

核心变更

一、新集工程 media/claude-code-explained-video/（成片已交付）

• 170 句 / 4048 字 / 7 幕 / 39 镜；成片 14:14（1080p30，h264 + aac 189kb/s，42.1 MB）+ srt/vtt 各 170 cue + 封面帧。
• 配音：IndexTTS-2.5 本人音色克隆，sunny-steady + me-bright.wav，实测语速 307 字/分。
• 视觉契约（反枚举原则，四章不给四色，映射「一个不变的内核 + 三层可拆卸外挂」）：陶土橙 #D97757 内核循环（全片恒定）/ 石青 #64C4C0 外挂机制 / 警示红 #EF6461 拒绝闸门 —— 对底色实测 6.06 / 9.18 / 6.00 : 1，全过 4.5:1。
• 站点 4 段交互式可视化按信息结构重建（While-Loop 环 / Dispatch Map / Permission Desk / Hook Workbench），未复刻其美术、未下载任何图片素材。

二、管线多系列化

media/series.json 顶层由单 series 对象改为 seriesList[]；check_series.py 相应分层——反串线规则（1）跨系列全局生效（两系列口播互不引用），顺序类规则（2/3/4）按系列内判定（episode 的 1..N 连续性只在系列内成立，slug 仍全局唯一）。

三、B 型信源取证基建

• skills/01-paper-extraction.md → 01-source-extraction.md：A 型论文正文原样保留，新增 B 型（文档/代码/课程站点） 大节——双轨取证、证据三级（三级「他人对闭源产品源码的分析」口播必须带归属句，不得当作产品既成事实）、数字口径须可复算、二次信源分歧清单必备。
• 新工具 source_ledger.py（fetch/list/verify）：repo 类校验 URL 含 commit sha 且 raw 指纹漂移即 FAIL；site 类只比剥标签归一后的正文、漂移报 WARN（构建产物哈希天天变，比 raw 毫无信噪比）。

四、三条实测口径沉淀

沉淀	位置	内容
时长口径	skills/02	chars_per_min = 280 是含停顿的等效口径（实测纯语速 307，停顿开销抵消，全片估算误差 2%）；推论「字数是硬约束、句数不是」——本集实测 263 句合并到 229 句，字数只掉 145，时长几乎没动
分幕音画复检	skills/08	配音是全流程最慢一环（2.1 h），而动画与旁白的错配只在真实时长下暴露 → 每合成完一幕就用该幕真实时长重算 beat 帧位、逐镜抽帧。本集据此修 9 处缺陷，3 处在等长外推下全部漏检
渲染耗时	skills/09	草渲 6.0 分钟 / 终渲 8.2 分钟（25642 帧）——渲染是分钟级，「渲染慢」是错觉；另记 Rendered N/N ≠ 完成（编码是第二段）

五、内容真实性校准（三处，均改变了成片说法）

1. 课程反复说「循环里只改了一行」，逐章 diff 实测只在第二章成立（s03 插 5 行闸门、s04 另长出 Stop 钩子分支）→ 改用可实测支撑的口径：骨架四章一字未改，变的只有「执行」那一步怎么写（总行 141→255 增 81%，agent_loop 恒在 20–28 行）。
2. 站点标注的章节行数 102/135/180/232 在固定提交上任何口径都复算不出（s04 声称 232、实测非空 213）。先按 ISSUE-162 验证过不是「未水合占位符」（站点是 SSG），判定为信源自身相对其代码陈旧 → 口播只说趋势、画面给实测值 + 口径 + 取数日期（ISSUE-164）。
3. 站点仍在教 stop_reason，而仓库已改成检查内容块——站点「深入源码」里当作差异讲的那点已被上游自己消除 → 采用仓库版。

六、qa_frames 字幕侵入判据几何化（ISSUE-166）

草渲 QA 首跑刷出 500+ 条「角标侵入」WARN 而画面实际干净：旧判据假设字幕框是实心亮矩形，而 Subtitle.tsx 的底是半透明 rgba(6,8,12,0.68)（实测灰度 0.10–0.14 << 文字阈值 0.45），于是每个汉字各成一段、字幕把自己每个字都举报成侵入物。改用几何法（字幕框高度是已知量，只查框上方窄带），无阈值自由度。

风险与回滚

• 主要风险：① check_series.py 的 schema 变更是破坏性的——旧单系列 series.json 不再被接受（已同步改数据 + 6 例多系列用例锁定语义）；② skills/01 更名可能留死链（已全仓 grep 修正 3 处引用，check_series 规则 5 会持续抓）；③ qa_frames 判据改动影响既有三集的 QA 结论（新判据更严格于几何、更宽松于亮度，需在下次三集重渲时复验）。
• 回滚方式：三块解耦，可独立回滚——新集工程（整目录删除，无外部引用）/ 管线多系列化（git revert 6206150 的 series.* + check_series.py + 其测试）/ 判据改动（git revert d6c9f9a）。成片产物均在 .gitignore 内，不入库。

验证证据

• 单元测试：media/pipeline/tests/ 46 → 64 项全绿（+6 多系列语义、+11 source_ledger、+1 半透明字幕假报回归）。
• 集成测试：check_series.py 2 系列 / 4 集 · 受检 116 文件 · FAIL 0 WARN 0；source_ledger verify 12 条信源 FAIL 0 WARN 0（交付前复验，站点正文至今未变）；check_script 双口径时长门 FAIL 0 WARN 0（估算 14.5 / 实测 14.2，预算窗 13.0–14.6）。
• E2E：tsc --noEmit 通过；草渲 25642 帧 7 幕 FAIL 0；终渲全分辨率抽帧 FAIL 0（唯一 WARN 为刻意的「画面凝住」）；尾幕末 6 句 FAIL 0 WARN 0，渐黑贴合末 beat（末帧灰度 0.0118），未复现第三集「渐黑提前收尾致长黑屏」。
• 关键证据：qa_frames --check-theme FAIL 0（三概念色 6.06 / 9.18 / 6.00 : 1）；pre-commit run 全绿；根 pnpm-lock.yaml 零变更（嵌套工程隔离有效）。
• 人工目检：39 镜逐镜抽帧 + 配音期间 4 轮分幕音画复检（详见 verification-2026-08.md）；真实性校验 RISKY 0、三级证据归属 12 组全覆盖。

影响范围

• 前端：无（media/ 下的 Remotion 工程 --ignore-workspace 独立安装，不并入根 workspace，根 lockfile 零变更）。
• 后端：无。
• GitHub Actions / 文档：pre-commit 的 series-consistency-check 行为随 schema 变更（已适配）；文档更新 series.md / knowledge-map.md / CHANGELOG.md / issue.md（+3 条）/ pipeline/README / skills 01·02·06·08·09 / SKILL.md 路由表。

Next Best Action

1. 人工听审「Claude Code」发音（全片仅 2 句含此词）：afplay media/claude-code-explained-video/video/public/audio/p1-20.mp3 —— 若不满意，改写 2 句 + 重渲约 15 分钟。这是唯一无法机器判定的关卡。
2. 清理声音小样：.temp/voice-samples/ 尚存 3 个领航小样（含本人音色，属生物特征信息），听审确认后执行 pipeline.py clean-samples。
3. 发布前合规自查：按平台规则标注 AI 合成语音；简介附课程链接 + 固定提交号 + MIT 许可。
4. 横向复验：本次 qa_frames 判据改动对既有三集的影响，建议在它们下次重渲（换 sunny-steady）时一并复验。