code-review-graph 使用教程
你有没有遇到过这种情况:在 Harness 里问一句「这个认证流程是怎么跑的?」「我改这个类会影响哪里?」或者「帮我 review 一下最近的改动」,它就开始一轮又一轮地搜索、读取、拼上下文。
时间一长,你会发现一个很现实的问题:AI 对代码库的理解,很难持续积累。
本文要讲的,就是如何用 code-review-graph 给本地代码仓库建立一张知识图谱,再通过 MCP 接入 Harness。这样,Harness 不再只会反复读文件,而是能像查地图一样查询代码结构、依赖关系、核心节点和影响范围。
1. 安装
把 code-review-graph 仓库直接发给 Harness,让它自行完成安装。
2. 单个仓库使用
2.1. 初始化 git
# code review graph 使用前必须初始化 git
git init
2.2 构建图谱
在 Codex 等 Harness 中输入:
为这个项目构建 code review graph。
你也可以指定项目内的某些目录来构建。
2.3 验证图谱已接入
在 Harness 中输入:
如果我修改认证模块,会影响哪些调用路径?
如果回复过程中调用了 get_impact_radius_tool、query_graph_tool、semantic_search_nodes 这类 MCP 工具,说明图谱已经正常接入。
也需要在命令行进一步确认:
# 查看图谱统计
code-review-graph status
输出的 Nodes、Edges 等信息不应该为 0。
2.4. 持续监听
在命令行启动监听模式,文件改动时图谱会自动更新:
code-review-graph watch
3. 多个仓库使用
① 日常检查:daemon 活着吗?两个仓库都在监听吗?
code-review-graph daemon status
输出示例(你容器实测):
Alias Status Watcher PID Event Path
gemmini alive ok 151034 2h /workspace/onnxim-gemmini/gemmini
onnxim alive ok 151035 4h /workspace/onnxim-gemmini/onnxim
Event 列 = 距离上次处理变更事件的时间
② 看监听日志(验证是否有增量更新发生)
code-review-graph daemon logs --repo gemmini # 最近 50 行 code-review-graph daemon logs --repo onnxim --lines 100 code-review-graph daemon logs --follow # 实时跟踪(全部)
看到 "FTS index delta: N entries ..." / "re-parsing" 字样 = 增量更新已发生
③ 加一个新仓库监听(自动热生效,无需重启)
code-review-graph daemon add /workspace/onnxim-gemmini/chipyard-env/workspace-chipyard/chipyard --alias chipyard
④ 移除监听(只改配置,不删图谱)
code-review-graph daemon remove chipyard
⑤ 完全停止 / 恢复
code-review-graph daemon stop code-review-graph daemon start
⑥ 调试:前台跑,直接看输出
code-review-graph daemon restart --foreground
评论