遥测的底线:匿名
官方文档(Privacy & Telemetry)对遥测的总原则是匿名:
- 事件用机器本地生成的一个随机 ID 关联
- 不收集账号、email、IP 地址或用户名
与事件一同上报的只有基础构建信息:Orca 版本、操作系统(darwin / win32 / linux)、CPU 架构、粗粒度系统版本、发布频道(stable / rc)、以及上面那个匿名本地 ID。没有主机名、没有用户名、没有 IP。
什么数据绝对不发送
| 类别 | 举例 |
|---|---|
| 代码内容 | 文件内容、prompt、Agent 响应、终端输出 |
| 仓库信息 | 仓库名、分支名、URL、路径、提交信息 |
| 错误细节 | 原始报错信息、堆栈帧(只留本地诊断文件) |
| 账号信息 | Orca 没有账号系统,自然不收集 |
| 地理信息 | 无 IP、无精确 geoip;唯一的地理信号是请求推导出的国家 |
核心机制:每个上报字段要么是固定枚举值,要么是版本字符串,要么是匿名 ID——没有任何来自界面输入的自由文本会离开你的机器。
收集什么(以及为什么安全)
| 类别 | 记录内容 | 从不记录 |
|---|---|---|
| 生命周期 | 应用何时打开(估算 DAU/WAU/MAU) | — |
| 仓库与工作区 | 你怎么创建的(文件夹选择器 vs clone URL、命令面板 vs 拖放) | 仓库名、URL、路径、分支、任何自由文本 |
| Agent | 启动的 Agent 种类(固定列表,如 claude-code、codex、gemini)与启动位置 |
prompt、模型细节、Agent 输出 |
| Agent 错误 | 粗粒度错误分类 + Agent 种类 | 原始错误消息、堆栈 |
| 设置 | 白名单内的少量功能开关偏好 | 自由文本设置值 |
| 隐私控制 | 你 opt in/out 遥测这件事本身 | — |
注意「Agent 错误」一条:事件详情留在本地诊断文件里,只有你显式分享诊断 bundle 时才会传出——日常遥测里它只是一个粗粒度分类。
三种关闭方式(任一即可,可叠加)
| 方式 | 操作 | 生效范围 |
|---|---|---|
| 应用内开关 | Settings → Privacy → 关闭 "Share anonymous usage data" | 立即、持久 |
| 环境变量 | DO_NOT_TRACK=1 |
本次启动 |
| 环境变量 | ORCA_TELEMETRY_DISABLED=1 |
本次启动,Orca 专属开关 |
生产环境的服务器 / 团队机器建议直接设 ORCA_TELEMETRY_DISABLED=1,一劳永逸。
数据去向:供应商是 PostHog Cloud(美国区),保留期按平台默认;访问权限只授予极少数 Orca 维护者。
故障排查
遇到问题时,官方文档提供两个入口:
- Troubleshooting & FAQ —— 通用问题速查
- Troubleshooting GitHub errors —— 与 GitHub 交互类问题专项
关键原则:错误上下文默认留在本地诊断文件中。需要寻求帮助时,你显式分享诊断 bundle 即可,它不会通过遥测自动外传。
落地练习:验证安全边界
- 打开 Settings → Privacy,看一眼「Share anonymous usage data」开关当前状态
- 在终端设
DO_NOT_TRACK=1后重启 Orca,确认界面或状态无异常(遥测已停) - 打开官方 Troubleshooting 页,把最近遇到的一个问题(哪怕很小)对号入座
- 把本课「生产级清单」抄成一份团队 checklist,勾掉你已经做到的项
- 对着终端里打印的
task_...ID、orca status --json输出,确认你能读懂 Orca 的运行时状态
怎么判断做对了?——你能不看文档说出「遥测传什么、不传什么、怎么关」三件事,并向团队讲清 Orca 生产部署的五个维度。
卡住了怎么办? 报错要发给官方:先收集本地诊断 bundle 再走 GitHub Issues;怀疑泄露内容数据?设 DO_NOT_TRACK=1 后用抓包工具验证无外发连接即可安心。
生产级清单:把整门课串起来
作为课程收尾,把四节课组合成一份「Orca 生产级使用」检查清单:
- CLI 与 Skills(模块一):注册
orcaCLI,orca status --json验证连通,安装orca-cli/orchestration/computer-use技能 - 远程运行(模块二):按任务选择 Local / SSH / Remote Orca Server / Cloud VM 四种方式
- 编排自动化(模块三):监督式 Run + Task + Worker 管多 Agent;
orca automations跑定时任务;checkpoints 汇报进度 - 移动与账号(模块四前两课):手机 Companion 遥控,多账号热切换配合用量追踪防限流
- 隐私与安全(本课):按需关遥测,访问令牌按最小权限发放,故障用诊断 bundle 显式分享
小结
- 遥测匿名:随机本地 ID,无账号/email/IP
- 内容数据(代码、prompt、输出、仓库名、路径)绝不外传
- 收集的只是固定枚举 / 版本 / 匿名 ID 级元数据
- 三选一关闭:Settings 开关、
DO_NOT_TRACK=1、ORCA_TELEMETRY_DISABLED=1 - 故障排查走官方 Troubleshooting 页,诊断 bundle 仅显式分享
至此,Orca 基础、进阶、生产级三门课全部完成——从「三 Agent 并行跑通」到「脚本化、远程化、自动化、安全化」,你已经有了一套完整的 Orca 工程体系。