抖音口播三件套
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_0bb3c523/douyin-txt 这个技能。
技能介绍
解决什么问题
把一条抖音视频变成可用素材,通常要拆成三步:拿到无水印视频、从视频里抽出人声音频、再把人声转成可读的文字。这三件事各自都能找到一个工具解决,但串起来会踩一堆坑:解析接口要注册拿 Token、识别要填 API Key、Windows 上跑起来还会因为编码或 OpenMP 直接崩溃。
这个 skill 把链路压成一次调用,默认路径全程零 Key、零费用,模型跑起来之后完全离线。
核心流程
输入支持四种:抖音分享链接、短链、.mp4 直链,或本地视频文件的绝对路径。
- 解析与下载:默认走抖音官方分享页
iesdouyin.com/share/video/<id>/,页面内嵌的_ROUTER_DATA里有播放直链,脚本把/playwm/换成/play/优先取无水印版本,免注册、免 Cookie。 - 提取口播音频:用 PyAV 直接抽取音轨重编码为单声道
_口播.mp3,不依赖系统 ffmpeg,也不触发 ASR。 - 生成逐字稿:本地
whisper.cpp识别(纯 C++ 实现,绕开 torch/ctranslate2 的 OpenMP 段错误),再依次经过 OpenCC 繁转简、sherpa-onnx的 CT-Transformer 补标点、按句末标点断行,最终交付_口播逐字稿.txt。
本地视频输入会跳过解析和下载,抖音通道挂了也能把口播环节跑完,这是最稳的兜底。
适用边界与注意点
- 不产出标题文案。自 v1.4.0 起移除了该能力,
resolve()也不再返回desc字段,机制上杜绝模型据此生成发布文案。 - 解析失败不是 bug。免 Key 通道的稳定性不由本 skill 控制,视频可能已删除、设私密或需要登录。脚本会打印结构化兜底清单而不是崩溃,最实际的做法是把本地
.mp4路径发给 AI。 - 首次运行需要联网一次:
ggml-small.bin(约 487MB)和标点模型(约 76MB)会经 HF 镜像下载到~/.workbuddy/models/下,之后完全离线。离线环境需手动放置这两个目录。 - 识别速度属正常开销:CPU 单线程下 5 分钟音频约 60–70 秒(约 0.2x 实时)。
- 跨平台已核验:Windows 上脚本入口强制 UTF-8 输出,避免中文控制台 GBK 编码崩溃;macOS 上解压出的脚本可能被 Gatekeeper 拦截,终端显式执行一次即可自愈。
- 外部 ASR 只是兜底:仅在本地识别连续失败且配置了
OPENAI_API_KEY时启用,兼容siliconflow(自动用 FunAudioLLM/SenseVoiceSmall)或智谱端点。
使用场景
- 你拿到一条抖音爆款视频链接,需要把视频、音频和口播逐字稿一次性保存下来,方便后续剪辑复用或做同款内容
- 你是知识付费或教育内容创作者,想把抖音上的课程讲解片段下载保存,并提取出带标点断行的讲稿用于制作学习笔记
- 你在做内容调研时收到客户发来的抖音参考视频,本地没有文件,想快速下载视频并拿到对应的口语文字稿用于内部分析
- 你收到一条只有抖音链接的素材需求,需要同时交付视频文件、单独音频和逐字稿三件套给下游同事做后续处理
适合人员
- 短视频内容创作者:经常拆解抖音爆款视频做同款或混剪,需要快速拿到视频、音频和口播稿三份素材同步处理
- 知识付费或教育行业从业者:想在抖音课程片段中提取口播文字,用于制作讲义、复习材料或短视频脚本
- 新媒体或增长运营:负责抖音内容的搬运和二次创作,拿到视频链接后要同时产出逐字稿用于本地撰写适配文案
- 独立开发者或技术从业者:需要一个可离线运行的本地工具,把抖音视频批量转为带标点的口语转写文本做数据处理