dsh-usage-monitor

DSH PLUGIN工具与能力

仓库 Dekurri/dsh-usage-monitor · npm dsh-usage-monitor

工具与能力 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 提供侧栏用量仪表盘,汇总全部会话的 token 用量、成本估算、缓存命中率与分模型统计,并监控本机 CPU/GPU/内存,支持与平台账单对账。

一句话选型结论

按资料字段整理

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

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

安装

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

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 >=20;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

dsh-usage-monitor:DeepSeek Harness 左侧栏用量与成本仪表盘

  • 全量 token 用量与成本估算
  • 缓存命中率与对话性能指标
  • 分会话、分模型明细统计
  • 实时 CPU/GPU/内存监控
  • 平台账单对账与余额账本

上游标签

cost-trackingdashboarddeepseek-harnessdshdsh-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),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-usage-monitor当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
huashu-design 未做沙盒验证 未标注 3.0 万 未标注 有
loopx 未做沙盒验证 未标注 6,233 未标注 无
agy-staff 未做沙盒验证 未标注 870 未标注 有
dsh-startup-screen 未做沙盒验证 未标注 633 未标注 有
minara-skills L4 · 沙盒安装通过 中风险 360 未标注 有

仓库档案

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

README 全文

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

dsh-usage-monitor · DSH 使用量监控

> 给 DeepSeek Harness 用的左侧栏仪表盘插件:把全部会话的 token 用量、成本估算、
> 缓存命中率、对话性能、分模型统计,和本机实例的实时运行状态(CPU / GPU / 内存 / 运行时长)放进一个面板,
> 并额外提供与 DeepSeek 开放平台账单的对账能力。纯本地运行,不上报任何数据。

Topics: dsh-plugin · deepseek-harness · usage-monitor · token · cost

侧栏图标 → 主面板
├─ KPI          总 Token / 成本(¥,$ 为派生) / 会话数 / 活跃会话 / 缓存命中率 / 请求数
├─ 对账条       全量调用口径 vs 平台账单
├─ 趋势         堆叠柱(未缓存输入/缓存读/缓存写/输出)+ 构成饼图 + 模型占比饼图
├─ 实时          CPU / GPU / 内存 / RSS / heap / 运行时长(2s 轮询 + 60 点 sparkline)
├─ 分会话       可排序、可搜索:token、命中率、TTFT、token 速度、时长
├─ 分模型       请求数、token 分桶、成本
├─ 对话性能     TTFT 分位、平均输出速度、工具耗时占比
├─ 全量调用     按 purpose(对话/压缩/标题/其他)与模型拆分
├─ 平台账单     余额、今日/昨日/7d/30d 消费、采样覆盖度(不全时金额前加 ≥)
├─ 账单历史     日柱状图,覆盖余额账本记录的每一天,含安装本插件之前
└─ 设置与计费规则  官方价表、高峰/谷价时段、法定节假日、汇率位、板块显隐勾选

特性

  • 一个面板看全量:会话口径 + 全量调用口径 + 平台账单口径并列,谁也不冒充谁。
  • 成本估算用官方人民币价目:元 / 百万 token,按每次调用发生的时刻判峰谷再结算;
    峰谷定义与「周末及中国法定节假日全天按谷价」完全按官方说明实现,内置 2025–2026 共 61 天法定节假日。
  • 实时汇率、央行口径:启动后异步拉取中国外汇交易中心(央行授权发布)人民币对中间价,30 分钟刷新;
    失败时按「历史中间价接口 → 非央行市场汇率(明确标注)→ 配置兜底值」四级降级,绝不静默使用旧值。
    人民币是权威基准,美元只是展示派生值,实时汇率不会回改已结算的历史成本。
  • 自建余额账本:插件用 DSH 的 deepseekAccount 服务采样余额,自己维护按天复式账本
    (opening / closing / debit / credit,充值永不冲减消费),所以「每日真实花费」可以跨安装回溯;
    如果本机恰好还有其它 DSH 插件的历史账本文件,会作为可选回填逐日合并(观测级合并,不重复计)。
  • 可视即配置:11 个大板块可在面板底部勾选显隐(存 localStorage),只影响展示不影响统计。
  • 不碰凭据:账户余额与账单全部经 DSH 的 deepseekAccount 服务读取,插件不接触、不存储任何 token / 密码。
  • 无第三方依赖:Host 侧零依赖,浏览器产物只用宿主注入的 React 模块,图表全部手写 SVG。

三种口径,不要相加

口径 数据来源 覆盖范围 用途
会话口径 会话日志折叠(ctx.sessionQuery) 本机全部历史会话,含安装本插件之前 分会话、分模型、分时段的明细;缓存命中率、TTFT、token 速度
全量调用口径 llm/stream waterfall 拦截 本机全部模型调用,从插件首次启动起 与平台「API requests / Tokens」对齐的那组数
平台账单口径 deepseekAccount.getBalance 余额采样 + 自建按天账本(可选历史回填) 该账号下的全部消费,含其他客户端与设备 唯一与开放平台严格一致的消费数字

