【免费下载链接】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 CLI 是 macOS Harness 项目提供的唯一命令行入口一条命令把 Python、真实的 macOS 应用和你的浏览器连在同一个进程里让 AI Agent或你本人能截图、打字、点击、执行 AppleScript。它是最薄的一层“控制 harness”不封装任何具体 App 工具只给出最原始的操作原语。本文带你逐条解析doctor、apps、repl、see、state等命令的用法、参数与典型场景帮助新手快速上手这套 Mac 自动化 CLI 工具。一分钟认识 macOS HarnessmacOS Harness 的设计理念是“六动词”see看、key按键、type打字、click点击、ax无障碍树、scriptAppleScript。没有 Spotify 工具、没有 Slack 工具——模型拿到的是原始能力缺失的逻辑由它在任务中途用普通 Python 补上。安装后你会得到一个可执行文件macos-harness所有功能都通过子命令暴露# 安装需要 Python 3.12 uv tool install --python 3.12 --upgrade --force macos-harness完整安装说明见 install.md。命令速查表命令作用一句话说明macos-harness doctor体检以 JSON 报告 macOS 权限与运行时状态macos-harness apps列应用枚举正在运行的 App名称、Bundle ID、PIDmacos-harness see app截图后台截取指定应用窗口带虚拟指针macos-harness state app读状态输出应用的 AccessibilityAX状态为 JSONmacos-harness repl交互启动持久的交互式 Python 会话macos-harness skill技能打印供 Agent 注册的技能文档macos-harness telemetry遥测查看或开关匿名遥测macos-harness无参数执行从标准输入读取 Python 并执行各命令的定义集中在 cli.py建议对照源码阅读。doctor首次运行前的权限体检 macOS 对“读屏幕、发输入、自动化”有严格的隐私限制。doctor是安全的第一步——它只报告、不弹窗macos-harness doctor输出是一个 JSON 报告核心字段来自 macos.pypermissions.accessibility辅助功能权限截图、按键、点击都需要它permissions.screen_recording屏幕录制权限permissions.post_events发送输入事件的权限permissions.automation自动化Apple Events权限按目标应用逐一授权如果某项权限缺失在获得用户确认后再加--request参数macOS 会弹出系统授权窗口macos-harness doctor --request 经验法则装完先跑一次不带--request的doctor按报告去「系统设置 → 隐私与安全性」手动授权比一路点“允许”更可控。apps列出正在运行的应用apps返回一个按名称排序的 JSON 数组每项包含name、bundle_id、pid、path四个字段实现在 macos.pymacos-harness apps它的价值在于帮你确认应用名到底怎么拼——后续所有命令的app参数都支持应用名、Bundle ID、路径或 PID 四种匹配方式见 应用解析逻辑。如果匹配到多个应用CLI 会报ambiguous错误并列出候选项此时改用 PID 即可精确命中。see后台截图不打扰你的前台 see是整套工具最核心的命令它截取指定应用某个窗口的画面但不会把该应用拉到前台也不移动你的真实鼠标macos-harness see Finder macos-harness see Spotify --max-width 800 --max-height 600参数说明定义于 cli.py参数默认值作用app必填应用名 / Bundle ID / PID--max-width1280输出图最大宽度超出则等比缩放--max-height1280输出图最大高度--no-pointer关闭不在图上绘制虚拟指针返回 JSON 包含图片路径、实际尺寸、窗口 bounds、缩放系数scale_x/scale_y以及焦点信息见 see 实现。特别注意focus.target_is_frontmost字段——它保证截图过程没有“偷偷抢焦点”。为什么需要缩放Retina 屏上窗口原始像素可能远超 1280直接喂给模型太贵。see会自动用 Lanczos 算法压到上限尺寸scale_x/scale_y则告诉你后续点击坐标该如何换算。state把无障碍树打印成 JSON截图解决“看”state解决“精确”它遍历应用的 Accessibility 树把每个控件的角色、标题、值、坐标、可用动作全部输出为 JSON实现在 get_app_statemacos-harness state Finder --screenshot --max-depth 10参数说明参数默认值作用app必填目标应用--screenshot关同时附带一张窗口截图--max-depth25AX 树遍历的最大深度--max-nodes5000最多输出的节点数防止超大应用拖慢--include-menu-bar关是否包含系统菜单栏输出中每个节点都带element_index在repl里可以直接用它读取属性或执行动作例如AXPress模拟按钮点击。对大应用适当调小--max-nodes能显著加快输出。repl交互式 Python 探索会话repl启动一个持久的交互式 Python 会话mac、browser、Path、subprocess四个对象开箱即用macos-harness repl进入后可以直接敲 mac.see(Finder) mac.key(cmdk, appFinder)它适合人工探索一个应用的控件结构官方建议日常任务优先用 stdin 方式把repl留给手动调试用完记得退出见 SKILL.md。隐藏高手用法stdin 直接执行 Python不给任何子命令、且输入不是终端时macos-harness会把标准输入里的 Python 代码直接执行逻辑见 cli.py。这是 Agent 使用它的标准姿势——一次调用完成一个“动作包”而不是每个原语调用一次macos-harness PY mac.see(Spotify) mac.key(cmdk, appSpotify) mac.type(Alessia Cara, appSpotify) print(mac.see(Spotify)) PY 官方技能文档建议把确定性的、可逆的步骤打包成一个 Python 程序一次跑完只在真正的决策点身份不明、新坐标、不可逆操作才停下来观察。skill 与 telemetry两个辅助命令macos-harness skill打印内置的技能文档即 SKILL.md把它存进 Agent 的 skills 目录后Agent 就能“自学会用”这套 CLI。macos-harness telemetry status | enable | disable查看或开关匿名遥测。遥测只记录命令类别、成功与否、耗时等粗粒度信息从不记录提示词、应用名、截图或窗口标题实现见 telemetry.py。macos-harness telemetry disable常见问题速查现象原因与解法Accessibility permission is required未授权辅助功能运行doctor --request或去系统设置授权No running application matches X应用名拼写错误先用apps确认真实名称Application query X is ambiguous多个应用命中改用 PID 精确定位Window screenshot failed缺屏幕录制权限或窗口过小小于 40×40 像素会被过滤所有错误统一以macos-harness: 原因输出到 stderr退出码为 1见 错误处理方便脚本判断成败。小结macOS Harness 把整个 Mac 压缩成了一组极简 CLI 命令用doctor确认权限用apps找目标用see和state观察用 stdin Python 或repl行动。记住这五步流程你就能让 AI Agent或自己在不干扰前台操作的前提下安全地驱动任何正在运行的 macOS 应用。赞分享【免费下载链接】macos-harnessThe simplest, thinnest harness that gives an LLM complete freedom to control a Mac.项目地址https://gitcode.com/gh_mirrors/mac/macos-harness点击查看免费下载相关推荐Xinference命令行工具详解xinference-cli全命令参考Xinference命令行工具详解xinference cli全命令参考 引言告别复杂部署一行命令玩转开源模型 你是否还在为开源大模型的部署流程繁琐而头疼人工智能大模型模型推理服务本地部署后端LLM 网关LongHorizon-Harness CLI 命令速查清单run、init、doctor、plugin 一次讲透LongHorizon Harness CLI 命令速查清单run、init、doctor、plugin 一次讲透 LongHorizon Harness 是人工智能AI AgentAgent 工作流Agent 评测GUI 自动化Hybrid Mount 故障排查完全指南status、vfs-doctor 等 CLI 诊断命令逐一讲解Hybrid Mount 故障排查完全指南status、vfs doctor 等 CLI 诊断命令逐一讲解 Hybrid Mount 是一款面向 Ker上一篇Telegraf Template Serializer 详解用 Go 模板与 Sprig 函数自由定制指标输出格式下一篇openJiuwen 大模型统一调用与管理模块 llm 完全指南Model、ModelClient 与输出解析机制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考