dsh-our-free-model 免费模型直连与网关插件

dsh-our-free-model 免费模型直连与网关插件

dsh-our-free-model·v1.4.2·providers

dsh-our-free-model 是一款为 DeepSeek Harness 打造的免费模型插件。免登录与 Key 即可直连 DeepSeek 与 Kimi 等前沿模型。内置真实 Token 思考预算控制、网络出口探测与兼容转发网关,全量数据落盘本地,实现零门槛极速调用。

DeepSeek · DSH插件 · 免费大模型 · 模型网关 · AI编程

GitHub版本下载
快速安装与集成
bash
dsh plugin --profile web add https://github.com/Ebony-Vinyl/dsh-our-free-model

项目简介

在现代软件工程实践中,依托 DeepSeek Harness(dsh)等轻量级智能体运行时开展全流程 AI 编程与自动化任务已成为主流开发范式。然而,在日常高频调用中,开发者往往面临严峻的模型接入瓶颈:获取头部商用大模型的 API 密钥不仅流程繁琐,通常需要海外信用卡绑定与企业级实名认证,而且高强度的上下文交互会迅速消耗高昂的 Token 费用;而对于仅需验证代码逻辑、调试智能体插件或探索前沿架构的中小开发者与个人极客而言,自建多模型反向代理或账号池则带来了沉重的基础设施维护负担。模型网关配额耗尽、密钥过期或网络跨域阻断,常常成为打断顺畅写码心流的关键阻碍。

由开源开发者团队 Ebony-Vinyl 发起并维护的 dsh-our-free-model 正是为攻克这一开发者痛点而生的免费模型基础设施插件。该项目在 GitHub 迅速斩获超过 4,500 颗标星,并强势登顶 Trendshift 与 GitTrend 全球技术趋势榜单前列。作为 DeepSeek Harness 生态中首屈一指的免密模型扩展,dsh-our-free-model 践行极致的极简挂载哲学:无需注册账号、无需登录认证、无需配置任何 API Key,即可在 dsh 运行时中无缝解锁包括 DeepSeek V4.1 Flash、Kimi K3 在内的前沿大语言模型。项目恪守纯插件架构设计,无需对 dsh 内核做任何侵入式修改,零打包编译步骤,零第三方外部运行时依赖,以完全透明直连的上游渠道、实测动态网络出口探测与物理 Token 思考预算机制,为智能体工程落地提供了零门槛、高可用的免费推理底座。

核心特性

纯插件解耦挂载与无头终端全形态运行时兼容

遵循 DeepSeek Harness 内核“一切皆插件”的核心设计理念,dsh-our-free-model 在架构设计上实现了彻底的关注点分离。插件将底层的 llm 抽象接口作为唯一硬依赖,完全剥离了对桌面图形界面或 Web 服务的强绑定。这意味着在缺乏浏览器环境的无头服务器、Docker 容器以及 dsh-tui 纯命令行终端环境中,插件依然能以极速独立加载并向宿主正常派发模型能力。为了向拥有前端页面的宿主提供丰富的图形化配置与看板功能,插件的 Web 模块常驻于独立的调度 Fiber 协程之上,采用惰性挂载策略静默等待宿主 webServer 就绪后再行动力注册路由,既保证了启动流程绝不阻塞主智能体线程,又彻底避免了因加载时序颠倒而导致设置页永久丢失的顽疾。

动态网络出口实测与智能可用性故障隔离机制

公共免费模型池的最大挑战在于上游节点波动与跨国网络环境差异。许多第三方代理工具仅保存一份静态的模型名称快照,导致开发者在发起对话后频遭断流报错。dsh-our-free-model 抛弃了静态清单方案,在每次刷新时直接从用户宿主机当前所处的真实物理网络出口发起实时健康探测。系统对不同错误类型进行了高精度的语义解耦:当上游网关明确返回模型不存在(404)或明确拒绝路由时,该模型会被精准移出下拉选择器;而对于网关临时过载(5xx)、短时配额流控(429)或网络握手超时等暂态异常,插件则将其判定为连通性波动并继续保持可达状态。针对因地理策略限制(Geo-blocking)导致拦截的模型,系统会自动将其归入独立的 region-limited 分组,在直观呈现可用边界的同时确保输入框选择器绝不产生不可用崩溃。

基于物理 Token 预算的确定性思考强度控制

