前言¶
DeepSeek Harness(DSH)的「一切皆插件」理念让智能体开发更灵活,但模型接入仍需配置 provider、管理 API Key,对免费模型尤其繁琐。本插件在 DSH 中自动运行本地 OpenAI 兼容代理,经 OpenCode 免费通道使用 mimo-v2.6-flash-free 等模型,无需登录、注册或填 API Key,模型直接出现在会话的模型选择列表中。
插件定位¶
维护者:zhangmaorongXL
分类:模型推理
GitHub:https://github.com/zhangmaorongXL/dsh-xl-free-model
插件名称为 dsh-xl-free-model,将 OpenAI 兼容代理挂载到 DSH,经 Host 半身注册的 LlmAdapter 让免费模型直接出现在模型选择列表,无需在 profile 的 cordis.patch.yml 手工配置 provider。
功能特性¶
安装后,免费模型自动出现在会话的模型选择列表,无需额外配置。
本地代理监听 http://127.0.0.1:8787/v1,可被任意 OpenAI SDK 调用。dsh 启动时自动拉起代理,退出时自动清理。
优先复用已打开的 OpenCode 桌面版;未打开时自动启动无头 CLI 后备。CLI 二进制缺失时直接从 npm registry 下载 tarball 解压,npm install 兜底。
完整支持 SSE 流式响应,通过提示词桥接模拟工具调用,每请求附带最小安全工具集。流错误不伪造完成,代理错误/流截断会向 dsh 上报真实失败(先输出已缓冲的部分文本)。
后端连接池自动复用,提升响应速度。无需手动配置密码,自动从 OpenCode 进程环境读取 PEB 密码。
安装与启用¶
前置条件:
- Windows 10/11 x64
- Node.js ≥ 22
- dsh 桌面版或 CLI
步骤:
- 克隆仓库
git clone https://github.com/zhangmaorongXL/dsh-xl-free-model.git
cd dsh-xl-free-model
- 安装到 dsh
将本目录复制到 dsh 插件目录,或在 dsh 设置中指定插件路径。
- 重启 dsh
重启后,会话模型选择列表中将出现 XL Free Model 分组,包含可用的免费模型。
在 DSH 中使用¶
- 新建会话
- 在模型选择器中选择
XL Free Model分组下的模型(如mimo-v2.6-flash-free) - 正常对话即可
独立使用代理¶
代理兼容 OpenAI API,可被任意支持自定义 base URL 的工具调用:
# 启动代理(dsh 运行时会自动管理,通常无需手动)
node proxy.cjs
# Python 示例
from openai import OpenAI
client = OpenAI(
base_url="http://127.0.0.1:8787/v1",
api_key="changeme-dsh-key" # proxy.config.json 中的 apiKey
)
response = client.chat.completions.create(
model="mimo-v2.6-flash-free",
messages=[{"role": "user", "content": "你好"}],
stream=True
)
// Node.js 示例
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "http://127.0.0.1:8787/v1",
apiKey: "changeme-dsh-key",
});
const stream = await client.chat.completions.create({
model: "mimo-v2.6-flash-free",
messages: [{ role: "user", content: "你好" }],
stream: true,
});
配置说明¶
proxy.config.json 完整配置项:
{
"proxyHost": "127.0.0.1", // 代理监听地址
"proxyPort": 8787, // 代理监听端口
"apiKey": "changeme-dsh-key", // API Key(必改)
"backend": {
"host": "", // OpenCode 后端地址(留空自动发现)
"port": 0, // OpenCode 后端端口(留空自动发现)
"username": "opencode", // 后端用户名
"password": "", // 后端密码(留空自动 PEB 发现)
"cli": {
"enabled": true, // 是否启用无头 CLI 后备
"path": "cli\\node_modules\\opencode-windows-x64\\bin\\opencode.exe",
"port": 4097 // CLI 后备端口
}
}
}
适用场景与注意¶
适合需要频繁切换免费模型的开发者,或希望避免手动配置 provider 的场景。
插件以当前 dsh 进程权限运行,安装前应检查源码与许可证。许可证为 MIT。
结尾¶
插件在 DSH 中自动运行本地 OpenAI 兼容代理,经 OpenCode 免费通道使用 mimo-v2.6-flash-free 等模型,零配置接入,支持流式、多轮会话复用与 function calling 桥接。
目录页:https://www.skillhub.cn/plugins/zhangmaorongXL/dsh-xl-free-model
GitHub:https://github.com/zhangmaorongXL/dsh-xl-free-model