Understand Anything：把代码库变成可交互知识图谱

Fen9Pi2026/6/9大约 10 分钟

Understand Anything

你刚加入一个新团队。
代码库有 200,000 行代码。
你从哪里开始？
Understand Anything 是一个 Claude Code 插件。
它用多 Agent 流水线分析你的项目。
构建每个文件、函数、类和依赖的知识图谱。
然后给你一个交互式仪表板。
停止盲目阅读代码。
开始看到大局。

核心愿景

目标不是一个让你惊叹代码库有多复杂的图谱。

而是一个安静地教你每个部分如何组合在一起的图谱。

核心价值：

将任何代码库转换为交互式知识图谱
可视化探索、搜索和提问
支持 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等

六大核心功能

1. 交互式知识图谱

将代码库导航为交互式知识图谱。

特性：

每个文件、函数和类都是一个节点
可以点击、搜索和探索
选择任何节点查看纯英语摘要
查看关系和引导式导览

价值：

可视化理解
快速导航
上下文清晰

2. 领域视图

切换到领域视图。

看到你的代码如何映射到实际业务流程。

特性：

领域、流程和步骤布局为水平图谱
业务流程可视化
跨文件流程追踪
逻辑关系清晰

价值：

业务对齐
流程理解
跨模块追踪

3. Wiki 知识图谱

指向 Karpathy 模式 LLM wiki。

获得力导向知识图谱和社区聚类。

特性：

确定性解析器从 index.md 提取 wikilinks 和类别
LLM agents 发现隐式关系
提取实体
发现主张
将 wiki 转换为互连思想的可导航图谱

价值：

知识可视化
关系发现
思想导航

4. 自动生成导览

自动生成架构导览。

特性：

按依赖排序
以正确的顺序学习代码库
结构化路径
循序渐进

价值：

快速上手
系统学习
避免迷失

5. 智能搜索

按名称或按含义查找任何内容。

特性：

搜索「哪些部分处理身份验证？」
获得跨图谱的相关结果
语义搜索
精确匹配

价值：

快速定位
语义理解
全面覆盖

6. 影响分析

在提交之前看到你的更改影响系统的哪些部分。

特性：

理解跨代码库的涟漪效应
依赖追踪
影响范围可视化
风险评估

价值：

风险预判
安全修改
减少回归

核心命令

1. /understand

多 Agent 流水线扫描项目。

功能：

提取每个文件、函数、类和依赖
构建知识图谱
保存到 .understand-anything/knowledge-graph.json

选项：

# 生成中文内容
/understand --language zh

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

增量更新：

# 默认增量（仅重新分析更改的文件）
/understand

# 强制完全重新分析
/understand --force

2. /understand-dashboard

打开交互式 Web 仪表板。

功能：

代码库可视化图谱
按架构层颜色编码
可搜索和点击
选择节点查看代码、关系和纯英语解释

特性：

交互式探索
详细信息
美观界面

3. /understand-chat

询问代码库的任何问题。

示例：

/understand-chat How does the payment flow work?
/understand-chat 支付流程是如何工作的？

功能：

基于知识图谱回答
上下文准确
详细解释

4. /understand-diff

分析当前更改的影响。

功能：

查看更改影响
涟漪效应分析
风险评估

5. /understand-explain

深入特定文件或函数。

示例：

/understand-explain src/auth/login.ts

功能：

详细解释
依赖关系
代码上下文

6. /understand-onboard

为新团队成员生成入门指南。

功能：

自动生成入门文档
项目结构说明
关键流程导览

7. /understand-domain

提取业务领域知识。

功能：

提取领域、流程和步骤
业务流程映射
领域视图生成

8. /understand-knowledge

分析 Karpathy 模式 LLM wiki 知识库。

示例：

/understand-knowledge ~/path/to/wiki

功能：

Wiki 知识图谱
实体提取
关系发现

9. /understand --auto-update

每次提交通过 post-commit hook 自动更新。

功能：

自动增量更新
保持图谱最新
无需手动维护

安装方式

Claude Code

原生支持，通过插件市场安装：

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

Codex / OpenCode / OpenClaw 等

macOS / Linux：

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

# 或跳过提示直接指定平台：
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex

Windows (PowerShell)：

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

支持的平台：

gemini
codex
opencode
openclaw
antigravity
vibe
vscode
hermes
cline
kimi
trae

更新：

./install.sh --update

卸载：

./install.sh --uninstall

Cursor

自动发现插件。

克隆此 repo 后，Cursor 通过 .cursor-plugin/plugin.json 自动发现插件。

无需手动安装 —— 只需克隆并在 Cursor 中打开。

如果自动发现未生效：

打开 Cursor Settings → Plugins
粘贴 https://github.com/Lum1104/Understand-Anything 到搜索字段
从那里添加

VS Code + GitHub Copilot (v1.108+)

自动发现插件。

克隆此 repo 后，VS Code 通过 .copilot-plugin/plugin.json 自动发现插件。

对于个人技能（跨所有项目可用）：

# 运行安装脚本并选择 vscode 平台
curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash

手动安装：

copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin

平台支持矩阵

平台	状态	安装方式
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

团队协作

提交流程

图谱只是 JSON —— 提交一次，队友跳过流水线。

适合：

