BAIZE AI RESOURCE

代码与文档知识图谱

Understand-Anything

Understand-Anything 是开源 AI Skill,可分析代码库、知识库或文档,生成文件、函数、类及依赖关系图谱,并通过交互式界面检索与问答。

Understand-Anything

资源介绍

Understand-Anything 由 Egonex 开源,最初由 Lum1104 创建,定位为面向代码理解场景的 AI Skill 与插件集合。它通过多智能体流水线扫描项目,把每个文件、函数、类和依赖关系抽取为节点与边,生成 knowledge-graph.json,并配套一个可交互的仪表盘用于可视化浏览。除结构图谱外,它还提供业务域视图,把代码映射为领域、流程和步骤;也支持对 Karpathy 模式的 LLM wiki 做知识库分析,生成带社区聚类的力导向图。内置能力包括按依赖顺序自动生成的导览、模糊与语义搜索、diff 影响分析、按架构分层着色、以及随用户角色调整细节的界面。它适用于刚加入新团队、面对大型陌生代码库的开发者,也适合需要梳理业务逻辑或整理知识库的团队。

Skill 能力

交互式结构知识图谱

把代码库中的文件、函数、类与依赖关系构建为可点击、可搜索、可探索的节点图,选中节点可查看摘要与关联关系。

业务域视图

将代码映射为真实业务流程,以领域、流程和步骤组成的横向图谱展示,帮助理解代码与业务之间的对应关系。

知识库分析

针对 Karpathy 模式的 LLM wiki,先用确定性解析器提取 wikilink 与分类,再由 LLM 智能体发现隐含关系、抽取实体与观点。

导览与语义搜索

按依赖顺序自动生成架构导览,并支持按名称或语义检索,例如查找处理鉴权的相关部分。

Diff 影响分析

结合知识图谱分析代码变更,识别受影响的组件、涉及的分层与潜在风险,并生成可供仪表盘可视化的 diff 覆盖数据。

分层与角色自适应界面

按 API、服务、数据、UI、工具等架构层自动分组并配色,仪表盘还会根据初级开发者、产品经理或高级用户调整细节层级。

资源配置

适用平台

Claude CodeCodexCursorGemini CLI其他

支持模型

模型无关

调用方式

手动调用命令调用

安装与调用

  1. 在支持的环境中安装 Understand-Anything 插件或 Skill,并确保 Node.js 等运行依赖可用。

  2. 在项目根目录运行 /understand 命令,对代码库执行分析并生成 knowledge-graph.json。

  3. 运行 /understand-dashboard 启动交互式仪表盘,在浏览器中浏览、搜索和探索知识图谱。

  4. 如需业务视角,运行 /understand-domain 从已有图谱或轻量扫描中提取领域、流程与步骤。

  5. 如需评估改动影响,运行 /understand-diff 分析 git diff 或 PR,并生成 diff 覆盖数据供仪表盘展示。

  6. 如需基于图谱提问,运行 /understand-chat 并附带查询内容,由 Skill 检索相关子图后作答。

使用案例

接手陌生大型代码库

使用场景新成员加入团队,面对数十万行代码不知从何入手

运行 /understand 生成知识图谱,再通过导览按依赖顺序了解架构,用语义搜索定位关键模块。

评估一次改动的波及范围

使用场景提交前需要确认改动会影响哪些组件

运行 /understand-diff 分析当前 diff,得到直接修改组件、受影响组件、涉及分层与风险提示。

梳理代码背后的业务流程

使用场景需要向非技术同事解释系统如何支撑业务

运行 /understand-domain 生成领域流程横向图谱,用领域、流程和步骤呈现业务逻辑。

把个人知识库变成可导航图谱

使用场景维护了大量 Markdown 笔记,希望发现笔记之间的隐含联系

运行 /understand-knowledge 指向 Karpathy 模式的 LLM wiki,得到带社区聚类的力导向知识图谱。

包含内容

understand-anything-source.zip
README-中文安装说明.md
LICENSE-MIT.txt
THIRD-PARTY-NOTICES.md
SHA256.txt

常见问题

Understand-Anything 支持哪些使用环境?
根据仓库说明,它可与 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等多种环境配合使用,仓库中提供了对应的插件配置与安装脚本。
使用它需要 API Key 或联网吗?
分析阶段依赖所选 AI 环境的能力;而独立的只读查看器 understand-anything-viewer 不需要 Claude Code、LLM 或 API Key,只要求 Node.js 18 及以上,数据全部在本地读取。
生成的数据保存在哪里?
分析产物默认写入项目的数据目录,新版本使用 .ua/,若项目已存在旧版 .understand-anything/ 目录则继续沿用该目录,其中包含 knowledge-graph.json 等文件。
知识图谱过期了怎么办?
相关 Skill 会对比图谱记录的 gitCommitHash 与当前 HEAD,并检查工作区改动;若检测到项目文件变化会提示图谱可能遗漏变更,可重新运行 /understand 刷新。
能否只查看图谱而不重新分析?
可以。项目提供独立的只读查看器,通过 npx 运行发布包并指向已分析的项目目录,即可在本地浏览器中打开完整仪表盘。