当前多数针对推理模型(Reasoning Models)的控制方案仅仅向上游传递虚设的 reasoning_effort 字符串参数,而在各类异构的公共网关实现中,该参数极易被底层直接忽略或产生不可预期的回退。dsh-our-free-model 在客户端层面重构了思考深度的控制逻辑,将轻度(Light)、均衡(Balanced)与深度(Deep)三档映射为真实的物理 Token 消耗预算,分别精准对应 2,048、8,192 以及模型硬件上限。对于部分原生无法关闭思维链的特殊模型架构,系统会自动将该预算梯度翻倍至 4,096 与 16,384,以解决思考推理与正文生成相互挤占单一输出上限的冲突。所有下发参数均在设置页模型卡片上透明标注,并在每一次推理调用中保留物理痕迹,确保深度思考真正对代码逻辑产生实质推演作用。

全量数据落盘本地与零遥测隐私安全护栏

针对开发者对代码资产与提示词泄露的合理担忧,dsh-our-free-model 构建了严苛的本地隐私防护体系。所有的运行状态、配置参数、调用频次、17 周 Token 消耗热力图、首字生成延迟(TTFT)以及生成速率采样数据,均完全保存在本地宿主配置目录 DSH_HOME/our-free-model/ 的纯 JSON 文件中,绝不设立任何中心化遥测服务器,也不向任何第三方上传分析日志。在 HTTP 接口层面,由于插件路由优先级高于宿主内核,系统内置了与宿主内核完全同级的信任围栏:每一个请求均强制校验 Connection 准入凭证,在非受信环境中自动退回严格结构化防护,强制阻断跨站请求伪造(CSRF)并校验来源同源性,从根源上封死通过网页恶意脚本刺探本地服务的安全漏洞。

环路保护的本地 OpenAI 兼容网关与局域网中继

为了让 DeepSeek Harness 外部的开发工具(如 Cursor、VS Code 插件、沉浸式翻译等)同样享受到免密模型带来的便利,插件内置了开箱即用的 OpenAI 兼容本地转发服务。该服务默认以严格权限仅监听本机环回地址(127.0.0.1),转发密钥由加密安全随机数运行时生成,并采用常量时间比对(timingSafeEqual)杜绝时序攻击。当开发者需要在局域网内的其它开发机上共享该能力时,可显式开启局域网中继模块。中继服务独立绑定可路由网卡并签发独立的局域网密钥,在接收请求后于宿主进程内部完成凭据置换,中继仅放行白名单内的模型与补全接口,并内置跳数标记(Hop Limit)拦截自环死锁,实现了安全性与多设备复用性的极致平衡。

快速上手

命令行终端插件安装与环境代理配置

在拥有 DeepSeek Harness 命令行环境的开发机上,推荐使用官方插件管理指令直接添加本插件。在安装与首次拉取模型清单前,若处于内网代理环境,请务必先导出终端代理变量:

bash
# macOS 与 Linux 系统 (zsh / bash)
export HTTP_PROXY="http://127.0.0.1:7890"
export HTTPS_PROXY="http://127.0.0.1:7890"

# 通过 dsh 命令行工具将插件添加至当前运行环境的指定 profile(以 web 配置文件为例)
dsh plugin --profile web add /path/to/dsh-our-free-model

# 重启 dsh 宿主服务以使插件挂载生效
dsh restart
powershell
# Windows 系统 (PowerShell 环境)
$env:HTTP_PROXY = "http://127.0.0.1:7890"
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

# 使用 PowerShell 执行插件添加命令
dsh plugin --profile web add C:\Users\Username\dsh-our-free-model

安装完成后,在终端日志中将显示 our-free-model: mounted 确认信息,此时打开 dsh 交互界面即可在模型列表中看到已就绪的前沿模型。

桌面端与 AIO 环境部署注意事项

若在 DeepSeek Harness 桌面端或 DSHEAC AIO 整合包中使用本插件,必须注意桌面端内置的依赖扫描闸门机制。桌面宿主为了保障离线环境稳定性,在启动 Web 服务前会严苛排查配置目录下的软链接与符号链接(junction):

