dsh-our-free-model-balance-zxp
> 前提：先装 dsh-our-free-model（OFM），并在里面登录至少一个渠道。
> 没有 OFM，这个插件装上也只会显示「读不到 Our Free Model」，不会有任何数字。
在 DSH 输入框旁显示 Our Free Model（OFM） 当前渠道的剩余额度，点开可看全部渠道。
它显示什么
- 图标：当前会话所用模型所属渠道的余额，切换模型会跟着变
- 面板：所有已登录渠道的总览，每个渠道一行
- 悬浮卡片：那一行的精确总额（两位小数），下面逐账号列出额度
显示规则：
| 情况 | 表现 |
|---|---|
| 渠道有余额 | 只显示数字，安静 |
| 余额为 0 | 红底 + 红边 + 加粗「用尽」 |
| 当前渠道 | 左侧一条该厂商的品牌色脊线 |
| 未登录的渠道 | 默认不出现（可在设置里打开） |
| 数字超过一千 | OFM 同款缩写（15K / 7.5K / 8.0M），悬浮卡片给精确值 |
前提
- 已安装 Our Free Model 插件，并在其中登录了至少一个渠道
- DSH ≥ 0.2.1（用到
connection.browserPeer与webServer的 prefix 路由）
安装
dsh plugin --profile desktop add github:zengxiangpeng123/dsh-our-free-model-balance-zxp
设置
设置 → 渠道余额：
- 自动刷新间隔（关闭 / 30 秒 / 1 分钟 / 5 分钟 / 自定义 15–3600 秒）
- 立即刷新
- 显示项：时间戳、单位、脊线、底部汇总、用尽标红、图标只显示色点
- 逐渠道隐藏 + 是否显示未登录渠道
它是怎么工作的
- 宿主侧轮询：DSH 主进程通过内核 RPC（
channel-pack）向 OFM 询问「谁登录了」，再只对已登录的渠道查余额，合成一份快照。 - 浏览器只读快照：客户端不直接调 OFM，只
GET /api/our-free-model-balance-zxp/snapshot，并定时发一次心跳（POST /watch）告诉宿主「还有人在看」。 - 省电：没人看的时候（心跳停了 150 秒）轮询自动停止；失败按指数退避（上限 10 分钟）。整轮失败时保留上一次的正确数字并标记为「可能已经不准」，而不是清空。
接口：/snapshot（GET）、/watch（POST）、/refresh（POST）、/settings（GET/PUT）。
已知限制
- 渠道表内置 10 个（lobsterai / qoder / qodercn / trae / cline / loomy / raccoon / minimax / zcode / gemini）。OFM 新增渠道后需要更新本插件才认识它（不认识的渠道会被忽略，而不是瞎猜数字）。
- 不同渠道单位不同（积分 / Token / USD / 配额），不做跨渠道换算或汇总。
- 宿主的本地接口不做鉴权（仅监听本机，与 DSH 其它插件一致）。
许可
MIT
