dsh-balance（DeepSeek 余额查询）

DeepSeek 开放平台余额与当前会话消耗估算——deepseek-harness（dsh）的 常驻组合插件（Host + Web Client 双半），可通过 dsh plugin add 安装。

功能

• 余额查询：调用官方 GET https://api.deepseek.com/user/balance，复用 harness 自身的 DEEPSEEK_API_KEY 凭据（与 Models 页同一把）。密钥只经有界 node 子进程的 stdin 传递， 不进入命令行、日志或任何输出。
• 当前会话消耗估算：从会话日志折叠 provider 上报的 token 用量（未命中输入 / 缓存命中 / 输出）， 按官方价目表逐步骤计价（2026-08-16 23:59 北京时间前为旧固定价；之后按峰谷价， 高峰 9-12 / 14-18 北京时间）。仅为估算，以官方账单为准。
• 顶栏徽章（会话头部）：余额 ¥x | 会话 ≈¥y，点击刷新；悬停 500ms 显示明细气泡 （按钮正下方、水平居中、视口边缘自动夹紧）。
• 设置页（设置 → DeepSeek 余额）：余额、自动刷新间隔下拉、可编辑价目表 （旧价 / 空闲 / 高峰 × 模型）。改动持久化于设置文档。
• 模型工具：deepseek_balance——余额 + 调用方会话的预估消耗。
• 空闲降频：连续 2 个刷新周期无会话活动后，自动刷新降为 5 分钟，有活动即恢复。
• 完全自包含：部署无需修改宿主仓库任何代码（通信走内置 commands Remote 命名空间）。

安装

dsh plugin --profile web add @lemcae/dsh-balance

重启 dsh web（host 模块就绪后刷新页面即可），打开任意会话：顶栏出现余额徽章， 设置 → DeepSeek 余额 显示完整卡片。

手动安装（同一机制，不经过市场）：在 web profile patch（$DSH_HOME/profiles/web/cordis.patch.yml）加行：

- insert:
    - id: dsh-balance
      name: '@lemcae/dsh-balance'

Peer 依赖为官方 @deepseek-ai/* 包（^0.1.0-rc.6 线，@deepseek-ai/cordis ^4.0.1）与 react。

使用

• 徽章：显示 余额 ¥x | 会话 ≈¥y；点击刷新；悬停查看明细（构成、模型、更新于、刷新节奏/空闲提示）。
• 设置页：余额行、「自动刷新间隔」（15 秒 … 5 分钟）、价目表编辑（「保存」持久化）、切换时刻提示。
• 命令（命令面板也可用）：/dsh-balance [refresh | interval | prices ]。
• 工具：deepseek_balance（无参数）。

配置

settings 命名空间 dsh-balance：

字段	默认	含义
refreshIntervalMs	30000