前言¶
DeepSeek Harness (DSH) 采用插件化架构,但在 Web 端缺乏官方用量查询接口。开发者需要实时追踪 Token 消耗、费用与模型构成时,往往需要依赖第三方工具或手动计算。dsh-mimo-quota 插件通过监听本地流式事件,为 DSH Web 端提供实时用量面板。
安装¶
在 DSH 插件管理器或设置中,使用以下任一方式安装:
# 通过 git URL 安装
git https://github.com/hbgdjb/dsh-mimo-quota.git
# 或通过 registry 包名安装
npm install dsh-mimo-quota
安装后需重启应用,插件将自动写入 manifest 并在当前 profile 生效。
环境要求与配置¶
本插件需运行在 DeepSeek Harness 0.1.x Web 端。安装成功后,可在 profile 的 cordis.patch.yml 中配置以下参数:
| 字段 | 说明 | 默认 |
|---|---|---|
storageFile |
用量记录 JSON 路径 | <profile>/mimo-quota-usage.json |
currency |
展示货币符号 | ¥ |
pricing |
牌价覆盖(default + models,单位 ¥ / 百万 tokens) |
内建小米牌价 |
数据存储文件采用 v2 结构:{ version: 2, records: [...], sessions: { id: { title, dir } } }。
核心功能¶
- 实时用量面板:展示 Token 用量、消费金额、API 请求数、输入/输出 tokens,并提供趋势图与模型构成。
- 交互控制:支持切换模型、统计粒度、时间范围(如 30 秒自动刷新或手动刷新)及统计范围(全部/项目/对话)。
- 定价系统:内置可编辑定价面板,支持修改默认价及各模型价(输入/缓存命中/缓存写入/输出),支持一键重置。
- 分时段计价:针对
deepseek-flash和deepseek-v4-pro内建峰谷价。北京时间 09:00–12:00、14:00–18:00 为峰时,其余时段与周末为谷时。消费金额按记录时间自动套算。 - 历史数据导入:支持将 CSV 文件导入,文件需置于
<profile>/mimo-quota-import.csv,刷新页面即可合并(自动去重与去重计数)。
使用示例¶
- 修改定价:在面板中直接修改四个定价字段,保存即时生效。若需调整特定模型价格,可在 pricing 配置中添加对应模型。
- 导入历史数据:准备 CSV 文件,表头需包含
会话ID、标题、原始输入tokens、输出tokens等字段,放置于指定路径后刷新页面。
注意事项¶
- 数据来源:消费金额为按牌价与分时段规则的估算值,并非官方账单,准确金额请以官方控制台为准。
- 版本兼容:插件数据结构为 v2,且依赖 Harness 的
llm/stream流式事件本地测量。 - 日志记录:会话事件日志采用“重建 + 实时 + 60s 文件轮询”三通道记账。
参考资料¶
- GitHub 仓库:https://github.com/hbgdjb/dsh-mimo-quota