用 dsh-plugin-background 給 DeepSeek Harness 網頁界面換上分區壁紙

前言

DeepSeek Harness(dsh)把模型、工具、會話和 UI 都做成插件,核心理念是「一切皆插件」。網頁界面開起來之後,對話區、軌跡區、側邊欄、設置頁整天對着看,界面皮膚可以換,但各塊工作區的背景往往還是同一套底色。

如果你用過 VS Code 的 shalldie.background 擴展,會知道編輯器、側邊欄、面板可以各自貼圖。dsh-plugin-background 做的就是類似的事:給 DeepSeek Harness 的 Web GUI 按區域畫背景,圖片可以輪播,視頻可以靜音循環。它由 gameswu 維護,MIT 許可,社區目錄歸在「主題與外觀」。截至 2026 年 8 月 18 日查閱,GitHub 倉庫約 10 星,當前版本是 0.2.1

需要先說清楚:DeepSeek Harness 本身是 DeepSeek AI 開源的智能體運行時,目前仍是 developer preview,接口可能不兼容地變動。下面用到的安裝命令來自社區站點 DeepSeek Harness 插件目錄,該目錄是獨立索引,和 DeepSeek / 幻方沒有官方從屬關係,不要把它當成官方應用商店。

這是什麼

一句話定位:dsh-plugin-background 是跑在 Web 界面 上的背景插件,爲對話區、軌跡區、側邊欄、設置頁分別設置獨立壁紙,並在「設置 → 插件」裏掛一張自己的配置卡片。

倉庫地址是 gameswu/dsh-plugin-backgroundpackage.json 裏聲明瞭 dsh.bundle(補丁文件 cordis.patch.yml)和 dsh.client.platform: web,也就是說它是一個自帶補丁層的組合包,只面向網頁客戶端,不會給 headless 或純終端會話畫壁紙。

它要解決的問題很具體:默認 Web UI 沒有按區域換壁紙的入口;裝上之後,不必手改 CSS,也不必去改 Harness 源碼。配置存在瀏覽器裏(localStoragedsh.background,本地文件進 IndexedDB),不寫進 profile 的 YAML。

核心功能

倉庫 README 和源碼(src/constants.tssrc/types.tssrc/locales.ts)對得上的能力如下。

1、四個內置區域各自一套背景:對話區、軌跡區、側邊欄、設置頁。每個區域可以開關、可以有自己的圖片組或視頻組。默認全部關閉,要你自己加素材纔會畫上去。

2、一組裏只允許一種媒體。圖片組按間隔輪播,像幻燈片;視頻組用靜音 <video> 循環播放。圖片和視頻不能混在同一組,混進去的條目會被跳過。GIF 按圖片處理,瀏覽器會自己播動畫。視頻擴展名識別 mp4webmmovm4vogv

3、素材來源三種:粘貼 URL(逗號、分號或換行分隔)、選擇本地圖片/視頻、選擇整個文件夾。本地文件以 Blob 存進 IndexedDB,不轉成 base64,刷新頁面後仍在。

4、每張圖可以單獨調顯示模式:填充(cover)、適應(contain)、拉伸、平鋪、居中、自定義。自定義模式下還能改位置、縮放、寬高、重複方式、旋轉和圓角。不透明度和模糊也是按張設置的,默認不透明度 0.9。視頻不能平鋪。

5、輪播間隔默認 15 秒,間隔設成 0 等於暫停。可以順序播或隨機播,也可以手動切下一張。切換前會預加載,並用交叉淡入,避免閃成空白。

6、表面列表裏勾選多個區域再添加,同一批圖可以一次落到多個區域。把一行拖到另一行上,兩個區域會合成爲一張跨區域大圖(多顯示器壁紙那種效果);拖出去或點拆分,就恢復成各自獨立。

7、兼容同一作者的 dsh-plugin-vscode-sidebar。裝了那個側欄之後,右側面板整體、下側面板整體,以及其中每個標籤頁,都會變成可獨立貼背景的表面。

安裝與啓用

社區目錄頁給出的安裝命令如下,在 DeepSeek Harness 終端裏運行即可:

dsh plugin add github:gameswu/dsh-plugin-background

