dsh-opencode-connect 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-opencode-connect 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-opencode-connect 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-opencode-connect 还在维护吗？

GitHub 1 星。最近一次上游提交在 2026/10/23。

OpenCode 免费模型接入 sanser9/dsh-opencode-connect

DeepSeek Harness

sanser912 天前有提交已提供中文文档扫描：高危

在 GitHub 查看 ↗

在模型选择器里直接调用本机 OpenCode 免费模型

30.4/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/27 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add sanser9/dsh-opencode-connect

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：已验证

是什么[目录]—

dsh 原生插件 · market

暂无时间戳·判据 →

装得上吗[实装验证]✓

本站已在 dsh 0.2.1-rc.2 下真实安装成功

非静态推断

L5 · 运行时冒烟等级说明 →

数据截至 2026/10/28·判据 →

安全吗[自动扫描]—

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

数据截至 2026/11/04·判据 →

还在维护吗[仓库]✓

活跃：最近一次提交在 12 天前

暂无时间戳·判据 →

图例：✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据，不代表插件有问题

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

可信度证据

🔴 安全扫描发现高危能力自动 · 静态分析源码

v2.7.0

🔴 扫描：高危尚无人工评估

静态扫描发现安装期即执行代码，或命令参数由运行时变量拼接（参数来源无法静态判定，从严处理）。

命令参数由运行时变量拼接读写/删除本地文件发起外部网络请求

查看扫描证据（共 9 处，展示前 9 条）

