Understand Anything v2.9.0：图谱可共享，语义仍要回源码核对

Understand Anything 先用 Tree-sitter 提取文件、函数、类、import、调用和继承，再让多个 Agent 补充摘要、架构层、业务域和导览。结果写入 .ua/knowledge-graph.json，Dashboard 读取这份本地 JSON。

仓库身份与当前版本

旧地址 Lum1104/Understand-Anything 已由 GitHub 重定向到 Egonex-AI/Understand-Anything。当前 Release 是 v2.9.0，发布于 2026-07-10。它增加 Figma 图谱、更多语言和平台，并把新项目的数据目录改成 .ua/；旧目录仍可继续使用。

understand anything 都有 2 次展现，最新一期还有 understand anything dashboard1 次展现。

安装与第一次分析

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

先在小型、无敏感信息的测试仓库运行。首次全量分析会读取大量源码，官方明确提醒大仓库可能消耗显著 token；后续默认只分析变更文件。

源码边界：Tree-sitter 的结构解析是本地确定性步骤，LLM 语义阶段会读取解析结构和原始源码。使用云模型前要确认公司政策、模型提供方和允许处理的目录。图谱本身也可能泄露结构、名字和生成摘要。

团队共享与只读查看

可以提交 .ua/ 中的图谱，但官方建议排除 intermediate/ 与 diff-overlay.json。图谱超过 10MB 时使用 git-lfs。只读 viewer 需要 Node.js 18+；已有图谱时不需要 Claude Code、LLM 或 API key，官方称内容从本地磁盘只读提供。

失败排查

升级后找不到图谱：若项目已有 .understand-anything/，v2.9.0 会继续使用旧目录，不会同时新建 .ua/。
首次运行耗时或 token 过高：先用小仓库验证，缩小分析范围，或按官方建议接本地模型。
图谱合并缺节点：查看 v2.9.0 写入的 merge-report.json 和告警；该版本会在下次运行自动重试相关合并。
Dashboard 能打开但结论不对：结构边可复查，语义描述要回源码、测试和负责人确认。

与 Aider repository map 对比

Aider repository map 按依赖图排序，只把当前对话最相关的类、函数和签名放进 token 预算。Understand Anything 生成更完整且可持久化的图，并提供 Dashboard、导览、业务域和知识库模式。一次编码对话需要轻量上下文时，Aider map 更省；团队要共享长期代码地图时，Understand Anything 提供的产物更完整。

验证边界：本轮只核对重定向后的官方 README、v2.9.0 Release 与主分支元数据。未安装插件，未执行 /understand，未向模型发送源码，未生成图谱或打开 Dashboard，未验证任何生成结论。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

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

采用建议

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

原教程未展开的系统信息

核心功能

结构与语义分层
Tree-sitter 确定性提取 import、函数、类、调用和继承；LLM 再生成摘要、标签、架构层和业务含义。
多 Agent 流水线
项目扫描、文件分析、架构分析、导览和图审查分工执行；文件分析最多五个并发 worker。
本地交互 Dashboard
生成图后可浏览节点、依赖、导览和业务域；已有图可用只读 viewer 打开，无需再次调用 LLM。
可共享增量产物
图谱是 JSON，可随仓库提交；后续分析默认只处理变更文件，v2.9.0 使用 `.ua/` 并兼容旧目录。

常见问题

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 生成内容；关键判断仍要回到源码、测试和负责人确认。

官方来源：仓库、v2.9.0、使用说明。