AegisDB – 自託管AI代理內存，單個C語言二進制文件

AegisDB是一款專為AI代理設計的自託管內存系統，旨在解決AI代理在會話間遺忘信息的問題。它通過一個簡單的JSON-over-TCP協議，為代理提供持久化、可搜索的長期記憶，包括基於事件歷史、語義事實（支持向量搜索）以及易失性工作記憶。整個系統僅由一個無依賴的C語言二進制文件構成，用户可完全掌控數據，無需第三方服務。

AegisDB的快速部署非常簡單：通過Docker運行單個命令即可啓動服務器。它內置了客户端工具，支持ping、存儲和搜索操作。對於Claude Code用户，通過MCP服務器集成，只需一條命令即可讓Claude擁有跨會話的持久記憶。

該系統的核心特性包括：自託管與隱私保護——代理記憶永不離開用户基礎設施，支持靜態加密；單一二進制文件，無依賴——採用C語言編寫，僅依賴cJSON和加密庫；面向團隊設計——支持多租户身份驗證（基於命名空間和作用域令牌）、每個租户的存儲配額和速率限制、在線備份和只讀副本，以及一鍵啓動的Prometheus/Grafana可觀測性棧。

AegisDB提供了三種內存類型：持久化事件記憶（追加日誌，支持CRC32校驗和崩潰恢復）、語義事實（可更新記錄）和工作記憶（基於TTL的易失性環形緩衝區）。檢索方式包括按ID、時間範圍、標籤、語義（嵌入向量）搜索，並支持餘弦相似度排序和去重。對於大規模語義搜索，系統在超過閾值後自動切換至HNSW圖索引，支持int8量化以降低內存佔用。

此外，AegisDB還支持記錄間的關係邊、圖遍歷和代理命名空間隔離。系統提供可選的靜態加密（XChaCha20-Poly1305）、可觀測性指標、在線快照備份和只讀副本。併發方面採用分片poll()事件循環線程，支持可選的fsync持久化策略（同步、批處理或間隔刷新）。

構建AegisDB需要Linux系統、GCC 11+或Clang 14+，以及CMake 3.20+或GNU Make。提供CMake和Make兩種構建方式，並支持Docker多階段構建。預構建的多架構鏡像已發佈至GitHub Container Registry。

配置選項豐富，包括數據目錄、端口、嵌入維度、ANN閾值、持久化模式、檢查點間隔、租户限制等。系統還支持複製、只讀模式和外部認證令牌。詳細的配置文件和示例可參照項目文檔。

總體而言，AegisDB為AI代理開發者提供了一個自託管、高性能、功能全面的內存解決方案，兼顧隱私、可擴展性和易用性。