Headroom Desktop

功能说明：这是一款跨平台桌面托盘应用，位于您的代码生成工具（Claude Code、OpenAI Codex、OpenCode AI 与 Grok Build）与其调用的 LLM API 之间。它运行一个本地优化管线，压缩提示词、工具输出与日志，在保持相同结果的前提下，将发送给模型的 Token 数量减少约一半。

重要性：Token 用量是 LLM 驱动的代码助手的主要成本来源。通过在请求到达模型前移除样板代码、冗余的 JSON 与旧的对话记录，Headroom 可以在不改变您工作流程的情况下，将您为 Claude Code 或 Codex 支付的费用减半。

运作方式：

• 一个基于 Tauri 的 Rust 托盘应用会在 127.0.0.1:6767 启动一个本地 HTTP 代理。
• 您的代码客户端会自动重新配置（通过小型 Hook 或环境变量）以指向该代理。
• 代理将请求转发到第二个本地端口上托管的 Python 执行环境（headroom + 选配工具），请求在此处进行优化，然后发送到真正的 Anthropic 或 OpenAI 端点。
• 响应以相同路径传回，并根据需求还原原始内容。
• UI 显示 Token 节省量的实时仪表板、各客户端的统计数据以及选配的附加工具。

关键技术细节：

• 零主机污染 – Headroom 在应用数据文件夹下安装其独立的 Python（约 3 GB）；它绝不会触碰系统 Python 或全局 PATH。
• 跨平台 – macOS (universal)、Windows 10+、Linux (preview) 构建版本均由单一标签发布。
• 可扩展性 – 可从 UI 启用选配的附加组件（rtk, markitdown, serena 等）；它们皆在本地运行。
• 开源 Shell – 桌面 UI 与代理代码采用 MIT 授权；订阅服务与后端为私有。
• 安全性 – 配置变更会进行备份，且在退出/卸载时会移除所有重定向，确保客户端运作方式与先前完全相同。

适用对象：已经使用 Claude Code、Codex、OpenCode 或 Grok Build，且希望在不重写工具的情况下减少 Token 账单的开发者。它也适合需要可预测、本地托管优化层的 AI 代理开发者。

安装：macOS 使用 Homebrew cask，或从 GitHub releases 页面直接下载 DMG/EXE/AppImage。该应用在 macOS 上已签名/公证，并包含内置更新程序。

授权：桌面 Shell（src/ 与 src-tauri/）采用 MIT 授权。运行该应用需要付费的 Headroom 账户（提供 7 天免费试用）。