← 返回目录
E

Entroly

社区
为 AI Agent 提供可恢复、可审计的上下文压缩。
GitHub 源仓库 ↗
★ 431 Stars 分类 · 开发工具 非常热门
67FMRS · C
可靠性
10/20
安全与权限
14/20
维护活跃度
13/20
文档质量
17/20
安装易用性
13/20

Entroly 面向需要上下文治理而非聊天运行时的 AI Agent 开发者。它提供本地优先的选择、压缩、恢复、回执和验证能力,支持 Python/PyPI、Node/npm 和 stdio MCP。主要限制是实际拦截范围取决于集成方式,恢复依赖本地状态,且 token 节省和质量结果必须在目标工作负载上自行验证。

查看 FMRS 评分方法 →

Entroly 是一个本地 Context OS 和 MCP 服务器,在模型请求前发现、排序、去重并压缩工具输出、日志、文件、对话和 RAG 上下文。它通过预算感知选择、内容寻址恢复和 Context Receipt 保留关键证据,并提供本地验证、恢复、缓存、记忆和成本观测能力。源码声明在测量工作负载上最多可减少 90% 的不必要 token,但实际效果取决于工作负载和集成路径。

工具能力

暂未整理工具清单。

安装接入

安装 Python 包:pip install -U entroly。将 Entroly 注册为 stdio MCP 服务器,命令为 entroly 且不带参数;也可使用 entroly init,或针对 Claude Code、Codex、OpenClaw 使用 entroly attach create --client <client> --project . --ttl 4h --install。安装后可运行 entroly verify-claims 和 entroly simulate 进行本地检查。

claude_desktop_config.json
{"mcpServers":{"entroly":{"command":"entroly","args":[]}}}

选型与风险

适合谁

  • 大型代码库和文档集合
  • 多轮、日志密集型 AI Agent 会话
  • 需要证据追溯、恢复和审计记录的团队
  • 希望在本地运行并控制模型集成路径的开发者

不适合谁

  • 上下文很短或已经低于预算的项目
  • 需要自动拦截所有模型请求的 MCP-only 集成
  • 要求始终保留完整上下文的任务
  • 需要将有限基准结果视为所有模型和生产工作负载保证的场景

所需权限

  • 需要访问所配置项目中的本地代码、文档、日志或其他上下文数据
  • MCP attachment 可按项目、范围和过期时间授予并可撤销
  • 代理模式需要用户自行配置相应 provider API key;Entroly 不选择 provider 或接收其凭据

风险与副作用

  • 压缩可能遗漏相关证据;应检查 Context Receipt 和验证结果
  • 精确恢复依赖 receipt 和本地 recovery store,删除这些状态会删除恢复路径
  • MCP 集成不会自动拦截每个模型请求;provider savings 需要请求经过 Entroly proxy
  • 代理对未知或歧义结构会原样传递,无法安全压缩时可能返回 413
  • README 中的基准是特定数据集、预算、模型和版本上的结果,不是普遍保证

常见排障

  1. 运行 entroly verify-claims 检查安装、导入、压缩、恢复和引擎模式
  2. 运行 entroly simulate 或 entroly perf 检查本地 token 估算和延迟
  3. 确认 MCP 客户端使用 stdio 命令 entroly 且不带参数
  4. 代理模式确认应用的 base URL 已指向 localhost:9377,并正确配置上游 provider
  5. 若没有 provider-bound 请求,检查客户端是否绕过了自定义端点或仅使用 MCP 模式
  6. 检查 receipt 和 recovery store 是否仍保留,以确保遗漏内容可恢复

使用场景

在预算内选择和压缩代码库或文档上下文
压缩重复的终端、测试和函数输出并保留恢复句柄
生成 Context Receipt,记录选中、遗漏、风险和指纹
对遗漏内容进行精确恢复和可重放验证
使用 WITNESS 根据证据检查回答
在本地估算 token 减少并观察 provider-bound 请求价值

支持客户端

Claude Desktop完整支持
Claude Code完整支持
Codex CLI完整支持
OpenClaw完整支持
Cursor完整支持
Windsurf完整支持
VS Code MCP clients完整支持
Zed完整支持
GitHub Copilot CLI部分支持