← 返回列表
需源码安装
在会话头部实时查看账户余额并悬停看明细
暂不能直接安装（需源码编译或环境不满足）：仓库 package.json 标记 private，未发布到 npm，需从源码安装。 · 最近上游提交 2026/9/5 · 已提供中文文档
一个用于 DeepSeek Harness 网页 GUI 的极简 DeepSeek 账户余额小组件
综合分
30.8
GitHub 分
30.8
用户评分
—
★ Stars
1
周下载量
—
兼容 / 相关生态插件（非 dsh 原生，请按其对应运行时安装）
git clone https://github.com/JovanHE/ds-balance.git数据截至 2026/9/6（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
安装兼容性检查需源码安装
以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。
✗npm 包@dsh-external/ds-balance（未发布到 npm，仅可源码安装）
✓Node 引擎要求 >=20 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明
仓库 package.json 标记 private，未发布到 npm，需从源码安装
验证方式：npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/19 09:04:51
依赖的 DSH / Cordis 模块
@deepseek-ai/cordis用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
ds-balance
一个极简的 DeepSeek 账户余额小组件，运行在 DeepSeek Harness（dsh）Web 界面里：会话头部右侧显示一个胶囊，展示 DeepSeek 账户余额，每 60 秒自动刷新，点击立即刷新。
ds-balance 在会话头部的效果
功能
- 会话头部实时余额胶囊（右侧）：显示币种与总余额，例如 DS CNY 3.65。
- 自动刷新：每 60 秒一次；点击立即手动刷新。
- 悬停看明细：总额 / 赠送余额 / 充值余额，支持多币种。
- 密钥安全：通过 DSH 凭据层读取 DEEPSEEK_API_KEY（~/.dsh/.credentials.yaml 或环境变量），密钥只放在子进程环境变量里，不进入命令行、不写入源码或浏览器。
- 只读且幂等：仅一次对余额接口的 HTTPS GET。
安装
dsh plugin --profile web add github:JovanHE/ds-balance
或从本地 checkout：
dsh plugin --profile web add /path/to/ds-balance
安装后需重启 dsh web（客户端插件发现只在进程启动时运行）。
使用
无需任何设置。只要配置了 DEEPSEEK_API_KEY（DSH 凭据库、.env 或环境变量），小组件就会出现在每个会话头部右侧。
- 点击胶囊立即刷新。
- 悬停查看完整明细。
- 若密钥缺失或请求失败，胶囊变红并在悬停提示里给出原因。
工作原理
客户端（浏览器） 宿主（dsh 进程）
───────────────── ─────────────────
头部胶囊 ── GET /__ds-balance ────> 路由处理器
│ │
└── 解析 JSON <────── JSON ────────────────┘
解析 DEEPSEEK_API_KEY（ctx.get("credentials")）
GET https://api.deepseek.com/user/balance
（ctx.shell / pwsh Invoke-RestMethod）
- 宿主半部（lib/index.js）：通过 ctx.get("credentials") 解析密钥，再经 ctx.shell 调用余额接口——该接口需要 Authorization 头，而 fetch 通道无法携带，因此以子进程 Invoke-RestMethod 执行，并显式使用 danger-full-access 策略（部署默认的 workspace-write 沙箱在 Windows 上无可用后端，且此调用只读）。它通过 ctx.webServer 注册 /__ds-balance HTTP 路由。
- 客户端半部（lib/client.js）：在 conversation.session.header.utilities 槽位注册胶囊，直接 fetch 同源 /__ds-balance 并渲染返回的 JSON。普通同源 fetch 不会产生任何会话事件，所以小组件每 60 秒的自动刷新不会污染对话或会话日志（若走命令派发，每次刷新都会写入 command/run + command/done 记录）。bundle 客户端里没有动态插件才有的 host/styles 全局，因此用 document 注入样式。
项目结构
lib/
index.js Host 半部：解析密钥 → 调用余额接口 → 注册 /__ds-balance 路由
client.js 客户端半部：会话头部胶囊小组件（bundle loader 契约）
assets/
widget-screenshot.png 小组件在 GUI 里的效果截图
package.json 声明 dsh.bundle + dsh.client
cordis.patch.yml 插入 host 插件行
依赖要求
- DeepSeek Harness（dsh）web profile
- Node.js ≥ 20
- 已配置的 DEEPSEEK_API_KEY 凭据
License
MIT扫码进群