十分钟上手：先使用现成命令

目标：不写脚本，先确认 Diatom 能工作，再打开一个程序，并知道如何退出。

第一步：准备体验命令

如果发行包已经提供下表快捷键，直接进行第二步。否则打开随本手册提供的 入门示例，把 src\starter_commands.toml 复制到 <Diatom>\src\user\，然后重启 Diatom。

示例依赖发行包中的热键宿主 def_hotkey。已有这份命令时保留原文件；全新运行目录的维护者可使用示例中的最小宿主。详细复制方法见示例说明。

复制后暂时不需要理解文件内容。

第二步：确认程序已工作

同时按 Ctrl+Alt+F8。看到“Diatom 已经可以执行命令”消息框，点击确定。

成功表示配置、命令加载、热键和 AHK 执行链路已经连通。没有反应时，先查看本章末尾，不急着修改手势。

第三步：体验打开程序

按 Ctrl+Alt+F9，应打开记事本。关闭记事本即可；这不会退出 Diatom。

这些热键由示例定义。如果与其他软件冲突，可在下一步学习修改 key=。

第四步：只改一句提示

用文本编辑器打开刚复制的 starter_commands.toml。找到：

MsgBox("Diatom 已经可以执行命令。", "Diatom")

只把引号中的提示改成“我的第一个命令”。保留引号、括号和文件其他部分，保存后重新运行 diatom.exe，再按 Ctrl+Alt+F8。

现在你已经完成一次配置修改。以后修改命令名、热键、属性或列表中的正文，也先按“保存 → 重启 → 重复同一动作”的顺序验证。

第五步：再尝试鼠标手势

先读 手势与触发，确认发行包使用哪个键。画一个简单的向右动作，查看记录中的实际触发名，再把它作为 starter_notepad 的别名。

不用重新编写打开记事本的代码，也不用先掌握窗口匹配。

没有反应时

1. 确认运行的是完整发行目录里的 diatom.exe。
2. 确认文件名是 starter_commands.toml，不是 .toml.txt。
3. 确认文件位于实际 src_dir 下，保存后已重启。
4. 如果所有体验热键都无效，检查发行包是否包含并启动 def_hotkey；已有其他热键可用时，再查按键冲突。
5. 保留错误窗口的完整内容，按 故障排查 继续。

练习结束后可用 Ctrl+Alt+F12 退出，再双击 exe 启动一次，确认自己掌握了恢复路径。