dsh-bili-video:在 DSH 裏同時「讀 B 站嘴」和「看視頻眼」

前言

在 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 從原流取幀。

安裝與啓用

環境要求

  1. Python 3.10+(或 uv)和 ffmpeg:Python 供 B 站半邊使用;無 ffmpeg 時「看視頻」半邊不可用,B 站半邊仍可用。
  2. DSH 版本:dsh >= 0.1.7-rc.1(package.json 的 engines.dsh);版本過舊時設置裏可能看不到「看視頻」,內核會靜默跳過插件。
  3. Node:>=22(同上 engines)。
  4. 可選: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 。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