DeepSeek Harness 通用 UI 個性化設置插件 (dsh-customization-settings)

DeepSeek Harness (DSH) 採用模塊化架構，允許通過插件擴展功能。UI 個性化是提升使用體驗的重要一環。dsh-customization-settings 插件旨在爲 DSH 提供通用的 UI 個性化設置入口。它通過擴展設置面板的結構，爲後續接入壁紙、主題色等具體功能做準備。

插件概況¶

名稱：dsh-customization-settings
作者：T-MKT
許可證：MIT
功能定位：通用 UI 個性化設置

核心功能¶

該插件目前主要完成基礎框架的搭建：

新增“外觀”大類：在 DSH 的“設置”面板左側新增“外觀”分類，圖標與“通用設置”保持一致。
集成設置組件：引入 @deepseek-ai/dsh-client-ui-settings，作爲後續功能開發的底層組件。
規劃功能：計劃支持壁紙、主題色、字體與排版、模糊材質等個性化選項。

安裝與啓用¶

由於插件尚未發佈到 npm，安裝過程需要從本地倉庫進行。

前置條件¶

Node.js 版本要求：>=22.19.0
已安裝 DeepSeek Harness 並配置好 Web Profile

步驟 1：本地安裝¶

將插件倉庫添加到 Web Profile 的 node_modules 目錄中：

dsh plugin --profile web add <repo-path>

步驟 2：啓用插件¶

啓用方式有兩種，選擇其一即可：

方式 A：追加至組合包列表（推薦）

編輯 Web Profile 的 package.json，找到 "dsh": { "profile": { "bundles": [...] } } 字段，將 "dsh-customization-settings" 追加到數組中。

"dsh": {
  "profile": {
    "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-customization-settings"]
  }
}

方式 B：合併 Patch 文件

將插件倉庫根目錄下的 cordis.patch.yml 文件中的 insert 段直接合併到 Web Profile 的 cordis.patch.yml 文件中。

步驟 3：重啓服務¶

執行上述配置修改後，重啓 DSH Web 服務使配置生效：

dsh web

開發與依賴¶

該插件依賴 DSH 客戶端的相關 UI 組件包：

@deepseek-ai/cordis
@deepseek-ai/dsh-client-ui-settings
@deepseek-ai/dsh-client-ui-slots

本地開發時，可使用以下命令進行依賴安裝、構建和類型檢查：

pnpm install   # 安裝依賴
pnpm build     # 產出 lib/index.js 與 lib/client.js
pnpm typecheck # 僅進行類型檢查

注意事項¶

開發狀態：插件處於開發階段，尚未發佈到 npm，目前“外觀”大類下的條目區暫爲空，具體功能待後續迭代。
維護情況：作者目前爲高二在讀學生，不常查看 issues 和 PRs，如有嚴重問題建議通過郵件聯繫。
安全建議：由於插件爲社區維護且未經過官方大規模審覈，安裝前請務必檢查源碼與許可證。