dsh-plugin-deepseek-balance

DSH PLUGIN工具与能力

仓库 MatthewTian2018/dsh-plugin-deepseek-balance · npm dsh-plugin-deepseek-balance

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

在 DeepSeek Harness 设置里新增「余额」分区,用环形仪表展示账户余额、赠金与充值构成、日均消耗和可用天数,并绘制 24 小时至全部区间的余额趋势,让你不必再切浏览器查余额。

一句话选型结论

按资料字段整理

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

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

安装

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

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

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

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

能做什么

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

dsh-plugin-deepseek-balance:在 DeepSeek Harness 设置里查看余额的 DSH plugin

  • 环形仪表显示余额占比
  • 区分充值余额与赠金
  • 日均消耗与可用天数
  • 四档余额趋势曲线
  • 每 10 分钟后台采样

适用场景

通知

上游标签

balancedashboarddeepseekdeepseek-balancedeepseek-harnessdshdsh-pluginplugin

验证等级与安全审查

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

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

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

不太适合

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

同类对比

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

仓库档案

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

README 全文

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

dsh-plugin-deepseek-balance

DeepSeek 余额仪表盘插件 —— 在 DeepSeek Harness(DSH)的「设置 → 余额」里查看账户余额、余额构成、消耗速度与余额趋势。

设置 → 余额
┌──────────────────────────────────────────────┐
│  DeepSeek 余额                    ● 实时      │
│  ┌────────┐   总余额 ¥86.05                   │
│  │  86%   │   赠金 ¥5.82 · 充值 ¥80.22        │
│  └────────┘   预算 ¥100                       │
│  日均消耗 ¥1.28   可用约 67 天                 │
│  趋势 ────╲╱────  24 小时 / 7 天 / 30 天 / 全部 │
└──────────────────────────────────────────────┘

这是什么

DeepSeek Harness(DSH)插件,不是独立应用。它由两半组成,并用 dsh.bundle 声明自己是可安装的组合包(bundle):

信号 位置
dsh-plugin topic 本仓库 GitHub Topics(dsh-plugin、dsh、deepseek-harness…)
dsh.bundle 声明 根目录 package.json → "dsh": { "bundle": { "patch": "./cordis.patch.yml" } }
插件模块(导出 apply(ctx)) lib/index.js:export const name、export const inject、export function apply(ctx)
浏览器半边 lib/client.js:window.__ModuleLoader__.load({ id: 'dsh-plugin-deepseek-balance', … })
Token 用量模块 lib/token-usage.js:读 ~/.dsh/sessions 里多帧 zstd 会话日志,按天/周/月聚合

一句话价值:装完不用再切浏览器查余额 —— 打开 DSH 设置就能看到还剩多少钱、按当前速度还能撑几天。

安装就一行(桌面端把 web 换成 desktop):

dsh plugin --profile web add github:MatthewTian2018/dsh-plugin-deepseek-balance

> ⚠️ 不要用裸包名安装本插件:npm 上 dsh-plugin-deepseek-balance 是另一位作者(fanlr)发布的同名不同项目(dsh-plugins/packages/balance)。本插件目前没有、也不能用这个名字发到 npm,请按上面的 github: 形式或 tgz 安装。

功能

  • 环形仪表:以预算为分母显示当前余额占比,预算可在页面内直接改(防抖 450 ms 落盘)。
  • 余额构成:区分充值余额与赠送余额,多币种按币种符号显示(CNY / USD / EUR / JPY)。
  • 消耗指标:日均消耗、按当前速率可用的天数、预算剩余、距上次快照时间。
  • 余额趋势:24 小时 / 7 天 / 30 天 / 全部四档,鼠标悬停看单点数值,宽度自适应(ResizeObserver)。
  • Token 使用趋势:按天 / 按周 / 按月切换,堆叠显示缓存命中、输入、输出;今日 / 本周 / 本月用量与缓存命中率一眼可见。数据来自本机会话日志,不需要额外接口。
  • 后台采样:Host 每 10 分钟补一次快照,即使不打开设置页,趋势也不断档。
  • 本地优先:Key、历史、预算全部留在本机,浏览器只拿到数字。

组成

