前言¶
在使用 DeepSeek API 进行开发或构建智能体工作流时，实时监控账户余额以及不同 Provider 的 Token 消耗是控制成本和排查问题的关键。现有的仪表盘往往难以在一个界面中聚合所有 Provider 的用量数据，且余额查询接口可能分散。这个插件通过一个可拖动、可折叠的悬浮面板，将 DeepSeek 开放平台的账户余额与今日所有 Provider、所有模型的 Token 用量汇总展示在 DeepSeek Harness Desktop 的界面中。
插件简介¶
该插件由开发者 Hades03 维护，采用 MIT 许可证。它基于上游项目 dsh-cost-meter 1.5.38 定制，复用本地账本以保留历史数据。插件主要提供两个维度的统计：一是 DeepSeek 官方平台的账户余额，二是本地所有 Harness Provider 的 Token 消耗明细。
核心功能¶
- 余额查询：只显示 DeepSeek 开放平台账户余额，公开运行版仅访问官方余额接口。
- Token 汇总：汇总今日所有 Provider、所有模型的 Token 使用情况。
- 明细展示：按 Provider / 模型列出输入 Token、缓存读取、缓存写入、输出和合计 Token。
- 交互控制：支持“全部 / DeepSeek”筛选和手动刷新；面板支持拖动并自动记忆位置。
- 边缘锚定：使用屏幕边缘锚定，展开与收起时位置不会发生漂移。
- 恢复默认：双击标题栏或收起后的悬浮条可恢复默认右下角位置。
- 自动刷新：60 秒自动刷新本地统计。
- 历史复用：复用
~/.dsh/storages/cost-meter/ledger.json，保留已有历史记录。 - 推理 Token 处理：推理 Token 单独显示在模型详情中，不计入合计，避免部分 Provider 已将推理 Token 包含在输出时发生双计。
安装与启用¶
在终端中执行以下命令安装插件：
dsh plugin --profile web add "github:Hades03/dsh-model-quota-usage"
安装或更新后，需要重启 DeepSeek Harness Desktop 应用。
使用说明¶
- 启动应用后，右下角会出现悬浮面板。
- 面板加载完成后，可以看到 DeepSeek 账户余额以及今日总 Token 用量。
- 点击筛选按钮，可以在“全部”和仅“DeepSeek”模型之间切换。
- 拖动面板标题栏可调整位置，面板会自动吸附到屏幕边缘。
- 双击标题栏可将面板重置到默认右下角。
- 面板会每 60 秒自动刷新本地统计数据。
适用场景与注意事项¶
- 版本要求：需确保 DeepSeek Harness 版本 >= 0.1.1-rc.2，环境 Node.js >= 20。
- 数据范围：Token 统计覆盖 DeepSeek、Kimi、GPT、GLM、Claude 等所有 Harness Provider，但不会查询这些 Provider 的账户余额（仅查询 DeepSeek 余额）。
- 数据隐私：Token 账本只保存在本机，不包含遥测，不上传会话标题或 Token 历史。
- 依赖服务：DeepSeek API Key 由 Harness 凭据服务读取。
