前言¶
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-background。package.json 裏聲明瞭 dsh.bundle(補丁文件 cordis.patch.yml)和 dsh.client.platform: web,也就是說它是一個自帶補丁層的組合包,只面向網頁客戶端,不會給 headless 或純終端會話畫壁紙。
它要解決的問題很具體:默認 Web UI 沒有按區域換壁紙的入口;裝上之後,不必手改 CSS,也不必去改 Harness 源碼。配置存在瀏覽器裏(localStorage 鍵 dsh.background,本地文件進 IndexedDB),不寫進 profile 的 YAML。
核心功能¶
倉庫 README 和源碼(src/constants.ts、src/types.ts、src/locales.ts)對得上的能力如下。
1、四個內置區域各自一套背景:對話區、軌跡區、側邊欄、設置頁。每個區域可以開關、可以有自己的圖片組或視頻組。默認全部關閉,要你自己加素材纔會畫上去。
2、一組裏只允許一種媒體。圖片組按間隔輪播,像幻燈片;視頻組用靜音 <video> 循環播放。圖片和視頻不能混在同一組,混進去的條目會被跳過。GIF 按圖片處理,瀏覽器會自己播動畫。視頻擴展名識別 mp4、webm、mov、m4v、ogv。
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.json 裏 dsh.client.platform 是 web。
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