memory-hygiene

Memory Hygiene 是一套專為 Clawdbot 用戶設計的工具，旨在維護精簡且高效的向量資料庫 (LanceDB)。隨著 AI 代理透過自動捕獲累積資訊，向量記憶體常因暫存日誌、重複的心跳檢查與低價值資料而變得臃腫，進而導致 RAG (檢索增強生成) 回溯時的 Token 成本大幅增加。此技能提供了一套結構化的工具包，用於審核當前的記憶體使用情況、執行精確刪除，並建立自動化的 Cron 維護程序，確保只有高價值的關鍵事實、偏好與架構決策被索引。

• 使用針對性檢索查詢，對 LanceDB 記憶體內容進行深度審核。

• 執行本地記憶體目錄的完整清除，以解決持續性的儲存空間膨脹問題。

• 從 MEMORY.md 等主檔案中重新植入核心資料，以重建乾淨的狀態。

• 套用配置補丁以停用如 autoCapture 等高噪音功能。

• 透過 Cron 作業實現每月自動化維護，解析、清理並整合知識庫。

• 實作智慧型儲存準則，明確區分瞬態狀態資訊與關鍵的長期事實。

• 用戶應監控 Token 使用量；若簡單查詢時消耗過高，通常表示向量記憶體過於臃腫。

• 此工具專為管理 Clawdbot 實例的開發人員與進階用戶設計，旨在優化效能並降低延遲。

• 輸入包括用於目錄管理的 Shell 指令與 Gateway 的 JSON 配置補丁；輸出為更新後的記憶體狀態與提升後的代理回溯精度。

• 在執行完整清除之前，務必確認 MEMORY.md 中的關鍵資訊，以免遺失專案架構或憑證。

• 避免儲存心跳狀態、原始日誌或瞬態時間戳記，以確保向量空間專用於重要知識。

• 在重新植入資料時，使用建議的重要性加權 (0.7-1.0) 以確保最佳的檢索優先順序。