deepseekplugins

DeepSeek Harness 插件

dsh-balance-deepforce

Human-facing /balance slash command that queries the DeepSeek account balance（英文原文）

用量与账单
跳到安装方式

来源信息

GitHub 仓库
deepforce/dsh-balance
最近更新
2026年8月15日
分类
用量与账单
GitHub stars
3
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt，让 Agent 读 GitHub 仓库和源码；需要自己装时再切到命令。

复制这段 Prompt，发给 DSH、Codex 或其他 Agent，让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码，然后用清楚、直接的方式回答以下问题，帮助我判断它是否适合我的需求：

1. 这个插件是什么，解决什么问题；
2. 适合哪些用户和典型使用场景；
3. 安装后如何使用，并给出一个最小使用示例；
4. 有哪些已知限制，以及隐私、安全、兼容性或维护风险；
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明，不要猜测或照抄 README。

GitHub：https://github.com/deepforce/dsh-balance
插件名：dsh-balance-deepforce
作者：deepforce

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器4 个文件
README.zh.md来源说明 · 只读预览
README 语言

dsh-balance

English | 中文

一个 DeepSeek Harness 插件：为 Web GUI 添加 /balance 斜杠命令和对话框底部常驻的余额显示，实时查询 DeepSeek 账户余额。

它调用 DeepSeek 官方 查询余额 接口，返回每种货币的总额、充值与赠送余额。API key 通过凭证服务（ctx.credentials）或环境变量按次解析——绝不写入配置、返回文本或进入浏览器。

功能

  • /balance — 人用斜杠命令，在会话里输出完整的余额明细。
  • Web GUI 底部余额条 — 对话页统计条区域（缓存命中率下方）显示简洁的 余额: ¥…，hover 显示充值/赠送详情，附带 充值 链接（跳转 DeepSeek 平台充值页）、手动刷新按钮，以及估算的 本会话 ≈ ¥… 花费（hover 显示 token 分桶 × 单价）。浏览器只请求宿主端的 /dsh-balance 路由；API key 始终留在宿主端。文案双语，跟随 dsh 当前语言（中文 / English）。
  • 每日消耗图 — 悬停 近{days}天 ≈ ¥… 时，一张带标题的柱状图会像漫画对话气泡一样从摘要向上浮出：纵轴为金额刻度（¥），横轴每根柱子标注日期，hover 柱子显示当天详情（日期、金额、请求数、token 明细），移出即收起。数据来自宿主端 /dsh-usage 路由：遍历已持久化的会话，折叠 assistant/message 的用量，并按每次请求发生时所在的时段单独计价。

会话花费估算

本会话 ≈ ¥… 按 DeepSeek 公布的每百万 token 单价（高峰/空闲分档，按当前北京时间自动选择），对会话累计 token 用量计价——数据源与统计条「缓存命中率」用的是同一个 tokenUsage 投影。这是估算值，不是账单记录：模型取配置的 estimateModel（而非每个请求实际使用的模型），缓存写入 token 不计价。价格可通过 offpeakPrices / peakMultiplier / peakWindows 配置项调整。

兼容性

已在 DeepSeek Harness 0.1.0-rc.6（web profile，Windows 11）上实测通过——/balance 命令与对话框底部余额条均于 2026-08-14 在线验证。npm 上的 @deepseek-ai/dsh-* 包处于 pre-release（无兼容性承诺）；若新版 dsh 改变了 conversation.composer.dock 槽位或 webServer 服务，请重新验证并提交 issue。

安装

方式 A：dsh plugin（推荐）

推送后执行：

dsh plugin --profile web add github:deepforce/dsh-balance

把 github:deepforce/dsh-balance 换成你的实际 git 地址。该 bundle 同时安装两部分：宿主端插件（斜杠命令 + /dsh-balance 路由）和浏览器端底部余额条插件（因为包声明了 dsh.client）。安装后重启 dsh web，让客户端插件表扫描到新条目。

方式 B：--patch overlay

# balance.cordis.yml
- insert:
    - id: balance
      name: '@deepforce/dsh-balance'
dsh web --patch "$PWD/balance.cordis.yml"

配置

字段默认值含义
apiKeyEnvDEEPSEEK_API_KEY凭证引用（环境变量名），每次调用解析
baseURLhttps://api.deepseek.comAPI 端点基础地址
timeoutMs10000单次请求超时（毫秒）
estimateModeldeepseek-v4-flash会话花费估算使用的模型
offpeakPrices{input: 1.5, cacheHit: 0.05, output: 4.5}空闲时段每百万 token 单价（CNY：未缓存输入 / 缓存命中 / 输出）
peakMultiplier2高峰时段相对空闲价格的倍数
peakWindows[[9,12],[14,18]]北京时间高峰时段，格式 [开始小时, 结束小时)
topUpUrlhttps://platform.deepseek.com/top_up底部余额条「充值」链接的目标页面
usageDays7每日消耗图默认覆盖的历史天数

用法

  • 在会话输入框敲 /balance：

`` Balance (CNY): 110.00 Topped up: 100.00 Granted: 10.00 ``

  • Web GUI 中，输入框下方的统计条区域显示 余额: ¥110.00 充值 ⟳ · 本会话 ≈ ¥0.42；hover「余额」查看充值/赠送拆分，点击 ⟳ 手动刷新。

安全

  • apiKeyEnv 是凭证引用：优先通过 dsh 凭证服务解析，其次环境变量。key 从不硬编码或打印。
  • 浏览器端只通过宿主端 /dsh-balance 路由获取公开的余额数字；key 始终留在宿主端。
  • 只调用 GET https://api.deepseek.com/user/balance，无其他数据离开进程。

本地构建

pnpm install        # 依赖 pnpm-workspace.yaml 的 overrides 以绕过上游 npm 缺失包
pnpm run build      # tsc（宿主端 + 类型）→ tsdown（lib/client.js 浏览器 bundle）
pnpm run typecheck

上游 @deepseek-ai npm 版本（0.0.1-rc.1）声明了几个 npm 上不存在的依赖；pnpm-workspace.yaml 将它们别名到真实包，以便本仓库安装和构建。dsh 运行时从自己的依赖树解析这些包，因此这些 overrides 不影响已安装的插件。

许可证

MIT

返回搜索打开 GitHub 仓库

更多相关插件

查看分类