一、问题是什么

想在 AI 客户端里用上前沿模型，正常路径是三件事：注册账号、绑定支付方式、填一串 API Key。真用起来还有第二层麻烦——额度按 token 计费，一次长上下文调用就肉疼，于是聊天时开始算计字数、能不贴的日志就不贴、让模型读代码前先自己删一半。第三层是切换成本：手里有好几个平台，每个都要单独充、单独管 Key，用完这一家的额度再换下一家，工具链跟着换一遍。Our Free Model 想抹掉的就是这前三层，它的做法是在客户端里挂一个插件，把免登录的免费模型源直接接进模型选择器。

二、核心设计

它不是模型服务方，是一个客户端插件。这一条必须先说清楚，因为它决定了后面所有的边界：请求由插件发往上游公开的免密网关，响应由上游生成，插件不中转、不托管、不改写输出。仓库文档里把出网目标逐条列了出来——免费车道走 OpenCode 的免密网关，Kilo 渠道走 Kilo AI 的公共网关，公告与升级清单走仓库自己的 feed。免费车道携带的凭据是字面量 public，也就是说插件里不含任何属于使用者的密钥。

真正让它跑起来的技术点有三个。第一，模型清单不写死，每次刷新都向上游重新拉取，插件内不保存静态快照，所以上游加了模型你这边就有，上游下架了这边也跟着消失。第二，可用性判定按「网关是否真的拒绝路由」来做，而不是按某次探测失败——网关 5xx、429、超时、断网一律保持可达，只有明确返回「该模型不可用」或 404 找不到 id 才从下拉框移除。第三，思考强度的下发分两类：声明了思考档位的模型，选中的档位按原值发到上游的 reasoning_effort 字段，上游会校验这个字段，集合外的取值直接报错；没有档位菜单的模型走预算阶梯，把档位翻译成硬性输出 token 上限。

三、功能拆解

模型选择：输入框的选择器里多出 Our Free Model 分组，被上游按地区策略拦住的模型单独归到 region-limited 分组，保留可见但不混在可用清单里。选择结果按会话记住，不同会话可以用不同模型。

思考强度：同一个菜单里的 Effort 项。有档位菜单的给 Off / Low / High / Max 这类选项，没有档位菜单的给 Light / Balanced / Deep 三档，对应不同的输出 token 预算；思考不可关闭的模型三档整体翻倍，因为思考和正文共享同一份输出额度。

本地转发端口：设置页打开后复制 base URL 并生成 Key，就能让本机其它工具用这些模型。支持五条接口——模型列表、Chat Completions、Responses、Anthropic Messages 与 token 估算。监听只绑回环地址，不带 Key 的请求直接拒绝；想跨机器用要另外显式打开局域网访问，那扇门有独立的 Key。

用量看板：Token 热力图、总量曲线、输出速度与首字延迟逐次采样，全部只落在本机，不上传。

应用内升级：下载、校验 SHA-256、备份、原子替换、校验回读、热重载，任一步失败自动回滚到上一版。

另外还有省 Token 的三件套（工具输出压缩、提示词瘦身、本地应答）、把多车道串成降级链的路由、以及自带 Key 接第三方提供商的聚合渠道。这些不是免费车道的必需品，但都在同一个设置页里。

四、适合谁、不适合谁

适合：想低成本把前沿模型接进日常客户端的人；已经装了 dsh、想省掉配 Key 这一步的人；要把模型能力接给自己写的脚本或其它工具、又不想先办一张信用卡的人；想在几个模型之间快速对比、而不想为每次对比付费的人。

不适合：要把密码、密钥、身份信息、商业机密发给模型的人——这一条是硬线，下面「诚实提醒」会展开；需要稳定 SLA 的生产环境；指望「免费就等于不限速」的人；用 Intel 芯片 Mac 又想直接用现成安装包的人，因为官方只出苹果芯片的包；还有一类是想拿它当模型服务方对外提供服务的，插件明确禁止这种用法，也不具备那个能力。

五、诚实提醒

第一，免费不等于私有。Kilo 免费池在它自己的模型卡里写得很直白：prompt 可能被上游提供方记录，并用于改进他们的服务，不适用于生产或敏感数据场景。这不是插件的判断，是上游的声明，插件只是把这句话如实转达在选择模型时的提示里。密码、密钥这类内容不要走免费车道。

第二，不限量不等于不限速。上游按会话统计速率，短时间内打满会返回 429，插件会把该模型标成「已达限额」且不做隐藏，下一轮探测自动恢复。额度和可用性政策完全由上游单方面决定，随时可能收紧、收费或下线。

第三，有的模型思考阶段是静默的。实测有模型会静默思考六十到七十秒、期间不发出任何思考帧，最后以正常结束收尾但正文为空，客户端容易报「空响应」。这不是插件坏了，是上游的思考与正文共享输出预算。把单次输出上限调高，或换用标注了不做思考的模型可以缓解。

第四，质量与安全责任在使用者。插件不改写、不过滤任何模型输出，模型可能产出错误、过时或有偏颇的内容。仓库文档里也写明了信任边界：源码是明文 JavaScript，能读到那个目录的人就能读懂网关逻辑，这是本地插件这种分发形态的固有属性。

最后单独提一句 npm 上的坑：有一批人装错了包。npm 上那个裸名的包不是这个仓库发布的，入口文件被第三方改过，还多出了本仓库从来没有的模块。装到它得不到本仓库审核过的构建，也拿不到签名清单校验和应用内升级。官方发布的是带前缀的包名，两者不是一回事。

六、项目现状

仓库当前 75,003 stars、2,095 forks、69 位关注者、871 次提交，MIT 许可，创建于 2026 年 9 月 24 日，最新版本 2.8.5 发布于 2026 年 11 月 15 日。这个增速在开源项目里属于头部水平，README 上也挂了趋势榜的位置截图。

技术形态上它走的是相当克制的一条路：纯插件挂载、零依赖、无构建步骤，只把内核的模型接口作为硬依赖，因此在没有 Web 服务的极简组合里也能启动并输出模型。适配器用结构化方式实现而不直接 import 内核包，所以同一份代码能跨两个内核版本运行。

我们这一轮实测的部分：桌面端两个安装包从官方渠道取回后，SHA-256 与官方公布的校验值逐字节一致；上传到网盘后再下载回来重算，仍然一致。macOS 包是社区构建，没有 Apple 开发者签名和公证，首次打开会被系统拦下——文件本身没坏，放行即可。官方只发布了苹果芯片的 macOS 包，没有 Intel 版本。