半边 文件 作用
Host lib/index.js 挂 GET /api/deepseek-balance/summary、POST /api/deepseek-balance/budget;请求 DeepSeek /user/balance;落盘采样历史
Client lib/client.js 注册 settings.section:「余额」分区,环形仪表 / 构成 / 趋势 / 指标
Host 子模块 lib/token-usage.js 解压 ~/.dsh/sessions/**/session*.jsonl.zstd,抽出 assistant/message 的 usage,按天/周/月分桶
Bundle cordis.patch.yml 被 profile 作为组合包(bundle)引入时,把自己插进 Loader 树

本包是一个组合包:package.json 里 dsh.bundle.patch 指向 cordis.patch.yml,被 profile 的 dsh.profile.bundles 列出时生效。

安装

要求:DSH 已能正常启动,本机已配置可用的 DeepSeek API Key。验证环境:DSH 0.2.2-rc.1(桌面端与 web 端共用同一套 profile 机制)。

把命令里的 --profile web 换成你实际用的 profile(桌面端是 desktop)。装完都要重启 DeepSeek Harness,插件才会被 Loader 挂载。

> 本包刻意没有声明 engines.dsh。DSH 在缺少该字段时退回检查 @deepseek-ai/dsh* peer 依赖范围,而本包只 peer 了 @deepseek-ai/cordis: *,因此不会被版本号(尤其是 -rc 预发布号)拒装。

方式一:一行命令,从 GitHub 源码安装(推荐)

dsh plugin --profile web add github:MatthewTian2018/dsh-plugin-deepseek-balance

本包没有 prepare / 构建脚本(lib/ 里就是可运行源码),所以 pnpm 不会向你索要 allowBuilds 授权,省掉这一步。生产环境建议锁 commit:

dsh plugin --profile web add github:MatthewTian2018/dsh-plugin-deepseek-balance#

方式二:发布包(tgz)

从 Releases 下载 .tgz:

dsh plugin --profile web add ./dsh-plugin-deepseek-balance-0.1.2.tgz

装完的 profile package.json 会多出依赖,dsh.profile.bundles 末尾会追加 dsh-plugin-deepseek-balance:

{
"dependencies": { "dsh-plugin-deepseek-balance": "file:./dsh-plugin-deepseek-balance-0.1.2.tgz" },
"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "…", "dsh-plugin-deepseek-balance"] } }
}

方式三:本地目录(改代码用)

图形界面:设置 → 插件 → 安装,填本地路径 /path/to/dsh-plugin-deepseek-balance。

或手动:

git clone https://github.com/MatthewTian2018/dsh-plugin-deepseek-balance.git
cd ~/.dsh/profiles/desktop
pnpm add link:/path/to/dsh-plugin-deepseek-balance   # link: 便于改代码即时生效

再把包名加进该 profile package.json 的 dsh.profile.bundles:

{
"dsh": { "profile": { "bundles": ["dsh-plugin-deepseek-balance"] } }
}

> 用 link:(符号链接)而不是 file::file: 会硬链一份副本,改代码不会生效。

卸载

dsh plugin --profile web remove dsh-plugin-deepseek-balance

校验是否装好

dsh --profile web --dump-config | grep -A2 '^# == dsh-plugin-deepseek-balance'

应看到 # == dsh-plugin-deepseek-balance 层与 - id: deepseek-balance 行。

配置

API Key 只在 Host 进程读取,按以下顺序:

  1. 环境变量 DEEPSEEK_API_KEY
  2. ~/.dsh/.credentials.yaml(DSH 自己的凭证文件)
环境变量 默认值 说明
DEEPSEEK_API_KEY 自动读取 显式指定 Key
DEEPSEEK_API_BASE https://api.deepseek.com 接口地址

数据文件(都不进仓库):

  • ~/.dsh/deepseek-balance/history.json —— 余额采样,最多 20 000 条,新采样与上一条间隔 < 45 s 时合并
  • ~/.dsh/deepseek-balance/config.json —— 预算(默认 100)

接口

方法 路径 说明
GET /api/deepseek-balance/summary?force=1 余额 + 余额趋势 + 指标 + 预算 + token 用量(usage.day/week/month);15 s 缓存,force=1 跳过
POST /api/deepseek-balance/budget {&quot;budget&quot;: 100},仅接受 POST

