3D 打印机最常见的浪费不是耗材,是「切片完了忘了拷到机器上」。这篇用 AutoHotkey v2 把它彻底自动化:切片一完成,脚本自动上传、自动开打、打完自动拍照存档,全程不用点鼠标。
前提:你的打印机跑的是 Klipper(或任何提供 Moonraker 接口的机器,比如 Voron、Ender 改装、创想三维 K 系列)。Moonraker 就是一个本地 HTTP 服务,默认端口 7125——这意味着只要是能发 HTTP 请求的语言都能控制它,AHK 当然也可以。
一、先确认接口通不通
浏览器打开:
http://打印机IP:7125/printer/info
能看到 JSON(含 state、hostname)就说明通了。再试:
http://打印机IP:7125/printer/objects/query?print_stats
返回里有 print_stats.state,常见值:standby / printing / paused / complete / error。
二、脚本 1:盯着切片目录,新文件自动上传并开打
思路:每 5 秒扫一次切片输出目录,发现比上次新的 .gcode 就调用 curl 上传,再调 API 开打。Windows 10/11 自带 curl,不用装东西。
#Requires AutoHotkey v2.0
; ── 配置 ──
PRINTER := "192.168.1.50:7125"
SLICE_DIR := "D:Sliceroutput"
INI := A_ScriptDir "printer.ini"
; 记住已处理过的文件,避免重复开打
StateFile := A_ScriptDir "last_upload.txt"
SetTimer Watch, 5000
Watch() {
global PRINTER, SLICE_DIR, StateFile
if !DirExist(SLICE_DIR)
return
latest := ""
latestTime := 0
Loop Files, SLICE_DIR "*.gcode", "F"
{
t := FileGetTime(A_LoopFileFullPath, "M")
if (t > latestTime) {
latestTime := t
latest := A_LoopFileFullPath
}
}
if (latest = "")
return
done := FileExist(StateFile) ? Trim(FileRead(StateFile, "UTF-8")) : ""
if (latest = done)
return
Upload(latest) ? StartPrint(latest) : 0
FileDelete StateFile
FileAppend latest, StateFile, "UTF-8"
}
; 上传:Moonraker 用 multipart 表单接收
Upload(file) {
global PRINTER
; 注意:文件名含中文或空格时一定加引号
cmd := Format('curl.exe -s -F "file=@{}" "http://{}/server/files/upload"', file, PRINTER)
out := RunWait(cmd, , "Hide")
return (out = 0)
}
StartPrint(file) {
global PRINTER
SplitPath file, &name
url := Format("http://{}/printer/print/start?filename={}", PRINTER, name)
RunWait Format('curl.exe -s -X POST "{}"', url), , "Hide"
TrayTip "已开始打印", name, 2
}
关键点:
curl -F "file=@路径"里的路径必须加双引号,否则中文目录和空格会直接断掉- 用
last_upload.txt记录已处理的文件,重启脚本不会重复开打 - 上传大文件(>100MB)时 curl 会卡住界面,建议改成
Run异步 + 轮询返回码
三、脚本 2:打印完成自动拍照存档
打完不看一眼等于没验货。用 AHK 轮询状态,变成 complete 就触发拍照(手机摄像头 / USB 摄像头 / 网络摄像头都行,这里用 ffmpeg 抓一帧)。
#Requires AutoHotkey v2.0
PRINTER := "192.168.1.50:7125"
CAM_URL := "rtsp://admin:密码@192.168.1.60/stream1"
OUT_DIR := "D:PrintShots"
SetTimer CheckDone, 10000
wasPrinting := false
CheckDone() {
global PRINTER, wasPrinting
state := GetState()
if (state = "printing")
wasPrinting := true
if (wasPrinting && state = "complete") {
wasPrinting := false
Shoot()
TrayTip "打印完成", "已存档照片", 3
}
}
GetState() {
global PRINTER
req := ComObject("WinHttp.WinHttpRequest.5.1")
req.Open("GET", "http://" PRINTER "/printer/objects/query?print_stats", false)
req.Send()
; 不引 JSON 库,直接正则取
if RegExMatch(req.ResponseText, '"state"s*:s*"([^"]+)"', &m)
return m[1]
return ""
}
Shoot() {
global CAM_URL, OUT_DIR
if !DirExist(OUT_DIR)
DirCreate OUT_DIR
file := OUT_DIR "" FormatTime(, "yyyyMMdd_HHmmss") ".jpg"
RunWait Format('ffmpeg -y -rtsp_transport tcp -i "{}" -frames:v 1 "{}"', CAM_URL, file), , "Hide"
}
四、脚本 3:多台打印机一键盘点
如果你有两台以上,把 IP 写进 ini,一个热键弹窗列状态,比挨个开网页快得多。
#Requires AutoHotkey v2.0
^!p:: {
ips := [
"192.168.1.50:7125",
"192.168.1.51:7125"
]
out := ""
for ip in ips {
req := ComObject("WinHttp.WinHttpRequest.5.1")
try {
req.Open("GET", "http://" ip "/printer/objects/query?print_stats", false)
req.SetTimeouts(3000, 3000, 3000, 3000)
req.Send()
st := RegExMatch(req.ResponseText, '"state"s*:s*"([^"]+)"', &m) ? m[1] : "?"
out .= ip "`t" st "`n"
} catch {
out .= ip "`t离线`n"
}
}
MsgBox out, "打印机状态"
}
五、踩过的坑
- 文件名中文:Moonraker 接受中文,但 URL 里要 encode;最省事的做法是切片时就用英文名
- API key:如果 Moonraker 开了认证,所有请求要加头
-H "X-Api-Key: 你的key" - 超时:默认 WinHttp 超时很长,多机探测一定要
SetTimeouts,否则一台离线会卡住整个循环 - 开打前检查:
print_stats.state不是standby时强行 start 会被拒,脚本里应该先判断 - 托盘提示被忽略:TrayTip 在 Win11 可能被折叠,重要提醒建议用 MsgBox 或声音
六、下一步:让 AI 判断打印失败
上面拍的完成照片只是存档。真正有意思的是把它喂给视觉模型:
- 打印中途每 10 分钟拍一张
- 把照片和「应该长什么样」的参考图一起发给视觉模型
- 模型判断「拉丝/翘边/断层」→ AHK 自动暂停并通知
这套「摄像头 + 视觉模型 + AHK 控制」的组合,是桌面级 3D 打印最实用的自动化升级,成本只有一台旧手机。
本文的全部代码都可以直接跑。如果你想把「AI 判断失败」这一步也做出来,我把它连同AI 自动化工具包里的 6 个脚本一起整理好了,可去工具商店自取。

