基于 Rust 的终端 AI 编程助手,支持多种大模型,提供交互界面、单次命令和 ZSH 插件模式。
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
使用 Cargo 安装(需要 Rust 1.90 或更新版本)
cargo install --locked --git https://github.com/hystax/optscale-kompressor kompressor-cli - 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 数据每日更新。
相关项目
基于 Rust 的开源递归编程智能体,提供持久化 Python 工作区、子智能体,并支持多种模型服务商。
命令行优先的开源 AI 编程代理运行时,支持任意模型和 MCP 工具,可交互、管道、守护进程或通过 WebSocket 使用。
OpenAI 推出的轻量级编程智能体,可在本地终端中运行,协助编写和修改代码。
在内容发送给大模型前压缩工具输出、日志、文件和 RAG 片段的上下文压缩层。
基于 Rust 的终端编程智能体,源自 OpenAI Codex,专为低成本与开源模型优化。