前言¶

用 DeepSeek 跑智能体时，大家通常要新开一个浏览器页面，登录平台控制台，才能看到账户余额和今天的消费。查一次还行，任务跑久了反复切窗口很烦，而且容易忘记自己今天到底花了多少。

这个插件把这件事压缩到一行：在 DSH 侧边栏账户行的最右端直接显示余额和今日消费，鼠标悬停能看到更详细的请求和 token 信息，点一下就刷新。下面介绍它的定位、功能、安装方式和使用注意点。

这是什么¶

chipcats/dsh-sidebar-wallet 是一个 DeepSeek Harness（DSH）客户端插件，由 chipcats 维护，分类为客户端，当前星标为 0。它解决的问题很具体：让 DSH 用户在界面里持续看到账户余额和今日消费，不用切回控制台。

需要说明的是，DSH 的生态思路是「一切皆插件」，插件由社区作者维护；社区目录站点是独立站点，与 DeepSeek 及幻方没有官方从属关系，所以这不是官方出品，也不是官方应用商店上架的应用。

插件在 DSH 侧边栏账户行的最右侧渲染一行读数，形如：

Balance ¥128.00 · Today ¥12.34

具体能力只有四项，都是 README 中写明的：

余额：调用官方 GET /user/balance，优先使用已保存的 DEEPSEEK_API_KEY，没有时回退到已登录的 DeepSeek 账户钱包。
今日消费：使用官方 Platform 用量导出，按北京日历日统计，数字与控制台 Usage 页面一致；拿不到时回退到本地会话日志估算，并标注 ≈。
悬停与点击：悬停显示余额、今日消费、请求数、输入 token（命中/未命中）、输出 token、缓存命中率、峰谷时段倒计时、更新时间和数据来源；点击触发刷新。
语言：读数跟随 DSH 界面语言（中文/英文），切换语言设置后实时变化。

README 给出的安装命令如下，需要 DeepSeek Harness ≥ 0.2.1-rc.1（作者在 0.2.1-rc.5 上测试）：

dsh plugin --profile desktop add github:chipcats/dsh-sidebar-wallet

包版本为 0.2.6，许可证是 MIT，运行环境要求 Node.js ≥ 20。package.json 里声明的 DSH 引擎约束是 >=0.2.1-rc.1 <0.3.0-0，装之前可以先确认当前 DSH 版本落在这个区间内。

装完以后不需要额外配置。插件直接把读数画在侧边栏账户行，日常使用就是看和点：

插件不需要手工填 token：官方用量通过 DSH 的 deepseekAccount.getPlatformSession() 读取已登录账户会话，失效时自动退回本地估算，读数不会空白。

适合用 DSH 日常跑任务、希望在界面内顺手看消费的开发者。

几个需要留意的地方：

插件以当前 DSH 进程的权限运行，安装前建议先读一遍源码并确认许可证（MIT）。
官方金额口径是账户下所有 API 调用的合计，不限于某个 API key 或客户端；只有本地会话估算时只统计当前会话。
未登录 DeepSeek 账户时，只显示本地估算值。
峰谷时段和节假日表只作用于本地估算和倒计时，不影响官方导出金额。
隐私方面，插件只访问两个主机：api.deepseek.com（余额）和 platform.deepseek.com（用量）；token 停留在 Host 进程内存中，不发送给浏览器也不落盘；对外只暴露只读的 GET /dsh-sidebar-wallet/state.json，走 loopback / 同源隔离，没有写入、没有遥测、没有第三方运行时依赖。

dsh-sidebar-wallet 思路很克制：不增加控制面板，不改计费逻辑，只是把已有的余额和用量信息挪到界面里固定展示，供需要频繁确认消费的 DSH 用户使用。