mac-computer-use v0.2.0 · 一份技能，多种 Agent

一份技能包，多 runtime 安装，统一命令启动

基于开放的 Agent Skills 格式，本版新增：

• 标准 license、compatibility 和版本元数据；核心正文不依赖客户端专属工具名称。
• sh scripts/run.sh native ... / cdp ... 统一入口，支持中文、空格和符号链接路径，保留工作目录、参数、JSON 与退出码。
• 指定目录安装、无写入预演、已有目标拒绝，以及 ZIP + SHA-256 分发；安装和打包共用 56 项显式文件清单。
• Claude Code、Codex、Kimi Code、Cursor、OpenClaw、WorkBuddy、豆包工作、千问办公、ZCode 的接入资料与状态表。豆包工作仍列为待验证；不将协议兼容等同于全部客户端完成实测。

安装

npx skills add To3akaRin/mac-computer-use

也可下载附件技能 ZIP，通过客户端技能包入口导入，或解压后运行：

sh scripts/install.sh --skills-dir "/目标技能父目录"

指定目录安装需要 macOS 与 Python 3 标准库；Skills CLI、ZIP 导入和日常执行无需这一额外依赖。本版无新增环境变量，原生仍需 macOS 14+、Swift 6+ 和必要系统权限，CDP 仍需 Node.js 22.4+。

验证

• 45 项 Node 测试通过：20 项 CDP、14 项启动、11 项安装打包。
• GitHub CI 的 Swift 测试、原生自检、官方 Agent Skills 参考校验及技能打包全部通过。
• 实际安装副本首次构建、跨目录相对截图、原生和 CDP 真实交互验收通过。
• ZIP 解压后再次安装、56 项文件字节一致和 SHA-256 校验通过。

CI：https://github.com/To3akaRin/mac-computer-use/actions/runs/34315941476
完整说明：https://github.com/To3akaRin/mac-computer-use/blob/main/references/runtimes.md

mac-computer-use v0.1.0

首个公开版本：独立运行的 macOS 桌面自动化 Agent Skill，支持通用 Agent，附带 Codex 自动发现元数据。

• Swift 原生工具：应用探测、窗口、ScreenCaptureKit 截图、AX、中文输入、鼠标键盘及受控焦点恢复。
• Node.js CDP 工具：页面观察、真实输入、只读断言、截图与遇到未知结果立即停止的批量操作。
• 明确坐标单位、快照约束、预演、超时、互斥锁与 JSON 结果。
• 中文安装说明、命令接口、贡献指南、规格和验收报告。

验证：本机 15 项原生自检、20 项 CDP 单测及两套真实交互测试通过；干净目录构建通过。GitHub CI 完整通过，包含 6 项 XCTest、15 项原生自检和 20 项 CDP 测试。

CI：https://github.com/To3akaRin/mac-computer-use/actions/runs/34208441256

实际本机环境为 macOS 15.7.7 / Apple Silicon / Swift 6.1.2；Node.js 22.23.1 与 24.18.0 已验证。macOS 14 和 Intel 尚未完成实机验收。

附件 ZIP 为源码技能包（解压后按 README 编译），不包含真实桌面截图、用户数据或预编译二进制。SHA-256 文件用于验证下载完整性。