alchaincyf/huashu-mac-use

它是什么

huashu-mac-use 是一个面向 macOS 的 Agent Skill 库，让 AI agent 能直接操控那些没有开放 API 的原生应用。它通过读后台数据、写操作不打扰用户、每一步都留下取证记录，实现完整的 computer use 能力。项目基于 Swift 编写，采用 MIT 协议开源。

核心亮点

• 无 API 也能控：绕过应用限制，直接操作 UI 层，打通 agent 与原生 app 的隔阂
• 后台读取：无需切换焦点即可获取应用状态，减少对用户工作的干扰
• 取证留痕：每次操作自动记录截图或日志，方便回溯与调试，增强可信度
• 轻量集成：作为 Agent Skill 可快速嵌入现有 agent 工作流，无需重写核心逻辑

为什么火

在 AI agent 向“电脑使用”场景进军的当下，macOS 上大量关键应用（如 Xcode、设计工具）没有稳定 API，而 huashu-mac-use 精准填补了这一空白。其“不打扰 + 可取证”的设计理念，兼顾了效率与安全，让开发者看到了 agent 真正落地日常办公的潜力，上线即获 228 星并持续升温。

适合谁用

• AI 应用开发者：需要让 agent 操作桌面软件但受限于 API 缺失
• 自动化脚本爱好者：希望用自然语言或 agent 控制 Mac 原生应用
• 企业效率团队：探索 AI 辅助完成复杂桌面任务，且要求操作留痕合规

快速上手

1. 克隆仓库并打开 huashu-mac-use.xcodeproj
2. 按照 README 配置辅助功能权限（需授权 Accessibility）
3. 将编译生成的 skill 文件导入你的 agent 框架（如 LangChain、AutoGPT）
4. 调用示例命令，如“读取当前 Pages 文档光标位置”，即可验证后台读取能力
5. 查看 logs/ 目录下的操作记录，确认取证功能正常