dsh-deepseek-balance

给 DeepSeek Harness 装的余额小插件:模型可以随时查余额,浏览器顶栏常驻余额按钮,点开看明细、手动刷新。

非官方社区插件,与 DeepSeek 无隶属关系。

功能

组件	说明
模型工具	deepseek_balance:agent 可调用,每次执行实时查询 GET https://api.deepseek.com/user/balance,返回 is_available 与分币种余额明细(总余额/赠送余额/充值余额)
浏览器按钮	会话顶栏 💰 按钮:显示当前总余额,点击弹出明细面板(总/充值/赠送 + 更新时间),可手动刷新
自动轮询	宿主每 pollIntervalMs(默认 3 分钟)查询一次并缓存;按钮与工具共享同一缓存,并发查询合并为一次在途请求

密钥解析:DEEPSEEK_API_KEY(环境变量 / 根 .env / 凭据存储 ~/.dsh/.credentials.yaml),工具也可用 api_key 参数临时覆盖。

装它

npm 安装(推荐,已发布到 npm registry)

# 在 profile 目录(~/.dsh/profiles/web)执行:
pnpm add @wanyantiande/dsh-deepseek-balance

# 然后编辑 cordis.patch.yml,加:
#   - insert:
#       - id: deepseek-balance
#         name: '@wanyantiande/dsh-deepseek-balance'

重启 dsh web 即可用。

从源码装

git clone https://github.com/WanYanTianDe/dsh-deepseek-balance.git
cd dsh-deepseek-balance
pnpm install && pnpm build
# 手动装配(link 到 profile + cordis.patch.yml insert,见下)

配置

字段	类型	默认	说明
pollIntervalMs	number	180000	自动查询间隔(毫秒)

# cordis.patch.yml 的插件 entry 下:
config:
  pollIntervalMs: 180000

常见问题

Q: 余额查不到? 确认 DEEPSEEK_API_KEY 已配置(环境变量 / 根 .env / ~/.dsh/.credentials.yaml);查询失败时按钮面板与工具会显示错误信息。

Q: 查询走代理吗? 查询使用宿主进程内 Node fetch 直连 api.deepseek.com,不走子进程;网络代理由系统/环境配置决定。

给开发者

bash scripts/build.sh      # 构建:安装依赖 + 打包(需要 DSH 源码,见下)+ 泄漏护栏
pnpm test                  # 测试(4 例,不需要 DSH 源码)
pnpm build                 # 打包 → lib/index.js + lib/client.js

构建需要 DSH 源码:设环境变量 DSH_CHECKOUT 指向 DSH 源码目录,或建链接 ~/.dsh/source/current → DSH 源码目录。插件目录放在 ~/.dsh/plugins/ 下(开发依赖用相对路径引用 DSH 检出)。

收录信息

项	值
npm 包名	@wanyantiande/dsh-deepseek-balance(npm registry, public)
GitHub topic	dsh-plugin
分类(taxonomy v2)	🔧 工具 / 🤖 Agent 能力
测试	vitest 4 例
许可	MIT

许可

• 插件本体:MIT(见 LICENSE)
• 依赖的 DeepSeek Harness:MIT