理解万物

把任意代码库/文档解析成可交互知识图谱，配可视化看板供探索问答

类型技能 74,303 星标更新 2026-07-15 许可 MIT 原仓库主页

Understand Anything

将任何代码库、知识库或文档转换为交互式知识图谱，供你探索、搜索和提问。
适用于 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等工具。

理解万物。理解每个人。
AI 应该帮助人，而不是取代人。

Understand Anything — 将任何代码库转换为交互式知识图谱

来自 Egonex 的开源项目
最初由 Lum1104 创建。

你刚加入一个新团队。代码库有 20 万行代码。你该从哪里开始？

Understand Anything 是一个 Claude Code 插件，它通过多智能体流水线分析你的项目，构建包含每个文件、函数、类和依赖的知识图谱，然后提供一个交互式仪表盘，让你直观地探索这一切。别再盲读代码了。开始看清全局。

目标不是用图来炫耀你的代码库有多复杂——而是用图默默教会你每个部分是如何组合在一起的。

✨ 特性

[!NOTE] 想跳过阅读？ 试试我们主页上的在线演示——一个完全交互式的仪表盘，你可以在浏览器中平移、缩放、搜索和探索。

探索结构图

将你的代码库作为交互式知识图谱进行导航——每个文件、函数和类都是一个节点，你可以点击、搜索和探索。选择任意节点，即可查看通俗易懂的摘要、关系和引导式导览。

理解业务逻辑

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

分析知识库

将 /understand-knowledge 指向一个 Karpathy 模式的 LLM wiki，即可得到一个带有社区聚类的力导向知识图谱。确定性解析器从 index.md 中提取 wiki 链接和分类，然后 LLM 智能体发现隐式关系、提取实体并揭示主张——将你的 wiki 转换为一个可导航的互联思想图谱。

🧭 引导式导览

按依赖顺序自动生成的架构漫游。按正确顺序学习代码库。

🔍 模糊与语义搜索

按名称或含义搜索任何内容。搜索“哪些部分处理认证？”即可在图谱中得到相关结果。

📊 差异影响分析

在提交前查看你的修改会影响系统的哪些部分。了解代码库中的连锁反应。

🎭 角色自适应 UI

仪表盘会根据你的身份调整细节级别——初级开发者、项目经理或高级用户。

🏗️ 分层可视化

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

📚 语言概念

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

🚀 快速开始

1. 安装插件

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

使用本地模型？ 为了隐私或企业部署，请将你的平台指向本地模型提供者，例如 Ollama —— 按照他们的集成指南更改模型提供者。

2. 分析你的代码库

/understand

一个多智能体流水线扫描你的项目，提取每个文件、函数、类和依赖，然后构建知识图谱并保存到 .ua/knowledge-graph.json。（已经存在 .understand-anything/ 目录的项目会继续使用它——它仍然是数据目录，因此无需迁移。）

Token 使用提醒： 初始的 /understand 会分析整个代码库，在大型项目上可能消耗大量 token。我们建议使用 token 套餐/订阅，或使用本地模型（见上文）进行初始化。后续运行默认是增量的——只重新分析已更改的文件——因此会少用很多 token。

本地化输出： 使用 --language 以你偏好的语言生成内容：

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

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

在项目的首次运行时——如果你未传递 --language 且尚未存储语言——/understand 会检测你正在使用的对话语言。如果该语言不是英语，它会在生成前请求你确认（或覆盖）；英语对话则不受影响。你的选择将保存到 .ua/config.json 中，并在后续每次运行时复用。

--language 参数影响以下内容：

知识图中节点的摘要和描述
Dashboard UI 的标签、按钮和工具提示
引导式导览说明

3. 探索 Dashboard

/understand-dashboard

一个交互式 Web 仪表板将以图形方式打开你的代码库——按架构层进行颜色编码、可搜索且可点击。选择任意节点可查看其代码、关系以及通俗易懂的解释。

4. 持续学习

# 询问关于代码库的任何问题
/understand-chat 支付流程是如何工作的？

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

# 深入了解特定文件或函数
/understand-explain src/auth/login.ts

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

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

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

# 随时重新运行——默认增量执行（仅重新分析已更改的文件）
/understand

# 通过 post-commit hook 在每次提交时自动更新
/understand --auto-update

# 限定到子目录（适用于大型 monorepo）
/understand src/frontend

🌐 多平台安装

Understand-Anything 可在多个 AI 编码平台上使用。

Claude Code（原生）

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

一行安装（Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI / Trae / Nanobot / Kiro）

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-anything/repo 并为所选平台创建正确的符号链接。之后请重启你的 CLI/IDE。

关于技能调用的备注： 不同平台的调用前缀不同。大多数平台使用斜杠命令（/understand），但 Codex 使用 $ 代替——请键入 $understand，而不是 /understand。如果你的平台上两种前缀均无效，只需用自然语言提出请求：“使用 understand 技能分析此项目。”

