api-monitor
常驻 API 用量监控：DeepSeek/GLM Coding Plan/OpenCode Go/火山 Coding+Agent Plan 余额与配额，会话树 token 与花费（侧边栏入口 + 独立浮动窗）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:jcleener/api-monitor#0b8fba64a0ae589f33f351d6859dd42a3b1ea4f1Api Monitor 以 api-monitor 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH（DeepSeek Harness）插件：常驻 API 用量监控。 侧边栏底部常驻摘要 + 独立浮动窗，实时查看 DeepSeek 余额、GLM Coding Plan、OpenCode Go 与火山引擎（Coding Plan / Agent Plan）订阅配额，以及当前会话树（主会话 + 全部子代理）的 token 用量与花费。
GET api.deepseek.com/user/balanceGET {base}/api/monitor/usage/quota/limitGET opencode.ai/zen/go/v1/usageGetCodingPlanUsage / GetAFPUsage（SigV4 签名，service = ark）priceTable 覆盖）.footArea（Cordis 面板按钮上方）。宽侧栏显示竖排多行摘要（每家一行：状态色点 + 名称 + 数值，行数由「显示在入口」勾选控制）；侧栏收起（rail）时退化为圆形图标；点击弹出 Cordis 风格浮动窗（标题栏 + ✕ 关闭 + Esc 关闭 + 遮罩点外关闭）ctx.credentials.resolve() 读取 DEEPSEEK_API_KEY / BIGMODEL_API_KEY（或 ZAI_API_KEY）/ VISION_API_KEY / VOLCES_API_KEY| 场景 | 颜色 |
|---|---|
DeepSeek 余额 < balanceWarn（默认 10 元） | 🔴 红 |
| 周期用量（GLM Coding Plan / 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/，已不推荐使用。
设置命名空间 api-monitor（DSH 设置页或 ~/.dsh/settings.yaml）：
| 键 | 默认 | 说明 |
|---|---|---|
volcesAccessKeyId / volcesSecretAccessKey | 空 | 火山引擎 AK/SK（配额查询专用，与推理用 VOLCES_API_KEY 不同；role('secret') 脱敏） |
volcesTier | auto | 火山档位（auto/lite/pro，Agent Plan 另含 small/medium/large/max） |
pollIntervalSeconds | 60 | 轮询间隔（秒） |
warnPercent / dangerPercent | 70 / 90 | 已用%阈值（用于推算剩余%的告警/危险档） |
balanceWarn | 10 | 余额预警阈值（元） |
priceTable | {} | 模型价格表（{ "模型ID": { pi, pcr, pcw, po } }，每 1M tokens USD） |
showCacheHitRate / showResetTime | true / false | 是否显示缓存命中率 / 重置时间 |
entryVisibility.* | true | 各供应商是否显示在入口 |
ResponseMetadata.Error 中的具体错误（如 SignatureDoesNotMatch / AccessDenied）。region=cn-beijing、service=ark。.credentials.yaml 配置 BIGMODEL_API_KEY（国内 open.bigmodel.cn，推荐）或 ZAI_API_KEY（国际 api.z.ai），插件自动按凭据名选择端点；无需 AK/SK。GET {base}/api/monitor/usage/quota/limit（Bearer 鉴权），解析 data.limits[]：unit=3 → 5 小时滚动窗口、unit=6 → 周配额、TIME_LIMIT → 月度工具额度（有则显示），data.level 为套餐档位（lite/pro/…）。5小时|1周 剩余；未订阅或未配置时区块内显示错误提示，不影响其他区块。历史说明：v0.1.x 曾支持 SiliconFlow 余额（
/v1/user/info），因其仅反映 API-key 旧口径余额、与网页钱包不一致，已于 v0.2.0 移除。
lib/index.js）常驻 dsh web 进程：
api-monitor 配置命名空间（真实 schemastery schema，role('secret') 原生脱敏）；fetch；火山 SigV4 用 crypto.subtle 计算 HMAC-SHA256）；sessionProjections.tokenUsage + assistant/message 事件按供应商分桶）；webServer.register 暴露同源路由：/api-monitor/snapshot|config|refresh|set-volces-keys|set-tier|set-visibility。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。
GET {base}/api/monitor/usage/quota/limit（open.bigmodel.cn / api.z.ai 自动按凭据选择），显示套餐档位（data.level）与 5 小时 / 周 / 月（TIME_LIMIT，如有）三窗口剩余 %；会话 token 按供应商 glm（bigmodel / zhipu / glm / zai）分桶。凭据 BIGMODEL_API_KEY（或 ZAI_API_KEY）。entryVisibility.siliconflow 旧键在下次保存可见性时自动清理。MIT © 2025 jcleener