前言¶
DeepSeek Harness（DSH）把能力拆成可安装的插件，窗口里除了对话和任务，也可以放一点「在场感」——不用另开桌面悬浮层，Companion 直接画在 DSH 界面里。若你用过社区里的鲸鱼宠物类插件，想要同一套交互（拖拽、缩放、按会话状态切换形象），但换成作者自供的 Q 版鲸鱼女仆立绘，下面介绍维护者 yangyiqun747 发布的 dsh-plugin-whale-maid（分类：趣味换装）。它在 MIT 代码上游 dsh-plugin-whale-pet（v0.2.9）能力之上替换角色资源：去掉原鲸鱼贴纸，六种状态均来自带透明抠图的单张插画，并附带分状态重着色与少量矢量效果。
这是什么¶
Whale Maid Companion 是一只住在 DSH 窗口里的 Q 版鲸鱼小管家：陪你工作、等你确认、为你欢呼，也陪你打个盹。插件简介为：A chibi whale-maid companion who works, waits, celebrates and naps alongside you. 这是 in-window 插件，不是操作系统级桌面 overlay。运行时通过 cordis.patch.yml 插入一条 entry（id 为 whale-maid），不会自行修改你的 DSH profile。
核心功能¶
功能集与上游 whale-pet 对齐，角色与美术为本仓库维护者提供。README 中列出的能力如下。
- 窗口内交互：在 DSH 窗口内拖拽、缩放、隐藏与恢复小管家。
- 会话范围：可选 All sessions 或 Current session；对普通主会话会统计 working-session 数量。
- 六种状态：resting、working、waiting、celebrating、sleeping、error；每种状态对应独立 SVG（内嵌角色栅格 + 该状态的矢量效果）。
- 插件管理器图标：与立绘同源，16 px 仍可辨认。
- 界面与无障碍：中英文菜单、明暗主题设置、支持 reduced-motion。
- 完成语义：区分正常完成、取消与失败；working 计数下降或绿色未读指示 alone 并不表示任务成功。
各状态视觉（摘自文档）：
| 状态 | 表现 |
|---|---|
| resting | 原画形象，柔和漂浮爱心 |
| working | 略暖、略亮，小进度火花 |
| waiting | 头顶出现思考气泡 |
| celebrate | 更亮，周围星星与彩纸 |
| sleeping | 变暗、偏蓝，漂浮 「Z」 |
| error | 去饱和灰度，警告徽章 |
Global 范围覆盖当前已连接 Host 上的普通主会话，不跨多台设备或多个 Host。等待用户输入时显示优先级更高；短暂完成提示不会排队延后回放。
安装与启用¶
在 DSH 的插件安装界面填入路径或仓库标识，由 DSH 拉取并安装；安装包自带预构建 lib/，无需在安装时再 build 或下载依赖。
方式一：从 Release 安装 tgz
从 v1.0.0 release 下载 dsh-plugin-whale-maid-1.0.0.tgz，在安装界面填写该文件的绝对路径，例如：
<wherever you saved it>\dsh-plugin-whale-maid-1.0.0.tgz
安装前可按 README 校验文件：
size 747460 bytes
sha256 8a9a71681a14af84a0444fc58655996f9da66e727d85f996defc62a3b55a24f7
方式二：从 GitHub 仓库直接安装
在同一安装界面填写：
github:yangyiqun747/dsh-plugin-whale-maid
方式三：本地打包
若你从源码自行打包，在仓库根目录执行：
npm pack # writes dsh-plugin-whale-maid-1.0.0.tgz
若更新涉及 Host 或 client 模块变更，README 要求：等正在跑的任务结束，完全退出 DSH 再重新打开（仅关窗口不一定退出应用）。
典型用法¶
安装并启用后，交互以 README 为准：
- 单击小管家打招呼；拖拽 reposition。
- 右键调整会话范围、尺寸、动画与打盹时机。
- 隐藏后用 restore 按钮唤回。
偏好保存在 client 本地存储。插件不代你点批准、不额外发模型消息；completion bridge 只投影会话身份与 turn 边界元数据，不包含聊天内容。
美术资源与开发（可选）¶
六种状态的 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
二次开发需 Node.js 22+；构建期使用 esbuild 与 zod@4.4.3（devDependencies），插件安装时不会安装这些工具。常用命令：
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"
浏览器直接打开 preview/index.html 可做离线预览，不连接 DSH 或模型。
适用场景与注意¶
适合谁：希望在 DSH 窗口内有一个随任务状态变化、可自定义位置与范围的趣味 Companion，且接受「女仆鲸鱼」立绘风格的开发者或日常 DSH 用户。
权限与信任：插件以当前 DSH 进程权限运行；安装前应阅读源码与许可证。README 明确：不修改 DSH 本体、不增加监听端口与遥测、不发起运行时字体/CDN 请求；使用 DSH 已有认证连接。
许可：代码为 MIT，继承上游；角色美术由本包维护者提供，见仓库 NOTICE 与 ASSETS-LICENSE.md，不适用 MIT 代码许可。气泡字体为上游子集，见 FONT-LICENSES.md。项目为个人作品，非 DeepSeek 官方产品，也与上游 dsh-plugin-whale-pet 除 MIT 代码继承外无隶属关系。
社区目录 SkillHub 插件页 与 GitHub 仓库便于检索与安装；目录站点为社区生态，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-plugin-whale-maid 在保留 whale-pet 交互与状态机的前提下，用一套可再生的 Q 版女仆鲸鱼美术替换角色，适合作为 DSH 窗口内的轻量陪伴插件。查阅说明与安装包见 GitHub 仓库，目录索引见 SkillHub。
