Understand-Anything：代码知识图谱

<blockquote><p>&quot;The goal isn&#39;t a graph that wows you with how complex your codebase is — it&#39;s a graph that quietly teaches you how every piece fits together.&quot;<br>目标不是一张让你惊叹「代码库真复杂」的图——是一张默默教你每个部分如何协作的图。</p><p>——Yuxiang Lin, Understand-Anything 作者, 2026 年</p></blockquote><p>Skills 拆能力。Spec 写合约。Ralph Loop 循环到对。gstack 角色覆盖。Goal Workflow 串流水线。autoresearch 全自动闭环。官方插件注入领域知识。每一章都在回答同一件事：让 AI 写出更好的代码。</p><p>本章不教 AI 写代码——教 AI 读懂已有的代码。</p><p>Understand-Anything 是目前「代码理解」方向上最成熟的开源项目：48.4K Stars，15 个 AI Agent 平台支持，最新版本 v2.7.3。作者 Yuxiang Lin。装上之后，Agent 不再靠 grep 和逐文件阅读理解代码库——先查知识图谱。</p><p><img src="/images/image-20260601161740269.png"></p><span id="more"></span><h2 id="13-1-问题：AI-不理解你的代码"><a href="#13-1-问题：AI-不理解你的代码" class="headerlink" title="13.1 问题：AI 不理解你的代码"></a>13.1 问题：AI 不理解你的代码</h2><p>AI 写代码很快。读代码是另一回事。</p><p>当你对 Claude Code 说「在这个功能里加上暗黑模式」，Agent 需要自己找出哪些文件跟主题相关、哪些组件需要适配、CSS 变量在哪里定义、有没有已有的主题切换逻辑。它用 grep 搜关键词，用 Read 逐文件阅读——每次一个文件，每次消耗上下文窗口。五万行的代码库，靠 grep + Read 理解全貌，几十轮对话。每轮烧 token，每轮都可能漏掉关键依赖。</p><p>Agent 不记昨天读过什么。你昨天问了「这个项目的认证逻辑在哪里」，今天再问，它从头搜。Understand-Anything 提前做了这件事。Agent 再来问，直接查知识图谱。</p><h2 id="13-2-核心概念：代码-→-知识图谱"><a href="#13-2-核心概念：代码-→-知识图谱" class="headerlink" title="13.2 核心概念：代码 → 知识图谱"></a>13.2 核心概念：代码 → 知识图谱</h2><p>把代码库变成知识图谱。每个文件、每个函数、每个类是一个节点。import 关系、调用关系、继承关系是边。节点上挂 LLM 生成的摘要和标签，边上标依赖方向。</p><p>这张图有了之后：</p><ul><li><strong>快速定位。</strong> 搜索语义，不是搜索关键词。「认证逻辑在哪里？」——知识图谱返回 <code>src/auth/</code> 模块及它依赖的 <code>src/middleware/session.ts</code>。</li><li><strong>影响分析。</strong> 改了 <code>UserModel</code>，知识图谱展示哪些文件 import 了它、哪些函数调用了它的方法。</li><li><strong>新人上手。</strong> 新成员 Clone 仓库后跑一次 <code>/understand</code>，再用 <code>/understand-onboard</code> 产出按依赖顺序的阅读指南——先看 domain 层，再看 service 层，最后看 API 层。</li></ul><h2 id="13-3-Tree-sitter-LLM：确定性骨架，语义血肉"><a href="#13-3-Tree-sitter-LLM：确定性骨架，语义血肉" class="headerlink" title="13.3 Tree-sitter + LLM：确定性骨架，语义血肉"></a>13.3 Tree-sitter + LLM：确定性骨架，语义血肉</h2><p>Understand-Anything 的架构做了明确分工。</p><p><strong>Tree-sitter</strong> 负责结构解析。把源代码解析成语法树，提取确定性事实：哪些文件 export 了哪些符号、import 来自哪个模块、函数调用了哪些函数、类继承自哪个类。同一份代码，Tree-sitter 每次输出完全相同——零随机性，零幻觉。这些结构事实在扫描阶段预解析成 <code>importMap</code>，文件分析 Agent 直接从 <code>importMap</code> 读取，不重新推导。Tree-sitter 还驱动增量更新——文件内容变了，fingerprint 定位变更范围。</p><p><strong>LLM</strong> 负责语义判断。读入 Tree-sitter 产出的结构和原始源码，产出解析器做不到的事：每个节点的人类可读摘要、语义标签、架构层分类、业务域映射、引导式学习路径。Tree-sitter 确定「这文件导出了什么」，LLM 判断「这个文件是做什么的、属于哪一层、和哪些业务流程相关」。</p><p>分开的好处：结构解析不消耗 token、不膨胀、不摇摆。语义理解只在需要判断「含义」的地方才调 LLM。两侧产出可独立验证——结构结果和 import 语句逐条对账，语义结果人工抽查。</p><h2 id="13-4-安装与配置"><a href="#13-4-安装与配置" class="headerlink" title="13.4 安装与配置"></a>13.4 安装与配置</h2><h3 id="13-4-1-平台支持"><a href="#13-4-1-平台支持" class="headerlink" title="13.4.1 平台支持"></a>13.4.1 平台支持</h3><p>Understand-Anything 支持 15 个 AI Agent 平台。核心引擎是同一套 TypeScript 代码，不同平台只是斜杠命令注册方式不同。</p><table><thead><tr><th>平台</th><th>安装方式</th></tr></thead><tbody><tr><td>Claude Code</td><td>Plugin Marketplace 原生安装</td></tr><tr><td>Codex</td><td><code>install.sh codex</code></td></tr><tr><td>OpenCode</td><td><code>install.sh opencode</code></td></tr><tr><td>OpenClaw</td><td><code>install.sh openclaw</code></td></tr><tr><td>Antigravity CLI</td><td><code>install.sh antigravity</code></td></tr><tr><td>Gemini CLI</td><td><code>install.sh gemini</code></td></tr><tr><td>Pi Agent</td><td><code>install.sh pi</code></td></tr><tr><td>Vibe CLI</td><td><code>install.sh vibe</code></td></tr><tr><td>Hermes</td><td><code>install.sh hermes</code></td></tr><tr><td>Cline</td><td><code>install.sh cline</code></td></tr><tr><td>KIMI CLI</td><td><code>install.sh kimi</code></td></tr><tr><td>Trae</td><td><code>install.sh trae</code></td></tr><tr><td>Cursor</td><td>自动发现 <code>.cursor-plugin/plugin.json</code></td></tr><tr><td>VS Code + Copilot</td><td>自动发现 <code>.copilot-plugin/plugin.json</code>（v1.108+）</td></tr><tr><td>Copilot CLI</td><td><code>copilot plugin install</code></td></tr></tbody></table><h3 id="13-4-2-Claude-Code-安装（推荐）"><a href="#13-4-2-Claude-Code-安装（推荐）" class="headerlink" title="13.4.2 Claude Code 安装（推荐）"></a>13.4.2 Claude Code 安装（推荐）</h3><p>最简路径——Claude Code 内置 Plugin Marketplace：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">/plugin marketplace add Lum1104/Understand-Anything</span><br><span class="line">/plugin install understand-anything</span><br></pre></td></tr></table></figure><p>第一条命令添加插件市场源，第二条安装插件。安装后 <code>/understand</code> 等命令全局可用。</p><h3 id="13-4-3-一行命令安装（其他平台）"><a href="#13-4-3-一行命令安装（其他平台）" class="headerlink" title="13.4.3 一行命令安装（其他平台）"></a>13.4.3 一行命令安装（其他平台）</h3><p>macOS&#x2F;Linux：</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash</span><br></pre></td></tr></table></figure><p>指定平台：</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex</span><br></pre></td></tr></table></figure><p>Windows（PowerShell）：</p><figure class="highlight powershell"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line"><span class="built_in">iwr</span> <span class="literal">-useb</span> https://raw.githubusercontent.com/Lum1104/Understand<span class="literal">-Anything</span>/main/install.ps1 | <span class="built_in">iex</span></span><br></pre></td></tr></table></figure><p>安装脚本做的事：Clone 仓库到 <code>~/.understand-anything/repo</code>，创建平台特定的符号链接，注册斜杠命令。重启 AI Agent 后生效。</p><h3 id="13-4-4-更新与卸载"><a href="#13-4-4-更新与卸载" class="headerlink" title="13.4.4 更新与卸载"></a>13.4.4 更新与卸载</h3><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">./install.sh --update <span class="comment"># 更新到最新版本</span></span><br><span class="line">./install.sh --uninstall codex <span class="comment"># 卸载指定平台</span></span><br></pre></td></tr></table></figure><h2 id="13-5-五到七个专门的-Agent-流水线"><a href="#13-5-五到七个专门的-Agent-流水线" class="headerlink" title="13.5 五到七个专门的 Agent 流水线"></a>13.5 五到七个专门的 Agent 流水线</h2><p>运行 <code>/understand</code>，背后是五个专门 Agent 按序执行。</p><table><thead><tr><th>Agent</th><th>角色</th><th>技术</th></tr></thead><tbody><tr><td><code>project-scanner</code></td><td>扫描项目，发现文件，检测语言和框架</td><td>Tree-sitter + 文件系统</td></tr><tr><td><code>file-analyzer</code></td><td>从每个文件提取函数、类、导入，生成图节点和边</td><td>Tree-sitter + importMap</td></tr><tr><td><code>architecture-analyzer</code></td><td>识别架构层（API、Service、Data、UI、Utility）</td><td>LLM</td></tr><tr><td><code>tour-builder</code></td><td>生成按依赖排序的学习路径</td><td>LLM</td></tr><tr><td><code>graph-reviewer</code></td><td>验证图完整性、引用完整性</td><td>默认内联（确定性检查），<code>--review</code> 切换到 LLM 全面审查</td></tr></tbody></table><p>五个是基础流水线。<code>/understand-domain</code> 追加第六个 Agent——<code>domain-analyzer</code>，从代码中提取业务域、流程、步骤。<code>/understand-knowledge</code> 追加第七个 Agent——<code>article-analyzer</code>，处理 Karpathy-pattern LLM Wiki 文章，提取实体、声明和隐含关系。</p><p>文件分析 Agent 并发运行——最多 5 个并行，每批 20-30 个文件。LLM 调用的延迟被并行掩盖，大项目的分析时间主要由最长的那批文件决定，而不是文件总数。</p><p>增量更新模式（<code>--auto-update</code> 或 commit hook）：只重新分析变更的文件。Tree-sitter 的 fingerprint 检测哪些文件变了，只跑这几个文件的 file-analyzer，其他节点和边不动。小型 commit 的图更新秒级完成。</p><h2 id="13-6-知识图谱的七种用途"><a href="#13-6-知识图谱的七种用途" class="headerlink" title="13.6 知识图谱的七种用途"></a>13.6 知识图谱的七种用途</h2><h3 id="13-6-1-交互式浏览：-understand-dashboard"><a href="#13-6-1-交互式浏览：-understand-dashboard" class="headerlink" title="13.6.1 交互式浏览：/understand-dashboard"></a>13.6.1 交互式浏览：<code>/understand-dashboard</code></h3><p>产出的知识图谱可以导入交互式 Web Dashboard。每个节点可点击——点击文件节点，展示 LLM 摘要、导出的符号、依赖来源和去向。点击类节点，展示方法列表和继承链。节点按架构层颜色编码——API 层蓝色，Service 层绿色，Data 层橙色，UI 层紫色，Utility 层灰色。Dashboard 支持角色自适应 UI——初级开发者、PM、高级用户看到不同粒度的信息。</p><h3 id="13-6-2-语义搜索：-understand-chat"><a href="#13-6-2-语义搜索：-understand-chat" class="headerlink" title="13.6.2 语义搜索：/understand-chat"></a>13.6.2 语义搜索：<code>/understand-chat</code></h3><p>搜索语义，不是关键词。「哪些模块处理用户认证？」——知识图谱中匹配到 <code>src/auth/login.ts</code>（摘要：「处理邮箱+密码登录」）、<code>src/middleware/session.ts</code>（摘要：「会话管理和 token 验证」）、<code>src/models/User.ts</code>（摘要：「用户数据模型和密码哈希」）。Agent 不仅告诉你在哪里，还能解释它们之间的协作关系。</p><h3 id="13-6-3-影响分析：-understand-diff"><a href="#13-6-3-影响分析：-understand-diff" class="headerlink" title="13.6.3 影响分析：/understand-diff"></a>13.6.3 影响分析：<code>/understand-diff</code></h3><p>改代码前先跑。告诉你在当前 diff 中，你改了哪些文件、每个被改文件影响了哪些下游依赖、哪些影响是「可能破坏」的、哪些是「需要测试」的。这是「在你把改动推出去之前，先让 AI 告诉你这一改会引发什么连锁反应」。</p><h3 id="13-6-4-新人引导：-understand-onboard"><a href="#13-6-4-新人引导：-understand-onboard" class="headerlink" title="13.6.4 新人引导：/understand-onboard"></a>13.6.4 新人引导：<code>/understand-onboard</code></h3><p>自动生成项目上手文档——按依赖顺序，而不是文件名字母顺序。最底层的模块先讲，依赖它们的模块后讲。路径上附 LLM 摘要——「这个文件提供日期格式化、字符串转义和 UUID 生成，被项目中 17 个其他文件调用」。</p><h3 id="13-6-5-业务域提取：-understand-domain"><a href="#13-6-5-业务域提取：-understand-domain" class="headerlink" title="13.6.5 业务域提取：/understand-domain"></a>13.6.5 业务域提取：<code>/understand-domain</code></h3><p>切换到业务视图。代码层的知识图谱展示技术结构——文件、函数、类。<code>/understand-domain</code> 提取业务结构——域、流程、步骤。一个电商项目，技术结构是 <code>src/orders/</code> 目录下的文件。业务结构是「下单流程：购物车验证 → 地址校验 → 库存锁定 → 支付 → 订单确认」。</p><h3 id="13-6-6-知识库分析：-understand-knowledge"><a href="#13-6-6-知识库分析：-understand-knowledge" class="headerlink" title="13.6.6 知识库分析：/understand-knowledge"></a>13.6.6 知识库分析：<code>/understand-knowledge</code></h3><p>Understand-Anything 处理的不仅是代码。它对 Karpathy-pattern LLM Wiki 有专门支持——纯 Markdown 文件 + <code>index.md</code> wikilinks 组织的个人知识库。<code>/understand-knowledge</code> 读取 Wiki 目录，确定性解析器提取 wikilinks 和分类，LLM 发现隐含关系、提取实体，生成力导向图。</p><h3 id="13-6-7-深度解释：-understand-explain"><a href="#13-6-7-深度解释：-understand-explain" class="headerlink" title="13.6.7 深度解释：/understand-explain"></a>13.6.7 深度解释：<code>/understand-explain</code></h3><p>对单个文件或函数做深度分析。「这个函数是做什么的，为什么这样设计，有什么性能考虑，有哪些调用方？」——不是给你代码注释的翻译，是给你这段代码存在的原因。</p><h2 id="13-7-知识图谱的共享与版本控制"><a href="#13-7-知识图谱的共享与版本控制" class="headerlink" title="13.7 知识图谱的共享与版本控制"></a>13.7 知识图谱的共享与版本控制</h2><p>知识图谱产出 JSON 文件——<code>.understand-anything/knowledge-graph.json</code>。因为是 JSON，可以 Git。commit 一次，团队其他人 Clone 后直接拿到图，不需要重跑分析流水线。</p><p><code>.gitignore</code> 按以下规则配置：</p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br></pre></td><td class="code"><pre><span class="line">.understand-anything/intermediate/ ← 中间文件，不提交</span><br><span class="line">.understand-anything/diff-overlay.json ← 本地临时文件，不提交</span><br></pre></td></tr></table></figure><p><code>.understand-anything/</code> 下其余文件全部提交。大型项目（图文件 10MB+）用 Git LFS 管理：</p><figure class="highlight bash"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">git lfs install</span><br><span class="line">git lfs track <span class="string">&quot;.understand-anything/*.json&quot;</span></span><br><span class="line">git add .gitattributes .understand-anything/</span><br></pre></td></tr></table></figure><p>commit 图的成本是一份 JSON 文件。收益是整个团队省掉重复的分析时间。</p><h2 id="13-8-实战：用-Understand-Anything-理解-goscapy"><a href="#13-8-实战：用-Understand-Anything-理解-goscapy" class="headerlink" title="13.8 实战：用 Understand-Anything 理解 goscapy"></a>13.8 实战：用 Understand-Anything 理解 goscapy</h2><p>goscapy 是一个纯 Go 网络协议库，12 个子包，200+ 个 <code>.go</code> 源文件。核心包包括 <code>layers</code>（以太网&#x2F;IP&#x2F;TCP&#x2F;UDP&#x2F;ARP&#x2F;ICMP&#x2F;IPv6&#x2F;ICMPv6&#x2F;NDP 等协议层实现）、<code>packet</code>（数据包序列化&#x2F;反序列化核心接口）、<code>pcap</code>（抓包）、<code>sendrecv</code>（收发）、<code>sniff</code>（嗅探）、<code>route</code>（路由表）、<code>reassembly</code>（TCP 流重组）、<code>arping</code>（ARP 发现）、<code>fields</code>（协议字段注册表）、<code>goscapy</code>（高层快捷 API）。examples&#x2F; 下有 20 个示例程序，覆盖从以太网帧构造到 TCP SYN 扫描的完整场景。</p><p>这种规模的 Go 项目，新人想理解架构，通常要从 <code>go doc</code> 开始，然后逐包读 <code>types.go</code> 找接口定义，再追踪 <code>layers/</code> 里的具体实现。一个下午至少耗掉。</p><p>用 Understand-Anything，几分钟。</p><p><strong>第一步：Claude Code 中安装并运行。</strong></p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br><span class="line">2</span><br><span class="line">3</span><br></pre></td><td class="code"><pre><span class="line">/plugin marketplace add Lum1104/Understand-Anything</span><br><span class="line">/plugin install understand-anything</span><br><span class="line">/understand --language zh</span><br></pre></td></tr></table></figure><p>Agent 做的事：</p><ol><li>Tree-sitter 扫描 <code>pkg/</code> 下所有 <code>.go</code> 文件，30 多个文件分析 Agent 并发提取每个包导出的函数、类型、接口；</li><li><code>architecture-analyzer</code> 识别出 goscapy 的层次结构<ol><li><code>packet/</code> 是核心接口层（<code>Layer</code>、<code>Packet</code>、<code>SerializeBuffer</code>），</li><li><code>layers/</code> 是协议实现层（依赖 <code>packet/</code> 的接口），</li><li><code>pcap/</code>、<code>sendrecv/</code>、<code>sniff/</code> 是 I&#x2F;O 层（依赖 <code>layers/</code> 和 <code>packet/</code>），</li><li><code>goscapy/</code> 是门面层（聚合所有下层能力）。</li></ol></li></ol><p><img src="/images/image-20260601150911572.png"></p><p>分析了将近一小时，分析完成，自动打开网页：</p><p><img src="/images/image-20260601155012187.png"></p><p>总之，眼花缭乱，需要你花点时间熟悉它的界面，以及你能不能从中获取帮助。</p><p><strong>第二步：查构建器链。</strong></p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">/understand-chat goscapy 中一个 TCP SYN 包是怎么构建的？</span><br></pre></td></tr></table></figure><p>Agent 查知识图谱，返回链路：<code>goscapy.NewPacket()</code> → <code>packet.NewPacketInfo()</code> 创建空数据包 → <code>layers.EthernetType.Build()</code> 加 Ethernet 头 → <code>layers.IPv4Type.Build()</code> 加 IP 头 → <code>layers.TCPType.Build()</code> 加 TCP 头（SYN flag）→ <code>packet.Serialize()</code> 序列化为字节流。每个 <code>Build()</code> 调用在知识图谱中用边标注，Agent 知道接口定义在 <code>packet/layer.go:15</code> 的 <code>LayerBuilder</code> 接口，TCP 实现在 <code>layers/tcp.go:200</code> 的 <code>Build()</code> 方法。</p><p>不靠 grep 搜 <code>Build</code>（200 个文件里至少有 40 个匹配）。不靠逐文件跟踪调用链。知识图谱一条边一条边走过。</p><p><img src="/images/image-20260601155809044.png"></p><p><strong>第三步：影响分析。</strong></p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">/understand-diff</span><br></pre></td></tr></table></figure><p>你改动了 <code>packet/layer.go</code> 的 <code>Layer</code> 接口定义（加了新方法）。知识图谱标记影响面：<code>layers/</code> 下所有协议层都实现了这个接口——<code>ethernet.go</code>、<code>ipv4.go</code>、<code>tcp.go</code>、<code>udp.go</code>、<code>arp.go</code>、<code>icmp.go</code>、<code>ipv6.go</code>、<code>icmpv6.go</code>、<code>ndp.go</code>、<code>vlan.go</code>、<code>gre.go</code>，加上 <code>pcap/</code>、<code>sendrecv/</code> 中引用 <code>Layer</code> 类型的函数。12 个文件受影响，需要逐文件补新方法实现。</p><p><strong>第四步：新人上手。</strong></p><figure class="highlight plaintext"><table><tr><td class="gutter"><pre><span class="line">1</span><br></pre></td><td class="code"><pre><span class="line">/understand-onboard</span><br></pre></td></tr></table></figure><p>产出一份按依赖顺序的阅读路径：第一步读 <code>packet/layer.go</code>（核心接口：<code>Layer</code>、<code>Packet</code>、<code>LayerBuilder</code>）→ 第二步读 <code>packet/serialize.go</code>（序列化原理）→ 第三步读 <code>layers/ethernet.go</code>（最简单的协议层实现）→ 第四步读 <code>layers/ipv4.go</code>（理解 options 和 fragmentation 处理）→ 第五步读 <code>layers/tcp.go</code>（理解 flag、checksum、状态机）→ 最后读 <code>goscapy/goscapy.go</code>（高层 API 封装）。每一个节点上都标注了关键的类型定义和核心方法，附 LLM 生成的中文摘要。</p><p>四个步骤，从安装到影响分析到新人阅读路径，200 个文件的 Go 项目全貌几分钟就通了。直接对 Claude Code 说「帮我理解这个项目」，Agent 靠 grep 猜结构。有知识图谱作骨架，是两套完全不同的东西。</p><p><img src="/images/image-20260601160059128.png"></p><h2 id="13-9-支持的语言与本地化"><a href="#13-9-支持的语言与本地化" class="headerlink" title="13.9 支持的语言与本地化"></a>13.9 支持的语言与本地化</h2><p>Tree-sitter 覆盖了主流编程语言——TypeScript、JavaScript、Python、Go、Rust、Java、C、C++、Ruby、PHP、Swift、Kotlin。语言检测自动完成，不需要配置。</p><p><code>/understand --language zh</code> 将输出切换为中文——节点摘要、Dashboard UI 标签、引导式学习路径。支持 <code>en</code>（默认）、<code>zh</code>、<code>zh-TW</code>、<code>ja</code>、<code>ko</code>、<code>ru</code>。</p><p>对中文开发者团队来说，中文知识图谱不仅降低阅读门槛，也让非技术角色（PM、设计师、运营）能读懂代码库的结构。</p><h2 id="13-10-适用边界"><a href="#13-10-适用边界" class="headerlink" title="13.10 适用边界"></a>13.10 适用边界</h2><p>最适合：五人以上的团队项目（知识图谱 commit 后新人上手速度翻倍）、长期维护的代码库（架构演进时可追踪模块间依赖变化）、跨语言项目（Tree-sitter 多语言解析让跨语言依赖关系可追溯）、频繁改动的核心模块（每次 commit 后增量更新，保持知识图谱最新）。</p><p>不适合：个人小项目（&lt; 20 个文件，手动翻比生成知识图谱快）、单文件脚本、极度频繁变更的早期原型（代码结构一天三变，图的维护成本高于收益）。</p><h2 id="13-11-与前后章节的关系"><a href="#13-11-与前后章节的关系" class="headerlink" title="13.11 与前后章节的关系"></a>13.11 与前后章节的关系</h2><p>与第 2 章 Skills：Understand-Anything 本身是 Skill 包——通过 Plugin Marketplace 或 <code>install.sh</code> 安装、注册为 <code>/</code> 命令、Markdown + TypeScript 混合实现。这是 Pocock 的「一个 Markdown 文件定义一种行为」哲学在代码理解领域的体现。</p><p>与第 12 章官方插件：和 code-review、feature-dev 同类——都是通过 <code>/plugin</code> 或 <code>/plugin marketplace</code> 安装的插件。Understand-Anything 填补了官方插件未覆盖的缺口：代码理解。</p><p>与第 3 章 SDD：写增量规格需要知道哪些模块会被影响、哪些行为必须保持。知识图谱能显式回答这两个问题——让规格更有依据。</p><p>与第 5 章 gstack、第 7 章 autoresearch：多 Agent 流水线的架构共享同样的思路——不同 Agent 负责不同维度。Understand-Anything 的 Agent 是功能化分工——<code>project-scanner</code> 扫描、<code>file-analyzer</code> 提取、<code>architecture-analyzer</code> 分层。</p><p>与第 8 章 Goal Workflow：<code>/to-issues</code> 和 <code>/review-it</code> 能从知识图谱中获取代码结构信息，减少 grep + Read 的轮次。Understand-Anything 可以是 Goal Workflow 流水线的一层基础设施。</p><h2 id="13-12-本章小结"><a href="#13-12-本章小结" class="headerlink" title="13.12 本章小结"></a>13.12 本章小结</h2><p>Understand-Anything 是全书唯一聚焦「代码理解」而非「代码生成」的一章。AI 写好代码的前提是理解代码——而理解正是多数 AI 编码工具最薄弱的环节。grep + Read 能走通，但 token 成本高、遗漏概率大、缺乏记忆。</p><p>Understand-Anything 用 Tree-sitter + LLM 混合架构回答了这个问题——确定性的事归 Tree-sitter（imports、exports、调用链、继承），语义的事归 LLM（摘要、标签、架构分层、学习路径）。一次分析产出的 JSON 知识图谱可以 commit 到 Git，全团队共享。Dashboard 给人看，Chat 给 Agent 查，Diff 在改动前预警影响面。</p><p>在 goscapy 这个 200 文件 Go 项目上的实战说明了这个方案的可行性——几分钟内从安装到新人上手路径，覆盖了「这个项目怎么组织」「一个包怎么构建」「改了接口会影响多少文件」三个最常见的代码理解问题。</p><p>下一章讲 UML 在 AI 时代的新用途——当 AI 能生成 UML，当 UML 能反过来教我们理解 AI 生成的代码。</p>