接手祖传代码别再 grep 了:这个工具把整个仓库画成一张图

接手祖传代码别再 grep 了:这个工具把整个仓库画成一张图

一句话:把仓库解析成一张”谁调谁”的持久关系图,人查架构、Agent 省 token,一次建图一直用。

GitHub:ix-infrastructure/Ix | ⭐ 约 1k | Fork 79 | Apache 2.0 协议

代码关系图谱概念图(AI 配图)
代码关系图谱概念图(AI 配图)

痛点:每个新仓库都要重新”读”一遍

接手祖传代码的流程永远是:搜、读、搜、再读。AI 编程时代更贵——Agent 每开一会话就把架构重推一遍,整个文件往提示词里塞,token 烧着玩,下次打开又失忆。

Ix 换了个思路:仓库只解析一次,沉淀成一张图,之后人查、Agent 查都查这张图。

它怎么做:Map → Structure → Retrieve → Remember

  • Map:ix map .,tree-sitter 抠出符号、调用、import(27 门语言,C++ 连 CUDA 核函数调用都认);
  • Structure:变成”谁包含谁、谁调用谁、谁 import 谁”的节点边图,存本地 ArangoDB + 记忆层,Docker 跑;
  • Retrieve:查一个符号只返回它和直接关系,不整文件灌你;
  • Remember:图持久化,关掉重开还在,Agent 跨会话不断片。

官方演示:建图 + 查仓库(点击看动图)

ix map 建图、命令行查关系(仓库官方动图,流量注意)。

几个杀手级命令

ix explain AuthService   # 这是啥,它碰了谁
ix trace user_login_flow # 这条流程到底怎么走的
ix impact verify_token   # 改它会炸谁(爆炸半径)
ix callers foo / ix callees foo  # 谁调它 / 它调谁
ix depends foo           # 依赖树一次拉全
ix rank --by dependents  # 找出最不能动的"承重代码"

还有 ix view 开 Compass 可视化,架构图直接看。

架构:CLI / MCP / 可视化共读一张本地图(仓库官方图,热链原图保证清晰)

Agent 接入:MCP 一行,opencode 也在列

ix mcp install   # 自动检测本机客户端并注册

Claude Code、Codex、Cursor、VS Code、Gemini CLI、OpenClaw、opencode 全支持,还有各家原生插件。按官方内部实测,查图代替灌文件,token 省 30%–99.7%(跨度大是因为任务和仓库大小差得多,原话是内部测量非公开基准——省是真省,省多少看命)。

安装

curl -fsSL https://ix-infra.com/install.sh | sh   # macOS / Linux

要 Node 22+、Git、ripgrep,后端走 Docker。装完:ix map . 建图,ix mcp install 接 Agent,开干。Windows 用 PowerShell 版脚本。

边界(诚实项)

  • 才 1k Star 的年轻项目,生态和文档都在长身体;
  • 后端(ArangoDB + 记忆层)是官方 Docker 镜像,不是从这个仓库构建的,重度定制前先看清边界;
  • 图的质量取决于解析,超大 monorepo 建图要耐心;
  • 省 token 那组数字是官方自测,别当 Benchmark 引用。

结语

AI 写代码的瓶颈早就不在”写”,在”读懂”。Ix 赌的是:读懂这件事,应该沉淀成资产,而不是每次现算。1k Star 早期项目,适合爱折腾的人先上车。

仓库:github.com/ix-infrastructure/Ix(Apache 2.0)。先拿一个你最头疼的祖传仓库 ix map .,再问它三个问题,效果自己判。

Comments

No comments yet. Why don’t you start the discussion?

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注