[!NOTE] 此 README 由 SKILL 生成，英文版請參閱 這裡。

A READ-ONLY RAG DATABASE SERVICE — DROP FILES, SEARCH INSTANTLY

Go RAG 資料庫服務，具備關鍵字與語意雙重搜尋、檔案系統監控自動索引，以及 OpenAI embedding 向量快取

目錄

• 功能特點
• 架構
• 授權
• Author

功能特點

go install github.com/agenvoy/kuradb/cmd/app@latest · 完整文件

• 關鍵字 + 語意雙重搜尋 — 同時支援中文斷詞關鍵字比對與 OpenAI embedding 向量相似度搜尋，精準與語意兼顧。
• 檔案系統監控自動索引 — 將檔案放入監控目錄即自動解析、分段、嵌入，無需手動觸發索引流程。
• 唯讀 API 安全邊界 — 對外僅暴露查詢端點，所有寫入走 watcher → parser → SQLite 單向管線，杜絕外部竄改。
• 向量快取與查詢快取 — 記憶體內 cosine 相似度搜尋搭配 OpenAI query embedding 快取，重複查詢近乎零延遲。
• 單一二進位部署 — Go 編譯的靜態二進位檔，內嵌 SQLite，無外部依賴，go install 一鍵部署。

架構

完整架構

graph TB
    Client[客戶端] --> API[HTTP API]
    API --> Health[健康檢查]
    API --> List[資料庫列表]
    API --> Semantic[語意搜尋]
    API --> Keyword[關鍵字搜尋]
    Watcher[檔案監控] --> Parser[檔案解析]
    Parser --> SQLite[(SQLite)]
    SQLite --> Embedder[OpenAI Embedding]
    Embedder --> Vector[向量快取]
    Vector --> Semantic
    SQLite --> Keyword

授權

本專案採用 MIT LICENSE。

Author

邱敬幃 Pardn Chiu

hi@pardn.io
https://www.linkedin.com/in/pardnchiu

©️ 2026 邱敬幃 Pardn Chiu