dsh-usage-monitor

DSH PLUGIN浏览器与联网

仓库 liyiersan/dsh-usage-monitor

浏览器与联网 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

在 DeepSeek Harness 界面内直接展示 DeepSeek API 官方定价、会话与累计花费及账户余额,用量 dock 条常驻记录。

一句话选型结论

按资料字段整理

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

分类浏览器与联网 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 2
最近更新 2026-09-12 创建于 2026-09-12
README 8.2 KB 正文体量,越大说明说明书写得越细

安装

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

    兼容的 DSH 版本为 0.2.0-rc.2 等 7 个;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

dsh-usage-monitor:在 DeepSeek Harness 里查看用量与花费的 DSH plugin

  • 账户余额与赠金实时查询
  • 本会话花费按模型增量计价
  • 跨会话累计花费账本
  • 内置高峰/空闲官方定价
  • 用量 Tab 与输入框 dock 条

上游标签

balancedeepseekdeepseek-harnessdshdsh-pluginpluginpricingusage

验证等级与安全审查

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

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

逐项检查结果

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 插件清单中已激活 方式:插件清单查询
— · 其它检查项
  • L4_0_SANDBOX 沙盒安装判定 方式:沙盒安装执行

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

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

值得选的地方

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

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-usage-monitor当前 L5 · 运行验证通过 低风险 0 0.2.0-rc.2 等 7 个 有
dsh-our-free-model L3 · 安装规范通过 低风险 8,796 未标注 有
dsh-web L3 · 安装规范通过 低风险 8,549 未标注 无
BrowserSkill L4 · 沙盒安装通过 低风险 8,456 未标注 有
dsh-pocket L5 · 运行验证通过 低风险 1,656 0.2.0-rc.2 等 12 个 有
Browser4 L4 · 沙盒安装通过 中风险 1,152 未标注 有

仓库档案

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

README 全文

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

dsh-usage-monitor

English | 简体中文

> 在 DeepSeek Harness(DSH)界面里直接显示 DeepSeek API 的官方定价、会话用量花费、累计花费和账户余额。


> 截图取自真实的 DSH Web 页面(用 Playwright 驱动本机 Chrome 渲染),只把插件接口替换为演示数据——界面结构、插件 DOM 与样式都是真实的;账户余额、会话用量与会话名均为演示值。

功能

  • 账户余额:查询 GET https://api.deepseek.com/user/balance,显示总余额、充值余额和赠金;默认 60 秒缓存,可手动刷新。
  • 本会话花费:显示宿主账本里已计价的金额——按各阶段实际使用的模型与时段分别增量计价,因此切换模型时数字不会跳变;账本尚未记录该会话时退回本地估算,并在界面上标注「估算」。
  • 按模型明细:账本按模型分桶记录 token 与金额,面板分别列出 Flash 与 V4-Pro 各自用掉多少、花了多少。
  • 累计花费:本地账本记录跨会话用量,采用增量计价,跨高峰/空闲时段也能准确累计;用量由常驻的 dock 条上报,不打开面板也会持续记录。
  • 官方定价:内置 deepseek-flash 与 deepseek-v4-pro 单价,自动区分高峰/空闲时段。
  • 两个入口:
  • 对话主视图新增「用量」Tab,展示完整面板;
  • 输入框上方 dock 条常驻显示余额、本会话花费、当前模型单价和计价时段。
  • 隐私安全:不监听公网,不写密钥;详细说明见下方「安全与隐私」。

截图

完整用量面板

输入框 dock 条

安装

前置条件

  • 已安装 DSH,例如 @deepseek-ai/dsh;
  • 使用 web profile;
  • 账户可用 DeepSeek API key,例如已经在 ~/.dsh/.credentials.yaml 中配置,或通过环境变量 DEEPSEEK_API_KEY 提供。

1. 安装插件

dsh plugin --profile web add github:liyiersan/dsh-usage-monitor

