dsh-balance
DeepSeek Harness 余额与开销插件。在对话底部状态栏（composer dock）显示 DeepSeek / MiMo 账户余额与话费开销，支持逐请求计价、高峰/空闲分时段、多模型价目与花费超线提醒（点击状态栏即可设置）。
📦 已发布 npm：@yyfather/dsh-balance（npm registry，可一键安装）
功能
- 余额：实时查询 DeepSeek 账户余额（仅本机可访问，密钥只存在于 Host 侧；当前会话为 MiMo 等外部模型时不显示 DeepSeek 余额）
- 开销（逐请求精确计价）：按每个请求时间戳选高峰/空闲档价、按该请求的模型选价、同一步骤的 usage 样本按官方投影替换规则去重
本会话 = 当前会话从创建至今的全部花费本次活跃 = 自本次插件启用以来新产生的花费最近一次 = 当前会话最新一步请求的花费上次对话 = 当前会话之前的上一会话花费（MiMo 会话按小米美元价 × 汇率折算）
- 多模型价目：内置 DeepSeek V4 Flash / V4 Flash Vision Exp / V4 Pro（官方价，空闲/高峰双档）与小米 MiMo V2.5 系（美元价），可在点击面板中按模型+时段编辑，美元模型按可配置汇率换算
- 提醒：本次活跃花费 ≥ 提醒线（默认 ¥1）时状态栏变橙色徽标；DeepSeek 余额 < 提醒线（默认 ¥10）同样提醒；点击面板可改两线
- 刷新：每次对话结束后自动刷新 + 每 5 分钟自动刷新（可在面板中开关）
安装
方式一：插件市场一键安装（推荐）
市场（设置 → 插件市场）中出现本插件后，在可安装页点击卡片即可走 DSH 官方的受管安装（npm 身份校验 + 安全快照 + 重启验证）。
方式二：手动安装
- 克隆仓库到 DSH 的 profile 依赖目录（
%USERPROFILE%\.dsh\profiles\node_modules\@yyfather\dsh-balance 或你的 $DSH_HOME/profiles/<name>/node_modules/@yyfather/dsh-balance）：
git clone https://github.com/YYfather/dsh-balance.git "$USERPROFILE\.dsh\profiles\node_modules\@yyfather\dsh-balance"
- 在 profile 的
cordis.patch.yml 末尾追加（该文件是用户 patch 层，重装/升级不会覆盖；%USERPROFILE%\.dsh\profiles\desktop\cordis.patch.yml）：
- insert:
- id: dsh-balance
name: '@yyfather/dsh-balance'
- 重启 DSH Desktop。状态栏底部即出现余额/开销一行；点击可打开设置面板。
依赖
- Host 侧：
webServer、credentials（DeepSeek 密钥在 设置→模型 保存，默认引用 DEEPSEEK_API_KEY）、sessions / sessionQuery（会话与历史投影）、timer
- Client 侧：
slots（conversation.composer.dock）、React
- Node ≥ 20（Host 使用原生
fetch）
配置（Host cordis.patch.yml 行内可覆盖）
| 字段 | 默认 | 说明 |
|---|
apiKeyRef | DEEPSEEK_API_KEY | 余额查询所用凭据引用 |
baseUrl | https://api.deepseek.com | DeepSeek API 根地址 |
timeoutMs | 20000 | 上游查询超时 |
allowRemote | false | 不允许非本机访问插件路由（安全默认，勿随意外开） |
运行时价格/提醒线在点击面板中修改（进程内生效）。
安全
- 密钥仅在 Host 侧解析，浏览器端只访问
dsh-balance/api/* 本机同源路由（默认拒绝本机以外的来源）
- 路由响应不含任何上游原文、密钥或未经校验的字段
License
MIT
