SuperCompress

SuperCompress

SuperCompress v2 — 为编码 Agent 减少约 64% 的大模型输入 token，且不丢失答案。

SuperCompress API 使用约 4 亿参数的 Neural Keep，根据当前问题为臃肿的上下文（文件、日志、工具输出、粘贴内容）打分，并丢弃其余内容。你的问题保持原样。此软件包通过 MCP + hooks 将 Cursor / Claude Code / Codex / 40 多种运行环境接入该 API。

网站 · 基准测试 · 在线体验 · 文档

---

安装

npm install -g supercompress-proxy

需要 Node.js 18+。

---

快速开始（推荐）

只需一条命令即可关联账户，并在 40 多种运行环境中自动添加 MCP + hooks（其中 25 多种支持原生自动 MCP 插件 — Cursor、Claude Code、Codex、Goose、Zed、OpenCode、fx、Hermes、OpenClaw、Grok Build、Grok Bot（托管 MCP URL）、Gemini、Windsurf、Continue 等）：

supercompress setup
supercompress doctor

然后重启 Agent，让集成重新加载。就这么简单。

稍后重新检测（例如安装了新的 Agent）：

supercompress plugin
supercompress agents
supercompress doctor

其他任意 Agent（自定义运行环境、闭源、DIY）：

supercompress agents connect

此命令会输出一个 stdio MCP 配置片段，并生成一个 Agent Plugins 1.0 包，可将其放入任何兼容的客户端。

基准测试

保留预算相同（保留 35% 的 token）。哪种方法还能保留答案？

方法	保留答案的关键内容
FIFO / 截断	24.8%
摘要	60.5%
H2O	97.9%
SuperCompress	100%

指标	结果
Oracle 召回率（固定预算）	100%
平均 token 削减量（真实测试集）	~67%
保留的重要行（编译器）	100%

完整方法说明和图表：supercompress.dev/benchmarks

---

工作原理

Your agent ──→ SuperCompress (hooks / MCP) ──→ smaller context ──→ model
                      ↑
                 query stays whole; only context is compressed

1. 你提出问题（问题不会被改写）。
2. 根据该问题为大量上下文打分。
3. 保留证据关键行的原始措辞；丢弃冗余内容。
4. 你只需为更少的输入 token 付费。

---

命令

命令	功能
supercompress / tui	交互式纸张风格 UI（TTY 中默认启用；Bun）
supercompress setup	推荐 — 关联账户、检测 Agent、安装 MCP + hooks
supercompress plugin	随时刷新 Agent 集成
supercompress doctor	各运行环境的健康状态矩阵（账户 / MCP / hooks）
supercompress agents	40 多种运行环境目录 — 自动插件与配置/连接方式
supercompress start / stop / status	可选的本地代理（setup --proxy）
supercompress usage	套餐、配额、节省情况（支持 --json）
supercompress limits	提供商速率限制可用时长 — 5 小时 / 每周窗口（供 Agent 使用时加上 --json）
supercompress uninstall	移除 ~/.supercompress 下的配置

如果你明确需要，可选用本地主机 API 代理（重写基础 URL）：

supercompress setup --proxy
supercompress start

然后将 OpenAI/Anthropic 兼容客户端指向 http://localhost:8080/v1。

---

MCP

setup / plugin 会在每个检测到的主机上注册 MCP 服务。你也可以直接运行：

supercompress-mcp

手动注册：

{
  "mcpServers": {
    "supercompress": {
      "command": "supercompress-mcp"
    }
  }
}

工具	用途
compress_context	压缩查询所需的臃肿上下文
connect_account	将此安装关联到你的控制面板
usage_summary	查看已连接账户的节省情况
runway_check	提供商速率限制可用时长（本地运行，无需账户）

---

Runway（速率限制）

supercompress limits --json / MCP runway_check 会告知 Agent 剩余的服务商配额，以及如何使用。它基于 limitcheck 构建，并扩展到 SuperCompress 接入的所有运行环境。Runway 在本地、此软件包内部运行；你的用量数据绝不会经过托管 API，托管 MCP 也没有 runway 工具。每次检查（limits 状态或 runway_check，不包括状态栏）都会向 limitcheck.supercompress.dev 上的公开总计发送一条匿名计数：只有判定结果（go / land / pace / wait / unknown）以及 cli 或 mcp。不包含 ID、用量数字、提示词或路径。可通过 SUPERCOMPRESS_TELEMETRY=0、DO_NOT_TRACK=1 或 SUPERCOMPRESS_RUNWAY=0 退出。setup / plugin 会自动安装：将 runway 规则添加到每个 Agent 的指令和技能中，在本地 MCP 上注册 runway_check，将独立运行时复制到 ~/.supercompress/runway/，并连接 Claude Code 的状态栏。uninstall 会撤销所有更改。

来源	运行环境
~/.codex/sessions 速率限制事件（无需配置）	Codex
由 setup 接入的状态栏 tee（或使用 supercompress limits connect claude-code）。你自己的状态栏保持原样，继续正常工作	Claude Code
本地代理捕获到的上游速率限制标头（Anthropic、OpenAI、xAI、OpenRouter、Codex）	经由 localhost:8080 路由的任何运行环境（Aider、Continue、Cline、OpenCode、Goose 等）
supercompress limits ingest --provider <id>（stdin JSON）/ SUPERCOMPRESS_LIMITS_SNAPSHOT / LIMITCHECK_SNAPSHOT	其他所有环境（Cursor、Windsurf、Grok Build、Gemini CLI、自定义钩子）

操作：go（附带 scope）、land（继续工作，并在每个步骤前创建检查点）、pace（仅适用于平衡策略）、wait（配额确实已耗尽——提供 waitMinutes、alternatives）、unknown（无数据来源；绝不臆造）。

默认的 max 策略会利用整个 5h 窗口，直到服务商的重置时间，而不是在固定的 10% 阈值处停止：短窗口会自动重置，因此未使用的配额会被浪费。每周／每月窗口则根据使用节奏判断（剩余百分比与剩余时间）。--policy conservative 会保留 limitcheck 的 25% / 10% 阈值。在预置模拟（node test/runway-sim.js）中，max 会用尽 100% 的受限 5h 窗口（而非 91.5%），完成步骤增加 7.8%，并在 60 个截止时间中的 59 个之前创建检查点。SUPERCOMPRESS_RUNWAY=0 会阻止 setup 修改状态栏，并禁用代理标头捕获。只存储速率限制数字（~/.supercompress/limits/），绝不存储提示词或响应。

---

账户与定价

发布促销：每月免费提供 5M tokens，之后可通过控制面板按每 1M 收费 $0.10。

---

隐私

钩子／MCP 在你的设备上运行。服务商 API 密钥由你的 Agent 保管。上下文文本会发送到 SuperCompress API，以便托管编译器对其进行压缩。

---

更多信息

• 编码 Agent：https://docs.supercompress.dev/coding-agents
• HTTP / Python API：https://docs.supercompress.dev/quickstart
• 源代码：https://github.com/Supercompress/Supercompress

许可证

MIT — 详见 LICENSE。