当Hermes Agent自定义快捷键与系统或其他应用冲突时，应依次通过配置文件调整、环境变量覆盖、禁用系统级热键、前端UI动态重映射四种方式解决，确保快捷键正常触发。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当您在使用Hermes Agent过程中发现自定义快捷键与操作系统或其他应用的默认热键发生重叠，导致功能无法触发或行为异常时，问题根源通常在于快捷键注册逻辑未做冲突规避。以下是针对该问题的具体处理路径：
一、通过Hermes Agent配置文件调整快捷键
该方法直接修改本地运行时配置，无需重新编译或安装，适用于大多数用户场景，且变更即时生效（重启Agent后加载）。
1、定位配置文件路径：~/.hermes/config.yaml 或项目根目录下的 config.py（取决于安装方式）。
2、在配置文件中查找 hotkey 或 shortcut 相关字段，例如 toggle_ui: "Ctrl+Shift+H"。
3、将冲突键位替换为未被系统占用的组合，推荐使用 Ctrl+Alt+字母 或 Ctrl+Shift+数字 类组合。
4、保存文件后，完全退出Hermes Agent进程（包括后台服务），再重新启动。
二、使用环境变量临时覆盖快捷键设置
该方式适用于多用户共享环境或需快速验证键位兼容性的情形，不修改持久化配置，仅对当前终端会话生效。
1、在启动Hermes Agent前，执行环境变量注入命令：
2、Linux/macOS下运行：export HERMES_HOTKEY_TOGGLE_UI="Meta+Shift+U"。
3、Windows PowerShell下运行：$env:HERMES_HOTKEY_TOGGLE_UI="Ctrl+Win+T"。
4、随后执行 hermes start 或对应启动命令。
三、禁用系统级快捷键释放占用
某些操作系统（如Windows 10/11、macOS Sonoma+）预占了大量全局热键组合，例如 Cmd+Space、Win+V 等，必须先解除系统绑定才能被Hermes Agent捕获。
1、macOS：进入 系统设置 → 键盘 → 快捷键 → 各类服务，关闭与 Spotlight、输入法切换 冲突的选项。
2、Windows：打开 设置 → 蓝牙和其他设备 → Windows 键快捷方式，关闭 “按 Windows 键打开搜索” 及类似项。
3、GNOME/Linux：运行 gsettings list-recursively org.gnome.desktop.wm.keybindings，识别并重置 toggle-shaded、panel-main-menu 等可能干扰的键绑定。
四、通过前端UI动态重映射热键
若Hermes Agent已成功启动且Web UI可访问（默认 http://localhost:3000），部分版本支持运行时热键管理界面，允许图形化操作完成映射更新。
1、在浏览器中打开 http://localhost:3000/settings/hotkeys。
2、找到目标功能条目（如 “聚焦输入框”、“打开技能面板”）。
3、点击对应行右侧的 “编辑” 图标，按下新组合键，系统自动捕获并校验可用性。
4、点击 “保存并应用”，页面提示成功后刷新当前UI标签页。
