AnLifeX/dsh-credits

dsh-credits

npm version

DeepSeek Harness（dsh web）额度插件：在输入框下方显示账户额度与本会话估算消耗；右下角另有可拖动的累计消耗胶囊。设置在侧栏「额度」（最后一项，货币硬币图标），分成多张可折叠卡片。

兼容性：适配 DSH Session v2（dsh 0.1.3-alpha.2 起），已在 dsh 0.1.5-rc.1 上验证；不再兼容旧版会话事件。

- 账户额度 + 状态灯
DeepSeek 模式如 🟢 余额 ¥97.69；OpenCode Go 模式如 🟢 Go 额度 月 6% · 周 12% · 5h 9%。点击圆点可立即强刷。
- 跟随当前对话模型
底部读数跟输入框选中的模型供应商走。每个 DSH 供应商独立选择内置模板、复用另一供应商的额度，或配置自定义 HTTP 接口；未配置或已关闭时不显示额度。
- 底部条布局
默认独立换行，额度单独占底下一行；也可改成跟底部已有统计共用一行、排在最后。底部条、累计胶囊、悬停卡片都可以关掉。
- 本会话估算消耗
按模型单价估算（单价可在设置里改）。DeepSeek 按北京时间自动套用峰谷价：V4 自 2026-08-17 00:00 起；deepseek-flash / deepseek-v4-flash / deepseek-v4-flash-vision-exp 自 2026-09-10 12:00 起切换为 V4.1 Flash 新价。
- 生成吞吐 TPS
从 DSH Session v2 settlement 的压缩流和 provider usage 计算精确 TPS n tok/s。可在「设置 → 展示 → 生成 TPS」关闭。
- 累计消耗胶囊
右下角可拖动气泡，查看今天 / 昨天 / 本周 / 本月 / 自定义时间范围内的跨会话估算总额（按当前计价货币与单价现算）。
- 设置卡片
展示、额度查询、模型单价、YAML 导出各一张卡；阈值与查询频率已收进每个供应商的额度配置。每张卡独立「放弃修改 / 保存」，改过的字段可「恢复默认」。关掉再打开，未保存的草稿还在。
顶部「启用额度功能」总开关关闭后会隐藏额度、TPS、峰谷徽章、悬停详情与累计消耗，停止额度轮询，并锁定展示和额度查询；模型单价和 YAML 导出仍可用。

快速使用

dsh plugin --profile web add dsh-credits

装完后重启 dsh web。本地开发可改为：

dsh plugin --profile web add

升级：

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

界面预览

悬停底部读数会展开详情：DeepSeek 列出全部币种钱包，Go 列出三个用量窗口，下面是本会话估算。

DeepSeek 官方余额悬停卡片

底部额度默认独立占一行：

DeepSeek 余额条

OpenCode Go 额度条

OpenCode Go 模式下，卡片改成三个窗口的用量百分比与重置时间：

OpenCode Go 额度卡片

右下角可拖动的累计消耗胶囊，按今天 / 昨天 / 本周 / 本月 / 自定义区间汇总跨会话估算：

累计消耗胶囊

设置 → 额度：多张可折叠卡片，同一功能区两列排布，每张卡单独保存。

设置卡片列表

展示卡片

额度查询现在以 DSH 供应商列表为主体：每个供应商都有独立的额度开关、信息来源和保存按钮。

供应商级额度查询

识别出适合的模板后会直接显示为「内置模板」，展开后仍可切换其他套餐或余额模板：

内置额度模板设置

没有适合的模板时，可使用自定义 HTTP 接口配置请求、鉴权、返回字段与数值换算：

自定义 HTTP 额度设置

供应商额度配置里的阈值与刷新

供应商额度怎么用

在「设置 → 额度 → 额度查询」中：

1. 页面以 DSH 已启用的供应商为列表，每个供应商独立开启或关闭额度展示。
2. 插件会在后台按供应商 ID 和 Base URL 匹配模板。匹配成功时，页面直接显示对应的「内置模板」，不会再出现单独的「自动识别」选项。
3. 如需调整，可点「编辑」，在「额度信息来源」中选择：
- 内置模板：使用模板的查询地址和解析规则，并复用当前 DSH 供应商保存的 Key；模板仍可手动切换。
- 复用另一供应商的额度：两个模型供应商实际共用同一账号时，直接展示另一项已经查询到的额度。
- 自定义 HTTP 接口：自行填写 URL、鉴权和返回字段映射。
4. 未识别出模板的供应商默认进入「自定义 HTTP 接口」；接口尚未填写时保持关闭，不会随意套用其他供应商的模板。
5. 修改后点击当前供应商编辑区底部的「保存」。测试按钮使用当前草稿，不要求先开启该供应商的额度展示。

