【免费下载链接】macos-harnessThe simplest, thinnest harness that gives an LLM complete freedom to control a Mac.项目地址https://gitcode.com/gh_mirrors/mac/macos-harness点击查看免费下载macOS Harness是一个让 LLM 直接控制 Mac 的极简工具官方说明中有一句容易被忽略的话匿名遥测默认开启。它到底收集了什么会不会把屏幕内容、文件路径、聊天记录发出去这篇文章带你完整看懂 macOS Harness 遥测机制——记录了什么、怎么发送、以及如何一键关闭。一、先说结论遥测只记命令类别 运行元数据 macOS Harness 的遥测模块总共只有一两百行代码全部集中在 src/macos_harness/telemetry.py 中文件开头的设计目标写得很直白Tiny, privacy-safe, opt-out——极小、隐私安全、可随时退出。核心规则只有一条遥测只记录哪个已知命令、是否成功、花了多久外加少量运行环境信息绝不记录任何用户数据。二、遥测到底记录了什么一张清单看明白每次执行macos-harness命令结束时cli.py 都会在finally块中调用capture_cli()上报一次事件事件名macos_harness_cli。完整字段清单如下字段含义示例值command命令类别仅限白名单值doctor、see、repl…success本次执行是否成功true/falseduration_seconds执行耗时秒保留 2 位小数1.23macos_harness_version工具版本0.1.2python_versionPython 主/次版本3.12os/machine操作系统 / 硬件架构Darwin/arm64agent检测到哪个 AI 客户端在调用codex、claude-code…两个值得展开的设计command 字段有白名单机制只有 7 个命令会被原样记录python、doctor、apps、repl、skill、see、state见 telemetry.py 中的COMMANDS。任何其他值都会被归一化为python所以你输入的参数、脚本内容、应用名在结构上就不可能被带出去。agent 字段靠环境变量猜测遥测会检查环境变量来判断是哪个 AI 客户端在调用CODEX_THREAD_ID→ codex、CLAUDECODE→ claude-code、CURSOR_AGENT→ cursor、GEMINI_CLI→ gemini-cli、OPENCODE→ opencode见 telemetry.py。没有命中任何标记时该字段为空。三、遥测绝对不记录的内容README 的 Permissions and privacy 一节给出了明确的负面清单❌ 你给 Agent 的提示词prompts❌ 应用名称app names❌ 截图screenshots❌ 屏幕上的 UI 文本❌ AppleScript 脚本内容❌ 文件路径、窗口标题这不只是口头承诺而是有自动化测试守护的。tests/test_telemetry.py 会把真实上报的 payload 序列化后断言其中不含app、path、prompt、script、screenshot、text、title、window等任何敏感字样CONTRIBUTING.md 也把绝不通过遥测发送用户数据列为项目三大不可妥协原则之一。四、install_id一个随机 UUID不是硬件指纹 上报数据需要一个标识符来区分不同安装macOS Harness 的做法是首次运行时生成一个随机 UUIDv4作为install_id写入本地配置见 telemetry.py配置文件默认位于~/Library/Application Support/macos-harness/telemetry.json可通过MACOS_HARNESS_HOME环境变量改变位置见 telemetry.py目录权限设为700、文件权限设为600仅本用户可读写见 telemetry.py注意这个 ID 与硬件序列号、MAC 地址、用户名均无关删掉配置文件就是全新的匿名身份。此外 payload 中还显式设置了$process_person_profile: False和$geoip_disable: True——不做用户画像合并、不做 IP 地理位置解析见 telemetry.py。五、数据怎么发出去后台静默、失败无感 发送逻辑见 telemetry.py每次上报启动一个分离的后台子进程发送不阻塞你的命令执行默认 5 秒超时可用MACOS_HARNESS_TELEMETRY_TIMEOUT调整目标是 PostHog 的欧洲节点eu.i.posthog.com地址可用MACOS_HARNESS_POSTHOG_HOST覆盖任何异常都被静默吞掉——网络不通、超时、报错都不会影响正常使用换句话说遥测是锦上添花式的发不出去工具也不会变慢或失败。六、如何关闭 macOS Harness 遥测一条命令即可 方法一一条命令永久关闭推荐macos-harness telemetry disable它会在本地配置中写入disabled: true之后所有上报直接跳过。随时可以用macos-harness telemetry status查看当前状态输出 JSON是否启用、install_id、配置文件路径用macos-harness telemetry enable重新开启。命令实现见 telemetry.py官方安装文档 install.md 也有同样说明。方法二环境变量即时关闭以下任意一个环境变量生效即可禁用遥测判断逻辑见 telemetry.py环境变量生效取值MACOS_HARNESS_TELEMETRY0/false/no/offANONYMIZED_TELEMETRY0/false/no/offDO_NOT_TRACK1/true/yes/on比如MACOS_HARNESS_TELEMETRY0 macos-harness doctor本次运行就不收集任何数据。七、小结macOS Harness 的遥测机制可以概括为三点记录极小只有命令类别、成功与否、耗时、版本与平台信息匿名彻底随机 UUID 关闭地理解析 不做用户画像退出自由一条命令或环境变量即可完全关闭且有自动化测试防止用户数据混入上报如果你打算把 macOS Harness 交给 AI 助手长期使用建议先跑一次macos-harness telemetry status确认状态再按需选择开启或关闭——知情才有得选。赞分享【免费下载链接】macos-harnessThe simplest, thinnest harness that gives an LLM complete freedom to control a Mac.项目地址https://gitcode.com/gh_mirrors/mac/macos-harness点击查看免费下载相关推荐StashBase遥测与用量统计透明解读它到底收集了什么如何一键关闭StashBase遥测与用量统计透明解读它到底收集了什么如何一键关闭 StashBase 是一款开源、本地优先local first的写作工作台让你GLiNER2 深度拆解从 arXiv:2507.18546 到「省 80% token」它到底动了什么手术GLiNER2 深度拆解从 arXiv:2507.18546 到「省 80% token」它到底动了什么手术 2025 年 7 月一篇 arXiv 论文人工智能NLP信息抽取macOS Harness 安全与隐私指南最小权限原则与匿名遥测机制详解macOS Harness 安全与隐私指南最小权限原则与匿名遥测机制详解 macOS Harness 是给予 LLM 完整控制 Mac 能力的最薄一层工具这上一篇告别MSVCP140.dll报错Visual C运行库合集vcredist完整安装指南下一篇内存管理工具自救指南一个被电脑卡到怀疑人生的人的 Mem Reduct 实战手记创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
