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 和多种数据导入器。