前言¶
DeepSeek Harness（DSH）的 Web 客戶端在側欄、對話頁頂部和瀏覽器標籤頁會展示默認品牌標識。若你在內網部署、做演示環境，或希望界面與自有產品名稱一致，改源碼再重新構建前端成本高，也不便於多人共用同一套配置。
下面介紹社區插件 dsh-plugin-brand-custom：在運行時替換側欄與對話區的品牌位，並通過插件詳情頁上的設置卡片在線修改名稱與圖標，保存後無需重新構建、無需刷新頁面即可生效。
這是什麼¶
dsh-plugin-brand-custom 由維護者 lzpway-jpg 發佈，在 SkillHub 社區目錄中歸類爲「趣味換裝」。插件面向 DSH Web 客戶端（web profile），用自定義圖標和名稱佔用官方 UI 中的品牌插槽，並同步替換瀏覽器 favicon。
項目採用 MIT 許可證，當前 package 版本爲 0.1.0。主機需 dsh 0.1.7 或更新版本（該版本起主機才通過 Config schema 爲插件提供 settings 能力；package.json 中 engines.dsh 亦聲明瞭兼容的 dsh 版本區間）。
核心功能¶
經 README 說明，插件主要做以下幾件事：
- 佔用品牌插槽：向
sidebar.brand.mark、sidebar.brand.name、conversation.hero.brand.mark注入自定義圖標與名稱，並將瀏覽器 favicon 換爲同一圖標。 - 設置卡片：在 Plugins → dsh-plugin-brand-custom（點擊卡片標題進入詳情頁）提供設置界面——編輯品牌名稱、選擇圖標文件（PNG / JPEG / WebP / GIF / SVG，單文件上限 256KB，支持就地預覽），保存或放棄更改；Reset 恢復插件內置默認資源。
- 即時更新：保存後側欄、對話區 hero 與 favicon 立即更新，無需 reload。
- 持久化：配置寫入當前 profile 的 settings 文檔，換瀏覽器或重啓 dsh 後仍保持一致。
- 與官方品牌互斥：禁用僅在
official構建中註冊的ui-brand-official佔用者；單一品牌插槽同一時刻只應有一個佔用方。 - 默認資源：內置默認圖標來自
src/client/assets/icon.png，由 tsdown 構建時內聯爲 base64 data URL。
安裝與啓用¶
在已安裝且版本滿足要求的 dsh 環境中，對 web profile 執行：
dsh plugin --profile web add dsh-plugin-brand-custom
也可在 dsh-market 插件市場的 GUI 中搜索 brand-custom 一鍵安裝。
安裝後重啓 dsh web，打開 Plugins → dsh-plugin-brand-custom，進入設置卡片進行配置。
卸載命令：
dsh plugin --profile web remove dsh-plugin-brand-custom
典型用法¶
經過上面的安裝與重啓，可按下面步驟完成一次品牌替換：
- 在 Web UI 打開插件管理，進入
dsh-plugin-brand-custom詳情頁。 - 在設置卡片中填寫品牌名稱，通過圖標選擇器上傳符合格式與大小限制的圖標並確認預覽。
- 點擊保存；檢查側欄品牌區、對話頁 hero 品牌位以及瀏覽器標籤頁圖標是否已更新。
- 若需恢復插件自帶默認，使用 Reset。
無需修改倉庫源碼或執行前端 rebuild；變更僅依賴插件 settings 與運行時插槽機制。
適用場景與注意¶
適合誰：需要在 DSH Web 界面統一展示自定義名稱與 Logo 的部署者、演示環境維護者，以及希望輕量「白標」外觀、又不想 fork 前端的同學。
生態說明：DSH 採用「一切皆插件」的擴展方式；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文安裝命令與能力描述以插件倉庫 README 爲準。
安全與權限：插件與當前 dsh 進程同權限運行。安裝前建議在 GitHub 查閱源碼與 MIT 許可證，確認圖標上傳與 settings 存儲方式符合你的合規要求。上傳圖標時注意 256KB 與格式限制，避免誤傳過大或非支持格式文件。
開發構建（可選）：若需從源碼打包，維護者在 README 中給出：
npm install --legacy-peer-deps
npm run bundle
產物 lib/client.js 爲 closure-factory bundle，React、Cordis、ui-slots、ui-primitives 等由宿主 shell 在運行時提供；運行時 peer 依賴 @deepseek-ai/schemastery 由 host profile 供給。
結尾¶
dsh-plugin-brand-custom 把側欄、對話 hero 與 favicon 的品牌展示集中到一個可在線編輯的設置卡片裏，適合在 DSH Web 部署中快速換成自有標識。更多信息見社區目錄頁 skillhub.cn/plugins/lzpway-jpg/dsh-plugin-brand-custom 與源碼倉庫 github.com/lzpway-jpg/dsh-plugin-brand-custom。
