AnnanRen/dsh-usage-suite

dsh-usage-suite

awesome · DSH plugin

DeepSeek Harness（DSH）用量可视化套件：两个互补的插件，把你的模型用量和套餐额度一眼看清。

| 插件 | 形态 | 一句话 |
|---|---|---|
| dsh-usage-zcode | 侧边栏入口 + 弹窗 | ZCode 风格的用量统计与套餐用量看板 |
| dsh-codingbar | 会话头部状态栏 | 常驻状态条实时显示套餐额度与上下文用量 |

两者可独立安装，也可组合使用；共享同一套凭据配置。

dsh-usage-zcode — 用量统计与套餐用量弹窗

ZCode 风格的使用统计与套餐用量弹窗，侧边栏「设置」上方两个入口，点开即看。

套餐用量（双套餐切换）

套餐用量 · 智谱 Coding Plan

套餐用量 · OpenCode

用量统计

用量统计 · 概览

用量统计 · 趋势与模型占比

功能

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

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

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

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

安装

dsh plugin --profile web add github:AnnanRen/dsh-usage-suite#path:plugins/dsh-usage-zcode

刷新页面即生效，无需重启。侧边栏收起时两个入口显示为图标。

dsh-codingbar — 会话状态栏

常驻在会话头部的窄状态条，实时显示两个套餐额度与当前会话上下文用量，点击展开详情卡。

状态条

详情卡片

功能

- 当前窗口：会话上下文 X万/100万（N%） + 近 5 小时用量曲线 + 模型名 + 缓存命中率
- 智谱 GLM Coding Plan（Max/Lite 档位徽章）：5 小时 / 每周 / MCP 月度额度，剩余百分比 + 重置时间 + 倒计时
- OpenCode GO：rolling 5 小时 / 每周 / 每月额度
- 剩余 <20% 变黄、<5% 变红

安装

dsh plugin --profile web add github:AnnanRen/dsh-usage-suite#path:plugins/dsh-codingbar

安装后需重启 dsh web（插件随服务端进程加载）。读取会话上下文需要 zstd CLI（macOS：brew install zstd）。

详见 plugins/dsh-codingbar/README.md。

凭据配置（两个插件共用）

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

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

未配置时显示引导性提示，不阻塞其他功能。

数据来源与隐私

- 应用用量（usage-zcode / codingbar 上下文曲线）：来自本机 DSH 持久化会话日志，不发起网络请求
- 套餐额度：分别请求 open.bigmodel.cn/api/monitor/usage/* 与 opencode.ai/zen/go/v1/usage，仅携带你自己的 API Key，带 1–5 分钟缓存
- tokens 口径：输入 + 输出 + 缓存读写 + 推理
- 不收集、不上传、不向第三方存储任何统计数据

声明

- 本项目为社区开源作品，与 DeepSeek、Z.ai / 智谱（BigModel / ZCode）、OpenCode 均无关联，未获得任何一方授权或背书
- "ZCode" 仅用于描述界面风格的参考来源；界面为独立实现，未使用 ZCode 的任何代码、图标、素材或 Logo
- 用量接口为非官方文档化的公开端点，如上游调整，插件可能需要跟随更新

License

MIT