你写过几十个 AHK 脚本,每个都各自为政。热键脚本管热键,剪贴板工具管剪贴板,文件监控管文件——它们之间想传个数据,靠写文件轮询?靠剪贴板中转?
停。这些办法在 2026 年,属于 “能用但不体面”。
WebSocket,才是 AHK 脚本之间、以及 AHK 与外部服务之间实时通信的正确姿势。
01 为什么 WebSocket 是 AHK 通信的最后一块拼图
传统 AHK 进程间通信无非三条路:
| 方式 | 延迟 | 可靠性 | 双向? | 复杂度 |
|---|---|---|---|---|
| 剪贴板 | 秒级 | ❌ 易冲突 | ❌ | ⭐ |
| 读写文件 | 秒级 | ✅ | ❌ | ⭐⭐ |
| SendMessage/WM_COPYDATA | 毫秒级 | ✅ | ✅ | ⭐⭐⭐⭐ |
| TCP Socket | 毫秒级 | ✅ | ✅ | ⭐⭐⭐ |
绝大多数人用前两种——简单、粗暴、但脆弱。SendMessage 虽然快,但需要知道目标窗口句柄,跨脚本耦合太紧。
WebSocket 的定位很清晰:毫秒级延迟、全双工、松耦合、跨语言跨机器。
最关键的场景是——你的 AHK 脚本需要跟外部的实时数据源打交道:
- 📈 股票/期货实时行情:WebSocket 推送,而不是每秒 HTTP 轮询
- 🤖 LLM 流式对话:ChatGPT API 的 SSE/WebSocket 流式返回
- 🔌 浏览器扩展通信:通过 WebSocket 与浏览器插件双向交互
- 🏗️ 多个 AHK 脚本协作:一个主控脚本,多个 Worker 脚本,WebSocket 总线
一句话概括:如果你的 AHK 脚本需要 “被外部通知” 而不是 “主动去问”,WebSocket 就是答案。
02 AHK v2 实现 WebSocket 客户端的正确姿势
AHK v2 本身没有内置 WebSocket 对象,但我们可以利用 Windows 内置的 WinHttp 组件来升级 HTTP 连接为 WebSocket。
核心原理
CODE_BLOCK_0
WinHttp.WinHttpRequest.5.1 的 Open() + SetRequestHeader("Upgrade", "websocket") + Send() → 拿到 ResponseStream 后手动完成 WebSocket 握手,或者直接用底层 WinHttpWebSocket API。
但更优雅的方式——使用 .NET 的 System.Net.WebSockets.ClientWebSocket,通过 CLR 桥接:
这套实现的核心亮点:
1. 纯 CLI/COM 桥接,不依赖第三方 DLL
2. 异步非阻塞,接收循环用 AHK 定时器驱动,不影响主线程
3. 消息回调,类似 JavaScript 的 ws.onmessage
03 实战案例:实时行情推送监控器
光说理论没意思。我们来做一个实时黄金/外汇行情推送工具——从公共 WebSocket 数据源获取实时报价,当价格突破阈值时弹窗提醒。
; 实时黄金行情监控器 —— 使用 WebSocket 接收实时报价
; 数据源:wss://ws.coincap.io/prices?assets=bitcoin,ethereum
; 也可以换成任何支持 WebSocket 的行情接口
#Requires AutoHotkey v2.0
#SingleInstance Force
Persistent
; 当前价格缓存
class PriceCache {
static prices := Map()
static alerts := Map()
static Update(symbol, price) {
old := this.prices.Has(symbol) ? this.prices[symbol] : 0
this.prices[symbol] := price
; 检查阈值
if this.alerts.Has(symbol) {
threshold := this.alerts[symbol]
if (price >= threshold && old threshold) {
; 跌破下限(或阈值可以设为范围)
}
}
}
static SetAlert(symbol, price) {
this.alerts[symbol] := price
}
static _TriggerAlert(symbol, price, direction, threshold) {
; 发出提醒
msg := symbol " " direction "!" . "当前: $" price " (阈值: $" threshold ")"
TrayTip "价格提醒", msg
; 输出到 GUI
if AlertsGUI.HasProp("hWnd") {
ctrl := AlertsGUI.Add("Text",, Format("{1:T} | {2} | {3}", A_Hour ":" A_Min ":" A_Sec, symbol, msg))
AlertsGUI.Show()
}
}
}
; 创建价格显示 GUI
MainGUI := Gui("+Resize", "实时行情监控")
MainGUI.SetFont("s10", "Consolas")
MainGUI.Add("Text", "x10 y10 w400", "连接状态: 初始化中...").Name := "status"
MainGUI.Add("ListView", "x10 y40 w450 h300 Grid", ["时间", "币种", "价格"])
MainGUI["ListView"].OnEvent("DoubleClick", EditAlert)
MainGUI.Add("Text", "x10 y350", "双击行设置价格提醒阈值")
MainGUI.Add("Button", "x10 y380 w100", "清空提醒").OnEvent("Click", (*) => AlertsGUI.Destroy())
MainGUI.Show("w490 h450")
; 创建 WebSocket 连接
ws := WebSocketClient()
ws.OnMessage := PriceUpdateCallback
ws.Connect("wss://ws.coincap.io/prices?assets=bitcoin,ethereum,solana,ripple")
PriceUpdateCallback(msg) {
try {
data := JSON.Parse(msg) ; 需要 JSON.ahk 库
for symbol, price in data.OwnProps() {
priceNum := Number(price)
PriceCache.Update(symbol, priceNum)
; 更新 ListView
lv := MainGUI["ListView"]
lv.Add(, Format("{:02}:{:02}:{:02}", A_Hour, A_Min, A_Sec), symbol, "$" Round(priceNum, 2))
; 保持最新数据可见
if lv.GetCount() > 100
lv.Delete(1)
}
}
}
EditAlert(GuiCtrl, Row) {
lv := MainGUI["ListView"]
if Row && Row > 0 {
symbol := lv.GetText(Row, 2)
curPrice := lv.GetText(Row, 3)
ib := InputBox("输入 " symbol " 的提醒价格`n当前价格: " curPrice, "价格提醒设置")
if ib.Result = "Ok" {
threshold := Number(ib.Value)
if threshold > 0 {
PriceCache.SetAlert(symbol, threshold)
TrayTip "提醒已设置", symbol " 阈值: $" threshold
}
}
}
}
这个实战案例的价值在哪里?
不是教你怎么看行情——市面上有更好的行情软件。重点是演示了 WebSocket 在 AHK 中的完整工作流:
CODE_BLOCK_3
这套模式可以复制到任何实时数据场景:
– 飞书/钉钉消息通知推送
– 量化交易策略信号接收
– 服务器日志实时监控
– 家庭物联网传感器数据
04 为什么不推荐用 HTTP 轮询替代 WebSocket
很多新手会想:”我每 1 秒用 UrlDownloadToFile 请求一次接口,不也能拿到实时数据吗?”
来,算笔账:
CODE_BLOCK_4
差距不是倍数的,是数量级的。
更关键的是实时性——HTTP 轮询最多做到 “准实时”(平均延迟 = 间隔/2),WebSocket 是真正的 “事件驱动”,数据产生即推送。
我的观点很明确:写工具脚本可以不计较性能,但做生产级自动化,每一个 HTTP 请求都在消耗你的系统资源和服务端配额。
05 进阶:让 WebSocket 成为 AHK 脚本的通信总线
单客户端只是起点。真正的大招是——用 WebSocket 把多个 AHK 脚本连接成一个分布式系统。
架构图(文字版):
CODE_BLOCK_5
; Worker 脚本 —— 注册到 WebSocket 总线并接收指令
; 通过中央服务器接收 "clipboard:copy" 或 "hotkey:trigger" 等命令
#Requires AutoHotkey v2.0
#SingleInstance Force
Persistent
; 配置
SERVER_URL := "ws://localhost:8080/ahk-bus"
WORKER_ID := "clipboard-worker-" A_TickCount
; 连接 WebSocket 总线
bus := WebSocketClient()
bus.OnMessage := CommandHandler
bus.Connect(SERVER_URL)
; 注册自身
SendRegistration() {
bus.SendText(JSON.Stringify({
type: "register",
id: WORKER_ID,
capabilities: ["clipboard", "notification"],
version: "2.0"
}))
}
CommandHandler(rawMsg) {
try {
cmd := JSON.Parse(rawMsg)
switch cmd.type {
case "clipboard:set":
A_Clipboard := cmd.data
bus.SendText(JSON.Stringify({
type: "ack",
id: cmd.id,
result: "ok",
worker: WORKER_ID
}))
case "notification:show":
TrayTip cmd.title, cmd.message
bus.SendText(JSON.Stringify({
type: "ack",
id: cmd.id,
result: "shown"
}))
case "ping":
bus.SendText(JSON.Stringify({
type: "pong",
worker: WORKER_ID,
time: A_Now
}))
}
} catch e {
OutputDebug "命令解析失败: " e.Message
}
}
; 重连机制
Disconnected() {
SetTimer () => (
OutputDebug "断线重连..."
bus.Connect(SERVER_URL)
), -3000
}
bus.OnClose := Disconnected
; 延迟注册
SetTimer SendRegistration, -500
这套架构的好处:
- 解耦:主控脚本不关心 Worker 的具体实现,只管发命令
- 可扩展:随时加新 Worker,不改现有代码
- 跨语言:Worker 可以是 Python、Node.js、浏览器,只要走 WebSocket
- 热更新:Worker 重启后自动重连注册,无需重启主控
06 性能与注意事项
WebSocket 在 AHK v2 中的性能上限:
- 单连接吞吐:每秒约 500-1000 条消息(受 AHK 消息循环频率限制)
- 消息大小:建议单条不超过 64KB(AHK 字符串处理瓶颈)
- 并发连接数:建议不超过 10 个(每个连接有独立定时器接收循环)
踩坑记录:
-
CLR 加载失败:某些精简版 Windows 缺失 .NET 组件。备用方案是用
WinHttp.WinHttpRequest.5.1+ 原生 WebSocket API(复杂但无依赖) -
定时器积压:
SetTimer接收循环如果处理太慢,消息会堆积。解决方案是critical指令或使用消息队列 -
编码问题:.NET CLR 的字符串默认 UTF-16,发送前确保转 UTF-8(上面的实现已处理)
-
断线重连:生产环境必须实现指数退避重连,否则服务器重启时所有客户端同时重连会打满带宽
-
身份验证:生产环境 WebSocket 一定要加 Token 验证,否则谁都能连你的总线
脚本与脚本之间的通信,不应该比人与脚本的通信更原始。
WebSocket 让每个 AHK 脚本不再孤独地各自读取配置文件、轮询剪贴板、或者等待用户按下某个神奇的热键组合才能传递一个数据。
如果你的自动化体系超过 3 个脚本还在用文件传数据,是时候让它们 “对话” 了。
内容由AI生成

