dhdbvcg/opencodeAI

opencodeAI

在 DSH（DeepSeek Harness）里原生使用 OpenCode Zen 的免费模型，支持视觉识别。

无需 API Key。无需注册。无需额外进程。

npm
license
node
DeepSeek Harness

opencodeAI 是一个基于 opencode2dsh 的增强版本，为 DSH（DeepSeek Harness）提供原生 LlmAdapter，直接流式对接
OpenCode Zen 的匿名免费通道。

✨ 主要改进

🖼️ 视觉模型支持（mimo-v2.5-free）
- 新增对 mimo-v2.5-free 模型的视觉（识图）能力支持
- 支持 Base64 编码图片和 HTTP URL 图片
- 模型自动检测输入模态，智能处理多模态内容

🎨 主题系统
- 支持自定义主题配置
- 深色/浅色模式自适应
- 可通过 CSS 变量自定义颜色

特性

- 零凭据、零配置——匿名通道不需要任何 Key；装好、重启、开聊
- 原生 adapter，无 sidecar——一个 npm 包，没有子进程、没有二进制、没有本地端口
- CLI 同形伪装——请求携带 OpenCode CLI 的 User-Agent 和整套会话/请求/项目关联头
- 视觉模型支持——mimo-v2.5-free 模型支持图像理解
- 思考等级可选——带推理的免费模型在 DSH 模型选择器里出现思考等级选项
- 实时目录 + 三级回退——上游实时列表 ∩ 元数据判定免费，断网时依次回退到磁盘缓存与已验证的静态名单
- 自愈能力——启动期快速重试、周期刷新，并落盘健康快照便于排查

安装

从 opencodeAI 安装（推荐，最新功能 + DSH 集成）：

dsh plugin --profile web add https://github.com/dhdbvcg/opencodeAI.git

从 npm 安装（已发布的包）：

dsh plugin --profile web add @opencode2dsh/dsh-plugin

从源码安装（自行打包）：

git clone https://github.com/dhdbvcg/opencodeAI.git
cd opencodeAI/packages/plugin
pnpm install && pnpm pack
dsh plugin --profile web add ./opencode2dsh-dsh-plugin-.tgz

验证：重启 dsh web，打开模型选择器，在 opencode2dsh 分组里选模型即可。

需要带 web profile 的 DSH（DeepSeek Harness）；Node.js ≥ 20；出站 HTTPS 需可达 opencode.ai 与 models.dev。

视觉功能

mimo-v2.5-free 模型现在支持图像输入。使用方法：

1. 在模型选择器中选择 mimo-v2.5-free
2. 在对话中附加图片（Base64 或 URL）
3. 模型将同时处理文本和图像内容

支持的图片格式：
- Base64 数据 URL（data:image/png;base64,...）
- HTTP/HTTPS URL
- 原始 Base64 字符串（自动包装为 PNG）

配置

默认配置开箱即用。需要覆盖时，编辑 profile 的 cordis.patch.yml：

- id: opencode2dsh
name: '@opencode2dsh/dsh-plugin'
config:
mode: adapter        # adapter（默认）| sidecar
providerId: opencode2dsh
refreshSeconds: 300  # 目录刷新周期（秒）

| 配置项 | 默认值 | 说明 |
| --- | --- | --- |
| mode | adapter | adapter：原生 LlmAdapter 直连 Zen。sidecar：旧版本地 agent 模式。 |
| providerId | opencode2dsh | 在 DSH 中显示的 provider 名称。 |
| refreshSeconds | 300 | 实时目录刷新间隔；定价元数据每 24 小时刷新。 |

主题定制

您可以通过修改 DSH 中的主题设置来自定义插件外观。插件使用 CSS 变量实现一致的主题效果：

:root {
--primary-color: #007bff;
--background-color: #ffffff;
--text-color: #333333;
}

工作原理

DSH 会话
│  harness chunk（block-start / text-delta / usage / finish …）
▼
ZenAdapter（注册的 LlmAdapter）
│  pi-ai openai-completions 流式
│  pi-ai openai-responses 流式（视觉模型）
▼
https://opencode.ai/zen/v1        ← Authorization: Bearer public
携带与 CLI 同形的请求头：
user-agent: opencode/…
x-opencode-client, x-opencode-session, x-session-affinity,
X-Session-Id, x-opencode-request, x-opencode-project

- 会话关联——session/project id 由会话首条用户消息经 SHA-256 派生
- 目录回退链——S1：实时 GET /v1/models；S2：models.dev 定价元数据判定 "免费"；S3：编译期验证的静态名单
- 视觉处理——从消息中提取图片，为支持的模型发送多模态内容

健康状态与排查

插件在每轮刷新后写入健康快照：

~/.opencode2dsh/adapter-status.json

| 现象 | 可能原因与处理 |
| --- | --- |
| 只有 3 个模型 | 启动时网络未就绪，重试会在约 1 分钟内补齐 |
| lastError: "fetch failed" 持续出现 | 出站 HTTPS 到 opencode.ai 被拦截；检查代理/VPN 规则 |
| 对话中报限流错误 | 匿名通道按 IP 限额；切换网络节点或稍后再试 |

开发

git clone https://github.com/dhdbvcg/opencodeAI.git
cd opencodeAI/packages/plugin
pnpm install
pnpm typecheck && pnpm test   # 单元测试
pnpm build                    # 打包到 lib/

致谢

- opencode2dsh，作者
@FishBottle7——本项目基于此 fork 而来
- OpenCode——运营免费匿名 Zen 通道
- @earendil-works/pi-ai——adapter 模式使用的线上协议层
- DeepSeek Harness 与 dsh-market 社区

许可证

MIT © dhdbvcg