Entroly
在显式 token 预算下为 AI 选择高价值证据，可恢复地压缩上下文，并为每次裁剪出具可审计回执——不换模型、不改代码即可降低 token 账单。
证据显示本地优先设计、可选加入的遥测（v3 合约拒绝内容字段、仅上传取整后的桶值）、fail-closed 的安全门与 fail-open 的压缩、可禁用自愈安装的 ENTROLY_NO_SELF_HEAL。扣分点：pyproject 中原生引擎为必需依赖且缺失时命令会自动从 PyPI 安装（一次未经确认的出站动作，仅靠环境变量退出）；Receipt/Context Commit 含精确恢复数据，访问控制交由操作者；发布者身份未经验证，仅为个人邮箱（[email protected]），归 attribut 弱。
pyproject 注释披露并修复了两处真实的静默失败（原生引擎缺失时选择退化为算术、PyYAML 缺失时策略被静默忽略但 now 命名原因），CI 有基准同步校验和回归守卫，worker 测试覆盖 413/500/内容盲错误。扣分点：多数失败路径证据来自测试文件与文档描述而非源码全貌，且 README 中存在前后夸大表述（下载数、模型名）损害整体一致性。
受众与场景覆盖极广（pip/npm/Rust/Docker/Homebrew、SDK/MCP/proxy/CLI/包装器，20 种语言的 README），明确区分'tested'与'guided/bounded'集成路径，模型无法识别时降级为保守默认窗口并明确说明。扣分点：触发精度依赖工具侧查询质量与 X-Entroly-Active-Tools 头等约定，边界声明多处依赖文档而非代码证据。
信息架构出色：安装矩阵、快速入门按用户类型分表、详细文档链接、SECURITY.md 有私密报告流程与安全边界、明确支持版本线。LICENSE 为完整 Apache-2.0 并含 NOTICE。扣分点：无 CHANGELOG 文件在证据中（仅 releases 链接）；维护者单一且身份未验证（个人 Gmail，版权署名 'Copyright 2026 Entroly' 日期异常），长期维护承诺无从证实。
输出可用性有据（receipt、verify-claims、simulate、value 命令、dashboard、结构化错误）；成本收益有基准表并诚实展示 SQuAD 2.0 退化（80%→72%）与'不是普遍保证'声明，GSM8K 标注 pass-through。扣分点：所有节省/保留数字均为仓库自报，静态审查无法复核；压缩引入的准确性损失在部分任务上真实存在。
基准有复现命令、原始 artifact 路径、CI 强制 BENCHMARKS.md 与代码同步、tiktoken 版本固定，事实与推断分离较好（PRISM-R 标为研究原型、WITNESS 标为 advisory、明确声明非发票真值）。扣分点：README 中的 'GPT-6 Astra'、'Gemini 3.6 Flash'、'Muse Spark 1.3' 等模型名与 '100,438 downloads' 无法与任何公开来源交叉印证，疑似夸大或虚构，严重削弱外部佐证；5,117/13 等验证徽章为自报。
- README 中的部分模型名称（GPT-6 Astra、Gemini 3.6 Flash、Muse Spark 1.3）与累计下载数无法经公开来源印证，采纳任何基准数字前请在自己的仓库用 entroly simulate / verify-claims 独立复测。
- Receipt 与 Context Commit 内含可逐字恢复的源码/提示内容，请按源仓库同等访问与保留策略保护这些工件。
- 原生引擎缺失时工具会自动从 PyPI 安装；如需严格离线，请设置 ENTROLY_NO_SELF_HEAL=1。
- 发布者为未验证的个人账号（Gmail 联系方式），安全报告与维护连续性存在单点风险；生产使用前建议锁定版本并审计依赖。
这个 Agent 能做什么，适合哪些场景？
Entroly 是一个开源、本地优先的 AI token 效率与上下文保障层，仓库地址为 juyterman1000/entroly，采用 Apache-2.0 许可证。它在你的代码与 AI 之间工作：先按查询挑选真正回答问题的证据片段，再在显式预算内压缩，所有被舍弃的内容都可按字节精确恢复，每个决策都会生成记录保留、舍弃及原因的 Context Receipt。它以 CLI、Python/TypeScript SDK、MCP 服务器、HTTP 代理（本地端口 9377）和库导入五种形态运行，可与 Claude Code、Codex CLI、OpenClaw、Cursor、GitHub Copilot CLI 等集成，代理路径覆盖 ANTHROPIC_BASE_URL、OPENAI_BASE_URL 和 GOOGLE_GEMINI_BASE_URL。核心命令包括 entroly go、entroly simulate、entroly verify-claims、entroly recover、entroly proxy、entroly attach 和 entroly govern。所有选择、压缩与验证默认在本机完成，代码不上传，默认无遥测。
Entroly 的端到端流程：读取你的仓库和查询，选出与当前问题相关的证据片段（先选择、后压缩）；在预算内压缩上下文，被剔除的每一片段可通过 entroly recover 以 sha256 句柄按字节精确恢复并经指纹校验；输出 Context Receipt，说明保留了什么、舍弃了什么及原因。SDK 提供 compress、compress_messages、optimize 和 rescue_session 等入口；代理在请求经过时自动优化，并支持用 X-Entroly-Active-Tools 头显式限定活动工具集以延迟工具 schema；会话接近上下文上限时自动在途中压缩工具输出而不破坏前缀缓存。WITNESS 幻觉检测在本地将 AI 回答与所给证据比对，无需第二次付费调用；RAVS 路由可把廉价工作路由到便宜模型，默认 fail-closed。治理命令 entroly govern 提供 deny-by-default 的授权策略与可校验的审计链。
- 在大型代码库上使用 Claude Code 或 Cursor 的开发者，发现 agent 只能看到少数文件、总说'没找到相关代码'——Entroly 记录模型真实上下文上限并出收回执，避免预算性漏文件。
- 多轮 agent 会话膨胀、频繁撞上下文上限的用户，用代理路径的 runaway-session rescue 自动在途中压缩工具输出，无需手动 /compact。
- 想压缩真实 AI 账单的团队：先用免费的 entroly simulate 和 entroly value 在自己的仓库上测量，再决定是否接入付费密钥。
- 需要验证 AI 回答是否有证据支撑的工程师，用本地 WITNESS 检测（HaluEval-QA 上 84.92% 准确率）而不额外调用模型。
- 需要为 agent 建立身份、授权与审计的团队，用 entroly govern 的策略检查与 audit verify 命令。
- 用 Ollama 本地推理 NVIDIA Nemotron 3.5 Lightning 的用户，通过 OpenAI 兼容代理路径获得证据选择与回执。
- 构建自己应用的 Python 开发者，直接调用 SDK：from entroly import compress, compress_messages, optimize。
这个 Agent 有哪些优点和局限？
- 可恢复压缩：被舍弃内容按字节精确恢复（66/66 重启恢复测试、13/13 SDK 恢复探针），并有指纹校验，区别于不可逆的有损压缩工具。
- 每个决策出收回执：保留、舍弃与原因均记录在 Context Receipt 中，5,117/5,117 源片段经独立验证，决策可审计。
- 先选择后压缩：按查询挑选证据再压缩，并保持提示前缀字节稳定以保住 provider 缓存折扣。
- 多形态接入：CLI、SDK、MCP、HTTP 代理、agent 包装器五种路径，适配 30+ 工具且零代码修改。
- 本地优先隐私：选择、压缩、验证全部在本机，无默认遥测，代码不上传。
- 基准透明：README 明确披露 SQuAD 2.0 准确率下降（80%→72%）等不利结果，而非只报好数字。
- 压缩是权衡：SQuAD 2.0 上准确率从 80% 降至 72%，并非在所有任务上都无损失。
- savings 依赖流量路径：只有请求实际经过 Entroly 控制的路由才产生 provider 侧节省；对 GitHub 托管的 Copilot 订阅推理不声称拦截。
- 额外运行面：需要维护一个本地进程（代理/守护进程/MCP 服务器），对微型仓库或本已很小的提示是纯粹的传递开销。
- 长上下文不省钱：填满 GPT-6 Astra 的 869,500 token 窗口不降低请求成本，费用按 provider 计费。
- 模型元数据分层：部分模型（如 Kimi K3、GLM-5.3）只有'announced'而非'verified'记录，OpenClaw 预算解析会拒绝它们。
- 模型路由有风险边界：会在实际请求上替换模型，因此默认关闭且 fail-closed。
如何安装或部署这个 Agent？
推荐 Python 完整版：pip install -U entroly。备选：npm install -g entroly（Node/WASM 版）、brew install juyterman1000/entroly/entroly（Homebrew）、docker pull ghcr.io/juyterman1000/entroly:latest（Docker）、或在 entroly-core/ 目录运行 cargo build --release --bin entroly-rs --features proxy 构建独立 Rust 二进制。包运行器：npx -y entroly@latest --help 或 uvx --from entroly entroly --help。可安装额外组件：entroly[proxy]、entroly[native]、entroly[full]。唯一例外的外呼：若原生引擎缺失会从 PyPI 安装（可用 ENTROLY_NO_SELF_HEAL=1 禁用）。本地安装与常规测试无需 API key。
如何使用这个 Agent？
最快上手：pip install -U entroly && entroly go——自动检测编辑器、包装 agent 并打开前后对比仪表盘。免费验证（无需 API key）：cd /your/repo && entroly verify-claims && entroly simulate。MCP 用户：entroly attach create --client claude --project . --ttl 4h --install（或 Cursor/VS Code 用 entroly init）。SDK 用户：from entroly import compress; compressed = compress(api_response, budget=2000)。代理用户：entroly proxy，然后把 ANTHROPIC_BASE_URL 或 OPENAI_BASE_URL 指向 localhost:9377。恢复被舍弃内容：entroly recover sha256:0b957c79... --out restored.。故障排查：entroly doctor；查看能力：entroly capabilities。