zouyuxuan122/dsh-our-free-model · 上手攻略

• 仓库：zouyuxuan122/dsh-our-free-model
• 链接：https://github.com/zouyuxuan122/dsh-our-free-model
• 分类：AI 工具 / 模型访问层 / DeepSeek Harness 插件
• 作者：Jay
• 更新：2026-10-01

一、是什么

dsh-our-free-model 是一个 DeepSeek Harness（dsh）插件，装上之后不需要登录、不需要注册、不需要填任何 API Key，就能直接使用包括 Muse Spark 1.3、MiMo V2.6 在内的前沿大模型——完全免费，不限量。

它的工作原理是在 dsh 的插件系统里挂载一个模型转发层，所有请求经过 OpenCode 的 Zen 网关（opencode.ai）发出，数据不经任何第三方中转。模型清单跟随上游实时刷新，不是一份写死的快照。它还给 dsh 增加了一个 OpenAI 兼容的本地转发端口，让你本地其他工具（如 curl、LangChain、AnythingLLM）也能通过一个 Key 调用这些免费模型。

前置依赖：你必须已经在电脑上安装了 DeepSeek Harness（dsh）——一个由 DeepSeek AI 开发的开源 AI 编码助手，基于 Node.js / TypeScript 构建，以插件化为核心设计。dsh 本身是一个完整的 AI coding agent，有 Web UI（127.0.0.1:3080），而这个插件是在 dsh 之上增加免费模型访问能力。

二、解决什么问题

如果你在用 dsh（DeepSeek Harness），默认情况下需要自己准备 API Key 才能调用模型。而这个插件：

1. 免 Key 免登录：绕过 API Key 门槛，在 dsh 里直接选免费的前沿模型。
2. 模型种类比肩付费服务：Muse Spark 1.3、MiMo V2.6 等前沿模型（截至 2026 年 10 月可用性以实际上游为准）。
3. 思考强度真的生效：Light / Balanced / Deep 三档对应真实的输出 token 预算（2,048 / 8,192 / 模型上限），且逐次调用留痕；MiMo V2.6 这类关不掉思考的模型三档整体翻倍（4,096 / 16,384 / 模型上限）。
4. 给其他本地工具用：通过 OpenAI 兼容的本地转发端口，本地其他工具也能用同一个 API Key 格式调用这些免费模型。
5. 模型可用性实时探测：上游点名但网关拒绝路由的模型会自动从选择器移除（显示"Model is unavailable"），不会让用户选了白等；5xx/429/超时断网不属于对模型的判定，保持可达；地区门拦截的单独归到 region-limited 分组。

三、快速安装

环境要求

• DeepSeek Harness（dsh）已安装并正常运行
• dsh 支持 Linux / macOS / Windows

安装命令

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

装完重启一次 dsh 应用（--profile 填你实际使用的 profile 名称，如 web）。

⚠️ 桌面端注意：dsh 的 profile 扫描器有安全闸门，只放行 dsh 自己生成的符号链接。如果 profile 目录树里出现其他符号链接或目录 junction，应用会拒绝启动并报错： PROFILE_UPGRADE_REQUIRED: offline dependency migration is not yet available 桌面端请不要用 link: 依赖安装，也不要建 junction，用应用内插件管理器或真实目录安装。

手工目录安装（备选）

在 <DSH_HOME>/profiles/<profile>/ 下：

1. 把发布文件复制进 node_modules/dsh-our-free-model/（index.js、client.js、src/、locale/、icon.svg、cordis.patch.yml、package.json）
2. 在 dependencies 里加 "dsh-our-free-model": "1.1.2"（写版本号，不要写 link:）
3. 在 dsh.profile.bundles 末尾追加 "dsh-our-free-model"

⚠️ 不要往 cordis.patch.yml 里再加条目。被 dsh.profile.bundles 引用的包自带 patch 层会自动生效，两处都注册会报 duplicate loader entry id: our-free-model。

安装后验证

# 验证 profile 兼容性
node -e "const g = require('<APP_ROOT>/sidecar/dist/lib/profile-upgrade.js'); \
const app = '<APP_ROOT>', profile = '<DSH_HOME>/profiles/<profile>'; \
console.log(g.planProfileUpgrade(app, profile)); \
g.assertProfileStartup(app, profile); \
console.log('startup gate: PASS');"

期望看到 status: 'compatible'、mismatches 为空数组，然后 PASS。

四、核心用法

4.1 模型选择器

安装后在 dsh 输入框的模型选择器里会看到两个新增分组：

• Our Free Model：当前网络出口可直接使用的模型（实测可用）
• Our Free Model · region-limited：上游对该地区不放行的模型（可见但不可用）

