whale-purse：DeepSeek Harness 里盯余额与会话花费的鲸鱼娘桌宠

它是做什么的？

whale-purse 是 DeepSeek Harness（DSH）的鲸鱼娘桌宠插件，把 DeepSeek 账户余额和当前会话的 token 用量、预估花费做成一只可拖拽的二次元角色，浮在 DSH Web GUI 上。它解决的是「跑任务时不知道花了多少钱、余额还剩多少」的问题，让你不必切到控制台或账单页反复核对。点她弹出当前/历史双 Tab 面板，余额 30 秒、花费 3 秒自动刷新，位置自动记住。由 Suiwan 维护，采用 MIT 协议，最近更新于 2026-08-30。

核心功能

• 余额监视：调用 DeepSeek 官方余额接口，30 秒轮询并做并发去重，请求失败时保留上次快照并提示数据已过期。
• 会话用量与花费折算：读取会话的 tokenUsage 投影，按输入未命中、缓存命中、输出三桶计价，分桶条形图按金额占比绘制，避免缓存命中 token 占大头却几乎不花钱的误导。
• 峰谷定价：北京 9:00-12:00 / 14:00-18:00 自动切到高峰价，面板显示当前档位与距下次切换的倒计时，官方定价页每 6 小时自动抓取。
• 提醒与状态动作：余额低于阈值或今日花费超预算时面板警告并亮红点，有通知权限时发送浏览器通知；后台会话跑完时桌宠弹跳冒泡，点气泡直达完成会话。
• 历史趋势：历史 Tab 展示近 7 天花费柱状图，并列出本会话每条提问的花费明细，多步循环自动合并成一行。
• 面板设置与主题适配：点齿轮即可改计价模型、低余额阈值和今日预算，保存到本地 JSON；面板配色随 DSH 浅色/深色主题切换，外接屏切换时桌宠自动夹回视口内。

怎么使用这个插件？

在 DSH Web 环境启用后，鲸鱼娘会以透明立绘悬浮在页面上，拖动即可换位，位置写入本地存储，刷新或重开浏览器都保持原处。点击她打开双 Tab 面板：「当前」Tab 看余额与实时花费，「历史」Tab 看近 7 天趋势和本会话逐条提问的花费。需要调整行为时点面板右上角齿轮，修改计价模型（auto 会按会话实际请求头识别 flash/pro，识别为非 DeepSeek 模型则不估算花费）、低余额阈值和今日预算，保存后立即生效、无需重启。余额查询依赖环境中的 DeepSeek API key，按 README 说明配置凭据即可；若同时使用 DSH-better-sidebar，桌宠拖进其 Explorer 面板区域也不会被遮挡。

报错怎么排查？

余额或定价请求超时时，面板会显示「请求超时」而不是英文的 aborted 提示，此时按官方说明检查网络与凭据配置即可。若余额数据旁出现过期标记，说明最近一次轮询失败，界面保留的是上一次快照，恢复连通后会自动刷新。若面板显示「未估算花费」，通常是当前会话被识别为非 DeepSeek 模型，属于预期行为，可在设置里手动指定计价模型。