免费模型桥接 Dreftian/Opencode-Connect

Opencode Connect（dsh-plugin-opencode-connect）

把 OpenCode Desktop 的全部免费模型无缝接入 DeepSeek Harness，并动态自动同步。

English Documentation • Documentación en Español

🇬🇧 English Documentation

📌 概览与它解决的问题

DeepSeek Harness 是高性能编排框架，也是桌面工作区，面向高级 AI 智能体、多步推理和软件开发工作流。但开发者常常卡在付费 API、速率限制、信用卡要求，或者为次要模型做复杂认证配置这些麻烦事上。

OpenCode Desktop 提供一整套精选的免费 LLM 模型，针对编码、推理、长上下文分析和多模态任务做过优化。

OpenCode Connect（dsh-plugin-opencode-connect） 正好补上这块缺口：
- 不需要任何 API Key：直接复用你本地已有的 OpenCode Desktop 实例。
- 10+ 个免费预配置模型：把高能力免费模型立刻暴露给 DeepSeek Harness，不用付费，也不用订阅。
- 动态自动同步：OpenCode Desktop 更新模型注册表、改动配置或新增免费模型时，插件自动监控并同步，全程不用重启。
- 原生 DeepSeek Harness 流式输出：完整对接 Cordis 和 DeepSeek Harness 协议，支持实时 token 流式输出和推理/思考轨迹（thinking_delta 与 text_delta）。

🧠 支持的 OpenCode Desktop 免费模型

插件会自动发现 OpenCode Desktop 的完整免费模型目录，并完成映射：

| Model ID | DeepSeek Harness Name | Context Window | Thinking / Reasoning | Modality | Best For |
| opencode/beam-free | Beam Free [Free] | 32,768 | ❌ | Text | Ultra-fast responses, linting, concise edits |
| opencode/big-pickle | Big Pickle [Free] | 65,536 | ✅ | Text | Balanced algorithmic coding & problem solving |
| opencode/deepseek-v4.1-flash-free | DeepSeek V4.1 Flash Free [Free] | 131,072 | ✅ | Text | High-throughput code synthesis & agent planning |
| opencode/glm-5.3-flash-free | GLM-5.3-Flash Free [Free] | 131,072 | ✅ | Text | 深度推理、多语言翻译、代码审查 |
| opencode/longcat-2.5-preview-free | LongCat 2.5 Preview Free [Free] | 262,144 | ❌ | Text | 超长上下文理解、全仓库分析 |
| opencode/mimo-v2.6-flash-free | MiMo-V2.6-Flash Free [Free] | 131,072 | ✅ | Text | 低延迟对话与响应式交互智能体 |
| opencode/nemotron-3-ultra-free | Nemotron 3 Ultra Free [Free] | 65,536 | ✅ | Text | 企业级代码分析与复杂架构 |
| opencode/nemotron-3.5-lightning-free | Nemotron 3.5 Lightning Free [Free] | 65,536 | ❌ | Text | 即时生成代码片段与文档 |
| opencode/nemotron-3.5-super-vl-free | Nemotron 3.5 Super VL Free [Free] | 65,536 | ✅ | Text, Image | UI/UX 原型图、可视化调试、图表 |
| opencode/space-bunny-free | Space Bunny Free [Free] | 65,536 | ✅ | Text | 创意工程、提示词设计、测试套件 |

🔄 动态自动同步引擎

flowchart LR
A["OpenCode Desktop(Local Service / CLI)"] <-->|"opencode modelsPeriodic Discovery"| B["OpenCodeModelSynchronizer(Background Daemon)"]
B -->|"Event: models-updated"| C["OpenCodeAdapter(LlmAdapter)"]
C -->|"Dynamic Registration"| D["DeepSeek HarnessLLM Runtime"]
D -->|"Stream Requests / Thinking Blocks"| E["Agent & Chat Sessions"]

1. 启动时自动发现：初始化时，OpenCodeModelSynchronizer 会通过 Windows、macOS 和 Linux 上的标准本地命令行路径调用 opencode models。
2. 差异比对：保留已知模型的快照并计算差异。如果 OpenCode 发布新模型版本或新增免费档模型，同步器会发出 models-updated 事件。
3. 热刷新注册表：DeepSeek Harness 动态更新当前服务商目录。你无需重新加载应用，即可在下拉选择器中立即选中新增的模型。

