BHGBrain：AI 代理的持久記憶

每個 AI 代理在每次会話開始時都是失憶的。昨天的架構決策、上週的除錯突破、三個 sprint 前團隊達成的命名慣例——全部消失。您得重新解釋一遍，否則代理就會出錯。

BHGBrain 解決了這個問題。 它是一個開源 MCP 伺服器，為您的 AI 代理提供持久、可搜尋、跨会話、工具與團隊共享的記憶。

運作方式

BHGBrain 位於您的 AI 代理與持久儲存層之間。任何相容 MCP 的客戶端——Claude Code、Codex、OpenClaw、Gemini——連線到 BHGBrain 後即可存取共享知識庫。

AI Agents (Claude / Codex / OpenClaw / Gemini)
  → MCP transport (stdio or HTTP)
    → BHGBrain server
      → Qdrant (semantic vector search)
      → SQLite (metadata, fulltext index, audit log, archive)

當代理儲存記憶時，BHGBrain 會透過智慧管線處理：

1. 正規化——輸入在雜湊前先清理與標準化，提升改寫或重新格式化內容的去重準確度
2. 去重——使用 SHA-256 內容雜湊與餘弦相似度（閾值：0.92）比對現有記憶，並依層級調整閾值以控制精準度
3. 決策——決定是新增知識、更新現有項目，還是捨棄重複內容
4. 保留指派——依類型、重要性與呼叫端指定的偏好，將記憶指派到適當的保留層級（T0–T3）
5. 儲存——嵌入、索引並持久化已接受的記憶，搭配影響未來搜尋排名的重要性分數

當代理需要上下文時，BHGBrain 透過混合 RRF 搜尋提供——結合語意相似度（70%）與全文比對（30%），採 Reciprocal Rank Fusion，權重可配置。代理取得的是相關記憶，而非整個知識庫。

關鍵能力

• 分層保留（T0–T3）——記憶存在多久取決於其價值。T0（基礎）永不過期。T1（機構性）持續一年。T2（營運性）持續 90 天。T3（暫時性）持續 30 天。每個層級都有可配置的容量預算（T1：10 萬、T2：20 萬、T3：20 萬筆項目）。
• 滑動視窗 TTL——每次存取重設到期時鐘。持續被使用的記憶會自動保持存活。
• 自動晉升——被存取 5 次以上的記憶自動晉升至下一個更高保留層級。高價值知識自我篩選為持久。
• 到期前警告——記憶在過期前 7 天被標記，讓代理與操作員有時間在知識流失前行動。
• 刪除前封存——過期記憶在移除前會寫入封存資料表。沒有可復原記錄就不會永久清除。
• 混合 RRF 搜尋——Reciprocal Rank Fusion 將語意（70%）與全文（30%）結果合併為單一排名清單。權重可依查詢配置。
• 語意去重——0.92 閾值的餘弦相似度捕捉近似重複。SHA-256 校驗和捕捉完全重複。內容正規化在雜湊前執行，使改寫的輸入能正確去重。
• 重要性評分——每筆記憶帶有 0–1 的重要性分數，直接影響搜尋結果排名。高重要性記憶優先浮現。
• 分類 / 持久原則插槽——具名原則分類（如 architecture-decisions、coding-standards、security-policies）為應始終可用的機構知識提供持久插槽，獨立於 TTL。
• 跨代理共享記憶——Claude Code 學會您的 API 慣例；Codex 在下次会話自動取得。一份記憶，每個代理，零漂移。
• 記憶分類——記憶自動分類為情節性（事件）、語意性（事實）或程序性（工作流程）。
• 命名空間隔離——分隔專案、團隊或客戶而不交叉污染。全域命名空間用於跨切面標準。
• 集合——在命名空間內群組相關記憶（如 api-design、infrastructure、security）。
• 上下文注入——特殊 MCP 資源在会話開始時傳遞預算控管的上下文區塊，讓代理無需手動提示即以相關知識起步。
• 完整 CLI——列出、搜尋、管理分類、執行垃圾回收、建立備份——全從命令列完成。

預設企業級就緒

BHGBrain 不是原型。它從第一天起就是為生產環境打造。

適用對象

• 執行多代理工作流程的團隊——當 Claude Code、Codex 與 OpenClaw 都需共享相同專案知識而不漂移。
• 企業 IT 部門——需要 AI 記憶稽核追蹤、驗證與自架基礎架構的組織。
• 顧問與代理商——命名空間隔離讓客戶知識分開，同時跨專案共享內部標準。
• 獨立開發者——任何 AI 記憶需求已超出 MEMORY.md 檔案的人。

5 分鐘上手

1. 啟動 Qdrant

docker run -d --name qdrant -p 6333:6333 qdrant/qdrant

2. 安裝 BHGBrain

git clone https://github.com/Big-Hat-Group-Inc/BHGBrain.git
cd BHGBrain && npm install && npm run build

3. 設定 API 金鑰並執行

export OPENAI_API_KEY=sk-...
node dist/index.js

4. 連結您的代理

將 BHGBrain 加入您的 MCP 客戶端設定——Claude Desktop、OpenClaw 或任何相容 MCP 的工具。您的代理現在可跨会話 remember 與 recall。

如需詳細安裝、設定選項與 bootstrap 訪談提示，請參閱 GitHub 上的完整文件。

多語文件

BHGBrain 隨附五種語言的完整文件：

📦 GitHub： github.com/Big-Hat-Group-Inc/BHGBrain

📖 深入解析： BHGBrain：為您的 AI 代理提供共享、持久記憶