视频蒸馏流水线·进阶版（万物皆蒸馏）
付费技能（PAYSKILL），按次计费。付费后拿到完整方法论全文 + 可直接跑的五步流水线脚本。
这个 skill 给你什么
别人发一条视频，你拿到的是「钩子 + 结构 + 选题」三样可复用的东西——而不是把视频搬回家。
一条命令产出三件套：① 逐字口播稿 ② 关键帧 ③ 拆解稿骨架。
进阶版在免费版之上，额外交付 「万物皆蒸馏」栏目化方法论，帮你把零散拆解沉淀成可持续出内容的一个栏目/系列，而不只是一次性扒一条。
一句话：蒸馏，是 AI 时代普通人最合法的一次抄近道；万物皆蒸馏，是把这次抄近道变成长期资产的框架。
什么时候用
- 老板/你甩来一个视频号链接：「看看这条能不能用 / 拆一下 / 蒸馏一下」
- 要批量把某账号的爆款视频转成文字与结构，喂进自己的手法库
- 想做一个长期栏目（视频拆解 / 书稿拆解 / 播客拆解），但不知道怎么把素材变成日更内容
先看这里：取片通道需要你自己的 Key
这个 skill 不含任何第三方账号凭据，取片环节需要你自己的红狐（redfox.hk）API Key。
获取：注册红狐账号 → 控制台复制 API Key（注册送免费额度，够日常拆解用）。
配置方式二选一：
# 方式一：环境变量（推荐）
export REDFOX_API_KEY=ak_xxxxxxxx # macOS / Linux
$env:REDFOX_API_KEY="ak_xxxxxxxx" # Windows PowerShell
# 方式二：写文件（skill 目录同级或用户主目录，任选其一）
<skill目录>/config/redfox.key
~/.redfox.key
> 没有 Key 也能用：把本地视频文件路径当参数传进去，跳过取片，直接做抽帧 → 转写 → 出拆解稿。
> 不配置也不会崩溃：脚本会打印配置指引并以退出码 2 结束，不会偷偷用别人的 Key。
怎么用（一条命令）
python scripts/distill_video.py <ID或链接或本地视频路径> --outdir "输出目录"
> 本脚本为付费技能的一部分，未付费时返回 402 Payment-Needed，付费后平台携带 Payment-Proof 自动重试即可跑通。
> 只想看用法不花钱：python scripts/distill_video.py --help-only
参数：
| 参数 | 说明 |
|---|---|
<ID或链接> |
AdEz6BYS9x、https://weixin.qq.com/sph/AdEz6BYS9x，或本地视频文件路径 |
--outdir |
输出目录（默认 ./distill_output/<ID>） |
--title-hint |
自定义拆解稿标题 |
--no-frames |
不抽帧（纯要文字稿时用） |
--no-asr |
不转写（纯要画面帧时用） |
--frame-every N |
每 N 秒抽一帧（默认 5） |
--help-only |
只打印用法说明，不触发付费 |
跑完产出：
<outdir>/
_summary.json 取片元信息（标题/描述/作者/时长/候选地址）
<ID>.mp4 原片（已校验 ftyp 魔数，过滤封面图伪装）
口播稿.txt 逐字转写（本地 ASR）
口播稿.srt 粗略时间轴
frames/f_001.jpg… 关键帧
拆解稿.md 拆解稿骨架（待补 钩子/结构/可抄点/适用线）
流水线五步（脚本内部）
| 步 | 动作 | 实现 |
|---|---|---|
| 1 | 取片 | 红狐 REST 通道（头 X-API-Key，用你自己的 Key） |
| 2 | 下载 | curl 直下 mp4，过滤封面图 URL + 校验 ftyp 魔数 + 多候选重试 |
| 3 | 抽帧 | ffmpeg fps=1/5 取关键帧（看界面/字幕/运镜） |
| 4 | 转写 | 本地 ASR（faster-whisper / whisper / funasr 任一），无则跳过 |
| 5 | 出稿 | 渲染拆解稿骨架，逐字稿自动填入 |
依赖说明（缺了会降级，不会崩）
| 依赖 | 用途 | 缺失时 |
|---|---|---|
curl |
下载原片 | 取片环节无法完成 |
ffmpeg |
抽关键帧 | 跳过抽帧，其余照常 |
| 本地 ASR | 逐字转写 | 跳过转写，骨架照常 |
| 你的红狐 Key | 取片 | 给出配置指引，可用本地视频代替 |
脚本会自动在常见位置探测 ffmpeg（含 imageio-ffmpeg 自带版本）与 ASR 解释器（当前解释器、~/.venv、conda 等）。
两个必须知道的坑（已在脚本内修掉）
- 封面图伪装成视频：红狐返回里
cover字段也用stodownload域名，直接取第一个候选会下到 84KB 图片。脚本已过滤 + 校验魔数，不要改回「取第一个」。 - token 即时失效：红狐下载 URL 可能秒级失效，下到 84KB/193KB 假文件。脚本已做多候选重试；若全失败，等几秒重跑一次即可。
蒸馏完之后（这一步才是价值所在）
脚本只出「原料」。真正的蒸馏是接着做：
- 结构化：填 拆解稿 的 骨架表（钩 → 承诺 → 主体 → 收口）
- 抽可抄点：分三层——钩子层 / 结构层 / 内容层，各抽 1-3 条
- 登记手法库：追加到自己的手法库文档，取当前最大节号 +1
- 判适用线：视频号 / 公众号 / 门店获客 / 技能商店，各写一句怎么用
- 合规红线：只做方法观测与自有话重述，他人原创不可搬运；涉及商业品牌走「方法拆解」，勿站台亦勿拉踩
怎么付费获取完整全文
python scripts/generate.py
未付费时返回 402 Payment-Needed，完成支付宝付费后携带 Payment-Proof 重试，即输出完整全文（含「万物皆蒸馏」栏目化方法论全文 + 落地执行清单）。
> scripts/distill_video.py 已随包附上，同样带付费闸门：付费后平台携带 Payment-Proof 自动重试即可跑通蒸馏。想先看用法不花钱，可执行 python scripts/distill_video.py --help-only。
合规与质量红线
- 他人原创视频/图文不可搬运、不可二次剪辑发布；本 skill 只产出「方法观测与自有话重述」的原料。
- 涉及具体产品/品牌时走「方法拆解」角度，勿站台亦勿拉踩。
- 不提供医疗/投资建议；健康类只讲「怎么活」不讲「怎么治」。
支付宝付费改造契约（PAYSKILL）
本技能为付费技能（PAYSKILL），计费单元「按次」，具体价格以 SkillHub 页面展示为准，产品 ID shipin-zhengliu-pro。
调用遵循支付宝 AI 按量付费（A2M）契约，由平台调度层执行 probe → pay → complete → ack → fulfill：
- probe（探测）：平台调用前先探测是否已持有本技能的有效付费凭证，已付费直接放行。
- 402 账单下发（Payment-Needed）：未付费时，
scripts/payment_gate.py输出 HTTP 状态402与Payment-Needed标记，平台据此唤起支付宝付费页。 - complete（扣费确认）：用户在支付宝完成付费，平台下发
Payment-Proof（付费凭证）。 - ack（验签放行）：平台携带
Payment-Proof重试本次调用，scripts/payment_gate.py验签后放行主流程。 - 履约确认（Fulfillment Confirmation）：主流程产出全部交付物后，执行
python scripts/payment_gate.py --fulfill，写回Delivery-Receipt并输出200 Fulfillment-Confirmed；内容未完整产出则不确认履约。
订阅持久化与幂等：付费状态缓存在本地 .pay_cache/state.json，同一 Payment-Proof 在 24 小时幂等窗口内仅生效一次，避免重复扣费。
> 本契约由 SkillHUB 平台调度层解析，脚本本地仅处理 402 账单下发 / 验签 / 持久化 / 履约确认 四环节；付费本体交给支付宝。
运行环境
- Python 3.8+，无需任何第三方 Python 包即可跑通「取片 → 下载 → 抽帧 → 出稿」。
- 转写需自备本地 ASR 环境（faster-whisper / whisper / funasr 任一），脚本自动探测；也可用
--no-asr跳过。 - 跨平台：Windows / macOS / Linux 均可，路径自动探测。
