Windows 桌面自动化脚本工具
| 🎮 Lua 脚本驱动 | 使用简洁的 Lua 语言编写自动化脚本，支持循环、条件、变量，上手简单 |
| 🖱️ 鼠标控制 | 移动、点击、按下/抬起、拖拽，支持左/中/右键 |
| ⌨️ 键盘控制 | 单键、组合键（Ctrl/Alt/Shift/Win+）、按下/抬起，覆盖所有常用按键 |
| 🎨 屏幕取色 | 拾取屏幕上任意坐标的颜色值，内置浮窗快捷记录坐标和屏幕取色 |
| 🔢 数字识别 | 支持识别屏幕指定矩形区域内的数字 |
| ⏺️ 操作录制 | 录制键盘和鼠标操作，自动生成可回放的 Lua 脚本 |
| ⚡ 全局快捷键 | 自定义快捷键一键运行/停止脚本、开始录制、打开取色器 |
| 📋 实时日志 | 清晰的日志面板，按时间戳、来源、级别显示 |
| 🔔 系统托盘 | 最小化到托盘，气泡通知运行状态，右键菜单快速操作 |
| 🎵 音效提示 | 脚本启动/停止时播放提示音，录制也有声音反馈 |
| 🌑 深色主题 | 简洁现代的深色 GUI，圆角无边框窗口 |
| 📦 无需安装 | 无需安装，解压即用 |
从 Releases 页面下载最新的 AutoFlow-v*-win-x64.zip，解压后双击 AutoFlow-v*-win-x64.exe 即可运行。
💡 程序第一次运行会在程序同级目录下自动创建
scripts/目录和演示脚本。
# 克隆仓库
git clone https://github.com/dss886/AutoFlow.git
cd AutoFlow
# 构建项目
dotnet build .\AutoFlow.sln
# 运行
dotnet run --project .\AutoFlow.App\AutoFlow.App.csproj本项目使用 MinVer 自动管理版本号，并生成便携版单文件发布包。
.\publish.ps1发布后会在 publish/ 目录下生成以下文件：
| 文件 | 用途 |
|---|---|
AutoFlow.exe |
可执行文件 |
AutoFlow-vx.y.z-win-x64.zip |
发布压缩包 |
推送一个 v 开头的 Git Tag 即可触发 GitHub Actions 自动构建和发布：
# 发布正式版
git tag v1.0.0
git push origin v1.0.0
# 或发布预发布版
git tag v1.0.0-beta.1
git push origin v1.0.0-beta.1CI 会自动完成：构建 → 压缩打包 → 上传到 GitHub Release。用户下载新版压缩包后手动替换即可完成更新。
在脚本文件开头使用注解声明名称和描述，将显示在脚本列表中：
-- @name: 我的自动化脚本
-- @description: 自动完成每日任务| API | 说明 |
|---|---|
host.log(message) |
输出信息到运行日志 |
host.sleep(ms) |
等待指定毫秒数 |
host.log("脚本开始执行")
host.sleep(500) -- 等待 500 毫秒
host.log("继续执行")| API | 说明 |
|---|---|
mouse.move(x, y) |
移动鼠标到屏幕坐标 (x, y) |
mouse.click(button) |
点击鼠标按钮："left" / "right" / "middle" |
mouse.down(button) |
按下鼠标按钮（不抬起） |
mouse.up(button) |
抬起鼠标按钮 |
-- 移动并点击
mouse.move(640, 360)
host.sleep(100)
mouse.click("left")
-- 拖拽操作
mouse.move(200, 300)
mouse.down("left")
for i = 1, 10 do
mouse.move(200 + i * 5, 300)
host.sleep(50)
end
mouse.up("left")| API | 说明 |
|---|---|
keyboard.press(keys) |
按下并释放按键，支持组合键（+ 连接） |
keyboard.down(key) |
按下按键（不释放） |
keyboard.up(key) |
释放按键 |
支持的按键名称：
| 类别 | 按键 |
|---|---|
| 字母/数字 | A ~ Z, 0 ~ 9 |
| 修饰键 | Ctrl, Alt, Shift, Win |
| 功能键 | F1 ~ F12 |
| 导航键 | Up, Down, Left, Right |
| 编辑键 | Enter, Esc, Del, Ins, Back, Tab, Space |
| 翻页键 | PgUp, PgDn, Home, End |
-- 单键
keyboard.press("Enter")
keyboard.press("Esc")
-- 组合键
keyboard.press("Ctrl+S")
keyboard.press("Ctrl+Shift+S")
keyboard.press("Alt+Tab")
keyboard.press("Win+R")
-- 按住修饰键后连续输入
keyboard.down("Shift")
host.sleep(100)
keyboard.press("H")
keyboard.press("E")
keyboard.press("L")
keyboard.press("L")
keyboard.press("O")
keyboard.up("Shift")| API | 说明 |
|---|---|
screen.get_color(points) |
批量获取多个坐标的颜色，points 为坐标数组，返回颜色数组 |
screen.read_number(x1, y1, x2, y2, options) |
识别矩形区域内的数字，坐标分别为左上角和右下角，识别失败时返回 nil |
local colors = screen.get_color({
{ x = 560, y = 320 },
{ x = 640, y = 360 },
{ x = 720, y = 400 }
})
for i = 1, #colors do
local color = colors[i]
host.log(string.format(
"采样点 %d 的颜色 = %s, RGB = (%d, %d, %d)",
i,
color.hex,
color.r,
color.g,
color.b))
end
local hp = screen.read_number(100, 50, 220, 90)
if hp ~= nil then
host.log("当前血量: " .. tostring(hp))
end批量模式下每个坐标支持两种写法：
{ x = 640, y = 360 }{ 640, 360 }
返回结果中的每一项都包含以下字段：
color.rcolor.gcolor.bcolor.hex
screen.read_number(...) 使用 Tesseract 在本地进行 OCR，适合读取游戏或桌面程序里的数字文本。
options 支持以下字段：
| 字段 | 类型 | 默认值 | 说明 |
|---|---|---|---|
lang |
string |
"eng" |
Tesseract 语言包名称；目前仅内置 eng，首次使用 OCR 时会在 AutoFlow.exe 同级自动创建 tessdata/eng.traineddata 和 bin目录 |
allow |
string |
整数模式为 "0123456789"，浮点模式为 "0123456789.," |
允许识别的字符白名单 |
scale |
number |
3 |
截图放大倍数，通常 2 到 4 对小字号数字更稳定 |
threshold |
number |
nil |
二值化阈值，推荐在数字与背景对比明显时使用，例如 160 到 200 |
invert |
boolean |
false |
是否先反色再识别，适合浅色背景上的深色数字 |
trim |
boolean |
true |
是否裁掉 OCR 结果首尾空白 |
mode |
string |
"integer" |
返回值解析模式，支持 "integer" / "float" |
max_candidates |
number |
3 |
最多尝试解析的候选数字个数 |
local stamina = screen.read_number(320, 120, 420, 156, {
scale = 4,
threshold = 180,
mode = "integer",
allow = "0123456789"
})
local ratio = screen.read_number(500, 120, 620, 156, {
scale = 4,
threshold = 170,
mode = "float",
allow = "0123456789.,"
})更多选项请参考 Tesseract 官方文档.
程序在运行时提供全局快捷键，可在系统任何位置触发：
| 快捷键 | 功能 | 可自定义 |
|---|---|---|
F10 |
运行选中的脚本 | ✅ |
F11 |
停止当前运行的脚本 | ✅ |
F12 |
开始/停止录制操作 | ✅ |
Ctrl+Alt+S |
打开/关闭屏幕取色器 | ✅ |
快捷键支持键盘按键和鼠标侧键（XButton1 / XButton2），可在应用设置中自定义。
打开取色器后，鼠标位置会出现一个叠加浮层，实时显示：
- 当前鼠标坐标
- 该坐标处的屏幕颜色色块
- 颜色值（支持 Hex / RGB 格式切换）
按下 R 键可以记录当前采样颜色，按下 Shift 键切换颜色格式。
录制功能会捕获键盘和鼠标操作，智能合并快速点击，自动处理修饰键组合，最后生成标准的 Lua 脚本文件。
- 按
F12（或点击录制按钮）开始录制，会有 3 秒倒计时和音效提示 - 执行你想要录制的操作
- 再次按
F12（或点击停止按钮）结束录制 - 录制的脚本会自动保存到
scripts/目录并通过托盘气泡通知
AutoFlow/
├── scripts/ # Lua 脚本目录（自动监控文件变化）
│ ├── demo.lua # 演示脚本：颜色采样与基础输入
│ └── demo2.lua # 演示脚本：按住与拖拽演示
├── AutoFlow.App/ # 主项目
│ ├── Assets/Icons/ # SVG 图标资源
│ ├── Assets/Sounds/ # WAV 音效资源
│ ├── Services/ # 核心服务层（DI 注册）
│ ├── ViewModels/ # MVVM ViewModel
│ ├── Views/Parts/ # 界面组件（脚本列表、日志、控制面板等）
│ ├── Infrastructure/ # 事件总线、RelayCommand
│ ├── Sessions/ # 录制会话
│ ├── Styles/ # WPF 样式
│ ├── Themes/ # 颜色主题
│ └── Models/ # 数据模型
├── AutoFlow.sln # 解决方案文件
├── publish.ps1 # 发布脚本
└── README.md
| 技术 | 用途 |
|---|---|
| .NET 8.0 | 运行时和框架 |
| WPF | 桌面 GUI 框架 |
| MoonSharp | Lua 5.2 解释器（纯 C# 实现） |
| SharpVectors | SVG 图标 WPF 渲染 |
| Microsoft.Extensions.DI | 依赖注入容器 |
| MVVM + EventBus | 应用架构模式 |
本地设置保存在 %LocalAppData%\AutoFlow\config.json：
除此之外不会在程序目录之外生成其他文件
{
"WindowLeft": 100,
"WindowTop": 100,
"WindowWidth": 800,
"WindowHeight": 600,
"RunHotkey": "F10",
"StopHotkey": "F11",
"RecordHotkey": "F12",
"ScreenToolHotkey": "Ctrl+Alt+S",
"ColorFormat": "Hex"
}- 自动化输入直接作用于系统前台，运行脚本前请确认目标窗口安全
- 若目标程序以管理员权限运行，本工具也需要以管理员权限运行，否则快捷键可能无法生效
- 部分游戏带有反作弊系统，可能会识别或拦截
SendInput模拟的输入，注意使用风险
本项目基于 GPLv3 License 开源。
Made with ❤️ by AutoFlow contributors