AHK 命令的三种常用写法

下面的条目可放进 <Diatom>\src\user\my_commands.toml。一条命令至少有一个名称和一个动作；它只有绑定手势、快捷键或被其他命令调用后才会运行。

1. 函数正文：多数短命令从这里开始

[open_notepad]
type=f
key=^!F9
code='''
Run("notepad.exe")
'''

type=f 把 code 当作函数正文，并提供名为 this 的上下文。一般不需要自己再包一层函数。

key=^!F9 表示 Ctrl+Alt+F9。与入门示例重复时，先移除旧绑定，再重启。

2. 调用一个函数

[open_notepad_by_function]
type=c
fn=Run
ps=notepad.exe

fn 是函数名，ps 默认作为一个字符串参数传入。字符串里的逗号不会自动拆成多个参数。

省略 type 时，有 fn 通常会推断为 c。也可写 fn=Run notepad.exe，加载器把第一个空白前作为函数名，其后作为参数。刚开始使用时分行更容易阅读。

3. 独立脚本：适合调试完整脚本

新建 debug_notepad.ahk：

;? type=e,read=1

Run("notepad.exe")
ExitApp()

文件名就是命令名 debug_notepad。需要调用时，为它添加 key 或 alias，修改头部后重启。

type=e 每次建立独立的 AHK 进程；read=1 在执行时重读文件，适合独立线程调试。完整脚本用 A_Args 取得调用数据；它没有自动提供的 this 参数。

需要记住的语法

• AHK 赋值写 :=，调用写 Run("notepad.exe")。
• 普通路径写一个反斜杠，如 "D:\Tools\App.exe"。
• AHK 的转义字符是反引号；换行写 `n。
• ''' 是命令列表包住正文的标记，不要把它复制到 .ahk 文件里。
• 使用配套 AHK_Z／AutoHotkey_H 2.1。不要给 Diatom 命令机械添加独立脚本的 #Requires 或 #SingleInstance 模板。

f、c 可以复用执行器；它们的全局变量可能保留。要理解 j、e 与复用的关系，再读 执行模式。