Repolode
hystax

hystax/optscale-kompressor

用 Rust 编写的单一二进制工具,对编码智能体的提示词和工具输出做确定性压缩,被移除的内容可按需找回。

Star
21
Fork
6
未关闭 Issue
13
最近提交
17小时前

这是什么?

OptScale Kompressor 用于缩减编码智能体(如 Codex、Claude Code、Aider)每一步重新发送给模型的工作历史,主要针对冗长的构建日志、编译器输出和目录列表。它的核心是确定性:相同输入在每一轮都输出相同字节,因此服务商的提示词缓存可以持续命中。每个被移除的片段都保存在按内容寻址的句柄之后,模型可通过检索工具取回。

项目以单一二进制形式提供,同时可作为命令行工具、HTTP API、MCP 服务器以及 OpenAI Chat Completions、OpenAI Responses 和 Anthropic Messages 的 LLM 代理使用。执行 `kompressor wrap codex` 即可启动代理、将智能体指向它并在退出时清理。压缩在本地完成,无需下载模型,并使用有序的内容检测规则和编译进来的 tree-sitter 语法处理源代码。支持三种模式:aggressive(有损)、lossless(无损)和默认的 recoverable(可恢复)。

仓库中给出的数据显示,在 89 个任务的 Terminal-Bench 2.1 测试中,相比不压缩,费用降低 22.7%,统计基于包含提示词缓存折扣的真实账单。

核心功能

  • 01输出具有确定性,跨轮次保持提示词缓存命中。
  • 02被移除的内容可通过句柄和内置检索工具取回。
  • 03可包装 Codex、Claude、Aider、OpenCode、Cursor,也可作为任意客户端的代理使用。
  • 04本地运行,无需下载模型,基于规则检测并用 tree-sitter 解析源代码。
  • 05同一个二进制同时提供命令行、HTTP API、MCP 服务器和 Rust 库。

适用场景

  • 降低长时间运行的编码智能体会话中,因冗长构建或测试输出带来的 token 费用。
  • 让团队的 LLM 请求经过共享的本地代理,压缩工具返回结果。
  • 为支持 MCP 服务器的智能体增加基于 MCP 的压缩与检索能力。

快速上手

  1. 1

    使用 Cargo 安装(需要 Rust 1.90 或更新版本)

    cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli
  2. 2

    通过压缩代理运行 Codex

    kompressor wrap codex

使用前须知

  • 自动包装仅支持 Codex;Claude Code 会原样转发而不做压缩。
  • cursor-agent 不受支持,因为代理无法读取其协议。
  • 基准数据由项目方 OptScale AI 自行发布。

标签

常见问题

optscale-kompressor 是什么?
用 Rust 编写的单一二进制工具,对编码智能体的提示词和工具输出做确定性压缩,被移除的内容可按需找回。 OptScale Kompressor 用于缩减编码智能体(如 Codex、Claude Code、Aider)每一步重新发送给模型的工作历史,主要针对冗长的构建日志、编译器输出和目录列表。它的核心是确定性:相同输入在每一轮都输出相同字节,因此服务商的提示词缓存可以持续命中。每个被移除的片段都保存在按内容寻址的句柄之后,模型可通过检索工具取回。
optscale-kompressor 可以免费使用吗?用的什么许可证?
optscale-kompressor 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
optscale-kompressor 还在维护吗?
活跃维护中。optscale-kompressor 最近一次提交是在 2026年10月20日。
optscale-kompressor 适合用来做什么?
降低长时间运行的编码智能体会话中,因冗长构建或测试输出带来的 token 费用。 让团队的 LLM 请求经过共享的本地代理,压缩工具返回结果。 为支持 MCP 服务器的智能体增加基于 MCP 的压缩与检索能力。
optscale-kompressor 怎么安装和运行?
使用 Cargo 安装(需要 Rust 1.90 或更新版本): cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli 通过压缩代理运行 Codex: kompressor wrap codex
在哪里获取 optscale-kompressor?
源代码和安装说明在 GitHub 上:https://github.com/hystax/optscale-kompressor

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目