dsh-balance：在會話中查看 DeepSeek 賬戶餘額

在 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 倉庫。