FaceToTalk 是一个非官方、纯本地的 macOS 菜单栏实验应用：使用内建摄像头和 Apple Vision 判断头部是否大致朝向屏幕，可选择控制 Codex / ChatGPT 快捷键，或控制系统默认输入设备的静音状态。
FaceToTalk is an unofficial, local-only macOS menu bar experiment. It is not affiliated with or endorsed by OpenAI.
- 连续朝向屏幕达到设定时间后，发送一次快捷键。
- 连续转开、未检测到人脸或角度数据不足达到设定时间后，再发送一次快捷键。
- 默认打开延迟为 1.0 秒，关闭延迟为 3.0 秒。
- 支持录制自定义组合键，并保存到本机
UserDefaults。 - 支持“按一下切换”和“按住说话”两种快捷键语义。
- 支持互斥的“Codex 快捷键”与“系统麦克风”两种控制方式，不会同时控制。
- 系统麦克风模式在暂停、切换模式或正常退出时恢复进入该模式前的状态。
- 可分别调整正对和转开的左右/上下角度，设置会自动保存并即时生效。
- 默认只在 Codex / ChatGPT 位于前台时发送事件。
- 菜单栏显示实时姿态、计时进度、权限状态和推测的语音状态。
- 支持 Apple Silicon 与 Intel，Deployment Target 为 macOS 13.3。
内建摄像头
-> AVFoundation 低分辨率视频帧
-> Vision 最大人脸 yaw / pitch
-> Facing / Away / No Face / Uncertain
-> 单调时间连续状态机
-> Codex 模式：CGEvent 完整组合键按下与释放
-> 系统麦克风模式：Core Audio 默认输入设备静音/取消静音
FaceToTalk 只判断头部大致方向，不做眼球追踪，也不识别人脸身份。
- Facing 连续 1.0 秒：发送一次完整快捷键（key-down + key-up）。
- Away、无人脸或角度不足连续 3.0 秒：再次发送一次完整快捷键。
- 默认快捷键：
Ctrl+Shift+D。 - 默认快捷键语义：按一下切换。
- 初始语音状态为
unknown；请先确认 Codex Dictation 当前关闭，再点击“我已确认当前关闭 / 重新同步”。
如果目标快捷键要求按住开始、松开停止，请在设置中改用“按住说话”。
控制方式默认仍为“Codex 快捷键”。选择“系统麦克风”后采用默认关闭策略：启动时先禁用（静音），Facing 达到朝向延迟后才启用；Away、无人脸或角度不足达到关闭延迟后再次禁用，并且不发送任何快捷键。摄像头失败、中断、锁屏或睡眠时立即禁用。此模式影响所有使用系统默认输入设备的应用。
- macOS 13.3 或更高版本。
- 带有内建摄像头的 Mac。
- 摄像头权限。
- “隐私与安全性 -> 辅助功能”中的键盘事件权限。
- Codex / ChatGPT 中已配置对应的 Dictation 快捷键。
后两项只适用于“Codex 快捷键”模式。“系统麦克风”模式使用 Core Audio 输入设备能力，不需要辅助功能权限，但目标 macOS 13.3 机器仍需确认其内建麦克风支持软件静音。
- 使用 Xcode 打开
FaceToTalk.xcodeproj。 - 选择
FaceToTalkscheme。 - 构建并运行。
- 应用不会显示 Dock 图标；请从菜单栏打开。
命令行测试：
xcodebuild -project FaceToTalk.xcodeproj \
-scheme FaceToTalk \
-destination 'platform=macOS,arch=arm64' \
CODE_SIGNING_ALLOWED=NO \
test构建 Universal 2 Release：
xcodebuild -project FaceToTalk.xcodeproj \
-scheme FaceToTalk \
-configuration Release \
-destination 'generic/platform=macOS' \
ARCHS='arm64 x86_64' \
ONLY_ACTIVE_ARCH=NO \
build当前版本使用 Xcode 27 beta 验证。其他 Xcode 版本尚未逐一测试；如果全局 xcode-select 指向 Command Line Tools，请通过 DEVELOPER_DIR 显式选择完整 Xcode。
- 启动 FaceToTalk 并允许摄像头权限。
- 点击菜单中的“请求键盘权限”，在系统设置中允许 FaceToTalk 使用辅助功能。
- 在 Codex / ChatGPT 中设置相同的 Dictation 快捷键。
- 确认 Dictation 当前关闭。
- 点击“我已确认当前关闭 / 重新同步”。
- 保持 Codex / ChatGPT 在前台，直视屏幕后再转开进行测试。
若使用“系统麦克风”模式，只需在设置中选择该模式，然后分别点击“测试启用麦克风”和“测试禁用麦克风”；该模式不要求 Codex 位于前台。
建议把应用固定放在 /Applications/FaceToTalk.app。从不同 DerivedData 路径运行多个同名副本，可能产生多条难以区分的辅助功能授权记录。
- 朝向后打开：0.3-5.0 秒，默认 1.0 秒。
- 转开、角度不足或无人脸后关闭：0.5-10.0 秒，默认 3.0 秒。
- 允许正对左右：5-35°，默认 16°。
- 允许正对上下：5-30°，默认 14°。
- 判定转开左右：至少比正对大 2°，最高 50°，默认 24°。
- 判定转开上下：至少比正对大 2°，最高 45°，默认 21°。
- 快捷键必须至少包含一个修饰键。
Command+Space通常会与 Spotlight 冲突。- 更改快捷键、计时或快捷键语义会重置当前连续计时。
- “控制方式”可选择“Codex 快捷键”或“系统麦克风”，两者互斥。
角度调节说明：把“允许正对”调大，会更容易识别为正对；把“判定转开”调小，会更容易在转头后禁用。设置窗口会实时显示 yaw / pitch，修改后不需要重启应用。
- 捕获会话只添加
.video输入。 - 快捷键模式不改变系统麦克风状态。
- 系统麦克风模式只修改默认输入设备的静音属性；设备不支持时回退为输入音量 0，并在退出时恢复原值。
- 不创建音频采集会话、不读取音频样本、不录音，也不保存或上传声音。
- 不保存或上传照片、视频或人脸特征。
- 不包含网络请求或云端模型。
- 不做人脸身份识别。
- App entitlements 包含 App Sandbox、Camera 与可选系统麦克风模式所需的 Audio Input。
CGEvent.post没有 Codex 接收回执，因此界面显示的是推测状态，不是确定状态。- 用户手动操作 Codex Dictation 后，Toggle 状态可能失步，需要重新同步。
- 默认只控制前台的 Codex / ChatGPT。
- 当前只选择画面中面积最大的人脸。
- 最终 macOS 13.3 最小补丁仍建议在目标机器完成一次完整端到端确认。
- 强制结束进程或应用崩溃时，系统不会保证执行恢复逻辑；正常暂停、切换模式和菜单退出会恢复原状态。
- 部分外接、蓝牙或聚合输入设备可能不支持软件静音或输入音量控制。
- 预编译测试包使用本地临时签名，未做 Developer ID 公证。
MIT License。详见 LICENSE。