AutoHotkey v2 原生 WebSocket 通信:让脚本不再是一座孤岛

你写过几十个 AHK 脚本,每个都各自为政。热键脚本管热键,剪贴板工具管剪贴板,文件监控管文件——它们之间想传个数据,靠写文件轮询?靠剪贴板中转?...

你写过几十个 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 桥接:

隐藏内容,支付积分后阅读
已经有0人购买查看了此内容
15
15积分

这套实现的核心亮点:
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 个(每个连接有独立定时器接收循环)

踩坑记录:

  1. CLR 加载失败:某些精简版 Windows 缺失 .NET 组件。备用方案是用 WinHttp.WinHttpRequest.5.1 + 原生 WebSocket API(复杂但无依赖)

  2. 定时器积压:SetTimer 接收循环如果处理太慢,消息会堆积。解决方案是 critical 指令或使用消息队列

  3. 编码问题:.NET CLR 的字符串默认 UTF-16,发送前确保转 UTF-8(上面的实现已处理)

  4. 断线重连:生产环境必须实现指数退避重连,否则服务器重启时所有客户端同时重连会打满带宽

  5. 身份验证:生产环境 WebSocket 一定要加 Token 验证,否则谁都能连你的总线


脚本与脚本之间的通信,不应该比人与脚本的通信更原始。

WebSocket 让每个 AHK 脚本不再孤独地各自读取配置文件、轮询剪贴板、或者等待用户按下某个神奇的热键组合才能传递一个数据。

如果你的自动化体系超过 3 个脚本还在用文件传数据,是时候让它们 “对话” 了。

内容由AI生成

声明:本站所有文章,如无特殊说明或标注,均为本站原创发布。任何个人或组织,在未征得本站同意时,禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益,可联系我们进行处理。

给TA捐赠
共{{data.count}}人
人已捐赠
教程

AutoHotkey 生态大爆发:2026 年中全景图与技术趋势

2026-7-8 12:14:26

教程

AutoHotkey v2 COM 深度实战:用 IDispatch 操控整个 Windows 生态

2026-7-12 7:24:43

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
❯
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索