前言¶

用 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 / 幻方没有官方从属关系，也不是官方应用商店。