dsh-whale-pet

English

一个运行在 DeepSeek Harness 官方 Web UI 中的非官方鲸鱼娘桌面宠物插件。

宠物通过 Harness 官方的 shell.overlay 叠加插槽挂载，只反映当前选中的会话；不修改 Harness 源码、不抓取页面文字，也不使用已被移除的 .dsh-plugin 格式。运行时图片全部内嵌在 client.js 中，不依赖额外静态资源路由。

兼容性

插件版本	DeepSeek Harness	界面
0.1.x	0.1.0-rc.6	官方 Web UI

Harness 当前仍是开发预览版。兼容表之外的版本，只有通过本项目真实安装测试后才会被声明支持。

功能

• 五种确定性状态：待机、工作中、需要操作、任务完成、遇到问题。
• 工作动画采用六步往返切帧；系统启用“减少动态效果”后固定首帧。
• 点击宠物查看待确认类型、当前工具和已工作时长。
• 支持拖拽、键盘移动、四档尺寸、动画开关、位置重置，以及可恢复的 32px 折叠入口。
• 中英文界面文案。
• 偏好只保存在浏览器本地，不含分析统计、远程请求或跨浏览器同步。

安装

dsh plugin --profile web add dsh-whale-pet@0.1.0-rc.1
dsh --profile web --dump-config
dsh --profile web

--dump-config 应只出现一条 dsh-whale-pet。客户端 bundle 加载后，宠物默认显示在 Web UI 右下角。

安装本地构建

pnpm install --frozen-lockfile
pnpm check
npm pack
dsh plugin --profile web add ./dsh-whale-pet-0.1.0-rc.1.tgz

卸载

dsh plugin --profile web remove dsh-whale-pet
dsh --profile web --dump-config

偏好存储在 localStorage["dsh-whale-pet/preferences/v1"]。卸载 npm 包不会删除这项浏览器本地设置，重新安装后可恢复布局；若希望一起清理，可手动删除该键。

状态映射

优先级	当前 Harness 会话	宠物状态
1	无当前或已打开会话	待机
2	等待审批、计划确认或回答	需要操作
3	正在运行	工作中
4	停止后存在明确的代理、发送或打开错误	遇到问题
5	同一会话从运行正常停止	完成 1600ms
6	其他稳定状态	待机

切换会话会重置完成边沿检测，因此打开一个早已完成的会话不会误报“刚刚完成”。

开发与验证

需要 Node 22.19+ 或 24+、pnpm 11.19.0；真实集成测试使用 DeepSeek Harness 0.1.0-rc.6。

pnpm install --frozen-lockfile
pnpm assets:build
pnpm check
pnpm test:visual
npm pack
node scripts/smoke-harness.mjs --package ./dsh-whale-pet-*.tgz

character/ 下的 PNG 是不可变输入。pnpm assets:build 会先核验 SHA-256，再执行边缘连通去背、工作帧对齐、透明 WebP 编码，并生成文档用接触表与 GIF。

完整贡献流程见 CONTRIBUTING.md。

许可证

• 代码：MIT
• 原图与处理后美术：CC BY 4.0
• 作者、原图哈希与修改记录：ASSET_ATTRIBUTION.md