启用全局快捷键
开启后，即使 QuickVibeHost 不在前台，也可响应录音快捷键。关闭后不会影响 MicStick 的 A 键录音。
建议：只用设备时可关闭；同时使用键盘语音输入时保持开启。
通用
用于控制 App 的启动方式、语言、快速 LLM、历史和悬浮窗行为。它们不会改变 MicStick 的实体按键定义。
| 设置项 | 作用 | 何时开启 / 设置 | 注意事项 |
|---|---|---|---|
| 开机自启 | 登录 macOS 后自动启动 QuickVibeHost。 | 每天都会用 MicStick 时开启。 | 关闭后不会影响已安装的语音模型或设备配对，只是需手动打开 App。 |
| 界面语言 | 设定 App 和 MicStick 的显示语言；未选择时跟随 macOS。 | 需要固定界面语言时设置。 | 已连接设备的屏幕语言会跟随 App 下发，无需单独配置。 |
| 发送匿名使用统计 | 发送不含个人内容的匿名产品使用数据，用于改进产品。 | 愿意帮助改进产品时开启。 | 关闭不影响语音、设备连接或会话功能。 |
| AI 助手用量统计 | 在状态页显示 Claude Code、Codex 的会话与可用用量信息。 | 需要在设备或 App 中观察 AI 工作状态时开启。 | 关闭后会停止记录相关会话状态；不会卸载 Claude Code 或 Codex。 |
| 重新打开首次设置 | 下次打开 App 时重新显示辅助功能、设备、ASR、AI 增强四步向导。 | 更换新 Mac、重置配置或排查首次配置时使用。 | 它只重新显示向导，不会删除现有设备或模型。 |
| 悬浮窗输入方式 | 选择“自动输入”或“先行编辑”。 | 追求最快输入选自动输入；需检查、修改识别结果再发送时选先行编辑。 | 自动输入依赖辅助功能权限和当前焦点；直通会话走自己的输入通道。 |
| 悬浮窗字号 | 改变识别胶囊与编辑框的显示字号。 | 大屏、远距离观看或演示时调大。 | 只改变显示，不影响识别准确率或实际发送文字。 |
快速 LLM 配置
API Key、Base URL、Model 与超时设置供 Prompt 智能推荐、输入助理和识别校对共用。保存有效配置后会自动开启识别校对；Prompt 智能推荐与输入助理仍需在“高级功能”中主动开启。调用失败时，Prompt 推荐会退回本地规则排序，识别校对会保留原文。
快捷键
全局快捷键给没有连接 MicStick、或临时需要键盘触发录音时使用。
录音快捷键
App 会显示当前生效的快捷键。默认可用于自由输入，识别文字发送到当前光标位置。
前提：需要 macOS 辅助功能权限；没有权限时 App 会提示快捷键不可用。
未检测到系统麦克风
快捷键语音依赖 Mac 的可用输入设备。请在“系统设置 → 声音 → 输入”选择一个麦克风，再回到 App 重试。
语音
这是最影响识别速度、隐私和文本质量的设置区。先选择识别引擎，再按你的口述场景配置结果处理。
ASR 引擎：本地 Paraformer
离线运行，语音不离开本机。适合重视隐私、网络不稳定或日常编程口述。
- 下载基础模型后可进行整段离线识别。
- 可选下载本地流式模型包：按住说话时实时出字，松手后给出精确定稿。
- 需要 Apple Silicon Mac。
ASR 引擎：豆包云端
将音频和文本发送到豆包云服务处理。适合已具备云端凭据、需要云端流式能力的场景。
- 填写 App Key 与 Access Key。
- 点击“检测配置”后再开始使用。
- 密钥与识别历史保存在本机，但云端识别本身会向服务商传输音频 / 文本。
| 设置项 | 作用 | 推荐 | 注意事项 |
|---|---|---|---|
| 自动添加标点 | 自动补全识别文本中的标点。 | 写作、日常沟通建议开启。 | 逐字口述命令、代码片段或故意不加标点的内容可关闭。 |
| 定稿数字规范化 | 把“二零二六”“百分之五十”等口语数字转换为书面形式。 | 日期、金额、比例和参数口述较多时开启。 | 对某些需保留原始念法的文本可关闭。 |
| 识别增强 | 从你发送前对识别文本所做的修改中，学习常用专名和术语。 | 长期在同一项目、产品或术语体系中工作时开启。 | 可单独清空学习数据；清空不会删除识别历史。 |
| 识别校对 | 使用已配置的快速 LLM 修正错词与标点；失败时保留原文。 | 保存快速 LLM 配置后自动开启，也可以在这里关闭。 | 代码、命令或敏感内容应先评估是否允许发送到该 LLM。 |
| 自定义热词 | 为识别引擎提供常用名称、技术词和产品词。 | 每行一个，可填写项目名、API 名、同事名或专业术语；最多 20 条。 | 逗号会按换行处理。热词影响识别倾向，不保证完全强制匹配。 |
| 豆包语义顺滑 | 尝试去除口水词和重复。 | 日常自然表达可尝试开启。 | 命令、代码或精确口述可能误删真实词句，编程场景通常建议关闭。 |
| 豆包原生数字规范化 | 在云端识别阶段把口语数字转换为书面形式。 | 需要数字格式规范时开启。 | 与 App 的最终数字规范化共同使用时，应根据实际文本结果确认是否符合预期。 |
识别校对与数据传输
开启识别校对后，识别文本会发送到“通用 → 快速 LLM 配置”指定的服务。调用失败会保留原文；代码、命令或敏感内容应先确认是否适合发送。
权限
权限是功能开关之外的系统前置条件。App 内显示已启用，不代表 macOS 没有在升级或迁移后撤销授权。
辅助功能
允许 App 将识别文本输入当前光标位置、发送按键动作并响应全局快捷键。
路径：系统设置 → 隐私与安全性 → 辅助功能。
蓝牙
允许扫描和连接 MicStick。首次连接时按 macOS 弹窗授权；拒绝后需在系统设置中重新允许。
麦克风
当选择系统麦克风作为录音来源时需要。使用 MicStick 设备麦克风时，音频由设备经蓝牙发送。
高级功能
Prompt 智能推荐与输入助理均默认关闭；启用前必须在“通用”中完成快速 LLM 配置。它们是可选增强功能，不影响基础语音、会话和审批操作。
Prompt 智能推荐
开启后，双击 MicStick 的 B 键显示最多 8 条动态 Prompt；关闭时，双击 B 等于执行两次删除。
推荐会结合 Agent、任务阶段、Git 状态和模板适用范围排序；可管理内置或自定义模板。插入 Prompt 后不会自动发送，仍可检查和修改。
输入助理
开启后，双击 MicStick 的 C 键读取当前输入框，可选择已启用的技能进行改写；关闭时，双击 C 等于执行两次 Esc。
使用前应确认目标应用允许 App 读取 / 操作当前输入内容；遇到安全输入框或不兼容控件时，改用普通语音输入。
产品更新
该分类用于检查 QuickVibeHost 新版本并查看更新状态。设备固件更新仍在“设备”页完成。
检查 App 更新
App 会读取当前稳定版信息；出现兼容性提示或需要新设备能力时，先更新 QuickVibeHost。
安装下载的版本
下载与校验完成后，退出当前 App，将新 QuickVibeHost 拖入“应用程序”并重新打开。更新不会删除已保存的设备、模型或设置。
设备页中的 MicStick 偏好
以下项目不在“设置”标签中，但属于 MicStick 的可配置项；它们会下发到设备或影响设备与 Mac 的协作方式。
| 设置项 | 作用 | 使用建议 | 注意事项 |
|---|---|---|---|
| 设备显示语言 | 设置 MicStick 屏幕显示语言。 | 与 App 语言一致时易于操作；也可按设备使用者单独选择。 | 不改变 Mac App 的界面语言。 |
| 设备提示音 | 调整任务与审批提示的蜂鸣器音量，滑块每 20% 一档并会播放试听音。 | 安静环境调低；不希望声音时设为关闭。 | 开机、低电量、录音和识别结果本来就没有蜂鸣器提示。 |
| 指示灯亮度 | 调整状态灯与睡眠提示的亮度。 | 可选关闭、弱、标准或亮；夜间使用选“弱”，户外或明亮环境选“亮”。 | 关闭后仍可用屏幕判断状态，但会失去远距离灯效反馈。 |
| 麦克风选择 | 选择 A 键语音来源：设备麦克风或系统麦克风。 | 随身操作建议设备麦克风；固定桌面、高质量外接麦克风建议系统麦克风。 | 系统麦克风跟随 macOS 默认输入设备；蓝牙耳机类麦克风启动可能有 1–3 秒延迟，且限 16 kHz。 |
| 提示词模板 | 配置设备端 Prompt 选择可插入的常用指令。 | 把稳定、可复用的工作指令做成模板。 | 与“Prompt 智能推荐”能力相关；未启用时双击 B 会保持普通删除行为。 |
| 情景模式 | 将 B、C 和 D 的旋转手势映射为自定义、ChatGPT App 或音乐控制动作，并可绑定前台 App。 | 先在 App 中启用、编辑或导入模式；主页长按 D 会按当前前台 App 打开优先模式。 | 在模式内，单击 D 切换到下一模式，长按 D 退出。具体 B / C / 旋转动作以设备屏幕显示为准。 |
| 运输模式 | 请求 V14 在设备屏幕显示确认页，并在确认后断开电池。 | 运输或长期存放前使用。 | 必须拔掉 USB，并在设备上单击 B 最终确认；恢复时先长按侧面 SW1 或插入 USB。 |
| 固件更新 | 设备卡片连接后会自动检查更新，并可通过蓝牙 OTA 下载、传输和校验新固件。 | 出现“可更新至 …”时再更新。 | 传输期间不要断电或断开蓝牙；MicStick 会显示进度且按键暂不可用。失败时可使用 USB-C 在线刷机恢复。 |
WorkBuddy 支持与连接
完整 WorkBuddy 体验需要 QuickVibeHost 2.8.0 与 MicStick V14 1.2.3。App 检测本机 WorkBuddy，读取本地会话、活动和积分记录，区分执行与等待状态；积分不是实时账户余额或 Token 配额，也不使用官方云端 API。
先安装并打开 WorkBuddy，在 App 选择会话跳转后确认输入框焦点，再使用普通语音输入。WorkBuddy 不支持 vibepty 直通输入。
设备审批默认关闭。在 App 设置启用本地插件后，必须完全退出并重启 WorkBuddy。插件处理 Bash 的 PreToolUse 和 PermissionRequest；设备仅支持单次允许或拒绝，不支持本会话始终允许。断连、超时或不可用时回退原生审批，不会自动批准。
WorkBuddy 场景支持上一/下一任务、新任务、快速提问、切换成果面板和停止任务，依赖 WorkBuddy 快捷键及 macOS 辅助功能权限；旧设备按能力降级。Claude Code、Codex CLI 与 Codex Desktop 的既有输入方式保持各自差异。