深入理解任何事物

將任何代碼庫、知識庫或文檔轉(zhuǎn)化為可交互的知識圖譜，讓你隨時探索、搜索和提問。 兼容 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等工具。

English | 簡體中文 | 繁體中文 | 日本語 | ??? | Espa?ol | Türk?e | Русский

?? 加入 Discord 社區(qū) → 提問、分享你的作品，與社區(qū)成員互相交流。

你剛加入一個新團(tuán)隊，代碼庫有 200,000 行代碼，你該從哪里下手？

Understand Anything 是一款 Claude Code 插件，它通過多 Agent 流水線分析你的項目，為每個文件、函數(shù)、類和依賴項構(gòu)建知識圖譜，并提供一個可視化的交互式儀表板供你全面探索。告別盲目讀代碼，開始掌握全局視野。

我們的目標(biāo)不是用復(fù)雜的圖譜讓你嘆為觀止，而是用一張圖悄悄告訴你每一個模塊是如何環(huán)環(huán)相扣的。

? 功能特性

Note

不想看文字介紹？ 直接體驗首頁上的在線演示 —— 一個完全交互式的儀表板，可以在瀏覽器中直接平移、縮放、搜索和探索。

探索結(jié)構(gòu)圖譜

以交互式知識圖譜的形式瀏覽你的代碼庫——每個文件、函數(shù)和類都是一個節(jié)點(diǎn)，可以點(diǎn)擊、搜索和探索。選擇任意節(jié)點(diǎn)，即可查看通俗易懂的摘要、關(guān)聯(lián)關(guān)系以及引導(dǎo)式瀏覽。

理解業(yè)務(wù)邏輯

切換到領(lǐng)域視圖，看看你的代碼如何映射到真實的業(yè)務(wù)流程——領(lǐng)域、流程和步驟以橫向圖譜的形式清晰呈現(xiàn)。

分析知識庫

將 /understand-knowledge 指向一個 Karpathy 風(fēng)格的 LLM wiki，即可獲得一張帶有社區(qū)聚類的力導(dǎo)向知識圖譜。確定性解析器從 index.md 中提取 wikilink 和分類，LLM Agent 則進(jìn)一步發(fā)現(xiàn)隱式關(guān)系、提取實體并浮現(xiàn)論斷——將你的 wiki 轉(zhuǎn)化為一張由相互關(guān)聯(lián)的思想構(gòu)成的可導(dǎo)航圖譜。

| ### ?? 引導(dǎo)式瀏覽 自動生成按依賴順序排列的架構(gòu)瀏覽路徑，幫助你以正確的順序理解代碼庫。 | ### ?? 模糊搜索與語義搜索 按名稱或語義查找任何內(nèi)容。搜索"哪些部分負(fù)責(zé)身份驗證？"即可獲取圖譜中的相關(guān)結(jié)果。 |

| ### ?? Diff 影響分析 在提交之前，提前了解你的改動會影響系統(tǒng)的哪些部分，掌握變更在整個代碼庫中的連鎖效應(yīng)。 | ### ?? 角色自適應(yīng) UI 儀表板根據(jù)你的角色——初級開發(fā)者、產(chǎn)品經(jīng)理或高級用戶——自動調(diào)整信息的詳細(xì)程度。 |

| ### ??? 分層可視化 按架構(gòu)層次自動分組——API、Service、Data、UI、Utility——并配有顏色編碼的圖例。 | ### ?? 編程語言概念 在代碼出現(xiàn)的上下文中，結(jié)合實際場景講解 12 種編程模式（泛型、閉包、裝飾器等）。 |

?? 快速開始

1. 安裝插件

/plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything

2. 分析你的代碼庫

/understand

多 Agent 流水線會掃描你的項目，提取每個文件、函數(shù)、類和依賴項，然后將構(gòu)建好的知識圖譜保存到 .understand-anything/knowledge-graph.json。

本地化輸出： 使用 --language 以你偏好的語言生成內(nèi)容：

# Generate Chinese content (知識圖節(jié)點(diǎn)描述和 Dashboard UI) /understand --language zh # Supported languages: en (default), zh, zh-TW, ja, ko, ru

--language 參數(shù)會影響以下內(nèi)容：

• 知識圖譜中節(jié)點(diǎn)的摘要和描述

• 儀表板 UI 的標(biāo)簽、按鈕和提示文本

• 引導(dǎo)式瀏覽的說明文字

3. 探索儀表板

/understand-dashboard

一個交互式 Web 儀表板將會打開，以圖譜形式可視化你的代碼庫——按架構(gòu)層次進(jìn)行顏色編碼，支持搜索和點(diǎn)擊交互。選擇任意節(jié)點(diǎn)，即可查看其代碼、關(guān)聯(lián)關(guān)系以及通俗易懂的解釋。

4. 持續(xù)學(xué)習(xí)

# Ask anything about the codebase /understand-chat How does the payment flow work ? # Analyze impact of your current changes /understand-diff # Deep-dive into a specific file or function /understand-explain src/auth/login.ts # Generate an onboarding guide for new team members /understand-onboard # Extract business domain knowledge (domains, flows, steps) /understand-domain # Analyze a Karpathy-pattern LLM wiki knowledge base /understand-knowledge ~ /path/to/wiki

?? 多平臺安裝

Understand-Anything 支持多種 AI 編程平臺。

Claude Code（原生支持）

/plugin marketplace add Lum1104/Understand-Anything /plugin install understand-anything

