Understand-Anything 是什么?

Understand Anything 是 Egonex-AI 维护的代码库与知识库分析插件。它用 Tree-sitter 提取可复现的结构,再用多 Agent 补充语义、架构层、业务域和导览,最后把结果写成 `.ua/knowledge-graph.json` 并在本地 Dashboard 中浏览。

⭐ 58,898 Stars 🍴 4,896 Forks TypeScript MIT 作者: Lum1104
来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

它把代码地图做成可提交、可增量更新的 JSON,而不是每次对话临时生成。最新一期另有 `understand anything dashboard` 1 次展现。原 Lum1104 URL 已由 GitHub 重定向到 Egonex-AI。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md

核心功能

结构与语义分层

Tree-sitter 确定性提取 import、函数、类、调用和继承;LLM 再生成摘要、标签、架构层和业务含义。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md
多 Agent 流水线

项目扫描、文件分析、架构分析、导览和图审查分工执行;文件分析最多五个并发 worker。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md
本地交互 Dashboard

生成图后可浏览节点、依赖、导览和业务域;已有图可用只读 viewer 打开,无需再次调用 LLM。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md
可共享增量产物

图谱是 JSON,可随仓库提交;后续分析默认只处理变更文件,v2.9.0 使用 `.ua/` 并兼容旧目录。

来源:github.com/Egonex-AI/Understand-Anything/releases/tag/v2.9.0

技术架构

扫描阶段先用 Tree-sitter 建立文件、符号和依赖骨架,再把结构和原始源码交给最多五个并发的 file-analyzer。architecture-analyzer、tour-builder 与 graph-reviewer 补齐架构层、导览和引用完整性;domain 与 knowledge 模式再增加专用 Agent。产物保存在 `.ua/`,Dashboard 从本地 JSON 读取。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md;https://…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) 支持插件或 skill 的编码 Agent支持插件或 skil… 完成语义分析所需的模型额度或本地模型完成语义分析所需… Node.js 18+(只读 viewer)Node.js 18+(… 可选 git-lfs(10MB 以上图谱)可选 git-lfs(1… 结构与语义分层 多 Agent 流水线 本地交互 Dashboard 可共享增量产物 Understand-Anything 项目本体 核心功能 关键依赖

技术栈

语言TypeScript框架Claude Code 插件/跨平台 skills + Tree-sitter + 多 Agent + 本地 Web Dashboard
支持插件或 skill 的编码 Agent完成语义分析所需的模型额度或本地模型Node.js 18+(只读 viewer)可选 git-lfs(10MB 以上图谱)
分析结果写入项目 .ua/;只读 viewer 在 127.0.0.1 提供带 token 的本地 URL
来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md

快速上手

Claude Code 中先执行 `/plugin marketplace add Egonex-AI/Understand-Anything` 与 `/plugin install understand-anything`。在测试仓库运行 `/understand --language zh`,确认生成 `.ua/knowledge-graph.json` 后再运行 `/understand-dashboard`。首次全量分析可能消耗大量 token;大型仓库先缩小范围或接本地模型。团队只读查看可用官方 release viewer,需要 Node.js 18+,并确保项目中已有 `.ua/` 或旧版 `.understand-anything/`。
来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md

使用场景

适合陌生代码库 onboarding、评估当前改动影响、整理业务域,以及把代码图作为仓库资产分享。生成的语义说明适合导航,不应替代源码、测试和人工架构审查。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md

优势与局限

优势

  • 确定性结构解析与 LLM 语义分析分开
  • 图谱 JSON 可提交并增量更新
  • 覆盖代码、业务域、知识库和 Figma 模式
  • 只读 viewer 不需要 LLM 或 API key

局限

  • 首次分析大型仓库可能消耗大量 token
  • 语义、架构层和业务域判断仍可能出错
  • 提交图谱可能把源码结构和生成摘要带入仓库
  • 跨多个 Agent 平台的安装与命令支持可能不完全一致
来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md;https://…

最新版本

v2.9.0 发布于 2026-07-10,加入 `/understand-figma`、Dart/Scala/Swift/Kotlin 等语言支持、新平台适配、合并报告和安全加固;产物目录改为 `.ua/`,同时向后兼容旧目录。

来源:github.com/Egonex-AI/Understand-Anything/releases/tag/v2.9.0

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对重定向后的官方仓库、README、v2.9.0 Release 与主分支提交元数据  |  limitations: 未安装插件,未执行 `/understand`,未向模型发送源码,未生成图谱或打开 Dashboard,未验证任何生成结论  |  observed_output: 当前 Release 为 v2.9.0,发布于 2026-07-10;数据目录改为 `.ua/`,旧 `.understand-anything/` 保持兼容;该版本加入 Figma 分析、更多语言/平台与合并报告

来源:github.com/Egonex-AI/Understand-Anything/releases/tag/v2.9.0;https://…

同类项目对比

Aider 的 repository map 会用依赖图排序,把最相关的类、函数和签名压进当前聊天的 token 预算;Understand Anything 则生成较完整、可持久化的知识图谱,并提供 Dashboard、导览和业务域分析。只为一次编码对话补上下文时 Aider 的 map 更轻;要共享和浏览长期代码地图时 Understand Anything 更合适。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md;https://…

总结评价

适合陌生代码库 onboarding、评估当前改动影响、整理业务域,以及把代码图作为仓库资产分享。生成的语义说明适合导航,不应替代源码、测试和人工架构审查。采用前需要核对:首次分析大型仓库可能消耗大量 token。

来源:github.com/Egonex-AI/Understand-Anything/blob/main/README.md;https://…

常见问题

Understand Anything v2.9.0 为什么把目录改成 `.ua/`?

v2.9.0 将新分析产物写入更短的 `.ua/`。已有项目若存在 `.understand-anything/`,所有读写仍继续使用旧目录,不需要手工迁移。

运行 `/understand` 会把源码发给模型吗?

结构解析由本地 Tree-sitter 完成,但语义分析会让配置的 LLM 读取解析结构和原始源码。敏感仓库应先确认模型提供方、数据政策和允许发送的目录,或改用合规的本地模型。

同事只查看已有图谱也要安装 Claude Code 吗?

不需要。只要仓库已有 `.ua/` 或旧目录,官方只读 viewer 可用 Node.js 18+ 在本机打开 Dashboard,无需 LLM 或 API key。

Understand Anything 生成的架构图能当权威文档吗?

不能直接这样使用。文件、符号和依赖骨架来自确定性解析,摘要、架构层和业务域属于 LLM 生成内容;关键判断仍要回到源码、测试和负责人确认。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件