如何把抖音、TikTok、微博、知乎视频转成文字稿:chubbyskills 本地转录环境搭建清单
如何把抖音、TikTok、微博、知乎视频转成文字稿:chubbyskills 本地转录环境搭建清单
把抖音、TikTok、微博、知乎的视频一键转成可搜索的文字稿,chubbyskills 帮你一次搞定。它是一套面向中文全渠道内容的开源工具集,核心思路是:yt-dlp 下载音频 → ffmpeg 解码 → SenseVoice-Small 本地模型转录 → 输出带来源信息的 Markdown 文字稿,全程在本地 CPU 上跑,不上传音频、不依赖 GPU、不配 API Key。
这篇清单文章带你从零搭好本地转录环境,并给出四个平台的验证方法和常见故障排查,跟着做即可跑通。
为什么要先准备本地转录环境
与 B站 / YouTube 的"字幕优先"不同,抖音、TikTok、微博、知乎没有稳定可用的字幕通道,只能走"视频转录"重依赖路径。一条命令背后需要三类依赖,缺任何一个都会在对应环节报错:
| 依赖 | 作用 | 缺失时的表现 |
|---|---|---|
ffmpeg(系统命令) |
从视频中提取、转码音频 | 下载后无法转 mp3,直接失败 |
yt-dlp(Python 包) |
解析平台链接并下载音频 | TikTok / 微博 / 知乎无法下载 |
funasr + modelscope + torch(Python 包) |
本地语音识别,默认 SenseVoice-Small 模型 | 音频下载了,但转不成文字 |
好消息是:chubbyskills 把这套依赖封装成了一条 setup.sh 命令,并且首次运行会自动从 ModelScope 下载约 893MB 的模型(国内网络速度快),之后完全离线可用。
本地转录环境搭建:5 步清单
第 1 步:获取完整仓库
注意要用安装器或完整仓库,单独下载某个技能目录会漏掉公共模块(详见 docs/installation.md):
git clone https://gitcode.com/gh_mirrors/ch/chubbyskills
cd chubbyskills
第 2 步:准备 Python 虚拟环境
需要 Python 3.9 及以上(建议 3.11+,可先 python3 --version 确认):
python3 -m venv .venv
source .venv/bin/activate
第 3 步:安装系统依赖 ffmpeg
# macOS
brew install ffmpeg
# Ubuntu / Debian
sudo apt install ffmpeg
第 4 步:一条命令装齐视频转录依赖
setup.sh 的 video 档位会检查 Python 和 ffmpeg,自动补装 yt-dlp、funasr、modelscope、torch、torchaudio,实现见 setup.sh:
bash setup.sh video
💡 首次安装体积较大(PyTorch 等),属于一次性成本。如果你同时要用播客转录,
bash setup.sh podcast依赖完全相同,装一次即可。
第 5 步:环境体检,确认全部就绪
python3 tools/check_env.py
体检脚本 tools/check_env.py 会逐项检查系统命令、Python 包,并按能力分组输出结果。看到这一行就说明四个平台的转录链路就绪:
✅ 视频转录:抖音·B站·TikTok·微博·知乎·小红书视频·X视频
也可以只验证单一平台:python3 tools/chubby.py doctor --platform douyin。
四个平台实测用法(每平台一条命令)
环境就绪后,进入对应技能目录运行脚本即可。四个平台各有一条命令,产物统一是带 frontmatter 的 Markdown 文件。
抖音视频转文字:支持短链接,被风控自动回退
cd douyin-transcribe
python scripts/transcribe.py "https://v.douyin.com/xxxxx"
脚本优先走无 cookie 直采;分享页返回"蜘蛛壳"(风控)时,自动回退到 yt-dlp + 本机浏览器登录态——只需浏览器里打开过一次 douyin.com,无需登录。完整流程说明见 douyin-transcribe/SKILL.md。
TikTok 视频转录:短链自动跳转,中英混杂自动检测语言
cd tiktok-transcribe
python scripts/transcribe.py "https://vm.tiktok.com/xxxxx" -o ./output
TikTok 有地区限制,脚本默认加 --geo-bypass;短链(vm / vt 开头)由 yt-dlp 自动跟随跳转。内容中英混杂时会用 language=auto 自动检测,见 tiktok-transcribe/SKILL.md。
微博视频转录:优先用移动端链接
cd weibo-transcribe
python scripts/transcribe.py "https://m.weibo.cn/xxxxx"
微博对桌面端 UA 拦截较严,脚本已内置移动端 UA + Referer 伪装;m.weibo.cn 移动端链接成功率明显高于 weibo.com 桌面链接,复制分享时优先拿移动端链接,详见 weibo-transcribe/SKILL.md。
知乎视频转录:三种链接形态都能解析
cd zhihu-transcribe
python scripts/transcribe.py "https://www.zhihu.com/video/1234567890"
除了独立视频页,问答页内嵌视频(/question/xxx/answer/yyy)和专栏文章(zhuanlan.zhihu.com/p/xxx)都支持,脚本会自动提取视频 ID。知乎有限流,建议单个链接处理间隔不少于 3 秒,详见 zhihu-transcribe/SKILL.md。
批量处理:链接入队,统一跑
视频多时不用一条一条敲命令:把链接逐行放进 inbox/links.txt,再用统一 CLI 处理并查看失败项:
python3 tools/chubby.py run --queue inbox/links.txt --no-enrich
python3 tools/chubby.py status --failed
python3 tools/chubby.py retry --all-failed
CLI 入口 tools/chubby.py 会自动识别链接所属平台并路由到对应技能,采集入库后还能用 search 关键词搜回文字稿。
常见失败模式与快速排查
平台采集失败通常不是 bug,而是链接、风控或依赖问题。chubbyskills 把失败分成了 5 类,对照下表自查即可,完整说明见 docs/platform-fallbacks.md:
| 失败类型 | 典型原因 | 第一动作 |
|---|---|---|
missing_dependency |
缺 ffmpeg / yt-dlp / funasr |
重跑 bash setup.sh video,再用 check_env.py 确认 |
expired_or_invalid_source |
抖音短链过期、内容被删 | 重新复制原始链接 |
anti_bot_or_rate_limit |
触发风控、验证码、429 | 稍后重试,或浏览器打开过平台页面后走 cookie 回退 |
auth_or_cookie |
需要登录态(如私密内容) | 配置自己的 YTDLP_COOKIES_FROM_BROWSER(如 chrome) |
network |
DNS / 超时 | 先确认浏览器能打开该视频,再重试 |
两个实用技巧:
- 万能兜底:任何平台下载失败,都可以先在浏览器里把视频保存到本地,再让工具转录本地文件——这条 fallback 路径在 docs/platform-status.md 的 Fallback Matrix 中逐平台列明。
- yt-dlp 报错 403 / needs to be reloaded:多半是版本落后于平台改版,先
python3 -m pip install -U yt-dlp升级再排查其他。
产物长什么样:可检索的 Markdown 文字稿
每个视频产出一份带 frontmatter 的 Markdown,自动记录标题、平台、来源链接、作者、语言、转录模型,正文是逐段文字稿。看一份真实的 TikTok 样例即可预期效果:examples/outputs/tiktok-sample.md。
转录性能参考(CPU 实测,来自 douyin-transcribe/SKILL.md):10 分钟视频总耗时约 1 分钟,1 小时 22 分约 4 分钟——首次运行多出的时间主要是加载模型,属正常现象。
收尾提醒
- 转录产物建议放进自己的知识库目录(可用
python3 tools/chubb.py init --vault ./creator-vault初始化),后续搜索、导出资料包都围绕它展开。 - 采集类技能仅限个人学习与研究使用,请遵守来源平台条款,控制请求频率,不要用于批量抓取或商用爬取。
- 想继续深入:环境分档说明见 docs/installation.md,逐平台真实验证记录见 docs/live-verification.md。
按这份清单走完 5 步、体检全绿,你的本地转录环境就搭好了——四条命令,四个平台的视频文字稿即刻到手。