也可以从本地目录安装:

dsh plugin --profile web add /path/to/dsh-usage-monitor

本仓库声明了 dsh.bundle.patch。DSH 支持该 manifest 时会在安装时自动应用 cordis.patch.yml,把插件插入 profile 配置树,通常不需要手动改配置。

2. 手动安装 / 兜底

如果当前 DSH 版本没有自动应用 bundle patch,编辑 $DSH_HOME/profiles/web/cordis.patch.yml(默认 ~/.dsh/profiles/web/cordis.patch.yml),加入:

- insert:
- id: usage-monitor
name: '@local/dsh-usage-monitor'

3. 确认 API key 可用

插件不会自己保存 key,它会通过 DSH credentials 服务解析 DEEPSEEK_API_KEY,失败时回退到进程环境变量。

4. 重启 DSH

dsh web

打开任意会话,即可在顶部看到「用量」Tab,并在输入框上方看到用量 dock 条。

卸载

dsh plugin --profile web remove @local/dsh-usage-monitor

如果你之前是手动加入 insert 条目,请再从 cordis.patch.yml 中删除;自动 bundle 安装通常由 dsh plugin remove 一并处理。可选手动删除本地账本:

rm -rf "$DSH_HOME/usage-monitor"

定价口径

单位:元 / 百万 tokens。高峰时段为北京时间周一至周五 09:00-12:00、14:00-18:00;空闲时段价格为高峰的一半。

模型 时段 缓存命中 缓存未命中 输出
DeepSeek-V4.1-Flash 空闲 0.02 1 4
DeepSeek-V4.1-Flash 高峰 0.04 2 8
DeepSeek-V4-Pro 空闲 0.15 4.5 13.5
DeepSeek-V4-Pro 高峰 0.3 9 27

计费规则:

  • cacheRead(缓存命中输入)按缓存命中单价;
  • uncachedInput(缓存未命中输入)按未命中单价;
  • output 按输出单价;
  • cacheWrite(写入缓存)官方未单列,本项目按未命中单价保守计算;
  • 模型名包含 pro、chat、reasoner 时归入 V4-Pro;包含 flash 归入 Flash;无法识别时按 Flash 兜底并在界面标注。

> token 数量来自提供方的精确用量;金额由本地账本按增量计价得出,与官方账单口径一致,可能有极小取整差异(时段归属按上报时刻判定)。DeepSeek 价格可能调整,更新时请同时修改 lib/pricing.js 和 lib/client.js 中内联的定价副本。

工作原理

DSH Host (Node)
lib/index.js ── GET /user/balance ──> api.deepseek.com
│
├─ GET  /usage-monitor/data   ──> browser client
└─ POST /usage-monitor/report <── browser client
│
├─ conversation.view「用量」Tab
└─ conversation.input.dock dock 条
  • lib/index.js:宿主半。解析凭据、查询余额、维护本地账本(按会话 + 按模型分桶,增量计价)、暴露本地 HTTP 端点。
  • lib/client.js:浏览器半。注册 conversation.view 和 conversation.input.dock 两个槽位;dock 条是常驻上报点,面板另外展示账本的分桶明细。
  • lib/pricing.js:纯函数计费引擎,供宿主和测试使用。
  • 客户端内联了一份定价副本,避免浏览器运行时无法直接 import 服务端模块;修改价格时两处都要改。

目录结构

dsh-usage-monitor/
├── lib/
│   ├── client.js      # 浏览器插件 bundle
│   ├── index.js       # 宿主插件
│   └── pricing.js     # 计费引擎
├── scripts/
│   ├── client-check.mjs
│   ├── inspect-session.mjs
│   └── smoke.mjs
├── test/
│   └── pricing.test.mjs
├── docs/screenshots/
├── package.json
├── README.md
├── README.en.md
└── LICENSE

开发与测试

npm test                 # 定价引擎单元测试
npm run test:client      # 客户端 bundle 离线校验
node scripts/smoke.mjs   # 服务端冒烟测试(会查询真实余额接口)

