SuperAPI AI 工具集

wield

通用与其它

查看项目

更新于 10-16 09:52

技能介绍

wield 面向 macOS 桌面自动化,核心用途是让 Mac 上的原生应用以编程方式被驱动。它编写 AppleScript、JXA 和 osascript,控制 Finder、Mail、Safari、Calendar、Notes、Reminders、Music、Keynote、Terminal、System Events 等应用,也能把多个应用串成可靠的多步骤工作流;当应用没有 AppleScript 字典时,可退回到 UI/GUI 脚本。每次交付包含可运行脚本以及所需的权限与安全设置。

主要能力:支持单应用控制、跨应用编排、无字典应用的 UI 脚本、将 osascript 接入 shell/shebang/Python/Node、审查与加固既有 AppleScript(权限、安全、幂等性)、AppleScript 与 JXA 互转。默认子命令 automate 会自动识别目标应用与实现方式;另有 control、ui-script、integrate、audit、convert。

必要用法:遵循 CLARIFY→INSPECT→SCRIPT→DRY-RUN→HARDEN→DELIVER 流程;先检查目标应用的 sdef 字典,优先用字典术语,UI 脚本仅作兜底;破坏性操作(删除、发送、覆盖、移入废纸篓)需事先声明并用 dry-run 或确认门控;设计时考虑 TCC,说明触发的 Apple Events 权限对,处理错误 -1743,尽量保持 StandardAdditions 进程内;交付时给出精确运行命令(osascript 调用或 .scpt 保存运行方式)与权限授权路径,并保证重跑幂等。

适用场景:原生 macOS 应用自动化、桌面多应用工作流、向无字典应用做 GUI 脚本、把 osascript 集成进脚本管道,以及脚本审查加固与语言转换。

限制与边界:不负责浏览器/网页自动化(Playwright/DevTools)、iOS 应用 UI 自动化(XCUITest)、独立 CLI/TUI 工具构建、dotfiles/shell 配置管理,以及单纯调度时序设计。不推荐关闭 TCC/SIP 或绕过权限提示作为“修复”;不得静默吞掉 -1743 等 Apple Events 错误;不得在脚本中明文嵌入凭据。若生成的是破坏性脚本,必须带 dry-run 或确认门控;涉及真实数据、辅助功能/完全磁盘访问、5 个以上应用或无人值守安装时需先征询。