安装后「我的配置被改了」/ 与 omc、agt 疑似冲突

你会遇到什么

你执行 code-review-graph install（或 init）后，发现 ~/.claude.json、~/.codex/hooks.json 等配置文件被写入了内容；如果还装了 oh-my-claudecode、agent-governance-toolkit，你开始怀疑它们互相打架。第一反应是"中毒了/出 bug 了"，其实这是这个工具的正常行为。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

install 子命令会向检测到的 AI 平台注册 MCP/hooks——这是它的功能设计，不是故障：

与 omc/agt 存在同文件写面（不同 key/段），判定为 possible-conflict（未实测共装，不冒充实测态）。全部写入都可由官方 code-review-graph uninstall 完整清理。

AI 工具的“安装”本质是注册：往各客户端的共享配置文件里写入 MCP/hooks 注册段，让客户端启动时能发现并加载这个工具。install 就是执行这些写操作，所以“装完配置被改”不是异常，而是安装的定义本身。

理解这点后有两个确定性推论：一是写面是公开契约——写到哪些文件、哪些段，写在 guide/manifest 里，装之前先看写面清单，就不会被吓到；二是同文件写面 ≠ 冲突——omc/agt 与 crg 写的是同一批文件但不同 key/段，就像两个程序各自写自己的配置项，只有写同一 key 才可能互相覆盖（这才是真冲突）。

判断口径统一：看冲突矩阵里是 possible-conflict 还是实测冲突，不自己猜。回滚路径也因此固定：官方 uninstall 是写操作的逆操作，能完整撤销注册。

一步步来

1. 装前知悉写面 — 必做

install 注册 MCP 是功能不是故障。装之前就知道它会写这些文件，就不慌。

2. 共装策略 — 必做

与 omc/agt 同环境：先装一个跑通再评估下一个。冲突口径见 站内文档（possible-conflict，未实测不冒充实测态）。

3. 清理残留 — 必做

官方 uninstall 后手动确认清单：

ls -la ~/.claude.json ~/.codex/hooks.json ~/.cursor/mcp.json 2>/dev/null && ls -la .code-review-graph/

确认工作区 .code-review-graph/ 与各配置文件中对应段已清掉。

怎么确认修好了

uninstall 后配置文件不再含 code-review-graph 相关段（预期输出形态）：

grep -c code-review-graph ~/.claude.json
→ 0（或不含该段）

各 AI 平台配置中 mcpServers/hooks 恢复原样；其它工具不受影响。

其它环境的表现

症状

执行 code-review-graph install（或 init）后，发现 ~/.claude.json、~/.codex/hooks.json 等配置文件被写入；或与 oh-my-claudecode、agent-governance-toolkit 共装时怀疑互相干扰。

原因

install 子命令会向检测到的 AI 平台注册 MCP/hooks：~/.claude.json（mcpServers）、~/.codex/hooks.json、~/.cursor/mcp.json、~/.config/opencode/plugins/crg-plugin.ts、工作区 .claude/settings.json 与 .mcp.json——这是该工具的正常行为（多注册面重件）。与 omc/agt 存在同文件写面（不同 key/段），判定 possible-conflict（未实测共装）。

解法

1. 装前知悉写面：install 注册 MCP 是功能不是故障；全部可由官方 code-review-graph uninstall 完整清理。
2. 共装策略：与 omc/agt 同环境先装一个跑通再评估；冲突矩阵口径见 站内文档（possible-conflict，未实测不冒充实测态）。
3. 清理残留：官方 uninstall + 手动确认清单（工作区 .code-review-graph/、~/.claude.json mcpServers 段、~/.codex/hooks.json、~/.cursor/mcp.json）。