Skip to content

SHORTCUTS_GUIDE.md

Latest commit

 

History

History
215 lines (164 loc) · 5.37 KB

SHORTCUTS_GUIDE.md

File metadata and controls

215 lines (164 loc) · 5.37 KB

创建快捷方式和快捷键指南

本指南介绍如何为HotMic创建桌面快捷方式、开始菜单项和全局快捷键。

方法一：自动创建快捷方式（推荐）

Windows用户

  1. 双击运行 create_shortcuts.bat

这将自动创建：

  • ✓ 桌面快捷方式：HotMic.lnk（显示窗口版本）
  • ✓ 桌面快捷方式：HotMic (后台).lnk（后台运行版本）
  • ✓ 开始菜单快捷方式

macOS用户

可以使用Automator创建应用程序：

  1. 打开Automator
  2. 选择"应用程序"
  3. 添加"运行Shell脚本"
  4. 输入以下内容：
cd "$(dirname "$0")"
source .venv/bin/activate
python hotmic.py
  1. 保存为"HotMic.app"
  2. 拖到应用程序文件夹或Dock

方法二：设置全局快捷键启动HotMic

Windows方法

  1. 右键点击桌面上的HotMic快捷方式
  2. 选择"属性"
  3. 在"快捷键"栏中，按下你想要的组合键，例如：
    • Ctrl + Alt + H
    • Ctrl + Shift + H
    • Win + H（推荐）
  4. 点击"确定"保存

现在你可以使用这个快捷键在任何地方启动HotMic！

macOS方法

  1. 打开"系统偏好设置" → "键盘" → "快捷键"
  2. 选择左侧的"App快捷键"
  3. 点击"+"添加新快捷键
  4. 选择HotMic应用
  5. 设置快捷键（如 ⌘+⇧+H）

方法三：添加到开机自启动

Windows自启动

有两种方式：

方式1：使用启动文件夹（简单）

  1. 按 Win + R 打开运行对话框
  2. 输入 shell:startup 回车
  3. 将桌面的"HotMic (后台).lnk"复制到这个文件夹
  4. 重启电脑，HotMic将自动在后台启动

方式2：使用任务计划程序（高级）

运行项目中的：

scripts\install_autostart.ps1

macOS自启动

使用项目中的脚本：

scripts/install_launchagent.sh

方法四：固定到任务栏（Windows）

  1. 找到桌面上的HotMic快捷方式
  2. 右键点击 → 选择"固定到任务栏"
  3. 现在可以从任务栏快速启动HotMic

可选：设置任务栏快捷键

  • 固定到任务栏后，按 Win + 数字 启动
  • 例如：如果HotMic在任务栏第3个位置，按 Win + 3 启动

快捷方式类型说明

项目创建了两种启动方式：

1. HotMic.lnk（显示窗口）

  • 特点：显示命令行窗口
  • 优点：可以看到日志输出，方便调试
  • 缺点：窗口可能碍眼
  • 适合：首次使用、测试、调试

2. HotMic (后台).lnk（后台运行）

  • 特点：完全后台运行，不显示窗口
  • 优点：干净整洁，不占用屏幕空间
  • 缺点：看不到日志输出
  • 适合：日常使用、开机自启
  • 关闭方法：打开任务管理器，结束python进程

推荐配置

日常使用配置

✓ 快捷方式：HotMic (后台).lnk
✓ 启动方式：开机自启动
✓ 快捷键：Win + H（启动/重启程序）
✓ 录音热键：已在config.json中配置

开发/调试配置

✓ 快捷方式：HotMic.lnk
✓ 启动方式：手动启动
✓ 查看日志：命令行窗口

故障排除

问题1：双击快捷方式没反应

解决方法：

  1. 右键快捷方式 → 属性
  2. 检查"目标"和"起始位置"路径是否正确
  3. 重新运行 create_shortcuts.bat

问题2：后台版本启动后找不到进程

检查方法：

  1. 打开任务管理器（Ctrl + Shift + Esc）
  2. 切换到"详细信息"标签
  3. 查找"python.exe"或"pythonw.exe"

关闭方法：

  1. 在任务管理器中找到python进程
  2. 右键 → 结束任务

问题3：快捷键冲突

解决方法：

  1. 尝试使用不同的组合键
  2. 避免使用系统保留的快捷键
  3. 推荐使用 Ctrl + Alt + 字母 组合

问题4：开机自启动失败

解决方法：

  1. 检查启动文件夹中的快捷方式
  2. 确保使用"后台版本"快捷方式
  3. 检查Python路径是否正确

高级技巧

1. 创建多个配置

可以创建不同配置的快捷方式：

# 工作配置
python hotmic.py --config config_work.json

# 家庭配置
python hotmic.py --config config_home.json

2. 使用系统托盘

虽然HotMic没有内置托盘图标，但可以：

  • 使用后台运行版本
  • 通过任务管理器管理

3. 快速重启

创建一个"重启HotMic"脚本：

@echo off
taskkill /F /IM python.exe /FI "WINDOWTITLE eq hotmic*"
timeout /t 1
start "" "HotMic (后台).lnk"

使用建议

  1. 首次使用：

    • 使用显示窗口版本
    • 测试所有功能是否正常
    • 查看麦克风测试结果

  2. 日常使用：

    • 切换到后台运行版本
    • 设置开机自启动
    • 配置全局启动快捷键

  3. 遇到问题时：

    • 切换回显示窗口版本
    • 查看日志输出
    • 检查错误信息

快捷键总结

系统快捷键（启动程序）

  • 推荐：Win + H - 启动HotMic程序
  • 备选：Ctrl + Alt + H - 启动HotMic程序

应用内快捷键（在config.json中配置）

  • Toggle模式：Ctrl + U - 切换录音
  • Hold模式：Win + Alt - 按住录音
  • 鼠标按钮：中键 - 按住录音

总结

创建快捷方式后，你可以：

  • ✓ 从桌面快速启动
  • ✓ 从开始菜单搜索启动
  • ✓ 从任务栏一键启动
  • ✓ 使用全局快捷键启动
  • ✓ 开机自动启动

推荐组合：开机自启动 + 后台运行 + 全局快捷键（Win+H）