用途:在用户的 MacBook 上配置可重复的 macOS 生产力偏好,偏向可重复设置、验证,并在 macOS 需要用户确认时打开相应的系统设置面板。支持两条工作流:语音输入/听写(Control-Control 快捷键)与 Raycast 友好的 Google Drive 启动器。
主要能力:听写脚本启用已知的听写偏好标志,将听写符号热键(AppleSymbolicHotKeys id 164)设为 Control-Control,重启偏好服务,并打开系统设置 > 键盘以便用户批准提示,最后打印听写与快捷键状态。Google Drive 启动器脚本创建 ~/Applications/Google Drive Launcher.app,使用独立 bundle 标识符以便 macOS 与 Raycast 索引,调用 LaunchServices 重新打开 /Applications/Google Drive.app,且不修改 Raycast 内部数据库;脚本幂等,可重复运行。
使用方式:先确认主机为 macOS(sw_vers)。听写运行 python3 "$CODEX_HOME/skills/setup-macbook-productivity/scripts/setup_voice_typing.py",CODEX_HOME 未设置时用 $HOME/.codex 路径。Google Drive 启动器运行对应 setup_google_drive_raycast_launcher.py。验证听写可用 defaults read 命令检查标志与热键 164;验证启动器可用 open -Ra "Google Drive Launcher" 与 open "$HOME/Applications/Google Drive Launcher.app",并可查看 DriveFS 日志中的 applicationShouldHandleReopen。
适用场景:Google Drive 已安装且文件可访问、Finder 直接打开可恢复界面、但 Raycast 启动无反应时,使用启动器方案而非重装 Drive 或修改 Raycast 数据库。
限制:不要绕过 macOS 隐私提示,需让用户自行批准;除非用户要求用语音控制 Mac,否则不要启用完整 Voice Control;不要直接编辑 Raycast 专有数据库。若 Raycast 未立即显示启动器,可在 macOS 索引后重启 Raycast。