bash
# 严禁在桌面端中使用 npm link 或符号链接安装,必须将插件放置为实体物理目录
# 目录放置路径遵循:~/.dsh/profiles/<your-profile>/plugins/dsh-our-free-model
mkdir -p ~/.dsh/profiles/default/plugins/dsh-our-free-model
cp -r /path/to/dsh-our-free-model/* ~/.dsh/profiles/default/plugins/dsh-our-free-model/

将实体目录拷贝到位后,直接重启桌面应用程序,即可在左侧导航的插件管理页面中看到已正确识别的 Our Free Model 模块。

启用本地 OpenAI 兼容网关与第三方工具对接

在 dsh 设置页导航中进入“Our Free Model → 本地转发”分区,开启本地转发服务并复制系统自动生成的访问密钥。开发者可以直接通过标准终端工具进行连通性验证:

bash
# 使用 curl 验证本地 OpenAI 兼容端点的模型列表接口(默认端口 8326)
curl -s http://127.0.0.1:8326/v1/models \
  -H "Authorization: Bearer your-generated-local-key"

# 发送一次标准的流式聊天补全请求
curl -X POST http://127.0.0.1:8326/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-generated-local-key" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [{"role": "user", "content": "请写一个快速排序算法"}],
    "stream": true
  }'

在诸如 Cursor、Claude Dev 或 NextChat 等第三方客户端中,只需将 Base URL 指定为 http://127.0.0.1:8326/v1,并将 API Key 填入上述生成的密钥,即可完全复用本插件提供的免费前沿模型算力。

常见问题

桌面端启动时提示 PROFILE_UPGRADE_REQUIRED 并中断退出的排查逻辑

该报错是由于 DeepSeek Harness 桌面端在执行启动自检时,在其配置文件所在的 profile 目录树中检测到了非内核生成的符号链接(Symlink)或目录软链接(Junction)。桌面端出于离线数据完整性考虑,目前尚未开放跨目录的动态模块迁移。解决该问题的关键是切断一切符号链接依赖:必须关闭所有开发工具,进入系统的用户配置目录(通常位于 ~/.dsh/profiles/),将此前通过软链接方式挂载的插件文件夹彻底删除,改用直接物理拷贝的方式将完整的插件代码放置为实体文件夹,重新启动桌面客户端后该校验阻断即可完全消失。

为什么部分模型在选择器中显示为灰色或归入 region-limited 分组

该状态表示插件从当前主机发起的实时网络探测被上游公共网关判定为命中地理位置管控策略。公共模型池的上游服务器(如 OpenCode Zen 网关与 Kilo AI 网关)通常根据请求来源的出口 IP 施行区域访问控制。当遇到此情况时,表明该模型的物理连接通道畅通,但当前 IP 暂未在放行白名单中。最直接的恢复途径是调整系统或终端的代理路由规则,切换至支持全球访问的网络出口节点;当完成网络切换后,只需在设置页面中手动点击重新探测按钮,或等待下一个轮询周期,系统将自动基于新出口重新评估,受限模型便会自动重回主选择器。

外部调用工具连接本地兼容网关时频繁遭遇 400 或 401 报错

遇到鉴权或请求拒绝时,首先需要区分请求来源是本机环回接口还是局域网跨机器请求。如果是在本机发起调用,务必检查请求头中是否完整携带了 Authorization: Bearer <key>,且该密钥必须是在设置页面中实时显示的本机 Key(请勿随意手工填写伪造字符串);如果是从局域网内其它设备发起访问,系统默认的环回监听会出于安全基线直接拒绝对外暴露,此时必须在插件设置中显式勾选启用“局域网访问”开关,并必须使用专门由系统签发的局域网中继密钥,而非本机专属密钥,同时确保调用路径严格限定在白名单内的补全端点上。

使用免费模型池进行日常开发时如何权衡隐私安全与数据保护

dsh-our-free-model 的免费车道依赖上游公共网关提供的开放算力,其中部分渠道(如 Kilo AI 免费池)在其公开模型规范中明确声明,传入的提示词可能会被上游服务器记录并用于后续的模型优化迭代。因此,开发者在使用免费车道时应当建立清晰的安全边界:该插件非常适合用于通用算法编写、公开技术文档查阅、开源框架原型验证与学习实验等非机密场景;但是,严禁将包含生产数据库凭据、企业内部专有业务代码、个人身份敏感信息(PII)或商用加密密钥的上下文发送至免费模型池,涉及企业敏感业务的工作流建议切换至私有部署模型或自有商业付费 API。