GitHub - Lum1104/Understand-Anything: 能教学的图谱 > 能炫耀的图谱。将任何代码转化为可交互的知识图谱，支持探索、搜索和提问。兼容 Claude Code、Cod

秦先生在广东
3 阅读1分钟

深入理解任何事物

将任何代码库、知识库或文档转化为可交互的知识图谱，让你随时探索、搜索和提问。 兼容 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等工具。

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe | Русский

💬 加入 Discord 社区 → 提问、分享你的作品，与社区成员互相交流。

你刚加入一个新团队，代码库有 200,000 行代码，你该从哪里下手？

Understand Anything 是一款 Claude Code 插件，它通过多 Agent 流水线分析你的项目，为每个文件、函数、类和依赖项构建知识图谱，并提供一个可视化的交互式仪表板供你全面探索。告别盲目读代码，开始掌握全局视野。

我们的目标不是用复杂的图谱让你叹为观止，而是用一张图悄悄告诉你每一个模块是如何环环相扣的。

✨ 功能特性

Note

不想看文字介绍？ 直接体验首页上的在线演示 —— 一个完全交互式的仪表板，可以在浏览器中直接平移、缩放、搜索和探索。

探索结构图谱

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

理解业务逻辑

切换到领域视图，看看你的代码如何映射到真实的业务流程——领域、流程和步骤以横向图谱的形式清晰呈现。

分析知识库

将 /understand-knowledge 指向一个 Karpathy 风格的 LLM wiki，即可获得一张带有社区聚类的力导向知识图谱。确定性解析器从 index.md 中提取 wikilink 和分类，LLM Agent 则进一步发现隐式关系、提取实体并浮现论断——将你的 wiki 转化为一张由相互关联的思想构成的可导航图谱。

| ### 🧭 引导式浏览 自动生成按依赖顺序排列的架构浏览路径，帮助你以正确的顺序理解代码库。 | ### 🔍 模糊搜索与语义搜索 按名称或语义查找任何内容。搜索"哪些部分负责身份验证？"即可获取图谱中的相关结果。 |

| ### 📊 Diff 影响分析 在提交之前，提前了解你的改动会影响系统的哪些部分，掌握变更在整个代码库中的连锁效应。 | ### 🎭 角色自适应 UI 仪表板根据你的角色——初级开发者、产品经理或高级用户——自动调整信息的详细程度。 |

| ### 🏗️ 分层可视化 按架构层次自动分组——API、Service、Data、UI、Utility——并配有颜色编码的图例。 | ### 📚 编程语言概念 在代码出现的上下文中，结合实际场景讲解 12 种编程模式（泛型、闭包、装饰器等）。 |

🚀 快速开始

1. 安装插件

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

2. 分析你的代码库

/understand

多 Agent 流水线会扫描你的项目，提取每个文件、函数、类和依赖项，然后将构建好的知识图谱保存到 .understand-anything/knowledge-graph.json。

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

# Generate Chinese content (知识图节点描述和 Dashboard UI) /understand --language zh # Supported languages: en (default), zh, zh-TW, ja, ko, ru

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

  • 知识图谱中节点的摘要和描述

  • 仪表板 UI 的标签、按钮和提示文本

  • 引导式浏览的说明文字

3. 探索仪表板

/understand-dashboard

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

4. 持续学习

# Ask anything about the codebase /understand-chat How does the payment flow work ? # Analyze impact of your current changes /understand-diff # Deep-dive into a specific file or function /understand-explain src/auth/login.ts # Generate an onboarding guide for new team members /understand-onboard # Extract business domain knowledge (domains, flows, steps) /understand-domain # Analyze a Karpathy-pattern LLM wiki knowledge base /understand-knowledge ~ /path/to/wiki

🌐 多平台安装

Understand-Anything 支持多种 AI 编程平台。

Claude Code（原生支持）

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

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

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash # or skip the prompt by passing the platform: 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

安装程序会将仓库克隆到 ~/.understand-anything/repo，并为所选平台创建相应的符号链接。安装后请重启你的 CLI/IDE。

  • 支持的 值：gemini、codex、opencode、pi、openclaw、antigravity、vibe、vscode、hermes、cline、kimi

  • 后续更新：./install.sh --update

  • 卸载：./install.sh --uninstall

Cursor

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

VS Code + GitHub Copilot

安装了 GitHub Copilot（v1.108+）的 VS Code 在克隆本仓库后，会通过 .copilot-plugin/plugin.json 自动发现插件，无需手动安装——克隆后直接在 VS Code 中打开即可。

如需个人技能（可跨所有项目使用），请使用 vscode 平台运行上方的 install.sh 命令。

Copilot CLI

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 |

📦 与团队共享图谱

图谱本质上只是 JSON 文件——提交一次，团队成员即可跳过流水线分析步骤。非常适合新人入职、PR 评审和文档即代码的场景。

示例： GoogleCloudPlatform/microservices-demo（fork） —— 一个包含已提交图谱的 Go / Java / Python / Node 参考项目。

建议提交的内容： .understand-anything/ 中的所有内容，除了 intermediate/ 和 diff-overlay.json（这两个是本地临时文件）。

.understand-anything / intermediate / .understand-anything / diff-overlay.json

保持图谱更新： 启用 /understand --auto-update —— 这是一个 post-commit 钩子，每次提交后会增量更新图谱，确保每次提交都附带最新的图谱。或者在发布前手动重新运行 /understand。

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

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

🔧 底层原理

多 Agent 流水线

/understand 命令协调 5 个专属 Agent，/understand-domain 则额外增加一个：

| Agent | 职责 |

| project-scanner | 发现文件，检测编程语言和框架 |

| file-analyzer | 提取函数、类、导入关系；生成图谱节点和边 |

| architecture-analyzer | 识别架构层次 |

| tour-builder | 生成引导式学习路径 |

| graph-reviewer | 验证图谱的完整性和引用一致性（默认内联运行；使用 --review 可进行完整 LLM 审查） |

| domain-analyzer | 提取业务领域、流程和处理步骤（供 /understand-domain 使用） |

| article-analyzer | 从 wiki 文章中提取实体、论断和隐式关系（供 /understand-knowledge 使用） |

文件分析器并行运行（最多 5 个并发，每批 20-30 个文件），支持增量更新——仅重新分析自上次运行以来发生变化的文件。

🎥 社区

由 Better Stack 制作的社区演示视频。

在 YouTube 上观看 →

制作了视频、博客或教程？欢迎提 Issue 或 PR，我们很乐意在此展示。

🤝 参与贡献

欢迎贡献！以下是参与方式：

  • Fork 本仓库

  • 创建功能分支（git checkout -b feature/my-feature）

  • 运行测试（pnpm --filter @understand-anything/core test）

  • 提交更改并发起 Pull Request

重大变更请先提 Issue，以便我们提前讨论实现方案。

告别盲目读代码，开始真正理解一切。

Star 历史

感谢每一位使用和贡献的人——知道这个项目能帮大家节省时间，是它值得被构建出来的意义所在。

MIT License © Lum1104

avatar
文章
阅读
粉丝