前言¶

DSH 的插件生態強調「一切皆插件」；社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。對於需要在 DeepSeek Harness Web 中調整外觀、品牌詞、Logo 和新會話標題，而不想改 Harness 倉庫源碼的場景，dsh-yizi-themes 是一個可用的第三方插件。

它由 laoduu 維護，許可證爲 MIT。舊版 install.sh / install.ps1 / MANIFEST.json / patch/ 是早期“源碼覆蓋”方案遺留，已廢棄，僅保留作參考，請勿使用。

這是什麼¶

dsh-yizi-themes 是第三方 DeepSeek Harness 主題擴展，主題設計語言移植自 YiziMarkdown。它提供 19 個精品風格主題，每個主題同時支持亮色 / 深色兩套配色，並跟隨「淺色 / 深色 / 跟隨系統」設置。

它按標準 Cordis 插件安裝，通過 dsh plugin 安裝/卸載，不修改 Harness 倉庫任何源碼。

核心功能¶

主題與明暗¶

• 提供 19 個精品風格主題。
• 明暗模式與風格主題完全獨立，可自由組合。
• 可在會話頭部右上角切換主題 / 明暗；新會話（無對話）時，切換入口以浮動按鈕顯示。

自定義品牌¶

• Logo SVG、品牌字樣、徽章字樣、新會話標題可自定義。
• 品牌顏色自動跟隨主題與明暗。
• 品牌設置持久化在 $DSH_HOME/settings.yaml 的 ui-theme.customBrand 分節。

如果 SVG 中使用了硬編碼顏色，顏色不會自動跟隨主題。可改爲：

fill="var(--dsw-alias-brand-primary)"
fill="currentColor"

前者隨主題與明暗切換，後者繼承容器顏色。

品牌映射（實驗性）¶

• 默認關閉。
• 可替換界面 / 輸出中的 DeepSeek / 深度求索 / Harness 品牌詞。
• 開啓後不改寫輸入內容。

安裝與啓用¶

前置條件¶

需要一個能運行 pnpm dsh web 的 DeepSeek Harness 倉庫（含 profile）。

web 與桌面版是兩個獨立 profile，互不相通。桌面版（DSH Desktop App）使用 --profile desktop。

從 GitHub Release 安裝¶

下載 0.4.0 tgz：

curl -L -o dsh-yizi-themes-0.4.0.tgz https://github.com/laoduu/DeepSeek-Harness-yizi-themes/releases/download/v0.4.0/dsh-yizi-themes-0.4.0.tgz

然後在 Harness 倉庫目錄執行安裝：

pnpm dsh plugin --profile web add /path/to/dsh-yizi-themes-0.4.0.tgz

重新啓動 Web 端：

pnpm dsh web

如果是桌面版，把命令中的 --profile web 換成 --profile desktop。

從源碼構建¶

克隆插件倉庫：

git clone https://github.com/laoduu/DeepSeek-Harness-yizi-themes.git

進入插件目錄後構建並打包：

node prepare.mjs
npm pack

生成的 dsh-yizi-themes-<version>.tgz 按上面的 add 命令安裝。

典型用法¶

切換主題與明暗¶

在會話頭部右上角點擊主題 / 明暗按鈕；新會話沒有對話內容時，使用同位置的浮動按鈕。

自定義品牌¶

進入“設置 → 外觀 → 自定義”，填寫 Logo SVG、品牌字樣、徽章字樣、新會話標題，並可開啓品牌映射。

覆蓋插件默認配置¶

在 profile 的 cordis.patch.yml 中可覆蓋以下字段：

wordmark:
wordmarkBadge:
headline:
mappingEnabled:
mappingDeepSeek:
mappingDeepSeekChinese:
mappingHarness:
mappingDeepSeekHarness:

這些字段分別用於品牌字樣、徽章字樣、新會話標題、品牌映射開關，以及各品牌詞的替換目標。設置頁的修改優先級高於 cordis.patch.yml；配置作爲 base 層，用戶層覆蓋之。

更新、卸載與注意¶

更新¶

如果版本號變化，可直接 add 新版本。

如果版本號沒變但 tgz 內容變了，直接 add 不會更新，pnpm 可能報 Already up to date。需要先卸載再安裝：

pnpm dsh plugin --profile web remove dsh-yizi-themes
pnpm dsh plugin --profile web add /path/to/dsh-yizi-themes-<version>.tgz

更新後需完全重啓 pnpm dsh web，並瀏覽器強刷 Ctrl+Shift+R。

卸載¶

pnpm dsh plugin --profile web remove dsh-yizi-themes

重啓後恢復默認外觀。$DSH_HOME/settings.yaml 中的 ui-theme.customBrand 分節卸載後仍保留，可手工刪除。

兼容與配置¶

• 適配 Harness v0.1.2-alpha.1+；0.4.0 起遷移到 @deepseek-ai/dsh-client-store / @deepseek-ai/cordis。
• Harness v0.1.2-alpha.1 移除了 @deepseek-ai/dsh-client-runtime；舊版 0.3.x 需升級到 0.4.0。
• 插件數據走核心 ui-theme 命名空間（api-proxy 白名單），不要改成自定義命名空間。
• 側邊欄摺疊後重新展開空白是老版本 bug，升級到 0.2.2+。

安全與許可證¶

dsh-yizi-themes 是第三方插件，許可證爲 MIT。安裝前建議檢查源碼與許可證。插件安裝後以當前 dsh 進程權限運行，不要從不可信來源直接執行。

結尾¶

dsh-yizi-themes 的價值在於用插件方式改 DeepSeek Harness Web UI 的外觀與品牌，不直接修改 Harness 倉庫源碼。

倉庫地址：

https://github.com/laoduu/DeepSeek-Harness-yizi-themes

社區目錄 URL 未確認，本文不列出；如目錄站點有該插件條目，請以該站點實際頁面爲準。