核心用法
AppleScript 技能是一套面向 macOS 的自动化执行框架,核心依赖系统自带的 osascript 解释器。用户通过自然语言描述自动化需求(如控制应用、提取数据、执行 UI 操作),Agent 负责脚本设计、安全执行、输出解析与故障排查。
关键工作流包括:
- 词典发现:在猜测对象名称前,先通过
app-dictionary-workflow.md流程检查目标应用的脚本化能力 - 脚本模式:使用
script-patterns.md中的安全引用模式,禁止直接将原始用户文本拼接到 AppleScript 命令字符串 - 执行边界:优先编写短脚本,明确指定目标与输出值,便于快速验证结果
显著优点
1. 安全优先架构:强制分类操作范围(只读/可逆写入/破坏性写入),破坏性操作需两步确认
2. 确定性转义:通过标准化模式处理动态输入,消除引号注入导致的语法错误或命令劫持
3. 故障可恢复:错误捕获包含精确命令与错误文本,配合 troubleshooting.md 提供针对性修复而非盲目重试
4. 本地化运行:零网络依赖,数据仅存储于 ~/applescript/,不涉及第三方 API
潜在缺点与局限性
- 平台绑定:仅限 macOS,Windows/Linux 用户无法使用
- 应用兼容性:目标应用必须支持 AppleScript/Apple Events,现代沙盒应用(如部分 App Store 应用)可能脚本化能力有限
- UI 自动化脆弱性:依赖应用启动时机,过早执行 UI 脚本可能导致间歇性失败
- 学习曲线:需理解 AppleScript 的英文自然语法及字典结构,复杂自动化仍需一定专业知识
适合人群
- macOS 高级用户与自动化爱好者
- 需要批量处理应用数据(邮件、日历、Finder 等)的办公效率追求者
- 开发运维人员需通过脚本控制 macOS 应用状态
- 对「安全执行边界」有明确要求的敏感环境操作者
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 运行时失败 | 猜测词典术语导致编译通过但执行失败 | 强制先执行词典发现流程 |
| 数据误操作 | 未预读直接写入导致错误对象被修改 | 执行「先读后写」验证模式 |
| 破坏性误删 | 批量删除/不可逆应用操作无确认 | 强制两步确认 + `safety-checklist.md` 检查 |
| 权限问题误判 | 将所有错误归因于权限而重复失败 | 精确错误捕获与针对性修复建议 |