入门命令示例
Diatom/用户手册/入门命令示例

入门体验命令

这套示例用于配套的 Windows x64 完整 Diatom 发行包。它提供现成热键,按 十分钟上手 先体验,再改一句提示,最后为原有命令绑定手势。

示例不是独立运行包:还需要 diatom.exe、配套 AHK_Z、conf\base、conf\dll、conf\default 和 lib。普通 AutoHotkey v2 不能直接代替项目的配套版本。

已有运行目录:只复制一个文件

  1. 找到 diatom.exe 所在的发行目录,以下称 <Diatom>。
  2. 确认 <Diatom>\src\user 目录存在,没有就新建。
  3. 把 src/starter_commands.toml 复制到这个目录。保持 .toml 扩展名,使用 UTF-8 保存。
  4. 重新运行 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,并在发行说明写明已内置。

用户手册

正在读取手册…