dsh-our-free-model 保姆级部署教程：免登录免 Key 直接用上 DeepSeek V4.1 Flash 等前沿模型的免费插件

一句话定位：GitHub 开源项目 Ebony-Vinyl/dsh-our-free-model 是一个挂在 DeepSeek Harness（内核命令名 dsh）上的免费模型插件——装上之后无需登录、无需注册、无需填写任何 API Key，就能在模型选择器里直接用上 DeepSeek V4.1 Flash、Kimi K3、GLM 5.3 Flash、MiMo V2.6 等一批前沿模型，完全免费、不限量。

slogan：All you do is install this plugin in dsh — the frontier models are just there.

仓库地址：https://github.com/Ebony-Vinyl/dsh-our-free-model · 许可证：MIT · ⭐ 54,307 · 最新版 2.7.4

▲ 图 0：dsh-our-free-model 官方仓库展示的 GitHub Trending 日榜第一、Trendshift JavaScript 周榜第一徽章（2026-10-05 至 2026-10-11，官方截图）

一、项目简介

dsh-our-free-model 是一款以独立插件形式挂载进 DeepSeek Harness 的免费模型插件，不改内核、零依赖、无构建步骤。它要解决的问题非常直接：大模型很好用，但要么要注册、要么要 Key、要么有额度焦虑。这个插件把「免费车道」做成开箱即用的体验——安装即用，模型清单跟随上游实时刷新，可用性由你自己这台机器的网络出口实测得出，思考强度下发的是真实预算而不是提示词。

免费车道的上游来源是公开透明的：一条通道直连 OpenCode 的公开网关（Zen 网关），另一条 Kilo 渠道直连 Kilo AI 的公共免费池（isFree 清单实时拉取，含 kilo-auto/free 自动路由），均直连、不经任何第三方中转。请求由谁处理、数据发往何处，仓库 README 的「上游是哪些源」与「免责声明」一节写得明明白白。

项目以 MIT 许可证开源，当前处于 beta 状态；2026 年 10 月登顶 GitHub Trending 日榜第一与 Trendshift JavaScript 周榜第一，目前 Star 数已超过 5.4 万。官方只发布 Windows 桌面安装包，macOS 桌面壳为社区构建；完整代码、发布清单与签名机制都托管在 GitHub 仓库。

二、功能特点

三、环境要求

• 宿主：DeepSeek Harness（dsh），插件适配内核版本范围 0.1.5 至 0.1.7-rc.2（官方标注兼容区间）；不依赖浏览器界面，无 web server 的 dsh-tui 同样可运行。
• Node 运行时：普通用户由 dsh 宿主自带 Node 运行，无需单独准备；从源码开发插件本体需 Node ^22.19.0 或 >=24.0.0。
• 网络：出口需能访问上游推理网关、模型清单接口与公告源仓库；另会访问几个只读 IP 定位服务以判定出口国家码（用于区分地区受限模型）。
• 平台：插件本体 Windows 环境经过完整实测；macOS 桌面壳为社区构建，未经 Apple 签名与公证；服务器形态用纯 web profile 命令行安装。

四、保姆级部署步骤

4.1 命令行安装（纯 dsh web profile）

最简安装只有一条命令，在终端执行：

dsh plugin --profile web add /绝对路径/dsh-our-free-model

其中路径替换为本机解压后的插件目录绝对路径，--profile 填写你实际使用的 profile 名称，安装完成后重启应用一次。也可以从仓库 Releases 页面 下载官方发布包，解压后把解压目录作为命令参数，绕开插件市场走 git 源自动安装时本机 git 配置带来的问题。

想走 npm 的可以安装官方带 scope 的包（与 Release 的 dsh-our-free-model-<版本>.tgz 同源同版本）：

dsh plugin --profile web add @ebony-vinyl/dsh-our-free-model@2.7.4

注意：不要安装 npm 上那个裸名的 dsh-our-free-model，它不是本仓库发布的（入口文件被改动过，还附带了本仓库从未有过的 src/channel-visibility.js），安装它拿不到审核过的构建，也享受不到签名清单校验与应用内升级。带 scope 的包名挂载条目是 @ebony-vinyl/dsh-our-free-model，与本地裸包名安装方式不能混用（同一个 profile 只选一种）。

