dsh-usage-panel

DSH PLUGIN浏览器与联网

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

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

为 DeepSeek Harness 侧栏加常驻用量面板,轮播显示官方账号与 new-api 中转站余额、今日消耗及峰谷时段。

一句话选型结论

按资料字段整理

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

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

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:InkiChang/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 侧栏用量常驻面板

  • 侧栏常驻用量块
  • 多站点轮播显示
  • 余额与今日消耗
  • 峰谷时段标注
  • 面板内设置与测试

适用场景

通知

上游标签

deepseek-harnessdshdsh-plugin

验证等级与安全审查

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 有
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 未标注 有

仓库档案

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

README 全文

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

dsh-usage-panel

给 DeepSeek Harness 提供侧栏常驻的用量面板:轮播显示 DeepSeek 官方账号(或手填的官方 API key)与各中转站(new-api 系)的余额、今日消耗,官方站点额外标注当前处于高峰还是空闲时段。

这是什么

DSH 本身不展示 API 用量。这个插件在左侧边栏底部嵌入一块面板,无需打开各站点后台即可查看余额与今日消耗。面板位于「记忆」这类入口之下、账号行(头像与用户名)之上,采用嵌入排版而非浮层覆盖。

  • 官方站点:余额来自 https://api.deepseek.com/user/balance。若 DSH 已登录官方账号,无需填写 key,直接读取账号余额;也可以改为「手填 API key」,单独跟踪某一个 key。手填 key 属未验证路径(原因见「已知限制」)。
  • 中转站:按 new-api 的接口形态读取配额与消费统计,支持多个站点并列轮播。
  • 高峰/空闲:官方定价在工作日高峰时段为空闲时段的 2 倍,面板以「峰 / 闲」标记标出当前时段,悬停浮层中给出高峰与空闲的分账。

功能

能力 说明
侧栏常驻块 嵌入侧栏底部:位于底部入口之下、账号行之上,宽度与左缩进同相邻入口一致
多站点轮播 官方账号、多个官方 key、多个中转站可同时存在,按间隔轮播
不遮挡其它入口 面板占据侧栏内的实际位置;其它插件新增底部入口时向上排布,两者不重叠
余额 + 今日消耗 每个站点两行数字,未配置或出错时给出原因与入口
峰 / 闲字块 仅官方站点显示,颜色随主题自适应
悬停浮层 余额与今日消耗;中转站另有本月已用、本月起算日,官方另有高峰/空闲分账
手动刷新 点击面板上的时间即可立即刷新
设置浮层 增删站点、测试连接、显示开关、刷新间隔,全部在面板内完成
只存本机 令牌与 key 落在 ~/.dsh/usage-panel/config.json,不外发

侧栏布局与实现

嵌入式布局

自 0.1.2 起,面板不再以浮层形式覆盖在侧栏之上,而是占据侧栏底部的一个固定位置:位于「记忆」等底部入口之下、账号行(头像与用户名)之上,与相邻入口一样参与正常排版。

0.1.1 及更早版本使用浮层方案,停靠位置由单一参照点推算;当参照点位移或底部新增入口时会出现遮挡,被覆盖的入口无法点击。

嵌入方案的变化:

  • 互不遮挡:其它插件在底部新增入口时,面板位置不随之移动,两者不会重叠。
  • 位置稳定:窗口尺寸、主题切换、站点轮播均不影响停靠位置,面板始终位于账号行上方。
  • 视觉一致:面板采用透明背景与无边框样式,左缩进与相邻入口一致;缩进值在每次布局时按「记忆」文字的起始位置实测得出,不写死像素值。

实现方式

改动全部位于插件内部,未修改 DSH 本身:

  1. 定位侧栏底部的账号行(含头像与用户名的行元素)。
  2. 在该行之前插入一个透明占位元素,高度等于面板自身高度;宿主布局会把占位下方的内容下移,形成面板所需空间。
  3. 面板绘制于占位区域,左右内边距按相邻入口文字的实际起始位置计算。
  4. 宿主重绘侧栏时占位可能被清除,插件每 900 毫秒检查一次并在缺失时补回。

已知影响

  • 侧栏底部高度增加:约 56 像素(等于面板高度),会话列表可见行数相应减少。
  • 依赖宿主侧栏结构:定位依赖账号行与底部入口的现有结构。若 DSH 大幅调整侧栏,插件可能无法定位,此时回退为「贴在『记忆』入口上方」的原有做法,功能不受影响,但位置可能不理想。
  • 重排闪烁:上述第 4 步补回占位时理论上存在一次重排,正常使用中不易察觉。
  • 不占用宿主入口位:面板未注册到 DSH 的插件入口表,因此不会与「记忆」「导入会话」等入口竞争位置,也不会因它们的增减而被挤出;相应地,它也不由宿主统一排版。

界面

截图取自真实桌面端窗口,站点名与令牌已打码。两张侧栏截图均为嵌入后的位置:面板位于「记忆」入口之下、账号行之上。

侧栏常驻块 · 官方站点(峰 字块表示当前处于高峰时段):

侧栏常驻块 · 中转站:

悬停展开 · 官方站点(余额、今日消耗,以及高峰与空闲分账):

悬停展开 · 中转站(今日与本月来自站点统计接口):

设置浮层(在面板内增删站点、测试连接、调整刷新间隔):

安装

需要已安装 DSH(桌面端或 @deepseek-ai/dsh 均可)。把本仓库目录作为插件包安装:

