前言¶
DeepSeek Harness（DSH）的 Web GUI 默認是純色或主題背景。若你長時間在 Harness 裏寫代碼、調 Agent，又習慣開着 B 站直播或某個視頻當「環境音 + 畫面」，通常要在瀏覽器另開標籤頁，聊天窗口和畫面分屏，佔用注意力。
dsh-bili-wallpaper 是社區插件，由 st21a1 維護，分類爲「趣味換裝」。它把 B 站直播間實時畫面 或 任意視頻 鋪在聊天界面背後，並在 設置 → B站背景 裏完成來源、清晰度、模糊與遮罩等調節。運行時依賴已隨 npm 包 vendor，不會再拉任何 npm 包。
這是什麼¶
一句話：DeepSeek Harness 插件，在 desktop / web profile 下，用掃碼登錄你自己的 B 站賬號，粘貼直播或視頻地址，選清晰度，讓畫面在 Web GUI 背後播放，並支持模糊、壓暗遮罩、面板半透明等調節。
- 目錄頁：skillhub.cn/plugins/st21a1/dsh-bili-wallpaper
- 源碼與文檔：github.com/st21a1/dsh-bili-wallpaper
- 當前 npm 版本（資料）：
0.3.0，許可證 MIT
插件聲明硬依賴 webServer；tui / headless 沒有 Web GUI，裝了也不會有畫面。
核心功能¶
下面按 README 已列能力歸納，不展開未在資料中出現的行爲。
| 能力 | 說明 |
|---|---|
| 直播背景 | 直播間鏈接或房號（如 https://live.bilibili.com/6 或 6），實時畫面在聊天背後 |
| 視頻背景 | 視頻鏈接、BV 號或 av 號；支持分 P |
| 掃碼登錄 | 設置頁內二維碼，手機 B 站掃一掃；登錄後直播可選「原畫」 |
| 清晰度 | 「自動」取當前能拿到的最好一檔；也可手動指定原畫 / 藍光 / 超清等 |
| 畫面調節 | 鋪滿 / 完整、背景模糊、壓暗遮罩、面板不透明度、靜音 / 音量 / 播放速度 |
| 省電 | 切到後臺自動暫停（可關） |
| 半透明 UI | 面板、側欄、氣泡變爲可透出背景的玻璃面，文字仍可讀 |
| 開播自愈 | 直播地址過期或下播後重開，會自動重新解析 |
| 視頻播完 | 下一 P（默認）/ 循環 / 停最後一幀 / 關閉背景 |
| 分 P 與進度 | 多 P 切換；視頻可拖進度條；同一視頻同一 P 可記住上次進度 |
Host 端必須做媒體代理：B 站 CDN 不帶正確 Referer 會 403；HLS 清單需改寫；代理 URL 帶進程內 HMAC 簽名。網絡僅訪問 B 站 API、登錄域與 CDN；憑證存 $DSH_HOME/bili-wallpaper/，不上傳第三方，無遙測。
安裝與啓用¶
推薦從 npm 安裝（Web 版 Harness）：
dsh plugin --profile web add dsh-bili-wallpaper
桌面版把 --profile web 換成 --profile desktop。包地址：npmjs.com/package/dsh-bili-wallpaper。
README 還給出從 GitHub 安裝的方式：
dsh plugin --profile web add github:st21a1/dsh-bili-wallpaper
裝完後按官方步驟：
- 重啓 Harness（Host 半端
index.js需重啓才加載） - 打開 設置 → B站背景
- 粘貼直播或視頻地址，點「使用這個來源」
- 需要原畫時點「掃碼登錄」
只改 client.js 對應源碼時，刷新頁面即可（client HMR），不必重啓 Host。
卸載示例（資料爲 desktop profile）：
dsh plugin --profile desktop remove dsh-bili-wallpaper
配置與登錄憑證仍在 $DSH_HOME/bili-wallpaper/，卸載不會自動刪除。
典型用法¶
設置頁分五塊：開啓背景 / 來源 / 清晰度 / 畫面 / 賬號。
- 開啓背景後，在「來源」填入直播間 URL、房號，或視頻 URL、
BV/av（可分 P 選擇）。 - 「清晰度」選「自動」或手動檔位；未登錄時視頻一般最高 720P、直播一般「超清」，「原畫」需登錄。
- 「畫面」裏調模糊、遮罩、面板透明度、音量與播放速度；視頻可用進度條與分 P 切換。
- 遇瀏覽器攔截有聲自動播放時，插件會先靜音並在頁面提示，點一下即可恢復。
與 dsh-plugin-wallpaper-engine 功能重疊：兩個都開時會提示，建議只開一個。
適用場景與注意¶
適合誰：長期在 DSH Web GUI（dsh web 或 Desktop）裏工作，希望背景是自有 B 站賬號可訪問的直播或視頻，且願意在本地保存掃碼憑證的用戶。
環境與兼容（來自 README）：
| 項 | 要求 |
|---|---|
| DeepSeek Harness | ^0.2.0-rc.1（開發與驗證於 0.2.1-rc.3） |
| Node.js | >=22.12.0 |
| 瀏覽器 | 支持 MediaSource Extensions 的現代瀏覽器 |
已知限制（節選）：直播只走 HLS；僅 FLV 的直播間會明確報暫不支持。視頻走 durl（MP4），被切成多段的只播放第一段。直播無進度條。若出現 B 站風控碼 -351，README 建議按「退出登錄 → 重登 → 等待 / 換網」順序排查，而非反覆改地址。
安全與信任：插件以當前 DSH 進程權限運行，會讀寫 $DSH_HOME/bili-wallpaper/ 下的配置與憑證。安裝前請自行查看 GitHub 倉庫 源碼與 MIT 許可證。本插件與嗶哩嗶哩官方無關，僅供個人本地使用，須遵守 B 站用戶協議與相關法律法規。
社區目錄 SkillHub 獨立於 DeepSeek / 幻方，並非官方應用商店；DSH 生態理念是「一切皆插件」，是否安裝由你自行判斷。
結尾¶
dsh-bili-wallpaper 把 B 站直播與點播收進 Harness 同一窗口：掃碼登錄、選清晰度、調模糊與遮罩，聊天背後即是畫面。需要細節、更新日誌與 Issue，見 GitHub 倉庫 與 SkillHub 目錄頁。