切换模型时只查看当前 DSH 供应商自己的绑定；没有配置或已关闭的供应商不显示额度，也不会回退到无关账户。本会话消耗和 TPS 不受影响。每个供应商拥有独立的查询与缓存，因此可以在 DSH 中添加多个指向 OpenCode Go 的自定义供应商，并为每个账号分别配置同一个模板。

自定义 HTTP 操作流程

自定义接口不要求编写整段 JSON 配置，常用设置都可以在页面完成：

1. 填写额度接口 URL 和请求方法。
2. 选择请求凭证：直接填写凭证、复用当前/其他 DSH 供应商的 Key、使用凭证引用，或无需鉴权。
3. 选择鉴权方式：Bearer、Token、Basic、任意请求头、Cookie、URL 参数、JSON 参数或 Form 参数。需要时再添加普通请求头和请求体。
4. 点击「测试并读取字段」。成功提示会列出实际解析出的指标；失败时可以复制请求方法、脱敏后的请求头与请求体、响应状态码和响应体。
5. 为每个展示指标选择计算方式并映射字段：
- 直接读取指标值：读取余额、剩余次数或任意数值；可选总量字段用于显示百分比。
- 总量减已用量：分别选择总量和已用量字段，插件计算剩余量。
6. 字段返回数组时可取第一项、求和、计数、最小值或最大值；换算乘数支持科学计数法，例如 1e-12。重置时间字段只用于显示。
7. 测试结果正确后保存，再开启「展示该供应商额度」。

直接填写的 Token 或 Cookie 保存到 DSH credentials，不写入导出的普通配置；页面只显示「已设置」，可输入新值覆盖。附加请求头中的 Cookie、Authorization、Token、API Key 等敏感字段也会脱敏。

设置页保存后会立即更新当前 dsh web 进程。若要让额度绑定在服务重启后仍然保留，请从「YAML 导出」卡片复制配置到当前 profile 的 cordis.patch.yml；直接填写的敏感凭证无需写入 YAML。

内置与官方模板

内置额度源：

| provider | 说明 | 上游接口 | 密钥 |
| :--- | :--- | :--- | :--- |
| deepseek | DeepSeek 官方余额 | GET /user/balance | DEEPSEEK_API_KEY |
| opencode-go | OpenCode Go 订阅用量 | GET https://opencode.ai/zen/go/v1/usage | OPENCODE_GO_API_KEY 或 OpenCode auth.json |

除 DeepSeek 和 OpenCode Go 外，设置页内置了以下模板：

- 订阅套餐：Kimi For Coding、智谱 GLM Coding / Z.AI、MiniMax Coding Plan（国内 / 国际）
- 账户余额：StepFun、OpenRouter、Novita AI

硅基流动不再提供内置余额模板。旧 /user/info 无法可靠反映网页现金余额和代金券；需要时请给对应 DSH 供应商选择「自定义 HTTP 接口」，自行配置网页接口与会话凭证。网页内部接口可能随时调整，Cookie 失效时需要重新填写。

高级 YAML 的每个 providerQuotas 绑定可以使用三种数据形态：

- balance：DeepSeek 风格多币种余额
- usage：OpenCode Go 风格多窗口用量
- metric：任意单指标/多指标剩余额度（HTTP + JSONPath）

服务端会按 DSH 供应商分别缓存所有已启用额度源；切模型时底部直接换展示，不必再等一轮查询。

| 当前对话模型的供应商 | 底部展示 |
| :--- | :--- |
| 绑定为 OpenCode Go 模板的供应商 | 该账号的订阅用量（5 小时 / 周 / 月） |
| 绑定为 DeepSeek 模板的供应商 | 该账号的官方余额 |
| 绑定为余额/套餐模板或自定义 HTTP 的供应商 | 该供应商自己的解析结果 |
| 未配置或单独关闭的供应商 | 不显示额度；本会话消耗与 TPS 仍可正常显示 |

OpenCode Go 密钥解析顺序：opencodeApiKey → OPENCODE_GO_API_KEY（credentials / 环境变量）→ ~/.local/share/opencode/auth.json。

配置

覆盖文件：$DSH_HOME/profiles/web/cordis.patch.yml。也可在设置 → 额度 改完后按卡片点「保存」。

新配置以 providerQuotas 为准，不再需要全局的额度查询模式、默认展示源或未匹配回退项。providerId 必须与 DSH 供应商列表中的实际 ID 一致。旧版 quotaMode、provider、quotaSources 等字段仍会兼容读取，但新配置不建议继续使用。

