Graphify：先问图谱，少 grep 整个仓库
大仓库里让 Claude Code「先 Glob / Grep 扫一遍」很常见，也很容易把上下文洗成噪声。Graphify 一类工具的思路是：先在本地把代码结构建成知识图谱，会话里优先问图（谁调用谁、某条路径怎么走），再决定要不要下钻文件。
中文讨论里同名项目容易混。下面以 Graphify-Labs/graphify 为主（本地 AST / 知识图谱 skill + CLI），并诚实说明和 safishamsi/graphify 等说法撞名——装完先确认你装的是哪一个。
先分清：名字撞车，包名带双 y
| 说法 | 常见指向 | 注意 |
|---|---|---|
| Graphify-Labs/graphify | 本地图谱 skill + CLI，给 Claude Code 查图用 | PyPI 包名是 graphifyy（两个 y），命令行仍是 graphify |
| safishamsi/graphify 等流传写法 | 常见安装口令：pip install graphifyy && graphify install，会话里 /graphify . | 推文常把两套混着抄；以你本机 pip show / 仓库 README 为准 |
结论：看到「Graphify」先核对 GitHub 组织/仓库 和 PyPI 包是否 graphifyy，别凭推文标题下指令。
前置与安装（概念级）
需要：Claude Code + Python 3.10+。
安装包一般用 pip / pipx / uv 装 graphifyy，再执行 graphify install，把 skill / 命令接到 Claude Code。进到目标仓库后，在会话里输入类似：
/graphify .具体旗标以你安装的那份 README 为准；下面只概括常见能力，避免把某一版参数写成「唯一真理」。
会生成什么、能问什么
构建完成后，常见输出目录是 graphify-out/，里面往往有：
graph.html：可浏览的图GRAPH_REPORT.md：给人扫的摘要graph.json：给工具查询的结构化图
交互侧常见能力包括：
- query / path / explain：按问题、调用路径、解释子图
--update：增量更新--watch：盯着仓库变化刷新- hook install：装钩子，让会话在乱 grep 前先想起图谱
代码结构多靠 tree-sitter 解析，不靠 LLM 扫全仓；文档、图片等非代码节点才可能动用模型。这点和「全程让 Agent 自己 grep」成本模型不同。
PreToolUse：在 Glob/Grep 前轻轻推一把
可以装 PreToolUse 类 hook：Claude 准备 Glob / Grep 时，提示先查图谱。这不是禁止搜索，而是把默认路径从「全仓字符串匹配」改成「先结构化再定点打开」。
Skills / hooks 怎么分工，见 Skills 怎么写；权限边界仍建议看 权限与沙箱。
Token：大仓省得明显，小仓别迷信倍数
演示语料里出现过很高的压缩倍数（例如混合语料上的 71.5x 一类数字）。那是特定混合语料的演示，不是你每个私有仓库的保证：
- 大仓 / 陌生仓：少做无效全仓 grep，结构收益和 token 收益都更明显
- 小仓：图谱更多是「看清结构」，压缩感有限，安装与维护成本可能反而不划算
何时值得上：onboarding 大仓、重构前追调用链、反复问「这个符号从哪来」。何时可跳过：玩具项目、单包小库、你已经闭着眼知道目录的时候。
小结
Graphify（Graphify-Labs 一线）把「先建本地 AST 图谱、再问图」接到 Claude Code；包名 graphifyy、CLI graphify，和同名项目容易混，装前核对来源。大仓 onboarding 与路径追踪最受益；小仓别被演示倍数绑架。技能沉淀方式对照 Skills 指南。