dsh-composer-balance

DSH PLUGIN通知与集成

仓库 Ushio155/dsh-composer-balance

通知与集成 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

为 DeepSeek Harness 输入框工具行常驻余额小字与刷新按钮,支持刷新间隔、低余额告警,并可在对话中直接查询余额。

一句话选型结论

按资料字段整理

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

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

安装

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

    兼容的 DSH 版本为 0.2.0-rc.2;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

兼容 DSH 版本0.2.0-rc.2版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名未发布到 npm可用 npm view 查看包信息

能做什么

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

dsh-composer-balance:把 DeepSeek 余额常驻在 DeepSeek Harness 输入框工具行

  • 输入框常驻余额与刷新
  • 可配刷新间隔与告警
  • 对话内查询余额工具
  • 密钥经 stdin 不落盘

适用场景

通知

上游标签

balancecomposercordisdeepseek-harnessdshdsh-plugin

验证等级与安全审查

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

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

逐项检查结果

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 插件清单中已激活 方式:插件清单查询

风险详情

  • 审查结论 通过
  • 结论说明 vet 静态分析未发现可疑行为,判定为干净(clean)。
  • 风险计数 严重 0 / 高 0 / 中 0
  • 风险详情 未发现严重或警告级问题。

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.0-rc.2),按版本装不容易报错。
  • 列出了 4 项功能,能直接看出它解决什么问题。

先想清楚的地方

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

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-composer-balance当前 L5 · 运行验证通过 低风险 1 0.2.0-rc.2 有
treg L3 · 安装规范通过 低风险 4,976 未标注 无
dsh-purge 未做沙盒验证 未标注 3,412 未标注 有
dsh-im L5 · 运行验证通过 低风险 1,837 0.1.7-rc.2 等 10 个 有
dsh-aurabot-qq 未做沙盒验证 未标注 633 未标注 有
dsh-dafeiyu L5 · 运行验证通过 低风险 425 0.1.7-rc.2 等 10 个 有

仓库档案

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

README 全文

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

dsh-composer-balance

> 在 DeepSeek Harness 的输入框工具行左端常驻一枚余额小字 + ↻ 刷新按钮,设置页可配刷新间隔与低余额告警,对话里还能直接问「查一下余额」。

这是已停更插件 kte66/dsh-balance 的接替实现,修掉了它的三个实际缺陷,保留它最直观的那部分 UX。

为什么会有这个插件

上游 kte66/dsh-balance 停更(最后提交 2026-08-16,一天内 6 次提交,1 star,无 release,从未上 npm,不在插件市场目录内),且存在三个必须修的问题:

上游缺陷 实测 本插件
密钥写入临时文件,声明 mode: 0o600 Windows 上该模式不生效,实测 0o666;进程被杀时残留 密钥经 stdin 传给 curl --header @-,不落盘、不进 argv
HTTP 路由无任何来源策略 同浏览器任意页面可读余额 校验 Origin 与 Sec-Fetch-Site,跨源返回 403
无条件遮蔽内置 cordis-panel 徽标 DSH 变更该槽位语义即波及内置 UI 改为设置项且默认关闭

此外:失败指数退避、标签页隐藏时暂停轮询、路由与配置键命名空间化、纯函数带单元测试。
完整取证与取用范围见 PROVENANCE.md,威胁模型见 SECURITY.md。

与上游/替代品的关系

保留的 UX 契约(这是它的价值所在):余额直接常驻输入框区域,不是悬浮球、不是桌宠、不是侧边栏、也不需要点开面板。

若市场里出现了同样把余额放在输入框区域、且活跃维护的插件,可以平滑迁移:本插件的设置项与上游一致(刷新间隔、低余额阈值),差异仅在配置键与路由名(见 PROVENANCE.md 变更摘要)。

安装(本地 profile,推荐)

适用于 DSH 以文件插件方式加载(随 DSH 启动自动生效,无需审批)。

  1. 把本仓库放到稳定路径(不要放在会话工作区或临时目录——一旦目录丢失,DSH 会因解析不到 bundle 而无法启动):
D:\code_practice\AI_coding\dsh-composer-balance
  1. 编辑 $DSH_HOME/profiles//package.json:
{
"dependencies": {
"dsh-composer-balance": "link:D:/code_practice/AI_coding/dsh-composer-balance"
},
"dsh": {
"profile": {
"bundles": [
// …原有 bundles…
"dsh-composer-balance"
]
}
}
}

> Windows 路径在 JSON 中用正斜杠。

  1. 让 bundle 解析器能找到它——建目录联接(junction):
