前言¶

DeepSeek Harness 的插件生態允許用戶擴展功能。默認的界面風格固定，長期使用容易產生審美疲勞。dsh-bg-switcher 專注於解決背景更換的問題，允許用戶使用預設或自定義圖片，快速調整界面氛圍。

是什麼¶

這是一個用於 DeepSeek Harness 的插件，由 Bainianzzz 維護。它將側邊欄底部「設置」按鈕上方的區域改造爲「背景」入口。用戶可以選擇 6 個預設色卡，或輸入自定義圖片 URL，將背景鋪滿窗口並保存選擇。

核心功能¶

插件將入口註冊在 sidebar.footer.action 插槽。

由於按鈕展開時約 220px、收起時 56px，受限於側邊欄寬度，無法在原位置直接展開面板。因此，選擇面板是一個 position:fixed 的浮層，根據按鈕位置測量後貼在側邊欄右側，窗口縮放時會自動重新定位。

背景圖直接繪製在 html 標籤上。--dsw-alias-bg-base 經 ctx.theme.overrideTokens 置爲 transparent，底層透明後，通過遮罩層保持前景不透明。亮暗色各配一層遮罩，暗色由 html:has(body[data-ds-dark-theme]) 跟隨。

選擇保存在 localStorage（dsh.bg-switcher.selection）中，重裝或升級插件都不影響。

安裝與啓用¶

使用 plugin_manager 工具進行安裝：

安裝 DSH 插件 https://github.com/Bainianzzz/dsh-bg-switcher：
1. 克隆倉庫到 ~/dsh-plugins/dsh-bg-switcher；
2. plugin_manager 工具，action=install_bundle，target 填該目錄絕對路徑；
3. 確認 application 爲 applied，否則把 warnings 與 error 報給我；
4. cordis_inspect_query 查客戶端 sidebar.footer.action 插槽，確認出現 id 爲 bg-switcher 的條目。

安裝完成後，在側邊欄選中插件，點擊啓用。

典型用法¶

1. 在側邊欄底部找到「背景」按鈕（位於「設置」按鈕上方）。
2. 點擊按鈕，從 6 個預設色卡中選擇，或粘貼自定義圖片地址。
3. 窗口背景會立即鋪滿並記住選擇。

技術細節¶

• 渲染順序：外殼先渲染該槽位、再渲染 sidebar.settings，所以按鈕落在「設置」上方。
• 清理機制：樣式標籤與 token 層在 ctx.effect 裏創建並返回清理函數，停用即回到主題默認。
• 主題適配：亮暗色遮罩確保在不同主題下前景內容可讀。

參考資源¶

• 插件目錄：https://www.skillhub.cn/plugins/Bainianzzz/dsh-bg-switcher
• GitHub 倉庫：https://github.com/Bainianzzz/dsh-bg-switcher