前言¶
DeepSeek Harness(DSH)的 Web 界面默認是一套通用外觀。對長期跑在本地或內網的開發者來說,界面往往只是「能用」——配色、圖標、對話狀態反饋都停留在框架默認層,和你在用的工具鏈沒有視覺上的關聯。
社區裏已有不少 DSH 插件擴展能力,但「換皮」類插件相對少見,且多數只是改幾個 CSS 變量。下面介紹的是維護者 tpmoonchefryan 發佈的 dsh-joi-channel-theme:一套基於 VirtuaReal 虛擬主播軸伊 Joi 官設製作的非官方粉絲主題,把兩套完整衣裝(Joi·Flowers / Joi·Library)搬進 Harness 的每個界面角落,並在對話狀態變化時同步演出角色表情。
這是什麼¶
dsh-joi-channel-theme 是 DSH 的 Web 客戶端主題插件,插件 ID 爲 dsh-joi-channel-theme,當前 npm 版本 0.1.10。它在 SkillHub 社區目錄中歸類爲「趣味換裝」,GitHub 倉庫約 11 stars。
插件定位很明確:把 DeepSeek Harness 的界面換成軸伊 Joi 的兩間「房間」——暖色舞臺感的 Joi·Flowers 和冷色書房感的 Joi·Library。兩套衣裝各自擁有獨立的底色、面板、氣泡、代碼高亮、底紋和角色演出,互不混用;明暗模式(淺色 / 深色 / 跟隨系統)仍由 Harness 原生設置控制,換裝只切換色相體系。
需要事先說明:這是非官方、非商業的粉絲作品,與軸伊 Joi、VirtuaReal、嗶哩嗶哩、DeepSeek 及相關權利方不存在隸屬或授權關係。代碼以 MIT 許可發佈,角色與視覺資產以 CC BY-NC-SA 4.0 許可發佈。
核心功能¶
雙衣裝完整主題¶
每套衣裝覆蓋 19 級中性色階、44 條語義色映射和 9 項代碼高亮(淺深各一套值)。側欄 logo 換成軸伊與鯨魚孃的雙人合照,隨衣裝切換;標籤頁圖標、列表記號等細節也一併替換。全部視覺素材以內聯 WebP data URI 打包(10 件,約 2.4 MB),不依賴外鏈,對 CSP 友好。
對話狀態演出¶
對話頁輸入框兩側各有一個 Q 版角色:左側爲粉絲形象「軸芯」,右側爲軸伊。它們共享同一套狀態詞表,在同一時刻切換表情:
| 狀態 | 標識 | 表現 |
|---|---|---|
| 待機 | info |
默認姿態 |
| 執行中 | running |
工作中 |
| 成功 | success |
眯眼開心 |
| 失敗 | error |
垂眼落淚,約五秒後回到待機 |
長對話中文字與角色重疊時,重疊行會自動加底色描邊以保證可讀性。
界面內換裝與回退¶
安裝後,在 設置 → 通用設置 → 換裝 中可見三張卡片:Joi·Flowers、Joi·Library,以及「DeepSeek 原生」。選原生外觀不會卸載插件,只是切回框架默認皮膚;再選任一套衣裝即可恢復。明暗仍由下方的淺色 / 深色 / 跟隨系統控制。
其他設計細節¶
- 上下文用量指示改爲一顆會隨用量變色的橘子,熟過頭即警示。
- 子代理任務以小鯨魚圖標排隊展示:排隊閉眼、運行噴水、完成眯眼。
- 設計基線凍結在
baseline-4q.json,構建期生成常量;四套象限(兩衣裝 × 淺深)各有獨立校色。
兼容要求:DeepSeek Harness Web 0.1.0-rc.5+。
安裝與啓用¶
DSH 插件目前只能通過命令行安裝,裝完後需重啓 Harness 進程纔會生效。安裝前確認運行環境:
| 前提 | 檢查命令 |
|---|---|
Node.js ^22.19 或 >=24 |
node -v |
pnpm(dsh plugin 依賴它管理 profile 依賴) |
pnpm -v |
沒有 pnpm 時,任選一種方式安裝:
npm install -g pnpm
或
corepack enable pnpm
用 npx 啓動 Harness 的情況¶
若你平時用 npx @deepseek-ai/dsh web 啓動,dsh 命令不在 PATH 上,需加同樣的 npx 前綴:
npx @deepseek-ai/dsh plugin --profile web add dsh-joi-channel-theme
裝完後照常啓動:
npx @deepseek-ai/dsh web
profile 名必須是 web。只有 web 和 headless 帶有出廠模板,其他名字不會加載網頁界面。
全局安裝 dsh 的情況¶
npm install -g @deepseek-ai/dsh
dsh plugin --profile web add dsh-joi-channel-theme && dsh web
瀏覽器打開終端打印的地址(默認 http://127.0.0.1:3080),硬刷新一次即可看到主題。若 Harness 已在運行,需先 Ctrl+C 停掉再重啓,插件集變更不支持熱加載。
卸載¶
npx @deepseek-ai/dsh plugin --profile web remove dsh-joi-channel-theme
卸載後界面會逐項回到原生外觀,README 稱經過實機逐項覈對,token、圖標、字標、代碼高亮均無殘留。
國內網絡下若 npx 拉取失敗,可臨時指定官方源:
npx --registry=https://registry.npmjs.org/ @deepseek-ai/dsh plugin --profile web add dsh-joi-channel-theme
典型用法¶
經過上面的安裝步驟,日常操作全部在界面內完成,無需再敲命令行。
- 啓動 Harness 並打開 Web 界面。
- 進入 設置 → 通用設置。
- 在「換裝」行選擇 Joi·Flowers 或 Joi·Library;需要恢復默認時選「DeepSeek 原生」。
- 在同一頁面的明暗設置中選擇淺色、深色或跟隨系統——明暗與衣裝獨立,可自由組合出四個象限。
對話過程中,觀察輸入框兩側角色的表情隨任務狀態(待機、執行中、成功、失敗)自動切換,無需額外配置。
適用場景與注意¶
適合誰
- 已在本地或內網使用 DeepSeek Harness Web 界面的開發者,想給日常工具換一套有完整視覺體系的皮膚。
- 軸伊 Joi 或 VirtuaReal 粉絲,希望在開發環境裏保留角色元素,同時不影響 Harness 本身的功能。
- 需要離線友好、零外鏈素材的主題——全部資源內聯打包,不依賴 CDN。
使用前請注意
- 插件隨當前 DSH 進程權限運行,安裝前應閱讀倉庫源碼與許可證(代碼 MIT、資產 CC BY-NC-SA 4.0),確認非商業使用範圍符合你的場景。
- 這是粉絲二創,不得用於商業用途,也不得暗示與官方或權利方有關聯。
- 插件只改 Web 客戶端外觀,不修改模型調用、工具鏈或 agent 邏輯;若你用的是
headlessprofile,本插件的 Web 注入不會生效。 - 從 GitHub 直裝不推薦:pnpm ≥10 會攔截
prepare構建腳本,首次安裝可能失敗;應通過 npm 官方包dsh-joi-channel-theme安裝,包內已帶構建產物。
結尾¶
dsh-joi-channel-theme 把軸伊 Joi 的兩套官設衣裝做成了 Harness 裏可切換的完整房間:色板、角色、狀態演出和細節彩蛋各自成體系,又能在設置裏一鍵回到原生外觀。對想把 DSH 界面個性化、又希望保持可逆和零殘留的開發者來說,這是一條經過 npm 官方鏈路、文檔齊全的換裝路徑。