入门体验命令
这套示例用于配套的 Windows x64 完整 Diatom 发行包。它提供现成热键,按 十分钟上手 先体验,再改一句提示,最后为原有命令绑定手势。
示例不是独立运行包:还需要 diatom.exe、配套 AHK_Z、conf\base、conf\dll、conf\default 和 lib。普通 AutoHotkey v2 不能直接代替项目的配套版本。
已有运行目录:只复制一个文件
- 找到 diatom.exe 所在的发行目录,以下称
<Diatom>。 - 确认
<Diatom>\src\user目录存在,没有就新建。 - 把 src/starter_commands.toml 复制到这个目录。保持
.toml扩展名,使用 UTF-8 保存。 - 重新运行 diatom.exe,按 Ctrl+Alt+F8,看到消息框即成功。
如果发行包的 src_dir 使用其他目录,复制到那个目录内的 user 子目录。已经存在同名示例时比较内容后合并,避免丢失自己的修改。
命令的 key 由 def_hotkey 宿主注册。已有可用热键时保留原宿主;全部示例热键无效时按 故障排查 检查宿主和加载错误。
五个现成功能
| 按键 | 结果 |
|---|---|
| Ctrl+Alt+F8 | 显示“Diatom 已经可以执行命令。” |
| Ctrl+Alt+F9 | 打开记事本 |
| Ctrl+Alt+F10 | 显示运行目录 |
| Ctrl+Alt+F11 | 导出并打开触发记录 |
| Ctrl+Alt+F12 | 退出 Diatom |
不用先理解脚本。先把前四个按一遍,最后按 F12 组合退出,再双击启动。
第一次修改
打开复制后的 starter_commands.toml,只改 starter_ready 正文里引号中的消息文字,保存并重新运行 diatom.exe,再按 Ctrl+Alt+F8。
修改热键时,仅改相应 key=:^ 表示 Ctrl,! 表示 Alt。例如 key=^!F8。每次只改一个地方,重启后按同一热键验证。
示例不默认占用任何鼠标手势。要练习手势,按 手势与触发 为 starter_notepad 增加 alias。先用实际触发记录确认名称,不直接覆盖已有全局命令。
维护者组装新包
src/def_hotkey.ahk 是最小热键宿主,仅用于没有现成 def_hotkey 的新包,不要覆盖用户宿主。它用旧式 ;? dog=1 属性头自动启动,注册后的热键附在 return 后。
conf.toml 是干净主配置起点,仅供组装新发行目录;不要覆盖已有用户配置。它使用 no_dll=1 将 AHK 调到 Job 后端,仍需配套 AutoHotkey.exe 和 thread.dll 等基础资源。也仍需准备项目当前依赖的默认配置、命名、样本及脚本库。
维护者把本目录中的 src 内容复制到新运行包的 src\user,确认仅有一个 def_hotkey,并逐一验收五个热键。交付用户时随包保留 examples/starter 与 docs 的相对位置,或把示例直接装入 src\user,并在发行说明写明已内置。