scripts/smoke.mjs 会使用临时 DSH_HOME,不会污染真实账本;它会从本地 DSH 凭据文件或环境变量读取 key,但只打印 key 长度,不打印 key 本身。

> 改动客户端后只需刷新页面(DSH 0.1.5-rc.1 实测):/plugins//client.js 由 DSH 的客户端模块表提供,该表在 DSH 运行时监听插件文件,内容变化会重新计算 bundle 的 rev 并按新 URL 提供(dsh-client-modules 的 rebuilt() 钩子),所以刷新浏览器页面就能拿到新副本,不必重启 DSH。若你在 DSH 停止时修改了 lib/client.js,下次启动本就会读取新内容;验证时如仍看到旧行为,先确认浏览器加载的 bundle URL 里 rev= 是否已变化。
>
> 注意:本插件的服务端半(lib/index.js)不会热更新,改动它必须重启 DSH。

兼容性

当前版本在 DSH 0.1.5-rc.1 的 web profile 上验证(2026-09),同时兼容 0.1.1-rc.2(客户端槽位与模型解析接口一致)。DSH 客户端 API 仍可能变化,升级 DSH 后如发现槽位或模型解析接口变化,请提交 issue 或 PR。

安全与隐私

  • 不收集、不上传遥测数据;
  • 插件本身不保存 API key;key 仅由 DSH credentials 服务或进程环境变量提供;
  • 余额查询只发生在宿主侧,目标为 https://api.deepseek.com/user/balance;
  • 本地账本保存于 $DSH_HOME/usage-monitor/ledger.json,只记录 session id、token 用量及按模型分桶的金额,不会提交到仓库;
  • /usage-monitor/* 端点随 DSH webServer 监听回环地址;/usage-monitor/report 要求 Content-Type: application/json,用于降低 CSRF 风险;
  • 建议开源使用者不要把自己本地账本、凭据文件或包含个人路径的日志提交到 Git。

贡献

欢迎提交 issue 和 PR。提交前请尽量运行:

npm test
npm run test:client

License

MIT

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:liyiersan/dsh-usage-monitor` 即可。

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

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

dsh-usage-monitor 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

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

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

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

上游记录的兼容版本包括 0.2.0-rc.2、0.2.0-rc.1、0.1.7-rc.2、0.1.7-alpha.2、0.1.6-alpha.2、0.1.6-alpha.1、0.1.5-rc.2。

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

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

dsh-usage-monitor 有哪些功能?

账户余额与赠金实时查询、本会话花费按模型增量计价、跨会话累计花费账本、内置高峰/空闲官方定价、用量 Tab 与输入框 dock 条。

这条记录的数据可靠吗?

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

同名或近似条目

7 条
不同作者的仓库分开列,请确认你要装的是哪一个
浏览器与联网
按星标排序,可作替代方案

dsh-our-free-model

dsh-our-free-model

在 DeepSeek Harness 中装上这个 DSH plugin,无需登录、注册或填 API Key,即可直接调用 DeepSeek

L3 · 安装规范通过 8,796 星

dsh-web

dsh-web

侧边栏多列任务看板:卡片交给真实 DSH 智能体会话执行,支持 cron 定时(Host 侧到点执行,关浏览器也生效)。

L3 · 安装规范通过 8,549 星

BrowserSkill

BrowserSkill

BrowserSkill 的 DeepSeek Harness 浏览器自动化桥接插件,通过原生浏览器工具控制可见的 Chrome 和 Edg

L4 · 沙盒安装通过 8,456 星

dsh-pocket

dsh-pocket

DSH Pocket 让 DeepSeek Harness 装进口袋:电脑跑 dsh web,手机扫码即实时同步访问(局域网+公网),人在外

L5 · 运行验证通过 1,656 星

Browser4

Browser4

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

agentrq

agentrq

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

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