常用展示项：

| 配置 | 默认 | 说明 |
| :--- | :--- | :--- |
| providerQuotas | [] | 每个 DSH 供应商独立的额度来源绑定；未显式配置时会在后台匹配内置模板，失败则准备一份关闭的自定义 HTTP 配置 |
| showDock | true | 是否显示底部额度读数 |
| dockLayout | own | own 独立换行；shared 与底部已有统计共用一行 |
| showCapsule | true | 右下角累计消耗胶囊 |
| showPopover | true | 悬停底部读数时的双栏详情 |
| showTps | true | 是否显示最近一次生成 TPS |
| enabled | true | 额度功能总开关；关闭后隐藏相关 UI、停止轮询，并锁定展示和额度查询；不影响模型单价和 YAML 导出 |

多个 OpenCode Go 账号

- id: dsh-credits
config:
showDock: true
dockLayout: own
showCapsule: true
showPopover: true
providerQuotas:
- providerId: opencode-go
enabled: true
sourceType: template
templateId: opencode-go
thresholdMode: percent
warningThreshold: 30       # 剩余额度
response:
metrics:
- key: remaining
label: 剩余额度
calculation: direct
valuePath: $.data.financialInfo.balance
totalPath: $.data.financialInfo.recharged
unit: CNY
aggregate: value
scale: 1e-12
offset: 0

页面配置时，将完整 Cookie 填入凭证输入框，x-subject-id 放在附加请求头。先测试并确认实际返回字段；如果接口返回的金额使用 10^-12 为单位，就把换算乘数设为 1e-12。网页接口及字段可能调整，Cookie 过期后需要重新填写。代金券接口与现金余额是两个请求，当前版本不能自动合并。

架构

浏览器只读本地缓存，不直连上游：

| 路径 | 作用 |
| :--- | :--- |
| GET /query-credits | 账户额度缓存。响应里同时带所有已启用额度源的 views；?source= 只决定顶层摊平哪一套，?force=1 强刷 |
| GET /query-credits/spend?range=today | 跨会话累计消耗。range 可为 today / yesterday / week / month / custom；自定义时再带 from、to（YYYY-MM-DD 或 ISO） |
| GET /query-credits/config | 读当前配置 |
| POST /query-credits/config | 保存配置并立即生效 |
| POST /query-credits/test-connection | 使用当前供应商草稿测试模板或自定义 HTTP，并返回可选字段或脱敏后的错误诊断 |
本会话花费由 queryCreditsCost 投影折叠 Session v2 的 assistant/message / assistant/attempt settlement（每笔带事件时间），重试产生的实际用量也会计入，并按该笔发生时的北京时间峰谷价计价；前端切货币时仍按各自行情重算，不会用“此刻”的单价覆盖早上的高峰用量。TPS 由 liveTokenUsage 计算：从 settlement 压缩流还原“首个输出 token → 最后一个输出 token”的时间窗，配合 provider 精确 usage 得到该步平均输出速度。当前步尚未算出时沿用上一步的数值并置为斜体，本步结算后换成新值并恢复正体。累计消耗同样计入失败与重试尝试、按事件时间计价，并落盘到 $DSH_HOME/storages/dsh-credits-spend.json。胶囊位置和所选时间范围记在浏览器 localStorage。

密钥走 Harness credentials，默认不写进配置文件。

更新记录

0.4.0

迁移到 DSH Session v2（dsh 0.1.3-alpha.2 起）；不再兼容旧版会话事件。

- 本会话与累计消耗从 assistant/message / assistant/attempt settlement 读取精确 usage
- 失败尝试和重试产生的实际 token 均计入费用，重试后不再覆盖上一笔消耗
- TPS 取 settlement 压缩流里“首个输出 token → 最后一个输出 token”的时间窗，配 provider 精确 usage 算出该步平均速度，并保留最近一次数值；当前步尚未算出时显示上一步的数值并置为斜体，本步结算后换新值并恢复正体
- 新增 deepseek-flash 内置定价
- deepseek-flash / deepseek-v4-flash / deepseek-v4-flash-vision-exp 自 2026-09-10 12:00（北京时间）起按 V4.1 Flash 新表计费：CNY 低谷 0.02 / 1 / 4、高峰 0.04 / 2 / 8；USD 低谷 0.003 / 0.15 / 0.60、高峰 0.006 / 0.30 / 1.20
- CNY / USD 两套价目均照官方页列出，不做汇率换算
- 设置 → 模型单价新增「检查官方定价」：抓官方定价页与内置表比对，把差异列成候选，勾选后写入草稿；不自动改价，解析失败静默降级
- 配置里保存的历史官方价仍按内置时间表重算；只有手改过的峰谷 / 单价才作为自定义覆盖
- 没有精确价表的 DeepSeek 新模型按名字回退到默认定价：含 flash → 默认 Flash，含 pro → 默认 Pro，其它 deepseek → 默认 Flash；本会话消耗卡片在模型名后标出黄色感叹号并提示所用回退定价
- 完全没有可回退定价的模型（例如 glm）仍会列出，金额显示“无法计算”
- 临时预览模型 deepseek-v4.1-flash-expires-on-0910 不再内置
- 会话投影状态版本更新，旧缓存自动失效重折
- 保存设置不再重挂投影
- 移除旧投影 schema / view 字段和已移除的 dsh-client-runtime 注入
- dsh-credentials peer dependency 更新到 0.1.3-alpha.2

