dsh-usage-monitor

DSH PLUGIN会话与消息

仓库 Alvin-Sun6612/dsh-usage-monitor · npm dsh-usage-monitor

会话与消息 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

DSH 侧边栏用量面板插件,按天统计本机会话 token 用量、缓存命中率与近 30 天趋势,并显示 DeepSeek 账号余额。

一句话选型结论

按资料字段整理

dsh-usage-monitor 是会话与消息类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 4 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类会话与消息 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-05 创建于 2026-11-05
README 6.9 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:Alvin-Sun6612/dsh-usage-monitor#v0.1.0
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-usage-monitor可用 npm view 查看包信息

能做什么

4 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-usage-monitor:在 DeepSeek Harness 侧边栏查看 token 用量与账户余额

  • 今日/7天/30天/累计 token 统计
  • 缓存命中率与今日明细
  • 近 30 天柱状图趋势
  • DeepSeek 余额卡片

适用场景

存储

上游标签

deepseek-harnessdsh-plugintoken-usageusage-monitor

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-11): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在会话与消息场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-usage-monitor当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
dsh-desktop L3 · 安装规范通过 低风险 3.0 万 未标注 无
openpets L4 · 沙盒安装通过 低风险 1,274 未标注 有
deeptide L4 · 沙盒安装通过 低风险 1,104 0.1.1-rc.2 有
jingyun-dsh L3 · 安装规范通过 低风险 1,004 未标注 有
study-mate 未做沙盒验证 未标注 856 未标注 无

仓库档案

会话与消息
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Alvin-Sun6612仓库 dsh-usage-monitor · 默认分支 main
分类会话与消息desktop
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-05 · 2026-11-05最后推送 2026-11-05
本站收录2026-11-05首次进入本站目录的时间

README 全文

6.9 KB
作者原文,中文版优先;只做安全转义,不改内容

dsh-usage-monitor · 用量与余额

DSH(DeepSeek Harness)插件:在侧边栏开一个面板,按天统计本机会话的 token 用量,并显示 DeepSeek 账号余额。

  • 今日 / 近 7 天 / 近 30 天 / 累计的 token 总量、调用次数、缓存命中率
  • 今日明细:未缓存输入、缓存命中、输出
  • 近 30 天柱状图(悬停看当天数值)
  • 余额卡片:需要 DeepSeek API Key,在面板里粘贴即可(存在本机)

> 说明:余额接口 /user/balance 只认 API Key(sk-...)。如果你只在 DSH 里登录了 DeepSeek 账号,面板会显示「未配置 API Key」;去 建一个,余额就会显示。用量统计不需要 Key。

安装

方式一:本机目录(开发用)

powershell -NoProfile -ExecutionPolicy Bypass -File .\install.ps1
# 或指定 profile:-Profile web

装完重启 DSH,侧边栏出现「用量与余额」。

方式二:发给别人(推荐用 Release 里的 tgz,不需要 git、不需要 npm)

# 直接装 Release 附件(推荐)
dsh plugin --profile desktop add "https://github.com/Alvin-Sun6612/dsh-usage-monitor/releases/download/v0.1.0/dsh-usage-monitor-0.1.0.tgz"

# 手上有 tgz 文件时
dsh plugin --profile desktop add .\dsh-usage-monitor-0.1.0.tgz

# 仓库装了 git 时也可以用 GitHub 直装(pnpm 会走 git,需 allowBuilds 授权)
dsh plugin --profile desktop add github:Alvin-Sun6612/dsh-usage-monitor

市场(dshmarket)条目已准备好:data/plugins/Alvin-Sun6612__dsh-usage-monitor.yml,收录后可直接在市场里搜「用量与余额 / usage monitor」。

卸载:dsh plugin --profile desktop remove dsh-usage-monitor

它读什么、发什么