一鍵安裝（Codex / OpenCode / OpenClaw / Antigravity / Gemini CLI / Pi Agent / Vibe CLI / VS Code Copilot / Hermes / Cline / KIMI CLI）

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash # or skip the prompt by passing the platform: curl -fsSL https://raw.githubusercontent.com/Lum1104/Understand-Anything/main/install.sh | bash -s codex

Windows（PowerShell）：

iwr - useb https: // raw.githubusercontent.com / Lum1104 / Understand - Anything / main / install.ps1 | iex

安裝程序會將倉庫克隆到 ~/.understand-anything/repo，并為所選平臺創(chuàng)建相應(yīng)的符號鏈接。安裝后請重啟你的 CLI/IDE。

• 支持的 值：gemini、codex、opencode、pi、openclaw、antigravity、vibe、vscode、hermes、cline、kimi

• 后續(xù)更新：./install.sh --update

• 卸載：./install.sh --uninstall

Cursor

克隆本倉庫后，Cursor 會通過 .cursor-plugin/plugin.json 自動發(fā)現(xiàn)插件，無需手動安裝——克隆后直接在 Cursor 中打開即可。

VS Code + GitHub Copilot

安裝了 GitHub Copilot（v1.108+）的 VS Code 在克隆本倉庫后，會通過 .copilot-plugin/plugin.json 自動發(fā)現(xiàn)插件，無需手動安裝——克隆后直接在 VS Code 中打開即可。

如需個人技能（可跨所有項目使用），請使用 vscode 平臺運(yùn)行上方的 install.sh 命令。

Copilot CLI

copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin

平臺兼容性

| 平臺 | 狀態(tài) | 安裝方式 |

| Claude Code | ? 原生支持 | 插件市場 |

| Cursor | ? 已支持 | 自動發(fā)現(xiàn) |

| VS Code + GitHub Copilot | ? 已支持 | 自動發(fā)現(xiàn) |

| Copilot CLI | ? 已支持 | 插件安裝 |

| Codex | ? 已支持 | install.sh codex |

| OpenCode | ? 已支持 | install.sh opencode |

| OpenClaw | ? 已支持 | install.sh openclaw |

| Antigravity | ? 已支持 | install.sh antigravity |

| Gemini CLI | ? 已支持 | install.sh gemini |

| Pi Agent | ? 已支持 | install.sh pi |

| Vibe CLI | ? 已支持 | install.sh vibe |

| Hermes | ? 已支持 | install.sh hermes |

| Cline | ? 已支持 | install.sh cline |

| KIMI CLI | ? 已支持 | install.sh kimi |

?? 與團(tuán)隊共享圖譜

圖譜本質(zhì)上只是 JSON 文件——提交一次，團(tuán)隊成員即可跳過流水線分析步驟。非常適合新人入職、PR 評審和文檔即代碼的場景。

示例： GoogleCloudPlatform/microservices-demo（fork） —— 一個包含已提交圖譜的 Go / Java / Python / Node 參考項目。

建議提交的內(nèi)容： .understand-anything/ 中的所有內(nèi)容，除了 intermediate/ 和 diff-overlay.json（這兩個是本地臨時文件）。

.understand-anything / intermediate / .understand-anything / diff-overlay.json

保持圖譜更新： 啟用 /understand --auto-update —— 這是一個 post-commit 鉤子，每次提交后會增量更新圖譜，確保每次提交都附帶最新的圖譜?；蛘咴诎l(fā)布前手動重新運(yùn)行 /understand。

大型圖譜（10 MB 以上）： 使用 git-lfs 進(jìn)行追蹤。

git lfs install git lfs track " .understand-anything/*.json " git add .gitattributes .understand-anything/

?? 底層原理

多 Agent 流水線

/understand 命令協(xié)調(diào) 5 個專屬 Agent，/understand-domain 則額外增加一個：

| Agent | 職責(zé) |

| project-scanner | 發(fā)現(xiàn)文件，檢測編程語言和框架 |

| file-analyzer | 提取函數(shù)、類、導(dǎo)入關(guān)系；生成圖譜節(jié)點(diǎn)和邊 |

| architecture-analyzer | 識別架構(gòu)層次 |

| tour-builder | 生成引導(dǎo)式學(xué)習(xí)路徑 |

| graph-reviewer | 驗證圖譜的完整性和引用一致性（默認(rèn)內(nèi)聯(lián)運(yùn)行；使用 --review 可進(jìn)行完整 LLM 審查） |

| domain-analyzer | 提取業(yè)務(wù)領(lǐng)域、流程和處理步驟（供 /understand-domain 使用） |

| article-analyzer | 從 wiki 文章中提取實體、論斷和隱式關(guān)系（供 /understand-knowledge 使用） |

文件分析器并行運(yùn)行（最多 5 個并發(fā)，每批 20-30 個文件），支持增量更新——僅重新分析自上次運(yùn)行以來發(fā)生變化的文件。

?? 社區(qū)

由 Better Stack 制作的社區(qū)演示視頻。

在 YouTube 上觀看 →

制作了視頻、博客或教程？歡迎提 Issue 或 PR，我們很樂意在此展示。

?? 參與貢獻(xiàn)

歡迎貢獻(xiàn)！以下是參與方式：

• Fork 本倉庫

• 創(chuàng)建功能分支（git checkout -b feature/my-feature）

• 運(yùn)行測試（pnpm --filter @understand-anything/core test）

• 提交更改并發(fā)起 Pull Request

重大變更請先提 Issue，以便我們提前討論實現(xiàn)方案。

告別盲目讀代碼，開始真正理解一切。

Star 歷史

感謝每一位使用和貢獻(xiàn)的人——知道這個項目能幫大家節(jié)省時間，是它值得被構(gòu)建出來的意義所在。

MIT License ? Lum1104