Criterion

🚀 Criterion - 伊斯蘭知識助手

Criterion 是一款由人工智能驅動的伊斯蘭知識助手，為全球的求知者提供真實可靠的伊斯蘭指導。它基於《古蘭經》和可靠的聖訓構建，並且永久免費，旨在為全人類提供神聖的指引。

🚀 快速開始

前提條件

• Node.js 18 及以上版本和 pnpm
• PostgreSQL 數據庫（推薦 Neon）
• API 密鑰：
  • XAI API 密鑰（用於 Grok LLM）
  • Google AI Studio API 密鑰（用於嵌入）

安裝步驟

1. 克隆倉庫

git clone <repo-url>
cd criterion

2. 安裝依賴

pnpm install

3. 設置環境變量 創建一個 .env.local 文件：

# 數據庫
POSTGRES_URL=postgresql://...

# AI API
XAI_API_KEY=xai-...
GOOGLE_GENERATIVE_AI_API_KEY=...

# 認證（可選）
AUTH_SECRET=...

4. 啟用 pgvector 擴展

pnpm db:enable-pgvector

5. 運行數據庫遷移

pnpm db:migrate

6. 導入《古蘭經》數據（為 6236 節經文生成嵌入）

pnpm ingest:quran

這將需要 10 - 15 分鐘才能完成。 7. 測試《古蘭經》搜索

pnpm test:quran

8. 啟動開發服務器

pnpm dev

應用程序現在應該在 localhost:3000 上運行。

可用命令

開發

pnpm dev          # 啟動開發服務器
pnpm build        # 為生產環境構建
pnpm start        # 啟動生產服務器

數據庫

pnpm db:generate  # 生成 Drizzle 模式
pnpm db:migrate   # 運行遷移
pnpm db:studio    # 打開 Drizzle Studio（圖形界面）

數據導入與測試

# 《古蘭經》
pnpm clear:quran         # 清除所有《古蘭經》數據
pnpm ingest:quran        # 導入《古蘭經》經文並生成嵌入
pnpm ingest:quran:slovak # 導入斯洛伐克語翻譯
pnpm test:quran          # 測試《古蘭經》搜索功能

# 聖訓
pnpm clear:hadith  # 清除所有聖訓數據
pnpm ingest:hadith # 導入聖訓並生成嵌入

✨ 主要特性

核心功能

✅ 語義《古蘭經》搜索 — 以自然語言提問，獲取相關經文
✅ 語義聖訓搜索 — 搜索可靠聖訓，並可按等級和集合進行篩選
✅ 上下文理解 — 搜索結果包含上下文，便於理解
✅ 準確引用 — 每個回覆都引用真實來源並提供超鏈接
✅ 多語言閱讀 — 支持英語（快速）和斯洛伐克語（可擴展到 10 多種語言）
✅ 可分享的 URL — 如 /quran/search?q=patience、/hadith/search?q=charity 和 /quran/2/255 等，並帶有元數據
✅ 即時流式傳輸 — 逐令牌生成漸進式響應
✅ 基於工具的 RAG — 大語言模型自主決定何時從《古蘭經》/聖訓中檢索信息

技術優勢

• 🎯 語義搜索 — 自然語言查詢可從 6236 節《古蘭經》經文和 21641 條聖訓敘述中返回相關內容
• 📖 上下文檢索 — 搜索結果包含前後各 2 節經文/敘述，提供完整上下文
• 🌐 多語言支持 — 支持英語（快速）和斯洛伐克語（可擴展到 10 多種語言）
• 🔗 準確引用 — 所有回覆均包含帶有超鏈接的來源參考（Quran.com、Sunnah.com）
• ⚡ 快速響應 — 查詢響應時間小於 150 毫秒

關鍵差異化特點

使命導向

• ✨ 永久免費 — 無付費牆、無廣告、無盈利目的，只為真主而建
• 📚 聚焦基礎 — 避免教派爭論，專注於普遍接受的伊斯蘭教義
• 🛡️ 信任優先 — 採用等級過濾的可靠聖訓（默認使用可靠聖訓），僅使用經過驗證的來源
• 🤝 面向求知者 — 專為好奇的心靈、新穆斯林和知識學習者設計
• 🕌 傳教士風格 — 提供富有同情心、知識淵博且謙遜的指導

技術卓越

• 🎯 語義搜索 — 自然語言查詢可從 6236 節《古蘭經》經文和 21641 條聖訓敘述中返回相關內容
• 📖 上下文檢索 — 搜索結果包含前後各 2 節經文/敘述，提供完整上下文
• 🌐 多語言支持 — 支持英語（快速）和斯洛伐克語（可擴展到 10 多種語言）
• 🔗 準確引用 — 所有回覆均包含帶有超鏈接的來源參考（Quran.com、Sunnah.com）
• ⚡ 快速響應 — 查詢響應時間小於 150 毫秒

