dsh-usage-zcode

DeepSeek Harness（DSH）用量统计插件：ZCode 风格的使用统计与套餐用量弹窗，侧边栏一键查看。

本机用量热力图、按模型 Token 趋势、模型占比环形图 + 智谱 GLM Coding Plan / OpenCode GO 双套餐实时额度，数据全部来自本机会话日志与两家官方接口。

效果截图

套餐用量（双套餐切换）

用量统计

功能

侧边栏「设置」按钮上方新增两个入口（侧边栏收起时显示为图标）：

📦 套餐用量（上方按钮）— 顶部两个套餐按钮切换：

• 智谱 Coding Plan（BigModel）
  • 剩余额度三卡：5 小时 / 每周 / MCP（剩余百分比 + 白色进度条 + 重置时间）
  • 用量趋势：当日 / 7日 / 30日 切换，Token 消耗总量 + 各模型用量卡片 + 平滑折线图
  • 工具用量：联网搜索等 MCP 调用次数
• OpenCode（GO 套餐）
  • 剩余额度三卡：5 小时滚动 / 每周 / 每月
  • 模型趋势：本机会话统计（OpenCode 暂无官方按模型接口）；工具用量显示空态

📊 用量统计（下方按钮）— 时间范围（最近 7 天 / 最近 30 天）：

• 六张统计卡：tokens 用量 / 会话数量 / 消息数量 / 活跃天数 / 当前连续天数 / 最常用模型（占比）
• 活跃热力图（26 周，较少→较多四级色阶，悬停显示当日明细）
• 按天 Token 趋势（按模型堆叠柱状图 + 图例）
• 模型用量（环形图 + 明细列表 + 占比）

安装

要求：DSH（@deepseek-ai/dsh）已可运行；已配置下方凭据。

## 凭据配置

插件通过 DSH credentials 服务读取密钥（不落盘、不出本机）：

| 凭据名 | 用途 | 获取方式 |
|---|---|---|
| `ZAI_CODING_CN_API_KEY` | 智谱 Coding Plan 额度/用量 | [bigmodel.cn](https://bigmodel.cn) 控制台 API Key |
| `DEEPSEEK_API_KEY` | OpenCode GO 额度 | [opencode.ai/auth](https://opencode.ai/auth) API Key |

未配置时弹窗显示引导性错误提示，应用用量部分不受影响。