deepseekplugins

DeepSeek Harness plugin

api-monitor

常驻 API 用量监控：DeepSeek/SiliconFlow/OpenCode Go/火山 Coding+Agent Plan 余额与配额，会话树 token 与花费（侧边栏入口 + 独立浮动窗）。

Development & Runtime
Jump to install

Source facts

Repository
jcleener/api-monitor
Latest update
Aug 21, 2026
Category
Development & Runtime
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/jcleener/api-monitor
Plugin: api-monitor
Author: jcleener

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

api-monitor

> DSH（DeepSeek Harness）插件：常驻 API 用量监控。 > 侧边栏底部常驻摘要 + 独立浮动窗，实时查看 DeepSeek / SiliconFlow 余额、OpenCode Go 与火山引擎（Coding Plan / Agent Plan）订阅配额，以及当前会话树（主会话 + 全部子代理）的 token 用量与花费。

功能

  • 余额与配额监控：

- DeepSeek — GET api.deepseek.com/user/balance - SiliconFlow — GET api.siliconflow.cn/v1/user/info - OpenCode Go — GET opencode.ai/zen/go/v1/usage - 火山引擎 — GetCodingPlanUsage / GetAFPUsage（SigV4 签名，service = ark）

  • 会话树用量：统计主会话与全部子代理的 token 用量与花费（价格表可配置，priceTable 覆盖）
  • 入口：侧边栏底部 .footArea（Cordis 面板按钮上方）。宽侧栏显示竖排多行摘要（每家一行：状态色点 + 名称 + 数值，行数由「显示在入口」勾选控制）；侧栏收起（rail）时退化为圆形图标；点击弹出 Cordis 风格浮动窗（标题栏 + ✕ 关闭 + Esc 关闭 + 遮罩点外关闭）
  • 轮询：默认 60s 可配置；拉取失败时保留上次成功值（stale-while-revalidate，弱化显示并标注获取时间）
  • 凭据：经 ctx.credentials.resolve() 读取 DEEPSEEK_API_KEY / SILICONFLOW_API_KEY / VISION_API_KEY / VOLCES_API_KEY

状态灯配色

场景颜色
DeepSeek / SiliconFlow 余额 < balanceWarn（默认 10 元）🔴 红
周期用量（OpenCode Go / 火山 Coding / 火山 Agent）剩余 ≤ 10%（0% = 用尽）🔴 红
周期用量剩余 ≤ 30%（预警）🟡 黄
其余正常🟢 绿

> 周期用量显示的是剩余百分比（100 − 已用），按三个窗口（5小时/周/月）中最低的剩余决定颜色——任一窗口告急即亮警示。

安装

在目标电脑的 DSH 环境执行：

dsh plugin --profile web add "github:jcleener/api-monitor"

或固定版本：

dsh plugin --profile web add "github:jcleener/api-monitor#v0.1.2"

安装后重启 dsh web，侧边栏底部即出现监控入口。插件为静态常驻：随 DSH 启动自动加载，无需在 Cordis 面板中手动启用/授权，配置持久化于 ~/.dsh/settings.yaml 与 .credentials.yaml。

> 早期「手动粘贴到 Cordis 面板」的动态版源码与恢复步骤保留在 [legacy/](./legacy/)，已不推荐使用。

配置

设置命名空间 api-monitor（DSH 设置页或 ~/.dsh/settings.yaml）：

键默认说明
volcesAccessKeyId / volcesSecretAccessKey空火山引擎 AK/SK（配额查询专用，与推理用 VOLCES_API_KEY 不同；role('secret') 脱敏）
volcesTierauto火山档位（auto/lite/pro，Agent Plan 另含 small/medium/large/max）
pollIntervalSeconds60轮询间隔（秒）
warnPercent / dangerPercent70 / 90已用%阈值（用于推算剩余%的告警/危险档）
balanceWarn10余额预警阈值（元）
priceTable{}模型价格表（{ "模型ID": { pi, pcr, pcw, po } }，每 1M tokens USD）
showCacheHitRate / showResetTimetrue / false是否显示缓存命中率 / 重置时间
entryVisibility.*true各供应商是否显示在入口

