DeepSeek Harness 插件

dsh-deepseek-balance

DeepSeek Harness 插件:在侧边栏实时展示 DeepSeek API 余额(英文原文)

跳到安装方式

来源信息

GitHub 仓库
kyya/dsh-deepseek-balance
最近更新
2026年8月14日
分类
用量与账单
GitHub stars
1
载体类型
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/kyya/dsh-deepseek-balance
插件名:dsh-deepseek-balance
作者:kyya

检查来源文件

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

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-deepseek-balance

一个 DeepSeek Harness(dsh)插件:在 Web 侧边栏底部(设置按钮上方)实时展示 DeepSeek API 账户余额。余额数据由 Node 侧定时拉取,浏览器侧每 30s 轮询一次, 点击指示器可立即强制刷新。

  • 状态点颜色:绿 = 可用;黄 = 账户不可用;红 = 拉取失败;蓝 = 加载中。
  • 悬停显示完整明细(总额 / 赠送 / 充值 / 更新时间)。
  • API key 每次拉取时经 credentials 服务解析,永远不会下发给浏览器

安装

# 把插件装进 web profile(本地目录方式)
dsh plugin --profile web add /绝对路径/dsh-deepseek-balance

# 或从 git 安装
dsh plugin --profile web add github:kyya/dsh-deepseek-balance

然后重启 dsh webdsh plugin 只会装依赖,插件集变更要重启才生效):

dsh web

打开 http://127.0.0.1:3080,侧边栏左下角即可看到余额指示器。

配置

默认读取凭据 DEEPSEEK_API_KEY(即 ~/.dsh/.credentials.yaml 里、或 DEEPSEEK_API_KEY=… 环境变量、或「设置 → 模型」里保存的那个 key)。 在 ~/.dsh/profiles/web/cordis.patch.yml 里覆盖(覆盖整行 config,需写全字段):

- id: deepseek-balance
  config:
    refreshMs: 60000                 # 后台刷新间隔(毫秒)
    apiKeyEnv: DEEPSEEK_API_KEY      # 凭据引用名
    baseUrl: https://api.deepseek.com
    endpoint: /user/balance

工作原理

半边文件职责
host(Node)index.js定时 GET <baseUrl><endpoint>(Bearer 鉴权),缓存快照;用 webServer.register 暴露 /deepseek-balance
browserclient.jssidebar.footer.action 插槽注册 React 指示器;轮询 /deepseek-balance,点击带 ?refresh=1 强制刷新。

余额接口返回形如:

{ "is_available": true, "balance_infos": [{ "currency": "CNY", "total_balance": "123.45", "granted_balance": "0.00", "topped_up_balance": "123.45" }] }

卸载

dsh plugin --profile web remove dsh-deepseek-balance