前言¶

DeepSeek Harness 的 dsh web 可以通过插件扩展界面能力。dsh-credits 是其中用于额度与消耗展示的插件，主要解决三类问题：当前账户额度是否可用、当前会话大约花了多少、一段时间内累计花了多少。它把这些信息集中在 dsh web 输入框下方和右下角累计胶囊中展示。

这是什么¶

dsh-credits 由 Gaq152 维护，许可证为 MIT。它按供应商展示内置套餐、余额或自定义 HTTP 额度，并提供模型计价、本会话估算与累计消耗。当前版本为 0.3.0。

核心功能¶

• 在输入框下方显示账户额度与本会话估算消耗。
• 右下角显示可拖动的累计消耗胶囊。
• 显示账户额度状态灯，支持 DeepSeek 官方余额或 OpenCode Go 订阅用量。
• 跟随当前对话模型供应商展示额度。
• 显示实时生成吞吐 TPS。
• 按模型单价估算本会话消耗，并支持峰谷价。
• 支持今天、昨天、本周、本月或自定义时间范围内的跨会话累计消耗估算。
• 提供设置卡片：展示、额度查询、阈值与刷新、模型单价、YAML 导出。
• 按 DSH 供应商独立配置额度来源：内置模板、复用另一供应商额度、自定义 HTTP 接口。
• 支持 YAML 导出到当前 profile 的 cordis.patch.yml。
• 兼容 dsh-credits 0.3.0 与 dsh 0.1.1-rc.1 的新版会话投影接口，并保留旧版投影接口兼容。

安装与启用¶

先安装插件：

dsh plugin --profile web add dsh-credits

安装后重启 dsh web。

本地开发时使用本目录绝对路径：

dsh plugin --profile web add <本目录绝对路径>

升级时先移除旧版本，再清理 pnpm store 并安装 latest：

dsh plugin --profile web remove dsh-credits
pnpm store prune
dsh plugin --profile web add dsh-credits@latest

卸载：

dsh plugin --profile web remove dsh-credits

如果从 dsh-balance 迁移，先移除旧插件：

dsh plugin --profile web remove dsh-balance

然后删除 profile 本地目录，以及 cordis.patch.yml 中给 dsh-balance 写的 disabled: true。

配置与额度来源¶

配置可以覆盖 $DSH_HOME/profiles/web/cordis.patch.yml，也可以在设置 → 额度中按卡片保存。设置页保存后会立即更新当前 dsh web 进程。若要让额度绑定在服务重启后保留，需要从 YAML 导出卡片复制配置到当前 profile 的 cordis.patch.yml。

额度来源按 DSH 供应商独立配置。providerQuotas 的 providerId 必须与 DSH 供应商列表中的实际 ID 一致。未配置或已关闭的供应商不显示额度；本会话消耗与 TPS 仍可显示。

支持三种来源：内置模板、复用另一供应商额度、自定义 HTTP 接口。OpenCode Go 多账号时，可为不同 providerId 分别绑定 templateId: opencode-go，并分别保存 Key。OpenCode Go 密钥解析顺序为：

opencodeApiKey → OPENCODE_GO_API_KEY → ~/.local/share/opencode/auth.json

自定义 HTTP 额度¶

自定义 HTTP 额度需要填写 URL、凭证、鉴权方式和字段映射，并使用「测试并读取字段」验证。直接填写的 Token 或 Cookie 保存到 DSH credentials，不写入导出的普通配置。页面只显示「已设置」，可输入新值覆盖。附加请求头中的 Cookie、Authorization、Token、API Key 等敏感字段会脱敏。

硅基流动不再提供内置余额模板。需要时给对应 DSH 供应商选择自定义 HTTP 接口。

旧配置兼容¶

旧版 quotaMode、provider、quotaSources 等字段仍会兼容读取，但新配置不建议继续使用。新配置以按供应商绑定的额度来源为主。

适用场景与注意¶

适合在 dsh web 中查看 DeepSeek 官方余额、OpenCode Go 订阅用量、本会话估算消耗、实时 TPS 和跨会话累计消耗。也适合多个供应商或多个 OpenCode Go 账号分别显示各自额度。

注意：

• 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。
• 许可证为 MIT，源码仓库为 GitHub。
• 自定义 HTTP 额度依赖外部接口和凭证，需要自行维护 URL、鉴权、字段映射与凭证有效性。
• 敏感凭证不要写入普通配置；页面保存时会按插件规则处理。

结尾¶

dsh-credits 的价值，是把账户额度、本会话估算和跨会话累计消耗放到同一个 dsh web 界面中，减少手工核对。

链接¶

• GitHub: https://github.com/Gaq152/dsh-credits
• 目录页：已核实资料未包含目录页页面内容，未给出具体 URL；可按 dsh-credits 在社区目录检索。