接入 Codex
Windows 接入
方式一 · 驱动设置页修复（推荐）
打开驱动设置页，点击"预览并修复插件副本"，确认 Codex 三项后执行。修复会自动复制脚本、增量合并 hooks.json 和 config.toml，保留已有配置。
完成后重启 Codex，在 /hooks 中核对并信任。
方式二 · 让 Codex 自己配置
把下面的提示复制给 Codex：
text
帮我配置知言家 AI Coding 伴侣的 Codex Hook。读 https://zyhome.run/docs/integrations/codex.txt 按步骤执行；无法联网则读驱动 plugins\codex 中的模板。保留已有配置，冲突时先问我，不要整文件覆盖。完成后告诉我改了什么、是否需要重启。方式三 · 手动安装
模板目录：%LOCALAPPDATA%\zy_home_vibe_coding_driver\plugins\codex\（修改过安装目录的，把前缀替换为实际路径，如 D:\mydriver\plugins\codex\）
1. 复制脚本
把 zy-vibe-coding-driver.ps1 复制到 %USERPROFILE%\.codex\。
2. 配置 hooks.json
目标：%USERPROFILE%\.codex\hooks.json
文件不存在则直接从模板复制；已存在则增量合并以下 5 个事件：UserPromptSubmit、PermissionRequest、PreToolUse、PostToolUse、Stop。每个事件的命令必须完整保留"优先调用 hookbridge.exe，失败回退 PowerShell 脚本"的结构，不要简化。
3. 配置 config.toml
目标：%USERPROFILE%\.codex\config.toml
确保包含以下内容（已有其他配置保留不动）：
toml
notify = [
"cmd.exe", "/d", "/s", "/c",
"powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"%USERPROFILE%\\.codex\\zy-vibe-coding-driver.ps1\" -HookEventName Stop"
]
[features]
hooks = true
codex_hooks = truenotify 是旧版 Codex 完成事件的兼容通道，不要因为已有 lifecycle Stop 就删除它。
4. 重启并信任
重启 Codex，执行 /hooks 核对事件和命令路径，首次信任提示确认指向 zy-vibe-coding-driver 后允许。
5. 验证
发一条普通消息，确认驱动控制台出现 Codex 任务、设备灯效变化。
WSL 接入
Codex 安装在 WSL（Ubuntu） 里时，宿主侧的 PowerShell 脚本无法直接使用，需改用 bash 转发脚本，并先在宿主侧开启桥接。
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 绑定冲突，导致驱动无法启动）。
让 Codex 自己配置
把下面的提示复制给 WSL 内的 Codex：
text
帮我配置知言家 AI Coding 伴侣的 WSL Codex Hook。读 https://zyhome.run/docs/integrations/codex.txt 的 WSL 部分按步骤执行；无法联网则读驱动 plugins\codex 中的模板。保留已有配置，冲突时先问我，不要整文件覆盖。完成后告诉我改了什么、是否需要重启。手动安装
1. 复制脚本
把 zy-vibe-coding-driver-codex.sh 复制到 ~/.codex/ 并加执行权限：
bash
chmod +x ~/.codex/zy-vibe-coding-driver-codex.sh2. 配置 hooks.json
目标：~/.codex/hooks.json，合并 5 个事件：UserPromptSubmit、PermissionRequest、PreToolUse、PostToolUse、Stop。
3. 配置 config.toml
目标：~/.codex/config.toml，合并 notify 与 [features] hooks=true、codex_hooks=true。
4. 干跑验证
bash
ZY_VIBE_CODEX_DRY_RUN=1 bash ~/.codex/zy-vibe-coding-driver-codex.sh UserPromptSubmit确认输出 source 为 codex。
5. 重启并验证
重启 Codex，在 /hooks 中核对并信任，发一条普通消息验证灯效。
WSL Codex 联网前提
Codex 连接 OpenAI 需要网络与认证：先打通 WSL 到宿主代理（重启 WSL 启用 hostAddressLoopback，或在 Clash 中开启 allow-lan），再完成 codex login。仅装 Hook 不联网时灯效不会触发。