前言¶
DeepSeek Harness（DSH）桌面端界面裏，側邊欄品牌區、新會話首頁和「思考中」狀態都有固定的視覺元素。若只想換圖標、調大小，而不動 app.asar、也不希望每次應用升級後手工重打補丁，通常需要找一種走 Cordis 插件鏈、寫入 profile 的方案。
下面介紹社區插件 dsh-plugin-whale-girl（維護者 aigisx，MIT 許可證，當前版本 V0.3.0）。它在應用內把默認鯨魚相關視覺換成「鯨魚娘」主題素材，並把中文「深度求索中」改爲可配置的文案（默認「努力乾飯中」）；圖標與「思考中」小圖標的大小可在插件設置裏分別調節。分類上屬於社區目錄中的「趣味換裝」。
這是什麼¶
dsh-plugin-whale-girl 是一個第三方 DSH bundle + client plugin 雙面包：安裝進 profile 後，官方 app.asar 一行都不改，應用升級後改動仍保留。
一句話定位：修改 DeepSeek Harness 應用內的圖標，並調整尺寸大小（與 GitHub 倉庫 簡介一致）。
改了哪些位置¶
README 用表格歸納了機制，核心如下：
| 位置 | 做法 | 效果 |
|---|---|---|
| 側邊欄左上角圖標 | slot 遮蔽（sidebar.brand.mark，priority: -1） |
覆蓋官方品牌 mark，官方 bundle 仍啓用 |
| 新會話首頁的魚 | slot 遮蔽（conversation.hero.brand.mark） |
替換首頁 hero 品牌圖 |
| 「思考中」左側小圖標 | 注入 CSS，命中 [data-chat-running] 與 [class*="_runningIcon"] |
隱藏官方 APNG/SVG 後重畫；默認內置藍底小米飯小碗，可單獨換圖、放大 |
| 瀏覽器標籤頁圖標 | 注入 <link rel="icon"> |
追加，不刪官方鏈接 |
| 中文「深度求索中」及帶計時的長文案 | 改寫 chat 命名空間 zh 字典 |
僅 zh；英文仍爲官方 Deep diving |
| 側邊欄 / 首頁圖標大小 | mark 組件乘以設置倍數，並放寬側邊欄對圖標的裁剪 | 默認 1.8× |
| 思考中圖標大小 | 官方約 14px 盒子乘以設置倍數 | 默認 1×，與上面圖標互不影響 |
未改動：側邊欄「DeepSeek Harness」字標、英文文案、任務欄/托盤/歡迎頁，以及 app.asar 內任何文件。
安裝與啓用¶
安裝前請自行閱讀倉庫源碼與 MIT 許可證；插件隨當前 DSH 進程權限運行，只安裝你信任的來源。
命令行（link 依賴）¶
在 PowerShell 中執行（路徑按本機 DeepSeek Harness 與插件目錄替換）：
& "<DeepSeek Harness>\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "<本目錄的絕對路徑>"
命令會把包裝成 link: 依賴、寫入 profile 的 dsh.profile.bundles 並啓用；改源碼後重啓即可，不必重裝。
應用內添加¶
側邊欄 →「插件」→「添加插件」，填寫本目錄的絕對路徑。
安裝後注意¶
本包自帶 cordis.patch.yml，內容爲向 bundles 插入 whale-girl 一行；Loader 會自動處理。不要在 profiles/<名稱>/cordis.patch.yml 裏再手寫同 id 的 insert，否則會出現兩行 whale-girl，設置可能無法寫入（報錯：Configuration for "whale-girl" is overridden by a home patch or command-line overlay）。V0.3.0 起 node 半邊會在啓動時把重複行記入日誌。
安裝後重啓 DeepSeek Harness 生效。
快速自檢（桌面走 HTTP 插件路由時）：
Invoke-WebRequest -Uri 'http://127.0.0.1:19387/plugins/dsh-plugin-whale-girl/client.js' -UseBasicParsing |
Select-Object StatusCode, @{n='len';e={$_.Content.Length}}
返回 200 表示宿主已納入啓動圖；若走 dsh-app:// 通道返回 404，以應用內是否生效爲準。
插件設置¶
入口二選一，配置相同：
- 側邊欄 →「插件」→ 本插件 →
whale-girl→ 配置（key：dsh-plugin-whale-girl#whale-girl）； - 側邊欄 →「設置」→ 鯨魚娘主題。
五個字段（icon / runningIcon / runningText / iconScale / runningScale）互不影響：
| 欄 | 設置 | 說明 |
|---|---|---|
| 圖標 | 圖標 | 側邊欄、新會話首頁、標籤頁；「選擇圖片…」選本地圖，純色底自動摳圖，居中裁切縮到 256px 後以 data URI 存入；「恢復內置」清空覆蓋 |
| 圖標 | 圖標大小 | 滑塊 0.2×–3×，步進 0.2×，默認 1.8× |
| 思考中 | 思考中圖標 | 與主圖標獨立；64px 原色存儲；默認內置藍底小米飯 |
| 思考中 | 思考中文案 | 默認「努力乾飯中」；留空用默認；計時會長文案帶「，用時 X秒 ···」 |
| 思考中 | 圖標大小 | 同量程滑塊，默認 1×（約官方 14px） |
寫入經 ctx.configForms.get("whale-girl") 落到 profile 的 cordis.patch.yml，多窗口會同步。圖片在瀏覽器端摳圖縮放，不寫臨時文件。
換內置素材（開發者）¶
把圖片放進 assets/ 後重新構建客戶端：
node tools/build-client.mjs
支持 .svg / .png / .webp。icon.* 爲必需；另有 icon-dark.*、icon-small.*、hero.*、running.*、favicon.* 等可選文件名，缺省按 README 表格回落。
白底插畫可用附帶腳本處理後再構建：
python tools\prepare-artwork.py "路徑\原圖.png" --erase 1180,1420,1536,1536
更換默認「思考中」內置圖：
python tools\prepare-thinking.py assets\你的圖.png --preview ..\_whale-girl-work\preview.png
node tools\build-client.mjs
構建產物 lib/client.js 約 240 KB；發佈前倉庫提供 npm run check（host-check + selftest）。
卸載與回滾¶
README 提供「卸載 / 回滾」章節：從 profile 移除 bundle 依賴並去掉重複的 patch 行即可恢復官方視覺；具體步驟以倉庫文檔爲準。
適用場景與注意¶
適合：希望在 DSH 桌面端做輕量品牌化或趣味主題、且接受只改 Web 客戶端 UI、不動 asar 的用戶。
注意：
- 插件爲社區作品，目錄站點（如 SkillHub 插件頁）與 DeepSeek / 幻方無官方從屬關係；DSH 生態理念是「一切皆插件」，安裝前核對來源與許可證。
- peer 依賴爲
@deepseek-ai/cordis~4.0.4、@deepseek-ai/schemastery~3.18.4，需與當前 Harness 版本匹配。 - 重複手寫
cordis.patch.yml的 insert 會導致配置無法保存，安裝時務必只保留包自帶那一行邏輯。
結尾¶
dsh-plugin-whale-girl 通過 Cordis slot 與客戶端 CSS、locale 補丁，在不動 app.asar 的前提下替換應用內多處圖標與中文思考文案，並用兩套獨立滑塊調節顯示倍數。若你要在 DSH 裏做同類「趣味換裝」，可按上文安裝命令接入 profile，在「鯨魚娘主題」或插件配置頁完成日常調整。
