分析与遥测
我们收集什么数据、如何禁用以及在哪里查看聚合统计信息
收集内容
项目创建成功后，CLI会发送单个事件（project_created），包含：
- 选择的选项（技术栈选择）：
frontend、backend、runtime、database、orm、api、auth、addons、examples、dbSetup、webDeploy、packageManager - 环境数据：
cli_version、node_version、platform - 随机会话ID：
distinct_id（格式如cli_<random>） - 已移除IP：
$ip: null
不收集：
- 项目名称、路径或文件内容（明确排除）
- 您机器上的密钥或环境变量
禁用遥测
遥测功能默认启用。禁用方法：
# 单次运行禁用
BTS_TELEMETRY_DISABLED=1 bun create better-t-stack@latest# 单次运行禁用
BTS_TELEMETRY_DISABLED=1 pnpm create better-t-stack@latest# 单次运行禁用
BTS_TELEMETRY_DISABLED=1 npx create-better-t-stack@latest将 export BTS_TELEMETRY_DISABLED=1 添加到您的shell配置文件中以实现永久禁用。
查看分析数据的位置
- 图表：
/analytics - 原始JSON快照：
https://r2.better-t-stack.dev/analytics-data.json - CSV导出：
https://r2.better-t-stack.dev/export.csv
注意事项：
- 聚合数据会定期从传入事件重新生成
- 原始数据不公开；
/analytics页面仅显示汇总统计信息
完全透明
每次脚手架生成只发送单个事件；使用随机ID；无IP或项目标识符。详见下方源代码。
如有疑问，请设置 BTS_TELEMETRY_DISABLED=1 后继续操作。您仍然可以使用所有CLI功能。
源代码
- CLI事件发送器：
apps/cli/src/utils/analytics.ts - 遥测开关逻辑：
apps/cli/src/utils/telemetry.ts - 聚合脚本（构建图表数据）：
apps/web/scripts/generate-analytics.ts