前言¶

DeepSeek Harness（DSH）在单次对话里能给出当轮的 token 用量，但日常开发更常遇到三类问题：账户里还剩多少余额、今天在本 Harness 里实际消耗了多少 token、是否接近自己设定的预算或余额下限。这三类数字来源不同——官方账户、流式响应里的 usage chunk、以及由余额快照推导的消费——若混在同一口径里展示，很容易误判。

下面介绍社区插件 dsh-deepseek-usage-monitor（维护者 MinaMiKune，分类：模型推理）。它在 DSH 左侧栏提供面板，用官方接口展示账户余额，用本 Harness 对 llm/stream 的观测展示真实 token 计数，并支持可配置阈值告警与本地历史；界面上各块数字均标注数据来源，且官方余额、本地观测、估算费用、余额差值四类指标互不相加。

第三方社区插件，与 DeepSeek 官方无关；仅调用公开 API 与 DSH 自身服务，不抓取控制台、不模拟登录。

这是什么¶

DeepSeek Usage Monitor 是面向 DSH 0.2.x 的纯 ESM 插件（package.json 版本 1.0.0，MIT 许可）。它解决的是「余额、本进程用量、账户级消费推导、按模型估算费用」分开展示与告警的问题，并提供 Agent 工具 deepseek_usage 与已鉴权 HTTP 快照接口，供面板与自动化共用同一套服务逻辑。

• 目录页：skillhub.cn/plugins/MinaMiKune/dsh-deepseek-usage-monitor
• 源码与文档：github.com/MinaMiKune/dsh-deepseek-usage-monitor

核心功能¶

数据来源与口径¶

插件在 README 中用表格固定了界面元素与字段标记，核心约定如下：

失败时可能保留旧值，但会显式标为「缓存值」；新鲜度有 实时 / 缓存值 / 未知 等分类。

左栏面板¶

安装并刷新页面后，左侧栏出现仪表盘图标，点击进入「DeepSeek 用量监控」面板。主要区块包括：账户余额（含通道 API Key / 已登录账户）、今日调用与 token 及估算费用、账户消费推导、可切换时间范围的 Token 用量与按模型明细、活动告警与阈值、以及固定的「数据来源」说明。面板约每 30 秒拉取快照；「刷新」可触发即时余额刷新。

Agent 工具与 HTTP¶

工具名 deepseek_usage，常用 action 包括：status、balance、usage（范围 1h/24h/7d/30d/custom）、refresh、alerts、set_thresholds / reset_thresholds、clear_history（需 confirm: true）。

HTTP（DSH 已鉴权 /api）：

• GET /api/deepseek-usage/snapshot?range=24h
• POST /api/deepseek-usage/refresh，body 如 { "scope": "all" }

告警与本地持久化¶

可配置低余额、当日估算费用、当日观测 token、连续失败次数等阈值；支持告警冷却与分类型开关。本地状态默认在 ~/.dsh/deepseek-usage-monitor/（或由 data_dir 指定），含调用记录与历史保留策略（默认 history_retention_days: 30）。

环境要求¶

安装与启用¶

官方 README 给出的获取方式有两种：克隆仓库，或下载 v1.0.0 Release 中的 dsh-deepseek-usage-monitor-v1.0.0.zip 并解压。

在 DSH 中安装该目录（Plugin Manager → 添加插件 → 本地目录，或 Agent 工具）：

plugin_manager install_bundle  target = <插件目录>

安装会登记 profile、读取 cordis.patch.yml 注册 Loader、Host 侧注册工具与 /api 并挂载流式观测、浏览器侧注册侧栏与主面板。完成后刷新页面即可看到侧栏图标。

启用 / 停用 / 卸载（摘自 README）：

plugin_manager set_plugin  target=include:deepseek-usage-monitor  enabled=false
plugin_manager set_plugin  target=include:deepseek-usage-monitor  enabled=true
plugin_manager remove_bundle  target=@local/dsh-deepseek-usage-monitor

清理数据可删除 ~/.dsh/deepseek-usage-monitor/（或配置的 data_dir）。修改源码后 Host 半不参与 HMR，需停用再启用或重启 DSH。

快速开始与配置¶

经过上面的安装步骤后：

1. 点击侧栏图标进入面板。
2. 若余额显示「未配置」：balance_source: auto 下，已登录 DSH 账户可走账户钱包；或设置环境变量 DEEPSEEK_API_KEY / DSH credentials。
3. 正常对话即可累积用量——插件在 llm/stream 处被动记录，不为此额外发请求。

配置写在 profile 的 cordis.patch.yml（用户层覆盖 bundle 默认），示例：

- id: deepseek-usage-monitor
  name: '@local/dsh-deepseek-usage-monitor'
  config:
    balance_source: auto
    low_balance_threshold: 20
    timezone: Asia/Shanghai

balance_source 取 auto（默认）、api-key 或 account；密钥优先经 DSH 凭据解析 api_key_env（默认 DEEPSEEK_API_KEY），其次环境变量，不推荐在配置里写明文 api_key。Plugins 页面无表单配置（插件不导出 Cordis Config schema），非法配置项会回退默认并在 configIssues 中可见。

运行期也可用工具调整阈值，例如：

deepseek_usage { "action": "set_thresholds", "thresholds": { "low_balance_threshold": 20 } }

典型用法¶

只看状态与余额（Agent）

deepseek_usage { "action": "status" }
deepseek_usage { "action": "balance" }

拉取近 24 小时用量并刷新余额

deepseek_usage { "action": "usage", "range": "24h" }
deepseek_usage { "action": "refresh", "scope": "all" }

面板等价 HTTP（需在已登录 DSH 的浏览器会话或同等鉴权下调用）：

GET /api/deepseek-usage/snapshot?range=24h
POST /api/deepseek-usage/refresh

适用场景与注意¶

适合长期在 DSH 里跑 DeepSeek 路由、需要同时盯官方账户余额与本机 Harness 真实 token、并希望阈值告警与本地趋势的用户。若 profile 通过 deepseek-account 调用模型且不持有 API Key，balance_source: auto 会落到已登录账户钱包，与常见付费账户一致。

安装前请注意：

• 插件以当前 DSH 进程的权限运行；本地观测不等于账户全量用量，跨进程或其它客户端的消费不会计入 Harness 观测。
• 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；安装前应自行阅读仓库源码与 MIT 许可证，确认凭据与 api_base_url 指向是否符合你的安全策略。
• 估算费用来自价格表与本地 token，不是账单；账户消费来自余额快照差值，无法按模型拆分。

结尾¶

DeepSeek Usage Monitor 把官方余额、Harness 观测用量、推导消费与估算费用拆开呈现，并统一到侧栏、Agent 工具与快照 API，减少 DSH 日常开发里「余额和 token 混在一起看」的口径问题。

• 目录页：https://www.skillhub.cn/plugins/MinaMiKune/dsh-deepseek-usage-monitor
• GitHub：https://github.com/MinaMiKune/dsh-deepseek-usage-monitor