Graphify 是什麼、怎麼安裝使用：把代碼庫變成可查詢知識圖譜的 /graphify Skill（Claude Code / Cursor / Codex）

本文根據 Graphify-Labs/graphify 倉庫 README、官方文檔站 docs.graphify.com 與 Claude Code 官方文檔整理，資料核對於 2026-10-10。支持的平台和命令更新頻繁，以倉庫 README 為準。

是什麼

Graphify 是一個把項目「畫成圖」的工具，由一個 Python 命令行程序和一個 /graphify 技能組成。智能體了解陌生代碼庫的常規做法是反覆搜尋、逐個讀文件，既慢又費上下文。Graphify 的思路是先把整個項目解析成一張知識圖譜——函數、類、模組、文檔裏的概念是節點，調用、導入、繼承、引用是邊——之後有問題就查圖：這兩個東西之間怎麼連起來的、某個概念牽涉哪些文件、哪些節點是所有流程都要經過的樞紐。

README 強調三點：代碼部分用 tree-sitter 語法樹在本地確定性解析，不經過大模型，內容不離開本機；每條邊都標註是從源碼裏直接讀到的（EXTRACTED）還是推斷出來的（INFERRED）；它不是向量索引，沒有嵌入和向量庫，是一張真正可以遍歷的圖。

截至 2026-10-10，GitHub 顯示該倉庫約 12.5 萬 Star、1.2 萬 Fork，最近一次推送在 2026-10-10。倉庫提供簡體中文版 README。

包含哪些 Skill

核心是一個技能 graphify（Codex 裏寫作 $graphify），配合同名命令行工具。跑一次會在 graphify-out/ 下生成三個文件：

• graph.html：可在瀏覽器裏點擊、篩選、搜尋的交互圖；
• GRAPH_REPORT.md：要點報告——連接最多的「樞紐節點」、跨模組的意外關聯、代碼註釋和設計文檔裏的「為什麼」、建議你問的幾個問題；
• graph.json：完整圖數據，之後隨時查詢，不用重讀文件。

README 列出的能力還有：

• 社區劃分：把圖自動分成若干子系統；
• 跨文件關係：調用、導入、繼承等關係，覆蓋約 40 種語言；
• 查詢、路徑、解釋：query 提問，path 找兩個節點之間的路徑，explain 解釋一個概念；
• 代碼以外的資料：文檔、PDF、圖片、音影片也能併入同一張圖（這部分需要模型參與）；
• 增量與自動更新：只重新解析改動的文件，或裝 Git 鉤子在提交後自動重建；
• MCP 伺服器：把圖暴露為 MCP 服務，供智能體反覆調用。

怎麼安裝

前置條件：Python 3.10 及以上，README 推薦用 uv。

bash
uv tool install graphifyy      # install the CLI (or: pipx install graphifyy)
graphify install               # register the skill with your AI assistant

注意 PyPI 上的官方包名是 graphifyy（兩個 y），README 特別聲明其他 graphify* 包與項目無關；裝好後的命令仍然叫 graphify。

graphify install 預設面向 Claude Code。其他工具用對應參數，例如 graphify install --platform codex、graphify install --platform gemini、graphify cursor install、graphify install --platform trae-cn；想裝到通用的 ~/.agents/skills/ 用 graphify install --platform agents。加 --project 則只裝到當前倉庫（如 .claude/skills/graphify/SKILL.md）。

README 建議在 Mac 和 Windows 上盡量不要用普通的 pip install，容易出現找不到模組的環境問題。

怎麼用

在智能體裏輸入：

text
/graphify .

為當前目錄建圖。在 PowerShell 裏直接運行命令行時寫 graphify .，不要帶開頭的斜槓。建好之後常用的有：

• /graphify query "what connects auth to the database?" 提問；
• /graphify path "UserService" "DatabasePool" 找兩者之間的路徑；
• /graphify explain "RateLimiter" 解釋一個概念；
• /graphify ./docs --update 只重新處理有改動的文件；
• /graphify . --wiki 從圖生成一套 Markdown 維基。

想讓智能體以後預設先查圖再讀文件，在項目裏運行一次對應平台的命令（Claude Code 是 graphify claude install，Codex 是 graphify codex install）。不想被索引的文件寫進 .graphifyignore。

適合誰 / 不適合誰

適合：

• 接手大型或陌生代碼庫，需要快速摸清模組關係的開發者；
• 覺得智能體在大倉庫裏反覆搜尋太耗上下文的重度用戶；
• 想把代碼、設計文檔、論文放在一起建立關聯的團隊。

不適合：

• 幾百行的小項目——直接讀文件更快；
• 不想在本機安裝 Python 工具的用戶；
• 需要百分之百精確調用關係的場合——推斷出的邊帶有不確定性，README 也為此做了標註，重要結論要回到源碼確認。

注意事項

• 許可證：倉庫 LICENSE 為 Apache-2.0。官方另有付費的 graphify 平台和企業版，與這個開源工具是兩回事。
• 維護狀態：更新非常活躍，最近一次推送 2026-10-10。
• 安全提醒：這不只是一份說明文件——它會在本機安裝並運行 Python 程序，往項目裏寫 graphify-out/ 和技能文件；讓智能體「始終使用圖」的安裝步驟會寫入各平台的指令文件，在 Claude Code 等平台上還會裝 hook（嚴格模式下會攔截會話裏第一次直接讀源碼的操作）；graphify hook install 會裝 Git 鉤子；另可啟動 MCP 伺服器或對團隊開放的 HTTP 服務。逐項確認自己需要再開啟，並通讀 SKILL.md。
• 哪些數據會離開本機：代碼解析和音影片轉寫在本地完成；文檔、PDF、圖片的語義提取會發給你當前會話所用的模型，或者在無頭模式下按已配置的 API Key 發給對應服務商。README 提醒有數據駐留要求時顯式指定後端，例如用本地的 Ollama。README 稱項目沒有遙測，但查詢記錄會寫入本機的 ~/.cache/graphify-queries.log，可用 GRAPHIFY_QUERY_LOG_DISABLE=1 關閉。
• 兼容性：Codex 要並行提取需在 ~/.codex/config.toml 的 [features] 下設定 multi_agent = true；部分語言和文件類型需要安裝額外的可選依賴。
• graphify-out/ 是否提交進倉庫由團隊自己決定，README 的團隊協作一節有建議做法。