# 代码知识图谱Understand-Anything

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

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

## Install

### Claude Code（原生）
```
/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything
```

### 一行命令安装
```
# 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
```

## 分析代码库
```
/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 大幅减少。

## 打开数据看板
```
/understand-dashboard
```

## 深度使用

```
# 询问任意代码库的问题
/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仓库，团队成员共享使用。


---

> 作者: XiongNeng  
> URL: https://xiongneng.me/posts/ai/understand-anything/