LeanCTX 上下文智能层

这个 Agent 能做什么，适合哪些场景？

LeanCTX 是一个面向 AI 编码代理的本地优先上下文工程层，以单个 Rust 二进制程序提供 MCP 服务器、Shell 钩子、可选请求代理、会话记忆、代码图谱和浏览器仪表盘。它可压缩文件读取、常见开发命令输出以及经代理发送给模型的请求，并将被裁剪内容保存到内容寻址存储中以供恢复。系统通过 Tree-sitter 支持 27 种语言的结构分析，提供 10 种读取模式，并以属性图支持搜索、影响分析和相关文件发现。它还记录令牌、成本、接受结果及 CPAO，提供 Shadow Mode、可验证的节省账本和上下文证明。项目支持 30 多种编码代理，并提供 Python、TypeScript/Node 和 Rust 客户端或压缩 SDK；代码、记忆与默认遥测均留在本地，除非用户明确启用外部能力。

在读取路径中，编码代理通过 ctx_* MCP 工具或 Shell 调用 LeanCTX；lean-ctx read 可按 full、map、signatures、diff、lines:N-M、density:X 等模式读取文件，Shell 钩子则压缩 git、npm、cargo、docker、kubectl、terraform 等命令的输出。Tree-sitter AST、ModePredictor 和 IntentEngine用于结构提取、读取模式选择与任务复杂度分类；被省略的原文进入内容寻址存储，可通过 ctx_expand、ctx_retrieve 或 /v1/references/{id} 恢复。会话记忆、知识图谱和多边属性图保存任务、事实、决策以及代码关系，并支持 lean-ctx graph impact、混合搜索和跨会话恢复。可选的 lean-ctx proxy enable 位于代理与 OpenAI、Anthropic或 Gemini 模型提供方之间，压缩系统提示、历史和工具结果。lean-ctx gain、savings、value-report、shadow 和 Context Manager 仪表盘生成令牌、美元成本、CPAO、质量及基线比较；ctx_proof 与 ctx_verify 提供四层验证和 CI 漂移门禁。它也能通过 ctx_agent、ctx_handoff、.ctxpkg 包、签名快照及 addon 网关支持多代理协作、上下文迁移和外部 MCP 服务接入。

1. 每天使用 Cursor、Claude Code 或 Codex，并频繁运行 git、测试和构建命令的开发者，可用混合模式减少重复文件读取和冗长终端输出。
2. 维护中大型仓库或 monorepo 的团队，可用 AST 签名、混合搜索、属性图和 graph impact 快速定位接口及变更影响范围。
3. 需要跨聊天延续长期重构或排障工作的用户，可将任务、事实和决策保存到本地会话记忆及知识图谱中。
4. 同时使用 OpenAI、Anthropic 与 Gemini 的团队，可通过本地上下文层保留可移植缓存和记忆，并选择性启用请求代理。
5. 需要证明 AI 成本收益的工程负责人，可使用节省账本、CPAO、Shadow Mode、基准报告和实时仪表盘比较令牌消耗与接受结果。
6. 运行规划、开发和审查等多代理流程的团队，可用 ctx_agent、ctx_handoff、共享状态、日记和上下文传递包协调交接。

如何安装或部署这个 Agent？

任选一种已记录的安装方式：

curl -fsSL https://leanctx.com/install.sh | sh
brew tap yvgude/lean-ctx && brew install lean-ctx
npm install -g lean-ctx-bin
cargo install lean-ctx
pi install npm:pi-lean-ctx

随后为目标代理执行一键配置，例如：

lean-ctx wrap cursor
lean-ctx wrap claude
lean-ctx wrap codex
lean-ctx wrap vscode

wrap 会安装 Shell 钩子、注册 MCP 服务器、配置代理钩子、启动守护进程并验证连接。也可运行 lean-ctx onboard 自动连接检测到的工具，或用 lean-ctx setup 进入交互式配置。Windows 源码构建可在克隆仓库后从 PowerShell 执行 ./install.ps1；加 -BuildOnly 可只构建。基础本地使用未注明需要 API 凭据；若启用模型请求代理、云同步、网页读取或外部提供方，则需自行具备相应服务访问条件。

如何使用这个 Agent？

完成包装后，可先运行 lean-ctx doctor 检查连接。典型调用包括：

lean-ctx read src/server.rs -m map
lean-ctx -c "git status"
lean-ctx overview
lean-ctx graph impact src/auth.rs
lean-ctx gain --live
lean-ctx dashboard

要压缩发送给模型的每个请求，可执行 lean-ctx proxy enable。要启用节省基线比较，在 ~/.config/lean-ctx/config.toml 中加入 [shadow] 与 enabled = true，使用一段时间后运行 lean-ctx savings 和 lean-ctx shadow --latest。应用集成可启动 lean-ctx serve，再通过 /v1/tools/call 或 lean-ctx-client 调用；只做消息压缩时，可安装 lean-ctx-sdk 并调用 Python 的 compress(messages, model="claude-sonnet-4") 或 TypeScript 的 compress(messages, { model: "gpt-4o" })。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v3.11.4 2026-10-11
   发布说明摘录

   A bugfix release: tool calls that an agent gets almost right are now served instead of refused, edits survive indentation slips, and the Claude Code plugin wakes the agent only once per finished background job. Agent Tools protocol and data formats are unchanged. Fixed - Searching a broad directory searches the project instead of failing. ctx_search, ctx_glob and ctx_tree called on ~, / or another directory that contains the session's project now walk the project and say so in the first line of the result. Before, they answered "refusing to scan" and agents repeated the sam …

   在 GitHub 查看 ↗
2. v3.11.3 2026-10-11
   发布说明摘录

   PathJail opens the home directory by default, the gateway keeps downstream MCP sessions alive between calls, Windows updates and CUDA 13 GPU embeddings work, and Claude Code gets a gateway cockpit. Agent Tools protocol and data formats are unchanged. Changed - PathJail opens your whole home directory by default. The default path_jail_scope = home now admits everything below ~ for reading and writing; before, it admitted only paths inside a project, read-only outside the session's project. Protected locations stay closed: every top-level dot entry (~/.ssh, ~/.aws, ~/.config, …

   在 GitHub 查看 ↗
3. v3.11.2 2026-10-09
   发布说明摘录

   Updater and security hotfix for 3.11.1. Agent Tools protocol, configuration and data formats are unchanged. Upgrade notes - Updating from 3.11.0 or 3.11.1 needs one manual step. Their built-in updater stops after downloading and verifying a release with Failed to complete durable update transaction: prepared transaction is missing its integrity digest, and scheduled automatic updates fail the same way. Nothing is changed or damaged: the installed binary keeps running. Install this release once through the channel you installed with — curl -fsSL https://leanctx.com/install.sh | sh …

   在 GitHub 查看 ↗

常见问题