DeepSeek Harness Hub
← 返回列表

余额查询qiuyongjin/dsh-balance

DeepSeek Harnessspec-screened在 GitHub 查看 ↗
未验证

查询 DeepSeek 账户余额并在输入区常驻显示

尚未跑自动兼容性验证,可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/16 · 已提供中文文档

DSH 插件:查询并显示 DeepSeek 账户余额(dsh_balance 工具 + Web UI 小组件)

综合分
27.6
GitHub 分
27.6
用户评分
★ Stars
1
周下载量
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add qiuyongjin/dsh-balance
该插件未发布到 npm,走 GitHub 源安装(pnpm 若拦截 prepare 脚本,按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑)
数据截至 2026/9/16(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis@deepseek-ai/dsh-client-runtime@deepseek-ai/dsh-credentials@deepseek-ai/dsh-host-webserver@deepseek-ai/dsh-tools@deepseek-ai/dsh-client-ui-conversation
用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

dsh-balance

DSH 插件:查询并展示 DeepSeek 账户余额(/user/balance API)。工具可查、Web UI 会话输入区常驻显示,TypeScript 双面开发,零运行时依赖。

能力

| 类型 | 名称 | 说明 |
|---|---|---|
| Tools | dsh_balance | 调用 DeepSeek GET /user/balance,返回账户可用状态与各币种余额明细(总余额 / 赠送余额 / 充值余额),headless / web 通用 |
| UI(web) | 输入区余额入口 | 填官方 conversation.input.right slot:按钮常驻显示当前总余额,点击展开明细卡片(可用状态 / 各币种明细 / 更新时间),手动刷新 |

工作原理

- 节点侧:注册 dsh_balance 工具;同时经 webServer(可选后端,ctx.inject 等待就绪,headless 组合下不挂载)暴露 GET /plugins/dsh-balance/balance JSON 端点,供浏览器拉取。
- 浏览器侧:惰性 CJS client bundle(window.__ModuleLoader__.load 包装)填充官方 conversation.input.right slot,同源 fetch 余额端点——API key 只存在于节点侧,浏览器不接触凭据。
- API key:通过 DSH 凭据服务解析(默认引用 DEEPSEEK_API_KEY,Web 的 Models 设置页可直接写入),凭据服务缺席时回退到启动环境变量;每次调用实时解析,改 key 无需重启。与官方 dsh-llm-deepseek 的取值方式一致。
- 取消语义:工具执行合并超时与调用方取消(AbortSignal.any),符合 dsh-tools 的协作取消契约。

安装

dsh plugin --profile web add ./dsh-balance

bundle 层栈变更需重启生效:

dsh --profile web

重启后,会话输入区工具行右侧(发送按钮前)出现 🔋 余额入口,按钮上直接显示当前总余额;会话中向代理提问"查询 DeepSeek 余额"同样可用工具查询。启动日志出现 [dsh-balance] plugin loaded(API key 引用:DEEPSEEK_API_KEY,基地址:https://api.deepseek.com) 即挂载成功。

配置

默认配置开箱即用;如需覆盖,在 profile 的 cordis.patch.yml 按行 id 覆盖(patch 整替换 config,需重述全部键):

- id: dsh-balance
config:
apiKeyEnv: DEEPSEEK_API_KEY
baseURL: https://api.deepseek.com
timeoutMs: 10000

| 键 | 默认值 | 说明 |
|---|---|---|
| apiKeyEnv | DEEPSEEK_API_KEY | 读取 API key 的凭据引用(POSIX 环境变量名) |
| baseURL | https://api.deepseek.com | DeepSeek API 基地址 |
| timeoutMs | 10000 | 请求超时(毫秒) |

开发

pnpm install
pnpm run build       # tsc 产出 lib/types(含 JS emit)+ tsdown 产出 lib/index.js / lib/client.js
pnpm run typecheck   # 严格类型检查(单一 tsconfig 覆盖 node + client 两侧)
pnpm run watch       # tsdown 增量重建(client half)

lib/ 为构建产物,勿手改——改源码后重新构建。单一 tsconfig 覆盖两侧(DOM lib 与 @types/node 全局共存),tsconfig.decl.json 产出 lib/types;node half 由 tsdown 从 tsc emit 打包(@deepseek-ai/* 依赖内联,运行期零依赖),client half 从源码打包为惰性 CJS bundle(react external 走平台种子表)。

验证

- 类型:pnpm run typecheck
- 挂载冒烟:安装并重启后,启动日志出现插件加载行;会话输入区工具行右侧出现余额入口
- 工具调用:在会话中向代理提问"查询我的 DeepSeek 余额",确认返回账户可用状态与余额明细

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

💬 加入 DPharness 群聊

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

点击加入 QQ 群
DPharness 群聊二维码,手机 QQ 扫码进群
扫码进群