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

接手一个 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 用户：

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

其他平台一行命令搞定：

# 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 即可。

第二步：分析代码库

/understand

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

第三步：打开 Dashboard

/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 文件，提交到仓库后团队成员直接跳过分析步骤：

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

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

/understand --auto-update

常见坑

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

写在最后

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

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

📄 文档管理系统