RTK 接入 Cline / Roo Code 实战用 .clinerules 规则文件实现 Prompt 级 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 的 Cline 集成文档 hooks/cline/README.md 展开讲清楚 RTK 是如何以Prompt 级规则文件这一最轻量集成方式为 Cline / Roo Code 提供 Token 节省能力的包括rtk init --agent cline的安装流程、.clinerules规则文件的完整内容、规则写入的幂等与追加逻辑可对照 src/hooks/init.rs 源码验证以及rtk gain/rtk discover等配套度量命令。读完后你可以独立完成 Cline 集成配置并理解它与 Claude Code、Cursor 等全钩子集成在机制上的本质区别。为什么 Cline 采用 Prompt 级集成而不是编程钩子RTK 对 AI 编码代理的集成分为三个层级完整对比见 hooks/README.md 与 docs/guide/getting-started/supported-agents.md层级机制维护成本代表集成Full hookShell 脚本或 Rust 二进制通过代理的 Hook API 拦截命令高 — 需跟踪代理 API 变更Claude Code、Cursor、Copilot、GeminiPlugin代理插件系统中的 TypeScript/JS/Python 插件原地改写中 — 代理管理加载OpenCode、Hermes、PiRules file代理读取的 Prompt 级指令低 — 没有会坏掉的代码Cline、Windsurf、CodexCline / Roo Code 属于第三层纯 Prompt 级指导无编程钩子依赖 Cline 读取 custom instructions 的行为。官方文档 hooks/cline/README.md 明确给出两条集成事实Prompt-level guidance only无程序化钩子—— 生效与否依赖 Cline 对规则文件的遵循程度rules.md包含所有 shell 命令前置rtk的指令、用法示例与元命令meta commands由rtk init安装到项目本地的.clinerules文件。这意味着 Cline 集成没有任何运行时拦截命令不会被自动改写而是由模型在看到规则后主动选择执行rtk cmd。这是三个集成层级中唯一不可强制保证No guarantee的方式对应 docs/guide/getting-started/supported-agents.md 支持矩阵中 Can rewrite transparently? N/A 的那一行。安装一条命令写入 .clinerules安装命令rtk init --agent cline # 在当前项目创建 .clinerules安装位置是项目根目录的.clinerulesworkspace 作用域与 Windsurf 的.windsurfrules处理方式一致。注意这与rtk init -gClaude Code 全局 Hook settings.json 补丁的产物完全不同Cline 模式不修改任何全局配置、不注册任何钩子只在当前项目落一个规则文件。安装流程的源码级细节规则内容的来源是编译期嵌入的rules.md见 src/hooks/init.rs/// Embedded Cline RTK rules const CLINE_RULES: str include_str!(../../hooks/cline/rules.md);也就是说仓库中的 hooks/cline/rules.md 就是安装进用户.clinerules的模板本身——查看该文件即可预知安装结果。写入逻辑在run_cline_mode()src/hooks/init.rs具有明确的幂等与追加语义已有检测若现有.clinerules内容包含RTK或rtk直接跳过输出Rules: .clinerules (already present)——重复执行rtk init --agent cline是安全的追加而非覆盖若.clinerules已存在自定义规则且不含 RTK 内容新内容会拼接到已有规则之后format!({}\n\n{}, existing.trim(), CLINE_RULES)不破坏用户既有的 Cline 自定义指令Dry-run 支持dry_run模式下只打印[dry-run] would write .clinerules: ...--verbose时还会打印将要写入的完整内容安装后提示提示 Cline 将开始使用 rtk 命令并给出验证建议Test with: git status。该模式在rtk init主流程中作为独立分支调度src/hooks/init.rs当install_cline为 true 时进入run_cline_mode(ctx)与 Windsurf 模式、Claude Code 默认模式互斥。.clinerules 规则文件内容详解规则模板 hooks/cline/rules.md 全文很短但每一部分都对应 RTK 的核心工作流。安装后.clinerules中会出现以下三类内容核心规则RuleAlways prefix shell commands withrtkto minimize token consumption.这是对模型的直接行为约束所有 shell 命令都要加rtk前缀。命令示例rtk git status rtk cargo test rtk ls src/ rtk grep pattern src/ rtk find *.rs . rtk docker ps rtk gh pr list这些示例覆盖了 Git、Rust 测试、文件操作、容器、GitHub CLI 六类高频命令目的是给模型足够的 few-shot 参照降低它忘记加前缀的概率——因为 Prompt 级集成没有运行时兜底示例质量直接影响遵循率。元命令Meta Commandsrtk gain # Show token savings rtk gain --history # Command history with savings rtk discover # Find missed RTK opportunities rtk proxy cmd # Run raw (no filtering, for debugging)这四条元命令是规则文件给 Cline 的自检工具箱rtk gain/rtk gain --history查看累计节省量与命令级节省历史。完整参数--daily、--weekly、--monthly、--graph、--format json/csv等见 docs/guide/analytics/gain.mdrtk discover扫描命令历史找出本可以走 RTK 却用了裸命令的机会是 Prompt 级集成的补偿机制——正因为规则不是强制的才需要主动审计遗漏rtk proxy cmd绕过过滤直接透传执行原始命令用于调试例如怀疑过滤层改变了输出时对照原始输出。原理说明Why规则文件末尾给出的解释是RTK 在输出到达 LLM 上下文之前对命令输出做过滤与压缩常见操作最多削减 90% 的 bash 输出。这与项目整体定位一致——RTK 是一个用 Rust 编写的单二进制、零依赖 CLI 代理在常见开发命令上减少 60-90% 的 LLM Token 消耗见 README.md。各命令类别的典型节省区间如 Test Runners 90-99%、VCS 70-80%、File Operations 60-75%汇总于 hooks/README.md 的 Rewrite Registry 表格。生效边界Prompt 级集成的优势与限制理解 Cline 集成的行为边界需要把它放在 RTK 的三条通用约定中对照1. 没有运行时保证但也不需要运行时。Full hook 集成如 Claude Code 的PreToolUse在命令执行前强制改写命令代理永远看不到裸命令Cline 集成则完全依赖模型遵守.clinerules。从 hooks/README.md 的 JSON 协议章节可见Claude Code / Cursor / Copilot / Gemini 等 Hook 都有严格的输入输出 JSON 契约而 Cline 一行的机制列就是 Custom instructions (rules file)、Hook 类型列是 Prompt-level guidance——不存在任何 JSON 协议可谈。2. 优雅降级是全局约定对 Cline 天然成立。RTK 的 Hook 系统要求所有错误路径退出 0、永不阻塞命令执行hooks/README.md 的 Exit Code Contract 与 Graceful Degradation 章节rtk二进制缺失、版本过旧、JSON 非法时都放行原始命令。Cline 集成作为最轻量的层级连这个降级路径都不需要——即使rtk未安装Cline 也只是照常尝试运行命令行为与未集成时完全一致。3. 与 Full hook 集成的可叠加性。如果同一机器上同时给 Claude Code 装了全局 Hookrtk init -g两者互不冲突Hook 层自动改写 规则文件兜底提醒。对 Cline 而言若后续希望获得强制改写级别的保证只能等待 Cline 提供可用的 Hook/插件 API——这正是 RTK 为新代理定级时的准入标准文档化且稳定的 hook/plugin API、活跃维护、遵守退出码契约见 hooks/README.md 的 Eligibility 章节。验证与量化效果安装完成后按规则文件的提示执行一次rtk git status类命令再通过元命令量化收益rtk gain # 查看累计节省 rtk gain --history # 最近命令的逐条节省 rtk discover # 找出遗漏的 RTK 机会rtk gain的统计口径需要注意见 docs/guide/analytics/gain.md它度量的是bash 输出字节数的缩减按bytes / 4估算 TokenSave%是 bash 输出字节比不等于账单占比——输入 Token 中还包括 prompt、系统提示与对话历史。小结何时选 Cline 规则文件集成维度Cline / Roo Code 集成表现安装rtk init --agent cline仅写入项目本地.clinerules作用域项目级workspace随项目提交可共享给团队机制Prompt 级指令 命令示例 元命令无运行时拦截改写保证依赖模型遵循可用rtk discover审计遗漏破坏性无——已有.clinerules内容被保留RTK 内容追加在后幂等性重复执行安全检测到rtk字样即跳过维护成本三档中最低无代码、无 API 跟踪负担规则模板、安装实现与支持矩阵分别位于 hooks/cline/rules.md、src/hooks/init.rs 与 hooks/README.md其他 Prompt 级集成Windsurf 的.windsurfrules、Codex 的 AGENTS.md可在 docs/guide/getting-started/supported-agents.md 中对照阅读结构上与 Cline 集成同构。【免费下载链接】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），仅供参考
RTK 接入 Cline / Roo Code 实战：用 .clinerules 规则文件实现 Prompt 级 Token 节省
RTK 接入 Cline / Roo Code 实战用 .clinerules 规则文件实现 Prompt 级 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 的 Cline 集成文档 hooks/cline/README.md 展开讲清楚 RTK 是如何以Prompt 级规则文件这一最轻量集成方式为 Cline / Roo Code 提供 Token 节省能力的包括rtk init --agent cline的安装流程、.clinerules规则文件的完整内容、规则写入的幂等与追加逻辑可对照 src/hooks/init.rs 源码验证以及rtk gain/rtk discover等配套度量命令。读完后你可以独立完成 Cline 集成配置并理解它与 Claude Code、Cursor 等全钩子集成在机制上的本质区别。为什么 Cline 采用 Prompt 级集成而不是编程钩子RTK 对 AI 编码代理的集成分为三个层级完整对比见 hooks/README.md 与 docs/guide/getting-started/supported-agents.md层级机制维护成本代表集成Full hookShell 脚本或 Rust 二进制通过代理的 Hook API 拦截命令高 — 需跟踪代理 API 变更Claude Code、Cursor、Copilot、GeminiPlugin代理插件系统中的 TypeScript/JS/Python 插件原地改写中 — 代理管理加载OpenCode、Hermes、PiRules file代理读取的 Prompt 级指令低 — 没有会坏掉的代码Cline、Windsurf、CodexCline / Roo Code 属于第三层纯 Prompt 级指导无编程钩子依赖 Cline 读取 custom instructions 的行为。官方文档 hooks/cline/README.md 明确给出两条集成事实Prompt-level guidance only无程序化钩子—— 生效与否依赖 Cline 对规则文件的遵循程度rules.md包含所有 shell 命令前置rtk的指令、用法示例与元命令meta commands由rtk init安装到项目本地的.clinerules文件。这意味着 Cline 集成没有任何运行时拦截命令不会被自动改写而是由模型在看到规则后主动选择执行rtk cmd。这是三个集成层级中唯一不可强制保证No guarantee的方式对应 docs/guide/getting-started/supported-agents.md 支持矩阵中 Can rewrite transparently? N/A 的那一行。安装一条命令写入 .clinerules安装命令rtk init --agent cline # 在当前项目创建 .clinerules安装位置是项目根目录的.clinerulesworkspace 作用域与 Windsurf 的.windsurfrules处理方式一致。注意这与rtk init -gClaude Code 全局 Hook settings.json 补丁的产物完全不同Cline 模式不修改任何全局配置、不注册任何钩子只在当前项目落一个规则文件。安装流程的源码级细节规则内容的来源是编译期嵌入的rules.md见 src/hooks/init.rs/// Embedded Cline RTK rules const CLINE_RULES: str include_str!(../../hooks/cline/rules.md);也就是说仓库中的 hooks/cline/rules.md 就是安装进用户.clinerules的模板本身——查看该文件即可预知安装结果。写入逻辑在run_cline_mode()src/hooks/init.rs具有明确的幂等与追加语义已有检测若现有.clinerules内容包含RTK或rtk直接跳过输出Rules: .clinerules (already present)——重复执行rtk init --agent cline是安全的追加而非覆盖若.clinerules已存在自定义规则且不含 RTK 内容新内容会拼接到已有规则之后format!({}\n\n{}, existing.trim(), CLINE_RULES)不破坏用户既有的 Cline 自定义指令Dry-run 支持dry_run模式下只打印[dry-run] would write .clinerules: ...--verbose时还会打印将要写入的完整内容安装后提示提示 Cline 将开始使用 rtk 命令并给出验证建议Test with: git status。该模式在rtk init主流程中作为独立分支调度src/hooks/init.rs当install_cline为 true 时进入run_cline_mode(ctx)与 Windsurf 模式、Claude Code 默认模式互斥。.clinerules 规则文件内容详解规则模板 hooks/cline/rules.md 全文很短但每一部分都对应 RTK 的核心工作流。安装后.clinerules中会出现以下三类内容核心规则RuleAlways prefix shell commands withrtkto minimize token consumption.这是对模型的直接行为约束所有 shell 命令都要加rtk前缀。命令示例rtk git status rtk cargo test rtk ls src/ rtk grep pattern src/ rtk find *.rs . rtk docker ps rtk gh pr list这些示例覆盖了 Git、Rust 测试、文件操作、容器、GitHub CLI 六类高频命令目的是给模型足够的 few-shot 参照降低它忘记加前缀的概率——因为 Prompt 级集成没有运行时兜底示例质量直接影响遵循率。元命令Meta Commandsrtk gain # Show token savings rtk gain --history # Command history with savings rtk discover # Find missed RTK opportunities rtk proxy cmd # Run raw (no filtering, for debugging)这四条元命令是规则文件给 Cline 的自检工具箱rtk gain/rtk gain --history查看累计节省量与命令级节省历史。完整参数--daily、--weekly、--monthly、--graph、--format json/csv等见 docs/guide/analytics/gain.mdrtk discover扫描命令历史找出本可以走 RTK 却用了裸命令的机会是 Prompt 级集成的补偿机制——正因为规则不是强制的才需要主动审计遗漏rtk proxy cmd绕过过滤直接透传执行原始命令用于调试例如怀疑过滤层改变了输出时对照原始输出。原理说明Why规则文件末尾给出的解释是RTK 在输出到达 LLM 上下文之前对命令输出做过滤与压缩常见操作最多削减 90% 的 bash 输出。这与项目整体定位一致——RTK 是一个用 Rust 编写的单二进制、零依赖 CLI 代理在常见开发命令上减少 60-90% 的 LLM Token 消耗见 README.md。各命令类别的典型节省区间如 Test Runners 90-99%、VCS 70-80%、File Operations 60-75%汇总于 hooks/README.md 的 Rewrite Registry 表格。生效边界Prompt 级集成的优势与限制理解 Cline 集成的行为边界需要把它放在 RTK 的三条通用约定中对照1. 没有运行时保证但也不需要运行时。Full hook 集成如 Claude Code 的PreToolUse在命令执行前强制改写命令代理永远看不到裸命令Cline 集成则完全依赖模型遵守.clinerules。从 hooks/README.md 的 JSON 协议章节可见Claude Code / Cursor / Copilot / Gemini 等 Hook 都有严格的输入输出 JSON 契约而 Cline 一行的机制列就是 Custom instructions (rules file)、Hook 类型列是 Prompt-level guidance——不存在任何 JSON 协议可谈。2. 优雅降级是全局约定对 Cline 天然成立。RTK 的 Hook 系统要求所有错误路径退出 0、永不阻塞命令执行hooks/README.md 的 Exit Code Contract 与 Graceful Degradation 章节rtk二进制缺失、版本过旧、JSON 非法时都放行原始命令。Cline 集成作为最轻量的层级连这个降级路径都不需要——即使rtk未安装Cline 也只是照常尝试运行命令行为与未集成时完全一致。3. 与 Full hook 集成的可叠加性。如果同一机器上同时给 Claude Code 装了全局 Hookrtk init -g两者互不冲突Hook 层自动改写 规则文件兜底提醒。对 Cline 而言若后续希望获得强制改写级别的保证只能等待 Cline 提供可用的 Hook/插件 API——这正是 RTK 为新代理定级时的准入标准文档化且稳定的 hook/plugin API、活跃维护、遵守退出码契约见 hooks/README.md 的 Eligibility 章节。验证与量化效果安装完成后按规则文件的提示执行一次rtk git status类命令再通过元命令量化收益rtk gain # 查看累计节省 rtk gain --history # 最近命令的逐条节省 rtk discover # 找出遗漏的 RTK 机会rtk gain的统计口径需要注意见 docs/guide/analytics/gain.md它度量的是bash 输出字节数的缩减按bytes / 4估算 TokenSave%是 bash 输出字节比不等于账单占比——输入 Token 中还包括 prompt、系统提示与对话历史。小结何时选 Cline 规则文件集成维度Cline / Roo Code 集成表现安装rtk init --agent cline仅写入项目本地.clinerules作用域项目级workspace随项目提交可共享给团队机制Prompt 级指令 命令示例 元命令无运行时拦截改写保证依赖模型遵循可用rtk discover审计遗漏破坏性无——已有.clinerules内容被保留RTK 内容追加在后幂等性重复执行安全检测到rtk字样即跳过维护成本三档中最低无代码、无 API 跟踪负担规则模板、安装实现与支持矩阵分别位于 hooks/cline/rules.md、src/hooks/init.rs 与 hooks/README.md其他 Prompt 级集成Windsurf 的.windsurfrules、Codex 的 AGENTS.md可在 docs/guide/getting-started/supported-agents.md 中对照阅读结构上与 Cline 集成同构。【免费下载链接】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），仅供参考
