Understand Anything 是一个把任意代码库 / 知识库 / 文档变成可交互知识图谱的 Claude Code 插件(同时支持 Codex、Cursor、Copilot、Gemini CLI 等 14 个平台),用多 Agent 流水线扫描项目、抽取每个文件/函数/类/依赖为图节点,再用浏览器 Dashboard 可视化探索,图谱以 JSON 存到 .understand-anything/ 可随仓库 commit 共享。
来源:README 首段 + Features 节 + Multi-Platform 表 查看 GitHub 仓库 →「新人接手 20 万行代码库不知从哪看起」是普遍痛点,传统办法是读文档(常年过期)或硬啃代码。Understand Anything 把这件事产品化:一条 /understand 命令跑多 Agent 流水线,自动出一张可点击、可搜索、按架构层着色的知识图谱 + 按依赖顺序排好的 Guided Tour。它踩中三个真实需求:① 跨 14 个 AI 编程平台(Claude Code 原生 + Codex/Cursor/Copilot/Gemini CLI 等一行 install.sh);② 6 种语言输出节点描述与 Dashboard UI;③ 图就是 JSON,commit 一次队友免跑流水线、还能做 PR review 和 docs-as-code。6 周拿到 16K★、覆盖 onboarding/代码考古/业务域梳理多个场景,是「knowledge graph for codebase」这条线上目前最完整的开源实现。
来源:README 开场痛点段 + Multi-Platform 表 + Share the Graph 节 + GitHub stars一条命令编排 5-7 个专职 Agent:project-scanner(发现文件、识别语言框架)、file-analyzer(抽函数/类/import 成节点和边)、architecture-analyzer(识别架构层)、tour-builder(生成导览)、graph-reviewer(校验图完整性与引用一致性);/understand-domain 加 domain-analyzer、/understand-knowledge 加 article-analyzer。file-analyzer 并行跑(最多 5 并发、每批 20-30 文件),支持增量更新只重分析变更文件,结果存 .understand-anything/knowledge-graph.json。
来源:README 'Under the Hood / Multi-Agent Pipeline' 表/understand-dashboard 打开浏览器 Dashboard,把代码库渲染成可平移/缩放/点击的图,按 API/Service/Data/UI/Utility 架构层色块分组并配图例。支持模糊搜索(按名字)+ 语义搜索(如「哪些部分处理 auth?」跨图返回相关结果)。点任一节点看代码、关系和大白话解释。dashboard 是 plugin monorepo 里的独立 package。
来源:README Features + Quick Start step 3 + understand-anything-plugin/packages/dashboard切到 domain 视图,由 domain-analyzer 把代码映射到真实业务流程——domains、flows、process steps 以水平图布局展示,回答「这套代码对应哪些业务环节」,适合 PM 和跨团队沟通,而不只是给开发者看的结构图。
来源:README 'Understand business logic' + Multi-Agent Pipeline 表把 /understand-knowledge 指向一个 Karpathy 模式的 LLM wiki,确定性解析器先从 index.md 抽 wikilinks 和分类,再由 LLM agents 发现隐含关系、抽实体、surface claims,产出带社区聚类的力导向知识图谱——把 wiki 变成可导航的概念关系图,而不只是代码图。
来源:README 'Analyze knowledge bases' 节提交前看当前改动会波及系统哪些部分,理解跨代码库的涟漪效应;diff overlay 存在本地 .understand-anything/diff-overlay.json(属本地 scratch、不建议 commit)。把图谱能力从「读懂现状」扩展到「评估变更」。
来源:README 'Diff Impact Analysis' + Share the Graph 节tour-builder 自动生成按依赖顺序排列的架构导览,让人按「正确顺序」学代码库;并在代码出现处就地解释 generics、closures、decorators 等 12 种编程模式。Persona-Adaptive UI 还会按使用者身份(初级开发 / PM / 资深)调整 Dashboard 的信息密度。
来源:README Features 表(Guided Tours / Language Concepts / Persona-Adaptive UI)Claude Code 走插件市场原生安装;Codex/OpenCode/Gemini CLI/Pi/Antigravity/Vibe/VS Code Copilot/Hermes/Cline/KIMI 等走 install.sh 一行(克隆到 ~/.understand-anything/repo 建符号链接);Cursor/Copilot 靠 .cursor-plugin/.copilot-plugin 自动发现。图谱是纯 JSON,commit 一次队友跳过流水线,配 /understand --auto-update 的 post-commit hook 增量保鲜,10MB+ 用 git-lfs。
来源:README Multi-Platform Installation + Platform Compatibility 表 + Share the Graph 节仓库是 pnpm workspace 单仓,主体在 understand-anything-plugin/(338 文件),内部又是一个 pnpm monorepo:packages/core(@understand-anything/core,图的类型、构建、解析核心)+ packages/dashboard(浏览器可视化)+ skills/(十几个 /understand* slash 命令的 SKILL.md)+ agents/(project-scanner 等专职 Agent 定义)+ hooks/(如 auto-update 的 post-commit hook)。另有 homepage/(understand-anything.com 含 live demo)和 docs/(33 文件)。数据流是「确定性解析 + LLM Agent」混合:先用确定性解析器抽出文件/符号/wikilinks 这些可靠骨架,再用并行 file-analyzer 等 LLM Agent 补语义关系、架构层、业务域和导览,最后 graph-reviewer 校验引用完整性,统一产出 knowledge-graph.json,Dashboard 纯读这份 JSON 渲染。设计判断:把「确定性骨架 + LLM 语义层 + 纯 JSON 产物 + 多端薄安装」拆得很干净,让图谱可缓存、可 commit、可跨平台复用是这套架构最聪明的地方;潜在过度设计是同时维护 14 个平台的 install/symlink 适配,长期适配成本不低。
来源:tree(understand-anything-plugin/{packages,skills,agents,hooks})+ package.json(pnpm workspace)+ README Under the Hood中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
@understand-anything/corepnpm workspace(pnpm@10.6.2)— 多包管理TypeScript + VitestClaude Code 多 Agent 子系统(project-scan…确定性解析器(wikilinks / 符号抽取)+ LLM Agent …1. 新人 onboarding:接手陌生大型代码库时跑 /understand + /understand-onboard,按依赖顺序的 Guided Tour 快速建立全局认知,不用盲读几十万行;2. 团队共享代码地图:把 knowledge-graph.json commit 进仓库,队友 clone 即看图、跳过流水线,PR review 时直接看 /understand-diff 的影响范围;3. 业务域梳理:PM 或架构师用 /understand-domain 把代码映射到业务流程,做跨团队沟通或系统重构前的领域盘点;4. 知识库导航:用 /understand-knowledge 把 Karpathy 模式的 LLM wiki / 文档站变成带聚类的力导向知识图谱;5. 多平台团队:Claude Code、Cursor、Codex、Gemini CLI 混用的团队,用同一套插件和同一份图谱产物。
来源:README 开场场景 + Share the Graph + Quick Start 各命令v2.7.3(2026-05-19)。最近 5 个 release:v2.0.0 (2026-03-28) → v2.1.0 (2026-04-03) → v2.3.1 (2026-04-12) → v2.5.0 (2026-05-04) → v2.7.3 (2026-05-19),2.x 线稳定迭代、约每两三周一个版本。具体变更内容以仓库 release notes 为准,材料中未逐条展开。
来源:GitHub Releases API(5 个 tag + 时间戳)如果你常接手陌生代码库、或团队想把「代码地图」做成可共享的资产,Understand Anything 是当前 GitHub 上把「codebase → 可交互知识图谱」做得最完整的开源方案:14 平台覆盖、6 语言输出、图谱即 JSON 可 commit,命令链路从 onboarding 一直覆盖到 PR review。务实建议:1) 优先在 Claude Code 上用(原生插件,多 Agent 流水线完整度最高),其它平台先用 install.sh 跑通 /understand + /understand-dashboard 两个核心命令再扩展;2) 大代码库首次跑 /understand 要有 LLM 时间和成本预期,跑完把 .understand-anything/ 的图 JSON commit 进仓库(排除 intermediate/ 和 diff-overlay.json),队友就能跳过流水线;3) 把生成的图当「导航地图和学习起点」而不是「权威架构文档」——语义层是 LLM 产出、有噪声,关键结论仍要回代码核对;4) 想长期保鲜开 /understand --auto-update 的 post-commit hook,图大于 10MB 记得上 git-lfs;5) 只是想快速感受效果的,直接看 understand-anything.com 的 live demo,零安装。
来源:综合分析Understand Anything 是一个把任意代码库 / 知识库 / 文档变成可交互知识图谱的 Claude Code 插件(同时支持 Codex、Cursor、Copilot、Gemini CLI 等 14 个平台),用多 Agent 流水线扫描项目、抽取每个文件/函数/类/依赖为图节点,再用浏览器 Dashboard 可视化探索,图谱以 JSON 存到 .understand-anything/ 可随仓库 commit 共享。
Understand-Anything 的核心功能包括:/understand 多 Agent 知识图谱流水线、交互式 Dashboard(结构图 + 架构层着色 + 双模式搜索)、业务域视图(/understand-domain)、知识库 / Karpathy-pattern wiki 分析(/understand-knowledge)、Diff 影响分析(/understand-diff)。
「新人接手 20 万行代码库不知从哪看起」是普遍痛点,传统办法是读文档(常年过期)或硬啃代码。Understand Anything 把这件事产品化:一条 /understand 命令跑多 Agent 流水线,自动出一张可点击、可搜索、按架构层着色的知识图谱 + 按依赖顺序排好的 Guided Tour。
1. 新人 onboarding:接手陌生大型代码库时跑 /understand + /understand-onboard,按依赖顺序的 Guided Tour 快速建立全局认知,不用盲读几十万行;2. 团队共享代码地图:把 knowledge-graph.json commit 进仓库,队友 clone 即看图、跳过流水线,PR review 时直接看 /understand-diff 的影响范围;3.