Understand Anything
沿着图谱读懂一个项目
把选定代码库整理成结构图、分层说明和阅读导览，再用真实源码核对业务流程与改动影响。也能为特定结构的 Markdown wiki 建图。
Understand Anything 项目演示
查看示例出处作者列出的使用环境
- Claude Code
- Codex
- Cursor
- Gemini CLI
- GitHub Copilot
- OpenCode
- Kiro
- Cline
- Antigravity
- OpenClaw
- Trae
- Hermes
- GitHub Star
- 88,943
- 版本
- 2.9.8
- 资料核对
- 分类
- 工程开发
先回答一个真实问题，再扩大分析范围
先用一个小项目建立基线，沿导览找到入口，再挑一个真实流程回读源码。确认这张图能帮助定位后，再用于业务说明和分支改动评审。
选一个任务，开始使用
在目标项目中启动 Claude Code，逐行执行下方命令。添加市场后还要安装插件；在安装面板中选择仅当前仓库的个人范围（local），按完成提示加载或重载。输入 /，确认能看到 /understand-anything:understand 等入口，再运行任务。
适合接手工程，先弄清入口、主要模块与阅读顺序。
在 Claude Code 中安装完整插件
在 Claude Code 会话中逐行执行。第二行打开插件安装面板，选择 local 范围并完成安装；按提示加载，确认命名空间命令出现。这里安装的是技能、分析代理与钩子组成的完整插件。
查看作者安装说明/plugin marketplace add https://github.com/Egonex-AI/Understand-Anything.git /plugin install understand-anything@understand-anything首次路径：确认范围 → 建图 → 打开 → 对照源码
先在选定项目根目录发送第一条任务。全量扫描前查看数据目录中的 .understandignore（默认 .ua/.understandignore，旧项目使用 .understand-anything/ 下的同名文件）并确认；完成后核对 knowledge-graph.json、meta.json、fingerprints.json 和警告，再用 /understand-anything:understand-dashboard ./ 打开。仪表盘会尝试下载与插件同版本的查看器，失败则安装依赖、构建 core 并启动本地 Vite。核查时源码为 2.9.8，公开 release 最新为 2.9.0，未找到 v2.9.8 查看器；首次应准备构建环境。打开终端输出的完整 token 链接，在图中找一个真实文件并对照本地源码。
查看仪表盘启动与回退步骤把这段话发给 AI
以下为编辑编写的使用示例，并非本站运行结果。先准备 brief.md，写明项目目录、代码版本、关注的问题、排除范围；改动评审还需写明基准分支。示例 ./ 指当前项目，wiki 示例目录需替换成自己的资料目录。
/understand-anything:understand ./ --language zh --no-auto-update 按 brief.md 分析当前项目。先报告实际目标目录、代码版本、将使用的数据目录和忽略规则，等我确认扫描范围后继续；若目标被重定向到主仓库，先说明。不要把未纳入扫描的目录算作已覆盖。 完成后报告扫描与分析文件数、跳过项、失败批次和验证警告，给出图谱、元数据及指纹文件路径。只有最终验证通过才打开仪表盘；保存了部分图也要明确标出。 给出从项目说明到入口、核心模块的阅读路线。用 brief.md 中的问题挑三处真实文件，回读源码核对图中的说明；区分解析线索、模型推断和仍待验证的关系。保留自动更新关闭状态，不修改业务代码。
检查你拿到的结果
- 项目数据目录中的 knowledge-graph.json，以及成功完成基线时的 meta.json、fingerprints.json；附实际覆盖和警告。
- 一条能定位到真实文件的阅读路线，至少核对三处源码，并说明图中尚未解释的问题。
进一步了解这个 Skill
Understand Anything 将本地分析工具、AI 技能和浏览仪表盘放在一起。当前仓库有九个技能入口：understand 建立代码图，dashboard 打开已有图；chat、explain、onboard 服务提问与阅读；diff 查看改动邻域，domain 提取业务流程，knowledge 分析 Markdown wiki，figma 则连接 Figma 文件。首次使用可以从代码图开始，无需同时使用所有入口。
代码图把文件、重要函数与类、配置、文档和基础设施关联起来。解析工具提供项目内部导入、声明等结构线索，模型再补充用途、分层、标签和阅读导览。业务视图将已有代码图解释为“业务域—流程—步骤”，保存在单独的 domain-graph.json；这层解释适合讨论业务，但不是程序运行轨迹。
产物保存在目标项目的 .ua/；已有 .understand-anything/ 目录时继续沿用旧目录。图谱可交给同事浏览，也可作为后续问答的上下文。它是一份有版本、有范围的理解材料：忽略项、解析失败、模型推断和代码更新都要随解释一起保留。
来源与核验
资料核对