LeanCTX 是一个面向 AI 系统的上下文网关（Context Gateway），定位在 AI 工具与其读取的信息之间。它通过选择任务相关上下文、应用访问和内容控制，并记录上下文操作与交付证据，来帮助开发者控制 AI 能“看到”什么。该引擎为开源，可本地运行，支持 CLI、MCP、hooks 和 proxy 路径，也提供 SDK 供应用嵌入。
用途与定位 LeanCTX 主要用于 AI 编程工作流，例如配合 Claude Code、Cursor 或 Codex 使用。它解决重复读取文件、shell 输出噪声过多、上下文窗口浪费以及跨会话记忆丢失等问题。开发者可自行保留模型调用和应用程序工作流，LeanCTX 只负责上下文的选择、控制与证明。
主要能力 上下文压缩：支持 16 种文件读取模式（如 full、map、signatures、diff、lines:N-M、density:X 等），符合条件的缓存重读返回紧凑引用而非重复内容。支持目标密度压缩（density:0.4），保留高熵行至原 token 约 40%，并采用确定性算法。JIT 披露机制让 signatures 携带行跨度并按需通过 lines:N-M 展开。Shell 输出支持 85+ 压缩模式，覆盖 git、npm、cargo、docker、kubectl、terraform 等，并有 250+ 直通规则。基于 Tree-sitter AST 为 27 种语言提供结构理解。源恢复（CCR）可通过 ctx_expand、ctx_retrieve 或 reference API 展开紧凑视图。 智能分诊：Adaptive ModePredictor 从历史会话学习每种文件类型的最优读取模式，IntentEngine 对查询复杂度分类，简单查询保持低成本。 知识路由：会话记忆（CCP）跨聊天持久化任务、事实和决策；知识图谱包含带有效窗口的时间事实、情景和程序记忆；Property Graph 支持多边代码图（导入、调用、导出、类型引用），用于影响分析和搜索排序。记忆保持本地和可移植，可导出为 .ctxpkg 包跨机器或模型迁移。 使用与结果证据：Context Manager 提供浏览器仪表盘，实时跟踪 token、压缩统计和利用率；支持预算、SLO、角色和每智能体节流策略；Context Proof（ctx_proof、ctx_verify）导出审计线索并运行时检查策略声明。Shadow Mode 基于未压缩 token 数模拟估算节省，但不测量回答质量。CPAO（每次接受结果的成本）作为核心指标。 其他能力：ctx_url_read 可拉取网页、PDF 或 YouTube 转录为压缩且带引用的文本，具备 SSRF 防护；混合搜索结合 BM25、嵌入和图形邻近度（RRF）；LSP 重构（ctx_refactor）支持重命名、引用和跳转定义；多智能体研究性交付（ctx_agent、ctx_handoff）为实验性本地功能；存档全文搜索（ctx_expand search_all）基于 FTS5；PR 上下文包通过 lean-ctx pack --pr 构建；上下文包和快照时间机器为研究性实验功能；可观测性命令如 lean-ctx gain --live、lean-ctx wrapped、lean-ctx watch 和浏览器仪表盘；验证节省通过本地每事件账本和 SHA-256 链实现；HTTP 模式通过 lean-ctx serve 提供 Streamable HTTP MCP 和 /v1/tools/call。
使用方式 安装后可通过 lean-ctx setup 配置支持的集成。常用命令包括 lean-ctx wrap 注册 MCP 服务器并配置本地传输，lean-ctx unwrap cursor 撤销。Claude Pro/Max 订阅 OAuth 无法使用自定义 ANTHROPIC_BASE_URL，wrap claude 不添加代理重定向，仅启用 ctx_* 工具和 shell 输出压缩。Windows 上可从源码构建，运行 ./install.ps1。当前发布工作流以 Thinkery AG 签名 Windows 二进制和 Python 伴随 wheel，早期版本可能未签名。禁用当前 shell 可用 lean-ctx-off，单命令不压缩用 lean-ctx -c --raw "git status"，仅智能体会话激活可设置 shell_activation = "agents-only"，项目级配置可创建 .lean-ctx.toml。更新用 lean-ctx update，诊断用 lean-ctx doctor --json。Docker 项目共享 /workspace 时可创建 .lean-ctx-id 防止上下文冲突。
适用场景与限制 适用于日常编码、减少重复读取和噪声、跨会话上下文连续性、多项目环境以及需要审计和预算控制的 AI 工作流。限制包括：部分功能如多智能体、上下文包、快照时间机器、Addons 仍为研究性实验功能；Shadow Mode 报告为模拟估算，不测量回答质量；秘密擦除不覆盖所有可能的秘密；Addon 默认不信任且不自动安装外部服务器；Claude 线级请求压缩需 ANTHROPIC_API_KEY；托管历史或注册表尚未作为通用产品提供。