🚀 DeepSeek Harness 安装说明

方式 1：通过 DeepSeek Harness 图形界面（推荐）

1. 打开 DeepSeek Harness Desktop。
2. 在左侧导航栏点击 Complementos（插件）。
3. 点击右上角的 + Agregar complemento（+ 添加插件）按钮。
4. 在文本框中粘贴官方 GitHub 仓库 URL： https://github.com/Dreftian/Opencode-Connect

（也可以填写包名 dsh-plugin-opencode-connect（如果已发布），或本地目录路径）。
5. 点击 Instalar（安装）。DeepSeek Harness 会安装插件，并自动检测你的 OpenCode Desktop 模型。

方式 2：通过 DeepSeek Harness 命令行 / Cordis 补丁

使用 DeepSeek Harness 命令行工具链： Using pnpm
pnpm dsh plugin add dsh-plugin-opencode-connect

Or using npm
npm install --save dsh-plugin-opencode-connect
或者在 cordis.patch.yml 中应用随附的补丁包：
- insert:
- id: llm-opencode-connect
name: dsh-plugin-opencode-connect

方法 3：从本地目录路径安装（开发 / 离线）

要从源码运行或开发： Clone the repository
git clone https://github.com/Dreftian/Opencode-Connect.git
cd Opencode-Connect

Install dependencies and build
npm install
npm run build

然后在 DeepSeek Harness GUI 中：
1. 进入 Complementos > + Agregar complemento。
2. 选择 Cargar desde directorio local（从本地文件夹加载），或粘贴绝对路径： C:\Users\<YourUser>\path\to\Opencode-Connect

3. 点击 Confirmar。

⚙️ 配置选项

可以在 Cordis / DeepSeek Harness 配置文件（cordis.yml 或插件选项）中指定配置：

dsh-plugin-opencode-connect:
Path to opencode or opencode-cli executable.
Leave empty ("") to auto-detect across standard installation paths.
cliPath: ""

Background synchronization polling interval in milliseconds.
Default: 30000 (30 seconds)
syncIntervalMs: 30000

Filter only free models provided by OpenCode Desktop.
Default: true
onlyFreeModels: true

DeepSeek Harness LLM provider prefix ID.
Default: "opencode"
providerPrefix: "opencode"

Human-readable provider display name.
Default: "OpenCode Desktop"
providerDisplayName: "OpenCode Desktop"

Enable streaming of internal reasoning/thinking tokens.
Default: true
enableThinking: true

Per-request execution timeout in milliseconds.
Default: 180000 (3 minutes)
timeoutMs: 180000

Diagnostic log level ('debug' | 'info' | 'warn' | 'error').
Default: "info"
logLevel: "info"

🛠️ 故障排查与诊断

1.「OpenCode CLI binary not found」

- 原因：OpenCode Desktop 可能装在自定义的非标准目录，或者还没启动过。
- 解决办法：
- 确认已安装 OpenCode Desktop，并且至少运行过一次，让它解压出 CLI 辅助程序。
- 在配置中写明可执行文件的路径（cliPath: "C:\\path\\to\\opencode-cli.exe" 或 /usr/local/bin/opencode-cli）。
- 自动探测的标准位置：
- Windows：%LOCALAPPDATA%\Programs\@opencodedesktop\resources\opencode-cli.exe 或 %APPDATA%\ai.opencode.desktop\cli\\opencode-cli.exe
- macOS：~/Library/Application Support/ai.opencode.desktop/cli//opencode-cli 或 /Applications/OpenCode.app/Contents/Resources/opencode-cli
- Linux：~/.config/ai.opencode.desktop/cli//opencode-cli 或 /usr/bin/opencode-cli

2.「Rate limit exceeded / FreeUsageLimitError」

- 原因：免费档模型在高峰时段可能有临时的用量窗口限制。
- 解决方案：插件会自动检测配额错误，并以 HTTP 429 状态通知 DeepSeek Harness。你可以切换到另一个免费模型（例如从 deepseek-v4.1-flash-free 切换到 glm-5.3-flash-free 或 beam-free），全程不中断。

3. 验证自动同步

- 打开 DeepSeek Harness 开发者控制台或日志查看器。
- 在终端触发 opencode models，确认 OpenCode 命令行输出模型列表。
- 检查日志中是否有： [dsh-plugin-opencode-connect] Synced 10 free models from OpenCode Desktop

