Hexecute手势管理清单:--list、--remove与gestures.json文件完全指南

原创2026-11-01 20:52:131,831 阅读

Hexecute手势管理清单:--list、--remove与gestures.json文件完全指南

Hexecute 是一款运行在 Wayland 桌面上的手势启动器,你可以用鼠标在空中"画符文"来启动应用程序。这篇文章是面向新手的手势管理清单,完整覆盖 --list 查看手势列表、--remove 删除手势,以及 gestures.json 文件的存储位置与备份方法,照着操作即可完成日常手势管理。

Hexecute手势启动器演示:在屏幕上绘制手势来启动应用

30秒速览:手势管理命令清单

Hexecute 的全部管理操作都在终端完成,共 4 条命令(前 3 条与手势管理直接相关):

命令 功能 是否打开绘图窗口
hexecute --learn <命令> 学习新手势(画 3 次即可) ✅ 打开
hexecute --list 查看所有已注册的手势 ❌ 纯终端
hexecute --remove <命令名> 按命令名删除手势 ❌ 纯终端
hexecute 直接呼出手势绘图界面启动程序 ✅ 打开

💡 --list 和 --remove 不会弹出绘图窗口,读取数据后立即退出,参数定义见 cmd/hexecute/main.go。

用 --list 查看手势列表:一键掌握已注册手势

在终端执行:

hexecute --list

输出只有两种情况:

No gestures registered

或者:

Registered gestures:
  nautilus
  firefox
  kitty

📌 两个实用场景

  1. 学习后核对:--learn 保存成功后,用 --list 确认新命令是否真的写入了文件。
  2. 删除前查询:--remove 需要精确的命令名,先用 --list 查一下,避免拼写错误。

如果 gestures.json 文件不存在,--list 会安静地返回空列表而不是报错,逻辑在 internal/gesture/gesture.go。

用 --remove 删除手势:按命令名精准移除

hexecute --remove nautilus

成功时会打印 Removed gesture: nautilus,删除后文件会立即重写保存。

⚠️ 三个容易踩的坑

  • 传的是命令名,不是手势形状:参数是学习时用的那条启动命令(例如 nautilus),不是"Z 字形"这样的描述。
  • 名字必须完全一致:找不到对应条目时会报错 Gesture not found: xxx,此时回到 --list 检查拼写。
  • 删除不可撤销:命令执行后数据直接从 gestures.json 移除,建议删除前先备份文件(见下一节)。

实现细节(查找 + 移除 + 回写)位于 cmd/hexecute/main.go。

gestures.json 文件:手势数据存放在哪里

所有手势集中保存在一个文件里:

~/.config/hexecute/gestures.json

路径解析逻辑见 internal/config/config.go,目录不存在时会自动创建。文件结构是一个 JSON 数组,每个元素代表一个手势:

[
  {
    "command": "nautilus",
    "templates": [ [...], [...], [...] ]
  }
]
  • command:该手势绑定的启动命令,--list、--remove 都围绕它工作。
  • templates:学习时 3 次笔画经过归一化后的点序列,用于 $1 手势识别算法比对,字段定义见 internal/models/models.go。

gestures.json 能做什么:备份、迁移与共享

得益于"所有手势都在一个纯文本文件里"的设计,它支持 README 中提到的四种玩法(见 README.md 的 Managing Gestures 一节):

场景 操作
📦 备份 把文件拷到云盘或 U 盘,换机/重装前必备
🔄 恢复 把文件放回 ~/.config/hexecute/,手势立即生效
🤝 共享 发给朋友,两人拥有一模一样的手势集
🧪 实验 复制一份"沙盒"文件,大胆折腾后随时换回

⚠️ 不建议手改 templates 里的坐标数字——它们是经过等距重采样和缩放的归一化数据,手改极易导致识别失效。想换手势形状?直接重新 hexecute --learn <命令> 即可:同命令名的新手势会自动覆盖旧数据,逻辑见 internal/gesture/gesture.go。

常见问题排查清单

Q:画了手势却没启动程序? 识别得分需要超过 0.6 的置信阈值才会执行命令(internal/execute/execute.go)。先 --list 确认手势存在,再重新 --learn,尽量画得大一点、稳一点。

Q:--list 显示为空,但我明明学过手势? 检查 ~/.config/hexecute/gestures.json 是否被移动、删除或改坏了。文件缺失会按"空列表"处理。

Q:想重学一个手势,需要先 --remove 吗? 不需要。--learn 对同命令名直接覆盖,只有彻底不想要了才用 --remove。

Q:这些命令和日常呼出手势界面冲突吗? 不冲突。日常使用建议把手势窗口绑定到快捷键(如 SUPER + SPACE,配置示例见 README.md 的 Setting a Keybind 一节),而 --list / --remove 独立在终端运行,互不干扰。

总结

  • ✅ hexecute --list:查看已注册的全部手势,管理操作的起点
  • ✅ hexecute --remove <命令名>:按命令名精确删除,删除前记得查名
  • ✅ ~/.config/hexecute/gestures.json:唯一数据文件,可自由备份、迁移、共享
  • ✅ 重新 --learn 同命令即可覆盖旧手势,无需手动编辑模板数据

掌握这份清单,Hexecute 的手势管理就再无死角——画符、启动、维护,一条命令都不差 🪄

登录后查看全文
Hexecute