配置、个性化与多机使用
全局配置的基本规则
conf.toml 使用类 INI 格式：
ini
[def]
hide_console=1
src_dir=%a_ahkdir%\src
[gs]
diff=26[def]、[gs] 都必须存在。; 开头的整行是注释。值通常是裸文本，不按标准 TOML 转义路径或去除值的引号。key= 会被忽略，不能用它保存空字符串或删除已有配置。
很多开关按“键存在”或“非空”判断，写 0 仍可能开启；只有明确比较 1 的字段才支持用 0 表示未启用。关闭某个开关时，先查它的具体规则。
常见修改
| 需要 | 设置 |
|---|---|
| 显示启动控制台 | 删除或注释 hide_console=1 |
| 未定义手势提示 | [def] 中设置 undef_tip=1 |
| 命令放在其他目录 | src_dir=绝对路径，多个路径用 ` |
| 更换编辑器 | edit=程序完整路径 |
| 更换日志临时目录 | disk=有写入权限的目录 |
| 不使用 DLL 执行默认 AHK | no_dll=1 使用 Job；2 使用独立进程 |
不要盲目开启 interception、HID 或线程绑定。它们是后端和设备配置，不是普通手势生效的必需前提。
路径变量
主配置解析前会替换 %a_ahkdir% 为程序目录，替换 %a_dir% 为驱动器下第一层目录。例如程序位于 D:\Tools\Diatom，后者为 D:\Tools。
机器覆盖文件目前没有执行同样的变量替换，其中的路径需要写成实际路径。
每台机器的差异
主程序把计算机名转小写，将 - 改为 _，再去掉 desktop_，据此读取 pc_<名称>.toml。例如 DESKTOP-ABC 对应 pc_abc.toml。
ini
[def]
disk=E:\DiatomTemp机器文件按段和键覆盖主文件。空值不进入映射，因此 disk= 不会清除主文件的 disk。仅某台机器启用的“存在即开”选项，应直接放进那台机器的文件。
单个命令可使用 pc=[abc][laptop] 或 pc_bl=[office] 控制是否加载。这里比较的是带方括号的字符串，不是标准 TOML 数组。
同步与升级
同步命令、命名和样本时，也保留历史版本。机器专属路径尽量集中在机器文件。更换运行目录后重新检查绝对路径、启动快捷方式和库依赖。
新增配置先在本机保存、重启、验证，再同步到其他机器。