🇪🇸 西班牙语文档

📌 概览与它解决的问题

DeepSeek Harness 是新一代 AI 智能体开发与编排环境，面向自主编码和推理工作流。不过，开发者在使用辅助模型或支撑模型时，常常遇到付费订阅、配额受限、API 密钥配置繁琐等障碍。

OpenCode Desktop 自带一套完整的免费 LLM 模型生态，专为快速编码、结构化推理、超大仓库理解和多模态视觉而设计。

OpenCode Connect（dsh-plugin-opencode-connect） 解决了这个问题：
- 零 API 密钥：直接复用你本地安装的 OpenCode Desktop，无需绑卡，无需订阅。
- 10 个以上免费模型：把强大、高速的模型直接接入 DeepSeek Harness 的模型选择器和智能体。
- 动态自动同步：实时检测 OpenCode Desktop 中模型的新增、变更或更新，无需重启 DeepSeek Harness。
- 流式输出与原生思考（Thinking）：完整支持实时流式输出和推理轨迹（thinking_delta 与 text_delta）。

🧠 OpenCode 支持的免费模型

插件会自动检测并启用完整的免费模型目录：

| 模型 ID | DeepSeek Harness 中的名称 | 上下文窗口 | 思考（Thinking） | 模态 | 推荐场景 |
| opencode/beam-free | Beam Free [Free] | 32,768 | ❌ | 文本 | 快速编辑、代码格式化、直接回答 |
| opencode/big-pickle | Big Pickle [Free] | 65,536 | ✅ | 文本 | 复杂算法与通用推理 |
| opencode/deepseek-v4.1-flash-free | DeepSeek V4.1 Flash Free [Free] | 131,072 | ✅ | 文本 | 智能体规划、重构与核心逻辑 |
| opencode/glm-5.3-flash-free | GLM-5.3-Flash Free [Free] | 131,072 | ✅ | 文本 | 深度代码审查与双语任务 |
| opencode/longcat-2.5-preview-free | LongCat 2.5 Preview Free [Free] | 262,144 | ❌ | 文本 | 完整仓库的大规模分析与超长日志 |
| opencode/mimo-v2.6-flash-free | MiMo-V2.6-Flash Free [Free] | 131,072 | ✅ | 文本 | 超高速交互式聊天助手 |
| opencode/nemotron-3-ultra-free | Nemotron 3 Ultra Free [Free] | 65,536 | ✅ | 文本 | 架构设计与企业级推理 |
| opencode/nemotron-3.5-lightning-free | Nemotron 3.5 Lightning Free [Free] | 65,536 | ❌ | 文本 | 即时生成代码片段与文档 |
| opencode/nemotron-3.5-super-vl-free | Nemotron 3.5 Super VL Free [Free] | 65,536 | ✅ | 文本、图像 | 理解界面、图表与截图 |
| opencode/space-bunny-free | Space Bunny Free [Free] | 65,536 | ✅ | 文本 | 创意生成测试与模块化逻辑 |

🔄 架构与自动同步

flowchart TD
subgraph OpenCode["OpenCode Desktop (Local)"]
CLI["CLI de OpenCode (opencode run / models)"]
Catalog["Catálogo de Modelos Gratuitos"]
end

subgraph Plugin["dsh-plugin-opencode-connect"]
Client["OpenCodeClient (Spawn & Parsing)"]
Sync["OpenCodeModelSynchronizer (Daemon)"]
Adapter["OpenCodeAdapter (LlmAdapter)"]
end

subgraph Harness["DeepSeek Harness Runtime"]
Registry["Registro Central de Proveedores LLM"]
UI["Selector de Modelos en Chat / Agentes"]
end

Catalog --> CLI
CLI <-->|"Polling periódico (syncIntervalMs)"| Client
Client --> Sync
Sync -->|"Evento: models-updated"| Adapter
Adapter -->|"registerAdapter()"| Registry
Registry --> UI

🚀 在 DeepSeek Harness 中安装

方式 1：从图形界面安装（推荐）

1. 打开 DeepSeek Harness Desktop。
2. 在左侧导航栏进入 插件。
3. 点击顶部的 + 添加插件 按钮。
4. 粘贴官方 GitHub 仓库 URL： https://github.com/Dreftian/Opencode-Connect

