接入 OpenCode
Windows 接入
方式一 · 驱动设置页修复（推荐）
打开驱动设置页，点击"预览并修复插件副本"，确认"OpenCode 全局插件"后执行。修复会自动把 JS 插件复制到全局目录，不影响其他插件。
完成后重启 OpenCode。
方式二 · 让 OpenCode 自己配置
把下面的提示复制给 OpenCode：
text
帮我配置知言家 AI Coding 伴侣的 OpenCode 插件。读 https://zyhome.run/docs/integrations/opencode.txt 按步骤执行；无法联网则读驱动 plugins\opencode 中的模板。保留已有配置，冲突时先问我，不要整文件覆盖。完成后告诉我改了什么、是否需要重启。方式三 · 手动安装
模板文件：%LOCALAPPDATA%\zy_home_vibe_coding_driver\plugins\opencode\zy-vibe-coding-driver.js（修改过安装目录的，把前缀替换为实际路径，如 D:\mydriver\plugins\opencode\zy-vibe-coding-driver.js）
1. 复制插件
复制到全局插件目录（所有项目生效）：
%USERPROFILE%\.config\opencode\plugins\zy-vibe-coding-driver.js目录不存在就创建，已有的其他插件保留不动。
2. 重启
重启 OpenCode 或重新打开当前会话，插件在启动时自动加载，无需修改配置文件。
3. 验证
发一条普通消息，确认驱动控制台出现 OpenCode 任务、设备灯效变化。
全局还是项目级
默认装全局。只想让某个项目启用时，复制到该项目的 .opencode\plugins\ 目录。两处不要同时放，否则事件会重复触发。
WSL 接入
OpenCode 安装在 WSL（Ubuntu） 里时，WSL 内的程序访问不到宿主机的驱动，需改用 WSL 专属插件，并先在宿主侧开启桥接。
WSL 前置检查（必看）
WSL 侧插件通过网关 IP 访问宿主机驱动，需要宿主侧已开启 netsh portproxy 桥接（<WSL适配器IP>:25263 → 127.0.0.1:25263）。未开启时事件无法送达，见WSL 桥接配置。注意桥接监听地址须为 WSL 虚拟网卡 IP，不要用 0.0.0.0（0.0.0.0:25263 会与驱动的 127.0.0.1:25263 绑定冲突，导致驱动无法启动）。
让 OpenCode 自己配置
把下面的提示复制给 WSL 内的 OpenCode：
text
帮我配置知言家 AI Coding 伴侣的 WSL OpenCode 插件。读 https://zyhome.run/docs/integrations/opencode.txt 的 WSL 部分按步骤执行；无法联网则读驱动 plugins\opencode 中的模板。保留已有配置，冲突时先问我，不要整文件覆盖。完成后告诉我改了什么、是否需要重启。手动安装
- 把 WSL 专属插件
zy-vibe-coding-driver-wsl.js复制到~/.config/opencode/plugins/。 - 在
~/.config/opencode/opencode.json的plugin数组中登记该插件路径（保留model等已有字段）。 - 重启 WSL 内的 OpenCode，发一条普通消息验证灯效。