dshtoken

DSH PLUGIN工具与能力

仓库 rinttt233/dshtoken · npm @local/dshtoken

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

DSH plugin 提供独立 Token 统计页,按类别、APIKey、模型、会话拆分用量并估算 CNY 花费,底部用量控件可一键跳转。

一句话选型结论

按资料字段整理

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

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

安装

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

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

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

dshtoken:DeepSeek Harness 的 token 用量统计插件

  • 独立统计页与柱状图
  • 按类别/模型/会话拆分
  • CNY 花费估算与预算
  • 底部用量控件跳转
  • token_stats 模型工具

上游标签

costdeepseek-harnessdshdsh-pluginstatisticstokenusage

验证等级与安全审查

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

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

逐项检查结果

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 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dshtoken当前 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 未标注 有

仓库档案

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

README 全文

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

@local/dshtoken — DSH Token 统计

一个独立的 DSH Web 插件:把会话日志里 provider 上报的 token 用量聚合成独立统计页,
支持日期范围柱状图、单柱时间跨度调节、按类别 / APIKey(provider 路由)/ 模型 / 会话拆分、
token 与 CNY 估算花费切换、模型筛选,并在对话底部的用量控件里提供跳转入口。

  • 纯本地:只读会话日志 + 本机 JSON 配置,不联网、不上报。
  • 不动官方组件:统计页是独立页面;底部用量控件按官方文档允许的方式(同 id + 同 order +
    更低 priority)替换,读数与官方一致并增加跳转按钮。
  • 主题/语言跟随宿主(light/dark + 中文/English)。

功能

统计页(左侧栏 Token 统计图标进入)
- 日期范围:今天 / 昨天 / 近 7 天 / 近 30 天 / 本月 / 上月 / 自定义;图上可拖选一段区间。
- 单柱跨度:自动 / 1 小时 / 1 天 / 1 周 / 1 月。
- 拆分维度:类别(缓存命中 / 未命中输入 / 缓存写入 / 输出)、APIKey(provider 路由)、
模型、会话;点柱子可下钻到该时间桶,面包屑返回。
- 「按会话」模式:柱高为该时间桶的总消耗(单色),悬停柱子弹出会话列表——按消耗量
从高到低排序、默认折叠、点「展开全部」可滚轮滚动查看全部;单击会话行展开明细、
双击直接跳转到该会话
。图例会隐藏并显示操作提示。
- 指标:Tokens 数 / CNY 估算花费。
- 模型筛选:多选勾选,只统计勾选的模型(对所有视图生效)。
- 汇总卡片:总 token、估算花费、缓存命中率、日均 token、峰值时间桶;未定价模型会提示
费用口径不完整。
- 月度预算:设置里填「月度预算(CNY)」,页面出现预算卡片(本月已用 / 剩余 / 进度条),
≥80% 显示警告色、≥100% 显示「已超出预算」。
- 官方账户余额:已登录 DeepSeek 官方账号时,标题栏显示「账户余额 + 赠送余额」;
未登录/不可用时静默隐藏(与本地估算费用相互独立)。
- 明细表(每个时间桶一行)+ CSV 导出 / 复制;Top 会话(点击跳到会话)与 Top 模型排行。
- 自动刷新(仅页面可见时)、索引进度条、重建索引、记住上次筛选。
- 模型可用工具:token_stats(可以直接问「这周花了多少 token / 多少钱」)。

对话底部用量控件
- 显示当前会话 token 总量 · 缓存命中率(与官方读数口径一致)。
- 展开后的统计弹窗:分类明细(token + 费用)、请求数、首末时间、今日/累计,以及
「打开 Token 统计 →」跳转按钮。

价格与口径设置(统计页右上角齿轮)
- 每个模型的单价(元 / 百万 token):缓存命中 / 未命中输入 / 缓存写入 / 输出,以及峰时倍数。
- 峰谷时段:默认工作日 09:00–12:00、14:00–18:00(北京时间)为高峰,其余(含周末/节假日)为空闲;
可改时段、工作日与节假日。
- 恢复默认、导入/导出价格 JSON。

