前言¶
DeepSeek Harness 的核心设计理念是「一切皆插件」。对于习惯在 Web 界面长期运行智能体的开发者而言，界面往往是静态的。dsh-whale-girl-pet 插件在 DSH Web 界面右下角部署了一只蓝发鲸鱼女仆，通过工作链路动画、费用统计和日常互动，为长时间的开发会话提供一种可视化的陪伴与状态反馈。
工作链路与互动¶
插件内置 46+ 透明动画（WebM VP9 alpha），覆盖多种场景：
- 工作链路：包括开工（出现电脑桌敲键盘）、工作轮播（认真工作/摸鱼/思考/摸鱼被抓）、收工庆祝、被打扰等状态。
- 时间感知：根据当前时间触发不同状态，例如 8:00–10:00 睡眼惺忪，12:00 吃盒饭，23:00–3:00 迷糊犯困。
- 睡眠系统：空闲 5 分钟后自动入睡，被操作时唤醒。
- 互动：支持投喂（吃 Token 小鱼干，30 秒冷却）。
费用统计与看板¶
该插件提供了一套完整的费用追踪体系，数据来源统一。
任务完成气泡与 Pill¶
每轮任务结束时，会弹出包含用时、消耗和花费的气泡。花费按三桶拆分：缓存命中、缓存未命中、输出。在输入框下方和每条回复的动作行中，也提供了本会话累计费用和本轮费用的 Pill，点击可查看缓存命中/未命中/输出的明细。
数据看板¶
点击看板按钮（📊）可打开一个内联 SVG 看板，支持今日分时和近 7 天视图。Y 轴支持花费和 Token 两种指标切换，图表按缓存命中（蓝）、未命中（橙）、输出（紫）三段堆叠。
看板底部显示缓存命中率（计算口径为 cacheRead / (input + cacheWrite + cacheRead)），并附带汇总数据（近 24 小时、今日、均值、输入、输出）。
数据来源：实时数据来自 ctx.on('session/event') 增量折叠，历史数据来自启动时 sessionPersistence 的补扫。数据去重通过「每会话已见 seq 集合」和「调用身份」双重校验。
日常功能¶
余额与用量¶
点击余额按钮可查询当前余额、今日 Token 消耗与花费。费用计算基于 DeepSeek 官方价目，2026-09-10 起针对 Flash 系列进行了新调价（空闲/高峰价），周末全天按空闲计价。
天气与设置¶
点击天气按钮可查看明日天气，支持中文城市名或自动定位。在 DSH 设置面板的「桌宠配置」中，可调整番茄钟提醒、深夜关怀、漫游开关、按钮位置、看板历史补扫开关、看板窗口天数、长任务阈值及天气城市。
安装与配置¶
- 运行安装命令：
dsh plugin --profile web add dsh-whale-girl-pet
- 重启
dsh web进程。修改客户端 bundle 后必须重启，否则新代码不生效。 - 刷新浏览器页面，桌宠将出现在右下角。
注意事项¶
- 重启要求：插件更新或修改
lib/文件后，必须重启dsh web才能生效，仅刷新浏览器页面不够。 - 计费规则：价格基于 DeepSeek 官方价目，Flash 系列有新的调价（2026-09-10 起），周末全天按空闲计价。
- 接口限制：数据看板使用只读接口
GET /api/whale-pet/usage。 - 数据来源：数据完全依赖宿主提供的
sessionPersistence和事件流，不依赖外部数据库。
总结¶
dsh-whale-girl-pet 通过可视化的桌宠、精确的费用分桶统计以及 SVG 数据看板，将 DeepSeek Harness 的使用体验从单纯的命令行交互扩展到了桌面陪伴层面。其计费口径与官方保持一致，适合需要精细监控 Token 消耗和会话费用的开发者使用。
