sqz

工具输出进模型前先压缩去重，省 token 降成本

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署 自动化工作流 🍴 复刻 43 🐛 待处理 3 👀 关注 6
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 678
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费，Rust实现，零LLM调用

项目预览

sqz 项目界面预览图
图片来源：GitHub 官方仓库名片

项目数据

分类自动化工作流
开发团队ojuschugh1
官网地址https://ojuschugh1.github.io/sqz
GitHubhttps://github.com/ojuschugh1/sqz
定价模式🏷️完全免费
价格说明开源免费，Rust实现，零LLM调用
访问状态🔧 仅开源项目，无在线服务，需自行部署
是否开源是
开源协议Apache-2.0
主要语言Rust
技术栈/模型agentic-ai,ai-agents,claude-code,cli,codex,coding-agents,context-compression,context-window,cost-optimization,cursor,developer-tools,llm,llms,mcp,mcp-server,open-source,prompt-caching,rust,token-optimization,tokens
GitHub 星标★ 678
上线时间2026-04-12 00:00:00
代码更新2026-10-22
仓库体积9.6 MB
本站数据更新2026-11-12
维护状态较活跃
收录时间2026-09-28
浏览次数1

项目介绍

sqz 是一个用 Rust 编写的上下文压缩工具，专门服务于 AI 编程代理（如 Claude Code、Cursor、Codex、Kiro、Zed 及任意 MCP 客户端）。它解决的核心问题是：代理在调用工具（读文件、跑命令、搜索代码）时会产生大量冗长输出，这些内容直接塞进模型上下文会迅速耗尽窗口、推高成本并稀释关键信息。sqz 在工具输出进入模型之前就进行压缩，对重复出现的内容做去重，用仅 13 个 token 的引用替代大段重复文本，从而显著降低 token 消耗。它完全在本地运行，不调用任何 LLM，因此没有额外 API 费用和延迟，也不依赖模型能力。作为命令行工具，它可以接入现有代理工作流，对使用者透明。项目处于早期阶段但增长较快，适合关注上下文成本与代理效率的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-28 · 当前星标 ★ 678

使用教程

难度：进阶 约 25 分钟 部署方式：本地安装 4 步

环境要求

  • Rust 或 Node.js
  • 支持 MCP 的编码助手

安装与启动步骤

  1. 1安装

    压缩上下文里的工具输出，cargo 或 npm 均可。

    cargo install sqz-cli sqz-mcp

  2. 2或用 npm

    不想装 Rust 工具链时走 npm。

    npm install -g sqz-cli

  3. 3接进 agent

    把 sqz 作为 MCP 服务登记，让工具输出先过它。

  4. 4观察 token 变化

    同一任务对比接入前后的输入 token 数。

如何确认成功

工具输出被压缩且信息未丢失

注意事项

  • 压缩只针对日志与文件读取这类冗长输出，别用在代码回写上。
  • 过度压缩会丢关键错误行，先小范围验证。

核心亮点

  • 纯 Rust 实现、零 LLM 调用，压缩过程不产生额外 API 费用和网络延迟
  • 针对重复工具输出做去重，用 13-token 引用替代大段内容，直接节省上下文窗口
  • 兼容 Claude Code、Cursor、Codex、Kiro、Zed 及任意 MCP 客户端，接入面广

不足之处

  • 项目较新，长期稳定性与边界场景覆盖仍需观察
  • 压缩策略对非重复型长输出效果可能有限，文档与社区案例待丰富

适用场景

  • 在 Claude Code 中读取大型代码库文件时，压缩重复的 import 和样板代码
  • 使用 Cursor 跑测试或构建命令，压缩冗长的日志输出再送入模型
  • 通过 MCP 客户端调用多个工具，统一压缩各工具返回结果以控制上下文长度

替代项目

LLMLingua、repomix

上一篇：awesome-openclaw

下一篇：invisible_playwright_mcp

同类项目推荐

job-application-agent 开源

让 AI 帮你投简历，事实不编造、密码不泄露、提交前你点头

JobAppAgent: open-source AI job application agent (Agent Skill + CLI). Searches wide···

★ 175 2026-09-15
gawkbot 开源

让 AI 替你干杂活，还给你生成管理小应用

open source grok bot. gawk bots automate your menial work via AI models and build yo···

★ 1563 2026-09-14
insta-p8 开源

自托管 Instagram 自动化，AI 回复+评论转私信，省时提效

Open-source ManyChat alternative for Instagram DM, comment, story automation and AI ···

★ 184 2026-08-09
pbottleRPA 开源

用脚本+AI 搞定浏览器和桌面重复操作

pbottleRPA is a professional RPA+AI software for professional users. It supports pr···

★ 154 2026-08-10
pojia-next 开源

双击一下，六个 AI 客户端的提示词人格全换好，还能一键还原

四个 AI 客户端的内置提示词一键替换：DSH / WorkBuddy / ZCode / Codex。双击即用、可自证···

★ 1135 2026-10-19
livecontext-ce 开源

用聊天描述任务，自动生成可用的 AI 工作流和代理。

The AI automation platform, self-hosted. Describe the job in chat and LiveContext bu···

★ 782 2026-08-09
video-recap-skills 开源

丢进视频，自动生成中文解说剪辑，还能导出剪映

AI 视频解说全流程 skill 包：自动切镜头、看画面写解说词、配音合成成片，支持一键导出可···

★ 621 2026-08-09
conductor 开源

用命令行编排多个 AI 智能体，几步跑通协作流程

A CLI tool for defining and running multi-agent workflows with the GitHub Copilot SD···

★ 497 2026-09-15
bookmarksAI 开源

让 GPT 自动帮你把杂乱书签整理得井井有条

GPT automatically organizes your browser bookmarks

★ 129 2026-08-09