rtk

在 AI 辅助编程日益普及的今天，开发者发现了一个隐蔽的成本黑洞：命令行工具的输出往往充斥着大量噪音。

当 Claude Code、Cursor 或其他 AI Agent 执行 git diff、cargo test 或 ls -R 时，原始的输出可能包含数千个 Token 的冗余信息（如空白行、重复日志、无关文件路径）。这些内容不仅浪费了昂贵的 Token 配额，还稀释了上下文的信噪比，导致 AI 难以聚焦关键问题。

rtk 是一款基于 Rust 构建的高性能 CLI 代理，它拦截命令输出，在送入 LLM 上下文之前进行智能过滤与压缩。

• 极致性能：单一二进制文件，零依赖，处理开销 <10ms。
• 惊人效果：实测可将 30 分钟 Claude Code 会话的 Token 消耗降低 80% 以上。
• 无缝集成：自动钩入现有工作流，无需修改任何代码。

💰 成本账：一次会话节省 80% Token

让我们看一组真实数据对比（基于 30 分钟典型开发会话）：

这意味着，原本需要消耗 11.8 万 Token 的操作，现在仅需 2.4 万。对于高频使用 AI 编程的团队，这直接转化为显著的账单缩减和更长的上下文窗口。

⚙️ 工作原理：四层智能压缩策略

rtk 并非简单的截断工具，它通过四种策略深度理解并重构输出内容：

1. 智能过滤 (Smart Filtering)
   • 自动去除注释、多余空白、样板代码和无关的系统提示信息。
   • 示例：将冗长的构建日志简化为关键错误行。
2. 分组聚合 (Grouping)
   • 将相似项合并展示。例如，将同一目录下的多个文件变更聚合显示，或将同类错误归类。
   • 示例：ls 输出不再罗列所有文件，而是按目录结构摘要展示。
3. 智能截断 (Truncation)
   • 保留最相关的上下文（如错误堆栈的前后几行），删除中间冗余部分。
   • 示例：长 Diff 只显示变更块，隐藏未改动的代码段。
4. 去重计数 (Deduplication)
   • 识别重复的日志行或错误信息，合并为一条并标注出现次数。
   • 示例：循环中的重复报错只显示一次，标记“重复 50 次”。

流程对比：

• 没有 rtk：Claude → git status → Shell → Git → 2,000 Tokens 原始输出 → Claude 上下文。
• 使用 rtk：Claude → git status → rtk (过滤/压缩) → Git → 200 Tokens 精简输出 → Claude 上下文。

🚀 快速开始：一键安装，自动生效

rtk 支持 macOS、Linux 和 Windows，安装极其简便。

1. 安装

macOS (Homebrew 推荐):

brew install rtk

Linux / macOS (快速脚本):

curl -fsSL https://raw.githubusercontent.com/rtk-ai/rtk/refs/heads/master/install.sh | sh

Rust Cargo:

cargo install --git https://github.com/rtk-ai/rtk

2. 验证安装

rtk --version   # 应显示 "rtk 0.27.x"
rtk gain        # 查看当前的 Token 节省统计

3. 集成到 AI 工作流（以 Claude Code 为例）

只需一条命令，rtk 即可全局钩入 Claude Code：

rtk init --global

重启 Claude Code 后，当你输入 git status 时，系统会自动将其重写为 rtk git status，全程无感，即刻享受压缩后的输出。

🛠️ 核心命令速查

rtk 覆盖了开发全流程的高频命令：

📂 文件操作

• rtk ls .：优化的目录树，按类型分组。
• rtk read file.rs：智能读取，自动跳过无关区域。
• rtk find "*.rs" .：紧凑的查找结果。
• rtk grep "pattern" .：按文件分组的搜索结果，高亮关键行。

🌿 Git 管理

• rtk git status：紧凑状态，仅显示变更概要。
• rtk git log -n 10：单行提交记录，清晰易读。
• rtk git diff：精简 Diff，隐藏上下文噪音。
• rtk git push：成功时仅返回 "ok main"。

🧪 测试与构建

• rtk test cargo test：节省 90%，仅显示失败用例和关键错误。
• rtk vitest run / rtk pytest / rtk go test：全语言支持，统一紧凑输出。
• rtk cargo build / rtk tsc / rtk lint：构建错误按规则分组，快速定位。

🐳 容器与运维

• rtk docker ps / rtk kubectl pods：紧凑列表，突出状态异常项。
• rtk docker logs <container>：去重日志，自动折叠重复行。

📊 分析与洞察

• rtk gain：查看本次会话的 Token 节省详情。
• rtk gain --graph：生成 ASCII 图表，展示 30 天节省趋势。
• rtk discover：智能分析你的习惯，发现未被优化的命令机会。

💡 为什么选择 rtk？

• 零配置负担：安装即忘（Install & Forget），自动适配主流 AI 编程助手。
• 极致轻量：Rust 编写，无运行时依赖，内存占用极低。
• 隐私安全：所有处理均在本地完成，命令输出绝不上传至 rtk 服务器。
• 持续进化：社区驱动，不断适配新的 CLI 工具和输出格式。