前言¶
本地跑 DeepSeek Harness(DSH)時,Web 客戶端側邊欄與會話頁標題往往顯示 Harness 自帶的「DSH 本地構建」與構建版本徽章,和你在 DeepSeek 官網產品上的視覺習慣不一致。改 Harness 源碼做主題成本高,也不利於跟上游同步。下面介紹社區插件 dsh-brand-deepseek:它通過 Harness 已公開的插槽系統替換側邊欄品牌與會話頁標題,不改 Harness 源碼,隨時可在設置裏關回默認外觀。
這是什麼¶
@linbin-mk/dsh-brand-deepseek(倉庫 linbin-mk/dsh-brand-deepseek)是由維護者 linbin-mk 發佈的純第三方、自包含 DSH 客戶端插件,分類爲「趣味換裝」。它只面向 Web profile,佔用 sidebar.brand.mark、sidebar.brand.name 與 conversation.hero.brand.mark 三個公開插槽,把側邊欄換成 DeepSeek 鯨魚標誌與 deepseek 字標,並可選改空白會話頁聊天框上方的標題行。
插件在 npm 上以 @linbin-mk/dsh-brand-deepseek 發佈(資料中當前版本 0.5.1)。社區目錄頁:SkillHub - dsh-brand-deepseek。
核心功能¶
側邊欄品牌¶
啓用後側邊欄顯示官方風格的鯨魚標誌與 deepseek 字標,默認填充官方 DeepSeek 藍(#4176e6)。設置頁提供 十種品牌顏色,選擇後立即生效並寫回 Host 配置,刷新後仍保留。
會話頁標題行¶
開啓「會話頁標題」後,空白會話頁聊天框上方標題行改爲「鯨魚標誌 + 想從哪裏開始?」,並隱藏 Harness 默認的「探索未至之境」與預覽版徽章;關閉後恢復官方默認標題。
品牌樣式設置頁¶
左下角 設置 → 品牌樣式 集中控制:
- 自定義樣式 —— 總開關。關閉後品牌插槽註銷,側邊欄回到
DSH 本地構建(或DSH Local Build)與構建版本徽章。 - 會話頁標題 —— 獨立開關標題行 DeepSeek 樣式(默認開啓)。
- 軌跡頁籤、更多操作按鈕 —— 獨立顯示或隱藏會話頁頭部這兩處 UI(默認均開啓);純 DOM 層操作,不影響軌跡數據與導出(「下載 Session 日誌」仍在「更多操作」菜單中)。
- 實時預覽 —— 預覽區隨開關與顏色變化;關閉自定義樣式時展示當前外殼回退品牌。
兼容性與清單展示¶
- 要求 Node.js
^22.19或>=24;DeepSeek Harness0.2.1-rc.2或兼容的0.2.1預發佈版本,且爲提供ctx.slots、ctx.configForms、ctx.locale的 Web profile。 package.json中engines.dsh = ^0.2.1-rc.2:Harness 插件兼容性預檢在不加載插件代碼的情況下讀取該字段,版本不符會給出明確提示。- 包內自帶
icon.svg與locale/en.json、locale/zh.json的meta.title/meta.description,插件管理器與 設置 → 插件 在未激活插件時也能顯示帶圖標的中英文名稱與說明。
安裝與啓用¶
把已發佈包安裝進自定義 Web profile。包內聲明瞭 dsh.bundle,因此 dsh plugin add 會自動補上 brand-deepseek 配置行。
先基於默認 Web profile 導出配置,再添加插件並啓動:
dsh --profile web-brand --from-default-profile web --dump-config
dsh plugin --profile web-brand add @linbin-mk/dsh-brand-deepseek
dsh --profile web-brand
從同一 profile 移除:
dsh plugin --profile web-brand remove @linbin-mk/dsh-brand-deepseek
若使用本地構建的 tarball(需自行在插件倉庫內 pnpm install、pnpm build、pnpm test、npm pack),安裝示例爲:
dsh plugin --profile web-brand add ./linbin-mk-dsh-brand-deepseek-0.5.1.tgz
典型用法¶
- 按上一節命令安裝並啓動
web-brandprofile,在瀏覽器打開 Harness Web 客戶端。 - 打開左下角 設置 → 品牌樣式,確認 自定義樣式 爲開啓(默認
enabled: true),側邊欄應顯示鯨魚與deepseek字標。 - 新建空白會話,確認標題行爲「想從哪裏開始?」;若不需要,關閉 會話頁標題 即可恢復官方標題。
- 在十種顏色中選一種品牌色;若需完全退回 Harness 默認品牌,關閉 自定義樣式 即可,無需卸載插件。
Host 側配置命名空間爲 Cordis loader 行 id brand-deepseek(與 npm 包名 @linbin-mk/dsh-brand-deepseek 故意不同,改包名不會使已有設置失效)。五個字段均爲可在運行時改寫的 volatile 配置:
| 設置 | 默認值 | 作用 |
|---|---|---|
enabled |
true |
自定義品牌樣式總開關 |
hero |
true |
空白會話頁標題行是否使用 DeepSeek 品牌標題 |
trajectoryTab |
true |
會話頁「軌跡」頁籤是否可見 |
sessionLogButton |
true |
會話頁「更多操作」按鈕是否可見 |
color |
#4176e6 |
品牌顏色(十選一) |
適用場景與注意¶
適合誰: 在本地或自建環境使用 DSH Web 客戶端、希望界面更接近 DeepSeek 官方品牌、又不想 fork Harness 的開發者或自用部署者。
權限與安全: 插件隨當前 DSH 進程與 Host 配置域運行;安裝前應閱讀 GitHub 倉庫 源碼與 LICENSE,確認許可證與行爲符合你的環境策略。本插件不修改 Harness 源碼,產物也不含指向 Harness checkout 的路徑依賴。
生態說明: DSH 採用「一切皆插件」思路;SkillHub 等社區目錄爲獨立站點,與 DeepSeek / 幻方無官方從屬關係,本文介紹的插件爲第三方維護(GitHub 星標數在資料抓取時爲 0)。
機制要點(便於排錯): 內置 @deepseek-ai/dsh-client-ui-brand-official 在 official 構建上以默認優先級佔用品牌插槽;本插件以 priority: -1 註冊,開啓自定義樣式時壓過內置佔位,關閉時註銷並交還內置佔位。客戶端 bundle 的 window.__ModuleLoader__.load 的 id 必須等於包名,否則 GUI 可能無法啓動。
結尾¶
dsh-brand-deepseek 用公開插槽與 Host 可持久化設置,把 DSH Web 客戶端的側邊欄與會話頁標題換成 DeepSeek 風格,並保留一鍵回退官方品牌的能力。需要細節、效果截圖與構建驗證說明時,以倉庫 README 爲準。