AutoHotkey v2 脚本自更新:改一次配置,公司几十台电脑上的脚本自动升级(含失败回滚)

启动检查版本 → 下载 → 校验哈希 → 批处理延迟替换 → 失败回滚。让几十台电脑上的 AHK 脚本自动升级,附完整代码与六个真实坑。

写 AHK 脚本的人迟早会撞上这个问题:脚本发到 30 台电脑上,改一个热键就得挨个跑一遍,或者发个压缩包让同事自己解压——然后总有人用的是旧版。

这篇讲怎么让脚本自己更新自己:启动时检查版本,有新版本就下载、校验、替换,失败还能回滚。整套逻辑不超过 60 行。

一、整体思路

脚本启动
  ↓
读取本地 version.txt
  ↓
请求服务器上的 latest.json(含版本号 + 下载地址 + 哈希)
  ↓
版本相同 → 直接运行
版本更新 → 下载新文件到临时目录 → 校验哈希 → 替换 → 重启

关键点:不能直接覆盖正在运行的脚本(文件被占用),必须用一个外部进程延迟替换。

二、服务器上放什么

一个静态 JSON 就行,放自己网站或对象存储:

{
  "version": "1.3.2",
  "url": "https://example.com/updates/tool-1.3.2.ahk",
  "sha256": "9f2c1a...",
  "notes": "修复了高 DPI 下坐标偏移"
}

三、客户端脚本

#Requires AutoHotkey v2.0
; ── 配置 ──
UPDATE_URL  := "https://example.com/updates/latest.json"
LOCAL_VER   := "1.3.0"
SELF        := A_ScriptFullPath

CheckUpdate()

CheckUpdate() {
    global UPDATE_URL, LOCAL_VER, SELF
    try {
        req := ComObject("WinHttp.WinHttpRequest.5.1")
        req.Open("GET", UPDATE_URL, false)
        req.SetTimeouts(3000, 3000, 5000, 5000)
        req.Send()
        if (req.Status != 200)
            return
        info := ParseJson(req.ResponseText)
    } catch {
        return   ; 网络不通就安静跳过,不要打扰用户
    }

    if !info.Has("version") || VerCompare(info["version"], LOCAL_VER) nul`r`n"
        . 'copy /y "' tmp '" "' SELF '"`r`n'
        . 'start "" "' SELF '"`r`n'
        . "del `"%~f0`"`r`n"
    FileAppend script, cmd, "UTF-8"
    Run cmd, , "Hide"
    ExitApp
}

GetSHA256(path) {
    ; 用 PowerShell 算哈希,避免自己实现
    cmd := 'powershell -NoProfile -Command "(Get-FileHash -Algorithm SHA256 -Path `"' path '`").Hash.ToLower()"'
    out := ""
    try {
        shell := ComObject("WScript.Shell")
        ex := shell.Exec(A_ComSpec ' /c ' cmd)
        out := Trim(ex.StdOut.ReadAll())
    }
    return out
}

; 极简 JSON 解析(只处理扁平对象)
ParseJson(s) {
    m := Map()
    RegExMatch(s, '"version"s*:s*"([^"]+)"', &v) ? m["version"] := v[1] : 0
    RegExMatch(s, '"url"s*:s*"([^"]+)"', &u) ? m["url"] := u[1] : 0
    RegExMatch(s, '"sha256"s*:s*"([^"]+)"', &h) ? m["sha256"] := h[1] : 0
    return m
}

四、为什么用批处理替换

Windows 会锁住正在运行的 .ahk 文件(尤其是被 AutoHotkey.exe 关联执行时),脚本自己删不掉自己。所以走这条路:

  1. 写一个 bat,先 ping 等 2 秒(给主进程退出的时间)
  2. 用 copy /y 覆盖旧文件
  3. start 重新拉起来
  4. bat 自己删掉自己

五、失败回滚

更新最怕”换上去跑不起来”。上线前留一份旧版:

; 替换前先备份
FileCopy SELF, SELF ".bak", 1

; 新版本启动时做健康检查:如果 30 秒内没写"启动成功"标记,就回滚
if FileExist(A_ScriptDir "boot_ok.flag")
    FileDelete A_ScriptDir "boot_ok.flag"
else if FileExist(SELF ".bak") {
    MsgBox "上次更新后启动失败,正在回滚"
    FileCopy SELF ".bak", SELF, 1
    ExitApp
}
SetTimer MarkAlive, -30000
MarkAlive() => FileAppend("ok", A_ScriptDir "boot_ok.flag")

六、踩过的坑

  • 文件被占用:一定要用外部进程替换,别指望脚本自己覆盖自己
  • 杀软拦截:bat 里 copy + start 容易被判为可疑行为,建议整个目录加白名单
  • 网络失败:更新检查必须 try/catch 且静默失败,否则断网时脚本直接不能用
  • 半截文件:必须校验哈希,WiFi 断了会下到 0 字节文件
  • 权限:装在 Program Files 下的脚本普通用户没写权限,更新会失败,装到 AppData 更省心
  • 多版本并存:更新后旧进程可能还活着,检查一下进程名再启动

七、再往前一步:加压授权码

自更新的下一步是”谁能用”。把 latest.json 换成带签名的接口,客户端带上用户授权码去换下载地址——没授权码拿不到新版本,这就是一套最朴素的商业授权机制。进一步的做法是把关键逻辑放服务端,客户端只做展示。


如果你正在把脚本发给同事或客户,这套机制能省掉 90% 的”帮我更新一下”。配套的脚本模板、异常处理、打包清单都整理在 AI 自动化工具包 里。

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

给TA捐赠
共{{data.count}}人
人已捐赠
AI 自动化教程

AutoHotkey v2 白嫖蚂蚁百灵 Ling-3.2-Flash:还在限时免费的 560B 原生多模态 Agent 模型,一个热键「截屏喂图问 AI」+ 让模型看着屏幕干活(完整可运行代码)

2026-11-15 21:15:29

AI 自动化

AutoHotkey v2 操控 Excel 的 8 个高频场景:批量读写、合并工作簿、筛选、自动出图、导 PDF

2026-11-16 0:54:36

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