kiwifs/kiwifs

解決的問題

KiwiFS 解決了人類可讀文件與 AI 代理可存取資料之間的落差。雖然 Markdown 對雙方都理想，但原始檔案缺乏生產級 AI 代理所需的搜尋、版本控制與結構化能力。它取代了在代理無法讀取的資料庫與代理無法寫入的唯讀檢索層之間二選一的困境。

工作原理

KiwiFS 作為一個 Markdown 檔案系統運作，磁碟上的檔案作為單一真實來源。它將這些檔案封裝於單一的 Go 二進位檔中，提供多種存取協定（REST、MCP、NFS、S3、WebDAV、FUSE）與內建的 Web UI。為支援 AI 功能，它實作全文搜尋（BM25）與可插入的向量搜尋（支援 OpenAI、Ollama、ONNX 等），同時使用 Git 實現原子性版本控制與審計日誌。

適用對象

• AI 代理開發者：需要一個持久、可寫的工作區，讓代理與人類共同協作知識。
• 團隊：希望擁有自架設、免供應商鎖定的 Notion 或 Confluence 替代方案。
• 合規要求高的產業：需要透過 Git 實現每次變更的不可變審計日誌。
• DevOps 團隊：希望代理維護可由人類審查的即時執行手冊。

核心亮點

• 原生 MCP 集成：內建 62 個工具，可與 Claude、Cursor 及其他 MCP 客戶端無縫協作。
• 混合搜尋：結合 SQLite FTS5 實作全文搜尋，同時支援靈活的向量儲存選項（如 sqlite-vec、Qdrant、Pinecone）。
• 自動版本控制：每次寫入都會作為原子性 Git 提交記錄，支援差異對比與時點還原。
• DQL 查詢：支援對 Markdown 前置元資料進行類似 SQL 的查詢，實現結構化資料檢索。
• 零設定部署：以單一二進位檔分發，內建 Web UI 與多種資料匯入器。