marisa-4219/deepseek-harness-quota-monitor

deepseek-harness-quota-monitor

DeepSeek Harness 多供应商额度监控插件。侧边栏实时卡片 + 「设置 → 插件」可视化配置，支持余额型（主动查询供应商 API）与限额型（本地滑动窗口计量）两类额度模型。

本版本适配 DSH 0.1.7-alpha.1 起的插件接口：设置 schema 改为导出 Config 声明式注册（不再有 installSection），配置页注册到插件管理页的 plugins.item 插槽，配置改写入 profile 的 cordis.patch.yml（settings.yaml 已被上游移除）。旧版（0.1.5-rc.1 及更早）的 installSection / settings.plugin.item 接口在本版本已不适用。

特性

• 余额型：主动查询供应商余额/用量 API（地址 + API Key 引用 + JS 解析器），如 DeepSeek 官方 GET /user/balance
• 限额型：本地滑动窗口用量统计（5h / 7d / 1m 等，按 llm/stream 瀑布采集真实 token 用量，持久化到 $DSH_HOME/storages/quota-monitor-usage.jsonl），对照配额上限显示剩余
• 今日已用：自然日桶，跨重启保留；主数字含缓存（输入 + 输出 + 缓存读），附输入/输出/缓存分项与缓存命中率（3 位小数）
• 翻转卡片：点击今日已用区翻转 3D 卡片，查看输入/输出/缓存三线小时折线图（平滑曲线、峰值标注）
• 自动发现：有确定预设的官方供应商（DeepSeek、OpenCode GO、Command Code 等）自动进入监控；无预设的自建网关不自动发现，需手动添加
• 逐个启用/禁用：自动发现与手动配置的每个供应商都可单独暂停/恢复监控（即时生效，配置保留）
• 预设一键添加：deepseek-official / opencode-go / commandcode / new-api / sub2api 等整体方案，选中即填好 kind/url/解析器
• 金额按供应商实报：供应商在 usage 里返回价格才显示金额（无价格表、不推断），按模型明细展示
• 供应商显示名：卡片打印人类可读的名字（路由声明的 displayName，或配置的 label），而不是 commandcode 这类路由 id；两者在悬停提示里同时可见
• 刷新有反馈：点卡片立刻出现转圈指示并短暂锁定按钮，不再依赖一闪而过的顶部横幅
• 消耗动画：每次模型调用从卡片飘出一个 -N 并轻微抖动，连续消耗连续抖；设置页可关闭
• 限流事件：模型请求被 429 限流时记录 retry-after，随快照返回
• 主题适配：明/暗色均使用产品 token，暗色下更贴近页面背景

UI 两处：侧边栏设置按钮上方的圆角卡片（sidebar.footer.action，点击刷新，5 分钟自动轮询）、插件管理页「Plugins」中的额度监控页（plugins.item，仅当 Host 正在提供 quota-monitor 命名空间时注册）。

安装

从 npm registry 安装（推荐）：

dsh plugin --profile web add deepseek-harness-quota-monitor
# 然后重启 dsh web 服务

dsh plugin 会把参数转发给 pnpm，包名会从 npm registry 拉取。若本机 pnpm 不在 PATH 导致失败，可用 corepack 手动安装（效果相同，之后需手动把包名追加进 profile package.json 的 dsh.profile.bundles）：

corepack pnpm --dir "$DSH_HOME/profiles/web" add deepseek-harness-quota-monitor

开发模式（本地目录安装，改动即时生效）：

dsh plugin --profile web add <本仓库路径>

安装后 profile 的 package.json 应形如：

{
  "dependencies": { "deepseek-harness-quota-monitor": "link:<本仓库路径>" },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "deepseek-harness-quota-monitor"   // ← 必须在这一层里，否则插件不会被挂载
      ],
      "patchReload": "live"
    }
  }
}