oh-my-openagent 匿名遥测与隐私机制全解析采集边界、PostHog 上报管线与 Opt-out 配置指南【免费下载链接】oh-my-openagentOmO: Just type mass ulw keyword with your prompt. Now you are the master of graph engineering.项目地址: https://gitcode.com/gh_mirrors/oh/oh-my-openagent本文以 oh-my-openagent / oh-my-opencode 官方隐私政策docs/legal/privacy-policy.md为骨架结合仓库内packages/telemetry-core与packages/omo-config-core的真实源码实现系统讲解该项目的匿名遥测体系采集了哪些事件、哪些数据被刻意排除、遥测如何经过 PostHog 上报以及如何通过环境变量和配置文件彻底关闭遥测。读完本文你将能完整掌握该项目的隐私边界与全部退出opt-out开关并理解其底层调用链与去重机制。1. 适用范围与角色定义隐私政策首先明确了术语边界避免歧义Application应用指已发布的oh-my-opencodeCLI 包及其安装的 OpenCode 插件运行时Service服务指 Application 与项目分发渠道npm、GitHub 仓库等的合称We / our指 oh-my-opencode 的维护者You指服务的使用者。使用该服务即表示你接受本隐私政策及其配套的服务条款docs/legal/terms-of-service.md。政策最后更新于 2026 年 8 月 21 日。2. 采集的信息两类数据与明确的不采集清单政策将采集内容严格划分为两类并在源码层面得到印证。2.1 自动采集的匿名事件当匿名遥测启用时Application 可能采集以下事件事件触发时机用途omo_daily_active插件加载reason: plugin_loaded或runCLI 被调用reason: run_started每台机器每个 UTC 日最多一次估算日活 / 周活 / 月活安装量omo_codex_daily_activeomo-codex适配器安装完成reason: install_completed或其 Codex 插件运行时在SessionStart钩子上触发reason: session_start与omo_daily_active相同的退出姿态估算 omo-codex 活跃安装OmO Native 事件族omo-senpi 适配器会话开始、提示词分类桶、单轮 token 与成本汇总、技能与功能使用、并行度汇总、逐委托聚合指标、类别配置快照等匿名产品分析完整 schema 见 docs/reference/senpi-telemetry.md逐委托per-delegation聚合指标子代理任务结束终端状态、掩码后的类别与模型标识、时长、token 与成本汇总、后续消息数理解委托执行概况上述载荷只包含布尔值、计数器、分桶值和白名单枚举例如prompt_submitted事件的prompt_length_bucketlt_100/100_500/500_2000/gte_2000与memory_bucketlt_8_gb/8_15_gb/ …——这些枚举值在 senpi-telemetry.md 中以机器生成的方式完整公布且仓库中存在 schema 漂移测试确保文档与生成器永远一致。2.2 随事件携带的匿名元数据包版本、插件名、运行时、OS 系列、locale、时区IANA 时区名随会话开始事件发送一个伪匿名安装标识由本地主机名的单向哈希派生而来具体实现见第 4.3 节一个近似国家由 PostHog 服务端根据连接 IP 推导。Application 从不把 IP 地址写入任何事件载荷自身也不存储 IPVPN、代理、移动网络、共享机器或流量从其他地区出口时该近似国家可能不准确。2.3 明确不采集的数据政策明文规定遥测路径不会创建或更新 PostHog 用户画像person profile也不会采集提示词内容prompt contents源文件与仓库内容访问令牌与 API 密钥原始主机名运行时错误诊断信息任务名称、提示词、响应、错误消息、文件路径逐委托指标层面3. 配置与本地状态Application 会在本机存储本地配置与遥测去重状态用于支持安装、配置与匿名日活追踪。这部分状态由packages/telemetry-core的activity-state.ts管理状态文件名为posthog-activity.json见 activity-state.ts记录lastActiveDayUTC字段位于基于 XDG 约定解析的缓存目录中。该文件仅在本机保留删除即重置日活去重状态。4. 遥测如何工作源码级剖析政策指出遥测通过PostHog进行匿名产品分析默认启用与 cmux 相同的 opt-out 姿态其目的仅为估算活跃安装量。下面从源码还原完整管线。4.1 核心模块结构遥测逻辑集中在 packages/telemetry-core/src 下职责划分清晰文件职责record-daily-active.ts日活事件上报入口串联客户端创建、去重判断、上报与关闭activity-state.ts本地日活去重状态读写posthog-activity.jsonenv.ts环境变量解析与 opt-out 判定shouldDisableTelemetryconstants.ts默认 PostHog Host、默认 API Key 与未配置占位 Keyposthog-client.ts创建 PostHog 客户端、注入共享属性、发送事件machine-id.ts从主机名生成伪匿名安装标识4.2 调用链recordDailyActiverecordDailyActiverecord-daily-active.ts是日活上报的核心入口调用链如下先调用isTelemetryClientEnabled检查开关与 API Key 是否有效无效则直接返回连客户端都不创建创建 PostHog 客户端若创建失败如初始化异常返回空操作客户端读取本地posthog-activity.json计算当日是否已上报若当日已上报则关闭客户端直接返回否则trackActive上报事件携带day_utc、distinctId、reason随后flush并shutdown。4.3 伪匿名标识主机名单向哈希getTelemetryDistinctId 的实现是sha256(machineIdPrefix hostname)的十六进制摘要——原始主机名不会离开机器外部仅能看到不可逆的哈希值这正对应政策中由本地主机名单向哈希派生的伪匿名安装标识的描述。4.4 PostHog 客户端配置细节createTransport 展示了客户端的安全配置倾向enableExceptionAutocapture: false、enableLocalEvaluation: false、disableRemoteConfig: true——关闭异常自动采集与远程配置拉取杜绝意外数据外泄flushAt: 1、flushInterval: 0——事件即时刷出不批量滞留本地$process_person_profile: falseposthog-client.ts——明确不创建用户画像与政策承诺一致默认 Host 为https://us.i.posthog.com见 constants.tsAPI Key 可通过POSTHOG_HOST/POSTHOG_API_KEY环境变量覆盖内置一个值为phc_REPLACE_ME_OMO_NATIVE的未配置占位 Key该值被刻意设计为必须 fail closed未配置即禁用。共享属性getSharedProperties包括平台、包名与版本、运行时、OS 版本/架构、CPU 数量与型号、内存分桶GB、locale、时区Intl.DateTimeFormat().resolvedOptions().timeZone、shell、是否 CI、终端程序等——注意 CPU 型号与内存仅以计数 / 取整 GB 形式出现并包在 try/catch 中以应对读取失败。4.5 每日去重机制getDailyActiveCaptureState 用toISOString().slice(0, 10)得到当日 UTC 日期字符串与本地状态中的lastActiveDayUTC比较相同则不再上报不同则先原子写入新日期再上报。这正是每台机器每个 UTC 日最多一次承诺的实现基础。5. 完整的 Opt-out 退出矩阵政策给出两类退出方式均可在任何时间生效。5.1 环境变量推荐全局生效在运行 CLI 或插件宿主之前设置任一全局开关即可彻底关闭遥测export OMO_SEND_ANONYMOUS_TELEMETRY0 # 或 export OMO_DISABLE_POSTHOG15.2 omo-codex 专属开关export OMO_CODEX_DISABLE_POSTHOG1 export OMO_CODEX_SEND_ANONYMOUS_TELEMETRY0OMO_CODEX_DISABLE_POSTHOG与OMO_CODEX_SEND_ANONYMOUS_TELEMETRY仅抑制omo-codex的遥测而全局开关OMO_DISABLE_POSTHOG/OMO_SEND_ANONYMOUS_TELEMETRY同时抑制 oh-my-openagent/oh-my-opencode 与 omo-codex 两边的遥测。关闭后 PostHog 事件不再发送。5.3 开关的源码语义env.ts 中的shouldDisableTelemetry精确实现了上述语义*_DISABLE_POSTHOG的真值为1/true/yes先 trim 再小写归一化*_SEND_ANONYMOUS_TELEMETRY的退出值为0/false/no以及归一化后的yes保持收敛一致前缀集合取OMO全局前缀与产品专属前缀如OMO_CODEX的并集因此全局开关天然覆盖 codex额外的DO_NOT_TRACK1也是一个全局退出开关对 omo-opencode、omo-codex、omo-senpi 一律生效。这一矩阵被 env.test.ts 以OPT_OUT_CASES表驱动用例逐条锁定包括OMO_CODEX_SEND_ANONYMOUS_TELEMETRY: TRUE 带空格大写与maybe无效值不退出等边界情况防止后续回归。5.4 配置文件方式对于 OpenCode 插件还可以在 oh-my-openagent 配置中设置telemetry: false关闭遥测。对应地packages/omo-config-core/src/schema/telemetry.ts 中的telemetry.enabled为布尔值且默认true并明确telemetry.enabled属于 senpi harness 支持项TELEMETRY_HARNESS_SUPPORT。6. 第三方服务服务可能使用以下第三方提供方各自适用其独立的条款与隐私实践PostHog匿名产品分析npm 与 GitHub包分发、发布与仓库托管OpenCode 及你自行配置的模型提供方用于你自己的代理使用其数据流向由你的配置决定与本遥测路径无关。7. 信息用途、保留与你的选择收集的信息仅用于三类目的估算日活 / 周活 / 月活安装量了解跨操作系统与包版本的总体采纳情况维护与演进服务。政策明确声明不会通过该遥测路径出售个人信息。匿名分析数据的保留仅以满足采纳分析所需的合理时间为限本机遥测状态如posthog-activity.json则一直保留到你自行删除。作为用户你随时可以通过环境变量或telemetry: false配置关闭匿名遥测删除本机的本地配置或缓存状态文件随时停止使用该服务。8. 安全、政策变更与联系项目对自身控制的系统采取合理的行政与技术安全措施同时政策如实声明任何传输或存储方式都无法做到绝对安全。政策可能不定期更新重大变更会通过修订文档顶部日期体现。有关本政策的疑问可通过项目仓库的 issue 跟踪器或仓库中公布的联系渠道提出。9. 延伸阅读隐私政策原文docs/legal/privacy-policy.md配套服务条款docs/legal/terms-of-service.mdOmO Native 完整事件 schemadocs/reference/senpi-telemetry.md遥测核心实现packages/telemetry-core/src入口 index.ts配置 schemapackages/omo-config-core/src/schema/telemetry.ts退出矩阵测试证据packages/telemetry-core/src/env.test.ts【免费下载链接】oh-my-openagentOmO: Just type mass ulw keyword with your prompt. Now you are the master of graph engineering.项目地址: https://gitcode.com/gh_mirrors/oh/oh-my-openagent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考