鲸鱼小管家 yangyiqun747/dsh-plugin-whale-maid

Whale Maid Companion

一位 Q 版鲸鱼小管家，陪你工作、等你确认、为你欢呼，也陪你打个盹。

Six companion states in light and dark themes: resting, working, waiting, celebrate, sleeping, error

All six states, rendered by a real browser in both themes. Regenerate with python artwork/tools/review-states.py.

一只住在 DSH 窗口里的 Q 版鲸鱼小管家：陪你工作、等你确认、为你欢呼，也陪你打个盹。

这个插件保留了上游项目 dsh-plugin-whale-pet（MIT 代码，v0.2.9）的全部功能，只换掉了角色：鲸鱼贴纸没了，每个状态都改用一张主人提供的 Q 版鲸鱼小管家插画来绘制，自带透明抠图、按状态重新上色，还有小型的矢量特效。

功能

- 在 DSH 窗口里拖动、缩放、隐藏和恢复小管家。
- 可选 All sessions 或 Current session，普通主会话会显示工作中的会话数量。
- 六种状态：resting、working、waiting、celebrating、sleeping、error。
- 自定义插件管理器图标，用同一套插画生成，16 px 下依然清晰可辨。
- 支持中英文文案、浅色与深色设置菜单，以及减弱动效。
- 区分正常完成、取消和失败；工作中数量下降，或只亮起绿色未读标记，都不代表成功。

这是窗口内插件，不是独立的操作系统桌面浮层。

六种状态

| 状态 | 外观 |
| resting | 角色保持原样，周围飘着柔和的心形 |
| working | 略微更暖更亮，带小小的进度闪光 |
| waiting | 头顶冒出一个思考气泡 |
| celebrate | 更亮，周围有星星和彩纸 |
| sleeping | 变暗并偏蓝，飘着「Z」字符 |
| error | 褪成灰色，带一个警告徽章 |

The plugin icon from 16 px to 128 px on light and dark plates

The plugin-manager icon at the sizes DSH actually draws it.

每个状态都是一个 SVG，里面嵌入角色位图，再加上自己的矢量特效。插画由 artwork/ 里的脚本从源图生成，所以插画一改，整套素材都能重新生成：

python artwork/tools/make-assets.py # writes assets/.svg and assets/icon.svg
python artwork/tools/review-states.py # writes artwork/build/states-with-effects.png

安装

直接下载： dsh-plugin-whale-maid-1.0.0.tgz，来自 v1.0.0 release，然后在 DSH 的插件安装界面里填入它的绝对路径：

<wherever you saved it>\dsh-plugin-whale-maid-1.0.0.tgz

安装前先校验下载：

size 747460 bytes
sha256 8a9a71681a14af84a0444fc58655996f9da66e727d85f996defc62a3b55a24f7

直接从本仓库安装

在同一个界面里填入下面这行，DSH 会帮你拉取并安装：

github:yangyiqun747/dsh-plugin-whale-maid

自己构建安装包

npm pack # writes dsh-plugin-whale-maid-1.0.0.tgz

包里已经带了构建好的 lib/ 产物，所以安装时不会跑构建步骤，也不会下载任何东西。如果更新改动了 Host 或客户端模块，先等正在运行的任务跑完，完全退出 DSH 再重新打开——只关窗口可能并没有退出应用。

插件不会自己改动你的配置档。它只通过 cordis.patch.yml 插入一行（条目 id 为 whale-maid）。

用法

- 点击女仆打个招呼；拖动她可以换位置。
- 右键可以改会话范围、大小、动画和打盹时间。
- 用恢复按钮把藏起来的女仆找回来。
- 全局范围覆盖当前已连接 Host 上的普通主会话——不跨多台设备或多个 Host。
- 等待用户输入的显示优先级更高。短暂的完成提示不会排队留到之后重放。

开发

用 Node.js 22 或更新版本。构建需要 esbuild 和 zod@4.4.3 作为开发依赖（在本地声明，比如用 pnpm install）；安装插件时不会装或下载任何东西。

node tools/bridge-build.mjs # regenerate lib/remote.js + lib/index.js
node tools/build.mjs # regenerate lib/client.js + offline preview
node --test "tests/.test.mjs"

tools/check-glyphs.mjs 会报告内嵌字体子集画不出来的气泡文案；随包发布的中文字典就放在这个子集里，所以气泡字体不会在句子中间回退。

构建会校验每个状态 SVG：不允许脚本、不允许远程引用、<image> 只能带内联 PNG 数据，并且有体积上限。直接在浏览器里打开 preview/index.html，就能看到离线预览，全程不会连接 DSH 或模型。

隐私与运行时边界

- 不改动 DSH 本身，不发模型消息，不增加模型推理调用，也不替你处理审批。
- 复用 DSH 已有的认证连接。不额外监听端口，不做遥测，运行时也不请求字体或 CDN。
- 完成桥接只投影会话身份和轮次边界元数据——不涉及聊天内容。
- 偏好设置留在客户端本地存储里。

许可

- 代码： MIT，继承自上游项目。上游仓库、它的构建工具、状态机和文案都归上游作者所有。
- 角色美术： 由本包所有者提供。见 notice 和 character asset notes；它不在 MIT 代码许可的覆盖范围内。
- Bubble fonts： 沿用上游子集，未作改动，见 font licenses。

这是个人项目，不是 DeepSeek 官方产品。它不代表 DeepSeek 的官方观点或背书，除了所基于的 MIT 许可代码之外，与上游 dsh-plugin-whale-pet 项目没有关联。