Understand-Anything:把整个代码库变成一张能点的知识图谱
一句话说清:这是一套 9 个技能组成的代码理解工具:把整个代码库分析成交互式知识图谱,每个文件、函数、类都是一个能点击的节点,可以搜索、可以问答、有按依赖排序的架构导览。79k star 的爆款项目。
场景:刚入职,面对 20 万行代码,从哪开始看
这是每个开发者都经历过的绝望:项目很大,文档很少,不知道哪个文件是入口,不知道支付流程串了哪些模块,前辈离职前只留下一句「代码里都有」。
这个技能包用多 Agent 流水线把项目分析成一张知识图谱,先看全景,再点进细节——而不是从第一个文件开始盲读。
用它能做到什么
全量分析。扫描整个项目,提取每个文件、函数、类、依赖关系,生成知识图谱(保存为 .ua/knowledge-graph.json)。支持增量更新,只重新分析改动过的文件。
可视化面板。交互式网页仪表盘:按架构分层着色(API、Service、Data、UI),点击任意节点看代码、关系和通俗解释,支持语义搜索——搜「哪些部分处理登录」能返回相关结果。
直接问答。不用翻代码,直接问「支付流程是怎么走的?」,它从图谱里回答。
改动影响分析。提交前先看你的改动会影响系统的哪些部分,提前发现涟漪效应。
新成员引导。自动生成按依赖排序的架构导览,新人按正确顺序学代码。
业务域提取。从代码反推业务领域、流程和步骤,把技术代码映射回业务逻辑。
知识库图谱。把 Karpathy 风格的 LLM wiki 变成带社区聚类的力导向图谱,挖掘隐性关系和观点。
它为什么值得用
1. 确定性解析 + 语义理解混合
Tree-sitter 做确定性结构解析(导入、函数、类、调用点),LLM 补语义(文件是干什么的、属于哪一层)。结构永远可复现,语义捕获意图——两者各干各擅长的。
2. 图谱是 JSON,能提交进仓库
分析一次,提交图谱,全团队跳过流水线。新成员 onboarding、PR 评审、文档即代码都直接看图谱。支持提交后自动更新,每次 commit 图谱同步。
3. 支持中文输出
用 --language zh 生成中文节点描述和中文界面。
适合谁
- 刚接手大项目、不知道从哪看起的新人
- 带团队、要给新人做 onboarding 的技术负责人
- 改代码前想先确认影响范围的人
- 想把知识库/文档变成可探索图谱的人
如果你不写代码:这个技能主要面向代码库理解。纯技能文档(9 个 SKILL.md)解压放进技能目录即可指导 AI 做结构化代码理解;完整的自动化流水线和可视化面板需要 Node.js 环境,适合在有开发环境的机器上跑。
技能包下载
understand-anything.zip (180 KB,9 个技能)
安装方法:解压后把 understand-anything 文件夹放进积木的技能目录(~/.jimu/skills/),重启积木就能用。之后对积木说「分析一下这个项目的架构」或「这个项目支付流程是怎么走的」。