支持的 <platform> 值：gemini、codex、opencode、pi、openclaw、antigravity、vibe、vscode、hermes、cline、kimi、trae、nanobot、kiro
后续更新：./install.sh --update
卸载：./install.sh --uninstall <platform>

Cursor

克隆此仓库后，Cursor 会通过 .cursor-plugin/plugin.json 自动发现插件。无需手动安装——只需克隆并在 Cursor 中打开即可。

如果自动发现未生效，可以手动安装：打开 Cursor 设置 → 插件，在搜索框中粘贴 https://github.com/Egonex-AI/Understand-Anything，然后从该处添加。

VS Code + GitHub Copilot

克隆此仓库后，带有 GitHub Copilot (v1.108+) 的 VS Code 会通过 .copilot-plugin/plugin.json 自动发现插件。无需手动安装——只需克隆并在 VS Code 中打开即可。

若要获得适用于所有项目的个人技能，请使用 vscode 平台运行上述 install.sh。

Copilot CLI

copilot plugin install Egonex-AI/Understand-Anything:understand-anything-plugin

Kiro CLI / IDE

curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash -s kiro

安装后：

Kiro CLI： kiro-cli chat --agent understand "Analyze this project"
Kiro IDE： 技能将符号链接到 ~/.kiro/skills/ 中，understand 代理写入 ~/.kiro/agents/understand.json，因此重启 IDE 后两者均可用。

若要获得适用于所有项目的个人技能，请使用 kiro 平台运行上述 install.sh。

平台兼容性

平台	状态	安装方法
Claude Code	✅ 原生	插件市场
Cursor	✅ 支持	自动发现
VS Code + GitHub Copilot	✅ 支持	自动发现
Copilot CLI	✅ 支持	插件安装
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`
Nanobot	✅ 支持	`install.sh nanobot`
Kiro CLI / IDE	✅ 支持	`install.sh kiro`

📦 与团队共享图形

图形只是 JSON——提交一次，队友即可跳过流水线。适用于入职引导、PR 审查以及将文档视为代码的场景。

示例： GoogleCloudPlatform/microservices-demo —— 一个提交了图形的 Go/Java/Python/Node 参考项目。

需要提交的内容： .ua/ 中除 intermediate/ 和 diff-overlay.json 之外的所有内容（这些是本地临时文件）。（旧项目使用 .understand-anything/ —— 如果存在该目录，请将下方目录名称替换为它。）

.ua/intermediate/
.ua/diff-overlay.json

保持更新： 启用 /understand --auto-update —— post-commit hook 会增量式修补图形，使每次提交都附带匹配的图形。或者也可以在发布前手动重新运行 /understand。

大型图形（10 MB 以上）： 使用 git-lfs 追踪。

git lfs install
git lfs track ".ua/*.json"
git add .gitattributes .ua/

无需 Claude Code 即可查看 Dashboard

一旦生成并提交了图形，团队中的任何人都可以一条命令打开它——无需 Claude Code、无需 LLM、无需 API 密钥。仅需 Node.js（>= 18）：

npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /path/to/analyzed/project

终端会打印一个带有 token 的 URL（http://127.0.0.1:5173/?token=…），并在浏览器中打开完整的交互式仪表板。项目目录（默认：当前目录）必须包含已提交的数据目录（.ua/ 或旧版的 .understand-anything/）。所有内容均从本地磁盘只读提供——无 LLM 调用，无数据离开你的机器。

Working from a clone instead? pnpm install && pnpm --filter @understand-anything/core build, then GRAPH_DIR=/path/to/analyzed/project pnpm dev:dashboard does the same via the Vite dev server.

🔧 内部机制

Tree-sitter + LLM 混合架构

静态分析与大语言模型各司其职：

Tree-sitter（确定性分析） — 将源码解析为具体语法树，提取结构化信息：导入、导出、函数/类定义、调用点、继承关系。在扫描阶段预解析为 importMap 并传递给文件分析器，避免它们从源码重新推导导入关系。相同输入 → 相同输出，每次运行结果一致。同时支持基于指纹的变更检测，用于增量更新。
LLM（语义分析） — 读取解析后的结构及原始源码，生成解析器无法产出的内容：简明英文摘要、标签、架构层级分配、业务域映射、导览讲解、语言概念说明。

这种拆分确保了图谱在结构层面可复现（相同代码始终生成相同边），同时在语义层面捕捉意图（文件“用途”而非仅仅“导入什么”）。

多智能体流水线

/understand 命令协调 5 个专用智能体，/understand-domain 额外增加一个：

智能体	职责
`project-scanner`	发现文件，检测语言和框架
`file-analyzer`	提取函数、类、导入关系；生成图节点和边
`architecture-analyzer`	识别架构层级
`tour-builder`	生成引导式学习导览
`graph-reviewer`	验证图的完整性和引用完整性（默认内联运行；使用 `--review` 可启用完整 LLM 审查）
`domain-analyzer`	提取业务域、流程及步骤（由 `/understand-domain` 使用）
`article-analyzer`	从 Wiki 文章中提取实体、声明和隐含关系（由 `/understand-knowledge` 使用）