deepseekplugins

DeepSeek Harness 插件

dsh-usage-hud

DSH 用量悬浮面板：右下角常驻多 Tab HUD（实时 token / 会话记录 / 今日 / 历史 / 热力图 / 24h 曲线 + 费用估算），Host 半从持久化会话日志聚合跨会话历史，零 npm 依赖。（英文原文）

记忆
跳到安装方式

来源信息

GitHub 仓库
ksk2023/dsh-usage-hud
最近更新
2026年8月16日
分类
记忆
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/ksk2023/dsh-usage-hud
插件名：dsh-usage-hud
作者：ksk2023

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-usage-hud

> DSH（DeepSeek Harness）用量悬浮面板 — 右下角常驻多 Tab HUD：实时 token、会话记录、今日汇总、历史统计、使用热力图、24 小时曲线，外加按模型估算的费用。 > > A always-on usage HUD for DeepSeek Harness: live tokens, session records, daily totals, history, GitHub-style heatmap, 24-hour curve, and per-model cost estimation — docked in the bottom-right corner of the Web GUI.

![npm](https://www.npmjs.com/package/dsh-usage-hud) ![license](./LICENSE)

---

✨ 功能

面板固定在 Web GUI 右下角（可折叠），六个 Tab：

Tab内容
实时当前会话累计 token 四项（输入未命中缓存 / 缓存命中 / 缓存写入 / 输出）、上下文压力条（>80% 告警变色）、上下文构成（system / tools / messages 三色分栏）、费用估算
会话全部会话记录（自动登记，含子代理标记），按最近活动倒序；展开看详情：创建时间、轮次/请求数、平均每轮用量、分项 token、分模型用量、费用
今日今日汇总卡片（token 总量、请求数、会话数、估算费用）+ 24h 分布迷你条
历史按月汇总 + 按日明细 + 全部总量与总费用
热力图类 GitHub 贡献图；默认近 1 年，可切 1 周 / 1 月 / 半年 / 1 年 / 全部；悬停看当日明细（token / 请求 / 费用）
24h0–23 时用量柱状图，峰值小时高亮；前后翻日；点击热力图某天自动联动查看该日曲线

特性：

  • 重启不丢数据 — 历史统计从 DSH 持久化会话日志（JSONL）重算，无需插件自建数据库
  • 统计与官方口径一致 — 聚合采用 @deepseek-ai/dsh-token-meter 相同的折叠规则（同 turn/step 用量样本替换而非累加），费用按每请求实际模型逐笔估算
  • 零 npm 依赖 — Host 半为纯 JS（手动 typert 注册 + duck-typed Remote 绑定），Client 半为自包含 __ModuleLoader__ bundle
  • 只读、本地 — 不写任何会话数据、不联网上报

📦 安装

需要 DSH ≥ 对应 web profile（含 dsh plugin 命令）与 pnpm：

dsh plugin --profile web add dsh-usage-hud

然后重启 dsh web，面板自动出现（无需会话内 define / 审批）。

升级（用户侧，一行 + 重启 dsh web）：

dsh plugin --profile web update dsh-usage-hud
# 跨大版本：dsh plugin --profile web add dsh-usage-hud@latest

卸载：

dsh plugin --profile web remove dsh-usage-hud

本地开发（link 模式，改源码即生效）：

git clone https://github.com/ksk2023/dsh-usage-hud.git
cd dsh-usage-hud
dsh plugin --profile web add .

🚀 发布新版本（维护者）

npm version patch        # 0.2.0 → 0.2.1：改版本号 + 提交 + 打 tag（patch/minor/major）
git push --follow-tags   # 推 GitHub
npm publish              # 发 npm（2FA 需 --otp=xxxxxx）

用户侧执行上面的 update 即升到新版本。注意：

  • npm 不允许重复发布同一版本号，每次发布前必须 bump
  • Host 半（lib-host/）与组合变更需重启 dsh web 生效；Client 半（lib/client.js）重启后必然生效
  • link 方式安装的开发副本改代码重启即生效，无需发版

🔧 工作原理

┌─ Client（浏览器）─────────────────┐      ┌─ Host（DSH 进程）──────────────────┐
│ shell.overlay 悬浮面板（6 Tab）    │ RPC  │ usagePanel Remote 服务             │
│  实时 Tab ← sessions 投影          │ ───▶ │  summary()  跨会话/按日/按模型聚合 │
│  其余 Tab ← usagePanel/summary     │/api  │  hourly(date) 指定日小时曲线       │
│            ← usagePanel/hourly     │      │  数据源：sessionQuery 重放持久日志 │
└───────────────────────────────────┘      └───────────────────────────────────┘
  • 实时数据：读取官方 token-meter 投影（tokenUsage / contextPressure / contextBreakdown）
  • 历史数据：Host 半经 sessionQuery.readSession() 重放全部会话日志，折叠出与会话内 tokenUsage 完全一致的累计值，再按本地日期 / 小时 / 模型分桶
  • 通信：静态 Remote 通道（connection.rpc.call('/api', 'usagePanel/*')），Host 侧手动 ctx.typert.register() + duck-typed typertRemote 绑定（typert-loader 文档保留的手写路径，codec 全部 src-json）
  • 费用估算：内置 DeepSeek 官方定价表（2025-09，美元 / 1M tokens）；未收录模型显示 —，可在 lib/client.js 顶部 PRICING 中自行补充

仓库结构：

lib/client.js       浏览器半（__ModuleLoader__ bundle）
lib-host/index.js   Host 半（聚合 + Remote 服务）
cordis.patch.yml    profile 组合行（dsh.plugin add 自动挂载）
src/usage-panel/    开发源与工具（动态版原型、离线验证脚本）
docs/               设计文档与生态调研

📊 数据口径说明

  • token 四桶与 DSH 官方 tokenUsage 投影一致：输入未命中缓存、输入缓存命中、缓存写入、输出（推理 tokens 计入输出）
  • 「上下文构成」为启发式估算（system / tools / messages），三数之和不等于总量属正常
  • 费用为估算值（面板底部有「非账单」提示），以模型提供商实际账单为准

🙏 相关项目

  • dsh-usage-panel（AlfredChaos）— 同领域的设置页版消耗统计（KPI + 热力图 + 模型图表）；本插件是悬浮 HUD 形态的独立实现，两者可共存

License

[MIT](./LICENSE)

返回搜索打开 GitHub 仓库

更多相关插件

查看分类