適用情境

快速入門工作流 是 Graphify 中最基礎、最快速的流程。它非常適合：

• 初次接觸 Graphify 的使用者
• 想要快速驗證概念的場景
• 小型知識提取任務（單一文件或少量文件）

此流程讓你在 5 分鐘內體驗完整的知識圖譜建立流程。

核心步驟

第 1 步：初始化專案

graphify init --backend=builtin

這會建立 .graphify/ 目錄和配置檔案，使用內建輕量級圖譜後端（無需安裝 Neo4j）。

第 2 步：提取知識

graphify extract README.md

從你的第一份文件中提取實體與關係。Graphify 會：

• 讀取文件內容
• 使用 LLM 識別實體（人員、專案、技術等）
• 建立實體之間的關係
• 將結果存入圖譜

第 3 步：視覺化結果

graphify visualize

生成互動式的圖譜視覺化，在瀏覽器中打開 graph.html 即可查看。

完整範例

以下是從零開始建立知識圖譜的完整對話：

── 初始化 ──

• You:

  graphify init

• AI:

  正在初始化 Graphify 專案…

  ✓ 建立目錄：.graphify/ ✓ 建立配置：graphify.config.yaml

  預設配置：

  • 圖譜後端：內建輕量級後端
  • LLM 提供者：OpenAI (gpt-4)

  ✓ 專案初始化完成！

── 提取 ──

• You:

  graphify extract README.md

• AI:

  正在從 README.md 提取知識…

  提取摘要：

  • 實體：15 個
  • 關係：22 個

  識別的實體：

  • Person: 張三、李四、王五
  • Project: Graphify、Superpowers
  • Technology: LLM、Neo4j、React

  ✓ 知識已成功加入圖譜！

── 視覺化 ──

• You:

  graphify visualize

• AI:

  正在生成視覺化…

  圖譜統計：

  • 節點數：15
  • 關係數：22

  ✓ 視覺化已生成：graph.html

  在瀏覽器中打開 graph.html 即可查看互動式視覺化！

優勢與限制

優勢

限制

何時升級到其他工作流？

當你遇到以下情況時，考慮升級：

1. 圖譜規模增大 → 升級到增量提取工作流
2. 需要生產級後端 → 升級到完整開發工作流
3. 需要驗證結果 → 加入 graphify query 步驟

組合使用

加入查詢步驟

# 1. 初始化
graphify init

# 2. 提取
graphify extract README.md

# 3. 查詢驗證
graphify query "README 中提到了哪些專案？"

# 4. 視覺化
graphify visualize

批量提取

# 1. 初始化
graphify init

# 2. 批量提取
graphify extract docs/*.md

# 3. 視覺化
graphify visualize

時間估計

常見問題

Q：提取後沒有結果？

A：檢查：

1. 文件內容是否包含實體與關係
2. LLM API 金鑰是否正確
3. 使用 --verbose 查看詳細日誌

Q：視覺化很亂？

A：嘗試：

1. 使用不同的佈局（--layout=hierarchical）
2. 過濾特定關係（--filter）
3. 只視覺化子圖（--focus）

快速入門工作流是體驗 Graphify 的最佳起點，完成後你就可以探索更進階的功能了！