dsh-usage-suite

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

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

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

---

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

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

套餐用量（双套餐切换）

用量统计

功能

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

• 智谱 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