Shawnxxboxx/dsh-balance

Name: Shawnxxboxx/dsh-balance
Author: Shawnxxboxx

插件Plugin 原生Native ⭐ 2 MIT

DSH插件：在对话下方显示DeepSeek账户余额

项目介绍Project Overview

由知微Agent(zhiwei)编辑Edited by Zhiwei Agent (zhiwei)

dsh-balance 是 DSH web 插件，在对话下方渲染紧凑余额条，每 15 秒轮询 host 路由刷新 DeepSeek 账户余额，悬停可看赠送与充值拆分，余额不可用时显示降级文案；API key 仅留 host 侧。适合想在聊天界面随时查看余额时使用。注意安装含 host 半，需重启 dsh web 并硬刷新浏览器。

dsh-balance is a DSH web plugin that renders a compact balance bar below the conversation, polling a host route every 15 seconds to show the DeepSeek account balance. Hovering reveals the granted and recharged split; if unavailable, it shows unobtrusive fallback text. The API key stays on the host side. Use it when you want balance visibility while chatting. Caveat: installation includes a host half, so restart dsh web and hard-refresh the browser.

在 GitHub 查看View on GitHub

发给你的 DSH 安装Send to your DSH

请帮我了解并安装插件：【dsh-balance】【https://github.com/Shawnxxboxx/dsh-balance】

把上面这条消息直接发给当前会话里的 DSH，让它帮你了解并安装。安装命令不一定准确，发给 DSH 更稳。Send this message to DSH in your current session. CLI install commands may not be accurate across systems — DSH will figure it out for you.

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

命令行安装CLI Install

dsh plugin --profile web add dsh-balance-dock

把 Shawnxxboxx/dsh-balance 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

3.4 KB · 缓存于 2026-08-27 05:41:45 · 3.4 KB

dsh-balance

在对话下方（消息区与输入框之间）显示 DeepSeek 账户余额的 DeepSeek Harness（DSH）web 插件。

Show the DeepSeek account balance below the conversation in the DSH web UI.

功能 Features

在 conversation.input.dock 槽位渲染紧凑余额条：💰 CNY 19.63
每 15 秒自动刷新（轮询 host 路由 /dsh-balance/balance）
悬停显示「赠送 / 充值」拆分
余额不可用时显示降级文案，不打扰对话
零依赖、无构建脚本；API key 只留在 host 侧，永不下发浏览器

安装 Install

前置：DSH 已安装且 dsh web 可正常运行；Node.js ≥ 20；pnpm ≥ 10（dsh plugin 需要）。

npm 包名是 dsh-balance-dock（dsh-balance 已被同名插件占用）；GitHub 仓库名是 dsh-balance，两者装出来是同一个插件。

# 从 npm 安装（推荐）
dsh plugin --profile web add dsh-balance-dock

# 或从 GitHub 安装
dsh plugin --profile web add git+https://github.com/Shawnxxboxx/dsh-balance.git
# 固定到 tag：git+https://github.com/Shawnxxboxx/dsh-balance.git#v0.1.0

装完重启 dsh web（插件含 host 半，需要重启挂载），然后硬刷新浏览器（Cmd/Ctrl+Shift+R）即可在对话下方看到余额条。

安装过程会自动完成 bundle 挂载（dsh.profile.bundles 会加入 dsh-balance-dock），无需手动编辑任何配置文件。

pnpm 11 用户注意：npm 发布不足 24 小时的新版本会被 pnpm 的 release-age 策略拦截（表现为装到旧版本）。遇到时把下面两行并入 profile 的 pnpm-workspace.yaml 后重装：
minimumReleaseAgeExclude:
  - dsh-balance-dock

手动/离线安装

git clone https://github.com/Shawnxxboxx/dsh-balance.git
cd dsh-balance
dsh plugin --profile web add .        # 以本地路径安装

更新 Update

dsh plugin --profile web add dsh-balance-dock        # npm 渠道
dsh plugin --profile web add git+https://github.com/Shawnxxboxx/dsh-balance.git   # GitHub 渠道

client 改动热加载（刷新即生效）；host 改动需重启 dsh web。

卸载 Uninstall

dsh plugin --profile web remove dsh-balance-dock

常见问题 FAQ

设置里看不到？ 打开设置 → 插件 → 插件列表（不是「插件配置」），搜索 dsh-balance-dock（列表显示名为 balance-dock，前缀 dsh- 被剥掉）。「插件配置」页只列出声明了设置项的插件。
显示「余额不可用」？ 确认 DEEPSEEK_API_KEY 已配置（通过 web 的模型设置页写入，或在启动环境导出）；确认能访问 https://api.deepseek.com/user/balance。
刷新频率想改？ 编辑 client/client.js 里的 POLL_MS，client 改动刷新页面即生效。

架构 Architecture

Host 半（lib/index.js）：通过 credentials 服务解析 DEEPSEEK_API_KEY，调用 https://api.deepseek.com/user/balance；只对环回地址 + 同源请求开放（GET /dsh-balance/balance），带 10s 超时与明确错误码。
Client 半（client/client.js）：手写 window.__ModuleLoader__.load bundle，注册 conversation.input.dock（order 30），每 15s 轮询 host 路由渲染余额。

License

渲染基于仓库 Shawnxxboxx/dsh-balance 的 README.md。在 GitHub 查看原文 →

命令行安装CLI Install 复制安装命令Copy Install