一句话:把仓库解析成一张”谁调谁”的持久关系图,人查架构、Agent 省 token,一次建图一直用。
GitHub:ix-infrastructure/Ix | ⭐ 约 1k | Fork 79 | Apache 2.0 协议

痛点:每个新仓库都要重新”读”一遍
接手祖传代码的流程永远是:搜、读、搜、再读。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 可视化,架构图直接看。

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 .,再问它三个问题,效果自己判。
