whale-purse: A whale girl desktop pet living on the DSH web page, helping you monitor your balance and spending.

前言¶

用 DeepSeek Harness（DSH）跑任务时，有一个常见的不便：你想知道账户还剩多少钱、今天花了多少、当前会话烧了多少 token，就得离开网页去官方平台翻用量页面。任务一多，这种来回切换很打断思路。

whale-purse 把这件事放回了 DSH 网页内部：一只鲸鱼娘桌宠悬浮在页面上，点开就能看余额、官方「今日已消费」、当前会话的用量和花费，以及近 7 天的历史趋势。下面介绍它的功能、安装方法和配置项。

这是什么¶

一句话定位：住在 DSH 网页里的鲸鱼娘桌宠，盯 DeepSeek 账户余额、官方「今日已消费」、当前会话用量/花费与近 7 天历史趋势。

核心功能¶

桌宠与提醒¶

透明立绘悬浮在 DSH 网页上，随波摇摆、脚底投影，点击会做 squash 弹跳回应
可拖拽换位，位置记在 localStorage，刷新或重开后保持
后台会话跑完时，鲸鱼娘弹跳并在头顶冒泡「任务完成啦」，点气泡可直达完成的会话
有任务运行时忙碌抖动，并显示「忙…」标签
外接大屏和笔记本切换时，自动把桌宠夹回视口内

余额与「今日已消费」¶

余额来自 DeepSeek 官方 Get User Balance 接口（GET https://api.deepseek.com/user/balance），每 30 秒轮询一次，带并发去重。「今日已消费」调用 platform.deepseek.com/api/v0/usage/cost，显示与官方 usage 页面一致的数据，这一项需要单独配置平台 token（见下文）。

会话用量与历史趋势¶

会话用量读 sessionProjections 的 tokenUsage 投影，按官方价格对输入、缓存读、缓存写、输出分桶折算：已落盘的消息按各自发生时的峰谷档计价，进行中的增量按当前档计价。这部分是本机记账（sessionProjections 加会话日志回放加官方价格），不需要额外凭证。

点桌宠打开双 Tab 面板：「当前」Tab 看余额、今日已消费和实时花费；「历史」Tab 看近 7 天花费柱状图，以及本会话每条提问的花费明细。

峰谷定价与界面适配¶

北京时间 9:00-12:00 / 14:00-18:00 的高峰价会自动切换，官方定价页每 6 小时自动抓取一次。面板颜色和柱状图通过 --dsw-alias-* token 跟随 DSH 浅色/深色主题切换。

安装与启用¶

前置条件：Node.js 与 pnpm，并已安装 dsh：

npm i -g @deepseek-ai/dsh

方式一：一条命令（推荐）¶

dsh plugin --profile web add github:liuherong808-dev/dsh-whale-purse

该包声明了 dsh.bundle，dsh plugin 会自动把它加进 profile 的 bundle 层。然后重启 dsh web 并刷新页面。

方式二：手动安装¶

先把仓库软链进 web profile 的依赖目录：

ln -s "$(pwd)" ~/.dsh/profiles/web/node_modules/whale-purse

再在 ~/.dsh/profiles/web/cordis.patch.yml 里加一条 insert：

- insert:
    - id: whale-purse
      name: 'whale-purse'
      config:
        model: pro
        refreshIntervalSeconds: 30

最后重启 dsh web 并刷新浏览器。

配置项¶

字段	默认值	说明
`model`	`pro`	计价模型：`pro` / `flash`
`refreshIntervalSeconds`	`30`	余额轮询间隔（秒）
`apiKeyEnv`	`DEEPSEEK_API_KEY`	API key 的凭据引用名
`baseUrl`	`https://api.deepseek.com`	余额接口 base URL
`pricingRefreshHours`	`6`	官方定价页抓取间隔（小时）
`enabled`	`true`	是否启用余额查询

余额接口需要能解析到 DEEPSEEK_API_KEY，解析顺序是凭据缝、启动环境、process.env 逐层回退。

「今日已消费」需要平台会话 token：登录 https://platform.deepseek.com 后，在 DevTools Console 执行：

JSON.parse(localStorage.getItem('userToken')).value

把得到的值写入凭证 DEEPSEEK_PLATFORM_TOKEN（~/.dsh/.credentials.yaml 或启动环境）。未配置时这一项显示「需配置平台 token」，其余功能不受影响。

适用场景与注意¶

适合长期用 DSH 网页跑任务、想随手掌握余额和花费的人，尤其是开着多个后台会话、需要任务完成提醒的场景。

安装前有两点要注意：

插件以当前 dsh 进程的权限运行，安装前建议检查源码与许可证（MIT）。
「今日已消费」要用到平台会话 token，这个凭证权限不低，自己权衡是否配置；不配置也不影响余额和本地记账功能。

结尾¶

whale-purse 把余额、消费和会话花费这些原本要切页面才能看到的信息，收进了一只可拖拽的桌宠里，本地记账部分不需要任何额外凭证，装完即用。

插件目录页：https://www.skillhub.cn/plugins/liuherong808-dev/dsh-whale-purse
GitHub 仓库：https://github.com/liuherong808-dev/dsh-whale-purse

需要说明的是，插件目录是社区独立维护的站点，与 DeepSeek、幻方没有官方从属关系。