4.2 DSHEAC AIO / 桌面端安装

部分 DSHEAC AIO / 旧版桌面整合包在启动 web 服务前会执行 profile 闸门，限制符号链接或目录 junction，可能报错：

PROFILE_UPGRADE_REQUIRED: offline dependency migration is not yet available

遇到该闸门时，不要使用 link: 依赖或 junction，改用应用内插件管理器，或使用下方本地 tarball 方式：

1. 创建 <DSH_HOME>/profiles/<profile>/vendor/ 目录，在审核过的本仓库目录运行 npm pack --ignore-scripts --pack-destination "<DSH_HOME>/profiles/<profile>/vendor"，或将官方发布的同版本 tarball 放入该目录。
2. 在 profile 的 package.json 的 dependencies 中加入 "dsh-our-free-model": "file:./vendor/dsh-our-free-model-2.7.4.tgz"，再通过宿主安装流程解析依赖。
3. 在 dsh.profile.bundles 末尾追加 "dsh-our-free-model"。

若手工复制发布文件，必须复制完整包（adapter/、src/、locale/、vendor/magpie/ 下的元数据与许可证，以及 vendor/channel-pack/ 下的 pack.js、WASM、LICENSE、NOTICE），只复制入口脚本会导致渠道加载失败。桌面端提示 profile "desktop" is managed exclusively by the Electron application 时，请在桌面端设置 → 插件里完成安装，命令行只适用于纯 web profile。

4.3 macOS 桌面壳（社区构建）

官方目前只发布 Windows 桌面版；macOS 为社区构建的 Apple Silicon（arm64）包，下载后先核对校验和：

shasum -a 256 ~/Downloads/Our.Free.Model_<版本>_aarch64.dmg

首次启动被 Gatekeeper 拦截（提示「已损坏」并非文件损坏，只是未签名）：在访达中按住 Control 点按应用选择「打开」；或终端清除隔离属性：

xattr -cr /Applications/Our\ Free\ Model.app

五、配置说明

插件安装后无需任何配置即可使用免费车道。设置页入口为 设置 → Our Free Model，顶部导航共十一个页面：免费模型（鱼缸水位 = 可用模型占比）、EAC 模型、白嫖模型接入（十张渠道卡：登录、账号、模型开关、一键领取积分）、数据看板、运行日志、网关设置、聚合渠道、省 Token、路由、插件升级与推荐项目。

• 聚合渠道：把第三方端点接进同一条模型清单，写入 Key 后其模型以 provider/model 出现在选择器；Key 只写入本机 0600 权限的 settings.json，API 只回显 hasKey 与指纹；每家可单独启停、测试（列表探测不花一次生成）。
• 省 Token：工具输出压缩默认开启，提示词瘦身（caveman / ponytail 两族）默认全关，另有五个不占用上游请求的本地应答。
• 路由：把任意车道模型串成命名链，fallback 固定从链首开始，round-robin 轮换起点并连续 N 轮粘滞；「想了很久才撞上配额墙」正是降级最有价值的场景。
• 网关设置：本地转发默认关闭，启用后复制 base URL 并生成密钥；同一面板提供局域网访问开关（默认关闭，启用后要求独立中继密钥并带环路保护）。
• EAC 渠道（桌面端专属）：在 DeepSeek Harness 桌面端与 DSHEAC AIO 桌面端自动解锁协付通道，模型带 EAC 前缀；凭据加密密封，服务器侧校验 GitHub 授权（登录并 star 本仓库）后才放行对话。
• 视觉特效：设置页顶部开关默认关闭，开启后恢复背景光晕、毛玻璃与装饰动画，选择仅保存在当前浏览器。

六、使用方法

6.1 选模型与思考档位

启动 dsh 后打开输入框旁的模型选择器，选择 Our Free Model 分组下的任意模型即可开始对话，选择结果按会话持久化。分组说明：

