AnnanRen/dsh-usage-suite 预览 preview

AnnanRen/dsh-usage-suite

DeepSeek Harness 用量可视化套件:ZCode 风格用量统计与套餐用量弹窗 + 会话状态栏(智谱 Coding Plan / OpenCode GO 实时额度)

项目介绍Project Overview

DSH 用量可视化套件,含两个互补插件:dsh-usage-zcode 提供 ZCode 风格用量统计与套餐弹窗,dsh-codingbar 在会话头部常驻显示额度与上下文用量。适合实时监控套餐余量,需配置 API 密钥,且部分接口为非官方端点。 -->

A DSH usage visualization suite with two complementary plugins: dsh-usage-zcode offers a ZCode-style stats and plan modal, while dsh-codingbar keeps a persistent status bar in the session header. Use it to monitor quota and context in real time. Requires API keys; some endpoints are unofficial. -->

或使用命令行安装(适合开发者)Or use CLI install (for developers)

命令行安装CLI Install

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

AnnanRen/dsh-usage-suite 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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

上一个 Prev dsh-memory-manager 下一个 Next dsh-reloader