Lum1104
12 KiB
Understand Anything
將任意程式碼庫、知識庫或文件轉化為可探索、可搜尋、可對話的互動式知識圖譜
支援 Claude Code、Codex、Cursor、Copilot、Gemini CLI 等多平台。
English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Türkçe
Tip
衷心感謝社群的支持！ Understand-Anything 收到的關注超出了我的預期。如果這個工具能幫你從複雜的資料中理出一點頭緒，少走幾分鐘彎路，那我開發它的初衷就達到了。🚀
當你剛加入一個新團隊，面對 20 萬行程式碼，你從哪裡開始？
Understand Anything 是一個 Claude Code Plugin，透過多智能體（multi-agent）架構分析你的專案，建構包含檔案、函式、類別以及相依關係的知識圖譜，並提供一個視覺化互動介面，幫助你理解整個系統。不再「盲讀程式碼」，而是從全局視角理解系統結構。
寓教於樂的圖表 > 僅為炫技的圖表。
✨ 核心功能
Note
探索程式碼結構圖
將你的程式碼庫以互動式知識圖譜呈現——每個檔案、函式和類別都是可點擊、可搜尋、可探索的節點。選取任意節點即可檢視淺顯易懂的摘要、依賴關係和引導式學習路徑。
理解業務邏輯
切換到領域視圖，查看程式碼如何對應到真實的業務流程——以水平圖的形式展示領域、流程和步驟。
分析知識庫
將 /understand-knowledge 指向一個 Karpathy 模式的 LLM Wiki，即可獲得帶有社群聚類的力導向知識圖譜。確定性解析器從 index.md 中提取 wikilinks 和分類，然後 LLM 代理發現隱式關係、提取實體並挖掘論斷——將你的 wiki 轉化為可導航的互聯思想圖譜。
🧭 引導式學習自動產生架構學習路徑，按相依順序學習。 |
🔍 語意搜尋支援模糊搜尋 + 語意搜尋，例如搜尋「哪些部分處理身分驗證？」即可在整個圖中獲取相關結果。 |
📊 變更影響分析提交變更前，查看變更會影響系統的哪些部分。了解變更對整個程式碼庫的連鎖反應。 |
🎭 使用者角色自適應 UI根據使用者類型（初級開發 / 專案經理 / 進階使用者）調整其詳細程度。 |
🏗️ 層級視覺化按架構層級自動分組 — API、服務、資料、UI、系統工具 — 並附有顏色編碼圖例。 |
📚 語言概念12 種程式設計模式（泛型、閉包、裝飾器等）將在上下文中逐一解釋。 |
🚀 快速開始
1. 安裝外掛程式
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
2. 分析你的程式碼庫
/understand
多智能體（multi-agent）架構會：掃描你的專案，提取函式 / 類別 / 相依關係，建構知識圖譜並儲存至 .understand-anything/knowledge-graph.json。
3. 開啟資料看板
/understand-dashboard
開啟互動式網頁資料看板，你的程式碼庫將以圖表形式呈現 — 按架構層級進行顏色編碼，支援搜尋和點擊。選擇任意節點即可查看其程式碼、關係以及簡明易懂的解釋。
4. 深度使用
# 詢問任意程式碼庫的問題
/understand-chat 付款流程是怎麼運作的？
# 分析目前修改的影響
/understand-diff
# 深入理解某個檔案
/understand-explain src/auth/login.ts
# 為新團隊成員產生指南
/understand-onboard
# 提取業務領域知識（領域、流程、步驟）
/understand-domain
# 分析 Karpathy 模式的 LLM Wiki 知識庫
/understand-knowledge ~/path/to/wiki
🌐 多平台支援
Understand-Anything 可在多個 AI 編碼平台上執行。
Claude Code（原生支援）
/plugin marketplace add Lum1104/Understand-Anything
/plugin install understand-anything
Codex
告訴 Codex：
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.codex/INSTALL.md
OpenCode
告訴 OpenCode：
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.opencode/INSTALL.md
OpenClaw
告訴 OpenClaw：
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.openclaw/INSTALL.md
Cursor
複製此儲存庫後，Cursor 會自動透過 .cursor-plugin/plugin.json 檔案發現外掛程式。無需手動安裝 — 只需複製並在 Cursor 中開啟即可。
VS Code + GitHub Copilot
安裝 GitHub Copilot 擴充功能（v1.108+）後，VS Code 會透過 .copilot-plugin/plugin.json 自動發現外掛程式，複製後直接在 VS Code 中開啟即可，無需手動安裝。
若需要在所有專案中使用（個人技能），告訴 GitHub Copilot：
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.vscode/INSTALL.md
Copilot CLI
copilot plugin install Lum1104/Understand-Anything:understand-anything-plugin
Antigravity
告訴 Antigravity：
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.antigravity/INSTALL.md
Gemini CLI
告訴 Gemini CLI：
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.gemini/INSTALL.md
Pi Agent
告訴 Pi Agent：
Fetch and follow instructions from https://raw.githubusercontent.com/Lum1104/Understand-Anything/refs/heads/main/.pi/INSTALL.md
多平台相容性
| 平台 | 狀態 | 安裝方式 |
|---|---|---|
| Claude Code | ✅ 原生 | 外掛程式市集 |
| Codex | ✅ 支援 | AI 驅動安裝 |
| OpenCode | ✅ 支援 | AI 驅動安裝 |
| OpenClaw | ✅ 支援 | AI 驅動安裝 |
| Cursor | ✅ 支援 | 自動發現 |
| VS Code + GitHub Copilot | ✅ 支援 | 自動發現 |
| Copilot CLI | ✅ 支援 | 外掛程式安裝 |
| Antigravity | ✅ 支援 | AI 驅動安裝 |
| Gemini CLI | ✅ 支援 | AI 驅動安裝 |
| Pi Agent | ✅ 支援 | AI 驅動安裝 |
📦 與團隊共享知識圖譜
圖譜就是一份 JSON 檔案——提交一次，團隊成員就可以跳過整條流水線。適合新人上手、PR 審查和 docs-as-code 工作流程。
範例： GoogleCloudPlatform/microservices-demo（fork） —— 包含已提交圖譜的 Go / Java / Python / Node 多語言參考專案。
需要提交的內容： .understand-anything/ 底下的全部檔案，除了 intermediate/ 與 diff-overlay.json（這些是本機暫存檔）。
.understand-anything/intermediate/
.understand-anything/diff-overlay.json
保持最新： 啟用 /understand --auto-update —— 一個 post-commit 掛鉤會增量更新圖譜，讓每次提交都有對應的圖譜版本。也可以在發布前手動重跑 /understand。
大型圖譜（10 MB 以上）： 使用 git-lfs 追蹤。
git lfs install
git lfs track ".understand-anything/*.json"
git add .gitattributes .understand-anything/
🔧 技術原理
多智能體架構
/understand 指令呼叫 5 個 agent，/understand-domain 額外增加第 6 個：
| Agent | 職責 |
|---|---|
project-scanner |
掃描專案檔案，偵測語言和框架 |
file-analyzer |
提取程式碼結構（函式、類別和匯入），產生圖節點和邊 |
architecture-analyzer |
識別架構層 |
tour-builder |
產生引導式學習路徑 |
graph-reviewer |
驗證圖的完整性和參考完整性 |
domain-analyzer |
提取業務領域、流程和處理步驟（由 /understand-domain 使用） |
article-analyzer |
從 wiki 文章中提取實體、論斷和隱式關係（由 /understand-knowledge 使用） |
檔案分析器並行執行（最多 3 個並發）。支援增量更新 — 僅重新分析自上次執行以來發生變更的檔案。
🤝 貢獻
歡迎貢獻！以下是貢獻指南：
- Fork 專案
- 新建分支（
git checkout -b feature/my-feature） - 執行測試（
pnpm --filter @understand-anything/core test） - 提交變更並建立 PR
對於重大變更，請先提交 issue，以便我們討論解決方案。
不再盲讀程式碼，而是理解整個系統
Star 歷史記錄
MIT 授權條款 © Lum1104