数据来源与口径

  • token 用量来自会话日志中 assistant/message 携带的 provider usage:
    inputTokens / outputTokens / cacheReadTokens / cacheWriteTokens / reasoningTokens。
    本 DSH 构建里 inputTokens 是未命中缓存的输入(已剔除缓存命中/写入部分),因此
    「未命中输入 = inputTokens」,总量 = 未命中 + 缓存命中 + 缓存写入 + 输出(与 provider
    totalTokens 一致)。
  • 只统计会话自身事件(fork 子会话不重复统计继承的历史);可按会话拆分查看子代理:
    勾选「子代理单独列出」时子代理会话单独成行,取消勾选时子代理消耗合并到所属主会话,
    合计(总量/费用/请求数)保持不变,只是不再单列。
  • 「APIKey」等于 provider 路由(每个 provider 配置一把 apiKeyEnv)。
  • 花费是估算不是账单:日志里没有账单金额,费用 = 用量 × 可编辑价格表。默认只给
    DeepSeek 官方模型(deepseek-official/*)内置官方价,其它网关/第三方模型默认不计算费用,
    只统计 token,并在页面里提示未定价;在设置里填好单价即可计入。
  • 首次打开页面会在后台扫描历史会话(本机约 311 个会话、数百 MB 压缩日志),约 1–2 分钟,
    显示进度;索引缓存到 $DSH_HOME/plugin-data/dshtoken/index.json.gz(按会话文件大小增量
    校验),之后每次启动/热加载只需 ~1 秒,只重读有变化的会话。

安装

仓库:github.com/rinttt233/dshtoken(MIT)。

git clone https://github.com/rinttt233/dshtoken.git

然后在 DSH 里把 clone 出来的目录作为本地 bundle 装入当前 profile(desktop):

plugin_manager  install_bundle  target = <你的 clone 路径>/dshtoken

例如 Windows 上 clone 到 D:\dshtoken 后,target 就是 D:\dshtoken。
安装是 link 方式(不是复制),所以之后 git pull 更新源码即可;覆盖已安装版本后
Host 侧需要重启 DSH、Client 侧刷新页面。

Host 侧改动需要重启 DSH;Client 侧改动只需刷新页面。安装后左侧栏出现「Token 统计」图标,
对话底部出现 token 用量控件。

卸载

plugin_manager  remove_bundle  target = @local/dshtoken

可选:删除 $DSH_HOME/plugin-data/dshtoken/(索引缓存与价格配置)。

开发

node scripts/build-client.mjs           # src/client/*.js → dist/client.js(单文件、无依赖)
node scripts/check-fragment.mjs   # 单片段语法检查
node scripts/host-selftest.mjs          # Host 纯函数自测(54 项)
node scripts/verify-api.mjs     # Host HTTP 端到端冒烟测试

verify-api.mjs 的 origin 是 DSH Web GUI 地址(端口每次重启会变,可在 DSH 运行时上下文里看到),
也可以写进环境变量:DSH_TOKEN_API_ORIGIN=http://127.0.0.1: node scripts/verify-api.mjs。

dist/client.js 是构建产物,仓库里保留它以便直接安装;改 src/client/*.js 后必须重新
node scripts/build-client.mjs 再刷新页面。

结构:

index.js               Host 薄壳:注册 /dshtoken/api,按 lib 文件 mtime 动态重载业务逻辑
lib/                   Host:store(磁盘/配置) cost(价格/峰谷) scan(索引) aggregate(聚合) http(接口)
src/client/shared.js   共享运行时(i18n / API / 格式化 / hooks / 基础 UI / 主题 CSS)
src/client/chart.js    SVG 堆叠柱状图
src/client/page.js     统计页
src/client/dock.js     底部用量控件(替换官方 usage)
src/client/main.js     入口:语言、样式、slot 注册
scripts/build-client.mjs  把 5 个片段拼成一个 __ModuleLoader__ bundle

CONTRACT.md 是 Host API、数据模型与各片段接口的完整契约。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:rinttt233/dshtoken` 即可。对应的 npm 包名是 `@local/dshtoken`。

dshtoken 的验证等级是什么意思?

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

dshtoken 安全吗?

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

dshtoken 装之前要先确认什么?

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

dshtoken 支持哪些 DSH 版本?

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

dshtoken 需要什么运行环境?

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

dshtoken 用的是什么许可证?

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

dshtoken 有哪些功能?

独立统计页与柱状图、按类别/模型/会话拆分、CNY 花费估算与预算、底部用量控件跳转、token_stats 模型工具。

这条记录的数据可靠吗?

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

工具与能力
按星标排序,可作替代方案

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 星

rinttt233 的其它插件

1 个

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