dsh-usage-panel

DSH PLUGIN工具与能力

仓库 AlexLin0803/dsh-usage-panel · npm dsh-usage-panel

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

为 DeepSeek Harness 提供 Token 用量面板,含 KPI 卡片、26 周活跃热力图、按模型堆叠图与占比环图,并支持 CSV/JSON 导出。

一句话选型结论

按资料字段整理

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

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

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:AlexLin0803/dsh-usage-panel
  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-panel可用 npm view 查看包信息

能做什么

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

dsh-usage-panel:DeepSeek Harness 的 Token 用量可视化面板

  • KPI 卡片汇总 Token 与缓存命中
  • 26 周活跃热力图
  • 按模型堆叠与占比图
  • 按提供商与最忙会话统计
  • 本地导出 CSV / JSON

上游标签

deepseekdshdsh-pluginsettingstoken-usagevisualization

验证等级与安全审查

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

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

逐项检查结果

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 项功能,能直接看出它解决什么问题。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

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

仓库档案

工具与能力
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方AlexLin0803仓库 dsh-usage-panel · 默认分支 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 全文

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

dsh-usage-panel

给 DeepSeek Harness(dsh)加一个 Token 用量 页面:KPI 卡片、26 周活跃热力图、按模型堆叠的
柱状图、模型环形图 —— 数据全部来自本机已有的会话持久日志。

两个入口,页面内容完全一致:

  • 左侧边栏的一行,点一下就在主工作区打开(不用进设置);
  • 设置 → 用量,与其它设置页并列。

截图使用 dev/sample-summary.json 里的合成数据;用 node dev/preview.mjs zh --sample 可复现。
仓库里不含任何真实会话数据。

页面内容

区块 含义
KPI 卡片 总 Token、输入/输出、缓存读取与命中率、会话数、活跃天数、连续活跃
活跃热力图 最近 26 周每天的 Token 消耗,悬停查看当日明细
按模型的 Token 最近 7 / 30 / 90 天的每日总量,按模型堆叠
模型占比 各模型占总消耗的比例
供应商 按实际承接请求的供应商拆分
最忙的会话 累计 Token 最高的会话,附消息数与使用的模型

页面使用设置面板自己的设计 Token,因此自动跟随 Harness 的语言(zh / en)与明暗主题。

导出 可以写出当前区间的每日序列、按模型的表格(CSV),或完整汇总(JSON)——全部在页面内生成,
不上传任何数据。

实现

一个包、两个半边:

  • Host(lib/index.js)—— Cordis 插件,在 Web 服务器上注册一条路由
    GET /usage-panel/api/summary?days=30[&refresh=1]。它扫描
    $DSH_HOME/sessions/**/session.v*.jsonl[.zstd],解码串接的 Zstandard 帧,把
    assistant/message 里的 usage 按天、模型、供应商、会话折叠成 JSON。
    每个文件按大小/mtime 缓存,并记住最后一个完整帧的字节位置:热请求直接走内存,追加写入的
    批次只解码新增的字节。
  • Browser(lib/client.js)—— client-module 包(window.__ModuleLoader__.load),注册一个
    settings.section 页面并拉取汇总。只依赖平台内置的 react 模块和主题 Token,不需要组合其它插件。

不含任何面向模型的内容:没有工具、没有提示词、不发模型请求。

安装

profile 的插件树由 bundle 组合而成。本包声明了 dsh.bundle.patch = ./cordis.patch.yml,
所以只要把它作为 profile 的 bundle 装进去即可。

# 1. 让 profile 能解析到这个包(本地开发用 link 即可)
dsh plugin --profile desktop add link:E:/path/to/dsh-usage-panel

# 2. 选中这个 bundle —— profile 的 package.json:
#    "@deepseek-ai/dsh-base",
#    "@deepseek-ai/dsh-web-app",
#    "dsh-usage-panel"

开启 HMR 时运行中的组合会立刻生效,否则重启 Harness。之后打开 设置 → 用量。

不想手改 profile 的话,也可以用 Web 侧栏的 插件 页面或 plugin_manager 工具安装,
它们会自行维护 dsh.profile.bundles。

排查

配置重载之后,侧边栏那一行或设置页消失了。 说明组合时这个 bundle 被跳过了。先查清单文件的编码:
package.json 必须是 不带 BOM 的 UTF-8,否则 JSON.parse 直接抛错,DSH 会丢掉整个 bundle。
可以拿 profile 的副本离线组合一次,看有没有那条警告:

Copy-Item ~/.dsh/profiles/desktop ~/.dsh/profiles/desktop-check -Recurse
dsh --profile desktop-check --dump-config | Select-String "skipping profile bundle"
Remove-Item ~/.dsh/profiles/desktop-check -Recurse

健康的输出里应该有一行 - id: usage-panel。仓库里的 .editorconfig 已经钉住编码,避免编辑器再把 BOM 加回来。

验证宿主路由

curl.exe "http://127.0.0.1:60341/usage-panel/api/summary?days=30"

返回 {"ok":true,...} 的汇总;带 ?refresh=1 会跳过 20 秒缓存。

开发

dev/preview.mjs 用一个小型 React 兼容运行时把真正的 lib/client.js 渲染到实时数据上,
并套用 Harness 自己的亮色主题 Token,需要时顺带截图 —— 改页面时不用反复刷新 GUI:

node dev/preview.mjs zh --shot assets/preview-zh.png
node dev/preview.mjs en

# 用合成数据渲染(截图就是这么生成的)
node dev/preview.mjs zh --sample --shot assets/preview-zh.png
node dev/preview.mjs en --sample

# 渲染主工作区页面(而不是设置页里的那一版)
node dev/preview.mjs zh --sample --panel

不带 --sample 时会去调用正在运行的宿主;--sample 只读 dev/sample-summary.json,不碰真实日志。

宿主不在默认地址时用 DSH_ORIGIN 指定。dev/tokens.json 是预览页用到的 --dsw-alias-*
解析结果。

限制

  • 只看本机会话。 折叠的是本机 $DSH_HOME/sessions,不调用供应商接口,看不到其它安装的用量。
  • 只有 Token,没有费用。 价格会变且各供应商不同,所以不推算金额。
  • 只统计带 usage 的事件。 早于供应商上报 usage 的会话会计入消息数,但 Token 记 0。
  • 路由没有鉴权。 与其它非 /api 的 Web 路由一致,依赖回环绑定;能访问该端口的人就能读到本机 Token 汇总。

结构

dsh-usage-panel/
├─ package.json          dsh.manifestVersion / dsh.bundle / dsh.client
├─ cordis.patch.yml      bundle:一条 insert,指向本包
├─ lib/index.js          宿主:日志扫描、聚合、HTTP 路由
├─ lib/client.js         浏览器:settings.section 页面
├─ dev/preview.mjs       离线渲染 + 截图工具
├─ dev/tokens.json       预览用的主题 Token
└─ assets/               预览截图

MIT License.

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:AlexLin0803/dsh-usage-panel` 即可。对应的 npm 包名是 `dsh-usage-panel`。

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

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

dsh-usage-panel 安全吗?

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

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

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

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

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

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

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

dsh-usage-panel 有哪些功能?

KPI 卡片汇总 Token 与缓存命中、26 周活跃热力图、按模型堆叠与占比图、按提供商与最忙会话统计、本地导出 CSV / JSON。

这条记录的数据可靠吗?

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

同名或近似条目

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

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 星

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