💰【付费】视频转文字链路验证与完整教程:ContextSearch + yt-dlp + CapsWriter Offline:视频转文字链路验证与完整教程

周店瑟谷 5 阅读 AI 工具与智能体

ContextSearch + yt-dlp + CapsWriter Offline:视频转文字链路验证与完整教程

本文对「浏览器 → yt-dlp 下载 → CapsWriter Offline 转写」这条经典链路做逐环节验证与补全,把每个环节的目的、关键配置、坑点讲透,并附上站内相关文章的跳转。相比原 18 号文章,本文补充了 AHK 方案(优于 Python)、yt-dlp 的 Cookie 新坑、CapsWriter 新版免配置等关键更新。

链路总览

ContextSearch(浏览器扩展,触发器,拿 URL)
        ↓
yt-dlp(命令行,下载器,抓音视频)
        ↓
CapsWriter Offline(离线转写引擎,音视频→文字)

三个工具各司其职,缺一不可。下面逐环节拆解。

环节一:ContextSearch 浏览器扩展(触发器)

目的:在浏览器里对视频链接/当前页面「右键」即可发起动作,把 URL 传给后面的脚本。

安装与配置:

  1. 在 Chrome / Edge 扩展商店安装 ContextSearch web-ext

  2. 打开它的设置 → 找到 Search Engines(搜索引擎)

  3. 新增一个引擎:

  4. Name:视频转文字(或 Video2Text)

  5. URL Template:http://127.0.0.1:5000/transcribe?url=%s

  6. %s 会被扩展自动替换为你选中的链接或当前页 URL

  7. 保存

关键点:%s 是占位符,链接是「从右键菜单选中」还是「当前页面 URL」,取决于你在扩展里的触发方式设置。

环节二:yt-dlp(下载器)

目的:把视频的音频/视频抓取到本地,供转写使用。

2.1 安装

  • 下载 yt-dlp.exe(yt-dlp Release)

  • 把 exe 所在文件夹加入系统环境变量 PATH,验证:CMD 输入 yt-dlp --version 能输出版本号即成功

2.2 转写场景的核心命令(只抓音频,最快)

yt-dlp -x --audio-format wav -o "D:\音频\%(title)s.%(ext)s" "视频链接"
  • -x:只提取音频(转文字不需要视频画面)

  • --audio-format wav:转成 wav,兼容性最好

  • -o:指定输出路径与文件名(强烈建议用绝对路径,见坑点)

2.3 完整视频下载场景(保留视频)

yt-dlp --merge-output-format mp4 --output "D:\视频下载\%(title)s.%(ext)s" "视频链接"

完整命令参数详解见 【跑通版】yt-dlp 完全版。

2.4 ⚠️ 重大坑点:Cookie 读取(2026 新变化)

目的:下载「会员专享 / 需登录 / 高清」视频时,需要浏览器登录态(Cookie)。

原版教程里推荐的 --cookies-from-browser chrome 参数,在最新版 Edge/Chrome 上已经「阵亡」——浏览器引入了「应用绑定加密(App-Bound Encryption)」,外部程序(含 yt-dlp)无法再解密 Cookie,会直接报 Failed to decrypt with DPAPI。

唯一稳妥方案:浏览器扩展内部导出

  1. 安装官方推荐的 Get cookies.txt LOCALLY 扩展(开源,别用不明插件,有盗号风险)

  2. 打开目标视频页,让它正常播放几秒(跑完 JS 风控,拿到最新 Token)

  3. 点扩展图标 → Export,保存为 cookies.txt

  4. 命令行使用:

yt-dlp --cookies cookies.txt "视频链接"

B 站特别注意:Cookie 经常变动,下载变慢/画质掉到 480p 就是 Cookie 过期,需重新导出。

详细踩坑记录见 【跑通版】yt-dlp 完全版。

环节三:CapsWriter Offline(离线转写引擎)

目的:本地、免费、无限次地把音频/视频转成文字,无需联网、无 Token 消耗。

3.1 两个版本怎么选

版本

特点

适用

原版 CapsWriter Offline

基于 FunASR,识别率高

经典稳定

axutongxue 魔改版(2.6 改)

内置 Qwen3-ASR + Fun-ASR-Nano 双模型、右键菜单一键用、托盘可切换导出格式(txt/SRT/json)

强烈推荐,免配置、更省心

魔改版详细说明与模型结构见 【重大升级】CapsWriter-Offline 2.6 修改而来。

3.2 安装要点

  • 直接下载完整压缩包解压即用(约 3.3G,含模型)

  • 若走 GitHub 手动安装,需单独下载模型放入 models/ 文件夹(结构见上文引用文章)

  • 报错缺 DLL → 装 VC++ 运行库

3.3 ⚠️ 文件名避坑(高频翻车点)

文件名和路径尽量不要有空格、特殊符号(如 C:\*fd sa@?&¥.mp4)。转写失败时,先把文件改名、移动到干净路径(如 D:.mp4)再试。

环节四:把三个环节串起来(Glue Code)

目的:让「点一下右键 → 自动下载 → 自动转写」全自动。这是整套方案的灵魂。

瑟谷智学 · 全站解锁弹窗
示例页:关闭弹窗后,右下角出现「解锁全站」入口可再次唤起|嵌入博客时删除本行提示

此处内容已隐藏,「密码可见」