rtk - 开源 LLM Token 消耗削减工具

解决什么

AI 编程助手(如 Claude Code、Cursor)在处理项目时会将大量文件内容作为上下文发送给 LLM,导致 Token 消耗激增。一个中型项目的单次查询可能消耗数十万 Token,按 Claude 3.5 Sonnet 定价计算,频繁使用者月成本可达数百美元。rtk 通过在 CLI 层面代理 AI 工具的文件读取请求,智能过滤掉 node_modules、.git、编译产物等无关内容,在保持功能完整性前提下将 Token 用量削减 60-90%。

为何火

项目在 GitHub 获得 8 万+ stars,核心吸引力在于"零配置降本"。开发者无需修改现有 AI 工具配置,仅需在命令前加 rtk 前缀即可生效。Rust 实现保证了毫秒级过滤延迟,单二进制分发消除了 Python/Node.js 环境依赖问题。据公开案例,某 React 项目从单次 15 万 Token 降至 2 万,成本直降 86%。在 AI 编程工具普及但 API 费用高企的背景下,该工具切中痛点。

核心功能

1. 智能文件过滤:基于 .gitignore 规则自动排除依赖目录、日志、缓存等,支持自定义黑名单
2. 增量上下文:通过 SQLite 缓存已发送内容,仅传输变更部分
3. 多编码支持:处理 Windows 代码页(ANSI/OEM)和 UTF-8 混合场景,避免乱码
4. 透明代理:拦截 AI 工具的文件系统调用,对上层应用无感知
5. 统计报告:实时显示节省的 Token 数量和成本

安装

从 GitHub Releases 下载对应平台的二进制文件(Linux/macOS/Windows),赋予执行权限后移动到 PATH 目录:

# macOS/Linux
curl -L https://github.com/rtk-ai/rtk/releases/latest/download/rtk-$(uname -s)-$(uname -m) -o rtk
chmod +x rtk && sudo mv rtk /usr/local/bin/

# 使用
rtk claude-code analyze-project

无需安装 Rust 工具链或其他依赖,配置文件自动生成在 ~/.config/rtk/。

适合谁

• 高频 AI 编程用户:每日使用 Claude Code/Cursor 超过 10 次的开发者,月省数百元 API 费用
• 大型项目团队:代码库超过 10 万行,常规上下文窗口无法容纳全部文件
• 成本敏感场景:创业公司或个人开发者,需严格控制 LLM 开支
• 离线优先需求:本地缓存机制减少重复网络请求

中国用户注意:Claude API 需梯子访问,国内 AI 工具(如通义灵码)集成需自行适配。

社区评价

HN 讨论热度中等(18 点),主要争议集中在命名冲突:多位开发者指出 "rtk" 已被 RTK GPS 定位库和 Redux Toolkit 广泛使用,README 首段专门声明"与 RTK GPS 无关"反映作者意识到问题但未更名。有无人机 LiDAR 开发者表示"心智负担很大"。

技术层面获正面认可:Rust 实现的性能和零依赖特性被称赞。有用户提问"能否支持 Gemini 等其他 Agent",暗示需求存在但当前主要针对 Claude 优化。1603 个 open issues 显示活跃但也反映功能请求和 bug 报告积压,需关注维护节奏。

选型对比

维度	rtk	手动 .clignore	Cursor 内置过滤
自动化	CLI 代理透明	需逐项目配置	依赖编辑器实现
跨工具	支持任意 CLI	仅特定工具	仅 Cursor
性能	Rust 原生	无额外开销	JavaScript 层
增量缓存	内置 SQLite	无	部分支持

取舍:rtk 适合多工具切换场景,但引入额外进程;手动配置更可控但维护成本高;编辑器内置方案最便捷但锁定生态。

已知坑

1. 命名混淆:与 RTK GPS/Redux Toolkit 重名,搜索和讨论易产生歧义
2. API 兼容性:主要测试 Anthropic Claude,其他 LLM(Gemini/GPT-4)支持需验证
3. Windows 编码:虽支持代码页转换,但非 UTF-8 项目可能遇到边缘情况
4. 配置透明度:默认过滤规则较激进,可能误排除关键文件(如自定义构建脚本),需检查 ~/.config/rtk/filters.toml
5. 网络依赖:中国大陆用户需稳定梯子,否则 Claude API 调用失败时工具无法降级

建议首次使用时对比原始 AI 工具输出,确认过滤未影响代码理解准确性。