RTK 快速上手5 分钟完成 Hook 初始化并验证 Token 节省【免费下载链接】rtkCLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies项目地址: https://gitcode.com/GitHub_Trending/rtk4/rtk本篇基于 RTK 官方 Quick Start 文档quick-start.md带你走完从验证安装、初始化 AI 助手 Hook、透明改写命令到查看节省看板的完整路径。读完后你将能够正确执行rtk init含--dry-run预演、理解 Hook 如何在你无感知的情况下把cargo test改写为rtk cargo test、用rtk gain量化 token 节省以及通过rtk proxy对未覆盖命令走直通模式——并顺带了解每一步背后的 Rust 源码实现以便排查问题时有据可依。前置条件确认 RTK 已安装并可用Quick Start 的第一要求是 RTK 已安装并验证通过rtk --version # rtk x.y.z rtk gain # shows token savings dashboard两条命令都能正常输出说明安装无误。如果尚未安装请先参考 安装指南其中覆盖了 curl 脚本、Homebrewbrew install rtk-ai/tap/rtk、Cargo 从 Git 源安装以及预编译二进制Windows/Linux/macOS四种方式。安装指南里特别提醒了一个易踩的坑存在另一个同名 crateRust Type Kit用于生成 Rust 类型与本项目Rust Token Killertoken 节省 CLI 代理无关。最直接的辨别方式就是rtk gain——能显示节省看板才是本项目的 RTK。这一点在 installation.md 中有专门章节说明初始化前值得先确认。Step 1为你的 AI 助手初始化 Hook安装后的第一个实质操作是rtk init它负责写入自动改写命令的 Hook# For Claude Code (global — applies to all projects) rtk init --global # For a single project only cd /your/project rtk init区别在于作用域--global修改用户级settings.json对所有项目生效不带该标志则只初始化当前项目。执行完成后必须重启 AI 助手Hook 才会生效。预演而不落盘--dry-run在确认init到底会改什么之前可以加--dry-run做一次纯预演rtk init --global --dry-runQuick Start 文档对其行为的描述是所有将要发生的文件创建/更新/补丁操作都会以[dry-run] would ...前缀打印出来最后以[dry-run] Nothing written.结尾。磁盘上不会被修改任何内容——不 patchsettings.json也跳过遥测telemetry同意提示。再加-v可以打印 RTK 本要写入的完整文件内容rtk init --global --dry-run -v这一点与源码完全对应。src/hooks/init.rs 中定义了一个贯穿所有 init 子模式的共享上下文/// Shared context threaded through every init/uninstall function. #[derive(Clone, Copy, Default)] pub struct InitContext { pub verbose: u8, pub dry_run: bool, } /// Shared dry-run footer printed at the end of every init sub-mode. fn print_dry_run_footer() { println!(\n[dry-run] Nothing written.); }verbose对应-v计数src/main.rs 中verbose参数用ArgAction::Count实现即-v/-vv/-vvv三级dry_run标志则驱动所有写入路径进入只打印不执行模式。命令参数层面--dry-run与--show被声明为互斥conflicts_with show见 src/main.rs这解释了文档中--dry-runcannot be combined with--show的限制。文档还指出--dry-run适用于所有 init 变体例如--agent cursor、--gemini、--codex、--copilot、--uninstall等。从 src/main.rs 的AgentTarget枚举看RTK 目前支持的 agent 目标包括 Claude、Cursor、Windsurf、Cline、Kilocode、Antigravity、Kimi、Pi、Hermes、Droid、Vibe——也就是说预演能力对每个 agent 的安装/卸载流程都可用。源码视角init实际会写什么从 src/hooks/init.rs 的常量定义可以确认初始化涉及的文件面settings.json补丁补丁行为由PatchMode枚举控制——Ask默认交互式确认[y/N]、Auto对应--auto-patch免确认、Skip对应--no-patch仅输出手工配置说明结果状态则覆盖Patched、AlreadyPresent、Declined、Skipped、WouldPatchdry-run 下的本应添加等情形src/hooks/init.rs。RTK.md/CLAUDE.md/AGENTS.md/GEMINI.md源码中维护了RTK_BLOCK_START!-- rtk-instructions标记块用于在助手指令文件中幂等地注入/定位 RTK 说明。嵌入式插件init 流程通过include_str!内嵌了 hooks/opencode/rtk.ts、hooks/pi/rtk.ts 以及 hooks/claude/rtk-awareness.md 等文件内容说明 OpenCode、Pi 等 agent 的自动改写插件是随二进制分发、初始化时落盘的不依赖额外下载。filters.toml模板若项目还没有自定义过滤规则init 会写入带示例注释的filters.toml模板含match_command、strip_ansi、max_lines等字段示例项目级规则优先于用户全局与内置规则。这些细节意味着rtk init不是装个插件这么简单而是一组幂等、可预演、可交互确认的文件操作集合——这正是--dry-run存在的原因。Step 2照常使用你的工具链Hook 装好之后工作方式完全不变。你的 AI 助手照常执行命令Hook 在命令执行前透明地拦截并改写它。Quick Start 给出的典型例子是当 Claude Code 运行cargo test时Hook 会把它改写成rtk cargo test再执行。LLM 收到的是只含失败用例的过滤输出而不是 500 行测试通过的日志。你全程看不到、也不会手动敲rtk。从源码结构看各生态的过滤逻辑集中在 src/cmds 目录下按语言/工具拆分src/cmds/rust/cargo_cmd.rsCargo、src/cmds/js/vitest_cmd.rsvitest/jest、src/cmds/python/pytest_cmd.rs、src/cmds/git/git.rs 等src/main.rs 顶部的模块导入列表即是对接生态的总览——Git、Cargo/Rust、JavaScript/TypeScript、Python、Go、Ruby、.NET、PHP、Scala、JVMMaven/Gradle、Docker/Kubernetessrc/cmds/cloud/container.rs等。各命令的具体压缩效果如git status压缩 75–93%、cargo test约 90%、jest/vitest94–99%在 What RTK Optimizes 中有完整表格。该文档同时注明了一个重要前提表中百分比度量的是bash 输出被移除的字节数——这是 RTK 唯一直接控制的部分它是输入 token 的一个贡献项而不等于最终账单上的成本。Step 3查看你的节省看板跑了几条命令后用rtk gain查看累计节省rtk gainQuick Start 给出的示例输出Total commands : 12 Input tokens : 45,230 Output tokens : 4,890 Saved : 40,340 (89.2%)实现上看板渲染逻辑位于 src/analytics/gain.rsTotal commands与Input tokens通过print_kpi逐项输出同一模块还维护一张按命令维度统计的明细表列为Command / Count / Saved / Avg% / Time / Impact可以定位哪条命令省得最多。另外在 src/analytics/cc_economics.rs 中可以看到token 节省的估算基于chars/4 启发式近似每 4 字符约 1 token而非精确分词器阅读看板数字时应理解这一精度边界。Step 4未覆盖命令的 passthroughRTK 不认识的命令会走直通模式输出原样返回但使用行为仍被记录。例如rtk proxy make install在 src/main.rs 中可以看到 proxy 的约束——缺少命令参数时直接报用法错误Usage: rtk proxy command [args...]。源码还处理了带引号参数拆分的边界情况如rtk proxy git log --format%H %s会正确拆出 cmd 与 args并专门处理了 SIGINT/SIGTERM 下终止子进程、防止孤儿进程的问题对应 ISSUE #897 的注释。passthrough 的意义在于即使某条命令暂时无对应过滤器也不会阻断工作流且其行为数据会进入rtk gain的统计口径。下一步What RTK Optimizes按生态列出全部受支持命令及 bash 输出压缩比例并附节省口径说明。Supported agentsClaude Code、Cursor、Copilot 等 agent 的 Hook 支持细节。Configuration定制 RTK 行为包括项目级.rtk/filters.toml过滤规则字段示例见 src/hooks/init.rs 中的模板定义。小结RTK 的快速上手路径只有四步——rtk init可先--dry-run预演、照常使用工具链、rtk gain看节省、未覆盖命令用rtk proxy直通。整个过程不改变任何既有开发习惯节省效果通过看板可量化、可追溯。【免费下载链接】rtkCLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies项目地址: https://gitcode.com/GitHub_Trending/rtk4/rtk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/7 5:13:48 · 阅读 1.2k RTK 快速上手：5 分钟完成 Hook 初始化并验证 Token 节省
RTK 快速上手5 分钟完成 Hook 初始化并验证 Token 节省【免费下载链接】rtkCLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies项目地址: https://gitcode.com/GitHub_Trending/rtk4/rtk本篇基于 RTK 官方 Quick Start 文档quick-start.md带你走完从验证安装、初始化 AI 助手 Hook、透明改写命令到查看节省看板的完整路径。读完后你将能够正确执行rtk init含--dry-run预演、理解 Hook 如何在你无感知的情况下把cargo test改写为rtk cargo test、用rtk gain量化 token 节省以及通过rtk proxy对未覆盖命令走直通模式——并顺带了解每一步背后的 Rust 源码实现以便排查问题时有据可依。前置条件确认 RTK 已安装并可用Quick Start 的第一要求是 RTK 已安装并验证通过rtk --version # rtk x.y.z rtk gain # shows token savings dashboard两条命令都能正常输出说明安装无误。如果尚未安装请先参考 安装指南其中覆盖了 curl 脚本、Homebrewbrew install rtk-ai/tap/rtk、Cargo 从 Git 源安装以及预编译二进制Windows/Linux/macOS四种方式。安装指南里特别提醒了一个易踩的坑存在另一个同名 crateRust Type Kit用于生成 Rust 类型与本项目Rust Token Killertoken 节省 CLI 代理无关。最直接的辨别方式就是rtk gain——能显示节省看板才是本项目的 RTK。这一点在 installation.md 中有专门章节说明初始化前值得先确认。Step 1为你的 AI 助手初始化 Hook安装后的第一个实质操作是rtk init它负责写入自动改写命令的 Hook# For Claude Code (global — applies to all projects) rtk init --global # For a single project only cd /your/project rtk init区别在于作用域--global修改用户级settings.json对所有项目生效不带该标志则只初始化当前项目。执行完成后必须重启 AI 助手Hook 才会生效。预演而不落盘--dry-run在确认init到底会改什么之前可以加--dry-run做一次纯预演rtk init --global --dry-runQuick Start 文档对其行为的描述是所有将要发生的文件创建/更新/补丁操作都会以[dry-run] would ...前缀打印出来最后以[dry-run] Nothing written.结尾。磁盘上不会被修改任何内容——不 patchsettings.json也跳过遥测telemetry同意提示。再加-v可以打印 RTK 本要写入的完整文件内容rtk init --global --dry-run -v这一点与源码完全对应。src/hooks/init.rs 中定义了一个贯穿所有 init 子模式的共享上下文/// Shared context threaded through every init/uninstall function. #[derive(Clone, Copy, Default)] pub struct InitContext { pub verbose: u8, pub dry_run: bool, } /// Shared dry-run footer printed at the end of every init sub-mode. fn print_dry_run_footer() { println!(\n[dry-run] Nothing written.); }verbose对应-v计数src/main.rs 中verbose参数用ArgAction::Count实现即-v/-vv/-vvv三级dry_run标志则驱动所有写入路径进入只打印不执行模式。命令参数层面--dry-run与--show被声明为互斥conflicts_with show见 src/main.rs这解释了文档中--dry-runcannot be combined with--show的限制。文档还指出--dry-run适用于所有 init 变体例如--agent cursor、--gemini、--codex、--copilot、--uninstall等。从 src/main.rs 的AgentTarget枚举看RTK 目前支持的 agent 目标包括 Claude、Cursor、Windsurf、Cline、Kilocode、Antigravity、Kimi、Pi、Hermes、Droid、Vibe——也就是说预演能力对每个 agent 的安装/卸载流程都可用。源码视角init实际会写什么从 src/hooks/init.rs 的常量定义可以确认初始化涉及的文件面settings.json补丁补丁行为由PatchMode枚举控制——Ask默认交互式确认[y/N]、Auto对应--auto-patch免确认、Skip对应--no-patch仅输出手工配置说明结果状态则覆盖Patched、AlreadyPresent、Declined、Skipped、WouldPatchdry-run 下的本应添加等情形src/hooks/init.rs。RTK.md/CLAUDE.md/AGENTS.md/GEMINI.md源码中维护了RTK_BLOCK_START!-- rtk-instructions标记块用于在助手指令文件中幂等地注入/定位 RTK 说明。嵌入式插件init 流程通过include_str!内嵌了 hooks/opencode/rtk.ts、hooks/pi/rtk.ts 以及 hooks/claude/rtk-awareness.md 等文件内容说明 OpenCode、Pi 等 agent 的自动改写插件是随二进制分发、初始化时落盘的不依赖额外下载。filters.toml模板若项目还没有自定义过滤规则init 会写入带示例注释的filters.toml模板含match_command、strip_ansi、max_lines等字段示例项目级规则优先于用户全局与内置规则。这些细节意味着rtk init不是装个插件这么简单而是一组幂等、可预演、可交互确认的文件操作集合——这正是--dry-run存在的原因。Step 2照常使用你的工具链Hook 装好之后工作方式完全不变。你的 AI 助手照常执行命令Hook 在命令执行前透明地拦截并改写它。Quick Start 给出的典型例子是当 Claude Code 运行cargo test时Hook 会把它改写成rtk cargo test再执行。LLM 收到的是只含失败用例的过滤输出而不是 500 行测试通过的日志。你全程看不到、也不会手动敲rtk。从源码结构看各生态的过滤逻辑集中在 src/cmds 目录下按语言/工具拆分src/cmds/rust/cargo_cmd.rsCargo、src/cmds/js/vitest_cmd.rsvitest/jest、src/cmds/python/pytest_cmd.rs、src/cmds/git/git.rs 等src/main.rs 顶部的模块导入列表即是对接生态的总览——Git、Cargo/Rust、JavaScript/TypeScript、Python、Go、Ruby、.NET、PHP、Scala、JVMMaven/Gradle、Docker/Kubernetessrc/cmds/cloud/container.rs等。各命令的具体压缩效果如git status压缩 75–93%、cargo test约 90%、jest/vitest94–99%在 What RTK Optimizes 中有完整表格。该文档同时注明了一个重要前提表中百分比度量的是bash 输出被移除的字节数——这是 RTK 唯一直接控制的部分它是输入 token 的一个贡献项而不等于最终账单上的成本。Step 3查看你的节省看板跑了几条命令后用rtk gain查看累计节省rtk gainQuick Start 给出的示例输出Total commands : 12 Input tokens : 45,230 Output tokens : 4,890 Saved : 40,340 (89.2%)实现上看板渲染逻辑位于 src/analytics/gain.rsTotal commands与Input tokens通过print_kpi逐项输出同一模块还维护一张按命令维度统计的明细表列为Command / Count / Saved / Avg% / Time / Impact可以定位哪条命令省得最多。另外在 src/analytics/cc_economics.rs 中可以看到token 节省的估算基于chars/4 启发式近似每 4 字符约 1 token而非精确分词器阅读看板数字时应理解这一精度边界。Step 4未覆盖命令的 passthroughRTK 不认识的命令会走直通模式输出原样返回但使用行为仍被记录。例如rtk proxy make install在 src/main.rs 中可以看到 proxy 的约束——缺少命令参数时直接报用法错误Usage: rtk proxy command [args...]。源码还处理了带引号参数拆分的边界情况如rtk proxy git log --format%H %s会正确拆出 cmd 与 args并专门处理了 SIGINT/SIGTERM 下终止子进程、防止孤儿进程的问题对应 ISSUE #897 的注释。passthrough 的意义在于即使某条命令暂时无对应过滤器也不会阻断工作流且其行为数据会进入rtk gain的统计口径。下一步What RTK Optimizes按生态列出全部受支持命令及 bash 输出压缩比例并附节省口径说明。Supported agentsClaude Code、Cursor、Copilot 等 agent 的 Hook 支持细节。Configuration定制 RTK 行为包括项目级.rtk/filters.toml过滤规则字段示例见 src/hooks/init.rs 中的模板定义。小结RTK 的快速上手路径只有四步——rtk init可先--dry-run预演、照常使用工具链、rtk gain看节省、未覆盖命令用rtk proxy直通。整个过程不改变任何既有开发习惯节省效果通过看板可量化、可追溯。【免费下载链接】rtkCLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies项目地址: https://gitcode.com/GitHub_Trending/rtk4/rtk创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考