╭──────────────────────────────────────────╮ ╭──────────────────────────────────────────╮ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ╚══════════════╝ ╚══════════╝ ╚══════════════╝ ╚══════════╝ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ file file file file read cache send tok tok tok tok tok tok file file file file read cache send tok tok tok tok tok tok ╭──────────────────────────────────────────╮ ╭──────────────────────────────────────────╮ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> ctx_read >>>>>>>>>>>> │ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ ┌─────────────┐ │ >>>>>>>>>>>>>>> compress >>>>>>>>>>>> │ ┌──────────┐ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ │ 100K tokens │ =========>│ >>> AST >>> cache >>> signal >>> │ =========> │ ~5K tok │ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ └─────────────┘ │ >>>>>>>>>>>>>>> filter >>>>>>>>>>>> │ └──────────┘ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ │ >>>>>>>>>>>>>>> dedupe >>>>>>>>>>>> │ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ╔══════════════╗ ╰──────────────────────────────────────────╯ ╔══════════╗ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ║ raw input ║ ─ ─ ─ ─ ─ ─ ─ ─ LeanCTX ─ ─ ─ ─ ─ ─ ─ ─ ─ ─ ║ output ║ ╚══════════════╝ ╚══════════╝ ╚══════════════╝ ╚══════════╝ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄┄ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ ┌──┐ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │▓▓│ │▓▓│ │▓▓│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ ───> │▓▓│ │▓▓│ │▓▓│ ───> │░░│ │░░│ │░░│ │░░│ │░░│ │░░│ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ └──┘ file file file file read cache send tok tok tok tok tok tok file file file file read cache send tok tok tok tok tok tok

用例 · 自定义机器人

为您的机器人提供
context engineering。

LeanCTX 通过版本化的 /v1 HTTP API（OpenAPI + /v1/capabilities）嵌入到任何自定义机器人或 agent 中，支持使用 GA Python 和 TypeScript SDKs 以及 Rust SDK。您的机器人无需构建任何东西，即可获得压缩读取、持久内存、知识图谱、ctx_tools 网关和治理能力。只需一个本地 Rust 二进制文件：lean-ctx serve，零云依赖。

基于 LeanCTX 构建阅读 API 文档

问题所在

它让您损失了什么今天。

原始 JSON 直接进入模型

每个工具响应、API 有效载荷和文档都会未经处理地进入提示。您为每一次调用支付噪音成本。

自建内存系统脆弱易碎

将向量存储绑定到 cron job 的做法，算不上一个记忆系统。发现的知识会消失，会话会重置，没有人信任其召回能力。

每个机器人都在重建相同的架构

缓存、去重、检索、预算：每个新的机器人都会重新发明上下文堆栈，而不是专注于它实际的工作。

今日交付

具备能力的那些完成工作。

下方所有功能都已在开源二进制文件中交付。没有路线图项目，没有等待列表。

您的工具 LeanCTX 模型

版本化 /v1 API OpenAPI 规范 + /v1/capabilities 发现；包含读取、搜索、记忆和 shell 端点

GA SDKs + 合规性 Python 和 TypeScript SDK 已达到 GA，并配备了 14 项检查的合规工具包，外加 Rust SDK

ctx_tools 网关通过一个受控的入口点连接外部 MCP 服务器和插件

WASM 扩展沙盒化的 WASM 运行时和插件可以在不分叉层的情况下扩展该层

上下文角色内置角色（coding、research、support 等）以及自定义；一个开关即可重塑工具集、读取模式、压缩和意图

知识存储事实、决策和阻塞点可以在会话和重启之间持久化

快速上手

从零开始到第一个收益。

# 启动 context API

$ lean-ctx serve

# 发现表面（OpenAPI + capabilities）

$ curl localhost:8080/v1/capabilities

# 安装 SDK

$ pip install lean-ctx-client

# 从您的机器人连接

$ client = LeanCtxClient("http://127.0.0.1:8080")

# 通过 /v1 API 进行压缩读取

$ client.call_tool_text("ctx_read", {"path": "data/report.pdf"})

深入了解

一本指南，两条路径。完整参考。

指南 API 参考所有带有请求和响应结构的 /v1 端点。旅程开放式：SDK 和 API 端到端地将 LeanCTX 嵌入到您自己的代理中。旅程上下文角色（Context personas）为您的机器人领域调整该层。参考 MCP 工具目录您的机器人可调用的完整 77 个工具目录。

FAQ

团队在采用前提出的问题。

我是否需要 AI 编码工具才能使用 LeanCTX？

不需要。lean-ctx serve 在您的机器上运行一个版本化的 /v1 HTTP API。任何进程（例如 Slack bot、支持代理或管道）都可以通过 Python、TypeScript 或 Rust SDK 使用压缩读取、内存和搜索功能。

SDK 是否足够稳定，可以进行构建？

是的。Python 和 TypeScript SDK 针对固定的 /v1 合约处于 GA 状态，而一个 14 个检查的合规性套件确保了每个客户端的诚实。Rust SDK 和 OpenAPI spec (/v1/openapi.json) 完善了这一功能集，扩展程序作为沙盒 WASM 或插件运行，因此您可以在不分叉的情况下扩展该层。

我的机器人数据存储在哪里？

在您的机器上。LeanCTX 是本地优先的，零遥测：缓存、知识库和账本都是本地文件。除非您构建了发送数据的组件，否则没有任何数据会离开。

嵌入 LeanCTX 的成本是多少？

零成本。本地使用永久免费，并通过公共 CI 网关强制执行。付费计划仅在上面增加了托管同步和团队平面。

重新掌控你的上下文。

本地使用免费，永久免费。CI强制执行它。一个二进制文件，十分钟即可获得第一个可衡量收益。

基于 LeanCTX 构建查看计划

为您的机器人提供context engineering。

它让您损失了什么 今天。