dsh-xl-free-model:在 DSH 中免配置接入免费 OpenAI 兼容模型

前言

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

步骤:

  1. 克隆仓库
git clone https://github.com/zhangmaorongXL/dsh-xl-free-model.git
cd dsh-xl-free-model
  1. 安装到 dsh

将本目录复制到 dsh 插件目录,或在 dsh 设置中指定插件路径。

  1. 重启 dsh

重启后,会话模型选择列表中将出现 XL Free Model 分组,包含可用的免费模型。

在 DSH 中使用

  1. 新建会话
  2. 在模型选择器中选择 XL Free Model 分组下的模型(如 mimo-v2.6-flash-free)
  3. 正常对话即可

独立使用代理

代理兼容 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