dsh-key-usage：DeepSeek Harness 侧边栏里的用量与余额面板

它是做什么的？

dsh-key-usage 是 DeepSeek Harness（DSH）的用量统计插件，在侧边栏新增一项「使用情况」，把本机台账与宿主会话事件汇总成整页用量面板。它解决的是「花了多少 Token、成本多少、余额还剩多少」只能靠翻日志估算的问题，让你在 DSH 里直接按通道、项目、会话查看明细。插件由 xyl886 维护，采用 MIT 协议，以 TypeScript 编写，数据以本地只读为主，只有余额与配额会请求各通道官方接口。

核心功能

• 总览面板：列出各通道 Key 的今日、近 30 天用量与 30 天成本，并附年度活跃热力图，悬停可看当日各模型占比。
• 使用明细：支持今日 / 周 / 月 / 总计 / 自定义范围切换，展示调用次数、Tokens、成本三张统计卡与按天（单日按小时）堆叠图，每日细目可展开到模型。
• 项目与会话维度：按工作目录聚合调用、Tokens、占比、成本与最近活跃；按会话列出时间、时长、Tokens、命中率与成本，均可搜索、筛选和排序。
• 余额与配额：实时查询各通道官方余额与订阅窗口占用，失败时回落本机快照并标明数据来源。
• 隐私与安全设计：不读取凭据文件、不写任何文件、不改宿主配置，服务端端点全部为只读 GET 且仅接受回环请求。

怎么使用这个插件？

在 DSH 中启用后，左侧导航会多出「使用情况」入口，点开即是整页面板，默认展示总览的 Key 清单与年度热力图。切换到「使用明细」可用范围切换器选择今日、周、月、总计或自定义区间，再按通道筛选查看堆叠图与每日细目；「项目用量」「会话用量」两页分别按工作目录和会话聚合，支持搜索与排序。打开「余额与配额」时服务端才会联网请求官方接口，结果缓存 60 秒，点「刷新」可强制重查；若未配置 Key 或请求失败，卡片会标明回落本机快照的原因。客户端改动刷新页面即生效，服务端插件代码在宿主启动时加载，需要退出并重新打开应用。

报错怎么排查？

余额或配额卡片显示「显示本机快照」时，说明实时查询未成功，常见原因是该通道的 API Key 无法被宿主凭据服务解析或未存在于进程环境变量，按官方说明补齐凭据后重试即可。若项目、会话或按小时数据提示「数据不可用」，通常是宿主会话持久化服务缺失或读取失败，此时其余页面仍可正常使用，无需额外处理。