被判定为「已声明但不路由」的模型不出现在任何分组，仅在设置页「不在选择器中」分组保留记录与拒因；切换 VPN 后点击重新探测可用性，地区受限模型会在两个分组间自动迁移。思考强度在菜单的 Effort 项调节：声明了思考档位的模型给出它自己的档位菜单（Off / Low / High / Max 等）按原值下发；其余模型提供 Light、Balanced、Deep 三档预算阶梯。长回答被截断时，切换到更高档位，或在设置页调高单次输出上限。

6.2 本地网关调用（OpenAI / Anthropic 兼容）

启用本地转发后，本机其它工具就能像调用 OpenAI 兼容服务一样调用这些模型。端点默认监听回环地址，端口被占用时插件会顺延到下一个可用端口并在设置页如实标注。一次最小化调用：

curl http://127.0.0.1:实际端口/v1/chat/completions \
  -H "Authorization: Bearer 你的本地密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"our-free-model/deepseek-v4.1-flash-free","messages":[{"role":"user","content":"你好"}]}'

网关设置页内置「接入客户端」分区，按实际绑定端口与真实密钥生成可直接复制的配方：Claude Code 的环境变量配置、Codex 配置文件、OpenAI SDK、Anthropic SDK、curl 以及局域网版本。支持的端点包括 GET /v1/models、POST /v1/chat/completions、POST /v1/responses、POST /v1/messages（Anthropic，含 thinking / tool_use 块）与 POST /v1/messages/count_tokens（本地估算）。

6.3 升级插件

在 设置 → Our Free Model → 插件升级 中检查更新并一键升级即可，无需重启应用；仓库推送公告后运行中的实例会在一个轮询周期内自动收到通知。升级信任根为插件内置的签名公钥，镜像源被投毒只会导致升级失败而不会执行其中代码。

七、常见问题 FAQ

问一：免费车道真的不要钱吗，有没有隐藏额度？
答：没有充值、没有套餐、没有按 token 计费的额度体系。但免费额度由上游单方面提供，按会话统计速率，短时间打满会返回限流状态，插件会把该模型标记为已达限额而不隐藏，下一轮探测自动恢复。Kilo 免费池在其模型卡中明确声明提示词可能被上游记录用于改进服务，因此请勿通过免费车道发送密码、密钥、个人身份信息或商业机密。

问二：模型下拉框是空的，或者某个常用模型不见了？
答：选择器只广播当前出口实测可用的模型。上游清单已声明但网关明确拒绝路由的模型会从下拉框移除，仅在设置页保留记录与拒因；网关故障、限流、超时与断网一律不会把模型判定为不可用。地区策略导致的模型会进入 region-limited 分组，切换网络环境后点击重新探测即可。

问三：本地转发端口起不来，或者端口号不是默认值？
答：这是有意设计。端口被占用时插件会顺延到下一个可用端口并落盘，设置页会标注实际监听端口，请以页面显示为准。监听地址只允许绑定回环，改成可路由地址会被直接拒绝；要跨机器使用必须显式开启局域网访问并使用独立密钥。

问四：应该怎么升级插件，能不能顺手用 npm 更新？
答：不要用 npm 上那个裸名包——它不是官方发布。正确方式是应用内 设置 → 插件升级 一键升级（下载、清单签名与哈希校验、备份、原子替换、热重载，任一步失败自动回滚）。官方 npm 包是带 scope 的 @ebony-vinyl/dsh-our-free-model。

问五：思考很久之后回答是空的，或者长回答被截断？
答：部分模型的思考过程静默进行且与正文共享输出预算，思考阶段可能耗时数十秒。对策：切换思考档位、调高设置页的单次输出上限到 16k 以上，或选择模型卡上标注思考关闭的模型。插件内置一次有界的自动恢复：当首段只有思考没有正文且上游异常收尾时，会以已收到的思考为检查点重新发起一次请求。

相关链接

• 项目仓库：Ebony-Vinyl/dsh-our-free-model
• 发布下载：Releases 页面
• 免费推理上游：OpenCode
• 免费模型池上游：Kilo AI
• 独立本地服务说明：packages/standalone 文档
• macOS 社区构建源码改动：PR #421
• 官方交流群：QQ 群 1023181017（ai技术交流群13）