项目 说明
数据来源 ~/.dsh/sessions/<工作区>/<会话>/*.jsonl.zstd,只读
解析内容 assistant/message 事件的 usage(inputTokens / cacheReadTokens / cacheWriteTokens / outputTokens)与事件时间
本地服务 插件在 127.0.0.1:46850 起只读 HTTP 服务,只有本机浏览器页能访问(CORS 只放行 localhost)
联网 只有你配置了 API Key 后,才会请求 https://api.deepseek.com/user/balance;用量统计完全离线
Key 存放 ~/.dsh/dsh-usage-monitor.json(权限 0600),面板不回显、不记录
缓存 会话文件按 (mtime, size) 缓存解析结果;余额结果缓存 60 秒

端口被占用时,在面板底部把端口改掉即可(浏览器端记住设置);也可以在 ~/.dsh/dsh-usage-monitor.json 写 {"port": 46851}。

目录结构

dsh-usage-monitor/
├─ package.json          # dsh.bundle + dsh.client 声明,exports 四项
├─ cordis.patch.yml      # 组合包补丁:insert id=usage-monitor
├─ index.js              # Host 半:解析 zstd 会话日志 + 余额代理 + 本地 HTTP 服务
├─ client.js             # 浏览器半:侧边栏面板(无构建,React.createElement)
├─ locale/{zh,en}.json   # 面板名与描述
├─ icon.svg / icon.png   # 图标
├─ install.ps1           # 一键安装(UTF-8 BOM)
└─ test/smoke.mjs        # 契约测试:node test/smoke.mjs

开发与自测

# 1. 不用 DSH 直接起 Host 半,浏览器/curl 访问
node index.js
# http://127.0.0.1:46850/health
# http://127.0.0.1:46850/summary?days=30
# http://127.0.0.1:46850/balance

# 2. 浏览器半契约测试(19 项)
node test/smoke.mjs

/summary 返回结构(节选):

{
"sessions": 22, "scanned": 22, "parsed": 22, "scanMs": 465,
"today":  { "requests": 525, "totalTokens": 43301332, "cacheHitRate": 0.982 },
"last7":  { "...": "同上结构" },
"last30": { "...": "同上结构" },
"allTime":{ "...": "同上结构" },
"series": [{ "date": "2026-11-05", "totalTokens": 43301332 }]
}

改个名字 / 换成自己的功能

  1. package.json:name、description、keywords、repository 换成你的;dsh.bundle.patch 保持不变。
  2. cordis.patch.yml:id 与 name 与包名保持一致。
  3. client.js:NS、PANEL_ID、PORT_KEY、CSS 前缀 dsh-um-* 建议一起换,避免和别的插件撞。
  4. locale/*.json 的 meta.title / meta.description 就是市场卡片文案。

发布给别人

1) npm

npm publish            # 需要先 npm login,且 package.json 里有 repository

发布后别人 dsh plugin --profile desktop add dsh-usage-monitor 即可。

2) 直接给 tgz

pnpm pack              # 产出 dsh-usage-monitor-0.1.0.tgz,发文件给对方

3) 上架 DSH 插件市场(dshmarket)

> 结论:不要给 dsh-market 仓库提 PR,也不要手改 README / plugins.json / index.json —— 它们都是 CI 生成的。
> 唯一动作:往 提交一个新文件 data/plugins/Alvin-Sun6612__dsh-usage-monitor.yml。

前置条件(缺一项 CI 会红):

  • [ ] 插件已放在你自己的 GitHub 仓库里(本目录内容推到仓库根目录)
  • [ ] package.json 声明了 dsh.bundle(本插件已有)
  • [ ] 仓库根目录有 cordis.patch.yml(已有)
  • [ ] 仓库创建满 1 天,且加了 dsh-plugin topic
  • [ ] 代码真实可用(不是占位)

条目模板(放到 data/plugins/Alvin-Sun6612__dsh-usage-monitor.yml):

url: https://github.com/Alvin-Sun6612/dsh-usage-monitor
name: Alvin-Sun6612/dsh-usage-monitor
category: usage
description:
en: 'Token usage monitor: shows token usage and the DeepSeek account balance in a panel.'
zh: '用量监视器:在面板中显示 token 用量与 DeepSeek 账号余额。'
  • category 用 usage;描述里 : 必须加引号;icon 可选,只能是 GitHub 托管的 png/jpg/webp(svg 不收)。
  • 一个 PR 最多 3 条。合并后站点与市场自动重建,通常一天内可搜到;不发 npm 也能收录(市场里显示 dsh plugin --profile web add github:Alvin-Sun6612/dsh-usage-monitor)。

常见问题

现象 原因 / 处理
面板提示「读不到本地服务的数据」 插件没随 DSH 重启加载,或 Host 半端口被占。重启 DSH;必要时在面板底部改端口
余额一直是「未配置 API Key」 用的是账号登录而非 API Key。去 platform.deepseek.com 建 Key 粘贴进面板
余额显示 HTTP 401 Key 无效或已被删除;重新生成
今日用量为 0,但确实在用 面板按本机时区分桶;刚产生的调用需要点「刷新」清缓存
中文乱码 / JSON 解析失败 PowerShell 5.1 读文件要加 -Encoding UTF8;.ps1 存成 UTF-8 with BOM
装完看不到入口 Desktop 版 profile 固定为 desktop;确认 ~/.dsh/profiles/desktop/package.json 的 dsh.profile.bundles 含 dsh-usage-monitor

License

MIT

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-usage-monitor 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:Alvin-Sun6612/dsh-usage-monitor#v0.1.0` 即可。对应的 npm 包名是 `dsh-usage-monitor`。

dsh-usage-monitor 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-usage-monitor 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-usage-monitor 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-usage-monitor 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-usage-monitor 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-usage-monitor 有哪些功能?

今日/7天/30天/累计 token 统计、缓存命中率与今日明细、近 30 天柱状图趋势、DeepSeek 余额卡片。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

7 条
不同作者的仓库分开列,请确认你要装的是哪一个
会话与消息
按星标排序,可作替代方案

dsh-desktop

dsh-desktop

为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。

L3 · 安装规范通过 3.0 万 星

openpets

openpets

L4 · 沙盒安装通过 1,274 星

deeptide

deeptide

L4 · 沙盒安装通过 1,104 星

jingyun-dsh

jingyun-dsh

井云 DSH 客户端插件,为 DeepSeek Harness 注入会员登录、订阅支付、算力管控与应用市场,让智能体和技能快速变成可交易商品

L3 · 安装规范通过 1,004 星

study-mate

study-mate

StudyMate 是 DSH 的「学习模式」预设与技能包,为数学、计算机科目定制学习路线、讲解课件与练习评估,跨科目共享记忆。

未标注验证等级 856 星

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-11。