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代理開發者提供了一個自託管、高效能、功能全面的記憶體解決方案，兼顧隱私、可擴充套件性和易用性。