代码知识图谱Understand-Anything

XiongNeng 收录于 AI

2026-07-22 约 1300 字预计阅读 3 分钟

Understand-Anything是一个知识图片插件，可将任意代码库、知识库或文档转化为可探索、可搜索、可对话的交互式知识图谱。支持 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等多平台。

GitHub地址：https://github.com/Egonex-AI/Understand-Anything

Install

Claude Code（原生）

1
2
/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything

一行命令安装

1
2
3
4
5
6
# macOS / Linux：
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash
# 也可以直接传入平台名跳过交互提示：
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s codex
# Windows（PowerShell）：
iwr -useb https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.ps1 | iex

分析代码库

1
2
3
4
5
6
/understand

# 生成中文内容（知识图节点描述和 Dashboard UI）
/understand --language zh

# 支持的语言：en（默认）、zh、zh-TW、ja、ko、ru

多智能体（multi-agent）架构会：扫描你的项目，提取函数 / 类 / 依赖，构建知识图谱保存至.ua/knowledge-graph.json。（已经有 .understand-anything/ 目录的项目会继续使用它——存在时它仍是数据目录，因此无需迁移。）

关于 Token 消耗的提醒：首次运行 /understand 会分析整个代码库，在大型项目上可能消耗大量 token。建议在有 token 套餐 / 订阅的情况下运行，或在初始化时使用本地模型（见上文）。后续运行默认是增量式的——只重新分析变更过的文件——因此消耗的 token 大幅减少。

打开数据看板

`1`	`/understand-dashboard`

深度使用

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 询问任意代码库的问题
/understand-chat How does the payment flow work?

# 分析当前修改的影响
/understand-diff

# 深入理解某个文件
/understand-explain src/auth/login.ts

# 为新团队成员生成指南
/understand-onboard

# 提取业务领域知识（领域、流程、步骤）
/understand-domain

# 分析 Karpathy 模式的 LLM Wiki 知识库
/understand-knowledge ~/path/to/wiki

# 直接重跑即可 —— 默认增量更新，只分析变更的文件
/understand

# 安装 post-commit 钩子，每次提交自动增量更新
/understand --auto-update

# 大型 monorepo？把分析范围限定到某个子目录
/understand src/frontend

最佳实践

前面一篇文章[[代码知识图谱codegraph]]我们介绍了codegraph，两者都是知识图谱工具。但是两者定位不一样。

codegraph最适合：

重度使用代码编程Agent工具比如Claude Code / Codex / Cursor等的开发者，在大型项目中显著降低AI的Token成本和响应时间。
需要频繁接收陌生代码的后端/全栈工程师：快速跟踪调用链和依赖关系
预算敏感的团队：完全免费商用，无需任何API密钥或付费订阅。
对隐私要求极高的企业：100%本地运行、零网络调用，代码和数据不出本地。
CI/CD集成：可作为质量门控，检测循环依赖、边界违规等。

Understand-Anything最适合：

新员工入职培训：自动生成定制化代码库导览，将上手时间从数天缩短到数小时。
技术团队负责人 / Tech Lead：向团队成员会非技术人员展示系统架构。
需要理解业务逻辑的开发者：独特的业务领域映射功能，将代码与实际业务流程关联。
遗留系统维护：帮助开发者快速理解旧代码的整体结构和核心逻辑。
团队协作：生成的知识图谱JSON可提交到Git仓库，团队成员共享使用。