鲸鱼娘桌宠 drfai/dsh-whale-pet

dsh-whale-pet 🐳

DeepSeek Harness 桌宠插件：一只会换装的女仆装鲸鱼娘，住在界面右下角。

内置 Coopanion 项目的 whale 分层精灵（25 层身体部件 + 表情图层 + 7 套配色方案），并随 DeepSeek 模型的峰谷计价时段自动更换头饰发带颜色，同时在宠物下方常驻显示时段倒计时圆环。

功能

| 能力 | 说明 |
| 🐋 分层动画 | 25 层部件按 model.json 严格分层拼装，呼吸起伏、随机眨眼、头发/裙摆/鱼鳍/尾巴/呆毛持续摆动 |
| 🎭 表情状态机 | 待命（睁眼 + 中性表情）/ 工作中（加速游泳 + 手臂摆动 + 认真表情）/ 睡眠（收拢 + 闭眼 + 💤）/ 惊讶（时段切换瞬间 + 脸红） |
| 🕐 常驻倒计时 | 宠物下方圆环 + 文本：距低谷 1h 23m，按秒刷新；最后 60 秒变强调色脉冲；时段切换瞬间显示「已切换」 |
| 🔥 计价换装 | 高峰时段头饰发带变正红；低谷 / 周末 / 节假日保持原色（蓝色系不受影响） |
| 💬 价格气泡 | 单击打开：模型、当前时段、三档官方单价（元/百万 tokens）、距下次切换倒计时、运行状态 |
| 🖱 交互 | 拖动移动（位置记忆）、单击开气泡、双击收拢成睡觉小鲸鱼（再双击展开） |
| 🛟 健壮性 | 部件图加载失败自动降级；渲染错误由错误边界隔离，不会拖垮整个界面 |

峰谷计价规则

数据来自 DeepSeek 官方模型 & 价格页（2026-08-17 起生效）：

- 高峰时段：北京时间周一至周五（不含中国法定节假日）09:00–12:00 与 14:00–18:00
- 空闲时段：其余全部时间（含周末与中国法定节假日全天），价格为高峰的一半

当前支持模型：deepseek-flash、deepseek-v4-pro（deepseek-chat / deepseek-reasoner 等旧名自动映射）。

安装

这是一个 DSH profile bundle 插件包，作为本地包安装：

1. 克隆到任意目录
git clone https://github.com/drfai/dsh-whale-pet.git

2. 在 DSH 中安装并启用（本地路径安装）
- 图形界面：设置 → 插件 → 安装 → 选择该目录
- 或让 Agent 调用 plugin_manager：install_bundle

安装后插件默认启用；若已打开页面未出现桌宠，刷新一次页面即可。

配置

编辑 cordis.patch.yml 中 whale-pet 行的 config：

| 字段 | 默认值 | 说明 |
| timeZone | Asia/Shanghai | 计价时区 |
| peakRanges | [[9,12],[14,18]] | 高峰窗口 [起, 止)（小时，本地时间） |
| holidays | 2026 年中国法定假期 | 假期区间 ['开始','结束']，全天按空闲计价；每年需更新 |
| pollMs | 5000 | 浏览器轮询 /whale-pet/state 的间隔（毫秒） |

工作原理

Host 半侧 (lib/index.js, 零依赖 Cordis 插件) ├─ 峰谷计价引擎：按 ohai 时区 + 高峰窗口 + 法定假期 计算当前时段与窗口边界 ├─ 活动追踪：监听 api-session/status，判断 Agent 是否在运行 ├─ GET /whale-pet/state 当前时段 / 模型 / 单价 / 窗口 / 剩余毫秒（JSON，带 CORS） ├─ GET /whale-pet/assets/ Coopanion 分层素材（前缀路由，含路径穿越防护） └─ GET /whale-pet/image 可选备用形象图（默认不含，见下）

Client 半侧 (lib/client.js, React 18 手写 bundle) ├─ 注册到 shell.overlay 插槽（frame 级浮层，click-through，条目自行 opt-in） ├─ 分层渲染 部件 + feat 表情图层，CSS keyframes 近似原版弹簧动画 ├─ 每 1 秒本地刷新倒计时圆环，每 5 秒轮询 Host 状态 └─ 主题换装：SVG feColorMatrix 对头饰发带做确定性的白色→红色映射

Host 路由使用 __DSH_TRANSPORT__.streamBaseUrl 提供的 HTTP origin（桌面壳的页面在 dsh-app://app 自定义协议下，因此状态接口带 Access-Control-Allow-Origin: ）。

素材与版权

- 代码：MIT，见 LICENSE
- 桌宠形象：来自 Pal-AI-Lab/Coopanion 的 packages/cortico-world-desktop-pet/web/whale/（model.json、分层贴图、表情部件、 7 套配色），MIT License，Copyright (c) 2026 Phantivia。
详见 assets/COOPANION-ATTRIBUTION.md 与 assets/coopanion/MANIFEST.md；上游 THIRD_PARTY_NOTICES.md 亦随素材保留。
- 上游声明：whale 贴图由 ChatGPT（OpenAI 图像模型）生成后拆件，角色原设「溟月」， DeepSeek 女仆装二创参考 ZipZipPipe；围裙上的品牌标志图形归各公司所有，本项目与其无关联。
- 本仓库不包含任何 CC BY-NC-SA 素材。若你希望使用「女仆装鲸鱼娘」静态图作为降级方案，请自行放置 assets/whale-maid.png（该图来源为萌娘共享，CC BY-NC-SA 4.0，非商用）。

开发

- Host 半侧改完保存后，若 profile 的 HMR 监听目录包含本包源码目录，会热重载
- Client 半侧为手写 bundle（window.__ModuleLoader__.load({ id, factory })），改动后由 client-hmr 推送到已打开的页面；必要时刷新页面
- 计价引擎可独立测试：node -e "import('./lib/index.js').then(m => console.log(m.phaseAt({timeZone:'Asia/Shanghai',peakRanges:[[9,12],[14,18]],holidays:[]}, Date.now())))"

许可

MIT © contributors。第三方素材许可见上节。