💰【付费】视频转文字链路验证与完整教程:ContextSearch + yt-dlp + CapsWriter Offline:视频转文字链路验证与完整教程
ContextSearch + yt-dlp + CapsWriter Offline:视频转文字链路验证与完整教程
本文对「浏览器 → yt-dlp 下载 → CapsWriter Offline 转写」这条经典链路做逐环节验证与补全,把每个环节的目的、关键配置、坑点讲透,并附上站内相关文章的跳转。相比原 18 号文章,本文补充了 AHK 方案(优于 Python)、yt-dlp 的 Cookie 新坑、CapsWriter 新版免配置等关键更新。
链路总览
ContextSearch(浏览器扩展,触发器,拿 URL)
↓
yt-dlp(命令行,下载器,抓音视频)
↓
CapsWriter Offline(离线转写引擎,音视频→文字)
三个工具各司其职,缺一不可。下面逐环节拆解。
环节一:ContextSearch 浏览器扩展(触发器)
目的:在浏览器里对视频链接/当前页面「右键」即可发起动作,把 URL 传给后面的脚本。
安装与配置:
在 Chrome / Edge 扩展商店安装 ContextSearch web-ext
打开它的设置 → 找到 Search Engines(搜索引擎)
新增一个引擎:
Name:
视频转文字(或Video2Text)URL Template:
http://127.0.0.1:5000/transcribe?url=%s%s会被扩展自动替换为你选中的链接或当前页 URL保存
关键点:%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。
唯一稳妥方案:浏览器扩展内部导出
安装官方推荐的 Get cookies.txt LOCALLY 扩展(开源,别用不明插件,有盗号风险)
打开目标视频页,让它正常播放几秒(跑完 JS 风控,拿到最新 Token)
点扩展图标 → Export,保存为
cookies.txt命令行使用:
yt-dlp --cookies cookies.txt "视频链接"
B 站特别注意:Cookie 经常变动,下载变慢/画质掉到 480p 就是 Cookie 过期,需重新导出。
详细踩坑记录见 【跑通版】yt-dlp 完全版。
环节三:CapsWriter Offline(离线转写引擎)
目的:本地、免费、无限次地把音频/视频转成文字,无需联网、无 Token 消耗。
3.1 两个版本怎么选
魔改版详细说明与模型结构见 【重大升级】CapsWriter-Offline 2.6 修改而来。
3.2 安装要点
直接下载完整压缩包解压即用(约 3.3G,含模型)
若走 GitHub 手动安装,需单独下载模型放入
models/文件夹(结构见上文引用文章)报错缺 DLL → 装 VC++ 运行库
3.3 ⚠️ 文件名避坑(高频翻车点)
文件名和路径尽量不要有空格、特殊符号(如 C:\*fd sa@?&¥.mp4)。转写失败时,先把文件改名、移动到干净路径(如 D:.mp4)再试。
环节四:把三个环节串起来(Glue Code)
目的:让「点一下右键 → 自动下载 → 自动转写」全自动。这是整套方案的灵魂。