先把本仓库 clone 到本地（下面把路径记作 <仓库>，即 git clone 出来的目录）：
| 你在用 | 最短路径 |
|---|---|
| ZCode | 打开 ~/.zcode/cli/config.json，把 zcode/user-config.example.json 的 hooks 合并进去，把 __COMI_REPO__ 换成本仓库绝对路径 → 新开一个 ZCode 会话 |
| DSH | dsh plugin --profile <你的profile> add <仓库>/adapters/dsh/comi-bridge（dsh web 用 web，桌面应用用 desktop）→ 重启 DSH |
| Claude Code | 把 claude-code/settings.example.json 的 hooks 合并进 ~/.claude/settings.json，替换 __COMI_REPO__ |
| Cursor | 合并 cursor/hooks.example.json 到 Cursor 的 hooks 配置，替换 __COMI_REPO__ |
| OpenCode | 把 opencode/comi_opencode.py 作为 SSE 监听进程挂上，见 opencode/README.md |
| Codex | 见 codex/README.md——目前只能跟随它自己新建的会话，不能跟随你正在用的 Codex 桌面会话 |
接好后验证（不需要真的跑任务）：
echo '{"session_id":"t1","hook_event_name":"PreToolUse","tool_name":"Bash"}' \
| python3 <仓库>/adapters/zcode/comi_hook.py
ls ~/.comi-pet/events/ # 出现一个事件 JSON 即说明通路正常，桌宠会消费它接不上时桌宠显示「未收到事件」是正确行为——它只报告真实收到的东西，不会凭进程存在就假装在工作。
全部适配器共用同一套 bridge（协议 v1、收件箱 ~/.comi-pet/events、桌宠端
状态归约），见 docs/BRIDGE.md。统一能力声明：
read_state / read_summary / send_prompt——未核实或不支持就如实为 ❌，
不提供会静默失效的按钮。第二阶段（send_prompt）统一设计，不逐家私造。
| 适配器 | 接入形态 | read_state | read_summary | send_prompt | 已验证版本 | 验收方式 |
|---|---|---|---|---|---|---|
| ZCode | 官方 Hooks（process 执行器） | ✅ | 开关后 ✅ | ❌ | 接口按官方文档 | fixture 重放（tests/test_zcode_adapter.py）；真实新 session 验收待用户执行 |
| DSH | cordis 宿主插件（session/event） | ✅ | 开关后 ✅ | ❌（SDK 属二阶段） | 事件语义按 dsh-pet 与本地 dsh 源码 | 映射自测（dsh/self-test.mjs）+ Python 归约重放；真实任务待用户执行 |
| Codex | App Server stdio JSON-RPC | ✅（仅本客户端会话） | ❌ | ❌ | codex-cli 0.162.1 实测握手/thread-list | mock 重放 + 实连 --list；当前不支持跟随正在使用的 Codex 桌面会话（ipc.sock 为内部 IPC） |
| Claude Code | Hooks（command 形式） | ✅ | 开关后 ✅ | ❌ | 按官方文档 | fixture 重放（tests/test_host_hooks.py）；本机未装，实机待用户验收 |
| Cursor | Hooks（项目/用户 hooks.json） | ✅ | 开关后 ✅ | ❌ | 按官方文档 | fixture 重放；本机未装，实机待用户验收 |
| OpenCode | Server HTTP SSE 监听 | ✅ | ❌ | ❌ | 按官方文档 | mock SSE 重放（tests/test_opencode_adapter.py）；本机未装 |
共同约定（docs/BRIDGE.md「安全红线」）： 默认只传状态；摘要需显式开启且截断清洗；不读 transcript/消息正文冒充上下文； Hook/监听失败静默退出不阻塞宿主；等待确认只提醒用户回宿主批准，不自动审批； 普通 Stop / turn end 一律显示"本轮结束"，只有明确结果事件才播完成。
"旁听用户正在用的会话"与"客户端自建会话"是两回事：目前六家都是只读 监测（Codex 明确仅本客户端会话）；任何适配器接不上时桌宠显示未连接是正确 行为，不从进程存在推断工作状态，更不会悄悄新建会话冒充旁听。