为什么会不一样?

  • 会话日志只记录 assistant/message,漏掉 Auto review、会话标题、上下文压缩、联网搜索等辅助模型调用。
    这些 token 真实计费但不产生会话事件;全量调用口径把它们算了回来。
  • 开放平台是账户级账单:同账号下的其他 API Key、其他机器、其他客户端都算进去,本机日志看不到;
    平台数据还可能有最多 5 分钟延迟。
  • 余额差法只在「区间内没有充值」时可信;检测到余额上升会标记为不可信,而不是给出错误数字。

安装

需要 DSH 0.2.x(Host 提供 sessionQuery / webServer;deepseekAccount、llm 是可选服务——缺失时对应卡片显示「不可用」,
其余面板照常)。插件零第三方依赖,不需要 npm install。

三条路径任选(完整步骤、排错与验证清单见 INSTALL.md):

  1. 下载即用(推荐给普通用户):从 Releases 下载
    dsh-usage-monitor-<版本>.tgz → 解压到一个长期目录 → 在 DSH 插件管理器里
    install_bundle,target 传该目录的绝对路径 → 刷新页面。
  2. 源码安装(可 git pull 升级):git clone https://github.com/Dekurri/dsh-usage-monitor.git,
    然后把仓库目录的绝对路径交给 install_bundle。
  3. 交给 AI 助手:把下面这段直接发给你的 DSH 助手。
把 https://github.com/Dekurri/dsh-usage-monitor 装进当前 DSH profile 并验证:
1. git clone 到 "<绝对路径>"(或下载 Release tgz 解压,得到含 package.json 的目录)
2. plugin_manager({ action:"install_bundle", target:"<插件目录绝对路径>" })
→ 必须 application === "applied";若 failedAt === "registry"(网络抖动)原样重试一次。
不要手工改 profile 的 package.json / cordis.patch.yml。
3. cordis_inspect_query({ platform:"client", provider:"Slots", method:"listSubTree",
input:{ root:"sidebar.panellist" } })
→ occupants 中应有 { registrant:"usage-monitor", id:"usage-monitor", active:true }
4. GET /usage-monitor/api/overview?range=today  → 200 且含 kpi
GET /usage-monitor/api/live                   → 200 且含 host.cpuPercent
5. 报告已装版本、实际插件目录、上面两项校验结果,并提醒用户刷新页面。

安装结果里 application 必须是 "applied"(failed + failedAt: "registry" 通常是网络抖动,重试即可)。
卸载:插件管理器里移除 dsh-usage-monitor。

配置

cordis.patch.yml 已给出全部默认值,可在 profile 层覆盖。

key 默认 含义
fx.USDCNY 7.1 离线兜底值:实时汇率取不到时使用(1 美元 = N 元)
fxRefreshIntervalMs 1800000 实时汇率刷新周期(30 分钟);中间价约每交易日 09:15 发布
fxFile $DSH_HOME/usage-monitor/fx.json 汇率落盘缓存
sampleIntervalMs 2000 系统指标采样周期
liveHistoryPoints 60 sparkline 环形缓冲点数
rescanIntervalMs 60000 非 live 会话的后台重扫周期
pricing 内置官方人民币价表 覆盖模型单价(元 / 1M token,峰谷两档);未知模型标 priced:false 而不是算错
pricingHolidays [] 追加法定节假日('YYYY-MM-DD' 数组,北京日历日)
accountRefreshIntervalMs 60000 账户余额刷新周期
billHistoryFile $DSH_HOME/.dshw-usage.json 可选的历史账本文件(只读),仅用于回填安装之前的日期
cacheFile / ledgerFile / accountFile $DSH_HOME/usage-monitor/ 下 落盘缓存路径

数据与隐私

  • 不上报:插件不发起任何遥测。唯一的对外网络请求是取汇率,且失败可降级:
    1. chinamoney.com.cn(中国外汇交易中心,央行授权发布)人民币中间价快照;
    2. 同站的历史中间价接口(快照失败时的备源);
    3. api.exchangerate-api.com(仅当上面都失败时的市场汇率兜底,面板上会明确标注「非央行口径」)。
    全部失败则使用配置里的离线兜底值并标记 stale,不会静默使用旧值。
    成本价目表是编译进包内的官方人民币价目快照(来源见 lib/fold.js 注释),运行时不联网抓价格。
  • 不碰凭据:账户相关全部经 DSH 的 deepseekAccount 服务;插件不读 token、不写 cookie、不碰 keychain。
  • 只读会话:不追加、不修改任何会话事件;会话日志始终是唯一真相源。
  • 本地缓存:只存聚合结果(小时桶、会话摘要、余额采样、账本、汇率),落在 $DSH_HOME/usage-monitor/。
  • 仓库本身不含任何账号、密钥或本机数据;.gitignore 已排除各类本地缓存与密钥文件。

