其他 · v0.1.1
dsh-usage-guard
- 静默采集——挂接会话事件,将每条助手消息的 token 用量按 provider × model 归入每日分桶;可跨重启保留,首次运行时从会话日志回填 - 与 harness 自身的统计口径一致——用量是……
作者原文(英文)
- Silent collection — hooks session events, folds every assistant message's token usage into daily buckets per provider × model; survives restarts, backfills from session logs on first run - Matches the harness's own accounting — usage is…
简介取自插件 README 开头,由 DeepSeek 模型翻译,仅供参考。
安装命令
dsh plugin --profile web add dsh-usage-guard@0.1.1
已试装 · 层已挂载
已在一个隔离的 profile 里真装过:包能装上,并且插件层挂载成功。这一条是实测结果,不是作者的声明。
检测报告
能力清单
- 写入文件
writes-files需留意43 处命中host/collector.test.js:14mkdirSync(sessionsDir, { recursive: true });host/collector.test.js:16afterEach(() => { rmSync(dir, { recursive: true, force: true }); });host/collector.test.js:30mkdirSync(d, { recursive: true });host/collector.test.js:31writeFileSync(join(d, 'session.jsonl.zstd'), frame(events));- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 发起网络请求
network需留意2 处命中dist/client.js:151const r = await fetch(path);dist/client.js:159const r = await fetch("/usage-stats/config", {- 看请求发往哪些域名。发往作者自己的后端是常见做法。
- 清单可疑
manifest-obfuscation需留意1 处命中- 安装脚本:prepare
- 清单被刻意写乱时,加载行为会难以预测。看原文而不是看渲染结果。
- 读取文件
reads-files一般17 处命中host/index.test.js:116expect(await waitFor(() => existsSync(storePath))).toBe(true); // backfill() 结束时会 flushhost/logscan.js:79const buffer = readFileSync(file);host/logscan.js:128entries = readdirSync(dir);host/logscan.js:136stat = statSync(path);- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 读取环境变量
reads-env一般7 处命中host/index.js:16const dshHome = process.env.DSH_HOME && process.env.DSH_HOME !== ''host/index.js:17? process.env.DSH_HOMEhost/index.test.js:22previousHome = process.env.DSH_HOME;host/index.test.js:23process.env.DSH_HOME = dir;- 环境变量里常混有密钥。看它是否把整个 env 都读走。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 写入文件 | writes-files | 需留意 | 43 |
| 发起网络请求 | network | 需留意 | 2 |
| 清单可疑 | manifest-obfuscation | 需留意 | 1 |
| 读取文件 | reads-files | 一般 | 17 |
| 读取环境变量 | reads-env | 一般 | 7 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 19 个文件,扫描于 2026-10-16。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
可信度
- -5cordis entry id「usage-stats」被 5 个包共用,同时安装会互相替换warn:@ychris12138/dsh-usage-stats、dsh-plugin-usage-stats、dsh-usage-statistics-panel、dsh-usage-stats
认证等级 L0
- L0静态结构与契约✓sha512-Maire1692LSispHb… 与本地 tarball 复算一致,补丁与入口齐备
- L1配置组合与依赖图—entry id usage-stats 被 5 个包共用
- L2隔离沙箱冒烟✓隔离 profile 安装成功,1.8s,层已挂载;宿主带它启动(rendered)(前一级未通过,本项不计入等级)前一级未通过,不计入等级
- L3运行时健康监控✓抽样会话内未观测到外部进程 / 越界写 / 外连(2 个事件)(前一级未通过,本项不计入等级)前一级未通过,不计入等级
评分口径与作者信息
从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分
- 维护者
- hb-degithub
- 仓库
- https://github.com/hb-degithub/dsh-usage-guard
- 许可
- MIT
- 最后发布
- 2026-10-09
- 周下载
- 576
- star
- 1
扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。
认证等级只回答四件事:包本身是否完整可解析(L0)、能不能与别的插件组合(L1)、隔离环境里装不装得上并起得来(L2)、抽样运行时有没有异常(L3)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。
| Node 要求 | >=22.19 |
|---|---|
| 第三方依赖 | 0 个(纯自包含) |
| bundle patch | ./cordis.patch.yml |
| 依赖安全公告 | 已查询全部依赖,没有匹配到已公开的安全公告(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。) |
元数据
| 主页 | https://github.com/hb-degithub/dsh-usage-guard#readme |
|---|---|
| 仓库最近提交 | 2026-10-09 |
| 仓库创建 | 2026-08-19 |
DSH