前言¶

用 DSH（DeepSeek Harness）幹活，大部分時間面對的是它的 Web 界面。想讓這套界面順眼一點，通常要分別處理幾件事：主題一套方案，光標一套方案，想直觀看到子代理的啓動與退出、想在界面上直接看每輪對話消耗，又各是獨立的需求。dsh-beautify 把這些收進同一個包：29 套主題、10 態鯨魚光標、跟隨子代理出現和離開的小鯨魚掛件，外加餘額氣泡與音效。下面按功能、安裝、本地開發和注意事項的順序介紹。

這是什麼¶

dsh-beautify 是 DSH 社區插件，定位爲「一站式美化包」。npm 包名是 @nlqh/dsh-beautify，GitHub 倉庫是 nlqh7/dsh-beautify，由 DSH 社區成員 @nlqh7 製作維護。它覆蓋五塊內容：鯨魚光標、子代理小鯨魚、29 套主題、自定義皮膚，以及聲音與設置，安裝後無需配置。

體積上，README 徽章標註 bundle 爲 4.6MB，其中內嵌壁紙瘦身後約 1.7MB。

實現上它站在幾個上游項目之上：餘額顯示與鯨魚 UI 的靈感來自 MeteorNOX/DeepSeek-Balance-Whale-Widget；默認主題「深海女僕工坊」來自 zhu1090093659/dsh-web-ui（vendored，CC BY-NC-SA）；反應 GIF 的播放機制參考了 Aibie07/whale-girl-desktop-pet。

核心功能¶

鯨魚光標：10 種狀態逐態可控¶

光標覆蓋 10 種狀態：默認箭頭、鏈接手型、文本、忙碌、禁止、十字準星、背景、畫筆、幫助、拖動。每種狀態可以單獨控制；想換成自己的皮膚，可以上傳 10 張圖分別覆蓋各態。默認行爲上，拖動態使用系統原光標。

子代理小鯨魚¶

每個子代理對應一隻小鯨魚，生命週期 1:1 聯動：子代理入場，小鯨魚出現；子代理離場，小鯨魚離開。多個子代理同時到達時逐只報到，間隔約 170ms。

互動細節：

• 點擊回彈：按下瞬間回彈一下。
• 生氣彩蛋：10 秒內連按滿 8 次觸發。
• 可單獨拖動：拖到屏幕任意位置後自動吸附牆壁。
• 碰撞體積：鬆手時若與主鯨魚或其他小鯨魚重疊，自動彈開，不會疊在一起。
• 獨立聲音開關：可單獨關掉子代理叫聲，不影響主鯨魚音效。

29 套主題與 Wallpaper Engine 橋接¶

內置 29 套主題，暗 / 亮雙套；也支持自定義主題：上傳壁紙後調 7 個參數。

如果本機裝了 Wallpaper Engine（WE），可以橋接本機壁紙：插件會掃描 WE 裏的壁紙，web HTML/JS 動畫和視頻兩類都支持。切換路徑是 設置 → 外觀 → 壁紙引擎一鍵切換，隨時刷新。先切換進入壁紙模式，當前主題會自動掛起；再用暗化、模糊、邊框、玻璃 4 個滑塊微調觀感。關閉壁紙後，主題完整還原。

默認主題：深海女僕工坊¶

「深海女僕工坊」是默認主題，新裝或未設置過主題時直接啓用。它使用海軍藍 + 金色調色板，提供暗色 / 亮色兩套皮膚。聊天界面裏女僕立繪以 96vh 大圖顯示；軌跡視圖不顯示女僕。

掛件菜單與氣泡¶

主鯨魚掛件帶菜單和氣泡，主要能力：

• 隨機臺詞：點擊氣泡切換臺詞段，來源包括峯谷時段、今日已用、賣萌吐槽和 rua 動圖，再點一次關閉。
• 每輪對話消耗：每輪對話結束自動彈出本輪消耗金額，按真實 usage 換算；主會話與子代理並行時按會話分桶統計。
• 峯谷文案三種可選；v4-pro 按 3 倍價換算。
• 滾動條避讓：掛件可按設定像素避開滾動條。
• 錨點位置記憶：記住掛件相對邊框的距離，窗口尺寸變化後能回到原位。
• 多幣種：餘額接口返回多種幣種、順序不定時，優先取 CNY 正餘額。

聲音系統¶

• 主鯨魚點擊、拖動音效：總音效開關 + 音量。
• 子代理叫聲：獨立開關。
• 用量氣泡：用量模式切換。
• 音效包：4 個可選，包括小黃鴨和 fx1。

設置體驗¶

• 設置彈窗跟隨主題自身的明暗，不是宿主偏好：暗色主題下彈窗也是深色。
• 鼠標光標開關修復：關閉後再打開，皮膚一定可見（自動恢復 default 態）。
• 拖動光標大小可在 24–64px 之間調整。

安裝與啓用¶

安裝走 DSH Hub，官方描述是一步完成：

DSH Hub 搜索 @nlqh/dsh-beautify → 安裝即用，無需配置

安裝後：

1、屏幕右下角出現主鯨魚；

2、啓動子代理，對應的子代理小鯨魚自動出現；

3、打開 設置 → 外觀，可以分別調整主題、光標、聲音。

本地開發¶

想改代碼或自己構建，按倉庫 README 的流程：

git clone https://github.com/nlqh7/dsh-beautify.git
cd dsh-beautify
pnpm install
pnpm dsh web

最後一條命令需要在 DSH harness monorepo 內執行。

README 還給了一條環境小貼士：WorkBuddy 環境下 git push 會被 helper-selector 卡住，繞過方式是用 GITHUB_TOKEN 加 URL 內嵌：

git -c credential.helper= push "https://x-access-token:${GITHUB_TOKEN}@github.com/nlqh7/dsh-beautify.git" master

適用場景與注意¶

適合的人羣：日常使用 DSH Web 界面、想給界面做個性化的人；希望直觀看到子代理起止的人；想在掛件氣泡裏直接看每輪消耗的人。

安裝前建議做三件事：

1、確認權限邊界。插件以當前 dsh 進程的權限運行，安裝前先瀏覽一遍倉庫源碼，確認行爲符合預期。

2、覈對許可證。README 的徽章與 License 章節寫的是 CC BY-NC-SA 4.0，但 package.json 的 license 字段是 MIT，兩者不一致，二次分發或商用前需要自行確認以哪個爲準。

3、留意素材版權。角色立繪 DSniang1.png（CC BY-NC-SA）與 assets/reactions/*.gif（B 站 UP 主「赤風RED」的「藍色大肥魚」表情包）版權歸原作者所有，僅隨插件作非商業展示用途，另行使用需先取得授權。

另有一條信息不一致：版本方面 README 徽章爲 0.2.1，package.json 爲 0.3.0，以倉庫實際代碼爲準。

小結¶

dsh-beautify 把 DSH 界面美化裏分散的幾件事——主題、光標、子代理掛件、消耗展示、聲音——收進了一個包，DSH Hub 安裝即用，無需配置。插件由社區成員 @nlqh7 維護，鏈接如下：

• GitHub 倉庫：https://github.com/nlqh7/dsh-beautify
• 社區目錄頁：https://www.skillhub.cn/plugins/nlqh7/dsh-beautify

最後說明：DSH 社區目錄是獨立站點，與 DeepSeek / 幻方沒有官方從屬關係，也不是官方應用商店。