两条路由挂在 DSH 自身的鉴权之后:未带登录 cookie 一律 401,且只监听回环地址。

安全

  • Key 绝不下发浏览器;前端只拿余额、趋势、预算这些数字。
  • 不写任何远程服务;除了 api.deepseek.com,插件不发起其它请求。
  • Token 用量只读本机 ~/.dsh/sessions 会话日志,读出来的只有时间和 token 数,原文内容不解析、不上送。

已知限制

  • DeepSeek 余额接口只返回当前快照,历史是本插件采样出来的,装完当天曲线从零开始积累。
  • settings.section 是设置页的一个分区,所以仪表盘长在设置里,不是独立主页面。
  • 后台采样依赖 DSH 进程常驻;关闭 DSH 期间不会有采样点。
  • Token 趋势只覆盖本机会话日志:其他设备、其它客户端或直连 API 的用量不在里面;会话日志被清理后对应统计也会消失。
  • 只统计 assistant/message 记录里的 usage,压缩摘要(compaction)等记录不计入。

开发

两份代码的生效方式不同:

改动 生效方式 原因
lib/client.js 保存后 Cmd + R 刷新 前端 bundle 由 Loader 在页面启动时装配
lib/index.js 重启 DeepSeek Harness Host 半边走 ESM 模块缓存,热替换拿不到新代码

调试 Host 路由:

curl -s http://127.0.0.1:/api/deepseek-balance/summary | head -c 400
# 未登录 cookie 会返回 401,属预期:先 GET /?token= 换 cookie

数据目录 ~/.dsh/deepseek-balance/ 可以直接删掉重置,插件会重新建。

发布(维护者)

# 1. 改版本号(package.json)与 CHANGELOG.md
# 2. 打包装进 dist/,先 dry-run 确认清单
npm pack --dry-run
npm run pack                                  # → dist/dsh-plugin-deepseek-balance-.tgz

# 3. 推代码、打 tag、建 Release 并挂上 tgz
git add -A &amp;&amp; git commit -m &quot;chore: release v&quot;
git push origin main
git tag v &amp;&amp; git push origin v
gh release create v dist/dsh-plugin-deepseek-balance-.tgz \
--title &quot;v&quot; --notes-file &lt;(sed -n &#x27;/^## v/,/^## v/p&#x27; CHANGELOG.md | head -n -1)

files 字段决定包里带什么(lib/、cordis.patch.yml、README.md、LICENSE),package.json 自动带上;dist/、node_modules/ 不进包也不进仓库。

关于发布到 npm

package.json 已去掉 &quot;private&quot;: true,具备发布条件;但包名 dsh-plugin-deepseek-balance 已被他人占用(fanlr 的同名插件 v2.0.0),直接 npm publish 会 403。要走 npm 分发需要先换成带 scope 的名字,例如:

npm pkg set name=@/dsh-plugin-deepseek-balance
npm publish --access public
# 用户侧:dsh plugin --profile web add @/dsh-plugin-deepseek-balance

换名前请同步更新本仓库 README 的安装命令与 profile 里的依赖名。

License

MIT

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:MatthewTian2018/dsh-plugin-deepseek-balance#v0.1.5` 即可。对应的 npm 包名是 `dsh-plugin-deepseek-balance`。

dsh-plugin-deepseek-balance 的验证等级是什么意思?

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

dsh-plugin-deepseek-balance 安全吗?

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

dsh-plugin-deepseek-balance 装之前要先确认什么?

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

dsh-plugin-deepseek-balance 支持哪些 DSH 版本?

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

dsh-plugin-deepseek-balance 需要什么运行环境?

Node.js >=20;需要同时安装 @deepseek-ai/cordis@*。环境不满足时安装会失败,建议先确认本机版本。

dsh-plugin-deepseek-balance 用的是什么许可证?

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

dsh-plugin-deepseek-balance 有哪些功能?

环形仪表显示余额占比、区分充值余额与赠金、日均消耗与可用天数、四档余额趋势曲线、每 10 分钟后台采样。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 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。