簡介

本 Harness 驗證 Graphify 的安裝與配置是否正確，並確保基本工具可以正常運作。

驗證步驟

第一步：檢查 Graphify 版本

graphify --version

預期輸出：

Graphify v1.0.0

若未安裝，請執行：

npm install -g @graphify/cli
# 或
pip install graphify-cli

第二步：驗證圖譜後端

# 使用內建後端（開發用）
graphify init --backend=builtin

# 或使用 Neo4j（生產用）
graphify init --backend=neo4j --uri="bolt://localhost:7687"

預期輸出：

✓ 建立目錄：.graphify/
✓ 建立配置：graphify.config.yaml
✓ 專案初始化完成！

第三步：驗證 LLM 連線

# 設定 API 金鑰
export OPENAI_API_KEY="your-api-key"

# 或使用 Anthropic
export ANTHROPIC_API_KEY="your-api-key"

# 測試連線
graphify test-llm

預期輸出：

✓ LLM 連線成功
✓ 模型：gpt-4
✓ 回應時間：< 1s

第四步：執行基本提取

# 建立測試文件
echo "Graphify 是一個知識圖譜工具" > test.txt

# 提取測試
graphify extract test.txt

預期輸出：

正在從 test.txt 提取知識...

提取摘要：
- 實體：2 個
- 關係：1 個

✓ 知識已加入圖譜！

第五步：執行查詢測試

graphify query "圖譜中有哪些實體？"

預期輸出：

根據圖譜查詢結果：
1. Graphify - Project
2. 知識圖譜工具 - Concept

共 2 個實體。

驗證清單

故障排除

❌ 問題：Graphify 未安裝

解決方案：

# 使用 npm
npm install -g @graphify/cli

# 或使用 pip
pip install graphify-cli

# 或使用 Homebrew（macOS）
brew install graphify

❌ 問題：Neo4j 連線失敗

解決方案：

# 確認 Neo4j 正在運行
neo4j start

# 或使用 Docker
docker run -d -p 7687:7687 -p 7474:7474 neo4j:latest

# 或使用內建後端
graphify init --backend=builtin

❌ 問題：LLM API 金鑰無效

解決方案：

# 確認 API 金鑰已設定
echo $OPENAI_API_KEY
echo $ANTHROPIC_API_KEY

# 重新設定
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."

❌ 問題：提取返回 0 實體

可能原因：

• 測試文件內容過少
• LLM 無法理解內容

解決方案：

# 使用更豐富的測試內容
echo "張三是 Graphify 專案的負責人，使用 Neo4j 作為圖譜資料庫" > test.txt
graphify extract test.txt

結論

若所有 5 項測試均通過 🟢，則 Graphify 安裝驗證成功，可以開始進行正式提取。若有任何 🔴 失敗，應先排查相關問題再進行後續操作。

下一步

安裝驗證成功後，可以：

1. 執行 graphify extract <file> 開始提取知識
2. 執行 graphify query "問題" 查詢圖譜
3. 執行 graphify visualize 生成視覺化

進階驗證

驗證 Neo4j 生產環境

# 使用 Neo4j Aura（雲端）
graphify init --backend=neo4j --uri="bolt://neo4j-aura.databases.com:7687"

# 測試連線
graphify test-connection

驗證批次提取

# 建立多個測試文件
echo "文件一內容" > test1.txt
echo "文件二內容" > test2.txt

# 批次提取
graphify extract --batch=file-list.txt

驗證視覺化

# 生成視覺化
graphify visualize --output=test.html

# 檢查檔案是否存在
ls test.html