ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

如何用 code-review-graph 做知识缺口分析:快速定位未测试热点与结构性弱点

如何用 code-review-graph 做知识缺口分析:快速定位未测试热点与结构性弱点 如何用 code-review-graph 做知识缺口分析快速定位未测试热点与结构性弱点【免费下载链接】code-review-graphLocal-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.项目地址: https://gitcode.com/GitHub_Trending/co/code-review-graph对于大型代码库code-review-graph是一款本地优先的代码智能图谱工具它把你的代码库解析成持久化的结构地图让 AI 编程助手只读真正相关的部分。除节省 token 外它还能做知识缺口分析knowledge gap analysis——自动扫描出未测试热点、孤立节点、薄弱模块等结构性弱点帮你把测试和重构精力花在刀刃上。本文面向新手完整介绍这套分析能力如何工作、如何上手。什么是知识缺口分析传统方式下想知道哪些核心函数没被测试你只能人肉翻代码或用脚本 grep 一遍大型仓库基本做不到。code-review-graph 用Tree-sitter把仓库解析成图谱节点是函数、类、导入边是调用、继承、测试覆盖关系TESTED_BY存进本地 SQLite无遥测、不上传代码。在这个图谱上知识缺口分析通过四个维度找出看不见的风险缺口类别判定规则实际含义 未测试热点连接度 ≥ 5 且无任何 TESTED_BY 边核心函数改动波及面大却没有测试兜底️ 孤立节点连接度 ≤ 1疑似死代码或新加入尚未集成的代码 薄弱社区成员数 3 的聚类职责模糊、边界不清的碎片模块 单文件社区整个社区挤在一个文件里上帝文件拆分重构的候选核心实现见 code_review_graph/analysis.py 中的find_knowledge_gaps函数同一模块还提供枢纽节点hub、桥接节点betweenness 中心性即架构瓶颈点和意外耦合检测。三步上手安装、建图、查看结果整个过程只有三条命令且全程本地运行pip install code-review-graph # 安装 code-review-graph install # 自动检测并配置你的 AI 工具 code-review-graph build # 解析代码库约 500 文件仅需 10 秒install会自动识别 Codex、Claude Code、Cursor、Windsurf、GitHub Copilot 等 14 个平台并写好 MCP 配置build完成后图谱保存在项目根目录的.code-review-graph/graph.db自动加入 gitignore。建图后你可以直接在 AI 助手里提问分析这个项目的知识缺口或由 CI 自动执行。完整的命令清单见 docs/COMMANDS.md用户指南见 docs/USAGE.md。日常怎么用把缺口接进每天的评审流程知识缺口分析真正的价值是嵌入你每天都在做的 Code Review变更风险检测detect-changes把 git diff 映射到受影响的函数、执行流和社区并列出测试覆盖缺口test gaps——即哪些被改动的函数没有测试保护。带--brief参数还会打印一个 Token Savings 面板展示本次评审节省了多少上下文。评审自动提醒评审工具在生成指导时会检查变更函数的测试边直接输出N 个被修改的函数缺少测试覆盖的提示若影响面超过 20 个节点还会提醒爆炸半径过大请仔细检查调用方。相关逻辑见 code_review_graph/tools/review.py。增量更新开启 watch 模式或 git hooks 后每次保存/提交自动增量更新图谱3000 文件的项目两文件编辑约 2.5 秒完成重建缺口数据永远是最新的。也就是说未测试热点不是季度审计才看一次的事而是每次提交都会被持续追踪。进阶玩法看图谱、找瓶颈、生成问题清单建图后还有几个新手友好的进阶动作可视化图谱运行code-review-graph visualize会生成交互式 D3.js 网页.code-review-graph/graph.html。默认只展示文件节点点击展开内部结构可以切换边类型调用/继承/测试的显示——肉眼看哪里一团乱麻、哪里孤立无援一目了然。找架构瓶颈桥接节点分析betweenness centrality能找出坐在最多最短路径上的节点它们一坏多个模块就失去连通性是重构和加固的第一优先目标。自动生成的评审问题清单generate_suggested_questions会基于图谱分析自动生成这次评审该问什么的问题列表配合 skills/review-changes/ 等内置技能使用。CI 合并门禁内置的 GitHub Action 会在每个 PR 上贴出带风险分数的函数表、受影响执行流和测试缺口可选fail-on-risk把高风险评审直接变成合并门禁。配置参考 docs/GITHUB_ACTION.md。什么时候该关注这些缺口接手陌生项目先看未测试热点 薄弱社区10 分钟内建立哪里最危险的地图。重构前用桥接节点和单文件社区定位拆分/加固优先级再配合rename预览等重构工具。测试补强规划未测试热点按连接度降序排列就是现成的测试优先级排序。CI 常态化风险评分评审 合并门禁把结构性弱点拦截在合并之前。常见问题Q会上传我的代码吗A不会。核心工作流完全本地优先图谱存在本地 SQLite无需网络可选的嵌入功能需显式启用才会调用配置的服务。Q支持哪些语言APython、JS/TS、Go、Rust、Java、C/C、C#、Ruby、Kotlin、Swift、PHP、Scala、SQL、Terraform、Jupyter Notebook 等 30 语言与领域文件还不支持的语言无需 fork一个languages.toml即可扩展见 docs/CUSTOM_LANGUAGES.md。Q小项目有必要用吗A500 文件以下建图只要约 10 秒小项目同样能拿到测试缺口和瓶颈分析而且增量更新几乎无感。code-review-graph 把哪里没测试、哪里是结构弱点从经验判断变成了可查询的图谱数据。装好、建图、问一句分析这个项目的知识缺口你就能得到一份按风险排序的代码体检报告——这正是 AI 时代 Code Review 该有的样子。【免费下载链接】code-review-graphLocal-first code intelligence graph for MCP and CLI. Builds a persistent map of your codebase so AI coding tools read only what matters, with benchmarked context reductions on reviews and large-repo workflows.项目地址: https://gitcode.com/GitHub_Trending/co/code-review-graph创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进