前言¶
在 DeepSeek Harness（DSH）里用 Our Free Model（OFM）切换多家免费模型渠道时，额度往往分散在各渠道账号里，输入框附近默认不会告诉你「当前渠道还剩多少」。要逐个打开 OFM 或各厂商页面核对，打断对话节奏。社区维护者 zengxiangpeng123 提供的客户端插件 dsh-our-free-model-balance-zxp，在 DSH 输入框旁展示 OFM 各渠道的剩余额度；点开可看全部已登录渠道。它依赖已安装的 dsh-our-free-model 插件及其登录状态，本身不替代 OFM，只做只读展示与定时刷新。
这是什么¶
dsh-our-free-model-balance-zxp 是 DSH 社区插件目录中分类为「客户端」的扩展（当前 package.json 版本为 1.1.1，MIT 许可）。定位是：在宿主已安装 OFM 且至少登录一个渠道的前提下，把各渠道余额快照展示在输入框旁，并支持面板总览与悬浮详情。未安装或未登录 OFM 时，界面会显示「读不到 Our Free Model」，不会出现具体数字。
核心功能¶
下面介绍插件在界面上呈现的内容与规则（均来自项目 README）。
图标：显示当前会话所用模型所属渠道的余额；切换模型后图标随渠道变化。
面板：列出所有已登录渠道，每个渠道一行。
悬浮卡片：该行渠道的精确总额（两位小数），下方逐账号列出额度。
显示规则摘要：
| 情况 | 表现 |
|---|---|
| 渠道有余额 | 只显示数字 |
| 余额为 0 | 红底、红边、加粗「用尽」 |
| 当前渠道 | 左侧一条该厂商品牌色脊线 |
| 未登录的渠道 | 默认不出现（可在设置中打开显示） |
| 数字超过一千 | 与 OFM 同款缩写（如 15K、7.5K、8.0M）；悬浮卡片仍给精确值 |
前提与环境¶
- 已安装 Our Free Model 插件（
dsh-our-free-model），并在其中登录至少一个渠道。 - DSH ≥ 0.2.1（插件使用
connection.browserPeer与webServer的 prefix 路由；package.json中 engines 为dsh >= 0.2.1-rc.1）。
安装与启用¶
在 desktop 配置下执行官方安装命令：
dsh plugin --profile desktop add github:zengxiangpeng123/dsh-our-free-model-balance-zxp
安装前建议自行查看 GitHub 仓库源码与 MIT 许可证；插件在 DSH 进程权限下运行，与目录中其它社区插件一样，需自行评估是否满足环境要求。
设置¶
路径：设置 → 渠道余额。
可配置项包括：
- 自动刷新间隔：关闭 / 30 秒 / 1 分钟 / 5 分钟 / 自定义 15–3600 秒
- 立即刷新
- 显示项：时间戳、单位、脊线、底部汇总、用尽标红、图标只显示色点
- 逐渠道隐藏，以及是否显示未登录渠道
典型用法¶
- 先完成 OFM 安装与各渠道登录（见 OFM 插件文档）。
- 安装本插件后打开 DSH 客户端，在输入框旁查看当前渠道余额图标；需要总览时点开面板。
- 将鼠标悬停在某一渠道行上，查看精确总额与各账号明细。
- 若余额长期不更新，可在「渠道余额」设置里点「立即刷新」，或调整自动刷新间隔。
宿主侧通过内核 RPC（channel-pack）向 OFM 询问已登录渠道并查询余额，合成快照；浏览器端只读 GET /api/our-free-model-balance-zxp/snapshot，并通过 POST /watch 心跳告知宿主仍在观看。无人观看约 150 秒后轮询停止以省电；失败时指数退避（上限 10 分钟），整轮失败时保留上次正确数字并标记可能已不准，而非清空。
本地 HTTP 接口包括：/snapshot（GET）、/watch（POST）、/refresh（POST）、/settings（GET/PUT）。宿主本地接口不做鉴权，仅监听本机，与 DSH 其它插件一致。
适用场景与注意¶
适合：已在 DSH 中日常使用 OFM、需要在对话界面快速感知当前渠道与全渠道额度、避免额度用尽才发现的用户。
已知限制（README 原文）：
- 内置渠道表共 10 个：
lobsterai、qoder、qodercn、trae、cline、loomy、raccoon、minimax、zcode、gemini。OFM 新增渠道后需更新本插件才会识别；未识别渠道会被忽略，不会猜测数字。 - 各渠道单位不同（积分 / Token / USD / 配额等），不做跨渠道换算或汇总。
DSH 采用「一切皆插件」的扩展方式；社区目录站点 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-our-free-model-balance-zxp 在 OFM 之上补一层输入框旁的余额视图与可配置的刷新策略，适合把「还剩多少」留在对话界面里。安装命令与行为以仓库 README 为准。
- 目录页：https://www.skillhub.cn/plugins/zengxiangpeng123/dsh-our-free-model-balance-zxp
- GitHub：https://github.com/zengxiangpeng123/dsh-our-free-model-balance-zxp
