前言¶
在 DSH Web 中部署模型调用后，余额、今日消费、Tokens 和请求数通常需要分别查询或估算。价格表估算也不能完全代表实际扣费。
dsh-api-usage 是一个 DSH Web 插件，把 DeepSeek API 余额与用量集中到侧边栏底部，方便日常查看当前状态。
dsh-api-usage 是什么¶
dsh-api-usage 由 chenzhexii 维护，仓库地址为 github.com/chenzhexii/dsh-api-usage，许可证为 MIT。
它面向 dsh web 的 Web profile，在侧边栏底部提供一个常驻小部件，展示余额、今日消费、今日 Tokens、请求数和 24h 消费柱状图。
核心功能¶
- 常驻位置：侧边栏底部，设置按钮上方。
- 余额查看：每 60 秒查询一次
/user/balance。 - 今日消费：按相邻两次余额差值计算真实消费，精度
¥0.01。 - 用量统计：今日 Tokens 和请求数来自每次模型调用的
usage上报。 - 手动刷新：点击「↻」强制刷新余额，并立即结算差值更新今日消费。
- 充值入口：蓝色「充值」按钮通过
window.open打开 DeepSeek 充值页。 - 失败兜底：余额查询失败时显示最近一次余额，并在 10 秒内自动重试。
- 持久化：今日消费、Tokens、请求数和余额基准落盘到
$DSH_HOME/.ds-api-usage-state.json。 - 响应式：侧边栏宽/折叠两态自适应，窄窗口自动精简。
- 路由保护：
/ds-api-usage/snapshot仅限环回地址访问。 - 数据保留：小时桶保留
48h，天桶保留14天，并自动滚动淘汰。
安装与启用¶
先确认环境满足以下要求：
- DeepSeek Harness Web profile（
dsh web），dsh plugin可用pnpm - 宿主侧
Node ≥ 20 - 已配置
DEEPSEEK_API_KEY凭据 - Host 上可用
curl，用于余额接口，经subprocess seam调用
执行安装命令：
dsh plugin --profile web add github:chenzhexii/dsh-api-usage
然后重启 dsh web，刷新页面。之后可在侧边栏底部看到小部件。
典型用法¶
- 查看实时面板：页面刷新后，侧边栏底部显示余额、今日消费、今日 Tokens、请求数和 24h 消费柱状图。
- 手动同步：点击「↻」强制刷新余额，并立即结算差值更新今日消费。
- 充值：点击「充值」按钮，打开
https://platform.deepseek.com/top_up。 - 调整轮询间隔：修改
src/index.js中的ctx.interval(..., 60000)。 - 查看状态文件：
$DSH_HOME/.ds-api-usage-state.json保存今日消费、Tokens、请求数和余额基准。 - 语法检查：在仓库内执行
npm run check，用于语法检查宿主与客户端两端。
适用场景与注意¶
适合已经部署 dsh web、配置了 DEEPSEEK_API_KEY，并希望在浏览器侧边栏常驻查看余额和用量的使用者。
注意以下几点：
- 插件以当前
dsh进程权限运行，安装前应检查源码与MIT许可证。 - 插件无需额外配置，开箱即用，复用部署已有的
DEEPSEEK_API_KEY凭据。 - 仅本地
0点按“今日”语义归零。 /ds-api-usage/snapshot仅限环回地址访问，跨网络暴露前应先确认访问控制边界。
结尾¶
dsh-api-usage 的价值在于把余额、消费和用量放到 DSH Web 的日常视图中，减少频繁切换接口或依赖价格估算的操作。
GitHub：https://github.com/chenzhexii/dsh-api-usage
目录页线索：https://www.skillhub.cn/plugins/chenzhexii/dsh-api-usage