這是目錄頁原文,不要自己按倉庫名再拼一遍。插件以當前 dsh 進程的權限運行,安裝時可能執行代碼。安裝前請看源代碼倉庫和許可證;需要可復現安裝時,固定 commit 哈希。

README 寫得更完整:這個包會把參數轉發給對應 profile 的 pnpm,並自動掛進 dsh.profile.bundles,不用手改配置。面向網頁界面時,建議顯式指定 web profile,並把 commit 釘死。2026 年 8 月 17 日 main 上覈實到的最新提交是 8660d41a4fb5cb320088b36b4109d055f598e077(版本 0.2.1,適配 dsh 0.1.0-rc.7 的插件配置卡片註冊),可以這樣裝:

dsh plugin --profile web add github:gameswu/dsh-plugin-background#8660d41a4fb5cb320088b36b4109d055f598e077

從本地倉庫安裝時,把路徑換成你 clone 下來的目錄:

dsh plugin --profile web add <路徑>

從 GitHub 安裝時,pnpm 會在安裝後跑這個包的 prepare 腳本,構建 lib/client.js。pnpm 10 及以上默認拒絕執行構建腳本,第一次 add 往往會失敗,並提示把包名寫進該 profile 的 pnpm-workspace.yaml 後再試:

allowBuilds:
  dsh-plugin-background: true

授權構建意味着安裝時會在你的機器上執行這個包的構建腳本,只對你信任的來源授權。官方 CLI 文檔對 Git 託管插件也是同一套說明。

裝完之後重啓 Web 界面:

dsh web

本地用路徑安裝、已經有構建產物時,重新 pnpm build 之後在瀏覽器裏硬刷新(Ctrl+Shift+R)即可,不必每次重啓服務。

典型用法

打開 設置 → 插件 → 背景,卡片名稱就是「背景」。操作順序按 README:

1、在表面列表裏點要配置的區域。勾選多行,可以一次加到多個區域。

2、在輸入框裏粘貼圖片或視頻鏈接,或點「選擇圖片」「選擇視頻」「選擇文件夾」。

3、點縮略圖進入編輯器,改顯示模式、不透明度、模糊,以及自定義模式下的位置、縮放等參數。區域上可以設輪播間隔、順序/隨機,也可以點「下一張」。

4、把一個區域行拖到另一個區域行上,合併成跨區域大圖;拖出或點拆分則取消合併。

配置存在當前瀏覽器裏。換瀏覽器、清站點數據,或換一臺機器,壁紙不會跟着 profile 走。瀏覽器存儲寫滿時,界面會提示已應用但未保存,需要刪掉一部分圖再試。

適用場景與注意事項

適合誰:主要在 dsh web 裏幹活、希望對話區和軌跡區背景分開、或者想像 VS Code 那樣給工作區貼圖的人。已經在用 dsh-plugin-vscode-sidebar 的,可以順便給右側/下側面板和各個標籤頁分別貼圖。只跑 headless 或不打開網頁界面的,這個插件沒有用處。

使用前還有幾條邊界,寫進文章裏是爲了避免裝完找不到效果:

1、只作用於 Web GUI。package.jsondsh.client.platformweb

2、一組背景不能圖和視頻混用;視頻默認靜音,不會出聲。

3、DeepSeek Harness 仍在 developer preview。這個插件 0.2.1 的提交說明就是:rc.7 按 settings 命名空間分發插件卡片,服務端必須註冊 background 這個空 schema,卡片纔會出現。升級 dsh 之後如果設置頁看不到「背景」,先覈對倉庫是否已跟進。

4、插件以當前 dsh 進程權限運行,GitHub 安裝還會跑 prepare 構建。安裝前檢查源碼和 MIT 許可證,能固定 commit 就固定。

小結

dsh-plugin-background 把 VS Code 分區壁紙那套做法搬到了 DeepSeek Harness 網頁界面:四個內置區域獨立貼圖或靜音視頻,本地文件進 IndexedDB,設置頁裏直接編輯,還可以把兩塊區域合成一張跨區大圖。它是 gameswu 維護的社區 MIT 項目,不是 DeepSeek 官方皮膚。

目錄頁:https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-plugin-background/

GitHub:https://github.com/gameswu/dsh-plugin-background

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

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

小夜