兼容与已知边界

  • 实时运行状态:CPU / 内存 / 进程指标跨平台可用;GPU 依赖 nvidia-smi,没有时 gpu.available:false(面板静默隐藏显卡块)。
  • 法定节假日表内置到 2026 年。官方尚未发布 2027 年放假安排,未内置年份的工作日 9–12/14–18 会按高峰价计(可能高估,最多 2 倍);
    周末仍自动按谷价;可用 pricingHolidays 追加新年度日期。
  • 平台账单口径依赖账号登录与余额采样;未登录时该卡片显示「不可用 + 原因」,其余面板照常。
  • 版本升级时 CACHE_VERSION 变化会触发一次全量冷扫(首次打开面板略慢,之后走缓存)。
  • UI 的正确性由静态自检(locale 完整性、禁用依赖、loader 结构、主题 token)与真实注册参数核对保证;
    自动化测试不覆盖视觉渲染。

开发与验证

包内 tools/ 是可复跑的独立校验脚本(不参与运行时),其中多数需要本机真实会话日志:

node tools/e2e-host.mjs            # 假 ctx + 真实日志跑通 index.js → routes 全链路
node tools/diff-fold.mjs           # 折叠口径 vs 另一套独立实现,逐会话逐字段比对
node tools/oracle.mjs --json       # 第三套独立实现的全库聚合,用于交叉核对
node tools/contract-check.mjs      # 契约自检(含 getLive / getOverview 延迟门槛)
node tools/ledger-check.mjs        # llm/stream 账本:流原样转发、用量聚合、落盘
node tools/account-check.mjs       # 余额采样、账本回放、登录态降级
node tools/bill-history-check.mjs  # 双源日观测级合并、充值不计消费、乱序忽略
node tools/fx-check.mjs            # 汇率四级降级、脏输入、缓存回环
node tools/ui-selfcheck.mjs        # 浏览器产物静态自检(零依赖,可在 CI 跑)
node tools/assembly-check.mjs      # 装配:五工厂 + 六路由 + 降级路径

tools/ 里的检查脚本会把临时文件写在包内 .tmp/(部分沙箱环境拒绝写系统临时目录),跑完自动清理。

接口契约见 CONTRACT.md(Host↔Client 唯一契约、字段定义、统计口径与降级规则)。

目录结构

index.js              Host 入口:装配 collector / llm-ledger / fx / account / bill-history + 路由
lib/fold.js           会话事件折叠(token 分桶、成本、峰谷、节假日)
lib/collect.js        会话扫描、缓存、range/币种视图
lib/system.js         本机实时指标(CPU/GPU/内存/RSS/运行时长/history 环形缓冲)
lib/routes.js         GET /usage-monitor/api/{overview,live,ledger,account,bill-history,fx} + POST /account/login
lib/llm-ledger.js     llm/stream 拦截账本(全量调用口径)
lib/account.js        余额采样 + 自建按天账本(平台账单口径)
lib/bill-history.js   账单历史合并(自建账本优先 + 可选历史回填)
lib/fx.js             央行中间价四级降级与缓存
lib/client.js         浏览器产物(React 组件注册到 sidebar.panellist / main)
cordis.patch.yml      bundle patch(含全部默认配置)
locale/{zh,en}.json   插件显示元数据
INSTALL.md            人类 / AI 助手通用安装与排错说明
tools/                可复跑的独立校验脚本

许可

MIT © 2026 Dekurri

> 非官方项目,与 DeepSeek 无隶属关系。成本为按官方价目表的估算值,与开放平台账单可能存在口径差,请以平台为准。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:Dekurri/dsh-usage-monitor#v1.0.1` 即可。对应的 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 需要什么运行环境?

Node.js >=20。环境不满足时安装会失败,建议先确认本机版本。

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

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

dsh-usage-monitor 有哪些功能?

全量 token 用量与成本估算、缓存命中率与对话性能指标、分会话、分模型明细统计、实时 CPU/GPU/内存监控、平台账单对账与余额账本。

这条记录的数据可靠吗?

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

同名或近似条目

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

huashu-design

huashu-design

在 DeepSeek Harness 里说一句话,就能拿回可交付的设计:网页、App 原型、可编辑 PPTX、动画与信息图,自带 84 种风

未标注验证等级 3.0 万 星

loopx

loopx

LoopX 是面向长周期 Agent 的本地优先控制平面,作为 DSH plugin 为 DeepSeek Harness 提供持久目标、证

未标注验证等级 6,233 星

agy-staff

agy-staff

把 Google Antigravity CLI 作为快速 Gemini 员工接入 DSH,提供子代理侧边栏、编排模式与多种角色技能。

未标注验证等级 870 星

dsh-startup-screen

dsh-startup-screen

DeepSeek Harness 的启动界面与启动动画插件。

未标注验证等级 633 星

dsh-blender-plugin

dsh-blender-plugin

让 AI 模型通过直连 TCP 通道实时驱动 Blender 的 DSH plugin:15 个工具覆盖视口取帧、任意角度渲染、内循环搜索、

未标注验证等级 211 星

Dekurri 的其它插件

2 个

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