前言¶

在 DeepSeek Harness（DSH）里跑 Agent 时，界面往往只有会话流和 token 统计，缺少一个能反映「正在干活 / 收工」状态的常驻元素；用量和花费分散在多处，也不直观。社区插件 dsh-whale-girl-pet 在 Web 界面右下角放置一只 Q 版蓝发鲸鱼女仆桌宠，把工作状态动画、任务完成气泡、余额与分时段花费看板、以及可选的任务结束语音播报绑在一起。YEJASONJIEXIN/dsh-whale-girl-pet 是在 yanzwzz/dsh-whale-girl-pet 0.3.2 基础上的 fork（npm 包名仍为 dsh-whale-girl-pet，当前版本 0.3.2-fork.1），在保留原有用量与动画能力的同时，增加了可拖拽调节的桌宠大小、16 种角色音色任务播报，并把天气与余额查询改为宿主进程内直连，避免受会话沙箱与审批策略限制。

下面按定位、能力、安装与配置、典型用法和注意事项说明。

这是什么¶

dsh-whale-girl-pet 是面向 DeepSeek Harness Web 的 Cordis 插件：宿主半侧注册路由与计费逻辑，浏览器半侧渲染透明 WebM 动画与交互按钮。维护者 YEJASONJIEXIN，在 SkillHub 社区目录中归类为 趣味换装；源码与说明见 GitHub 仓库，目录页见 SkillHub 插件页。许可证为 MIT。

核心功能¶

工作链路与动画¶

桌宠会跟随 Agent 状态切换动画：开工时进入「开始工作」；运行中约每 10.5 秒在认真工作、摸鱼、思考等状态间随机轮播；任务结束时播放收工庆祝。长任务超过阈值（默认 10 分钟，可在设置中调整）会触发「看表」动画；忙时点击桌宠会播放「被打扰」反应。资源为 46+ 透明 WebM（VP9 alpha），支持 prefers-reduced-motion。

用量、花费与看板¶

任务结束时头顶气泡会给出用时、token 消耗与花费估算，并按 缓存命中 / 缓存未命中 / 输出 三桶拆分；计价按 DeepSeek 官方价目与事件时间选档，含北京时间峰谷（工作日 9:00–12:00、14:00–18:00 高峰为空闲价 2 倍）。侧边 数据看板（📊 按钮）用手写内联 SVG 展示今日分时或近 N 天（1–30 天可配）的花费或 token，三桶堆叠柱、高峰底纹与缓存命中率汇总；数据来自 session/event 增量统计，启动时可通过 sessionPersistence 补扫历史会话。只读接口为 GET /api/whale-pet/usage（可选 ?hours=1..24&days=1..30）。

输入框下方与会话内动作行还会显示 会话累计 与 单轮 费用 pill，口径与气泡、余额按钮共用 lib/usage.js；DSH 0.1.6-alpha.2 起官方 composer dock 改为横向 flex 行后，本插件费用项已按新布局注册为行内 flex 项。

余额、天气与互动¶

余额（💰）调用官方余额接口，展示余额与今日消耗/花费（同样三桶与峰谷拆分），并播放「翻钱包」动画。明日天气（☁️）支持中文城市名或留空自动定位，宿主内直接 fetch，仅 Node 出网失败时退回 PowerShell 兜底路由 /api/whale-pet/weather-shell。投喂（🍪）为 TOKEN 小鱼干互动（30 秒冷却）。另有睡眠系统（空闲 5 分钟入睡）、时间感知（如 12:00 盒饭、深夜犯困）及可选番茄钟、深夜关怀、随机小剧场、漫游开关等，均在设置面板可调。

本 fork 的增量能力¶

1. 桌宠大小：拖拽右下角斜杠把手，或在 DSH 设置 → 桌宠配置 中用滑块/预设（小 180、中 260、大 360、特大 480）；范围 80–600px，写入 settings.yaml 的 size。侧边按钮尺寸随 --wb-scale 等比缩放，鼠标移入桌宠才显示按钮（查询/看板/拖拽时保持可见；触屏常显）。

2. 任务播报语音：任务完成、中断（turn/end 且 reason.kind: 'aborted'）、失败时朗读，并带上本轮第一条人类提问作为任务名（超长截断至 24 字）。默认使用 Edge 神经网络 TTS（宿主合成 MP3，无需 API Key，实现见 lib/edge-tts.js）；失败时退到浏览器 speechSynthesis。内置 16 个角色预设（胡桃、派蒙、钟离、纳西妲、可莉、东北大姨、陕西妹子、港风/台妹等），可在设置中试听并切换；总开关 voiceEnabled 默认开启。

3. 天气与余额：由 fork 说明改为 宿主侧直连，不再依赖会话内 shell，从而不受沙箱与审批策略阻挡。

安装与启用¶

在已安装 DSH CLI 的环境中，从 npm 安装（资料原文命令如下）：

# 从 npm 市场安装（推荐）
dsh plugin --profile web add dsh-whale-girl-pet

# 或从本地 tarball 安装
dsh plugin --profile web add dsh-whale-girl-pet-0.3.0.tgz

安装后需 重启 dsh web，再刷新浏览器；桌宠默认出现在右下角。修改插件客户端 bundle 或 lib/ 下宿主逻辑后也必须重启进程，仅刷新页面无法加载新代码。

兼容性：README 标明 0.3.2 系在 DSH 0.1.6-alpha.2 上验证；peerDependencies 为 ^0.1.6-alpha.2。DSH alpha 线变更时 peer 范围可能需要随宿主更新，否则包管理器可能提示 peer 未满足（一般为警告，不影响运行）。

典型用法¶

1. 安装并重启 dsh web 后，在 Web UI 右下角观察桌宠随 Agent running / idle 切换动画。
2. 跑完一轮任务，查看头顶 任务完成 气泡中的用时、token 与三桶花费；需要细查时点击 📊 打开分时段看板，或点击输入框旁的 会话费用 pill 看累计明细。
3. 需要听播报时，打开 DSH 设置 → 桌宠配置，确认「任务播报语音」开启、引擎选 edge，点选角色（默认胡桃）试听；关闭语音则只保留气泡。
4. 查余额或明日天气：鼠标移入桌宠，点 💰 或 ☁️；天气城市可在设置中填写，留空则自动定位。
5. 调整观感：拖桌宠右下角把手改大小，或在设置里改「按钮位置（左/右）」、关闭「漫游走动」让桌宠固定位置。

适用场景与注意¶

适合长期在 DSH Web 界面开发、希望用桌宠感知任务节奏，并希望在同一处查看 峰谷与缓存三桶 花费的开发者。语音角色音色为 Edge TTS 音调语速近似，并非游戏原声录音。

插件以 当前 dsh web 进程权限 运行：会注册 /api/whale-pet/* 等路由、读取会话持久化数据做用量补扫、并在宿主内请求余额与天气。安装前建议在 GitHub 查阅源码与 MIT 许可证；社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，属于 DSH「一切皆插件」生态中的第三方条目。

结尾¶

dsh-whale-girl-pet（YEJASONJIEXIN 胡桃语音 fork）把桌宠动画、用量看板、余额天气与可选 16 角色任务播报集中在 Web 右下角，并针对 DSH 0.1.6-alpha.2 的 composer 布局做了费用 pill 适配。安装命令见上文；详情与配置表以仓库 README 为准。

• 目录页：https://www.skillhub.cn/plugins/YEJASONJIEXIN/dsh-whale-girl-pet
• GitHub：https://github.com/YEJASONJIEXIN/dsh-whale-girl-pet