yvgude/lean-ctx

解決的問題

LeanCTX 是為 AI 編碼代理設計的 AI 價值閘道與上下文工程層，旨在減少 AI 編碼代理的令牌浪費與 API 成本。它防止代理反覆傳送未變更的檔案內容或雜訊過多的 shell 輸出至模型，這會消耗上下文視窗並增加支出。

工作原理

LeanCTX 在兩個層面運作以優化資訊流：

1. 讀取路徑：作為 MCP 伺服器與 shell 鈎子，提供專用的讀取模式（如 AST 簽名或熵過濾視圖），並在代理看到之前壓縮常見的 CLI 輸出（例如 git、npm、docker）。
2. 傳輸路徑：在代理與模型提供者之間可選地部署本地代理，壓縮所有請求——包括系統提示與歷史記錄——同時保持提示快取安全。

它使用 Tree-sitter AST 來理解 27 種語言的結構，並使用屬性圖進行程式碼分析。所有壓縮皆可逆；被修剪的內容儲存在內容位址儲存中，模型可依需求檢索。

適用對象

使用 Cursor、Claude Code、Copilot、Windsurf 和 Gemini 等 AI 編碼代理的開發者，希望降低 API 費用、延長有效編碼會話時間，並保持對專案上下文與記憶的本地擁有權。

主要亮點

• 上下文壓縮：提供 10 種讀取模式與 95+ 種 shell 輸出模式，減少令牌使用量，同時不遺失資料。
• 會話記憶：在不同聊天會話之間持續保存事實與決策，避免「冷啟動」問題。
• AI 價值閘道：提供即時儀表板，追蹤令牌使用量、美元節省額以及「每接受結果成本」（CPAO）指標。
• 模型無關：跨不同 LLM 提供商（OpenAI、Anthropic、Gemini）運作，不會將上下文鎖定在供應商的黑箱中。
• 可攜式上下文：可將知識與會話資料匯出為 .ctxpkg 檔案。
• CPAO 追蹤：使用「影子模式」將 LeanCTX 的最佳化上下文與基線進行比較，以證明實際節省效果。