@rsrini/pi-headroom
为AI编码助手节省30-60%令牌的本地压缩代理
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@rsrini/pi-headroom。 它的用途是：为AI编码助手节省30-60%令牌的本地压缩代理 完整的 Skill 内容见：https://321skill.com/skills/rsrini-pi-headroom/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析这个src/目录下所有模块的依赖关系并给出重构建议。” 由于涉及文件多，请求内容长，Headroom代理会自动压缩你的请求，节省大量输入令牌。AI处理完并返回答案时，代理也会确保你收到完整的响应。
介绍
这个Skill解决了用户在使用pi-coding-agent等AI编码助手时，因长上下文或频繁交互导致令牌消耗过快、成本高昂的问题。它通过在本地运行一个Headroom压缩代理，将发送给AI模型的请求进行智能压缩，从而显著减少每次请求消耗的令牌数量。
使用方式很简单，用户需要先确保本地环境已安装Node.js，然后通过npm安装此扩展。安装后，在启动你的AI编码代理（如pi-coding-agent）时，配置其请求通过本地的Headroom代理端点即可。该代理会自动处理请求的压缩与解压，对用户透明。
它非常适合频繁使用AI进行代码生成、审查或调试的开发者，尤其是那些需要处理大型代码库、进行深度对话导致上下文很长的用户。对于个人开发者或注重成本控制的小团队来说，这是一个能直接降低AI使用成本的实用工具。
需要注意的是，由于请求经过了额外的压缩/解压步骤，可能会引入微小的延迟。在追求极致低延迟的交互场景下需权衡利弊。此外，它主要优化的是发送给模型的提示（Prompt）令牌，对模型输出的令牌节省效果取决于模型本身。建议在非实时性要求极高的开发任务中启用。
核心特点
这是专为pi-coding-agent设计的本地代理扩展，能无缝集成并实现请求级压缩；同时支持CCR检索，能在压缩过程中保持关键信息的可用性，而不仅仅是简单的文本压缩。
注意事项
不适合对请求响应延迟极其敏感或需要绝对原始文本保真度的场景。
常见问题
能节省多少令牌？
根据官方描述，通常可节省30-60%的令牌消耗。
支持哪些AI助手？
目前主要设计用于pi-coding-agent，可能通过配置支持其他基于类似架构的代理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/rsrini-pi-headroom/raw/index.md 读取 @rsrini/pi-headroom 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/rsrini-pi-headroom/raw/index.md（查看排版版本）