夜雨聆风学习资料网

ARTICLE · 1369136

DSH 插件推荐:Our Free Model 把多模型渠道与本地 API 网关接进 DSH

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. 项目热度数据

指标
数据
来源与统计口径
GitHub Star 总数
约 74.4k
GitHub 仓库页面当前显示值,四舍五入
最近 24 小时新增 Star
约 +1.5k
OSS Radar 2026-11-15 页面滚动 24h 指标;精确差值未公开
最近 7 天新增 Star
约 +8.3k
OSS Radar 2026-11-15 页面显示值,取整
最近 30 天新增 Star
+57.4k
GitTrend 2026-11-15 页面滚动 30d 统计;Hysen Labs 对 10/15–11/14 日快照统计为 +54,946,窗口不同
最近一次代码更新
2026-11-14
OSS Radar 的 Last code push 字段
最近一次正式插件 Release
v2.8.4,2026-11-14
GitHub Releases;同日另有 macOS 非官方社区构建,不能混淆
GitHub 仓库
Ebony-Vinyl/dsh-our-free-model
官方源码仓库

数据核验说明

  1. OSS Radar 在 2026-11-15 报告该仓库约 74k Stars、最近 24h +1.5k、最近 7d +8.3k。它还列出 11 月 10–14 日连续多天约 +1.3k 至 +1.5k 的日增量,说明增长并非只出现一天。
  2. GitTrend 报告最近 30 天约 +57.4k;Hysen Labs 对 10 月 15 日至 11 月 14 日的日快照统计为 +54,946。两者窗口和采样时点不同,不能当作同一口径的精确值。
  3. GitHub 页面当前显示约 74.4k Stars,不是 API 精确整数。
  4. DSH 生态没有一个覆盖所有插件、且公开精确滚动 24h 差值的统一官方排行榜。因此本期把它列为当前可查数据中最值得关注的强增长候选,不宣称已经穷尽所有插件并证明其绝对第一。
  5. 本文排除此前已推荐过的项目;也没有把 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/models
  • POST /v1/chat/completions
  • POST /v1/responses
  • POST /v1/messages
  • POST /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 策略并按优先级排列模型。例如:

  1. 首选:适合复杂推理的模型;
  2. 备用:响应较快的模型;
  3. 最后备用:额度更稳定或成本更低的模型。

然后使用插件创建的 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 下载量或插件独立用户数。

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料