Hexecute手势管理清单:--list、--remove与gestures.json文件完全指南
Hexecute手势管理清单:--list、--remove与gestures.json文件完全指南
Hexecute 是一款运行在 Wayland 桌面上的手势启动器,你可以用鼠标在空中"画符文"来启动应用程序。这篇文章是面向新手的手势管理清单,完整覆盖 --list 查看手势列表、--remove 删除手势,以及 gestures.json 文件的存储位置与备份方法,照着操作即可完成日常手势管理。
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
📌 两个实用场景
- 学习后核对:
--learn保存成功后,用--list确认新命令是否真的写入了文件。 - 删除前查询:
--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 的手势管理就再无死角——画符、启动、维护,一条命令都不差 🪄
