如何把抖音、TikTok、微博、知乎视频转成文字稿:chubbyskills 本地转录环境搭建清单

原创2026-10-13 22:34:491,620 阅读
文章标签:AI 技能知识管理MCP 服务语音人工智能RAG

如何把抖音、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 步、体检全绿,你的本地转录环境就搭好了——四条命令,四个平台的视频文字稿即刻到手。

登录后查看全文
chubbyskills