dsh-balance: Check DeepSeek Account Balance in Conversation

在 DeepSeek Harness 中，查看账户余额通常需要打开浏览器面板或进入设置页面，这会打断当前会话的工作流。dsh-balance 插件通过注册 /balance 命令，直接在会话中读取并展示 DeepSeek 账户的余额信息，无需离开当前终端或聊天窗口。

插件定位¶

dsh-balance 是由 DWJZ 维护的一个客户端插件。它将 DeepSeek 的账户余额查询功能集成到会话交互中，支持查看可用余额、充值金额及赠送金额。

核心功能¶

1. 命令注册：注册 /balance 命令，其输出为命令自身的文本，直接在发起会话中渲染，不会发送给模型。
2. 余额读取：通过 GET {baseUrl}/user/balance 读取账户余额，并报告每一笔资金的充值和赠送部分。
3. 缓存控制：支持 /balance refresh 命令绕过缓存，强制重新读取。
4. 密钥解析：支持通过配置文件指定 apiKey 或使用 apiKeyRef（默认为 DEEPSEEK_API_KEY）引用凭证或环境变量，支持密钥轮换。
5. 故障处理：在读取失败时，显示最后一次成功读取的余额并提示状态，而非隐藏已知余额。

安装¶

使用官方安装命令添加插件：

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

配置与使用¶

该插件需要配置 cordis.patch.yml 才能正常工作。配置文件路径通常为 $DSH_HOME/profiles/<profile>/cordis.patch.yml。

示例配置：

- id: dsh-balance
  config:
    apiKey: ''                        # 显式密钥，留空则使用 apiKeyRef
    apiKeyRef: DEEPSEEK_API_KEY       # 凭证引用或环境变量名
    baseUrl: https://api.deepseek.com
    timeoutMs: 10000
    cacheMs: 30000                    # 缓存有效期，单位毫秒

使用示例：

1. 查看当前余额：
   /balance
   （输出示例：DeepSeek 账户余额（可用），CNY 总余额 ¥293.58 · 充值 ¥293.58 · 赠送 ¥0.00，读取于 2026/9/18 13:20:41）

2. 刷新余额（绕过缓存）：
   /balance refresh

注意事项¶

• 依赖项：该插件依赖 @deepseek-ai/cordis。
• 配置要求：必须正确配置 cordis.patch.yml 中的密钥信息才能完成读取。
• 缓存机制：缓存有效期为 30000 毫秒，刷新命令可覆盖此限制。
• 许可证：许可证为 MIT。
• 生态背景：DeepSeek Harness 理念是「一切皆插件」，本插件为社区维护项目，与 DeepSeek / 幻方无官方从属关系。

总结¶

dsh-balance 通过简单的命令行接口简化了余额管理流程。对于需要频繁监控账户资金状态的开发者，这是一个集成度高且实用的工具。更多细节请参考 GitHub 仓库。