RTK遥测与隐私完全指南：收集什么、不收集什么、如何关闭
【免费下载链接】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 是一款单文件 Rust 二进制、零依赖的 CLI 代理，能把常见开发命令的 LLM token 消耗降低 60-90%。很多用户最关心的问题正是：RTK 遥测（telemetry）到底收集什么？不收集什么？如何一键关闭？本指南一次性讲清楚——先说结论：RTK 遥测默认关闭，必须你明确同意才会启用，而且随时可以撤回同意并彻底清除数据 🎯
一、先明白：RTK 遥测是什么、为什么存在
RTK 支持 100+ 命令、15+ 生态（git、cargo、npm、Python 等）。为了让团队知道哪些命令最常用、哪些过滤器效果不好，RTK 提供了匿名、聚合的用量统计：每天最多上报一次"心跳"，帮助决定下一步优先为哪些生态开发过滤器。
关键机制（对隐私很重要）：
- ⏰一天只发一次（23 小时间隔），由本地标记文件防止重复
- 🧵后台线程发送，2 秒超时，绝不影响你使用命令行
- 📴 服务器不可达时静默丢弃，不重试、不排队
- 🔒 全部走 HTTPS；未获得同意时，一个字节都不会发送
完整文档见 docs/TELEMETRY.md，实现代码在 src/core/telemetry.rs。
二、RTK 遥测收集什么？（全部是匿名聚合数据）
| 类别 | 收集内容 | 用途 |
|---|---|---|
| 身份 | 加盐设备哈希（SHA-256，不可逆） | 统计安装数量，无法反推个人 |
| 环境 | 版本、操作系统、CPU 架构、安装方式 | 决定优先支持哪些平台 |
| 用量 | 24 小时/累计命令数、估算节省 token 数 | 衡量 RTK 实际价值 |
| 质量 | 节省率为 0 的前 5 个命令、解析失败次数 | 发现需要新增或改进的过滤器 |
| 生态 | 命令类别占比（如 git 45%、js 15%） | 规划过滤器开发优先级 |
| 留存 | 首次使用天数、近 30 天活跃天数 | 判断用户是否持续使用 |
| 配置 | 是否自定义过 config、排除命令数、项目数 | 了解用户成熟度 |
注意：top_commands只包含工具名（如 "git"、"cargo"），最多 5 个，绝不含参数。
三、RTK 遥测不收集什么？（重点清单 ✅）
以下内容明确不收集：
- ❌ 源代码或文件内容
- ❌ 完整命令行或参数（只有工具名）
- ❌ 文件路径或目录结构
- ❌ 密钥、API Key、环境变量值
- ❌ 仓库名称或 URL
- ❌ 任何可识别个人的信息
- ❌ IP 地址不存入遥测数据（仅在服务端删除审计日志中临时保留，6 个月后匿名化）
四、如何关闭 RTK 遥测？4 条命令全搞定
RTK 提供了完整的遥测管理命令，实现位于 src/core/telemetry_cmd.rs：
rtk telemetry status # 查看当前同意状态（含设备哈希） rtk telemetry enable # 给予同意（交互式确认） rtk telemetry disable # 撤回同意——立即停止所有收集 rtk telemetry forget # 撤回 + 删除本地数据 + 请求服务端删除💡 最彻底的是rtk telemetry forget：它会删除本地设备盐、标记文件和追踪数据库，并向服务器发送 GDPR 第 17 条（被遗忘权）删除请求。如果服务器不可达，会打印你的设备哈希并给出手动删除的邮箱指引。
终极开关（环境变量强制禁用）——无论你是否曾同意，遥测都会被彻底拦截，连初始化提示都不会出现：
export RTK_TELEMETRY_DISABLED=1这个环境变量适合 CI 环境和非交互场景（源码注释见 src/hooks/init.rs），是"物理级"关闭遥测的最快方式。
五、数据保留多久？你有哪 6 项 GDPR 权利？
保留期限一览：
| 位置 | 保留时长 | 说明 |
|---|---|---|
| 服务端遥测记录 | 最多12 个月 | 每 24 小时自动清理 |
| 服务端删除审计日志中的 IP | 6 个月后匿名化 | GDPR 要求 |
| 客户端本地数据库 | 默认90 天 | 可在 config.toml 的tracking.history_days调整 |
基于欧盟 GDPR，你拥有的权利（全部可通过命令自助完成）：
- 访问权：
rtk telemetry status查看设备哈希，字段文档即上文 - 删除权：
rtk telemetry forget（本地 + 服务端一起删） - 限制处理 / 反对权：
rtk telemetry disable或设置环境变量 - 可携带权：本地数据库包含你所有本地存储数据，可自由导出
六、别混淆：本地追踪 ≠ 遥测
RTK 还有一个纯本地的 token 节省统计（rtk gain命令依赖它），记录每条命令节省了多少输出，存放在本地 SQLite 数据库（Linux 下为~/.local/share/rtk/tracking.db）。它从不离开你的机器，且 90 天自动清理，详见 docs/usage/TRACKING.md 与实现 src/core/tracking.rs。想彻底清零，直接运行rtk telemetry forget即可连本地数据库一并删除。
七、30 秒快速决策清单
| 你的诉求 | 一条命令解决 |
|---|---|
| 确认自己是否同意了遥测 | rtk telemetry status |
| 永久停止收集 | rtk telemetry disable |
| 删除一切痕迹（含服务端） | rtk telemetry forget |
| CI / 脚本环境保险 | export RTK_TELEMETRY_DISABLED=1 |
总结：RTK 的遥测是"默认关闭 + 明确同意 + 匿名聚合 + 随时可删"的隐私友好设计。只要你不主动在rtk init或rtk telemetry enable中回答 y，RTK 就不会发送任何遥测数据。完整字段定义与贡献者规范，请参考 docs/TELEMETRY.md。
【免费下载链接】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），仅供参考
