安裝指南

Step 1 — 安裝套件

# 推薦（隔離環境；若之後找不到 graphify 指令，跑 uv tool update-shell）
uv tool install graphifyy

# 替代方案
pipx install graphifyy
pip install graphifyy   # 可能需要設定 PATH

為什麼推薦 uv/pipx 而不是 pip？ skill 會在執行期從 graphify-out/.graphify_python 解析 Python 執行環境；如果那指向的環境跟你 pip 安裝套件的環境不同，會報 ModuleNotFoundError: No module named 'graphify'。uv/pipx 把套件隔離在自己的環境裡，完全避開這個問題。

Step 2 — 註冊 skill

graphify install

預設註冊到 Claude Code。想裝進目前專案（而非使用者設定檔）加 --project：

graphify install --project
graphify install --project --platform codex

PowerShell 使用者：用 graphify . 而不是 /graphify .——開頭的斜線在 PowerShell 是路徑分隔符。

Step 3 — 開你的 AI 助手，輸入

/graphify .

就完成了。會在 graphify-out/ 產生三個檔案：graph.html（瀏覽器可開）、GRAPH_REPORT.md、graph.json。

平台一覽（20+ 助手）

Codex 使用者需在 ~/.codex/config.toml 的 [features] 加 multi_agent = true 才能平行抽取。Codex 用 $graphify 而非 /graphify。

延伸套件（只需要裝你要的）

還有 google / gemini / anthropic / openai / azure / bedrock / sql / postgres / terraform / pascal / dm / svg 等，完整清單見 文件教學 與上游 README。

讓助手「一直用圖」（always-on）

建完圖後執行一次，你的助手之後回答程式碼問題會優先查圖：

graphify opencode install    # 依你的平台調整

機制分兩種：

• Hook 平台（Claude Code、Gemini CLI）：在搜尋類工具呼叫前自動觸發 hook，把助手導向圖。
• 指令檔平台（Codex、OpenCode、Cursor）：寫入 AGENTS.md、.cursor/rules/ 等常駐指令檔，提供同樣的「先查圖」指引。

要一次移除所有平台：graphify uninstall（加 --purge 會連 graphify-out/ 一起刪）。

常見問題

• graphify: command not found → uv/pipx 的 bin 目錄（~/.local/bin）不在 PATH。跑 uv tool update-shell 或 pipx ensurepath 後開新終端。
• uvx graphify … 解析失敗 → 套件叫 graphifyy：用 uvx --from graphifyy graphify install。
• PowerShell 路徑不認 → 用 graphify .（去斜線）。
• 文件/PDF 抽取回傳空 → 文件需要 LLM key（純程式碼不需）。設好 API key 後用 graphify extract ./docs --backend claude（依你用的後端）。
• 版本警告 → 升級後要重新註冊 skill：uv tool upgrade graphifyy 再 graphify install。