前言¶
在 DSH(DeepSeek Harness)里用 dsh-our-free-model 走多渠道免费额度时,积分读数默认落在「设置 → 插件 → Channel Pack」里,对话输入框旁边没有常驻余额。若再装 dsh-connect-workbuddy、dsh-connect-trae 等各自带胶囊的插件,功能会重复。另一类麻烦是模型选择器里多家平台可能同名(例如都叫 DeepSeek-V4.1-Flash),只看原名很难判断请求会发到哪条渠道。
下面介绍社区维护的客户端插件 dsh-our-free-model-composer-credits:在输入框工具行左侧挂一枚轻量「积分胶囊」,数据全部来自上游 channel-pack 的 RPC;并在模型列表里为渠道包模型名加上平台前缀,便于区分同名模型。
这是什么¶
dsh-our-free-model-composer-credits 是 dsh-our-free-model 的衍生插件,维护者为 liushQAQ,许可证 MIT,当前包版本 1.1.0。它不联网、不持凭证、不直接读账号数据——显示与切号都依赖已安装的 dsh-our-free-model 内嵌 channel-pack。
挂载点为 Cordis 插槽 conversation.input.left(会话输入框工具行左侧)。插件未发布到 npm,需从 GitHub 或 Release tarball 安装。
强制前置:先装 dsh-our-free-model¶
这不是可选依赖。未装宿主插件时,胶囊只显示 —,点开是空面板,不报错、不崩,但无实际作用。
建议安装顺序:
- 安装
dsh-our-free-model(channel-pack自 2.0.0 起提供本插件依赖的 RPC;README 建议用最新 2.5.x),并至少登录一个渠道账号。 - 再安装本插件。
本插件依赖的 RPC 包括:usage.badge、account.list、credits.balances、account.reorder、provider.status。1.x 老版 dsh-our-free-model 装了也无法正常工作。
dsh-our-free-model 2.5.8 起上游已移除 WorkBuddy 国内版(buddy)与国际版(workbuddy);本插件自 v1.0.3 起同步不再展示这两个渠道。继续用旧版强行调用 WorkBuddy 存在封号风险,README 明确不建议回退。
核心功能¶
输入框积分胶囊¶
- 常驻读数:形如
● Raccoon 7,160(渠道短名 · 余额),约每 5 分钟自动刷新。 - 点击开面板:一行一账号 + 余额;点某行即「秒切」——通过
account.reorder把该账号排到首位,改写 channel-pack 的自动选号 / 限流换号优先级。 - 渠道切换:面板顶部列出仍有账号的渠道,选择写入
localStorage,跨会话保留。 - 降级显示:读不到余额显示
—,不显示 0。
读数优先走 usage.badge(宿主侧约 120s TTL 缓存);打开面板时再拉 account.list、credits.balances,避免按账号数放大上游读取。
模型名平台前缀(v1.1.0)¶
宿主半体注入 llm,在 llm.listModels / llm.resolveModelInfo 出口把渠道包模型 name 改写为 <平台> · <原名>(例如 LobsterAI · DeepSeek-V4.1-Flash · x0.05)。只改显示用 name,id、路由与上下文元数据不变;非渠道 provider 原样透传。升级后需重启 DSH 才会生效。
当前支持的渠道(12 个)¶
codearts、lobsterai、qoder、qodercn、trae、cline、loomy、raccoon、minimax、zcode、gemini、opencode。
安装与启用¶
在 DSH Profile 目录(例如 ~/.dsh/profiles/desktop)执行。npm i dsh-our-free-model-composer-credits 会 E404,只能走 GitHub 源。
先做前置(在同一 profile 下):
pnpm add dsh-our-free-model
再装本插件:
# pnpm
pnpm add github:liushQAQ/dsh-our-free-model-composer-credits
# 或 npm
npm i github:liushQAQ/dsh-our-free-model-composer-credits
也可用 Release tarball:
pnpm add https://github.com/liushQAQ/dsh-our-free-model-composer-credits/releases/latest/download/dsh-our-free-model-composer-credits.tgz
装完后在 dsh.profile.bundles 中加入 dsh-our-free-model-composer-credits,重启或重载 profile。
典型用法¶
- 确认
dsh-our-free-model已装且至少有一个渠道账号已登录。 - 打开任意会话,看输入框左侧胶囊是否显示「渠道短名 + 余额」;若只有
—,先排查宿主插件与账号状态。 - 需要固定某账号优先时,点胶囊打开面板,点对应账号行即可完成 reorder。
- 多渠道并存时,在面板顶部 chips 切换当前查看/操作的渠道。
- 选模型时,借助带平台前缀的
name区分同名模型,发送逻辑仍按原有id路由。
RPC 经宿主 connection 服务调用 /api/channel-pack;连接不可用时会机会式降级,不让整个插槽崩溃。
适用场景与注意¶
适合谁:已在用 dsh-our-free-model、希望把余额和切号放到输入框旁、并希望在模型列表里分清各平台同名模型的 DSH 用户。
运行权限:插件随当前 DSH profile 与进程加载,安装前宜自行查看 GitHub 仓库 源码与 MIT 许可证。
生态说明:DSH 社区插件目录(如 SkillHub 条目)为独立站点,与 DeepSeek / 幻方无官方从属关系;本文事实以仓库 README 与 package.json 为准。
结尾¶
dsh-our-free-model-composer-credits 把 channel-pack 的余额与切号能力收敛到输入框一枚胶囊,并补上模型名的平台前缀显示,前提始终是先正确安装并配置 dsh-our-free-model。
- 目录页:https://www.skillhub.cn/plugins/liushQAQ/dsh-our-free-model-composer-credits
- GitHub:https://github.com/liushQAQ/dsh-our-free-model-composer-credits