mcpField
S
setup-macbook-productivity

setup-macbook-productivity

github.com/arthurzakirov生产力1164 次安装2 周前更新
代码仓库

关于 setup-macbook-productivity

用于配置 macOS 听写和 Google Drive 的 Raycast 启动器的技能，涵盖设置、用户确认与验证，并避免绕过隐私控制或直接修改 Raycast 数据库。

主要功能

  1. 01将听写快捷键设为连按两次 Control
  2. 02创建可由 Raycast 索引的 Google Drive 启动器
  3. 03验证设置与启动器行为
  4. 04遵守 macOS 隐私提示

适用场景

  1. 01在 Mac 上启用并测试听写
  2. 02通过 Raycast 重新打开已运行的 Google Drive 界面

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arthurzakirov/agentdesk --skill setup-macbook-productivity

安装后在 Claude Code 中输入/setup-macbook-productivity确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
scripts/
setup_google_drive_raycast_launcher.py
setup_voice_typing.py

详细介绍

设置 MacBook 生产力

概述

使用此技能配置本地 macOS 生产力偏好设置，侧重于可重复的设置、验证，以及在 macOS 需要用户确认时打开相关的「系统设置」面板。

支持的工作流：

  • 使用 Control-Control 快捷键进行语音输入 / 听写。
  • 为 Google Drive 创建便于 Raycast 使用的启动器，适用于 Google Drive 运行正常但 Raycast 无法重新打开其界面的 Mac。

语音输入工作流

  1. 确认主机运行的是 macOS：
sw_vers
  1. 运行随附的设置脚本：
python3 "$CODEX_HOME/skills/setup-macbook-productivity/scripts/setup_voice_typing.py"

如果未设置 CODEX_HOME，请使用：

python3 "$HOME/.codex/skills/setup-macbook-productivity/scripts/setup_voice_typing.py"

  1. 告知用户，macOS 可能仍会显示一次性听写隐私提示或下载提示。如果出现提示，请点击 启用。对于 Apple 音频共享，除非用户明确想要共享录音，否则建议选择 暂不。

  2. 请用户在任意文本字段中按两次 Control 进行测试。按 Esc 或再次按相同快捷键即可停止听写。

听写脚本的作用
  • 启用已知的听写偏好设置标记。
  • 将听写符号热键（AppleSymbolicHotKeys id 164）设置为可正常使用的 Control-Control 修饰键快捷键。
  • 重启偏好设置服务，使 macOS 注意到更改。
  • 打开 系统设置 > 键盘，以便用户批准任何所需提示并检查听写设置。
  • 输出最终的听写和快捷键状态以供验证。
听写验证
defaults read com.apple.HIToolbox AppleDictationAutoEnable 2>/dev/null
defaults read com.apple.assistant.support "Dictation Enabled" 2>/dev/null
defaults read com.apple.symbolichotkeys AppleSymbolicHotKeys | sed -n '/164 =/,/};/p'

预期结果：

  • 前两个命令返回 1。
  • 热键 164 的 enabled = 1、type = modifier，且参数与 Control-Control 匹配。

如果听写仍未启动，请打开 系统设置 > 键盘 > 听写，确认听写已开启，将 快捷键 设为 按两次 Control 键，并选择所需的麦克风来源。

Google Drive + Raycast 工作流

以下条件全部满足时，使用此工作流：

  • 已安装 Google Drive 桌面版，且其文件已挂载或可通过其他方式访问。
  • 在 Finder 中直接打开 Google Drive.app 可以成功重新打开 Drive 界面。
  • 由于 Drive 已作为后台 / 菜单栏应用运行，从 Raycast 启动 Google Drive 时看似没有任何反应。
  • 用户希望使用常规的 Raycast / ⌘ Space 工作流，而不是终端命令。

运行：

python3 "$CODEX_HOME/skills/setup-macbook-productivity/scripts/setup_google_drive_raycast_launcher.py"

如果未设置 CODEX_HOME，请使用当前运行环境对应的已安装技能路径。

Google Drive 启动器脚本的作用

该脚本会创建：

~/Applications/Google Drive Launcher.app

此启动器：

  • 拥有独立的 bundle 标识符，因此 macOS 和 Raycast 可以将其编入索引，作为单独的应用。
  • 在可用时使用 Google Drive 图标。
  • 调用 macOS LaunchServices 重新打开 /Applications/Google Drive.app。
  • 避免修改 Raycast 的专有内部数据库。
  • 让用户日常操作完全通过图形界面完成：在 Raycast 中搜索 Google Drive Launcher 并按 Enter。

该脚本具有幂等性：重复运行会在原位置重新创建相同的启动器 bundle。

Google Drive 验证

设置完成后，验证 macOS 能否解析该启动器：

open -Ra "Google Drive Launcher"

然后启动一次：

open "$HOME/Applications/Google Drive Launcher.app"

如需进行更严格的行为检查，请检查最近的 Google Drive 日志，确认是否有重新打开事件：

tail -80 "$HOME/Library/Application Support/Google/DriveFS/Logs/drive_fs.txt" \
  | grep 'applicationShouldHandleReopen'

成功运行后，应出现近期的 applicationShouldHandleReopen / Got double launch 日志条目，并重新打开与 Finder 打开时相同的 Drive 界面。

如果 Raycast 中没有立即显示 Google Drive Launcher，请在 macOS 将启动器编入索引后重启 Raycast。

诊断说明

不要因为 Google Drive 菜单栏图标缺失，就认定 Drive 本身出了问题。首先区分以下情况：

  1. Drive 进程运行正常，且已挂载的文件可用。
  2. 在 Finder 中重新打开应用后，应用可以正常工作。
  3. 只有通过 Raycast 激活时才会失败。

如果以上三个条件都成立，应优先采用上文的启动器变通方案，而不是重新安装 Drive 或修补 Raycast 数据库。

在 macOS 版本中，如果“控制中心”状态受 TCC 保护，不要绕过隐私控制来检查或修改受保护的菜单栏注册表。请将缺少“屏幕录制”或“辅助功能”权限视为边界条件，而非 Drive 已损坏的证据。

边界

不要尝试绕过 macOS 隐私提示。请打开“设置”，并让用户批准需要人工选择的提示。

除非用户要求通过语音控制 Mac，否则不要启用完整的 语音控制。启用语音控制后，标准听写功能会被替代。

如果受支持的已索引应用机制或脚本命令机制可以实现相同结果，就不要直接编辑 Raycast 的专有数据库。

评论

支持 Markdown