AutoHotkey v2 监控文件夹:新文件一到就自动处理(含防抖、去重、失败重试)

用 AutoHotkey v2 监控文件夹变化:防抖判断文件写完没、去重避免重复处理、失败重试与日志,附三个实战场景。

有些流程天生是”事件驱动”的:文件一落地就要处理——下载完的报表要归档、收到的图纸要转格式、导出的大图要压缩。

这篇讲怎么用 AutoHotkey 稳稳地做这件事,重点在三个容易被忽略的细节:防抖、去重、失败重试。

一、为什么用轮询而不是系统通知

Windows 有 ReadDirectoryChangesW 这种系统级通知,但要 DllCall 一堆结构体,还容易漏事件(缓冲区溢出时)。

对”几十秒内处理就行”的场景,轮询更简单可靠:

#Requires AutoHotkey v2.0
#SingleInstance Force

WATCH_DIR := A_Desktop "待处理"
DONE_DIR  := A_Desktop "已处理"
INTERVAL  := 3000          ; 3 秒扫一次

DirCreate WATCH_DIR
DirCreate DONE_DIR

SetTimer(Scan, INTERVAL)

Scan() {
    global WATCH_DIR, DONE_DIR
    Loop Files, WATCH_DIR "*.*", "F"
    {
        path := A_LoopFileFullPath
        if !IsReady(path)
            continue                 ; 还在写入,下次再说
        if IsDone(path)
            continue                 ; 已经处理过
        Process(path)
    }
}

3000ms 对你来说是”立刻”,对 CPU 来说是几乎零成本(一次目录遍历而已)。

二、防抖:判断”文件写完了没有”

这是最容易翻车的地方。文件刚被创建时大小是 0,或者还在增长,这时候处理必然出错。

; 连续两次读到的大小一样,才认为写完了
IsReady(path, waitMs := 800) {
    try {
        s1 := FileGetSize(path)
        if (s1 = 0)
            return false          ; 空文件先跳过
        Sleep waitMs
        s2 := FileGetSize(path)
        return (s1 = s2)
    } catch {
        return false              ; 文件可能被占用/已删除
    }
}

更稳的写法:用独占方式尝试打开,打不开说明还被占用。

IsLocked(path) {
    try {
        f := FileOpen(path, "a")
        f.Close()
        return false
    } catch {
        return true
    }
}

三、去重:防止同一个文件被处理两次

轮询的天敌是”处理完但没移走”——下一次扫描又来了。两种解法:

解法 A:处理完移走(简单可靠)

Process(path) {
    global DONE_DIR
    SplitPath path, &name
    ; ...实际处理...
    FileMove path, DONE_DIR "" name, 1
    Log("处理完成:" name)
}

解法 B:记录已处理清单(需要原地保留文件时)

SEEN_FILE := A_AppData "AutoAHKwatcher_seen.txt"

IsDone(path) {
    global SEEN_FILE
    key := path "|" FileGetSize(path) "|" FileGetTime(path, "M")
    if !FileExist(SEEN_FILE)
        return false
    content := FileRead(SEEN_FILE, "UTF-8")
    return InStr(content, key) > 0
}

MarkDone(path) {
    global SEEN_FILE
    key := path "|" FileGetSize(path) "|" FileGetTime(path, "M")
    FileAppend key "`n", SEEN_FILE, "UTF-8"
}

用「路径+大小+修改时间」做键,同名但被改过的文件会重新处理。

四、失败重试:别让一次异常卡死整个流程

Process(path, retries := 3) {
    global DONE_DIR
    SplitPath path, &name
    Loop retries {
        try {
            DoWork(path)                    ; 你的实际处理逻辑
            FileMove path, DONE_DIR "" name, 1
            Log("[OK] " name)
            return true
        } catch as e {
            Log("[ERR] 第 " A_Index " 次:" name " → " e.Message)
            Sleep 1000 * A_Index            ; 递增等待
        }
    }
    ; 三次都失败,移到失败目录,别反复重试
    failDir := A_Desktop "处理失败"
    DirCreate failDir
    try FileMove path, failDir "" name, 1
    return false
}

关键:失败的文件必须移走,否则每 3 秒重试一次,日志会被刷爆。

五、日志:至少要能回答”这个文件处理了吗”

Log(msg) {
    static LOG := A_AppData "AutoAHKwatcher.log"
    DirCreate A_AppData "AutoAHK"
    FileAppend FormatTime(, "yyyy-MM-dd HH:mm:ss") "  " msg "`n", LOG, "UTF-8"
}

日志按行追加,出问题时可以看到完整的处理时间线。

六、三个实战场景

场景 1:下载文件夹自动归档

; 按扩展名分流
DoWork(path) {
    SplitPath path, &name, , &ext
    ext := StrLower(ext)
    target := (ext ~= "^(xls|xlsx|csv)$") ? "表格"
            : (ext ~= "^(jpg|png|webp)$") ? "图片"
            : (ext ~= "^(pdf|docx)$") ? "文档"
            : "其它"
    dest := A_Desktop "归档" target
    DirCreate dest
    FileMove path, dest "" name "." ext, 1
}

场景 2:大图自动压缩

DoWork(path) {
    SplitPath path, &name, &dir, &ext
    if !RegExMatch(StrLower(ext), "^(jpg|jpeg|png)$")
        throw Error("不是图片")
    ; 调用之前写过的 GDI+ 压缩函数(见「批量处理图片」那篇)
    ResizeImage(path, dir "out_" name "." ext, 1600, 82)
}

场景 3:收到图纸自动转 PDF 并上传

DoWork(path) {
    SplitPath path, &name, , &ext
    if (StrLower(ext) != "docx")
        throw Error("只处理 docx")
    ; Word 转 PDF(见「批量处理 Word」那篇)
    ; 上传到服务器(见「网络能力」那篇)
}

七、六个坑

  • 临时文件:Office 保存时会先写 ~$xxx.docx,要过滤掉以 ~$ 开头的文件
  • 大文件传输慢:防抖的 800ms 不够,改成”大小连续 3 次不变”更稳
  • 网络盘:SMB 共享上的文件状态可能滞后,判断要更保守
  • 文件被占用:用独占打开探测,别指望文件大小判断
  • 循环误触发:如果把处理结果写回监控目录,会无限循环——输出目录必须在监控范围外
  • 长时间运行:记得加 #SingleInstance Force,否则重复启动会有多个监控器抢同一个文件

八、什么时候不用轮询

  • 需要毫秒级响应 → 用 ReadDirectoryChangesW
  • 文件量极大(每秒几十个)→ 用专门的守护进程或 Python watchdog
  • 跨机器同步 → 用 Syncthing / rsync 触发

日常的”文件夹来了文件就处理”,轮询完全够用,而且好调试。


这套监控如果需要做成带界面的工具(显示处理队列、手动重试、暂停监控),AI 自动化工具包里有完整实现;企业侧要做无人值守的文件流水线,可以留个联系方式聊。

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

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

AutoHotkey + GDI+ 批量处理图片:压缩、改尺寸、加水印、批量转格式(零依赖)

2026-11-16 1:48:32

案例

语音数字-2.5-feiyue

2021-5-13 14:23:24

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