前言¶
DSH（DeepSeek Harness）的界面主題和對話背景由原生客戶端控制。想要換一種配色或背景時，常見的做法是改 profile 配置或直接改樣式文件：前者容易被下一次配置寫入覆蓋，後者會影響佈局、字體和交互。zxbingoo/dsh-minimalist-appearance 把這件事做成一個插件：新增左側「外觀」入口，只覆蓋顏色與對話背景，不改變原有字體、字號、字重、行高、間距、控件尺寸、消息結構或交互。下面介紹這個插件的能力、安裝方式和使用要點。
這是什麼¶
dsh-minimalist-appearance 是 zxbingoo 維護的 DSH 持久化外觀插件，分類屬於「趣味換裝」。它解決的問題是：在不去動 DSH 原生排版和交互的前提下，切換配色與對話背景，並保證切換結果在重啓後保留。
插件在側欄新增「外觀」入口，把設置頁做成靜態外觀示意，並提供七種預置主題。當前版本爲 0.2.18，倉庫的 package.json 寫的是 "private": true，發行只通過 GitHub Release 發佈；npm 上的舊名 dsh-appearance 屬於另一個項目，不是本插件。
核心功能¶
插件只做繪製層面的覆蓋：
- 左側新增「外觀」入口，插件管理頁顯示爲「外觀(dsh-minimalist-appearance)」，側欄仍爲「外觀」。
- 七種主題：「淺色」「深色」「跟隨系統」「綠色」「海藍」「暖沙」「原始」。其中「綠色」原名「有風」，內部標識仍是
breeze/forest。 - 設置頁頂部是 2:1 大預覽，下方是「全部主題」緊湊縮略圖。常規寬度下五列，窄面板自動減爲三列或兩列；點擊主題後上方示意立即更新，並以一次原子寫入保存。
- 大預覽只是設置頁內的靜態示意，不是第二個真實會話，不能輸入或發送消息，佈局和裁切也不保證與原生對話一致。
- 縮略圖和示意共用真實背景的圖片、配色、fade 和 cover 繪製規則。「原始」主題同等對待，點擊即應用並移除插件的顏色與背景覆蓋。
- 只讀或離線狀態下點擊只改變本頁示意，不應用也保存，頁面顯示「僅預覽 · 未應用」。關閉或刷新頁面會清除未保存的內存選擇。
- 不提供自定義顏色、上傳、背景或淡化控件，舊版本保存的自定義值繼續可讀和生效，不做破壞性遷移。
配色覆蓋的邊界是明確的：完整對話框架的背景、正文與滾動層、輸入區座位的透明底色、文件變更卡片與附件按鈕的局部填充變量、共享彈出菜單的材質/圖標/分組標題顏色變量、品牌標牌的局部反色文字，以及 macOS 側欄的不透明底色。插件不修改佈局、字體和原生主題偏好。
安裝與啓用¶
插件通過 DSH 的原生插件管理器安裝，不是在普通終端執行命令：
{
"action": "install_bundle",
"target": "https://github.com/zxbingoo/dsh-minimalist-appearance/releases/download/v0.2.18/dsh-minimalist-appearance-0.2.18.tgz"
}
這條安裝命令來自 README 的「初版定版與安裝」一節，指向 v0.2.18 Release 的預構建 .tgz 包。安裝、啓用和卸載都通過 DSH 插件管理器完成，不手改 profile。本地目錄安裝是鏈接不是複製，替換已加載的 Host 代碼通常需要重啓 DSH。
需要注意發行身份：本倉庫保留髮行包名 dsh-minimalist-appearance、包名派生的瀏覽器 factory，以及原有 dsh-appearance / dsh_appearance 內部地址。不要在同一 profile 同時啓用舊開發包與本發行包；舊保存項裏可能包含舊包名斷言。需要替換時，先通過受支持的插件管理與設置流程備份並確認遷移。
典型用法¶
-
打開左側「外觀」。
-
在設置頁點擊「淺色、深色、跟隨系統、綠色、海藍、暖沙、原始」中的任一主題。上方示意立即更新，並以一次原子寫入應用及保存。保存中暫時禁止重複點擊，失敗時保留選擇，可再次點擊同一主題重試。
-
點擊「原始」同樣應用即生效：移除插件的顏色與背景覆蓋，但不改原生 DSH 的主題、字體或佈局偏好，也不刪除舊配置裏的休眠圖片。
-
如果設置在其他位置更新，未修改的選擇會同步；已有修改則保留並鎖定選擇，點擊提示中的「重新載入」會明確丟棄舊選擇後繼續。
插件設置由當前 profile 的會話共享，通過原生 settings 服務寫入，重啓後仍保留。禁用插件會移除配色覆蓋、背景樣式及訂閱，但保留保存的偏好；重新啓用即可恢復。
適用場景與注意¶
適合這些使用者：想給 DSH 換配色或對話背景，但又不希望佈局、字體、控件尺寸和消息結構發生變化的人；以及需要用 Agent 工具批量讀寫外觀配置、又不想在頁面上手工點擊的人。dsh_appearance 提供 get / set / reset 三種操作，與頁面共享 Host settings.mutate 操作及校驗，get 返回 revision，set 和 reset 可以附帶 expectedRevision 拒絕過期寫入。返回值只包含圖片 MIME 與字節數，不包含圖片正文。
運行時權限與邊界需要提前看清楚。插件以當前 DSH 進程的權限運行，安裝前應當檢查源碼與許可證（package.json 中標註爲 MIT）是否與自己的合規要求一致。README 明確寫了當前運行環境 DSH 0.2.1-rc.5 / 0.2.2-rc.1 的 Host/Client 加載與接口已覈對，但真實頁面視覺驗收仍受認證限制，不能把源碼測試當作全面的視覺驗收。升級 DSH 後若結構變化，需要重新覈對。通用 settings 編輯器可以暫存「上傳背景但未提供圖片」的不完整組合，專用頁面和 Agent 工具都會拒絕這樣的保存，Client 對不完整配置不應用任何視覺覆蓋並提供恢復入口。
已知限制方面，README 提到插件針對既有界面的 CSS 僅改繪製，並羅列了完整的對話框架、輸入座位、文件變更與交付文件卡、共享彈出菜單、品牌標牌和 macOS 側欄等接入點；這些接入點按 DSH 0.2.1-rc.5 的結構覈實。背景不請求外部圖片服務，舊背景以內聯 data URL 保存在 profile 設置中，選擇預設不會清除休眠圖片。內置 PNG 在構建時校驗簽名並限制爲 4 MiB，內聯進 Client，不寫入 profile 圖片字段，也不佔用用戶上傳圖片的 2 MiB 限額。
結尾¶
這個插件的價值在於範圍窄而明確：只改顏色和背景，不碰字體、佈局和交互，切換通過原生插件管理器和 settings 服務完成，改完重啓仍在。項目目錄頁在 https://www.skillhub.cn/plugins/zxbingoo/dsh-minimalist-appearance，源碼和 Release 在 https://github.com/zxbingoo/dsh-minimalist-appearance。