# 在 DSH 会话里让插件管理器安装本地目录(换成你的绝对路径)
plugin_manager action=install_bundle target="C:\path\to\dsh-usage-panel"

安装或卸载插件后,需完整退出并重启一次 DSH,否则侧栏不会显示该面板。原因:DSH 在进程启动时读取插件清单并注册插件的后端入口与前端资源;运行中的进程不会因重新安装而重建这份清单,仅刷新页面(Ctrl+R)同样无法加载新安装的代码。实测表现为:插件文件已在磁盘上,刷新页面后前端资源仍返回 404,侧栏对应位置为空。

生效规则:插件已安装且仅修改 client.js(界面部分)时,刷新页面(Ctrl+R)即可生效;修改 index.js(后端)或重新安装、卸载插件后,必须重启 DSH。

快速开始

  1. 左栏底部出现用量面板后,点击面板上的「设置」(尚未配置时显示「去设置」),或从 设置 → Usage 面板 进入。
  2. 官方站点:默认「数据来源」为 DSH 已登录账号,处于登录状态即显示余额;如需单独跟踪某个 key,将来源改为「手填 API key」并填入 key。
  3. 添加中转站:填写站点地址(例如 https://<中转站域名>)与访问令牌。部分站点还需填写数字用户 ID(响应头 New-Api-User),填写后可正常取数。
  4. 点击「测试连接」确认可读取余额后保存。

数据口径

官方站点

  • 余额:GET /user/balance,取 balance_infos 中人民币项。
  • 今日消耗:本机采样推算。官方只提供余额接口,没有用量明细,因此插件记录余额随时间的变化,用「当日首个样本余额 − 当前余额」估算今日消耗,并按采样时刻判断该笔消耗落在高峰还是空闲时段。
  • 因此:DSH 未运行的时段不计入统计,插件首次使用的当天从启动时刻起算。
  • 端点与时段规则:高峰为北京时间周一至周五(不含法定节假日)09:00-12:00、14:00-18:00,其余时间为空闲,空闲单价为高峰的一半。设置里的「今天算节假日」开关用于临时调整判定。

中转站(new-api 系)

  • 余额:GET /api/user/self 的 data.quota 除以 quota_per_unit(来自 GET /api/status,默认 500000)得到基础金额;站点开启 display_in_currency 时再乘以 usd_exchange_rate(默认 7),单位按人民币显示,否则按美元显示。
  • 今日 / 本月已用:按优先级尝试三种接口,取到即止——
    1. GET /api/data/self(区间汇总,直接给 quota)
    2. GET /api/log/self/stat(区间统计)
    3. GET /api/log/self(明细列表逐条累加;单页被填满 100 条时视为统计不完整,不使用该结果)
  • 「本月起算」显示自然月首日,说明本月已用是从月初累计到现在,不会随账单日回退。

配置项

配置 位置 说明
刷新间隔 设置浮层 默认 300 秒,最小 60 秒
显示哪些站点 设置浮层 关闭后该站点不参与轮播
数据来源 官方站点卡片 DSH 已登录账号 或 手填 API key
用户 ID 中转站卡片 站点要求 New-Api-User 时填写
今天算节假日 设置浮层 强制把今天按空闲时段计价

配置文件:~/.dsh/usage-panel/config.json(站点与令牌)、~/.dsh/usage-panel/samples.json(余额采样,保留 4 天)。

隐私与安全

  • 所有请求只发往你在设置里填写的站点,以及 api.deepseek.com;没有第三方统计上报。
  • 令牌只写本机配置文件,界面上只显示前三位与后四位(例如 abc…wxyz)。
  • Windows 上 chmod 600 不生效,配置文件的实际保护来自用户目录权限;插件仍会尝试设置,失败不影响使用。
  • 插件提供的是本机只读诊断接口 GET /plugin/usage-panel/report,内容仅为版面几何信息,不含令牌。

已知限制

  • 手填官方 API key 是未验证路径:官方目前只对外提供 /user/balance,本机没有可用的官方 key,这条分支未经实测。它是「已登录账号」之外的可选来源,遇到问题时先改回账号来源再排查。
  • 官方今日消耗是采样估算,精度等于刷新间隔;插件未运行期间的消费不会被记录。
  • 中转站只按 new-api 的接口形态适配。其他面板(如 one-api 的不同分支)字段不一致时可能需要改 index.js 里的取数函数。
  • 不做跨站汇总:侧栏按站点轮播,浮层只显示当前站点自己的数字(不同站点的余额与单位不可直接相加)。
  • 只读取用量,不会触发任何计费操作。
  • 嵌入定位通过读取 DSH 侧栏现有 DOM 结构实现,不属于官方接口。宿主调整侧栏结构后需要重新适配;表现为面板回退为贴在「记忆」入口上方,其余功能正常。

开发

index.js            插件后端:取数、采样、配置读写、本地 HTTP 接口
client.js           界面部分:侧栏常驻块、悬停浮层、设置浮层
cordis.patch.yml    装配入口
locale/             中英文显示元数据
icon.svg            插件图标
docs/screenshots/   真实截图

开发时的生效规则:只改 client.js → Ctrl+R 即可;改 index.js、或动过 package.json / cordis.patch.yml → 完整退出重启。

许可

MIT

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:InkiChang/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 有哪些功能?

侧栏常驻用量块、多站点轮播显示、余额与今日消耗、峰谷时段标注、面板内设置与测试。

这条记录的数据可靠吗?

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

同名或近似条目

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

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-11-10。