Skip to content

USAGE_GUIDE.md

Latest commit

 

History

History
98 lines (72 loc) · 3.28 KB

USAGE_GUIDE.md

File metadata and controls

98 lines (72 loc) · 3.28 KB

HotMic 快速使用指南

三种录音模式

1. 切换模式（Toggle Mode）

  • 按键: Ctrl+U（Windows）或 Cmd+U（macOS）
  • 使用方法: 按一次开始录音，再按一次停止并获取识别结果
  • 适用场景: 长时间录音，或需要准备好再说话的情况

2. 按住说话模式（Hold-to-Talk Mode）⭐ 新功能

  • 按键: Win+Alt（Windows）或 Cmd+Alt（macOS）
  • 使用方法: 按住这两个键开始录音，松开立即停止并获取识别结果
  • 适用场景: 快速语音命令，类似对讲机的使用方式
  • 优势: 更直观，不会忘记停止录音

3. 鼠标按钮模式（Mouse Button Mode）⭐ 新功能

  • 按键: 鼠标滚轮按钮（中键）
  • 使用方法: 按住鼠标中键开始录音，松开立即停止并获取识别结果
  • 适用场景: 游戏、设计软件等手在鼠标上的场景
  • 优势: 单手操作，不需要键盘

视觉提示 ⭐ 新功能

录音时会在屏幕顶部中央显示红色的"🎤 Recording..."提示框，松开后自动消失。

配置说明

编辑 config.json 来启用/禁用这些功能：

{
  // 切换模式热键
  "hotkey": "<ctrl>+u",

  // 启用按住说话模式
  "enable_hold_mode": true,
  "hold_hotkey": "<cmd>+<alt>",

  // 启用鼠标按钮模式
  "enable_mouse_button": true,
  "mouse_button": "middle",  // 可选: left, middle, right

  // 显示录音提示
  "show_visual_indicator": true,

  // 自动粘贴识别结果
  "autopaste": true
}

常见问题

Q: 三种模式可以同时使用吗？

A: 可以！所有模式可以同时启用，你可以选择最方便的方式来录音。

Q: 如何只使用按住说话模式？

A: 保持 enable_hold_mode: true，其他模式不影响它的使用。

Q: 按住说话模式没反应？

A:

  1. 确保 enable_hold_mode 设为 true
  2. Windows 需要以管理员权限运行
  3. 检查快捷键是否被其他程序占用

Q: 鼠标中键录音没反应？

A:

  1. 确保 enable_mouse_button 设为 true
  2. Windows 需要以管理员权限运行
  3. 尝试更换为 "right" 或 "left" 按钮测试

Q: 如何自定义按住说话的快捷键？

A: 修改 hold_hotkey 的值，例如：

  • "<ctrl>+<shift>": Ctrl+Shift
  • "<alt>+r": Alt+R
  • "<cmd>+<ctrl>": Win+Ctrl（Windows）或 Cmd+Ctrl（macOS）

Q: 录音时的红色提示可以关闭吗？

A: 可以，将 show_visual_indicator 设为 false 即可。

Q: 识别结果在哪里？

A: 识别结果会自动复制到剪贴板，如果 autopaste 为 true，会自动粘贴到光标位置。

使用技巧

  1. 组合使用: 平时用切换模式录长段，需要快速输入时用按住说话模式
  2. 游戏玩家: 启用鼠标中键模式，游戏中快速发送语音命令
  3. 办公场景: 使用按住说话模式，类似使用对讲机，更自然
  4. 关闭视觉提示: 如果觉得提示框干扰，可以关闭 show_visual_indicator
  5. 只用鼠标: 禁用键盘热键，只使用鼠标按钮模式

快速开始

  1. 运行程序: scripts\run_hotmic.bat（Windows）或 python hotmic.py（macOS）
  2. 按住 Win+Alt（或 Cmd+Alt）开始说话
  3. 松开按键，等待识别完成
  4. 识别结果自动复制并粘贴！

享受你的语音输入体验！🎤