AutoHotkey v2 的网络能力:HTTP 请求、下载大文件、解析 JSON、上传文件(完整封装)

用 WinHttp 封装 HTTP 请求、下载大文件、解析 JSON、上传文件,附重试退避与七个常见坑。

调 AI 接口、抓数据、同步文件、推送日志——这些都绕不开 HTTP。

AutoHotkey 没有内置网络库,但用 Windows 自带的 WinHttp 就够。这篇把它封装成能直接用的几个函数,并把常见的坑一次说完。

一、核心封装:一个函数搞定 GET / POST

#Requires AutoHotkey v2.0

; 返回 {status, body, headers},失败时 status=0
Http(url, method := "GET", body := "", headers := "", timeoutMs := 30000) {
    try {
        req := ComObject("WinHttp.WinHttpRequest.5.1")
        req.Open(method, url, false)
        req.SetTimeouts(5000, 5000, timeoutMs, timeoutMs)

        ; 默认头
        ; UA 很重要:很多接口会拒绝空的 User-Agent
        req.SetRequestHeader("User-Agent", "AutoAHK/1.0 (Windows)")
        if IsObject(headers) {
            for k, v in headers
                req.SetRequestHeader(k, v)
        }

        if (body != "")
            req.Send(body)
        else
            req.Send()

        return {status: req.Status, body: req.ResponseText, headers: req.GetAllResponseHeaders()}
    } catch as e {
        return {status: 0, body: "", err: e.Message}
    }
}

为什么用 false(同步):异步要处理事件回调,脚本里没必要,同步 + 设置超时更简单可控。

二、GET 一个 JSON 接口

r := Http("https://api.example.com/v1/status")
if (r.status != 200) {
    MsgBox "请求失败:" r.status " " r.body
    return
}
data := JsonParse(r.body)
MsgBox "返回条数:" data["count"]

三、POST JSON(调大模型最常见的写法)

payload := '{'
    . '"model":"deepseek-chat",'
    . '"messages":[{"role":"user","content":"你好"}]'
    . '}'

r := Http("https://api.deepseek.com/chat/completions", "POST", payload,
    Map("Content-Type", "application/json",
        "Authorization", "Bearer " API_KEY))

if (r.status != 200) {
    MsgBox "调用失败:" r.status "`n" SubStr(r.body, 1, 300)
    return
}
resp := JsonParse(r.body)
content := resp["choices"][1]["message"]["content"]

注意:中文要保证 UTF-8。如果接口返回乱码,检查 req.Option(2)(是否 UTF-8 转换)或手动转码。

四、下载大文件(带进度)

Download(url, savePath) {
    try {
        req := ComObject("WinHttp.WinHttpRequest.5.1")
        req.Open("GET", url, false)
        req.SetTimeouts(5000, 5000, 120000, 120000)
        ; 关键:以二进制流方式接收,避免文本转换损坏文件
        req.Send()

        if (req.Status != 200)
            return false

        stream := ComObject("ADODB.Stream")
        stream.Type := 1                      ; 1 = 二进制
        stream.Open()
        stream.Write(req.ResponseBody)        ; 注意某些版本是 ResponseStream
        stream.SaveToFile(savePath, 2)        ; 2 = 覆盖
        stream.Close()
        return true
    } catch as e {
        return false
    }
}

大文件的坑:WinHttp 会把整个响应读进内存,超过几百 MB 容易失败。真要大文件,建议调用 curl.exe(Windows 10 之后自带):

RunWait A_ComSpec ' /c curl.exe -L -o "' savePath '" "' url '"', , "Hide"

五、解析 JSON:三种选择

方案 A:用现成库(推荐)

社区有成熟的 JSON.ahk / cJson 库,直接 #Include 进来用,支持嵌套与数组。

方案 B:调 PowerShell(零依赖,最稳)

