编辑文档 - 别再盲读代码了！Understand Anything 把项目变成可搜索的知识图谱，一键看懂全局架构

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

接手一个 20 万行的老项目，或者刚加入新团队面对完全不熟的代码库——你从哪开始看？逐个文件点开，边猜边记依赖关系？

Understand Anything 做的事很简单：**把你的代码库变成一张能点击、能搜索、能对话的知识地图**。

### 做什么的

Understand Anything 是一个 Claude Code 插件（也支持 OpenCode、 Cursor、Copilot、Codex 等 8 大平台），用多 Agent 架构自动分析项目，生成一张可交互的知识图谱：

- 文件、函数、类、依赖关系全部变成可视化节点
- 点任意节点，直接看代码摘要、依赖关系和通俗解释
- 支持语义搜索，比如搜“哪些部分处理身份验证”直接定位

**一句话：AI 帮你从全局视角看懂系统，不再逐文件硬啃。**

支持平台：

| 平台 | 状态 |
|------|------|
| Claude Code | ✅ 原生插件 |
| Cursor / VS Code + GitHub Copilot | ✅ 自动发现 |
| Codex / OpenCode / Gemini CLI / Hermes | ✅ 一行脚本安装 |
| Copilot CLI / Pi Agent / Cline / KIMI CLI | ✅ 一行脚本安装 |

### 三步跑通

**第一步：安装插件**

Claude Code 用户：

```bash
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
```

其他平台一行命令搞定：

```bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash

# Windows
iwr -useb https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.ps1 | iex
```

安装完重启 CLI 或 IDE 即可。

**第二步：分析代码库**

```bash
/understand
```

多 Agent 自动扫描项目 → 提取函数/类/依赖 → 构建知识图谱，保存至 `.understand-anything/knowledge-graph.json`。需要中文内容加上 `--language zh`。

**第三步：打开 Dashboard**

```bash
/understand-dashboard
```

浏览器打开交互式页面——图谱按架构层级颜色编码，任意节点点进去就能看代码、依赖关系和学习路径。

### 核心功能：能解决什么

| 功能 | 解决什么问题 |
|------|-------------|
| 交互式知识图谱 | “这个项目到底有哪些模块？它们怎么关联？” |
| 引导式学习路径 | “我是新人，从哪个文件开始看？” |
| 语义搜索 | “认证逻辑在哪？不用 grep 猜关键词” |
| 变更影响分析 | “改这个文件，会不会把支付流程搞崩？” |
| 业务领域视图 | “代码怎么对应到实际业务流程？” |
| 编程概念解释 | “这段用了装饰器模式，什么意思？” |
| 角色自适应 UI | 初级开发看到通俗解释，架构师看到层级关系 |

### 适合你吗？

| 场景 | 推荐度 |
|------|--------|
| 接手老项目，快速摸清全局 | ⭐⭐⭐⭐⭐ 强烈推荐 |
| 新人 onboarding | ⭐⭐⭐⭐⭐ 把图谱 JSON 提交仓库，团队共享 |
| 大型 PR 前评估影响范围 | ⭐⭐⭐⭐ 用 `/understand-diff` 提前看连锁反应 |
| 多语言 monorepo | ⭐⭐⭐ 支持，首次分析较慢，建议限定子目录 |
| 小型个人项目（< 50 文件） | ⭐⭐ 边际收益不高 |

### 技术原理

核心思路：**确定性的事交给静态分析，语义理解交给 LLM**。

- **Tree-sitter**：解析语法树，提取导入导出、函数/类定义、调用关系——同样的输入永远给同样的输出，作为增量更新的指纹基础
- **LLM**：读取解析后的结构，生成摘要、标签、架构层级、业务领域映射——回答“这个文件为什么存在”

多 Agent 各司其职：`project-scanner` 扫描项目 → `file-analyzer` 提取结构 → `architecture-analyzer` 识别层级 → `tour-builder` 生成学习路径 → `graph-reviewer` 验证完整性。文件分析器并行运行（最多 3 并发），支持增量更新，只分析变更文件。

### 团队共享

图谱就是一个 JSON 文件，提交到仓库后团队成员直接跳过分析步骤：

```bash
# 需要提交的
.understand-anything/
# 需要忽略的
.understand-anything/intermediate/
.understand-anything/diff-overlay.json
```

大图谱（10 MB 以上）用 git-lfs 跟踪。装 post-commit 钩子后每次提交自动增量更新：

```bash
/understand --auto-update
```

### 常见坑

1. **Dashboard 空白**——先跑 `/understand` 生成图谱，再跑 `/understand-dashboard`
2. **增量更新没生效**——升级到最新版，或删掉 `.understand-anything/` 全量重建
3. **monorepo 分析太慢**——限定范围：`/understand src/frontend`

### 写在最后

Understand Anything 解决的是一个很实际的问题：代码是写给人看的，但中大型项目靠人肉读太慢了。把代码库变成一张可导航的地图，AI 不再盲扫文件，而是带你直接找到入口、按图索骥。

**你接手过完全陌生的老项目吗？当时怎么上手的？评论区聊聊。**

摘要

标签多个标签用逗号分隔

分类