ARTICLE · 1369136
DSH 插件推荐:Our Free Model 把多模型渠道与本地 API 网关接进 DSH
DSH 插件推荐:Our Free Model 把多模型渠道与本地 API 网关接进 DSH
本期推荐:Ebony-Vinyl/dsh-our-free-model项目名称: Our Free Model采集时间: 2026-11-15 11:07(Asia/Taipei)最新正式插件 Release: v2.8.4(2026-11-14)数据提醒: 24h 数值来自第三方追踪站的滚动窗口,页面仅显示约数
+1.5k,未公开精确窗口边界和精确差值。本文不把它冒充成 GitHub 官方精确排名。
1. 模型接入不该成为 Agent 工作流的瓶颈
使用 Agent 做开发,麻烦往往不是没有模型,而是模型接入成本太高:每换一家模型就要注册账号、申请 API Key;不同网关的可用性和地区策略不同;本地工具、DSH 和模型供应商各自维护一套配置;推理模型的思考强度参数也不一定会被上游真正执行。
Our Free Model 想做的是把模型接入层统一起来。
它是一个面向 DeepSeek Harness(DSH)的模型 Provider 插件:提供公开免费模型通道、可选账号渠道、用户自带 Key 的 Provider 聚合、本地 OpenAI / Anthropic 兼容网关、模型路由和用量看板。
它近期的 Star 增长很显眼,但它不是“官方免费模型服务”,也不能把“免费”理解成无限额度或隐私保证。本文会把功能和使用边界一起讲清楚。
2. 项目热度数据
| 约 74.4k | ||
| 约 +1.5k | ||
| 约 +8.3k | ||
| +57.4k | ||
| 2026-11-14 | ||
| v2.8.4,2026-11-14 | ||
数据核验说明
OSS Radar 在 2026-11-15 报告该仓库约 74k Stars、最近 24h +1.5k、最近 7d +8.3k。它还列出 11 月 10–14 日连续多天约 +1.3k 至 +1.5k 的日增量,说明增长并非只出现一天。 GitTrend 报告最近 30 天约 +57.4k;Hysen Labs 对 10 月 15 日至 11 月 14 日的日快照统计为 +54,946。两者窗口和采样时点不同,不能当作同一口径的精确值。 GitHub 页面当前显示约 74.4k Stars,不是 API 精确整数。 DSH 生态没有一个覆盖所有插件、且公开精确滚动 24h 差值的统一官方排行榜。因此本期把它列为当前可查数据中最值得关注的强增长候选,不宣称已经穷尽所有插件并证明其绝对第一。 本文排除此前已推荐过的项目;也没有把 DSH 桌面客户端 dsh-Go、DSH 核心仓库等非插件项目混入插件排名。
数据来源:
OSS Radar:24h / 7d 增长、日度榜单、最近提交与 Release GitTrend:30 天 Star 历史 Hysen Labs:2026-10-15 至 2026-11-14 日快照 GitHub 官方仓库 GitHub Releases
3. 插件简介
Our Free Model 由 Ebony-Vinyl 维护,使用 MIT License。它通过 DSH 插件机制注册模型 Provider,不需要修改 DSH 内核。
它不只是一个免费模型列表,而是一个模型接入与转发层,主要包含:
OpenCode Zen 与 Kilo AI 的公开免费模型通道; 桌面宿主可用的 EAC 协付通道; 多个第三方 AI 编码产品的账号渠道; 用户自带 API Key 的多 Provider 聚合; 本地 OpenAI / Anthropic 兼容转发服务; 思考预算控制、Fallback / Round-robin 路由和 Token 用量看板。
它是独立社区项目,不是 DeepSeek 官方插件,也不代表 DeepSeek、Kimi 或其他模型厂商为其背书。
4. 最值得关注的 5 个功能
4.1 动态模型清单与真实可用性探测
插件会从上游刷新模型清单,并根据当前机器的网络出口探测模型是否可路由:
上游明确返回模型不存在或拒绝路由:从可选模型列表移除,并在设置页留下原因; 地区策略限制:放入 region-limited分组;暂时性 5xx、429、超时或断网:不直接判定模型永久不可用。
这比维护一份写死的模型名称列表更实用,尤其适合模型和免费额度变化较快的环境。
4.2 真实思考预算,而不只是传一个参数
部分模型支持 reasoning_effort 档位,插件会将档位传给上游。对于没有标准思考档位的模型,插件提供 Light / Balanced / Deep 等预算层级,将选择映射到实际输出 Token 上限,而不是只在 Prompt 里写“请深入思考”。
不同模型的推理机制不同,预算档位不保证所有模型得到相同质量或速度,但至少让资源上限有可检查的依据。
4.3 本地 OpenAI / Anthropic 兼容网关
启用本地转发后,插件提供统一 API:
GET /v1/modelsPOST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesPOST /v1/messages/count_tokens
这样,除了 DSH 本身,本机其他支持相应协议的开发工具也可以调用已接入的模型。默认监听回环地址,API Key 从设置页生成;不要为了方便直接把本地服务暴露到公网。
4.4 多 Provider 聚合与模型路由
插件内置多个第三方 Provider 的配置目录。用户可以在设置页填入自己持有的 API Key,把 OpenRouter、Groq、Cerebras、Gemini、DeepSeek、Mistral、SiliconFlow、Ollama、LM Studio 等服务汇入同一个模型选择器。
还可以把多个模型车道组合成命名路由:
fallback:从首选模型开始,失败时切换下一个; round-robin:轮换请求起点。
这对开发测试、模型可用性波动和不同成本档位的任务分流有实际价值。
4.5 用量看板与 Token 节省
插件提供请求数、Token 用量、首字延迟、输出速度等本地统计;另有工具输出压缩与提示词瘦身选项。README 中的压缩比例属于项目自己的测试结果,不代表每个仓库和每种工具输出都能得到同样节省。建议先在自己的任务上对比压缩前后的输出质量。
5. 实际使用场景
场景 A:个人开发者快速验证 Agent 能力
不想为了短期测试给每个模型供应商注册账号,可以先试用公开免费通道,验证 DSH 工具调用、Prompt、Agent 流程和插件逻辑。不要将生产代码、客户数据或密钥放入公开免费通道。
场景 B:统一本地 Coding Agent 的模型入口
如果本机同时使用 DSH、Codex、Claude Code 或其他兼容客户端,可以通过本地转发网关统一模型地址和 Key,减少每个工具单独维护 Provider 的工作。
场景 C:模型故障自动降级
某个模型临时 429 或上游故障时,可以把多个模型组成 Fallback 路由,避免一次临时故障就让整个工作流中断。
场景 D:比较模型推理预算与响应表现
用看板观察不同模型的首字延迟、Token 消耗和响应速度,再根据任务类型选择模型和预算档位。代码补全、简单问答和复杂架构分析不必一律使用同一档模型。
场景 E:接入自有 API 与本地模型
如果已经有 OpenRouter、Groq、Gemini 或本地 Ollama / LM Studio 服务,可以把它们放进统一选择器;免费通道不是唯一使用方式。
6. 安装方式
6.1 推荐方式:从官方 v2.8.4 源码目录安装到 DSH Web
当前仓库 README 提供本地目录安装方式。选择它是因为仓库的 npm scoped 包安装曾出现包名、Cordis 挂载名和前端注册 ID 不一致的问题;GitHub Issue #796 对 2.8.0、2.8.2、2.8.3 的 npm scoped 安装失败有具体复现。虽然 v2.8.4 已发布,但我没有找到该 Issue 对 v2.8.4 的明确复测关闭记录,所以不把 scoped npm 安装写成已验证无问题。
# 1. 拉取官方 v2.8.4 taggit clone --depth 1 --branch v2.8.4 \https://github.com/Ebony-Vinyl/dsh-our-free-model.git# 2. 进入源码目录cd dsh-our-free-model# 3. 安装到 DSH Web profiledsh plugin --profile web add "OFM_BASE_URL/v1/models" \-H "Authorization: Bearer OFM_BASE_URL/v1/chat/completions" \-H "Authorization: Bearer MODEL_ID\",\"messages\": [{\"role\": \"user\",\"content\": \"请解释这个项目的模块边界,并给出一份代码审查清单。\"}],\"stream\": false}"
模型 ID 必须以本机 /v1/models 的实际返回为准,不要照搬网上旧截图里的模型名称。
7.3 配置 Fallback 路由
在 Settings → Our Free Model → Routing / 路由 页面创建命名路由,选择 fallback 策略并按优先级排列模型。例如:
首选:适合复杂推理的模型; 备用:响应较快的模型; 最后备用:额度更稳定或成本更低的模型。
然后使用插件创建的 combo:<name> 路由模型。具体模型 ID 和可用性以设置页实际显示为准。
8. 为什么值得推荐?
第一,增长信号足够强。 OSS Radar 在 11 月 15 日显示最近 24 小时约 +1.5k、最近 7 天约 +8.3k;GitTrend 的最近 30 天统计约 +57.4k。不同追踪站的时间窗口有差异,但增长方向一致。
第二,解决真实工程问题。 动态模型目录、可用性探测、统一 Provider、Fallback 路由和本地兼容网关,都能直接进入开发者日常工作流。
第三,功能不是单一“免费模型列表”。 它把模型接入、路由、预算、用量统计和本地 API 复用放在一个插件里,适合模型实验和个人开发环境整合。
第四,维护活动持续。 Rising.dev 在 11 月 13 日记录该仓库最近 30 天有 435 次 commits;OSS Radar 记录 11 月 14 日仍有代码更新;GitHub Releases 于 11 月 14 日发布 v2.8.4。
9. 注意事项与安全边界
9.1 免费通道不等于无限,也不等于私有
插件 README 明确说明,它是客户端,不是模型服务方。公开免费通道由上游提供,额度、地区限制和服务政策由上游决定,可能出现 403、429、限流、收费或下线。
Kilo 免费池的模型卡明确提示:Prompt 可能被上游记录并用于改进服务。不要向公开免费通道发送 API Key、密码、Cookie、访问令牌、客户资料、个人身份信息、未公开源代码、商业机密或生产数据。生产或敏感工作负载应使用自己掌控的私有部署或付费 API。
9.2 请求会发送到所选模型上游
README 列出 OpenCode Zen 网关和 Kilo AI 公共网关等上游。Prompt、工具结果和附带图像会作为正常推理请求发送给所选上游;“用量统计只保存在本机”不代表模型请求内容也只在本机。
9.3 公开免费额度和账号渠道要遵守上游条款
项目还接入多个第三方账号渠道。不同服务的账号、免费额度、自动领取积分、地区限制和使用政策各不相同。使用前应自行确认各服务条款,不要把“能接入”理解为厂商授权无限自动化调用。
9.4 npm scoped 安装存在已报告问题
GitHub Issue #796 记录了 @ebony-vinyl/dsh-our-free-model@2.8.0 / 2.8.2 / 2.8.3 的 scoped 包名与内部挂载 ID 不一致,可能导致 Host 无法激活或前端加载失败。v2.8.4 已于 11 月 14 日发布,但该 Issue 页面尚未提供 v2.8.4 的明确复测结论。
因此本篇推荐新安装时使用官方 v2.8.4 tag 的本地源码目录方式;不要在没有验证前直接把 npm scoped 命令当作可靠安装路径。也不要安装官方 README 明确警告的同名裸 npm 包。
9.5 Bun 是部分免费通道的额外前提
README 说明默认 OpenCode 免费推理通道需要本机自行安装 Bun,插件不会自动下载或安装它。若相关通道无法启动,先检查 Bun 是否安装、版本和 PATH;不要把所有模型通道都能用视为默认保证。
9.6 插件权限与网络暴露
第三方 DSH 插件运行在宿主环境中,不应把 DSH 的工具审批误认为插件代码的 OS 级沙箱。先在独立 profile 或测试环境验证。默认本地转发仅监听回环地址;若开启 LAN Relay,会扩大可访问范围,应使用独立密钥并限制可信网段,切勿直接暴露到公网。
9.7 macOS 桌面安装包要与插件本体区分
11 月 14 日的 v2.8.4-macos-unofficial 是非官方社区构建,Release 页面明确标注未经 Apple 签名和公证。它不是 DSH 插件安装所必需的文件,也不应与正式插件 Release 混为一谈。
10. 官方资源
- GitHub 仓库:
https://github.com/Ebony-Vinyl/dsh-our-free-model - 官方 README:
https://github.com/Ebony-Vinyl/dsh-our-free-model/blob/main/README.md - 英文 README:
https://github.com/Ebony-Vinyl/dsh-our-free-model/blob/main/README_EN.md - GitHub Releases:
https://github.com/Ebony-Vinyl/dsh-our-free-model/releases - 安装问题追踪:
https://github.com/Ebony-Vinyl/dsh-our-free-model/issues/796 - 官方 DSH 项目:
https://github.com/deepseek-ai/deepseek-harness
一句话总结
Our Free Model 值得关注的,不只是把免费模型放进 DSH,而是把动态模型发现、统一 Provider、本地兼容 API、推理预算和故障降级整合成一层模型接入基础设施。
它适合个人开发者做模型实验、整合本地工具和验证 Agent 工作流;但公开免费通道不适合承载敏感或生产数据,安装时也要留意 scoped npm 包的已报告问题。先用隔离 profile 和非敏感任务验证,再决定是否纳入长期开发环境。
数据说明:本文使用 2026-11-15 可访问的第三方 GitHub Star 追踪页面及官方 GitHub 源码 / Release 信息。24h 与部分 7d 指标为第三方页面取整值,未公开精确差值时不伪装成精确排名;Star 数据均为仓库级,不代表 npm 下载量或插件独立用户数。
















































