JsonParse(text) {
    tmpIn  := A_Temp "json_in.txt"
    tmpOut := A_Temp "json_out.txt"
    FileDelete tmpIn
    FileAppend text, tmpIn, "UTF-8"
    cmd := 'powershell -NoProfile -Command "'
        . '$j = Get-Content -Raw -Encoding UTF8 ''' tmpIn ''' | ConvertFrom-Json; '
        . '$j | ConvertTo-Json -Depth 20 -Compress | Set-Content -Encoding UTF8 ''' tmpOut '''"'
    RunWait A_ComSpec ' /c ' cmd, , "Hide"
    if !FileExist(tmpOut)
        return ""
    out := FileRead(tmpOut, "UTF-8")
    FileDelete tmpIn
    FileDelete tmpOut
    return out
}

输出仍是 JSON 文本,便于后续正则或再交给 PowerShell 处理。

方案 C:正则硬抠(只适合极简结构)

; 只取一个字段,快但脆
if RegExMatch(body, '"count"s*:s*(d+)', &m)
    count := m[1]

六、上传文件(multipart)

UploadFile(url, filePath, fieldName := "file", extra := "") {
    boundary := "----AutoAHK" Format("{:08X}", Random(0, 0xFFFFFFFF))
    f := FileOpen(filePath, "r")
    size := f.Length
    content := f.Read(size)
    f.Close()

    head := "--" boundary "`r`n"
        . 'Content-Disposition: form-data; name="' fieldName '"; filename="' A_LoopFileName '"`
        . "`r`nContent-Type: application/octet-stream`r`n`r`n"
    tail := "`r`n--" boundary "--`r`n"

    ; 拼二进制
    st := ComObject("ADODB.Stream")
    st.Type := 1
    st.Open()
    st.Write(ToUtf8Bytes(head))
    st.Write(content)
    st.Write(ToUtf8Bytes(tail))
    body := ReadAll(st)

    return Http(url, "POST", body, Map("Content-Type", "multipart/form-data; boundary=" boundary))
}

这个写法偏底层。**更省事的办法**:用 curl.exe -F,一行搞定。

RunWait A_ComSpec ' /c curl.exe -s -X POST -F "file=@' filePath '" ' url ' > "' A_Temp 'resp.json"', , "Hide"

七、七个坑

  • User-Agent 为空:很多 CDN / 接口直接 403,必须设
  • 中文乱码:请求体和响应都要确认 UTF-8;POST 时显式 Content-Type: application/json; charset=utf-8
  • 没设超时:默认可能很久,脚本会”假死”;一定 SetTimeouts
  • HTTPS 证书:WinHttp 走系统证书库,自签证书会失败;测试环境可临时忽略(生产别关)
  • 代理:公司网络走代理时,WinHttp 默认用系统代理;如要直连需显式设置
  • 大响应占内存:>100MB 改用 curl
  • 频率限制:接口 429 时别狂重试,加退避(见下)

八、带退避的重试

HttpRetry(url, method := "GET", body := "", headers := "", tries := 3) {
    delay := 1000
    loop tries {
        r := Http(url, method, body, headers)
        if (r.status >= 200 && r.status = 500) {
            Sleep delay
            delay *= 2                  ; 1s → 2s → 4s
            continue
        }
        return r                        ; 4xx 不重试
    }
    return r
}

九、一个实战:把脚本日志推到自己的服务器

; 每 5 分钟把新增日志 POST 上去
PushLog() {
    global LOG_FILE
    if !FileExist(LOG_FILE)
        return
    txt := FileRead(LOG_FILE, "UTF-8")
    if (StrLen(txt) < 10)
        return
    r := HttpRetry("https://你的域名/api/log", "POST",
        '{"host":"' A_ComputerName '","log":' JsonEscape(txt) '}',
        Map("Content-Type", "application/json"))
    if (r.status = 200)
        FileDelete LOG_FILE            ; 推成功再清
}

这样几十台机器上的脚本运行情况,就能在一个后台统一看。


这些封装(含 JSON 库、上传、重试、日志推送)都整理在 AI 自动化工具包里;企业侧要部署到多台机器,可以留个联系方式。

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

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

用 AutoHotkey + 大模型自动写周报:自动收集工作痕迹、AI 归并、一键成稿(附完整代码)

2026-11-16 1:39:28

AI 自动化

AutoHotkey v2 调试实战:脚本不生效、报错、静默失败,怎么在 10 分钟内定位

2026-11-16 1:47:57

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