（也可以填写包名 dsh-plugin-opencode-connect，或你电脑上的本地路径）。
5. 点击 安装。插件会立即注册，并开始同步你在 OpenCode 中的免费模型。

方式 2：通过 DeepSeek Harness 命令行 / Cordis 补丁

在 DeepSeek Harness 环境的终端中执行： Con pnpm
pnpm dsh plugin add dsh-plugin-opencode-connect

O con npm
npm install --save dsh-plugin-opencode-connect

或者在 cordis.patch.yml 文件中注册补丁：
- insert:
- id: llm-opencode-connect
name: dsh-plugin-opencode-connect

方式 3：从本地目录安装（开发 / 离线）

如果你想编译或定制源码： Clonar el proyecto
git clone https://github.com/Dreftian/Opencode-Connect.git
cd Opencode-Connect

Instalar dependencias y compilar
npm install
npm run build

然后在 DeepSeek Harness 中：
1. 进入 插件 > + 添加插件。
2. 选择本地安装文件夹： C:\Users\<TuUsuario>\ruta\a\Opencode-Connect

3. 点击 确认。

⚙️ 配置选项

你可以在 Cordis / DeepSeek Harness 的配置里自定义插件参数：

dsh-plugin-opencode-connect:
Ruta explícita al binario de OpenCode CLI.
Dejar en blanco ("") para autodetección en rutas del sistema.
cliPath: ""

Intervalo de sondeo para sincronización automática en milisegundos.
Por defecto: 30000 (30 segundos)
syncIntervalMs: 30000

Filtrar únicamente los modelos de capa gratuita de OpenCode.
Por defecto: true
onlyFreeModels: true

Identificador de prefijo del proveedor en DeepSeek Harness.
Por defecto: "opencode"
providerPrefix: "opencode"

Nombre visible en la lista desplegable de proveedores.
Por defecto: "OpenCode Desktop"
providerDisplayName: "OpenCode Desktop"

Transmitir bloques de razonamiento/pensamiento interno (thinking).
Por defecto: true
enableThinking: true

Límite máximo de tiempo por solicitud en milisegundos.
Por defecto: 180000 (3 minutos)
timeoutMs: 180000

Nivel de registro ('debug' | 'info' | 'warn' | 'error').
Por defecto: "info"
logLevel: "info"

🛠️ 故障排查指南（Troubleshooting）

1.「找不到 OpenCode CLI 二进制文件」

- 原因：OpenCode Desktop 装在自定义路径下，或者这台机器上从未启动过它。
- 解决办法：
- 至少打开一次 OpenCode Desktop，让它解压出命令行工具。
- 如果你用的是便携版安装，在插件配置里加上 cliPath: "C:\\ruta\\a\\opencode-cli.exe" 属性。
- 自动检查的标准路径：
- Windows：%LOCALAPPDATA%\Programs\@opencodedesktop\resources\opencode-cli.exe 或 %APPDATA%\ai.opencode.desktop\cli\\opencode-cli.exe
- macOS：~/Library/Application Support/ai.opencode.desktop/cli//opencode-cli 或 /Applications/OpenCode.app/Contents/Resources/opencode-cli
- Linux：~/.config/ai.opencode.desktop/cli//opencode-cli 或 /usr/bin/opencode-cli

2. 用量限制或临时配额（「Rate limit exceeded」）

- 原因：高峰时段，某个免费模型可能触达每分钟请求数的临时上限。
- 解决办法：插件会干净地拦截 429 错误。你只需在下拉列表里换一个可用的免费模型（比如从 deepseek-v4.1-flash-free 换成 glm-5.3-flash-free 或 beam-free），然后继续干活。

3. 如何验证自动同步

- 打开开发者控制台或 DeepSeek Harness 日志。
- 启动时你会看到同步记录： [dsh-plugin-opencode-connect] Synced 10 free models from OpenCode Desktop

- 如果 OpenCode 新增或更新模型，聊天选择器里的列表会立即刷新，无需重新加载应用。

🧪 测试与开发

Compilar TypeScript
npm run build

Ejecutar suite de pruebas unitarias
npm test

📄 许可证

本项目基于 MIT 许可证分发。
由 Dreftian 开发并维护。