前言¶
DeepSeek Harness (DSH) 允许通过插件扩展功能。dsh-bili-asr 是一个用于解析 B站 视频链接并提取文本的工具。它优先读取视频自带字幕；若视频无字幕，则调用本机 Whisper 模型进行语音转写，最终将结果以带时间戳的文本形式返回，并支持导出 SRT、TXT 或 JSON 文件。
功能特性¶
- 链接宽容解析：支持 BV 号、av 号、b23.tv 短链、完整链接及分享文本。
- 字幕轨优先：优先读取视频自带字幕（CC 字幕），无需额外依赖。
- 无字幕自动转写：无字幕时调用本地
whisper-cli进行语音转写，自动下载音频并处理。 - 带时间戳全文：返回格式为
[mm:ss] 文本的完整转写内容。 - 一键导出：支持导出 SRT、TXT、JSON 三种格式到指定目录。
- 跨平台：基于 Node.js 实现，兼容 Windows、macOS、Linux。
- 宿主工具注册：自动注册为
bili_script宿主工具，代理调用。
安装¶
使用 DSH 官方插件安装命令添加该插件：
dsh plugin add git+https://github.com/rudyz666/dsh-bili-asr.git
安装完成后，插件会随 DSH 进程启动自动加载。
使用示例¶
在 DSH 聊天中输入指令即可触发解析：
解析这个视频的脚本：BV1dL8K6HEm3
返回内容：
* 视频元数据：标题、UP主、时长、来源（字幕轨 / 本地转写）。
* 转写条数及带时间戳的完整文本。
* 导出文件路径。
依赖与配置¶
字幕视频：开箱即用，仅依赖网络请求。
无字幕视频：需要本机安装 whisper-cli 和 ffmpeg。
* Whisper 模型：首次使用会自动下载约 874MB 的 large-v3-turbo 模型。
* GPU 支持：GPU 不是必需的，CPU 也能正常转写；若检测到 GPU，会自动优先使用。
* 配置：通过 profile 的 cordis.patch.yml 进行配置：
- id: dsh-bili-asr
config:
baseDir: '/Users/you/.dsh/bili-asr' # 缓存与导出目录根
writeFiles: true # 是否写导出文件（默认 true）
生态与资源¶
该插件遵循 MIT 许可证，由社区开发者 rudyz666 维护。DSH 理念强调“一切皆插件”，此工具通过注册为 bili_script 宿主工具，实现了在智能体开发中自动调用视频脚本的能力。
