前言¶

用 DSH（DeepSeek Harness）跑智能体任务时，API 余额和花费通常要另开官方控制台才能看到：切页面、登录、翻账单，一趟下来手头的工作就断了。如果想顺手掌握「还剩多少钱、最近每天花多少」，就需要一个常驻在客户端里的监视器。

下面介绍的 dsh-deepseek-balance 就是解决这个问题的 DSH 插件：它在窗口右下角放一个悬浮徽章，实时显示账户余额，并附带 7 天 / 30 天的用量费用图表。

这是什么¶

dsh-deepseek-balance 是由 lin-cheng-lab 维护的 DSH 插件，当前版本 0.1.0，许可证为 MIT。定位一句话可以说清：DeepSeek API 余额监视器——DSH 右下角悬浮徽章 + 7 天/30 天用量费用图表。

DSH 的理念是「一切皆插件」，这个插件把「查余额」这件事做成了客户端 UI 的一部分。数据来源分两路：余额来自官方接口 GET https://api.deepseek.com/user/balance；用量则统计本机 DSH 会话日志里的真实 token 数，再按官方价格换算成费用。

核心功能¶

按 README 的说明，插件提供这些能力：

• 右下角常驻悬浮徽章：状态色圆点 + 实时余额，任何页面/会话下可见；
• 用量费用图表：7 天 / 30 天柱状图，悬停查看每日金额；
• 每 60 秒自动刷新，也可手动刷新；
• 自动适配深浅色主题（使用 DSH 主题变量）；
• 自动读取已配置的 DEEPSEEK_API_KEY 凭证，无需手动填写；
• Key 安全：通过环境变量传给 curl，命令行/日志不出现明文。

安装与启用¶

先安装插件，命令为 README 原文，<你的用户名> 部分按实际仓库路径替换：

dsh plugin --profile web add "github:<你的用户名>/dsh-deepseek-balance#main"

再配置凭证。在 ~/.dsh/.credentials.yaml 中写入：

DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxxxxxxxxxx

经过上面的步骤，重启 dsh --profile web，右下角即可看到余额徽章。插件会自动读取这份凭证，不需要在界面里手动填 Key。

注意：插件的 Client 平台是 web，必须以 dsh --profile web 方式运行。

工作原理¶

插件分 Host（Node 进程）和 Browser UI 两半。Browser UI 部分挂载在 shell.overlay 上，负责悬浮徽章和图表；查询时通过 connection.rpc.call 调用 /deepseek-balance，由 Host 完成三件事：

1. credentials.resolve 解析凭证；
2. 通过 shell 调用 curl 请求余额接口，Key 经环境变量传递，不出现在命令行和日志；
3. sessionQuery 统计本机会话日志的 token 用量并换算费用。

README 中的结构图如下：

┌──────────────┐   connection.rpc.call   ┌──────────────────────────┐
│  Browser UI  │ ──────────────────────▶ │  Host (Node)             │
│  shell.overlay│  /deepseek-balance      │  ├─ credentials.resolve  │
│  悬浮徽章+图表 │ ◀────────────────────── │  ├─ shell curl 余额 API  │
└──────────────┘   RpcResult             │  └─ sessionQuery 用量统计 │
                                         └──────────────────────────┘

需要说明的是，用量图表基于本机 DSH 会话日志的 token 统计，本地没有记录的更早历史会以灰色示意柱展示。

本地开发与构建¶

如果想自己改代码或从源码构建，要求 Node >= 22.19.0（package.json 的 engines 字段）。先拉取依赖，再执行构建：

pnpm install
pnpm build    # tsc 编译 Host + tsdown 打包 Client

构建产物为 lib/index.js（Host 半，RPC handler：余额/用量查询）与 lib/client.js（Client 半，悬浮徽章 UI）。

适用场景与注意事项¶

适合的场景：

• 长时间在 DSH 里使用 DeepSeek API，想随时掌握余额；
• 关心每日花费趋势，想用 7 天 / 30 天图表复盘用量；
• 不想把 API Key 交给第三方面板，希望 Key 只留在本机凭证文件里。

几点注意：

1. 插件以当前 dsh 进程的权限运行，可以读取本机凭证和会话日志，安装前建议先检查源码与许可证（本项目为 MIT）；
2. 必须以 dsh --profile web 启动，否则 Client 不生效；
3. 余额查询依赖 Host 通过 curl 调用官方接口，Key 经环境变量传递，不会出现在命令行或日志中。

结尾¶

回顾一下：dsh-deepseek-balance 把 DeepSeek 的余额与用量信息搬进了 DSH 客户端右下角，余额来自官方接口，用量来自本机会话日志的真实统计，Key 全程留在本机。对每天和 DeepSeek API 打交道的开发者来说，这是一个小而实用的补充。

项目地址：

• GitHub：https://github.com/lin-cheng-lab/dsh-deepseek-balance
• 社区目录页：https://www.skillhub.cn/plugins/lin-cheng-lab/dsh-deepseek-balance

（目录为社区独立站点，与 DeepSeek / 幻方无官方从属关系。）