🏠 AI Tools Hub | 首页 | 文章 | 评测 | GitHub热门 | 排行榜

Huashu Mac Use教程：让Agent操控没有API的Mac原生应用

📌 项目日期：2026年9月 | 数据来源：GitHub官方仓库 | 星数：178+

📋 项目简介

Mac上大量应用没有API——Blender有命令行但没有高层接口，豆包、剪映、WPS更是纯GUI。Huashu Mac Use 是一个 Agent Skill，装上之后你可以对Agent说："操控Blender做一个巧克力甜甜圈，渲出来"、"把豆包工作里正在跑的任务截三张过程图，别抢我焦点"、"探一下剪映能不能自动化"。

它的方法论很扎实：先探测，再选层。probe.sh 会告诉你目标app的bundle、架构、有无URL scheme、有无AppleScript字典、有无本地端口、AX树里几个可编辑控件——这是每次动手前的第0步。本地优先的Agent搭档参考 OpenClaw本地AI助手。

🔧 L0-L3四层操控通道

层	手段	什么时候用
L0 结构接口	app自带的CLI、AppleScript字典、URL scheme、内嵌Chromium的CDP	有就用，成本最低最可靠
L1-L3	AppleScript自动化 → 辅助功能AX树 → 截图取证	逐层降级，每层成本差数量级

实测案例：Blender巧克力甜甜圈（Metal GPU两分钟出1920×1440，再打120帧运镜）、豆包工作连续8张过程截图一次焦点都没借、邮轮照片4张多视角→参数化建模→同机位渲染8轮迭代。

📦 安装

# 方式一：把链接丢给 agent
帮我安装这个 skill：https://github.com/alchaincyf/huashu-mac-use

# 方式二：一行命令
npx skills add alchaincyf/huashu-mac-use

# 方式三：手动
git clone https://github.com/alchaincyf/huashu-mac-use.git ~/.claude/skills/huashu-mac-use
bash ~/.claude/skills/huashu-mac-use/scripts/build.sh   # 编译内核，一次就好

# 探测任意app（动手前第0步）
bash ~/.claude/skills/huashu-mac-use/scripts/probe.sh 系统设置

前置：macOS 14+（实测macOS 26）、Xcode CLT、Node.js；给你正在用的终端app授屏幕录制和辅助功能权限（授给终端不是授给脚本，换终端要重新授）。

✅ 使用建议

永远先 probe 再动手——通道选错层，自动化成本差数量级
GUI窗口操作用"后台取证截图"而非抢占焦点，不干扰你手头工作
涉及支付、删除类操作保持人工确认，Agent只做探测与执行

📚 常见问题

Huashu Mac Use是什么？

一个Agent Skill：让AI Agent操控Mac上没有API的原生应用（Blender、豆包、剪映、WPS、系统设置等），通过L0-L3四层通道探测选择最优操控方式，全程不抢焦点、每步留取证。

怎么安装？

三种方式：把GitHub链接丢给agent、npx skills add alchaincyf/huashu-mac-use、或git clone到skills目录后跑build.sh编译内核（Swift单文件，约20秒）。需给终端app授屏幕录制和辅助功能权限。

L0-L3四层通道是什么？

L0结构接口（app自带CLI/AppleScript字典/URL scheme）→ 内嵌Chromium走CDP → AppleScript → AX树；每层成本与可靠性差数量级，从上往下试。