AppleScript

🍎 安全优先的 macOS 自动化引擎

专为 macOS 设计的 AppleScript 自动化工具,采用「先读后写」安全模式,支持应用词典发现与确定性转义,适合需要稳定 UI 自动化与数据提取的专业用户。

收藏
4.8k
安装
989
版本
1.0.0
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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` 检查 |
| 权限问题误判 | 将所有错误归因于权限而重复失败 | 精确错误捕获与针对性修复建议 |

AppleScript 内容

手动下载zip · 8.1 kB
app-dictionary-workflow.mdtext/markdown
请选择文件