前言¶

如果你已经在使用 DeepSeek Harness（DSH）Web GUI，又希望在一处查看 DeepSeek 账户余额和本地会话用量，xavier711/dsh-plugin-deepseek-usage 是一个面向 Web GUI 的用量面板插件。它在左侧栏底部增加「Usage / 用量」入口，把余额查询、本地 token 统计和费用估算放在同一个面板里。

这是什么¶

• 插件名：xavier711/dsh-plugin-deepseek-usage
• 维护者：xavier711
• 许可证：MIT
• 运行环境：DSH Web GUI，需要 Node.js
• 一句话定位：为 DSH Web GUI 增加 DeepSeek 用量面板。

核心功能¶

下面介绍它能直接显示的内容。

账户余额¶

支持配置 DeepSeek API key 后，实时查询官方 GET /user/balance 账户余额，字段包括 total、topped-up、granted。

如果没有 API key，本地用量统计仍可用，余额卡只显示提示。

本地用量统计¶

DeepSeek API 未暴露账户级用量端点（资料称所有候选路径实际返回 404），所以本地用量数据来自本地会话日志。插件会重放本地会话日志中的官方每请求 usage 记录，并显示：

• 今日、最近 7 天、全时段统计
• 7 天图表
• 今日 token 构成
• 按模型统计
• 按 workspace 统计

费用估算¶

插件按模型以官方 DeepSeek 价格（CNY per 1M tokens）估算费用，并应用：

• 2026-08-17 V4 峰谷计价
• 2026-08-23 周末全天 off-peak 规则

侧栏入口和面板头部会显示当前峰/off-peak 指示、活跃时间窗口及下一次切换。

安装与启用¶

先确认已安装 Node.js。下面几种安装方式任选其一。

方式一：从 GitHub 安装（推荐）¶

dsh plugin --profile web add git+https://github.com/xavier711/dsh-deepseek-usage.git#v0.4.2

如果本机没有全局 dsh，可以用：

npx --yes @deepseek-ai/dsh plugin --profile web add git+https://github.com/xavier711/dsh-deepseek-usage.git#v0.4.2

如果安装器提示缺少 pnpm，先运行：

npm install -g pnpm

然后重试原安装命令。

方式二：npm 安装¶

dsh plugin --profile web add @xavier711/dsh-deepseek-usage

方式三：克隆安装¶

git clone https://github.com/xavier711/dsh-deepseek-usage.git
cd dsh-deepseek-usage
./install.sh

安装后启用¶

1、在运行 dsh web 的终端中停止服务，然后重新运行 dsh web；如果没有全局 dsh，可以用 npx --yes @deepseek-ai/dsh web。

2、刷新浏览器页面，必要时做硬刷新。

完成后，「用量」入口会出现在侧栏底部、Settings 上方。

因为插件通过 dsh.bundle 自动激活，通常不需要手动改配置。

可选配置¶

API key¶

如果要显示余额卡，可以在 ~/.dsh/.credentials.yaml 中写：

DEEPSEEK_API_KEY: sk-xxxx

或者设置环境变量：

DEEPSEEK_API_KEY

无 key 时，本地用量统计仍可用；余额卡显示提示。

覆盖行配置¶

按需可在 ~/.dsh/profiles/web/cordis.patch.yml 中通过 id: deepseek-usage 覆盖配置。已列出的配置项包括：

balanceTtlMs
maxSessions
sessionConcurrency
balanceTimeoutMs
localTtlMs
newPricingAt
weekendOffPeakAt
peakHours

具体取值请按你的运行环境设置。

更新、卸载与排查¶

npm 安装更新¶

dsh plugin --profile web update @xavier711/dsh-deepseek-usage

Git 安装更新¶

Git 安装为固定快照，更新不自动。插件会在打开用量面板时查询 GitHub releases feed（小时级缓存），并显示新版本的准确更新命令。

执行更新命令后，需要重启 dsh web 并刷新页面。

卸载¶

dsh plugin --profile web remove @xavier711/dsh-deepseek-usage

然后重启 dsh web 并刷新页面。

常见问题¶

如果看到警告 declares no dsh.bundle，说明安装了旧快照。按 pinned tag 重装：

dsh plugin --profile web remove @xavier711/dsh-deepseek-usage
dsh plugin --profile web add git+https://github.com/xavier711/dsh-deepseek-usage.git#v0.4.2

然后重启 dsh web 并刷新页面。

如果「用量」入口没有出现在安装后，先确认 dsh web 已重启，并刷新或硬刷新浏览器页面。

适用场景与注意¶

这个插件适合已经使用 DSH Web GUI，并且希望同时查看 DeepSeek 余额和本地会话用量的场景。

需要注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码和许可证。
• API key 不会被内嵌到插件中；运行时从本机 ~/.dsh/.credentials.yaml 或环境变量解析，并且只在 host 端使用，浏览器 bundle 不接触。
• 资料中的截图数字均为合成样例数据，不表示真实余额、key、token 或会话内容。

链接¶

GitHub 仓库：https://github.com/xavier711/dsh-plugin-deepseek-usage