0.3.1

阈值与查询频率全面改为供应商级独立配置，移除全局「阈值与刷新」设置卡。

- 删除全局「阈值与刷新」卡片；阈值、刷新频率均在每个供应商的额度配置中设置
- 百分比模式默认预警 / 告急改为 30% / 10%
- 金额模式默认 CNY 10 / 5，USD 2 / 0.5
- 旧配置遗留的 0 阈值视为未设置，自动回退默认值
- 查询频率改为数字输入框，单位分钟，支持 0.5～60 分钟，默认 5 分钟
- YAML 导出不再输出全局阈值 / 刷新字段，改为随 providerQuotas 保存
- 会话消耗按「提供方 / 模型」区分，例如 opencode-go/deepseek-v4-flash
- 旧会话投影缓存升级后自动失效重建，旧会话也能补上提供方前缀
- 右下角累计消耗胶囊支持视口边界避障 / 贴边，关闭后不会跑出画面

0.3.0

额度查询重构为供应商级配置，并扩展自定义 HTTP、诊断和模型计价能力。

- 将内置 deepseek / opencode-go 抽象为额度源适配器注册表
- 支持自定义 HTTP / JSONPath 额度源：balance / usage / metric
- 自定义 HTTP 支持 Cookie / Token / Basic / Header / Query / JSON / Form 鉴权、请求体与数值转换
- 自定义指标支持直接读取、总量减已用量、百分比基准、重置时间、数组汇总、乘数和偏移
- 测试连接可读取响应字段；请求失败时可查看并复制脱敏后的请求与响应诊断
- 设置页改为以 DSH 供应商列表为主体，每个供应商可独立使用内置模板、复用另一供应商或自定义 HTTP
- 模板匹配改为后台默认逻辑：匹配成功直接展示可编辑的内置模板，匹配失败进入自定义 HTTP；不再暴露全局查询模式或「自动识别」选项
- 同一模板的多个供应商分别使用各自凭证和缓存，可配置多个 OpenCode Go 账号
- 直接输入的敏感凭证写入 DSH credentials，页面和配置 API 不回显原值
- 服务端与客户端统一按 kind 渲染，不再写死 opencode-go
- 供应商子卡片独立标记未保存状态；改回原值后自动清除提示
- 内置 deepseek-v4-flash-vision-exp 定价，恢复官方默认价不会删除自定义模型
- 计价货币仅保留官方 CNY / USD 两套价格；修复旧 EUR 复用 USD 数值但标签错误的问题
- V4 按工作日峰谷和周末全天低谷计价，本会话与累计消耗均按每笔请求发生时间计算
- 更新供应商级额度配置、自定义 HTTP 和内置模板的高清截图

0.2.4

适配 dsh 0.1.1-rc.1 的新版会话投影接口。

- 为本会话金额与实时 TPS 投影增加持久化状态 schema 和前端 wire 视图
- 修复升级 dsh 后设置已开启但 TPS、本会话金额不显示的问题
- 保留旧版投影字段，兼容较早版本的 dsh

0.2.2

设置页改成多张可折叠卡片，截图同步换成当前界面。

- 展示 / 额度查询 / 阈值与刷新 / 模型单价 / YAML 导出各一张卡，每张独立草稿和保存
- 同一功能区两列排布，勾选框与标题同行
- 提示文案缩短；底部条「共用一行」不再绑定第三方统计插件
0.2.1

悬停双栏卡片改为响应式：字号随卡片宽度缩放，窄窗口时两列改为上下堆叠，主标题不再被挤到换行。

0.2.0

适配官方设置页，不再使用输入框旁边的齿轮。