入门培训
PR 审查
Docs-as-code

示例： GoogleCloudPlatform/microservices-demo (fork) — Go / Java / Python / Node 参考，带有已提交的图谱

提交内容

提交 .understand-anything/ 中的所有内容，除了：

intermediate/
diff-overlay.json（这些是本地临时文件）

保持更新

启用 /understand --auto-update — post-commit hook 增量修补图谱。

这样每次提交都有匹配的图谱。

或在发布前手动重新运行 /understand。

大型图谱

大型图谱（10 MB+）：使用 git-lfs 跟踪。

git lfs install"
git lfs track ".understand-anything/*.json"
git add .gitattributes .understand-anything/

技术架构

静态分析 + LLM

静态分析和 LLM 各司其职：

Tree-sitter（确定性）：

将源代码解析为具体语法树
提取结构事实：imports、exports、function/class 定义、调用点、继承
在扫描阶段预解析为 importMap
传递给 file-analyzers，避免重新推导 imports
相同输入 → 相同输出，每次运行
基于指纹的变更检测，用于增量更新

LLM（语义）：

读取解析的结构和原始源代码
产生解析器无法产生的：
- 纯英语摘要
- 标签
- 架构层分配
- 业务域映射
- 引导导览
- 语言概念标注

为什么这样设计？

这种分离使得图谱在结构方面可重现（相同代码总是产生相同边）。

同时在语义方面捕获意图（文件的用途，而不仅仅是它导入什么）。

多 Agent 架构

/understand 命令协调 5 个专门 agents，/understand-domain 添加第 6 个：

Agent	角色
project-scanner	发现文件，检测语言和框架
file-analyzer	提取函数、类、imports；产生图谱节点和边
architecture-analyzer	识别架构层
tour-builder	生成引导学习导览
graph-reviewer	验证图谱完整性和引用完整性（默认内联运行；使用 `--review` 进行完整 LLM 审查）
domain-analyzer	提取业务域、流程和过程步骤（由 `/understand-domain` 使用）
article-analyzer	从 wiki 文章中提取实体、主张和隐式关系（由 `/understand-knowledge` 使用）

并行处理：

文件分析器并行运行（最多 5 个并发，每批 20-30 个文件）。

支持增量更新 —— 仅重新分析自上次运行以来更改的文件。

高级特性

1. 多语言支持

本地化输出：使用 --language 以你首选语言生成内容。

# 生成中文内容
/understand --language zh

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

首次运行：

如果没有传递 --language 且没有存储语言，/understand 检测你对话使用的语言
如果不是英语，它要求你确认（或覆盖）再生成
英语对话不受影响
你的选择保存到 .understand-anything/config.json 并在每次后续运行中重用

--language 参数影响：

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

2. 架构分层

自动按架构层分组：

API
Service
Data
UI
Utility

带颜色编码的图例。

3. 编程模式标注

12 种编程模式在上下文中解释：

泛型
闭包
装饰器
工厂模式
单例模式
观察者模式
策略模式
命令模式
迭代器模式
代理模式
适配器模式
桥接模式

无论它们出现在哪里。

4. 用户级别调整

仪表板根据你是谁调整其详细级别：

初级开发者
PM
高级用户

使用场景

场景 1：新成员入职

问题： 新成员加入团队，代码库庞大，不知从何开始

解决方案：

/understand
/understand-onboard

价值：

自动生成入门指南
快速理解项目结构
减少上手时间

场景 2：代码审查

问题： PR 审查时，不了解更改的全局影响

解决方案：

/understand-diff

价值：

查看涟漪效应
评估风险范围
做出明智决策

场景 3：功能开发

问题： 开发新功能，需要理解现有代码如何工作

解决方案：

/understand-chat How does the payment flow work?
/understand-explain src/auth/login.ts

价值：

快速理解业务流程
深入具体实现
准确找到修改点

场景 4：知识管理

问题： 团队知识分散在 wiki 中，难以导航

解决方案：

/understand-knowledge ~/path/to/wiki

价值：

将 wiki 转换为知识图谱
发现思想之间的关系
快速找到相关知识

场景 5：文档生成

问题： 需要为项目生成文档，但手动编写耗时

解决方案：

/understand
/understand-dashboard

价值：

自动生成可视化文档
保持与代码同步
Docs-as-code

关键洞察

Understand Anything 不是另一个代码可视化工具。

Understand Anything 是代码理解的工作台。

传统代码理解：

你手动阅读代码、在文件之间跳转、在脑海中构建心理模型、容易迷失方向

Understand Anything：

多 Agent 流水线分析 → 构建知识图谱 → 交互式仪表板 → 智能搜索 → 影响分析 → 自动导览

Understand Anything 的价值：

停止盲目阅读代码

开始看到大局

理解每个部分如何组合在一起

适用对象：

新团队成员（快速上手）
代码审查者（理解影响）
架构师（全局视图）
PM（业务对齐）
文档撰写者（自动生成）

核心能力：

将代码库转换为交互式知识图谱
可视化探索、搜索和提问
自动生成入门指南和导览
分析更改的影响
提取业务领域知识
将 Wiki 转换为知识图谱

一个命令。

/understand

停止阅读代码盲。

开始理解一切。

Understand Anything

把代码库变成可交互知识图谱。