GitHubhttps://github.com/Lum1104/Understand-Anything

官网https://understand-anything.com/

演示https://understand-anything.com/demo/

数据⭐ 32,816 Stars · 2,666 Forks · TypeScript

日期2026-05-26 · 调研人：小K ✨

支持平台

智能体管道

编程概念解释

多语言 UI

Understand Anything 调研报告

一、项目概览

Understand Anything 是一个将任意代码库、知识库或文档转换为可交互知识图谱的工具，通过多智能体管道分析项目，构建包含每个文件、函数、类和依赖关系的知识图谱，并提供可探索的可视化仪表板。

"The goal isn't a graph that wows you with how complex your codebase is — it's a graph that quietly teaches you how every piece fits together."

你刚加入一个 20 万行代码的团队。从哪里开始？Understand Anything 分析你的项目，构建知识图谱，给你一个交互式仪表板来可视化探索一切。停止盲目读代码，开始看清全局。

二、入口地址一览

类型	地址
GitHub	https://github.com/Lum1104/Understand-Anything
官网	https://understand-anything.com/
Demo	https://understand-anything.com/demo/
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`

三、支持平台（16 个）

最广泛的 AI Coding 平台支持，覆盖所有主流工具：

平台	状态	安装方式
Claude Code	原生	Plugin marketplace
Cursor	支持	自动发现
VS Code + GitHub Copilot	支持	自动发现
Copilot CLI	支持	`copilot plugin install`
Codex	支持	`install.sh codex`
OpenCode	支持	`install.sh opencode`
OpenClaw	支持	`install.sh openclaw`
Antigravity	支持	`install.sh antigravity`
Gemini CLI	支持	`install.sh gemini`
Pi Agent	支持	`install.sh pi`
Vibe CLI	支持	`install.sh vibe`
Hermes	支持	`install.sh hermes`
Cline	支持	`install.sh cline`
KIMI CLI	支持	`install.sh kimi`
Trae	支持	`install.sh trae`

四、核心功能

🧭 引导游览

自动生成的架构引导游览，按依赖关系排序。以正确的顺序学习代码库。

🔍 模糊和语义搜索

按名称或按含义查找任何内容。搜索"哪些部分处理身份验证？"即可跨图谱获得相关结果。

📊 差异影响分析

在提交前查看更改影响的系统部分。理解代码库中的涟漪效应。

🎭 角色自适应 UI

仪表板根据用户身份调整详细程度——初级开发者、PM 或高级用户。

🏗️ 分层可视化

按架构层自动分组——API、Service、Data、UI、Utility——带有颜色编码图例。

📚 语言概念

12 种编程模式（泛型、闭包、装饰器等）在出现的上下文中解释。

业务逻辑理解

切换到领域视图，查看代码如何映射到真实业务过程——领域、流程和步骤以水平图形式展示。

知识库分析

对准 Karpathy 模式的 LLM wiki，获取带有社区聚类的力导向知识图谱。从 index.md 中提取 wikilinks 和分类，LLM 智能体发现隐式关系、提取实体并呈现声明——将 wiki 转换为可导航的互联思想图谱。

五、命令详解

命令	功能
`/understand`	分析代码库，构建知识图谱
`/understand-dashboard`	打开交互式 Web 仪表板
`/understand-chat <question>`	询问任何关于代码库的问题
`/understand-diff`	分析当前更改的影响
`/understand-explain <file>`	深入了解特定文件或函数
`/understand-onboard`	为新团队成员生成入职指南
`/understand-domain`	提取业务领域知识（领域、流程、步骤）
`/understand-knowledge <path>`	分析 Karpathy 模式的 LLM wiki 知识库
`/understand --auto-update`	每次提交时自动更新（post-commit hook）
`/understand --language zh`	生成中文内容（支持 en/zh/zh-TW/ja/ko/ru）
`/understand src/frontend`	限定范围（适用于大型 monorepo）

六、实现原理

6.1 Tree-sitter + LLM 混合架构

静态分析（deterministic）语义分析（LLM） ↓ ↓ Tree-sitter 解析源码 → LLM 读取解析结构 + 提取结构事实：原始源码 → imports, exports, 生成自然语言摘要、函数/类定义、标签、架构层分配、调用站点、继承业务领域映射、 ↓ ↓ importMap（预解析）引导游览、语言概念标注

为什么这样分工：

Tree-sitter（确定性）：解析结果可复现——相同输入产生相同输出，每次运行都一致。也驱动基于指纹的变化检测用于增量更新。
LLM（语义）：生成 parser 无法生成的内容——文件是"为了什么"，而非只是"导入了什么"。

6.2 多智能体管道

/understand 协调 7 个专门智能体：

智能体	角色
`project-scanner`	发现文件，检测语言和框架
`file-analyzer`	提取函数、类、导入；生成图节点和边
`architecture-analyzer`	识别架构层
`tour-builder`	生成引导学习游览
`graph-reviewer`	验证图完整性和引用完整性
`domain-analyzer`	提取业务领域、流程和步骤（用于 `/understand-domain`）
`article-analyzer`	从 wiki 文章中提取实体、声明和隐式关系（用于 `/understand-knowledge`）

文件分析器并行运行（最多 5 个并发，20-30 个文件/批次）。支持增量更新——只重新分析自上次运行以来已更改的文件。

七、与 CodeGraph 对比

维度	Understand Anything	CodeGraph
Stars	⭐ 32,816	⭐ 26,134
语言	TypeScript	TypeScript
核心定位	知识图谱 + 交互仪表板 + 多智能体	本地知识图谱 + MCP Server
交互界面	独立 Web Dashboard	纯命令行/MCP 工具
业务理解	`/understand-domain` 业务领域分析	无
Wiki 支持	Karpathy LLM wiki 分析	无
Diff 影响分析	`/understand-diff`	`codegraph_impact`
平台数量	16 个平台	5 个代理
增量更新	指纹变化检测	文件监听
Benchmark	无公开数据	详细 7 代码库数据
目标用户	新人 onboarding / 团队共享	AI 代理上下文增强

八、快速上手

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

使用

# 分析代码库
/understand

# 打开交互式仪表板
/understand-dashboard

# 询问任何问题
/understand-chat How does the payment flow work?

# 分析更改影响
/understand-diff

九、团队共享

图谱是 JSON 文件——提交一次，队友跳过管道。适合 onboarding、PR review 和 docs-as-code。

# .gitignore 中排除本地临时文件
.understand-anything/intermediate/
.understand-anything/diff-overlay.json

# 大图谱（10 MB+）使用 git-lfs
git lfs install
git lfs track ".understand-anything/*.json"

十、核心亮点

亮点	说明
最广泛平台支持	16 个 AI Coding 平台，Claude Code 原生支持
交互式 Dashboard	可视化知识图谱，可点击、搜索、漫游
多智能体管道	7 个专门智能体分工协作
业务领域分析	`/understand-domain` 提取业务领域、流程和步骤
LLM Wiki 支持	`/understand-knowledge` 分析 Karpathy 模式 wiki
增量分析	指纹变化检测，只重新分析已更改的文件
团队共享	图谱 JSON 可提交到 git，队友直接使用
多语言 UI	支持 6 种语言（en/zh/zh-TW/ja/ko/ru）生成内容