TREG_TELEMETRY0关闭treg遥测隐私设置与数据收集说明【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtregtools-registry是一个开源的 Agent 工具注册中心口号是 OpenRouter for agent tools——用一把统一的密钥调用 2000 工具 API。它的 CLI 在使用官方托管服务时会向 PostHog 发送匿名遥测数据命令名、退出码、耗时等而通过设置环境变量TREG_TELEMETRY0或DO_NOT_TRACK1就能一键关闭遥测。本文完整讲清treg 收集什么、不收集什么以及如何快速关闭 treg 数据收集。treg 遥测到底收集哪些数据先说结论treg CLI 的遥测是尽力而为的匿名统计源码在 cli_analytics.py 中实现。每次命令执行后它会发送一个cli_command_completed事件内容只有收集项说明命令名固定的命令标识如version、call退出码 / 成功标志判断命令是否成功执行耗时毫秒级CLI 版本、操作系统如0.19.0、Linux本地安装 ID随机 UUID保存在配置目录旁的analytics-id文件而以下内容明确不收集这一点在 USAGE.md 和 cli.md 中有明文说明❌ 命令行参数比如你传入的密钥名、参数值❌ 凭证、Token、请求/响应内容❌ 文件路径、邮箱、团队标识项目自带的测试 test_cli_analytics.py 还会专门验证参数内容永远不会进入事件例如断言secret add private-name --value secret-token后private-name和secret-token都不出现在上报数据中。如何快速关闭 treg 遥测TREG_TELEMETRY0关闭方法非常简单任选其一即可# 方法一推荐显式关闭遥测 export TREG_TELEMETRY0 # 方法二遵循业界通用的 DNT 约定 export DO_NOT_TRACK1几个值得了解的细节见 cli_analytics.pyTREG_TELEMETRY接受0、false、off三种值不区分大小写都能生效关闭后不仅停止上报连本地analytics-id文件的创建都会被跳过测试test_disabled_has_no_side_effects专门验证了无任何副作用官方 README.md 也写明The CLI sends anonymous command usage to PostHog when using treg.to. Disable withTREG_TELEMETRY0orDO_NOT_TRACK1小贴士如果不想污染全局环境也可以在单次命令前临时设置例如TREG_TELEMETRY0 treg version。遥测只在官方托管模式下默认开启这一点容易被忽略遥测开关与你连接的是哪个注册中心有关。官方托管https://treg.to及其别名默认使用内置的公共 PostHog 采集密钥上报自部署注册中心默认完全不上报——除非你主动设置TREG_CLI_POSTHOG_KEY并可选TREG_CLI_POSTHOG_HOST指向自己的 PostHog 项目也就是说自托管用户天然就是零遥测状态只有官方托管用户需要决定是否关闭。关闭遥测对性能有影响吗几乎没有放心关。遥测的设计原则是绝不影响命令本身上报在守护线程中执行网络请求超时 0.2 秒命令退出时最多等待 1 秒网络慢或离线时事件会被直接丢弃不重试任何上报失败都是静默的不会改变命令输出或退出状态相关行为由测试 test_cli_analytics.py 中的test_slow_ingestion_does_not_block_exit和test_sdk_failure_is_silent保证。如何验证遥测已关闭验证方法很直观——关闭后不应再产生任何上报事件。你可以观察两点配置文件目录关闭模式下不再新建analytics-id文件已存在的旧 ID 文件不会被删除也不会有新数据带它上报抓包观察使用TREG_CLI_POSTHOG_HOST指向本地服务确认设置TREG_TELEMETRY0后没有任何cli_command_completed请求发出这正是官方测试 test_cli_analytics.py 的验证思路常见问题FAQQ1关闭遥测会影响 treg 的正常使用吗不会。遥测与登录、密钥、调用完全解耦treg call、treg tool add等功能均不受任何影响。Q2TREG_TELEMETRY0和DO_NOT_TRACK1有区别吗功能上没有区别两者都会在 cli_analytics.py 中被优先检查并直接返回。DO_NOT_TRACK1更符合跨工具的隐私约定适合希望一套环境变量管所有工具的用户。Q3遥测数据存在哪里能要求删除吗数据通过 PostHog欧盟端点eu.i.posthog.com接收本地仅存一个随机 UUID。由于 ID 与登录状态无关、也不含个人信息它本身无法定位到你的身份。总结一张表看懂 treg 隐私设置场景遥测行为推荐操作官方托管 默认上报匿名命令统计介意则设置TREG_TELEMETRY0官方托管 已关闭不上报、不创建 ID无需额外操作自部署注册中心默认不上报无需额外操作CI/测试环境项目测试已全局禁用参考 tests/conftest.py一句话总结treg 的数据收集是最小化 可关闭的——默认只收集匿名命令统计设置TREG_TELEMETRY0即可彻底关闭且无任何副作用。如果你更关心完整的 CLI 参数与隐私边界建议通读 USAGE.md 的 Anonymous usage analytics 章节。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
