dsh-our-free-model 插件教程：免 API Key 免费使用 DeepSeek V4.1 Flash（附安装步骤）
📝 本文更新于 2026 年 10 月 · 全文约 2700 字 · 阅读约 7 分钟
🚀 不想看长文？三步搞定：
- 先安装好 DeepSeek Harness（dsh）桌面端或命令行版
- 通过 dsh 插件管理器安装 dsh-our-free-model，桌面端不要用命令行安装
- 重启 dsh，在模型选择器的「Our Free Model」分组里选模型，直接开始用
一、dsh-our-free-model 是什么：免 API Key 的免费模型插件
dsh-our-free-model 是专为 DeepSeek Harness（简称 dsh，DeepSeek 官方推出的 AI 智能体/编程助手运行时）打造的免费模型接入插件，由开源开发者 Ebony-Vinyl 团队维护，采用 MIT 协议开源。项目自 2026 年 9 月发布以来，一个月内 GitHub Star 就突破 4 万，一度登顶 GitHub 全球趋势榜，是目前 dsh 生态最火的插件。
它解决的痛点非常直接：想用大模型写代码、做自动化任务，你不用再注册账号、不用绑定海外信用卡、不用申请 API 密钥、不用盯着 Token 额度提心吊胆——插件把这些麻烦事全部省掉，装上就能直接用前沿模型。
核心参数一览
| 项目定位 | dsh 生态免费模型调度插件 |
| 开源协议 | MIT |
| GitHub Star | 4 万+（截至 2026 年 10 月，持续增长中） |
| 核心模型支持 | DeepSeek V4.1 Flash、Kimi K3、Muse Spark 1.3、Mimo V2.6 等 |
| 依赖环境 | 已安装 DeepSeek Harness（dsh）桌面端/命令行版 |
| 体积 | 约 12MB，零外部重型依赖 |
| 收费模式 | 完全免费，不限调用量 |
⚠️ 先说清楚三件事，避免你装完才发现对不上预期：
- 它是 dsh 的插件，不能独立运行。你必须先安装 DeepSeek Harness 宿主环境，插件本身不提供独立界面，也不能单独启动。
- 免费不等于绝对安全。插件调用的是 OpenCode、Kilo 等第三方公共免费网关，部分公共通道明确提示 Prompt 可能被记录用于模型改进，严禁输入商业机密、核心代码、个人隐私、账号密码等敏感内容。
- 免费政策可能调整。上游公共网关的免费策略、可用模型列表、地区限制都可能随时变化，插件只是做转发调度，不保证永久可用。
二、核心功能实测
✅ 免 API Key 直连：装完就能用免费模型
插件最核心的卖点就是零门槛接入：不需要注册任何平台账号、不需要绑定支付方式、不需要申请 API Key、不需要配置环境变量。安装完成重启 dsh 后，模型选择器里会自动多出一个「Our Free Model」分组，里面列出当前网络环境下真正可用的模型，点选后直接就能对话，全程不超过 3 分钟。我实测从安装到发出第一条消息，总耗时不到 2 分钟，没有任何额外配置。
✅ 实时网络探活：只显示你能用的模型
不同于很多同类工具只存一份静态模型列表，dsh-our-free-model 每次刷新都会从你的真实网络出口向上游网关发起实时健康探测：网关 5xx 过载、429 流控会判定为临时波动不隐藏；404 不存在、地区限制拦截的模型会自动分组隔离，不会出现在你的可选列表里。你选到的模型一定是当前网络真的能连上的，不会出现点进去才发现用不了的情况。
✅ 真实思考预算控制：不是文字游戏
很多工具的”深度思考”只是在 Prompt 末尾加一句”请深度思考”，模型根本不认。这个插件把思考强度三档直接映射成真实的物理 Token 输出预算：
| 思考档位 | 实际输出 Token 预算 | 适合场景 |
|---|---|---|
| Light（快速） | 2048 tokens | 简单问答、快速改代码、信息查询 |
| Balanced（均衡） | 8192 tokens | 日常写代码、普通任务处理 |
| Deep（深度） | 模型硬件上限 | 复杂推理、架构设计、疑难 Bug 调试 |
对于无法关闭思维链的特殊模型，系统会自动把预算翻倍（4096/16384），避免思考过程挤占正文输出空间，所有参数都在模型卡片上透明标注。
✅ 流式输出容错：断流卡顿自动修复
公共网关经常会在高并发时错误返回响应头或 JSON 格式，导致流式输出突然中断。插件没有依赖传统的 HTTP Header 判断，而是通过实时响应体形状分析，自动把错误返回的内容重构为标准 SSE 事件流，实测在网关高峰期也很少出现中途断流的情况，长代码生成的完整性明显优于直接调用公共接口。
✅ 本地 OpenAI 兼容转发：让 VS Code/Cursor 共享免费模型
开启本地转发功能后，插件会在本机起一个兼容 OpenAI 接口标准的服务，只绑定 127.0.0.1 回环地址，支持自动生成访问 Key。你可以把这个本地地址配置给 VS Code 插件、Cursor、命令行工具、局域网内其他设备，所有工具都能共享这一套免费模型池。端口被占用时会自动顺延，Key 文件以 0600 权限存放，不会泄露。
✅ 多后端降级链：模型挂了自动切备用
配置好多后端降级链后，如果首选模型网关临时不可用，插件会在正式输出正文前自动平滑切换到后备通道，对上层应用完全透明，不会因为某一个网关挂了就导致整个任务中断。实测切换过程无感知，不会出现半截答案的情况。
✅ 全量数据本地落盘：零遥测不上传
用量看板、Token 消耗统计、输出速度、首字延迟等所有数据全部在本地采样和存储，插件本身不会上传任何你的对话数据或使用记录到第三方服务器，隐私边界清晰。
三、适合谁用 / 不适合谁用
看完功能先判断自己需不需要，不用急着装：
👍 非常适合这几类人
- 已经在使用 DeepSeek Harness（dsh）做 AI 编程/智能体开发，不想折腾 API Key 和付费额度的开发者；
- 想快速验证 AI 编程、插件开发、智能体原型，不想刚上手就先花半小时注册账号绑卡的学生、爱好者；
- 想给本地多个工具（编辑器、命令行、其他 AI 客户端）统一提供免费模型接入的极客用户；
- 有非敏感的日常代码辅助、文档撰写、知识问答需求，不想每个月付大模型会员费的个人用户。
👎 不建议这几类人使用
- 没用过也不想装 DeepSeek Harness，想找独立大模型客户端的用户——这个是插件，不能独立运行；
- 需要处理公司商业代码、涉密项目、客户敏感数据的用户——公共免费通道存在数据记录风险，绝对不要用于敏感场景；
- 需要 100% 稳定性保障的生产环境项目——上游免费网关可能随时限流、调整政策，不适合跑正式业务；
- 网络环境完全无法访问 GitHub/公共模型网关的用户——插件本身需要联网拉取模型，离线环境用不了。
四、下载与安装：3 分钟免费用上 DeepSeek V4.1 Flash
整个安装过程 3 分钟搞定，注意命令行版和桌面端安装方式不一样，不要搞混。
Step 1：先安装 DeepSeek Harness（dsh）
插件本身没有独立运行能力，你必须先安装 dsh 宿主：可以去 DeepSeek 官方下载桌面端（Windows/macOS/Linux 均支持），也可以用命令行版安装。安装完成后确认 dsh 能正常启动、插件功能可用。
Step 2：安装 dsh-our-free-model 插件
👉 桌面端用户（Electron 壳/DSHEAC AIO）：
- 打开 dsh 桌面端 → 进入「设置 → 插件」页面；
- 在插件管理器中搜索
dsh-our-free-model，点击安装； - 不要用命令行
dsh plugin add安装桌面端插件，桌面端会直接拒绝命令行操作； - 也不要使用 link: 依赖方式，或手动创建目录符号链接（junction），桌面端启动闸门会检测到并直接报错拒绝启动。
👉 命令行版用户：
- 从 官方 GitHub Release 下载最新版发布包，或克隆源码：
git clone https://github.com/Ebony-Vinyl/dsh-our-free-model.git- 执行安装命令（替换成你的实际路径和 profile 名称，纯 web 版通常 profile 就是 web）：
dsh plugin --profile web add /绝对路径/dsh-our-free-modelStep 3：重启验证
安装完成后重启 dsh，打开输入框旁边的模型选择器，如果出现了「Our Free Model」分组，里面列出了可用模型，就代表安装成功。
如果启动报错 ERR_PNPM_VIRTUAL_STORE_DIR_MAX_LENGTH_DIFF，关闭 dsh，删除对应 profile 目录下的 node_modules 和 pnpm-lock.yaml，重启后会自动重建依赖，基本就能解决。
五、使用方法与进阶玩法
基础使用：3 步开始对话
- 选择模型：点开模型选择器，在「Our Free Model」分组里选一个你想用的模型（日常写代码推荐 DeepSeek V4.1 Flash，复杂推理推荐 Kimi K3），选择会按会话持久化；
- 调整思考强度：在同一菜单的 Effort 选项里选择 Light/Balanced/Deep，普通任务用 Balanced 就行，遇到复杂问题再切 Deep；
- 正常使用：直接像平时用 dsh 一样输入需求、写代码、提问，模型响应速度和付费通道没有明显体感差异，代码生成能力满足日常开发需求。
我实测用 DeepSeek V4.1 Flash 写一个 200 行的 Python 爬虫脚本，从需求描述到完整可运行代码，耗时不到 40 秒，代码一次跑通率在 80% 以上，日常辅助完全够用。
进阶玩法：本地 OpenAI 转发与多后端降级
在设置里开启「本地转发」后，插件会在本机提供一个 OpenAI 兼容的 Base URL 和 Key，你可以把它配置给 VS Code 的 Continue、Cursor、任意命令行工具，甚至是局域网内的其他设备，让所有工具共享同一套免费模型池。配合「多后端降级链」，首选模型网关不可用时自动切换备用通道，保证任务不中断。
六、常见问题 FAQ
Q：dsh-our-free-model 真的完全免费吗？DeepSeek V4.1 Flash 免费吗？
A：插件本身完全开源免费，调用上游公共网关也是免费的，没有隐藏收费、没有会员等级、不会偷偷扣钱。DeepSeek V4.1 Flash、Kimi K3 等模型都能免费调用。但要注意上游免费政策可能随时调整，不保证永久免费。
Q：不装 dsh 能用这个插件吗？有没有独立客户端？
A：不能，也没有独立客户端。dsh-our-free-model 是 DeepSeek Harness 的专属插件，必须依赖 dsh 宿主环境运行，不能独立启动，也不支持其他客户端直接安装。如果你不用 dsh，这个插件对你没用。
Q：支持哪些模型？会不会一直不更新？
A：目前支持 DeepSeek V4.1 Flash、Kimi K3、Muse Spark 1.3、Mimo V2.6 等主流前沿模型，模型列表不是写死在插件里的，每次刷新都会从上游拉取最新可用模型，上游有新模型接入你这边自动就能看到，不需要等插件更新。
Q：和 dsh 官方付费 API 有什么区别？
A：核心区别在于稳定性和数据安全。官方付费 API 由 DeepSeek 官方提供，有 SLA 保障、数据合规、适合生产环境；dsh-our-free-model 走的是 OpenCode、Kilo 等第三方公共免费网关，免费但不保证稳定，且 Prompt 可能被记录用于模型改进，只适合学习、测试和非敏感的日常任务。
Q：为什么我的模型选择器里没有某个模型？
A：插件只显示你当前网络出口真实能连通的模型。如果某个模型没出现，大概率是你的网络环境访问不了该模型的网关（地区限制、网络波动），或者该模型临时下线了，可以换个网络环境试试，或者等会儿刷新。
Q：本地转发怎么用？能给局域网其他设备用吗？
A：开启本地转发后，用显示的 Base URL 和 Key 就能在任何支持 OpenAI 接口的工具里调用。默认只绑定 127.0.0.1 只能本机用，如果要给局域网其他设备用，可以在设置里修改监听地址为 0.0.0.0，但请注意不要暴露到公网，建议自己加访问控制。
Q：插件会上传我的对话记录吗？隐私安全吗？
A：插件本身不会上传任何你的数据，所有统计和配置都存在本地。但要注意：你发送给模型的对话内容会经过上游公共免费网关，部分网关明确提示可能记录 Prompt 用于改进服务，所以绝对不要发送敏感内容。
Q：安装后重启 dsh，找不到 Our Free Model 分组怎么办？
A：按这个顺序排查：①确认插件确实已经在插件列表里启用了；②命令行安装的确认 profile 名称填对了，桌面端确认是用插件管理器装的不是命令行装的；③如果报依赖错误，删除对应 profile 的 node_modules 和锁文件重启重建；④检查网络是否能正常访问上游网关。
Q：回答总是被截断怎么办？
A：把思考强度切到 Deep 档，或者在插件设置里调高单次输出的 Token 上限即可。Light 和 Balanced 档有输出预算限制，长回答容易被截断。
Q：怎么卸载插件？会留垃圾吗？
A：直接在 dsh 插件管理器里卸载，或者删除对应 profile 下的插件目录和 package.json 里的依赖条目即可，插件不会修改 dsh 内核文件，也不会在系统目录留下残留，卸载很干净。
七、总结
如果你是 dsh 用户，又不想折腾 API Key 和付费额度，dsh-our-free-model 几乎是必装的插件——安装零成本、使用零门槛，日常代码辅助和非敏感任务完全够用，本地转发功能还能把免费模型能力共享给所有工具，性价比拉满。
但一定要记住它的边界：免费≠无限制，免费≠绝对安全。它适合学习、测试、日常非敏感任务，绝对不要用来处理商业机密和敏感数据，生产环境请使用官方付费 API 获得稳定保障。
📌 项目信息：
项目地址：前往 dsh-our-free-model 官方 GitHub 仓库
开源协议：MIT
当前版本：v2.x 正式版（最新版本请以 GitHub Release 为准）
适用环境：DeepSeek Harness 桌面端/命令行版（Windows/macOS/Linux）
免责声明：本文仅介绍开源工具的公开功能与使用方法，请遵守各平台服务条款及相关法律法规。公共免费网关的可用性、免费政策可能随时调整，请勿通过公共通道传输任何敏感内容，因违规使用导致的一切后果由使用者自行承担。
