第 04 模块 · 3 节

隐私、遥测与故障排查

《Orca 生产级工程》04 规模化、账号与安全 · 本节时长 22 分钟

把安全收尾Orca 默认收集的是匿名产品使用遥测,且有一条硬边界:文件内容、prompt、Agent 输出、仓库与分支名这些内容数据永远不会传出你的机器。本课把遥测边界、关闭方式与故障排查讲透,作为整个 Orca 课程的收尾。

遥测的底线:匿名

官方文档(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-codecodexgemini)与启动位置 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 即可,它不会通过遥测自动外传。


落地练习:验证安全边界

  1. 打开 Settings → Privacy,看一眼「Share anonymous usage data」开关当前状态
  2. 在终端设 DO_NOT_TRACK=1 后重启 Orca,确认界面或状态无异常(遥测已停)
  3. 打开官方 Troubleshooting 页,把最近遇到的一个问题(哪怕很小)对号入座
  4. 把本课「生产级清单」抄成一份团队 checklist,勾掉你已经做到的项
  5. 对着终端里打印的 task_... ID、orca status --json 输出,确认你能读懂 Orca 的运行时状态

怎么判断做对了?——你能不看文档说出「遥测传什么、不传什么、怎么关」三件事,并向团队讲清 Orca 生产部署的五个维度。

卡住了怎么办? 报错要发给官方:先收集本地诊断 bundle 再走 GitHub Issues;怀疑泄露内容数据?设 DO_NOT_TRACK=1 后用抓包工具验证无外发连接即可安心。


生产级清单:把整门课串起来

作为课程收尾,把四节课组合成一份「Orca 生产级使用」检查清单:

  1. CLI 与 Skills(模块一):注册 orca CLI,orca status --json 验证连通,安装 orca-cli / orchestration / computer-use 技能
  2. 远程运行(模块二):按任务选择 Local / SSH / Remote Orca Server / Cloud VM 四种方式
  3. 编排自动化(模块三):监督式 Run + Task + Worker 管多 Agent;orca automations 跑定时任务;checkpoints 汇报进度
  4. 移动与账号(模块四前两课):手机 Companion 遥控,多账号热切换配合用量追踪防限流
  5. 隐私与安全(本课):按需关遥测,访问令牌按最小权限发放,故障用诊断 bundle 显式分享

小结

  1. 遥测匿名:随机本地 ID,无账号/email/IP
  2. 内容数据(代码、prompt、输出、仓库名、路径)绝不外传
  3. 收集的只是固定枚举 / 版本 / 匿名 ID 级元数据
  4. 三选一关闭:Settings 开关、DO_NOT_TRACK=1ORCA_TELEMETRY_DISABLED=1
  5. 故障排查走官方 Troubleshooting 页,诊断 bundle 仅显式分享

至此,Orca 基础、进阶、生产级三门课全部完成——从「三 Agent 并行跑通」到「脚本化、远程化、自动化、安全化」,你已经有了一套完整的 Orca 工程体系。