前言¶
在 DeepSeek Harness(DSH)裏做 B 站相關任務,常見做法是分別裝搜索/評論類插件,再另找一套工具去拉流、切幀、看結構。對話裏要在兩套能力之間來回切換,配置也不在一個頁面裏。dsh-bili-video 把 B 站交互與視頻分鏡合併進同一個插件包,維護者 13520rygvv 標明是個人自用、順手分享,基於兩個 MIT 上游項目合併改造,不是產品路線,也不承諾在所有 DSH 版本上行爲完全一致。
這是什麼¶
dsh-bili-video 是 DSH 社區目錄中的聯網工具類插件(目錄頁:https://www.skillhub.cn/plugins/13520rygvv/dsh-bili-video)。當前發佈版本爲 0.9.0,許可證 MIT,倉庫:https://github.com/13520rygvv/dsh-bili-video。
一句話定位:搜視頻、讀字幕與評論、發評論/三連/私信、掃碼登錄,以及把一條視頻(鏈接或 BV 號)做成帶編號的宮格分鏡、時間碼清單和音頻波形條;需要細節時用放大工具在原流裏重掃。
核心功能¶
下面按 README 中的工具表說明,只列資料裏已寫明的名稱與用途。
B 站交互(「讀嘴」)¶
| 工具 | 作用 |
|---|---|
bili_search |
關鍵詞搜索,可選排序與時間窗,返回 BV 號、播放量、簡介等 |
bili_subtitle |
讀取字幕原文;無字幕時會說明 |
bili_comments |
翻評論區(含樓中樓),按贊數排序 |
bili_reply |
發評論,可 @ 用戶 |
bili_triple |
三連:點贊、投幣、收藏 |
bili_send_message |
發私信 |
bili_whoami |
當前登錄身份與憑證是否有效 |
bili_status |
當日刷輪次、下次時間、環境是否就緒 |
bili_login_start / bili_login_poll |
掃碼登錄:生成二維碼後輪詢結果 |
bili_setup |
安裝主依賴或修復環境 |
bili_config |
讀寫配置(與設置頁等價,可批量修改) |
視頻分鏡(「看眼」)¶
| 工具 | 作用 |
|---|---|
video_probe |
只讀容器頭:時長、分辨率、字幕軌、可用檔位;不消耗圖片 token |
video_storyboard |
切點檢測 + 編號宮格 + 時間碼清單 + 音頻條(切點、靜音、鏡頭數) |
video_zoom |
在指定時間窗內重掃,取更細幀 |
video_locate |
用一句話描述找回片內大致時間碼 |
video_watch |
按「看點」模式跑組合流程 |
資料中強調的幾點行爲:
- BV 號可直接作爲輸入,例如
video_storyboard({ input: "BV1TDC6YVEK7" }),插件會補全鏈接。 - 默認用較低清晰度掃結構;登錄 B 站後可拿更高檔位流(大會員專屬檔位另算)。
- 優先使用站點 CC 字幕;沒有 CC 時才走 ASR,需單獨配置 key。
- 宮格來自低碼率掃描副本;看細節應使用
video_zoom從原流取幀。
安裝與啓用¶
環境要求¶
- Python 3.10+(或
uv)和ffmpeg:Python 供 B 站半邊使用;無ffmpeg時「看視頻」半邊不可用,B 站半邊仍可用。 - DSH 版本:
dsh >= 0.1.7-rc.1(package.json的engines.dsh);版本過舊時設置裏可能看不到「看視頻」,內核會靜默跳過插件。 - Node:
>=22(同上engines)。 - 可選:
yt-dlp(直接喫 B 站鏈接/BV 時需裝);ASR 僅在無 CC 字幕時使用,配置見下文。
安裝步驟¶
先在 DSH 中:設置 → 插件 → 安裝,填寫倉庫標識;或使用命令行(資料原文):
github:13520rygvv/dsh-bili-video
dsh plugin --profile desktop add github:13520rygvv/dsh-bili-video
裝完後重啓一次 DSH(插件在 bundle 層組裝,不重啓不生效)。進入 設置 → 看視頻,用 B 站賬號掃碼登錄。
README 還提到:把倉庫鏈接發給本機 DSH,說明「幫我裝這個插件」,也可走同樣安裝路徑。
設置頁概覽¶
設置 → 看視頻 共 5 個頁籤:看視頻、B 站、自動刷、提示詞、環境與高級。其中「看視頻」頁的 7 個字段對下一次工具調用立即生效(無需重啓):
| 配置 | 含義 |
|---|---|
videoCells |
一張圖幾格(0 = 自動) |
videoSheets |
出幾張圖(0 = 自動) |
videoDetail |
每格文字量:low / med / high |
videoScanHeight |
掃描檔:240 / 360 / 480 / 720 |
videoZoomHeight |
放大檔:720 / 1080 / 1440 / 2160 |
videoTranscript |
auto(無字幕才聽寫)/ off |
videoAsrLang |
空則跟 asr.json,或 auto / zh / en / ja |
無 CC 字幕且啓用聽寫時,在 ~/.dsh/asr.json 配置 ASR(改完即時生效):
{
"baseUrl": "https://api.siliconflow.cn/v1",
"key": "sk-...",
"model": "FunAudioLLM/SenseVoiceSmall",
"language": "auto"
}
資料建議 language 用 auto;SenseVoice 對動漫臺詞準確率一般,引用臺詞前宜與畫面硬字幕覈對。
更新¶
dsh plugin --profile desktop remove dsh-bili-video
dsh plugin --profile desktop add github:13520rygvv/dsh-bili-video
設置頁「環境與高級 → 檢查更新」也會提示是否有新提交。
典型用法¶
在智能體對話中直接調用上述工具名即可;分鏡側最簡示例來自 README:
video_storyboard({ input: "BV1TDC6YVEK7" })
需要先了解片長與軌道而不出圖時,可先 video_probe;定位某句描述再用 video_locate;對某一時間段要更密幀率時用 video_zoom。
B 站側典型順序:無登錄態時用 bili_login_start + bili_login_poll;用 bili_whoami 確認憑證;搜片用 bili_search,讀稿用 bili_subtitle,互動前看清 README 中的使用提醒(勿刷量、勿高頻打擾)。
適用場景與注意¶
適合誰:已在用 DSH、需要在同一進程裏完成 B 站信息獲取/輕量互動,並對本地視頻或 B 站鏈接做結構化解構(分鏡、時間碼)的開發者或個人用戶。
來源與邊界:倉庫合併自 Yuuyuko-uu/dsh-bili-subagent(上游含 c1overzz/dsh-bili-scroll)與 SAOS-3624/dsh-video-storyboard,改動包括包名 dsh-bili-video、掛入 storyboard vendor、BV 直喂、登錄態 cookies、ASR 兜底與設置頁等;細節見倉庫 NOTICE。
權限與安全:插件以當前 DSH 進程權限運行,會代你訪問 B 站接口並可能寫評論、私信、三連。安裝前應自行閱讀源碼與 MIT 許可證;賬號限流或封禁由使用者承擔。社區目錄 skillhub.cn 爲獨立站點,與 DeepSeek / 幻方無官方從屬關係。
常見問題(摘自 README):重啓後 web 啓動失敗且報 import failed 時,檢查 client.js 裏 load({ id: ... }) 是否與 package.json 的 name 一致;看視頻提示無字幕且 transcript: no-key 表示 ASR 未配;B 站鏈接下載失敗時安裝 yt-dlp 並確認插件 venv 內可用。
結尾¶
dsh-bili-video 把 B 站「讀嘴」與視頻「看眼」收進一個 DSH 插件,適合不想維護兩套工具鏈、又接受「個人維護、無 roadmap」前提的用戶。目錄頁:https://www.skillhub.cn/plugins/13520rygvv/dsh-bili-video;源碼與完整工具表:https://github.com/13520rygvv/dsh-bili-video 。