前言¶
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 宿主工具，實現了在智能體開發中自動調用視頻腳本的能力。
