FastScripts for Mac 详细使用指南

FastScripts 是一款专为 macOS 设计的高效脚本启动器与管理工具。它允许用户通过自定义的全局快捷键，快速执行 AppleScript、Shell 脚本、Automator 工作流、Python 等各类脚本，将复杂的自动化操作简化为一次按键，极大地提升了工作流效率。本文旨在提供一份详尽的操作指南，帮助用户从入门到精通。

一、核心界面与工作区详解

FastScripts 采用菜单栏常驻应用模式，界面简洁，主要交互区域分为两部分：菜单栏下拉菜单和偏好设置面板。

1. 菜单栏图标与下拉菜单

• 位置：安装后，FastScripts 图标（默认为一个“播放”按钮形状）会出现在屏幕右上角的菜单栏。
• 功能：点击图标会显示一个下拉菜单，这是 FastScripts 的“命令中心”。
  • 脚本列表：菜单主体部分按文件夹分组显示所有已配置的脚本。脚本前的数字代表其分配的快捷键（如“⌃1”）。
  • 状态指示：正在运行的脚本旁会有指示器。
  • 快速访问：直接点击菜单中的脚本名即可执行，无需快捷键。

2. 偏好设置面板 (Preferences)

这是 FastScripts 的核心控制区，通过点击菜单栏图标选择“Preferences…”或使用快捷键 ⌘, 打开。

• Scripts Tab（脚本选项卡）：
  • 左侧面板：以树状结构显示脚本文件夹，通常对应 ~/Library/Scripts/ 目录及其子文件夹。
  • 右侧面板：显示选中文件夹内的所有脚本文件。可在此为脚本分配快捷键、启用/禁用、重命名或获取信息。
• General Tab（通用选项卡）：
  • 设置菜单栏图标显示样式。
  • 配置辅助功能权限（确保 FastScripts 能控制其他应用）。
  • 设置脚本编辑器的默认打开应用。
• Shortcuts Tab（快捷键选项卡）：
  • 高级快捷键冲突检测与查看。
  • 配置“双键快捷键”触发前缀（如先按 ⌃⌥ 再按其他键）。

二、完整操作流程：从配置到执行

以下流程将引导您完成从准备脚本到通过快捷键执行的完整过程。

步骤 1：创建或打开脚本项目（在脚本编辑器或文本编辑器中）

方法：FastScripts 本身不编写脚本，它负责调用。您需要先在其他应用中创建脚本。

1. 打开“脚本编辑器”（用于 AppleScript）或任何代码编辑器（如 VS Code、BBEdit 用于 Shell/Python 等）。
2. 编写您的脚本。例如，一个简单的 AppleScript：tell application "Finder" to make new folder at desktop。
3. 将脚本文件保存到 FastScripts 监控的目录。最常用的目录是 ~/Library/Scripts/。您可以在其中创建子文件夹（如“文件操作”、“Safari 工具”）来分类管理。

步骤 2：在 FastScripts 中分配与管理脚本

1. 打开偏好设置：点击菜单栏的 FastScripts 图标，选择“Preferences…”，或按 ⌘,。
2. 定位脚本：在“Scripts”选项卡的左侧文件夹树中，导航到您保存脚本的文件夹。右侧会列出所有脚本。
3. 分配快捷键：点击脚本右侧“Shortcut”列下的空白区域，然后按下您想设置的组合键，例如 ⌃⌥⇧C。快捷键会立即生效。
4. 启用/禁用脚本：勾选或取消勾选脚本前的复选框，可以临时启用或禁用该脚本（禁用后不会出现在菜单中）。

步骤 3：执行脚本

有三种主要执行方式：

1. 使用全局快捷键（最快捷）：在任何应用程序中，直接按下您分配的快捷键（如 ⌃⌥⇧C），脚本将立即在后台执行。
2. 通过菜单栏菜单：点击 FastScripts 菜单栏图标，在下拉菜单中找到对应的脚本名称并点击。
3. 使用双键快捷键（可选）：如果启用了此功能（在 Shortcuts Tab 设置），可以先按前缀键（如 ⌃⌥），松开后再按一个字母键（如 C）来触发脚本。

步骤 4：查看结果与日志

脚本执行后，效果取决于脚本本身（如创建文件夹、操作文本等）。如果脚本有输出：

• AppleScript 的“say”或对话框命令会直接显示。
• Shell 脚本的输出默认不可见。如需调试，可在脚本中重定向输出到文件，或使用 osascript -e 'display dialog "完成"' 之类的命令弹出提示。

三、常用功能进阶技巧

1. 脚本文件夹与组织

• 在 ~/Library/Scripts/ 下创建逻辑清晰的子文件夹（如“写作助手”、“开发调试”、“系统管理”）。FastScripts 的菜单和偏好设置面板会完全镜像这个结构。
• 将常用脚本的快捷键设置为易于记忆的组合，如将“复制当前网页标题和URL”设置为 ⌃⌥C。

2. 应用专属脚本

这是 FastScripts 的杀手级功能，允许您为特定应用分配专属脚本，该脚本仅当目标应用处于活动状态时才会出现在菜单中或响应快捷键。

操作方法：

1. 在偏好设置的“Scripts”选项卡中，选中一个脚本。
2. 点击右下角的“Info”（信息）按钮（或右键选择“Get Info”）。
3. 在弹出的信息窗口中，从“Application”下拉菜单中选择一个特定的应用程序（如“Safari”、“Xcode”）。
4. 保存后，该脚本及其快捷键将只在您选定的应用前台运行时生效。

3. 使用“备用快捷键”避免冲突

如果某个全局快捷键与其他应用冲突，FastScripts 允许设置备用快捷键。在快捷键设置框按下多个组合键（用逗号分隔），例如输入 ⌃1, F1，则两个快捷键都能触发同一脚本。

四、常见问题与解决方案

问题 1：快捷键按下后无反应

• 可能原因：系统辅助功能权限未授予。
• 解决方案：
  1. 打开“系统设置” > “隐私与安全性” > “辅助功能”。
  2. 在应用列表中找到并勾选“FastScripts”。如果不在列表中，点击“+”号添加它。
  3. 重启 FastScripts。

问题 2：菜单栏图标不显示

• 可能原因：被系统菜单栏隐藏，或应用未正常启动。
• 解决方案：
  1. 检查“系统设置” > “控制中心”中相关设置，确保菜单栏允许显示第三方图标。
  2. 打开 FastScripts 偏好设置的“General”选项卡，确认“Show FastScripts in menu bar”被勾选。
  3. 在“活动监视器”中重启“FastScripts”进程，或重新启动应用。

问题 3：Shell/Python 脚本执行失败

• 可能原因：脚本文件无可执行权限，或脚本内部命令路径问题。
• 解决方案：
  1. 在终端中，使用 chmod +x /path/to/your/script.sh 命令为脚本添加执行权限。
  2. 在脚本内部，使用绝对路径引用命令（如 /usr/local/bin/python3 而非 python3），或正确设置 PATH 环境变量。

五、FastScripts for Mac 快捷键汇总表

通过以上指南，您可以充分利用 FastScripts 将 macOS 的自动化潜力发挥到极致，打造出高度个性化且高效的工作环境。其核心在于将重复性操作封装为脚本，并通过直观的快捷键调用，从而实现“一键化”操作体验。