cortexkit/magic-context

Magic Context – 為編碼代理提供自我管理的長期記憶

簡介 – 這是CortexKit套件的一個外掛，為AI驅動的編碼代理賦予「海馬體」。它能自動從專案的聊天記錄中提取有用知識，在背景整合，並使其跨工作階段和工具（OpenCode、Pi、Oh‑My‑Pi）可搜尋。目標是消除傳統的壓縮中斷——那種讓代理在任務中途忘記所學內容的機制。

主要功能

• 捕獲 – 代理工作時，歷史記錄器會掃描對話，提取持久性事實（設計決策、約束、設定值、命名約定），並將其儲存為專案記憶。
• 整合 – 可選的夢想家（通常在夜間）執行，對照目前程式碼庫驗證記憶，合併重複項，清理過時條目，並保持文件最新。
• 召回 – 每一輪系統都會將最相關的記憶注入提示詞。開發者還可以呼叫ctx_search、ctx_expand、ctx_note等來擷取或編輯記憶、搜尋git提交或延後筆記。
• 上下文視窗管理 – 歷史記錄器建立分層隔間，用重要性分數總結較舊訊息，從而在保持完整執行緒的同時讓活動提示詞保持小巧。快取感知的縮減確保模型的提示詞快取不會被失效。
• 跨框架支援 – 支援三大CortexKit框架（OpenCode、Pi、Oh‑My‑Pi），並自動停用任何競爭的上下文管理外掛。

安裝與設定

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.sh | bash
# Windows PowerShell
irm https://raw.githubusercontent.com/cortexkit/magic-context/master/scripts/install.ps1 | iex
# 或透過npx在任何作業系統上
npx @cortexkit/magic-context@latest setup

精靈會偵測你使用的框架，新增相應的外掛（@cortexkit/opencode-magic-context、@cortexkit/pi-magic-context等），停用主機的內建壓縮，並協助你為歷史記錄器、夢想家和副駕選擇模型。

設定 – JSONC檔案（magic-context.jsonc）允許你按框架指定歷史記錄器（必要）以及可選的夢想家和副駕的模型ID。你還可以啟用/停用嵌入、時間感知和自動搜尋提示。

典型工作流程

1. 執行設定精靈（或手動將外掛新增到框架設定中）。
2. 歷史記錄器開始總結聊天記錄，並將持久性事實提升到專案記憶。
3. 可選地啟用夢想家（/ctx-dream）以執行夜間維護。
4. 在工作階段期間，代理會自動接收相關記憶；你也可以用ctx_search查詢或用ctx_memory編輯。

你將使用的命令

命令	作用
/ctx-status	顯示目前記憶統計、待處理丟棄項、歷史記錄器進度等。
/ctx-flush	強制立即執行所有排隊的縮減/壓縮。
/ctx-recomp	從原始歷史重建隔間（在狀態損壞時有用）。
/ctx-dream	按需觸發夢想家的維護週期。
/ctx-search（工具）	跨記憶、聊天、git提交和筆記進行語義/關鍵字搜尋。
/ctx-note	建立一條延後筆記，供夢想家稍後呈現。

重要性 – 沒有Magic Context，每個編碼代理工作階段都從空白狀態開始，並遭受週期性「壓縮」導致的上下文中斷。有了Magic Context，單一工作階段可以持續數週甚至數月，在保留專案知識的同時降低令牌成本，並保持代理的提示詞快取穩定。

了解更多 – 完整文件位於 https://docs.cortexkit.io/magic-context ，Discord社群連結在README中。