dsh-route-balance：在 DeepSeek Harness 侧边栏实时显示账户余额

DSH（DeepSeek Harness）的理念是“一切皆插件”。在开发或日常使用中，管理多个 API 提供商和订阅的余额是一项重复性任务。dsh-route-balance 旨在解决这个问题，它允许开发者在一个地方查看所有配置的 API 路线余额以及 ChatGPT/Codex 订阅的剩余额度。

核心功能¶

该插件在 DSH 侧边栏直接显示各条 API 路线（模型厂商与中转站）的账户余额。它支持多种数据源，包括 DeepSeek、OpenRouter、智谱、小米 MiMo 等。显示的格式通常为货币符号与金额的组合，例如 ● ¥12.90 · $13.14 · GPT 剩 49%。

除了 API 余额，插件还支持读取 Codex 本机服务的额度信息。

安装与启用¶

在使用前，请确保满足以下环境要求：
* Node.js 20 或以上版本
* DSH 版本 0.2.0-rc.2 或以上

注意：当前版本（0.6.4）为实验版（pre-release），接口和配置默认值可能变化。npm 包尚未发布，请按 GitHub 固定版本安装，不要跟随浮动的分支名。

在终端中执行以下命令进行安装：

dsh plugin --profile desktop add github:Ronniealgo/dsh-route-balance#v0.6.4

安装成功后，按照 DSH 的提示重启应用。

配置说明¶

插件默认将组件插入到侧边栏底部。可以通过 YAML 配置文件调整以下参数：

- insert:
    - id: route-balance
      name: "dsh-route-balance"
      config:
        slot: sidebar.footer.action
        refreshMs: 300000
        requestTimeoutMs: 15000
        cacheMs: 10000
        maxStaleMs: 86400000
        codex:
          strategy: auto
          warmMs: 240000
          timeoutMs: 20000
          snapshotPath: null

配置项	含义
`slot`	组件插入位置，默认为侧边栏底部
`refreshMs`	页面轮询刷新间隔，默认 5 分钟
`requestTimeoutMs`	每条供应商读取的总时限，默认 15 秒
`cacheMs`	host 每家短缓存时间，默认 10 秒
`maxStaleMs`	上次成功读数的保留上限，默认 24 小时
`codex.strategy`	Codex 额度读取策略：`auto`（后台读取）、`snapshot`（仅读快照）、`off`（隐藏且不读）
`codex.snapshotPath`	快照文件路径，默认按环境变量 `CODEX_HOME` 或用户 Codex home 查找

使用示例¶

界面显示示例：

● ¥12.90 · $13.14 · ¥0.10 · GPT 剩 49%

Codex 快照命令：

node tools/codex-quota.mjs --write

适用场景与注意事项¶

断线保护：页面隐藏或断网时会暂停请求，恢复后立即补更新。断线期间会保留上次显示的余额。
安全机制：API Key 仅在 host 使用，通过 DSH 的凭据解析服务解析，不直接读取 auth 文件。
缓存清理：认证失败、凭据拒绝访问或配置变化会清除对应的旧余额。
独立容错：各来源独立超时和恢复，一个接口挂起不会冻结整个余额栏。
生态背景：该插件属于社区插件，DSH 官方与 DeepSeek/幻方无从属关系，市场收录与“已验证”状态仅代表自动化检测结果，不代表安全审计。

结语¶

dsh-route-balance 提供了一个集中、实时的余额监控视图，适合需要频繁切换或管理多个 API 资源的 DSH 用户。使用前请确认源码与许可证。

GitHub 仓库
 DSH 插件市场