被判定为"点名但不路由"的模型不出现在任何分组里，只在设置页"不在选择器中的模型"分组留痕，带上拒因和探测时间，下次探测通过后自动恢复。

4.2 设置页（6 个分区）

打开 dsh 设置 → Our Free Model：

4.3 本地转发（OpenAI 兼容）

开启本地转发后，本地其他工具用以下格式调用这些免费模型：

# 复制自设置页的 curl 示例
curl http://localhost:<端口>/v1/chat/completions \
  -H "Authorization: Bearer <你的 Key>" \
  -H "Content-Type: application/json" \
  -d '{"model": "muse-spark-1.3", "messages": [{"role": "user", "content": "Hello"}]}'

base URL、Key 和端口全部在设置页本地转发分区复制。接口经过鉴权围栏，插件的 HTTP 路由优先级高于 dsh 内核 /api，自带与内核一致的信任检查。

4.4 思考强度配置

在 dsh 设置里选 Light / Balanced / Deep 三档：

• Light：输出上限 2,048 tokens（MiMo V2.6 等思考关不掉的模型翻倍 → 4,096）
• Balanced：输出上限 8,192 tokens（MiMo V2.6 翻倍 → 16,384）
• Deep：输出上限模型上限（MiMo V2.6 翻倍）

⚠️ 每张模型卡直接印出该档实际下发的上限，不是把一个 reasoning_effort 字符串丢给上游然后假装生效——是真正的 token 预算控制。

4.5 公告与升级

• 公告：仓库主人通过推送 JSON 到仓库，所有安装最迟一个探测周期内收到，urgent 级别全屏弹窗，可在设置页开关系统通知。
• 应用内升级：设置页一键升级，流程为：下载 → SHA-256 校验 → 备份 → 原子替换 → 校验回读 → 热重载，任一步失败自动回滚到上一版本。
• 热重载：升级与代码更新即时生效，不需要重启应用；也可在设置页手动触发或开启文件监视自动重载。

4.6 整合包安装（EAC / Mojobox 等）

整合包装此插件时，需要在安装时把 bundle config 设为 distribution: 'managed'（或向 settings.json 写入同一字段），这样插件的应用内升级、公告 feed 和热重载全部停用——避免两个写入者同时操作同一安装目录。模型 lane 不受影响。

五、典型适用场景

1. 免费调用前沿模型：在 dsh 里直接使用 Muse Spark 1.3、MiMo V2.6 等模型做代码任务，无需任何付费 API。
2. 本地工具接入：通过 OpenAI 兼容端口，让 LangChain、AnythingLLM 等本地工具使用这些免费模型。
3. 模型基准测试：在设置页逐模型跑单调用基准测试，对比速度和输出质量。
4. 无网控场景：学生、个人开发者快速试用前沿模型，不需要信用卡和 API Key。

六、坑与注意

⚠️ 必须先装 dsh：这个插件是 dsh 的插件，不能独立运行，必须先安装 DeepSeek Harness。

⚠️ Muse Spark 1.3 / MiMo V2.6 可用性以实际上游为准：模型清单跟随 OpenCode Zen 网关实时刷新，不是写死的，"可用"是实测结果而非承诺。网关点名但被判定为不可路由的模型会在选择器消失，这不是 bug 是设计。

⚠️ 桌面端不要用 link: 安装：如上所述，dsh profile 扫描器有安全闸门，违反会导致应用拒绝启动。

⚠️ 整合包装插件时必须设为 managed 模式：EAC / Mojobox 等整合包安装此插件时，必须设置 distribution: 'managed'，否则升级机制冲突会写坏安装目录。

⚠️ 地区门（region-limited）模型的可用性不稳定：上游对特定地区不放行的模型单独归组，有时通有时不通，插件会更新状态但不做保证。

⚠️ 本地转发 Key 不是你的：这是插件生成的本地 Key，不应与他人分享；OpenCode Zen 网关本身免费，但数据经过 opencode.ai 发出，隐私政策遵循上游。

⚠️ 模型选择器在整轮全部被拒时会保留全部选项：这是刻意的设计决策——宁可让用户看到模型也不让选择器变空，但选出来可能会收到 API 错误。

七、与同类对比

八、一句话推荐结论

只要你在用 dsh，装上这个插件就能零成本零门槛用上 Muse Spark 1.3 / MiMo V2.6 这些前沿模型，且附带 OpenAI 兼容本地转发——对于个人开发者和学生来说，是目前最顺滑的免费前沿模型入口之一。唯一的前置代价是你得先用上 dsh。