读取本地文件
dist/opencode-server.js:25
if (existsSync(candidate)) return candidate
执行外部命令运行时拼接
dist/opencode-server.js:37
execSync(`${JSON.stringify(bin)} --version`, { stdio: 'ignore', timeout: 5_000 })
发起网络请求
dist/opencode-server.js:50
return fetch(OPENCODE_SERVER_URL + '/session', {
执行外部命令来自配置/变量
dist/opencode-server.js:82
const child = spawn(binary, ['serve', '--port', String(OPENCODE_SERVER_PORT)], {
发起网络请求
dist/opencode-server.js:109
const res = await fetch(OPENCODE_SERVER_URL + '/session', {
发起网络请求
dist/opencode-server.js:145
const res = await fetch(`${baseUrl}/session`, {
发起网络请求
dist/opencode-server.js:164
const res = await fetch(`${baseUrl}/config/providers`, { signal })
发起网络请求
dist/opencode-server.js:191
const res = await fetch(`${baseUrl}/event?sessionID=${encodeURIComponent(sessionId)}`, { signal })
发起网络请求
dist/stream-bridge.js:147
const res = await fetch(`${opencodeUrl}/session/${sessionId}/message`, {

扫描于 2026/11/4（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/cordis@deepseek-ai/dsh-attachment@deepseek-ai/dsh-llm@deepseek-ai/dsh-llm-pi-ai

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

把 OpenCode 的免费模型接入 DeepSeek Harness，零配置就能在 DSH 里用上 OpenCode 免费模型。

README

由 DeepSeek 最新模型翻译生成

dsh-opencode-connect 把 OpenCode 的免费模型接入 DeepSeek Harness —— 零配置、零费用、开箱即用。 English ·安装 ·工作原理 ·故障排查 ·开发一个独立的 DeepSeek Harness (DSH) bundle 插件。它把本机已安装的 OpenCode CLI 的免费模型（deepseek-v4.1-flash-free、glm-5.3-flash-free、big-pickle、kimi-k3-free、qwen3.7-max-free 等）接入 DSH 的模型选择器，让你在 DSH 里直接使用，无需 API Key、无需登录、不产生任何费用。插件会自动拉起或复用本机的 opencode serve（127.0.0.1:40961），再通过一层本地 loopback shim 把 OpenCode 的事件流翻译成 OpenAI 兼容的 SSE，交给 DSH 的 pi-ai 适配器。整个过程不经过任何第三方中转，凭据（如果有）始终留在你自己的机器上。风险提示本插件依赖 OpenCode CLI 的免费层，属于非官方集成方式。上游一旦调整免费策略或接口，插件可能需要跟着更新，甚至可能失效。请自行评估后使用；需要长期稳定与合规性时，请使用各家的官方 API。

展开完整文档（README 剩余 1 节）

dsh-opencode-connect

把 OpenCode 的免费模型接入 DeepSeek Harness —— 零配置、零费用、开箱即用。

English ·安装 ·工作原理 ·故障排查 ·开发

一个独立的 DeepSeek Harness (DSH) bundle 插件。它把本机已安装的 OpenCode CLI 的免费模型（deepseek-v4.1-flash-free、glm-5.3-flash-free、big-pickle、kimi-k3-free、qwen3.7-max-free 等）接入 DSH 的模型选择器，让你在 DSH 里直接使用，无需 API Key、无需登录、不产生任何费用。

插件会自动拉起或复用本机的 opencode serve（127.0.0.1:40961），再通过一层本地 loopback shim 把 OpenCode 的事件流翻译成 OpenAI 兼容的 SSE，交给 DSH 的 pi-ai 适配器。整个过程不经过任何第三方中转，凭据（如果有）始终留在你自己的机器上。

风险提示

本插件依赖 OpenCode CLI 的免费层，属于非官方集成方式。 上游一旦调整免费策略或接口，插件可能需要跟着更新，甚至可能失效。请自行评估后使用；需要长期稳定与合规性时，请使用各家的官方 API。

需要说明的是，这个插件做的事情很普通：省掉在 OpenCode 和 DSH 之间来回切换的麻烦。你本来就能在终端里免费用这些模型，插件只是把同一份本地能力接到 DSH 的模型选择器上——不提供账号、不共享凭据、不绕过计费（免费模型本身也不计费）。

功能特性

- 零配置接入 —— 装好 OpenCode CLI 和本插件，重启 DSH 即可在模型选择器里看到全部免费模型，不需要任何 API Key 或登录。
- 免费模型自动发现 —— 启动时从本机 opencode serve 的 /config/providers 读取当前可用的免费模型；上游新增或下线模型时，插件每 5 分钟自动刷新一次目录，模型选择器随之更新（模型名统一带 · Free 后缀，一眼可辨）。
- 自动管理 OpenCode 服务 —— 检测到本机已有 opencode serve 在跑就直接复用（不抢占、不重启）；没有才按需拉起，并在 DSH 退出时干净地回收自己启动的进程。
- 安全 loopback shim —— 每次进程启动生成一个 32 字节随机 secret，仅绑定 127.0.0.1，并校验 Host / Origin 必须是回环地址；真实的 OpenCode 服务地址不暴露给 pi-ai，适配器只拿到 shim 的地址与一次性 token。
- 流式输出与用量回传 —— 把 OpenCode 的 message.part.delta 事件流翻译成 OpenAI 兼容 SSE，包含增量文本、结束帧与 token 用量；中断（用户停止、切换会话）时立即释放上游连接。
- 零费用 —— 所有模型的 cost 都被声明为 0，DSH 的用量统计不会虚报开销。

安装

前置条件

1. Node.js ^22.19.0 或 >=24.0.0（DSH 自身的要求）
2. DeepSeek Harness（桌面版或 dsh CLI）
3. OpenCode CLI ≥ 1.18.0 —— 免费层的版本门槛。安装方式任选：

官方安装脚本（macOS / Linux）
curl -fsSL https://opencode.ai/install | bash

或通过 npm
npm install -g opencode-ai

验证版本（必须 >= 1.18.0） opencode --version

插件按以下顺序查找二进制，任一命中即可：

~/.local/share/dsh-opencode-connect/bin/opencode
~/.local/bin/opencode
/usr/local/bin/opencode
PATH 上的 opencode

提示：如果你的 opencode 不在上述位置，把它软链到 ~/.local/bin/opencode 即可。

安装插件

方式一：从 npm（发布后）
dsh plugin install dsh-opencode-connect

方式二：从源码（开发/自用）
git clone https://github.com/sanser9/dsh-opencode-connect.git
cd dsh-opencode-connect
npm install --omit=dev
npm run build
dsh plugin install "$PWD"

安装完成后重启 DSH（或让宿主重新加载 profile），模型选择器里会出现 OpenCode 分组。

工作原理

DSH 模型选择器 -> DSH PiAiAdapter（provider: opencode） -> 本地 loopback shim（随机端口 + 进程内随机 secret，OpenAI 兼容 /v1/chat/completions） -> 本机 opencode serve（127.0.0.1:40961，由插件拉起或复用） -> OpenCode 免费模型 → SSE 事件流（message.part.delta） → stream-bridge 翻译为 OpenAI SSE → DSH 渲染流式回复

关键设计：

- shim 是唯一出口：pi-ai 只看到 shim 的地址和一次性 token，OpenCode 服务的真实地址不外泄；shim 拒绝一切非回环请求。
- 目录双来源：启动时优先读 opencode serve 的实时目录；读不到时退回内置的静态名单（src/catalog.js），保证模型选择器不会空着。
- 5 分钟自愈：如果启动时实时目录没拿到（服务还没就绪），后台定时器会在后续轮询里补上并通知 DSH 刷新适配器。

内置兜底模型名单

当 opencode serve 暂时不可达时，插件用以下名单兜底（src/catalog.js）：

| 模型 id | 上下文 |
| big-pickle | 200K |
| mimo-v2.6-flash-free | 200K |
| deepseek-v4.1-flash-free | 200K |
| glm-5.3-flash-free | 200K |
| minimax-m3.1-flash-free | 1M |
| nemotron-3-ultra-free | 1M |
| kimi-k3-free | 200K |
| qwen3.7-max-free | 200K |
| north-mini-code-free | 200K |
| trinity-large-preview-free | 200K |
| ling-3.0-flash-free | 200K |

实时目录可用时以实时目录为准，上表只是兜底。

故障排查

| 现象 | 原因与处理 |
| 模型选择器里没有 OpenCode 分组 | 插件未激活：检查 DSH 日志里是否有 dsh-opencode-connect 的启动记录；确认 profile 的 cordis.patch.yml 有 llm-opencode 行。 |
| 分组在但模型列表为空 | opencode serve 没起来。手动执行 opencode serve --port 40961 看报错；确认 CLI 版本 ≥ 1.18.0（旧版免费层不可用）。 |
| 发送消息报 Provider is not configured: opencode | 旧版本的已知问题（auth resolver 返回空）。升级到 0.1.0 及以上。 |
| 报 no opencode binary found | 二进制不在查找路径里。按上文装好，或软链到 ~/.local/bin/opencode。 |
| 端口 40961 被占用 | 插件会先探测该端口；若被别的程序占用且不是 opencode，换一个程序或释放端口。 |
| 回复中途截断 | OpenCode 免费层有速率/上下文限制，长对话会被上游拒绝。开新会话或换一个模型。 |

查看日志：

macOS 桌面版 tail -f ~/Library/Application\ Support/DSH\ Desktop/logs/host/.log

只看本插件 grep dsh-opencode-connect ~/Library/Application\ Support/DSH\ Desktop/logs/host/.log

开发

git clone https://github.com/sanser9/dsh-opencode-connect.git
cd dsh-opencode-connect
npm install # 只装 @earendil-works/pi-ai
npm run build # src/.js -> dist/.js（纯拷贝，无编译）
npm test # Node 内置 test runner，零额外依赖

目录结构：

src/
index.js 插件入口：注册 provider、适配器、5 分钟目录刷新 shim.js 本地 OpenAI 兼容 HTTP shim（鉴权 + 回环校验 + 路由） stream-bridge.js OpenCode SSE -> OpenAI SSE 翻译 opencode-server.js opencode serve 生命周期 + HTTP 客户端 catalog.js 模型目录（实时 + 兜底名单） loopback.js 回环地址判定与端口绑定 scripts/build.mjs 构建（src -> dist） tests/ Node 内置 test runner 测试（12 个用例） cordis.patch.yml bundle 声明（llm-opencode 行） .github/workflows/ CI（Node 22.19 / 24 × Linux / macOS） marketplace/ Awesome DSH Plugin 收录草稿

本地调试：把本仓库 link: 进某个 DSH profile 的 dependencies，重启 dsh web，日志里应出现：

dsh-opencode-connect: opencode server ready at http://127.0.0.1:40961
dsh-opencode-connect: shim listening at http://127.0.0.1:xxxxx
dsh-opencode-connect: registered opencode provider

免责声明

本项目与 OpenCode、DeepSeek 均无隶属关系，是一个社区维护的第三方 DSH 插件。免费模型的可用性、速率限制与计费规则完全由上游决定，本项目不提供任何保证。使用即表示你理解并接受这一点，并自行承担由此产生的风险。

License

MIT © 2026 sanser9