前言¶
DeepSeek Harness Web（dsh web）的默認界面是一套中性的工程風格，長期盯着看，想調整外觀基本只有兩條路：自己動手改界面樣式，或者等一個現成的主題機制。DSH 的理念是「一切皆插件」，界面換裝這件事同樣可以交給插件來做。
下面介紹 dsh-columbina-theme，一個由 hyposelen1a 維護的主題插件：它把原神角色「哥倫比婭」的主題應用到 DSH Web 上——背景、蒙版、配色，安裝後首幀即生效，不需要改動 DSH 本身的代碼。
這是什麼¶
dsh-columbina-theme 是爲 DeepSeek Harness Web 打造的主題插件，一句話定位：背景、蒙版、配色——來自挪德卡萊的月光。插件歸類爲「趣味換裝」，當前版本 0.1.1，代碼採用 MIT 許可。
插件隨包附帶兩張預設背景：columbina-1 用於淺色模式，columbina-2 用於深色模式，切換明暗模式時背景與配色一起切換。
核心功能¶
插件的能力分兩組：一組是主題本身，一組是實現方式。
主題部分：
- 淺色/深色雙默認：淺色默認背景
columbina-1+ 淺色配色，深色默認背景columbina-2+ 深色配色； - 可調蒙版：0% 等於背景原圖效果（主界面面板通透度同步歸零），越高越不透明，100% 爲完全覆蓋當前明暗主題底色；
- 自定義顏色：蒙版、輸入框、側邊欄、字體顏色均可自定義，留空即跟隨明暗主題默認色；
- 自定義背景：上傳 PNG/JPEG/WebP/GIF 圖片作爲背景；放進
assets/backgrounds/目錄的任意圖片自動成爲預設； - 選中會話標題特效：當前會話標題使用藍紫漸變文字與光暈；
- 通透的界面表面：會話區、氣泡等主內容表面的通透度跟隨蒙版設置；輸入框固定 80% 不透明；側邊欄與浮層始終不透明，保證可讀性。
實現部分：
- 首幀即生效：主題樣式通過
webServer.tapIndex注入每次頁面響應，加載無閃爍； - 上傳的自定義圖片限制在 15MB 以內，位圖超過 512KB 時由服務端生成 640px 寬的 JPEG 預覽縮略圖。
安裝與啓用¶
前置條件：DeepSeek Harness（dsh）、Node.js ≥ 22、pnpm 在 PATH 中。
1、先完全退出 DSH（不只是關閉瀏覽器標籤頁）。
2、安裝插件。從 GitHub 安裝：
dsh plugin --profile web add github:hyposelen1a/dsh-columbina-theme
插件發佈到 npm 後，也可以直接按包名安裝：
dsh plugin --profile web add dsh-columbina-theme
本地開發調試用 link 方式，路徑換成你的實際目錄：
dsh plugin --profile web add link:/path/to/dsh-columbina-theme
3、經過上面的步驟，重新啓動 dsh web 並硬刷新瀏覽器（Ctrl+F5），打開 設置 → 插件 → 哥倫比婭主題 即可配置。
不想卸載、只想臨時停用時，編輯 $DSH_HOME/profiles/web/cordis.patch.yml，加入下面兩行並重啓：
- id: dsh-columbina-theme
disabled: true
刪除這兩行（或改回 false）再重啓，即可恢復啓用。
典型用法¶
安裝後，插件的設置入口在 設置 → 插件 → 哥倫比婭主題，常用幾項：
- 背景預設：留空爲自動（淺色
columbina-1/ 深色columbina-2）； - 上傳自定義圖片：支持 PNG/JPEG/WebP/GIF，不超過 15MB，上傳後作爲背景使用；
- 蒙版不透明度：0% 爲原圖效果，100% 爲完全覆蓋當前明暗主題底色；
- 顏色：蒙版、輸入框、側邊欄、字體顏色均可自定義，留空跟隨明暗主題；
- 選中會話標題特效：開關當前會話標題的漸變 + 光暈效果。
想添加自己的預設背景，把圖片放進插件的 assets/backgrounds/ 目錄即可。文件名只能包含字母、數字、-、_（如 columbina-3.jpg），支持 svg/png/jpg/jpeg/webp/gif 格式，重啓 DSH 後自動出現在預設網格，不需要改代碼。
超過 512KB 的位圖會自動使用服務端生成的 640px 寬 JPEG 預覽縮略圖，避免設置界面加載原圖。上傳的自定義圖片與預設縮略圖緩存統一保存在 $DSH_HOME/storages/dsh-columbina-theme/。
插件的所有設置保存在 $DSH_HOME/settings.yaml 的 dsh-columbina-theme 命名空間下。
適用場景與注意¶
適合的人：每天使用 dsh web，希望在不動 DSH 本身代碼的前提下給界面換一套固定風格的玩家和開發者。
幾個已知的限制，裝之前建議過一遍：
- 插件針對 DeepSeek Harness
0.1.0-rc.7開發（@deepseek-ai/cordis ^4.0.1、dsh-* ^0.1.0-rc.7）。DSH 仍處於 developer preview 階段，接口可能發生破壞性變更；升級後如果主題失效，先查看倉庫的 CHANGELOG 與 release 說明。 - 選中會話標題特效依賴會話行的 DOM 結構，DSH 界面內部類名隨版本變化時可能需要調整選擇器。
- 表面透明度通過 CSS token 覆蓋實現，DSH 版本升級後個別表面可能不再受控。
- 多實例共享
$DSH_HOME/settings.yaml時，併發寫入以最後一次爲準。 - 版權要分開看：代碼與程序生成的預設資源採用 MIT 許可；隨包附帶的兩張背景圖
columbina-1.png/columbina-2.png爲作者自備素材，版權歸原作者所有，詳見倉庫的 ASSET_LICENSE.md。
最後照例提醒：安裝任何 DSH 插件，插件都會以當前 dsh 進程的權限運行。dsh-columbina-theme 的代碼採用 MIT 許可、源碼公開在 GitHub，建議安裝前自行檢查源碼與許可證。
結尾¶
dsh-columbina-theme 只做一件事：把 DSH Web 換成「哥倫比婭」主題，同時保持界面可讀可用。淺色/深色雙默認、可調蒙版、放進目錄即成預設的背景機制，把自定義門檻壓得比較低。如果你想要一個開箱即用的換裝方案，或者想看看 web profile 主題插件怎麼寫，它的倉庫值得一讀。
- GitHub 倉庫：https://github.com/hyposelen1a/dsh-columbina-theme
- 社區目錄頁：https://www.skillhub.cn/plugins/hyposelen1a/dsh-columbina-theme
