在 DeepSeek Harness（DSH）中构建智能体时，开发者通常需要精确掌握 API 调用的成本。yyfather/dsh-balance 插件解决了这一需求，它将 DeepSeek / MiMo 的账户余额与逐请求计费信息直接展示在对话底部的状态栏（composer dock）中。
功能¶
- 实时余额查询：实时查询 DeepSeek 账户余额。密钥仅存储在 Host 侧，仅本机可访问。当当前会话为 MiMo 等外部模型时，DeepSeek 余额不显示。
- 逐请求精确计价：支持按每个请求的时间戳选择高峰/空闲档价，按模型选价，并使用官方投影替换规则去重。支持四种计费维度：
- 本会话：当前会话从创建至今的全部花费。
- 本次活跃：自本次插件启用以来新产生的花费。
- 最近一次：当前会话最新一步请求的花费。
- 上次对话：当前会话之前的上一会话花费（MiMo 会话按小米美元价 × 汇率折算）。
- 多模型价目：内置 DeepSeek V4 系列（Flash/Vision Exp/Pro 等）与小米 MiMo V2.5 系列的价目。支持峰谷定价，可在面板中按模型+时段编辑。美元模型按可配置汇率换算。
- 花费超线提醒：当本次活跃花费 ≥ 提醒线（默认 ¥1）或 DeepSeek 余额 < 提醒线（默认 ¥10）时，状态栏变为橙色徽标。点击状态栏面板可修改这两条提醒线。
- 自动刷新：每次对话结束后自动刷新余额 + 每 5 分钟自动刷新（可在面板中开关）。
安装¶
方式一：插件市场（推荐）¶
在 DSH 的设置 → 插件市场中找到本插件，在可安装页点击卡片即可完成安装。
方式二：手动安装¶
- 克隆仓库到 DSH 的 profile 依赖目录：
git clone https://github.com/YYfather/dsh-balance.git "$USERPROFILE\.dsh\profiles\node_modules\@yyfather\dsh-balance"
- 在 profile 的
cordis.patch.yml末尾追加：
- insert:
- id: dsh-balance
name: '@yyfather/dsh-balance'
- 重启 DSH Desktop。
配置与使用¶
- 密钥配置：在 DSH 的设置 → 模型中保存 DeepSeek 密钥，插件默认引用
DEEPSEEK_API_KEY。 - Host 侧覆盖：在
cordis.patch.yml中可覆盖以下配置项：
apiKeyRef: DEEPSEEK_API_KEY # 余额查询凭据引用
baseUrl: https://api.deepseek.com # API 根地址
timeoutMs: 20000 # 上游查询超时
allowRemote: false # 安全默认，不允许非本机访问
- 运行时设置：点击状态栏面板，可编辑价格档位与提醒线，修改在进程内生效。
依赖与安全¶
- 依赖：需安装 Node >= 20 以支持 Host 原生 fetch。依赖 Host 侧的
webServer、credentials、sessions、sessionQuery和timer服务，以及 Client 侧的slots和react。 - 安全：密钥仅在 Host 侧解析，浏览器端只能访问本地路由（
dsh-balance/api/*）。默认配置不允许非本机访问插件路由（allowRemote: false），路由响应不含任何上游原文或密钥。
总结¶
该插件通过状态栏集成，为开发者提供了直观的余额监控和逐请求计费能力。对于需要精细化控制 DeepSeek 调用成本的用户，这是一个实用的工具。