📦 安裝指南

前提條件

• Node.js 18 及以上版本和 pnpm
• PostgreSQL 數據庫（推薦 Neon）
• API 密鑰：
  • XAI API 密鑰（用於 Grok LLM）
  • Google AI Studio API 密鑰（用於嵌入）

安裝步驟

1. 克隆倉庫

git clone <repo-url>
cd criterion

2. 安裝依賴

pnpm install

3. 設置環境變量 創建一個 .env.local 文件：

# 數據庫
POSTGRES_URL=postgresql://...

# AI API
XAI_API_KEY=xai-...
GOOGLE_GENERATIVE_AI_API_KEY=...

# 認證（可選）
AUTH_SECRET=...

4. 啟用 pgvector 擴展

pnpm db:enable-pgvector

5. 運行數據庫遷移

pnpm db:migrate

6. 導入《古蘭經》數據（為 6236 節經文生成嵌入）

pnpm ingest:quran

這將需要 10 - 15 分鐘才能完成。 7. 測試《古蘭經》搜索

pnpm test:quran

8. 啟動開發服務器

pnpm dev

應用程序現在應該在 localhost:3000 上運行。

💻 使用示例

基礎用法

以下是一個簡單的《古蘭經》搜索示例：

pnpm test:quran

高級用法

你可以使用 MCP 服務器進行搜索，以下是一個快速設置示例：

{
  "mcpServers": {
    "criterion": {
      "url": "https://criterion.life/api/mcp"
    }
  }
}

可用工具：

• search_quran — 搜索 6236 節《古蘭經》經文
• search_hadith — 搜索 21641 條來自 6 個集合的可靠聖訓
• get_verse — 根據引用檢索特定經文（例如，"2:255"）

📚 詳細文檔

瞭解 Criterion

• MISSION.md — 我們的願景、價值觀和深層目標。建議先閱讀此文檔，以瞭解我們構建 Criterion 的原因。
• CRITERION_DETAILED.md — 全面的技術文檔，包括架構、實現歷史和性能指標。
• CRITERION.md — 快速參考指南，涵蓋設置和關鍵概念。

關鍵文檔說明

🔧 技術細節

RAG 管道

用戶問題
    ↓
XAI Grok 4 大語言模型（決定使用哪些工具）
    ↓
工具選擇：
  - queryQuran → 6236 節經文（聊天時取前 7 節，搜索時取前 20 節）
  - queryHadith → 21641 條來自 6 個集合的聖訓（聊天時取前 3 條，搜索時取前 15 條，可按等級過濾）
    ↓
向量搜索（768 維 Gemini 嵌入）
    ↓
上下文增強（前 3 條結果包含前後各 2 節經文/敘述）
    ↓
大語言模型生成帶引用的響應
    ↓
即時流式傳輸給用戶（服務器發送事件）

數據

• 6236 節《古蘭經》經文 來自所有 114 章
  • 阿拉伯語文本（Tanzil 古蘭經）
  • 英語翻譯（主版本）
  • 斯洛伐克語翻譯（可擴展）
  • 768 維嵌入（Gemini text-embedding-004）
• 21641 條聖訓敘述 來自 6 個主要集合（Kutub al-Sittah 子集）
  • 布哈里聖訓集（7558 條）
  • 穆斯林聖訓集（2920 條）
  • 提爾密濟聖訓集（3951 條）
  • 艾布·達烏德聖訓集（5274 條）
  • 納瓦維 40 聖訓（42 條）
  • 利雅得聖訓集（1896 條）
  • 等級過濾（可靠、良好、薄弱）
  • 768 維嵌入

性能

• 《古蘭經》搜索：<150 毫秒（英語），<200 毫秒（翻譯）
• 聖訓搜索：<150 毫秒
• 向量搜索：由 HNSW 索引提供支持
• 流式傳輸：即時逐令牌傳輸

📄 許可證

• 《古蘭經》文本：知識共享署名 3.0 許可協議（Tanzil.net）
• 聖訓數據：來自經過驗證的伊斯蘭來源，並進行了適當的引用
• 代碼：詳情請參閱 LICENSE 文件

“你應憑智慧和善言而勸人遵循主道，你應當以最優美的態度與人辯論。” — 《古蘭經》16:125

願真主接受這項工作，並使其成為各地求知者的指引。阿敏。