氛围控制器 VIBE CTRL 使用指南
让设备准备就绪。
适用于当前 0.1.0 / 构建 1。先完成桌面控制，再按需配置语音输入。
连接与授权
- 在 Apple 芯片 Mac（macOS 13+）上安装应用。
- 遥控器通过蓝牙配对；手柄通过蓝牙或 USB 连接。
- 按提示开启辅助功能；遥控器还可能需要输入监控与蓝牙权限。
确认设备状态后，先测试桌面控制。
遥控器默认操作
| 方向键 | 键盘方向键 |
|---|---|
| 确认键 | 回车 / Return |
| 返回键 | Esc |
| 主页键 | Home |
| TV 键 | 切换应用 / ⌘Tab |
| 音量键 | 系统音量 |
可在按键配置中改为滚动等操作，效果取决于前台应用。
按键与应用配置
点击「按键配置」或设备预览中的按键，设置鼠标、滚动与快捷键。
可使用通用配置、Codex 配置，或为其他应用添加专属配置。点击「保存配置」后生效；自动切换模式按前台应用选择配置。
Codex、Claude 与 Cursor
Codex 内置专用配置：可映射命令菜单（⌘K）、上/下一个对话（⌘⌥← / ⌘⌥→）和待关注对话（⌘⌥A）等动作。Codex 模式下，普通按键操作仅在 Codex 前台响应；「自动切换」按当前应用选择配置。
Claude、Cursor 目前使用通用方案，可在「按键配置」中添加对应 .app，为它们保存独立快捷键；尚未提供专用预设。
语音输入需先配置听写工具的快捷键与麦克风，点击目标输入框后按住说话、松开结束，文字不会自动发送。快捷键以目标应用的支持及设置为准。
遥控器语音
- 确认设备语音配置中的蓝牙关联。点击「测试收音」，按住语音键检查电平；测试不触发听写。
- 安装可选的「VIBE CTRL 麦克风」组件（需管理员授权），在听写工具中选择该麦克风，并匹配快捷键。
- 回到输入框，按住说话、松开结束。
听写文字不会自动发送。
设备兼容与切换
手柄的可用输入取决于 macOS 提供的能力。蓝牙遥控器仅适配部分硬件与固件，不代表所有型号兼容；购买前可联系确认。PlayStation 专门适配待支持。
一次只接管一台设备，更换时先断开当前设备，再连接目标设备；配置按设备保存。
手柄默认操作
| 左摇杆 | 移动指针 |
|---|---|
| 右摇杆 | 滚动 |
| A / B / X | 点击 / Esc / Tab |
| RT + A | 回车 |
| 长按 View 1 秒 | 暂停或恢复 |
玩游戏前先暂停桌面控制。快捷键效果取决于目标应用的设置。
手柄听写
LT 默认触发右 Command。将听写工具的语音快捷键设为同一按键，再选好工具使用的麦克风。
VIBE CTRL 不接收手柄音频，文字由听写工具生成。
有反馈，但没有操作或文字？
先检查暂停状态、辅助功能授权、当前模式和前台应用。
收音有电平但没有文字时，检查虚拟麦克风、听写工具的输入设备与快捷键，以及当前输入框。Dev 与正式版需分别授权；正式版运行期间 Dev 停止输入输出。
可选的 Codex 额度
设备控制无需安装 Codex。额度显示使用本机已登录的 Codex CLI，可以在「设置 → 通用」关闭，不影响手柄或遥控器控制。