火山引擎 AK/SK 配置

1. 在浮动窗的「火山 Coding Plan」/「火山 Agent Plan」区块点 key配置，输入 AccessKey ID 与 SecretKey，保存（两区块共用一份）。 2. 保存后立即重拉配额；若鉴权失败，区块会显示 ResponseMetadata.Error 中的具体错误（如 SignatureDoesNotMatch / AccessDenied）。 3. 需要 IAM 具备用量查询权限；SigV4 使用 region=cn-beijing、service=ark。

关于 SiliconFlow 余额

硅基流动新云平台（cloud.siliconflow.cn）的网页钱包余额不通过 API 暴露：/v1/user/info 仅反映 API-key 归属账号的旧口径余额。插件显示的是接口真实返回值；网页上的 45+ 之类的余额请以控制台为准。

工作原理

  • Host 半段（lib/index.js）常驻 dsh web 进程：

- 注册 api-monitor 配置命名空间（真实 schemastery schema，role('secret') 原生脱敏）； - 60s 轮询 5 家数据（原生 fetch；火山 SigV4 用 crypto.subtle 计算 HMAC-SHA256）； - 聚合会话树 token/花费（sessionProjections.tokenUsage + assistant/message 事件按供应商分桶）；

- 经 webServer.register 暴露同源路由：/api-monitor/snapshot|config|refresh|set-volces-keys|set-tier|set-visibility。

  • Client 半段（lib/client.js）以 window.__ModuleLoader__.load factory 加载，注册 sidebar.footer.action 槽（order -20），数据经 fetch 同源路由获取。

开发 / 结构

lib/index.js      Host 半段（ESM，原生 fetch + crypto.subtle）
lib/client.js     Client 半段（__ModuleLoader__ factory，React.createElement）
cordis.patch.yml  加载器补丁层（insert 声明）
package.json      包清单（dsh.client 声明浏览器端打包）
PRD.md            产品需求文档
legacy/           早期动态版源码

本地联调：改动 lib/ 后 HMR 热载（客户端 CSS/JS 变更约 1s 生效）；宿主代码与补丁层变更需重启 dsh web。

更新日志

v0.1.3

  • 修复会话花费高估（约 2 倍）：单价表改为人民币口径，DeepSeek 走官方定价页自动抓价（api-docs.deepseek.com/zh-cn/quick_start/pricing，正则解析 v4-flash/v4-pro 峰谷价，6h 缓存，随【读取套餐】强制刷新）。此前缓存命中按 ¥0.20/M 计价（实际 ¥0.05–0.1），是 agent 编码会话花费高估的主因。
  • 花费展示改为预估区间：峰谷定价无法按请求时刻归因，显示「会话花费预估：梁文峰 ¥X | 梁文谷 ¥Y」（高峰/空闲各一档）；平铺价显示单值。
  • 重试去重：会话 token 统计按 (turn,step) 取最后一次 usage，避免同一逻辑调用（重试/失败重发）被重复计费。
  • SiliconFlow 价格仍为内置种子值（DeepSeek-V4-Flash ¥1/¥2）+ 可在 settings 的 priceTable 覆盖；未知名模型显示「—」。

v0.1.2

  • 修复状态灯方向：周期用量（OpenCode Go / 火山 Coding / 火山 Agent）按剩余%上色——剩余 ≤10% 红、≤30% 黄、否则绿（此前按剩余越高越红，与"0% = 用尽"语义相反）。

v0.1.1

  • stale-while-revalidate：数据拉取中或失败时，保留并显示上次成功读取的数据（弱化显示并标注「↑ 显示上次数据（HH:MM 获取）」），恢复成功后自动切回实时。

v0.1.0

  • 首个公开版本：常驻 API 用量监控（DeepSeek / SiliconFlow / OpenCode Go / 火山引擎 余额与配额、会话树 token 与花费，侧边栏入口 + 独立浮动窗）。

许可证

MIT © 2025 jcleener

Back to searchOpen GitHub repository

More related plugins

View category