- 设置收进一级「额度」入口，排在侧栏最后；图标改为带 ¥ 的硬币
- 可开关底部条、累计胶囊、悬停卡片
- 底部条默认独立换行，可选与底部已有统计共用一行
- 额度查询支持「跟随当前模型」或「自定义固定展示」

发布到 npm

普通 git push 不会发包。 只有推送符合 v 的 tag（例如 v0.4.0）才会触发 .github/workflows/publish.yml。

第一次发布前：

1. 在 npmjs.com 注册账号（包名 dsh-credits 目前可用）。
2. 生成 Automation 或 Granular Access Token，权限包含 publish。
3. GitHub 仓库 → Settings → Secrets and variables → Actions → New repository secret，名称必须是 NPM_TOKEN，值贴刚才的 token。不要写进代码或 README。
4. 仓库 Settings → Actions 允许 workflow 运行。
5. package.json 的 version 与即将打的 tag 一致后：

git tag v0.4.0
git push origin v0.4.0

之后 Actions 会执行 npm publish --provenance --access public。发布成功即可：

dsh plugin --profile web add dsh-credits

验证

npm test
curl http://127.0.0.1:3080/query-credits
curl http://127.0.0.1:3080/query-credits/spend?range=today
curl http://127.0.0.1:3080/plugins/dsh-credits/client.js

开发

- 服务端：src/index.js（ESM，零构建）
- 浏览器：client/client.js（手写 __ModuleLoader__ 工厂）。改完需重启 dsh web
- 测试：npm test（零依赖冒烟）

FAQ

Q: 插件怎么知道查的是谁的额度？
A: 插件先根据当前模型的 DSH 供应商 ID 找到它自己的 providerQuotas 绑定。内置模板默认复用该供应商保存的 Base URL 与 Key；自定义 HTTP 则按页面选择使用直接凭证、DSH 供应商 Key、凭证引用或无鉴权。Key 不会发给浏览器。

Q: 状态灯规则？
A: 每个供应商使用自己的 warningThreshold / dangerThreshold。DeepSeek 按余额金额对比，OpenCode Go 按剩余额度百分比对比；未填写时使用该模式的默认值。🟢 ≥ 预警线；🟡 告急线～预警线；🔴 < 告急线或接口不可用。

Q: 切模型后底部读数会跟着变吗？
A: 会。插件按当前模型的 DSH 供应商 ID 读取它自己的 providerQuotas 绑定；没配置或单独关闭时不显示额度，不会回退到其它账号。

Q: “自动识别”去哪了？

A: 它现在只是后台默认逻辑，不再是页面选项。识别成功时会直接显示匹配到的内置模板，你仍可修改模板；识别失败时使用自定义 HTTP 配置。

Q: 一个自定义供应商能同时查询现金余额和代金券两个接口吗？

A: 当前不能。一个供应商绑定只发送一个 HTTP 请求，可以在同一个响应内配置多个指标或汇总数组；来自两个不同 URL 的数据暂时不能合并。

Q: 8 月 17 日峰谷价会自动切吗？
A: 会。北京时间 2026-08-17 00:00 之后，V4 Flash / Pro / Flash Vision Exp 在周一至周五 09:00–12:00、14:00–18:00 按高峰价；工作日其余时段及周末全天按低谷价。

Q: 9 月 10 日的 V4.1 Flash 新价会自动切吗？
A: 会。北京时间 2026-09-10 12:00 起 deepseek-flash / deepseek-v4-flash / deepseek-v4-flash-vision-exp 按 V4.1 Flash 新价计费。历史样本始终按该笔发生的时间点计价。

Q: 用了官方还没收录 / 不存在的模型（例如 deepseek-v5-flash、glm）会怎样？
A: DeepSeek 系新模型按名字回退到默认 Flash / Pro 定价，并在本会话消耗卡片里用黄色感叹号标出回退到了哪个价；完全无法回退的模型（例如 glm）仍会列出，金额显示“无法计算”。需要精确金额时可在设置里为对应模型补一条自定义单价。

Q: TPS 多久刷新一次？数字为什么有时候是斜体？
A: 每一步刷新一次，显示该步的平均输出速度（时间窗取压缩流里“首个输出 token → 最后一个输出 token”，不含收尾等待）。斜体表示“这不是当前这步的最终数值”——当前步还在生成、尚未算出时先显示上一步的数值并置为斜体，本步结算后换成新值并恢复正体。

Q: 官方调价了怎么办？
A: 设置 → 模型单价里有「检查官方定价」按钮：抓官方定价页与内置表比对，把有差异的项列为候选，勾选后写入草稿，保存前可以再核对。内置表本身会随插件版本更新。