K
dsh-usage-panel
kai-githubaccount/dsh-usage-panel
세션 헤더에 DeepSeek 잔액과 세션별 토큰 사용량을 표시합니다. 3단계 잔액 경고와 편집 가능한 임계값, 원클릭 충전 링크, 캐시 적중 통계가 포함된 분할 토큰 바, 화면 표시 상태를 고려한 폴링을 제공합니다.
설치
dsh plugin --profile web add github:kai-githubaccount/dsh-usage-panelREADME
dsh-usage-panel
English | 简体中文
为 DSH（DeepSeek Harness） Web 界面提供 DeepSeek 账户余额与本会话 Token 用量，以彩色胶囊显示在会话头部右侧。
功能
- 余额：官方
GET /user/balance，显示总额 / 充值 / 赠送。 - Token 用量：读取宿主
tokenUsage投影，显示未缓存输入 / 缓存命中 / 缓存写入 / 输出 / 合计 / 缓存命中率。 - 三级余额预警（阈值可自定义）：充足 / 警告 / 不足，胶囊与卡片颜色随之变化。
- 充值入口：去充值 / 用量明细 / 登录平台 / 复制链接；支持新标签、当前标签、复制链接三种打开方式。
- 查询效率：仅在页面可见时轮询（隐藏暂停）、失败指数退避、宿主 30s 缓存 + 单飞、手动刷新。
- 跨版本兼容：宿主端优先
ctx.connection.fetch并回退ctx.webServer；浏览器端依次尝试会话头部插槽。
安装
方式一：作为插件包安装（推荐）
dsh plugin --profile web add dsh-usage-panel
方式二：本地安装脚本
node install.mjs --home ~/.dsh --profile web
重启 dsh web（或等待热重载）后刷新页面。
配置（宿主端）
apply(ctx, config) 可读取 patch 行中的可选配置：
| 字段 | 默认值 | 说明 |
|---|---|---|
routePath | /api/usage-panel/balance | 宿主端路由 |
cacheMs | 30000 | 上游缓存与单飞窗口 |
apiKeyEnv | DEEPSEEK_API_KEY | 经 ctx.credentials 解析，再回退环境变量 |
baseUrl | https://api.deepseek.com | 服务商地址 |
baseUrlEnv | DEEPSEEK_BASE_URL | 覆盖 baseUrl 的环境变量 |
兼容性
- 宿主端：Node >= 18，零
import，可从任意路径加载；优先ctx.connection.fetch.register，回退ctx.webServer.register；密钥优先走ctx.credentials。 - 浏览器端：仅依赖内置 React 与
slots服务；优先conversation.session.header.utilities，其次conversation.session.header.corner，sidebar.footer.action为延迟 4 秒的兜底，因此正常启动不会跑到左下角；缺少useProjection时仍显示余额。 - 纯 JS、无平台相关代码，跨机型通用。
自检
node tools/verify.mjs --port 3080 --home ~/.dsh
输出启动图、HMR 通道与服务包特性。
卸载
删除 profile patch 中的 usage-panel 行，并删除 <home>/plugins/dsh-usage-panel。
作者
Mysterious Mark