把本机 OpenCode 的模型能力转换成 LLM-wiki 可以识别的 OpenAI 兼容 API。

Version License Node

OpenCode CLI 本身能调用免费模型(如 MiMO V2.5 Free),但 LLM-wiki 需要的是 OpenAI 兼容 API。这个 Bridge 的作用,就是把本机 OpenCode 的能力转换成 LLM-wiki 能识别的 API。

大家不用额外注册模型平台账号,不用配置复杂密钥,只需要保持 OpenCode CLI 正在运行(终端中运行 opencode),然后启动 Bridge,再把三个字段填进 LLM-wiki。

课堂主线:

Obsidian
 ↓
LLM-wiki
 ↓
OpenAI-compatible API
 ↓
LLM-wiki OpenCode Bridge
 ↓
OpenCode CLI (opencode)
 ↓
MiMO V2.5 Free

• LLM-wiki 课程学员
• Obsidian 用户
• Windows 小白用户
• 想本地测试 OpenCode 免费模型的人

1. 安装 Node.js LTS — 下载地址:https://nodejs.org/
2. 安装 OpenCode CLI — 在终端中运行:npm install -g opencode-ai
3. 首次配置 OpenCode CLI — 在终端中运行 opencode,选择模型提供商并确认 MiMO V2.5 Free 可用
4. 启动 Bridge — 双击 start-windows.bat,Bridge 会自动启动 OpenCode CLI 后端服务(opencode serve),无需手动启动

本工具仅供本机学习测试使用,不要用于公网服务。

双击项目根目录下的:

start-windows.bat

脚本会自动:

1. 检查 Node.js 是否安装
2. 检查 npm 是否可用
3. 检查 OpenCode CLI 是否已安装
4. 自动安装依赖(首次运行)
5. 启动 API 服务(同时自动启动 opencode serve 后端)
6. 在终端中显示 LLM-wiki 配置信息
7. 自动打开浏览器到配置页面

在 LLM-wiki 的自定义 API 配置中填写:

也可以打开浏览器访问 http://127.0.0.1:9999 查看配置页面,支持一键复制。

项目开箱即用,默认配置如下:

{
 "BIND_HOST": "127.0.0.1",
 "PORT": 9999,
 "API_KEY": "sk-tjad1230",
 "DEFAULT_MODEL": "mimo-v2.5-free",
 "DEFAULT_MODEL_DISPLAY_NAME": "MiMO V2.5 Free",
 "OPENCODE_SERVER_URL": "http://127.0.0.1:5949"
}

如需修改,可以编辑 config.json 或设置环境变量(参考 .env.example)。

以下模型名都可以正常使用,都会指向 MiMO V2.5 Free:

mimo-v2.5-free
MiMO V2.5 Free
mimo
opencode-auto

curl http://127.0.0.1:9999/health

正常返回:

{
 "status": "ok",
 "service": "llm-wiki-opencode-bridge",
 "opencode": "connected",
 "endpoint": "http://127.0.0.1:9999/v1",
 "defaultModel": "mimo-v2.5-free",
 "defaultModelDisplayName": "MiMO V2.5 Free"
}

curl -X POST http://127.0.0.1:9999/v1/chat/completions \
 -H "Authorization: Bearer sk-tjad1230" \
 -H "Content-Type: application/json" \
 -d '{
 "model": "mimo-v2.5-free",
 "messages": [{"role": "user", "content": "你好!"}],
 "stream": false
 }'

1. 确认 OpenCode CLI 已安装(npm install -g opencode-ai)
2. 确认已运行 opencode 进行首次配置(选择模型提供商)
3. 确认 Bridge 服务已启动(终端窗口没有关闭)
4. 打开浏览器访问 http://127.0.0.1:9999 查看状态
5. Bridge 会自动启动 opencode serve 后端,如果自动启动失败请手动运行:opencode serve --port 5949

• 检查 OpenCode CLI 是否正常启动
• 在 OpenCode CLI 中尝试与 MiMO V2.5 Free 对话一次
• 刷新 http://127.0.0.1:9999/v1/models

Bridge 启动时会自动启动 opencode serve 后端服务。如果自动启动失败,可以手动在终端中运行:

opencode serve --port 5949

如果尚未安装 OpenCode CLI,请先运行 npm install -g opencode-ai。

关闭其他正在运行的 Bridge 实例。如果仍有问题,可以在 config.json 中修改 PORT 为其他端口号,同时更新 LLM-wiki 中的 Endpoint。

Bridge 会自动管理 opencode serve 后端进程。如果关闭 Bridge 窗口,后端服务也会被停止,LLM-wiki 将无法调用任何模型。

• 默认只监听 127.0.0.1,不开放局域网访问
• 不读取浏览器 Cookie
• 不导出 OpenCode 账号凭据
• 不做账号池
• 不上传用户笔记内容到额外服务器
• 不保存用户 prompt 日志(除非主动开启 debug)
• 仅供本机学习测试使用

# 安装依赖
npm install
# 启动服务
npm start
# 运行测试
npm test

MIT · 详见 LICENSE