RTK dry-run模式完全指南--dry-run安全预览init到底会改动哪些文件【免费下载链接】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/rtkRTKRust Token Killer是一个用 Rust 编写的单文件 CLI 代理工具能在常见开发命令上为 AI 编程助手节省 60%–90% 的 LLM token 消耗零外部依赖。当你准备运行rtk init把 RTK 接入 Claude Code 等 AI 编码代理时可能担心它会在settings.json、CLAUDE.md等配置里动手脚。别急——RTK 内置了--dry-run模式先彩排一遍逐条列出将要创建、更新、修补的每一个文件却不实际写入任何内容。本指南带你从零看懂 RTK init dry-run 预览模式。为什么配置 AI 代理前要先预览改动rtk init的作用是把 RTK 的指令和钩子hook写入 AI 代理的配置文件创建RTK.md、修补CLAUDE.md、向settings.json注入钩子条目、生成过滤模板等。这些文件有些属于全局用户配置如~/.claude/目录一旦改错会影响所有项目。RTK 的 dry-run 模式预览改动、零写入正是为此设计它有三个关键保障只读承诺所有拟议操作只打印不执行磁盘文件保持原样跳过交互不会弹出 telemetry 同意提示也不会等待你按 y/N 确认管道和非交互环境下也不会卡住结尾盖章输出末尾固定出现[dry-run] Nothing written.确认什么都没写相关实现在 src/hooks/init.rs 的write_if_changed函数开启 dry-run 时它只打印意图完全不触碰文件系统。一键预览rtk init --dry-run 快速上手如果你还没安装 RTK可先获取源码需要 clone 时使用仓库地址https://gitcode.com/GitHub_Trending/rtk4/rtk安装步骤详见 INSTALL.md。最快预览方法——在项目目录或全局作用域下执行# 预览全局安装会做什么 rtk init --global --dry-run典型输出如下注意每行的[dry-run] would ...前缀[dry-run] would create RTK.md: /Users/you/.claude/RTK.md [dry-run] would update CLAUDE.md: /Users/you/.claude/CLAUDE.md [dry-run] would patch settings.json: /Users/you/.claude/settings.json [dry-run] would create global filters template: /Users/you/.config/rtk/filters.toml [dry-run] Nothing written.看到Nothing written.这行结尾就可以放心了刚才只是过电影系统一点没变。想看将要写入的完整内容加 -v普通预览只显示文件路径。加上-vverbose参数后每个拟议操作后面会附带完整的文件内容方便你逐字审查 RTK 准备写入的指令和 JSON 结构rtk init --global --dry-run -v-v下你会看到类似[dry-run] content:后跟整段 RTK.md 或 settings.json 序列化结果的输出。该行为定义在 src/hooks/init.rs。init 到底会改动哪些文件完整清单结合 dry-run 输出和源码src/hooks/init.rs的run_default_mode全局初始化涉及以下文件文件操作说明~/.claude/RTK.md创建/更新精简版 RTK 指令约 10 行~/.claude/CLAUDE.md更新追加RTK.md引用行~/.claude/settings.json修补注入hooks.PreToolUse钩子条目并自动生成.json.bak备份~/.config/rtk/filters.toml创建用户全局过滤模板已存在则跳过.rtk/filters.toml项目内创建项目级过滤模板建议随仓库提交~/.claude/hooks/rtk-rewrite.sh删除旧版钩子脚本的迁移清理如存在两个贴心的细节幂等跳过——若settings.json中已存在 RTK 钩子RTK 会直接报 hook already present不会重复注入dry-run 下连备份都不创建——.json.bak只在真实写入时生成。不止安装uninstall 也能 dry-run 预览卸载前同样值得先演一遍。RTK 的卸载流程也完整支持 dry-run实现位于 src/hooks/init.rs# 预览全局卸载会删除什么 rtk init --global --uninstall --dry-run输出以[dry-run] would uninstall RTK:开头逐条列出将被移除的产物RTK.md、CLAUDE.md 中的引用、settings.json 钩子条目等。对应would uninstall的文案会随目标代理变化例如 Cursor 模式显示[dry-run] would uninstall RTK (Cursor):。最佳实践何时使用 RTK init dry-run 首次接入 AI 代理前用rtk init --global --dry-run -v审查全部改动再实际执行 CI / 自动化脚本中dry-run 不弹交互提示天然适合非交互环境做配置审计 清理前留底--uninstall --dry-run确认移除范围避免误删 适配其他代理时dry-run 对--agent cursor、--gemini、--codex、--copilot等各种 init 口味全部生效两点小提醒--dry-run不能与--show同时使用两者在参数定义上互斥见src/main.rs中 Init 子命令的conflicts_with showdry-run 模式会跳过 telemetry 同意询问因此不会写入遥测同意记录小结RTK 的--dry-run把先看清楚再动手做到了极致一条rtk init --dry-run就能列出 init 拟创建、更新、修补的所有文件-v附赠完整写入内容结尾的Nothing written.给出零副作用保证。无论是全局安装还是卸载清理这个预览模式都是 AI 代理配置工作流中最安全的第一步。【免费下载链接】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），仅供参考