LemCAE/dsh-balance 预览 preview

LemCAE/dsh-balance

一个适用于deepseek-harness的插件,功能是显示当前账户余额以及当前会话预估的费用消耗。

Project Overview项目介绍

This plugin is built natively for DeepSeek Harness (DSH) and can only be installed and run on DSH. It fetches your DeepSeek Open Platform account balance and estimates the spending of the current active session based on token usage logs. To install the plugin using the recommended method, you can run the command dsh plugin --profile web add @lemcae/dsh-balance, which will automatically add the dependency and apply the configuration after you restart dsh web. If you prefer a manual install, you can edit the package.json of your web profile, add the dependency to both dependencies and the DSH bundle list, then run pnpm install and restart DSH.

Once installed and DSH is restarted, the plugin will add a chip to the top bar of every session that displays your current account balance and the estimated spending for the session. You can click the chip to manually refresh the balance, and hovering over it for 500 milliseconds will pull up a tooltip with more detailed breakdown information. The plugin also adds a dedicated settings page under DSH’s settings menu where you can adjust a range of options, including toggling auto-refresh on or off, setting a custom refresh interval, changing the UI language, and editing price tables for different models. This plugin also exposes a deepseek_balance tool that AI agents can call directly to get balance and spending information.

The plugin is released under the open-source MIT license, so it is free to use and modify for any purpose. It requires peer dependencies of the official @deepseek-ai/* packages and React, which are already provided by the DSH host environment, so you do not need to install them separately. The development team notes several known limitations to keep in mind: the session spending is only an estimate, and your official DeepSeek bill is the authoritative source; unknown models use the default price; and subagent sessions are not included in the spending estimate. The auto-refresh feature is also pause-aware, and will pause after two cycles of no new messages to reduce unnecessary API calls and noise in the session log.

这是一个专为 DeepSeek Harness (DSH) 开发的原生插件,核心功能是查询用户DeepSeek开放平台账户余额,并根据当前会话的token使用量估算本次会话的消费金额。插件可通过DSH官方的dsh plugin add命令快速安装,支持标准捆绑安装和手动编辑配置文件两种方式。它复用DSH已存储的API密钥,密钥不会出现在命令行、日志或界面中,保障密钥使用安全。

插件安装完成后,重启DSH即可生效,会在会话顶部栏显示余额和当前会话估算消费的标签,点击可刷新余额,悬浮可查看详细明细。用户可进入设置页面的DeepSeek余额面板调整配置,支持开启或关闭自动刷新、设置自动刷新间隔、切换界面语言、编辑不同模型的峰谷价格。它还提供了模型工具deepseek_balance可供AI代理调用查询余额和会话消耗。

该插件遵循MIT许可证开源,免费供用户使用。它依赖DSH官方提供的@deepseek-ai/*相关包和React,这些依赖由DSH宿主环境提供,无需用户额外安装。插件明确说明会话消费仅为估算值,官方账单为准,还存在一些已知限制,比如未知模型使用默认费率,子代理会话不计入估算,这些都需要用户注意。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 4 stars - very few users, little community feedback星标只有 4,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @lemcae/dsh-balance

把 LemCAE/dsh-balance 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-balance

English | 中文

awesome · DSH plugin

A Host + Web Client composition plugin for deepseek-harness (dsh): queries the DeepSeek Open Platform account balance and estimates the current session's spend. Installable via dsh plugin add.

1786767329895

1786767316204

1786899004009

Features

  • Balance: queries the official GET https://api.deepseek.com/user/balance using the harness's own DEEPSEEK_API_KEY credential (the key travels only over a bounded node subprocess's stdin — never in command lines, logs, or UI).
  • Session spend estimate: folds the provider-reported token usage from the session log (uncached input / cache-hit input / output) and prices each step with the official peak/off-peak table (peak 9:00–12:00 and 14:00–18:00 Beijing time). Estimate only — the official bill is authoritative.
  • Top-bar chip (session header): 余额 ¥x | 会话 ≈¥y, click to refresh; hover (500 ms) shows a detail tooltip below the button, horizontally centered and viewport-clamped.
  • Settings page (设置 → DeepSeek 余额): balance rows, an auto-refresh on/off switch, refresh-interval selector (15 s … 5 min or custom), UI-language selector (auto follows the host UI / 中文 / English), and an editable price table (off-peak / peak per model). Changes persist in the settings document across restarts.
  • Model tool: deepseek_balance returns balance + the calling session's estimated spend.
  • Pause-aware refresh: after 2 refresh cycles without a new user or assistant message the auto-refresh pauses (5-minute detection cadence); it resumes when a new conversation appears. Auto-refresh can also be switched off manually (Settings switch or /dsh-balance auto-refresh off); while off, no queries are issued.
  • Self-contained: no host-repository changes are required to deploy (communication rides the built-in commands Remote namespace).

Installation

Standard (bundle install, recommended):

dsh plugin --profile web add @lemcae/dsh-balance

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev silk-background 下一个 Next deepseek-harness-media →