New-Item -ItemType Junction `
-Path "$env:DSH_HOME\profiles\web\node_modules\dsh-composer-balance" `
-Target "D:\code_practice\AI_coding\dsh-composer-balance"

或直接在 profile 目录执行 pnpm install。

  1. 验证解析:
node -e "console.log(require.resolve('dsh-composer-balance/package.json', { paths: ['$env:DSH_HOME/profiles/web'] }))"
  1. 确认凭证(插件不硬编码密钥,缺失时显示红色 余额 —):
# $DSH_HOME/.credentials.yaml
DEEPSEEK_API_KEY: sk-xxxx
  1. 重启 DSH(Host 端改动需重启;此后仅改客户端只需刷新页面)。

验证安装

# 1) 路由存活:应返回含 balance_infos 的 JSON
curl.exe -sS http://127.0.0.1:3080/ds-composer-balance

# 2) 来源策略生效:应返回 403
curl.exe -sS -H "Origin: http://evil.example" http://127.0.0.1:3080/ds-composer-balance

UI 侧:输入框工具行左端出现 ¥ x.xx 小字 + ↻;设置页出现「DeepSeek 余额」卡片。

设置项

项 默认 说明
自动刷新间隔 60 秒 允许 5–86400 秒;失败时按 2 的幂退避,上限 15 分钟
低余额告警阈值 ¥10 低于阈值数字变红并显示 ⚠;0 = 关闭
启用自动刷新 开 关闭后只能点 ↻ 手动刷新
隐藏内置 Cordis 徽标 关 开启会遮蔽内置 UI 入口,仅在明确需要时打开

配置存于浏览器 localStorage,键 dsh-composer-balance:config。

模型工具

对话中说「查一下余额」即可触发 deepseek_balance,返回按币种的总余额、赠送余额、充值余额与账户可用状态。

开发

node test/host.test.mjs   # 8 条断言,含"密钥不进 argv"的回归锁
  • lib/index.js — Host 半部:路由 + 模型工具 + 凭证处理(零第三方 import,仅 node: 内置)
  • lib/client.js — 浏览器半部:经典脚本 bundle,改动后刷新页面即生效,无需重新构建
  • cordis.patch.yml — bundle 组合补丁(向 profile 根插入一行)

三条不变量由测试锁定,改动后必须仍成立:密钥不进 argv、密钥经 stdin 传递、无写密钥到磁盘的路径。

许可

MIT。上游 kte66/dsh-balance 在 package.json 声明 MIT 但未附 LICENSE 文件,取用范围与许可状态说明见 PROVENANCE.md。

维护规约、升级自检、发布渠道与卸载步骤见 MAINTENANCE.md。

常见问题

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

在 DSH 里执行 `dsh plugin --profile web add github:Ushio155/dsh-composer-balance#v0.1.1` 即可。

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

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

dsh-composer-balance 安全吗?

低风险。vet 静态分析未发现可疑行为,判定为干净(clean)。

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

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

dsh-composer-balance 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.0-rc.2。

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

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

dsh-composer-balance 有哪些功能?

输入框常驻余额与刷新、可配刷新间隔与告警、对话内查询余额工具、密钥经 stdin 不落盘。

这条记录的数据可靠吗?

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

同名或近似条目

2 条
不同作者的仓库分开列,请确认你要装的是哪一个
通知与集成
按星标排序,可作替代方案

treg

treg

Treg 是面向 Agent 工具的 OpenRouter,聚合 60 个提供商的 2896 个端点,按调用计费,统一令牌访问,无需注册各供

L3 · 安装规范通过 4,976 星

dsh-purge

dsh-purge

dsh-purge Community · DeepSeek Harness 社区维护版:宿主兼容、状态诊断、提示词管理、更新与本机备份回滚

未标注验证等级 3,412 星

dsh-im

dsh-im

将IM机器人接入DeepSeek Harness,支持飞书、微信、钉钉等九种渠道,通过扫码或凭据配置,统一管理多机器人连接。

L5 · 运行验证通过 1,837 星

dsh-aurabot-qq

dsh-aurabot-qq

让 DeepSeek Harness 里的 AI 以「大肥鱼」人格住进 QQ,通过 OneBot v11 网关聊天、发表情语音、写空间日记并

未标注验证等级 633 星

dsh-dafeiyu

dsh-dafeiyu

DSH 大肥鱼是一款由 DeepSeek Harness 真实工作状态驱动的桌面伴侣插件,以始终置顶的透明窗口实时展示 Agent 的思考、

L5 · 运行验证通过 425 星

dsh-trading

dsh-trading

L3 · 安装规范通过 235 星

Ushio155 的其它插件

1 个

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