千机图灵 · 新手图文教程

从解压安装到打包发客户 · 零基础也能照着做
▶ 视频教程
← → 翻页
千机图灵
新手图文教程 · 2026-11 版 · 共 12 章

这份教程假设你完全不会编程、没听过 Lua。
每一页只讲一件事,代码可以直接抄,抄完点「运行」就能在手机上看到效果。

① 解压安装
→
② 连上手机
→
③ 抄第一个脚本
→
④ 打包发客户

▶ 看视频版教程(B站 · 跟着做更快)

看的时候按键盘 ← → 翻页;上面那排是章节,点一下直接跳过去。

目录

教程分为 12 章,按顺序看最省劲

标「必看」的是新手一定要会的;标「以后再看」的等你能跑通再说。

给完全没基础的人一句话
你不需要「学会编程」才能用。先照着抄、跑通、看到效果,再回头理解为什么 —— 这是最快的学习方式。
第 1 章

1.1安装:先在 D 盘建个「千机图灵」文件夹

收到的是 千机图灵.zip。安装就三步,照着做:

① D 盘新建文件夹「千机图灵」
→
② 把 zip 里的东西全放进去
→
③ 双击「打开千机图灵.vbs」

① 建文件夹

打开「此电脑」→ 双击 D 盘 → 空白处右键 → 新建 → 文件夹 → 名字打 千机图灵。 最后就是 D:\千机图灵 这个目录。

② 把压缩包里的东西放进去

放进去的是压缩包"里面"的东西
应该是 打开千机图灵.vbs、pc、Java、手机端 这些文件本身,而不是那个 .zip 压缩包。
✗ 三种会出事的放法
① 直接在压缩软件窗口里双击 打开千机图灵.vbs —— 关掉窗口就全没了,配置也存不住;
② 放在 C:\Program Files —— 系统盘没写权限,程序存不了配置;
③ 放在 桌面 / 下载文件夹 —— 容易被清理软件删,路径也经常变。
D:\千机图灵\ 里应该是这样
D:\千机图灵\ ├─ 打开千机图灵.vbs ← 双击这个启动 ├─ 创建桌面快捷方式.vbs ← 想生成桌面图标点这个 ├─ 使用说明.txt ├─ pc\ ← 程序本体 ├─ Java\ ← 自带的运行环境,别删! ├─ tools\ ← adb(连手机用) ├─ 手机端\ ← 千机图灵.apk(装到手机上) ├─ android\ ← 打包出来的 APK 存这里(AI 文件夹) └─ 千机图灵\ ← 你以后的项目都放这里
第 1 章

1.2启动,顺手生成桌面快捷方式

进到 D:\千机图灵 里,双击 打开千机图灵.vbs。第一次启动会慢几秒,别连点好几下。

想要桌面图标?双击「创建桌面快捷方式.vbs」
运行一次,桌面就会出现「千机图灵」图标,以后直接点图标启动,不用每次进 D 盘找。
它只是个快捷方式,指向的还是 D:\千机图灵 —— 所以这个文件夹别改名、别挪地方,不然图标会失效。
双击没反应怎么办
  • 先看 Java 文件夹还在不在 —— 被 360 / 火绒 / Defender 隔离掉就打不开,恢复它并加白名单。
  • 确认路径是 D:\千机图灵 这种干净的路径(别放桌面、别放很深的层级、别带奇怪符号)。
  • 还不行就截图问客服,别自己删文件试。

认一下界面

主界面(示意图)
工程面板
脚本
资源
界面
插件
代码编辑区(中间这块)
左边写脚本,右边看函数说明
日志面板(运行结果、报错都在这)
右上角工具栏
新建
打开
连接
运行
打包

不要求一次记住,下面用到哪个再回来看。

第 1 章

1.3把手机端装到手机上

电脑上写脚本、手机上跑脚本。所以手机要先装好 手机端\千机图灵.apk。

① 手机开「USB 调试」
→
② 数据线连电脑
→
③ 把 APK 拷到手机装
→
④ 打开 App 给权限

手机怎么开 USB 调试

用模拟器也一样
雷电 / MuMu / 夜神这些模拟器,一般自带 adb,装好 APK 就能连。模拟器里也要在「设置 → 开发者选项」确认 USB 调试是开的。
APK 怎么装到手机
最省事:手机连电脑后,把 手机端\千机图灵.apk 复制到手机存储里,用手机文件管理器点开安装;或者直接在电脑上用 adb 装。
第 1 章

1.4电脑连上手机(关键一步)

点工具栏的 「连接」,弹出这个框:

连接设备
127.0.0.1
37271
开始搜索连接设备
方式一:点「开始搜索」(推荐)
会自动列出用数据线连着的手机、以及开着的模拟器 → 选中 → 点「连接设备」。
这条依赖 adb,模拟器一般自带;真机需要数据线 + 驱动。
方式二:直接填地址
地址和端口默认 127.0.0.1 / 37271,点「连接设备」。
云手机 / 别人帮你开了反向调试时,把对方给的 IP 和端口填这里。
连不上先查这 3 条
① 手机上 App 有没有真的打开(有些机型要手动点一次 App 才算启动);
② 数据线是不是只能充电的「劣质线」;
③ 电脑上别的软件(另一个模拟器、其他助手)抢占了 adb → 把它们关掉再试。
第 1 章

1.530 秒验证:你的第一个脚本

先随便建一个项目(点「新建」→ 名字随便填 → 创建,下一章细讲),把中间编辑区的内容全选删掉,敲这一行:

main.lua复制
print("你好,我是第一次写脚本")

然后点工具栏 「运行」。

点运行
→
电脑把脚本推到手机
→
手机自动执行
→
下面日志面板出现这行字
日志面板(模拟)
[脚本 main:1] 你好,我是第一次写脚本
看到这行字 = 全通了
电脑能连手机、能推脚本、手机能跑 —— 后面所有教程都建立在这一步上。没看到就先回上一页查连接。

小知识:打印 和 print 是同一个东西,中文英文随便用。日志面板只是给你自己看,打包发给客户后客户看不到。

第 2 章

2.1新建项目:只填 3 个东西

点工具栏 「新建」,弹出来的框里只有三项:

新建项目
D:\千机图灵\千机图灵\
选择
com.xiaobai.demo1
我的项目
创建
字段怎么填能不能改
存放位置项目文件夹放哪,默认在 千机图灵\ 下面。不用动。创建时定
应用包名像网址倒着写的名字,英文小写 + 点,例如 com.abc.monster。两个项目不能重复。打包时还能改
应用名称客户手机上显示的名字,中文可以,例如 自动打怪。打包时还能改
包名别乱写
不要写 com.xiaobai.helper(那是引擎自己的包名),也不要带中文、空格、大写。写错了打包会失败。
第 2 章

2.2项目里都有什么

创建完,左边工程面板会出现 4 个分区,你只需要先管第 1 个:

我的项目\ ← 项目文件夹 ├─ 脚本\ │ └─ 我的项目.lua ★ 主脚本:打包后 APP 启动就跑它 ├─ 资源\ 图片、模型、配置,脚本里用 找图/释放资源 引用 ├─ 界面\ .ui 界面文件(做设置面板/参数面板用) └─ 插件\ 插件文件(进阶,先不用管)
脚本
真正的代码写在这。主脚本名字跟项目名一样,APP 打包后启动自动跑这个文件。
资源
截图得到的 .png、YOLO 模型 .onnx 都放这。脚本里写 找图("开始.png", ...) 就能用,不用写手机路径。

加文件 / 删文件

第 2 章

2.3「运行」按钮到底做了什么

很多人以为「运行」是在电脑上跑脚本 —— 不是,是把脚本推到手机上跑。

保存所有文件
→
打包 脚本\ → 手机
→
资源\ → 手机 img\
→
手机引擎执行主脚本
你电脑上的手机上变成
脚本\我的项目.lua手机上的主脚本(启动就跑它)
脚本\副本.lua同目录下的 副本.lua,用 require("副本") 调
资源\开始.pngimg/开始.png(脚本里直接写 "开始.png" 就行)
界面\main.uiui/main.ui
没连手机时「运行」是灰的
这是正常的,不是软件坏了。先去点「连接」把手机连上,按钮才会亮。
改了代码要重新点「运行」
手机上跑的还是上一次推过去的版本。改完 → 点运行 → 手机上会先停掉旧的再跑新的。
第 2 章

2.4右边那一栏(函数说明)是最好的老师

软件右边有一整列中文函数说明,每条都带「怎么用 + 例子」。新手 90% 的问题在这都能查到。

函数说明(示意图)
▸ 图色方法
找图(图片, 左, 上, 右, 下, 偏差) —— 在区域里找图,返回 x, y
找色(左, 上, 右, 下, 颜色, 相似度) —— 找某个颜色
▸ 识字方法
读数字(左, 上, 右, 下) —— 只读数字,读不出返回 nil
▸ AI识别方法(YOLO)
模型加载 / 模型检测 / 模型信息
学习顺序建议
先看「点击/滑动」→「图色」→「识字」→「文件」这四组,剩下的用到再查。
第 3 章 · 零基础

3.1别怕,Lua 是最好上手的语言之一

你不需要装任何东西。左边代码区写,右边点「运行」,手机上就有反应 —— 这就是学 Lua 的全部环境。

它长这样
看一眼复制
print("打怪开始") if 血量 < 30 then print("血太少了,先加血") end
新手只需要掌握 5 件事
① 怎么输出(print)
② 怎么存东西(变量)
③ 怎么判断(if)
④ 怎么重复(循环)
⑤ 怎么打包一段代码复用(函数)
表和函数是新手最怕的,第 3.12 ~ 3.16 节专门用大白话讲。
关于大写小写
Lua 区分大小写:Blood 和 blood 是两个不同的名字。中文名不受影响。
第 3 章 · 零基础

3.2第一件事:把结果显示出来

1.lua复制
print("你好") print(123) print("血量是", 88)

日志面板会输出:

日志复制
[脚本 main:1] 你好 [脚本 main:2] 123 [脚本 main:3] 血量是 88
为什么我写的没输出?
① 忘了点「运行」;② 看错地方了 —— 输出在编辑区下面的日志面板,不在手机屏幕。
想在手机屏幕上看文字,用 提示("文字", 100, 300)。
关于中英文函数名(重要)
print 是 Lua 原生命令,本教程所有代码统一用英文写法,最保险。
引擎另外内置了一批中文别名(点击、滑动、找图、找色、读数字、延时、提示……), 这些在软件右侧「函数说明」里能搜得到就代表能用,搜不到就别写。
拿不准的时候:中文名一律去右侧函数说明里搜一遍,有就放心用,没有就用英文。
第 3 章 · 零基础

3.3变量:给它起个名字,把东西存起来

变量复制
local 名字 = "小白" local 等级 = 80 local 正在打怪 = true print(名字, 等级) 等级 = 81 -- 后面想改,直接重新赋值 print(等级)
类型长什么样说明
字符串(文字)"小白" / 'abc'必须带引号
数字80 / 3.14不带引号
布尔(真假)true / false只有这两种,不能写 True
空值nil「什么都没有」,找图失败返回的就是它
local 是啥?必须写吗?
local 表示「这个变量只在本文件/本函数里用」,是好习惯,建议都写。
不写也能跑(会变成全局变量),但脚本一大就容易互相打架。
第 3 章 · 零基础

3.4注释与算术

注释和算术复制
-- 这一行不会执行,是写给人看的说明 -- 想临时关掉一行代码,前面加两个减号就行 local a = 10 local b = 3 print(a + b) -- 13 print(a - b) -- 7 print(a * b) -- 30 print(a / b) -- 3.3333333333333 print(a % b) -- 1(余数,判断「能不能整除」很有用) -- 文字拼接用两个点 print("血量:" .. a .. "/" .. b) -- 血量:10/3
三个常用小工具
取整数(3.9) → 3 | 四舍五入(3.6) → 4 | 随机数(1, 100) → 1~100 随机
数字和文字不能直接加
123 .. "个" 能拼成文字 123个;但 "123" + 1 会报错。 读数字读出来是数字,读文字读出来是文字,别混。
第 3 章 · 零基础

3.5if:让脚本自己做决定(最重要的一节)

语法就一个模板:if 条件 then ... end。注意结尾必须有 end。

最简版复制
local 血量 = 25 if 血量 < 30 then print("血太少了") end print("这一行一定会执行")
90% 的新手报错都是这个
写了 if 忘了写 end → 报 'end' expected。
记住口诀:一个 if 配一个 end。缩进(前面的空格)不影响运行,但一定要缩,不然自己都看不懂。

加个否则:if / else

二选一复制
local 血量 = 80 if 血量 < 30 then print("先加血") else print("继续打") end
第 3 章 · 零基础

3.6多个条件:elseif 和比较符

三段判断复制
local 血量 = 50 if 血量 < 30 then print("危险,加血") elseif 血量 < 70 then print("有点低,注意") else print("状态很好") end
写法意思例子
==等于(两个等号!)名字 == "小白"
~=不等于状态 ~= "打怪"
> < >= <=大于 / 小于 / 大于等于 / 小于等于血量 <= 0
and并且(两个都成立)血量 < 30 and 有药
or或者(一个成立就行)血量 < 30 or 没蓝
not不成立not 正在打怪
最常见的低级错误
把 == 写成 =(一个等号是赋值,两个才是比较)。if 名字 = "小白" then 会直接报错。
第 3 章 · 零基础

3.7循环:让脚本一直干活

脚本的骨架基本都是「一直重复:看一眼 → 做判断 → 点一下」。

主循环模板(背下来)复制
while true do -- 这里写每次要干的事 print("我在循环里") 延时(1000) -- 停 1 秒(1000 毫秒),千万别不写! end
循环里必须要有「延时」
不加 延时 会疯狂空转:手机发烫、卡死、甚至被系统杀掉。
经验值:判断类 100~300ms,等界面 500ms,长时间不变 1000ms。

数着次数循环:for

跑 10 次就停复制
for i = 1, 10 do print("第 " .. i .. " 次") 延时(500) end print("10 次跑完了")
怎么停下来
点软件上的「停止」,或者手机悬浮球点停止。脚本里的 延时() 会立刻被打断,所以即使卡在循环里也能停。
第 3 章 · 零基础

3.8函数:把一段代码取个名字

为什么要函数?因为同一段操作你要写几十遍 —— 包成函数,写一遍,到处调用。

定义 + 调用复制
-- 定义(只是"写好",不会执行) function 打招呼() print("你好呀") 延时(300) end -- 调用(这样才会真的执行) 打招呼() 打招呼()

带参数:让它能变

参数复制
function 打招呼(名字) print("你好," .. 名字) end 打招呼("小白") 打招呼("老王")

带返回值:把结果交回来

return复制
function 加血够不够(当前血, 需要血) if 当前血 >= 需要血 then return true else return false end end if 加血够不够(80, 50) then print("够,可以打") end
第 3 章 · 零基础

3.9实战:把一个常用操作封装起来

假设你每次打怪都要「找一次开始按钮再点它」。不封装的话,写 5 遍就长这样:

✗ 复制粘贴 5 遍(最垃圾写法,但能跑)
main.lua复制
local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) end 延时(500) local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) end 延时(500) -- 还要再来三遍……
✓ 封装一次,到处调用
main.lua复制
function 点开始() -- 封装 local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) return true -- 点到了 end return false -- 没找到 end 点开始() -- 用 点开始() 点开始()
封装到底好在哪
① 以后想改(比如把相似度从 0.8 改成 0.9),只改函数里一处,全部生效;
② 代码短了,一眼能看出流程;
③ 可以直接把 if 点开始() then 当条件用(因为它 return true/false)。
第 3 章 · 零基础

3.10表(一):一堆东西排排站

「表」就是一个抽屉里放好几样东西。新手先只记「数组式」:

数组式表复制
local 怪物 = {"鸡", "鹿", "狼", "熊"} print(怪物[1]) -- 鸡 ← 注意:从 1 开始,不是 0! print(怪物[4]) -- 熊 print(#怪物) -- 4 ← # 是"一共几个" -- 加一个 怪物[5] = "龙" print(#怪物) -- 5

遍历(一个个过一遍)

for 遍历复制
local 怪物 = {"鸡", "鹿", "狼"} for i = 1, #怪物 do print("第" .. i .. "只:" .. 怪物[i]) end
什么时候用数组式
一串同类的名字 / 一串坐标 / 一串图片名 —— 凡是「按顺序排的一堆」都用它。
新手最常踩的坑:从 0 开始数
Lua 的表从 1 开始。写 怪物[0] 拿到的是 nil,不会报错,但你会莫名其妙拿不到值。
第 3 章 · 零基础

3.11表(二):带名字的抽屉(键值式)

数组是「1号、2号、3号」,键值式是「给它取个名字」:

键值式表复制
local 角色 = { 名字 = "小白", 等级 = 80, 血量 = 100, } print(角色.名字) -- 小白 print(角色.等级) -- 80 角色.等级 = 81 -- 改值 角色.蓝量 = 50 -- 新增一项 print(角色.蓝量) -- 50

遍历所有项

pairs复制
local 角色 = {名字 = "小白", 等级 = 80} for 键, 值 in pairs(角色) do print(键, 值) -- 等级 80 / 名字 小白(顺序不固定) end
小技巧:找不到就当默认值
local 血 = 角色.血量 or 100 —— 如果 角色.血量 是 nil,就用 100。
这招在「配置项可能没填」的时候特别好用。
第 3 章 · 零基础

3.12表(三):表里套表(实战最常用)

坐标、检测结果这类「一组一组的数」都要靠套表:

套表复制
-- 三个按钮的坐标,每个都是一张小表 local 按钮 = { {名字 = "开始", x = 540, y = 1200}, {名字 = "确定", x = 720, y = 900}, {名字 = "关闭", x = 1000, y = 120}, } for i = 1, #按钮 do local 项 = 按钮[i] print(项.名字, 项.x, 项.y) 点击(项.x, 项.y) 延时(300) end

真实场景:遍历找图结果

YOLO 检测结果就是表复制
local 结果 = 模型检测(0, 0, 9999, 9999, 0.35) if 结果 ~= nil then for i = 1, #结果 do local 物 = 结果[i] print(物.cls, 物.prob, 物.cx, 物.cy) -- 类别 / 置信度 / 中心点 end end
看表的结构有个笨办法
写 print(结果) 只会显示一个地址(table: 0x7f...)。要看内容就 for k, v in pairs(结果) do print(k, v) end。
第 3 章 · 零基础

3.13「能跑」和「好维护」的差距

同一个功能,两种写法都能跑,但第二个改起来不痛苦:

✗ 全堆在一起
main.lua复制
while true do local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) 延时(1000) local x2, y2 = 找图("确定.png", 0, 0, 9999, 9999, 0.8) if x2 ~= nil then 点击(x2, y2) 延时(1000) end end 延时(500) end
✓ 拆成小函数
main.lua复制
function 找并点(图片) -- 通用工具 local x, y = 找图(图片, 0, 0, 9999, 9999, 0.8) if x ~= nil then 点击(x, y) 延时(800) return true end return false end while true do if 找并点("开始.png") then 找并点("确定.png") end 延时(500) end
简化写法的三个套路
① 能复用的动作 → 写成函数(上面那个 找并点 一行搞定所有按钮);
② 一堆固定数据 → 写成表(按钮坐标、地图名);
③ 先返回再判断 → 少写 if 嵌套(if 找并点("x") then ...)。
第 3 章 · 零基础

3.14新手最常见的 6 个报错

日志里写的原因怎么改
'end' expectedif / while / for / function 少了 end数一下:几个 if 就要几个 end
attempt to call a nil value函数名写错,或用了没定义的函数对照右侧函数说明核对名字;自己写的函数要定义在调用前面
attempt to index a nil value拿 nil 当表用,例如找图失败后直接 x.foo先 if x ~= nil then 再取
attempt to perform arithmetic on a nil value拿 nil 做加减(读数字没读到)用 读数字(..., 0) 给默认值
unexpected symbol near '='比较写成 =改成 ==
点了运行没反应、也没日志没连手机 / 脚本第一行就死循环先看连接状态;循环里补 延时()
看报错的方法
[脚本 main:12] 里的 12 就是行号 —— 直接跳到第 12 行看,八成就在那一行或上一行。
报错不怕,怕的是不看日志硬猜。
第 4 章

4.1脚本怎么「看见」屏幕:三种方式

方式适合什么优点缺点
找图按钮、图标、固定界面最好写,截图就能用换分辨率/换皮肤会失效
找色血条、状态灯、进度条快、省资源要自己选颜色,颜色会变
认字金币、战力、提示语数值类必用字体太花会认错
新手就用「找图」起步
先能跑通,再考虑用找色/认字优化。别人云亦云地上来就搞多点比色。

顺序永远是:看 → 判断 → 动手

找图/找色/读数字
→
if 找到了 then
→
点击 / 滑动
→
延时
第 4 章

4.2点击、长按、滑动

基本操作复制
点击(540, 1200) -- 点屏幕中间偏下 点击(540, 1200, 300) -- 点完等 300 毫秒 滑动(540, 1500, 540, 700, 400) -- 从下往上滑(翻页/拖地图) 长按(540, 1200, 1500) -- 按住 1.5 秒 按键("back") -- 返回键 按键("home") -- 回桌面
坐标怎么知道?
① 手机「开发者选项 → 指针位置」,点屏幕就显示 x y;
② 软件工具栏的 图色工具 里能看坐标、取色、截图;
③ 先截图到电脑上,用画图软件量像素(准,但麻烦)。
点击自带 ±1~3 像素随机
这是故意的,防检测。所以别指望每次落在完全同一个点。
先点再等,最常用的两行复制
点击(x, y) 延时(500)
第 4 章

4.3找图:脚本的眼睛

找图复制
-- 找图(图片名, 左, 上, 右, 下, 偏差) local x, y = 找图("开始.png", 0, 0, 9999, 9999, 0.8) if x ~= nil then print("找到了,坐标", x, y) 点击(x, y) else print("没找到") end
截图三原则(很重要)
① 只截按钮本体,不要把大片背景截进去;
② 四周留 2~3 像素,别把边框切掉;
③ 越小越准。截图后存成 .png 放进「资源」。
一次找多个
找图("a.png|b.png", ...) 任意一张命中都算;找图EX(...) 能告诉你命中的是第几张。
第 4 章

4.4找色:比找图快,适合状态判断

找色 / 颜色数量复制
-- 找色(左, 上, 右, 下, 颜色, 相似度) local x, y = 找色(0, 0, 9999, 9999, "#ff0000", 0.9) if x ~= nil then print("屏幕上有红色") end -- 颜色数量:某区域里有多少个这个颜色(判断进度条、血条) local n = 颜色数量(100, 1400, 400, 1440, "#ff3b3b-101010", 0.9) if n > 0 then print("血条还有颜色,数量", n) end
函数什么时候用
找色「这个位置有没有这个颜色」,比如技能冷却好了没
颜色数量「这个颜色占多少」,比如血条长度、进度条
多点找色
findMultiColor
几个点同时满足才算命中,最严格,防误判
颜色怎么写
"#ff0000" 是纯红。带 -101010 表示允许每个通道 ±16 的误差,写宽松点更稳。
颜色用「图色工具」直接吸,别手打。
第 4 章

4.5认字:读数字、读文字、点文字

常用四招复制
-- 1) 只读数字(战力、金币、次数) local 金币 = 读数字(700, 100, 1000, 150, 0) print("金币", 金币) -- 2) 读文字(名字、提示语) local 名字 = 读文字(100, 500, 600, 560, "") if 名字 == "挑战成功" then print("过关了") end -- 3) 直接点文字(最省事,免字库) 点文字("确定") -- 4) 等文字出现(最多等 10 秒) local x, y = 等文字("战斗胜利", 10) if x ~= nil then 点击(x, y) end
一定要给默认值
读数字(..., 0) 里最后那个 0 是「读不出来就返回 0」。不写默认值会返回 nil,拿去做加减直接报错。
认不准怎么办
① 区域缩小到只有那串字;② 别把图标边框框进去;③ 字体太花就改用「找图」把数字截成图片然后一个数字一个图片地找。
第 4 章

4.6换手机就错位?设好「设计分辨率」

你在自己手机上量出坐标 540,1200,别人的手机分辨率不一样就会点歪。设一次设计分辨率就全解决了:

一行搞定适配复制
设置设计分辨率(1080, 1920) -- 按你量坐标时用的那台手机填 点击(540, 1200) -- 以后所有坐标都按 1080x1920 写,自动换算
放在脚本最上面
这一行要写在所有点击/找图之前,一般就放在脚本第一行。
不知道自己的分辨率?
用 print(屏幕宽(), 屏幕高()),或者 print(分辨率())。

本章最重要的组合套路

模板复制
function 找并点(图片, 偏差) local x, y = 找图(图片, 0, 0, 9999, 9999, 偏差 or 0.8) if x ~= nil then 点击(x, y) 延时(600) return true end return false end

这 9 行会陪着你写完整套脚本,先背下来。第 5 章马上用它。

第 5 章

5.1完整实战:一个能交付的小脚本

假设要做的功能:启动游戏 → 等主界面 → 循环:关弹窗 / 血少加血 / 点开始 / 点胜利。这就是最典型的自动化脚本骨架。

main.lua(可直接抄,改配置区即可)复制
-- ========== ① 配置区:以后只改这里 ========== local 游戏包名 = "com.xxx.game" local 低血线 = 30 -- ========== ② 工具函数 ========== function 找并点(图片, 偏差) local x, y = 找图(图片, 0, 0, 9999, 9999, 偏差 or 0.8) if x ~= nil then 点击(x, y) 延时(600) return true end return false end function 等图(图片, 秒) local 用时 = 0 while 用时 < (秒 or 10) * 1000 do local x, y = 找图(图片, 0, 0, 9999, 9999, 0.8) if x ~= nil then return x, y end 延时(300) 用时 = 用时 + 300 end return nil end -- ========== ③ 启动 ========== 设置设计分辨率(1080, 1920) 启动app(游戏包名) 延时(8000) print("游戏已启动") local x, y = 等图("主界面.png", 30) if x == nil then 提示("进不去游戏,脚本结束", 200, 500, 18, "#ff5555") return end print("已进主界面") -- ========== ④ 主循环 ========== while true do if 找并点("关闭弹窗.png") then print("关弹窗") elseif 找并点("开始战斗.png") then print("开始战斗") elseif 找并点("胜利确定.png") then print("结算确认") else local 血量 = 读数字(60, 40, 260, 90, 100) if 血量 < 低血线 then print("血量低", 血量, "先加血") 找并点("加血按钮.png") end 延时(500) end end
第 5 章

5.2逐段解释(每一块在干嘛)

段落作用为什么这么写
①配置区把所有要改的东西提到最上面以后换游戏、调阈值只改这 3 行,不用翻遍全文
②工具函数「找并点」「等图」两个万能动作后面 20 处点击都靠它,写一次用一辈子
③启动设分辨率 → 开游戏 → 等主界面等图 最多等 30 秒,进不去就提示并 return(结束脚本)
④主循环无限循环按优先级判断if / elseif 是从上往下试,最要紧的放最前面
为什么用 if / elseif 串起来
因为同一时刻只可能发生一件事。用 elseif 比写 4 个独立 if 快,也不会出现「点了关闭又去点开始」的乱序。
else 分支必须延时
如果 4 个都没命中,就走到 else。这个分支如果不延时,会疯狂刷屏空转 —— 每个循环至少 300~500ms。
第 5 章

5.3让它更像正式产品:加卡密和状态提示

打包版必备的两段复制
-- 打包版启动时引擎已经自动弹框验过卡密了,这里直接拿那张卡 提示("已登录:" .. 当前卡密(), 100, 60, 16, "#7CE38B", -1) -- 毫秒 -1 = 常驻 -- 循环里给自己和客户看当前状态(打包版客户能看到) 提示("正在战斗 血量 " .. 血量, 100, 60, 16, "#7CE38B", -1)
给客户看的两种方式
① 提示(...):屏幕上的小浮字,毫秒 -1 是常驻(当成状态栏用);
② print(...):只在你自己的日志面板能看到,客户看不到,调试用。

加一层"防卡死"保护

兜底复制
local 连续失败 = 0 while true do if 找并点("开始战斗.png") then 连续失败 = 0 else 连续失败 = 连续失败 + 1 if 连续失败 > 60 then -- 大概 30 秒啥也没干成 print("卡住了,重进游戏") 停止app(游戏包名) 延时(3000) 启动app(游戏包名) 延时(10000) 连续失败 = 0 end 延时(500) end end
第 6 章

6.1打包前先自查这 5 条

自查清单
① 主脚本在「脚本」分区,名字是 项目名.lua(打包后 APP 启动就跑它);
② 所有用到的图片都在「资源」分区里(别只在电脑某个文件夹里);
③ 脚本能独立跑起来——不依赖你手动点运行、不依赖调试版的任何东西;
④ 需要卡密的话,卡密登录 那套已经写好(勾「官方卡密」时会自动帮你加密);
⑤ 分辨率适配那行 设置设计分辨率 已经加上。
先在调试版跑通再打包
调试版能跑 ≠ 打包版能跑。打包版没有你电脑上的日志面板,而且会真正校验卡密。所以打包后务必自己装到手机上跑一遍,别直接发客户。

点工具栏「打包」

弹出来的对话框上一排是「打包类型」,下拉只有两个选项:打包apk 和 打包脚本。这一章讲第一个。

第 6 章

6.2打包对话框,一栏一栏填

打包
打包apk
自动打怪
com.abc.monster
1.0.0 / 1
脚本/我的项目.lua
☑ arm64-v8a ☑ armeabi-v7a
...\android\AI
打开目录开始打包
字段怎么填
应用名称手机上显示的名字,中文随便写
包名英文小写+点,不能和已装的 App 重复;改过就得当新 App 装
版本名 / 版本码版本名给人看(1.0.0),版本码是整数给系统比大小(1、2、3…)。每次发新版版本码必须变大
打包脚本默认自动选主脚本,一般不用动
架构至少勾 arm64-v8a;想兼容老手机就再勾 armeabi-v7a(包会大一点)
应用图标可不填,默认蓝图标。要自定义就选一张 png
输出目录默认 android\AI,出现"重名"会自动加 (1)(2)
第 6 章

6.3两个勾选框决定「安不安全」

☑ 使用官方卡密(建议勾)
勾上后:脚本被加密、运行时校验卡密、后台能看到在线/离线、能远程停用。
勾上会自动带上「最强加密」。
不勾 = 谁拿到 APK 都能用,等于白送。
☑ 最强加密(AOT)
把脚本编译成机器码,反编译难度最高。
代价:不能用热更新(每次改脚本都要重新打包发客户)。
如果打算长期更新、要热更新,就别勾。
AOT + 打包脚本 = 直接拒绝
勾了「最强加密」又选「打包脚本(热更新包)」会被弹窗拦下来。二选一。

其它小开关

第 6 章

6.4点「开始打包」之后发生了什么

打包是云端打包,你电脑上不需要装 Android SDK,也不要有 android 目录。

① 校验开发者账号/包月/次卡
→
② 上传项目(>8MB 会提示删大图)
→
③ 服务器排队编译
→
④ 自动下载成品 APK
情况结果
成功APK 落到 android\AI\应用名.apk,托盘气泡提醒,正式扣费
失败弹窗告诉原因,自动退款,不扣钱
10 分钟没回报冻结金额自动退回
提示「还没开通打包」去后台开通包月,或等全站免费打包时段
发客户之前
① 自己先用真机装一遍,跑 5 分钟看会不会被杀/闪退;
② 把 APK 改成客户看得懂的名字(自动打怪_v1.0.2.apk);
③ 提醒客户开「悬浮窗 / 后台运行 / 电池不优化」三项权限,不然会被系统杀。
第 7 章

7.1什么是热更新:不用重装 APK 就能改脚本

客户已经装好的 APK,脚本有 bug 或者要加功能 —— 传统做法是重新打包、让客户卸载重装,客户早跑了。

✗ 重新打包 APK
改脚本 → 打包 APK → 发给客户 → 客户卸载重装 → 登录卡密 → 权限重设
客户流失率极高,而且版本一多你自己都乱。
✓ 热更新
改脚本 → 打包脚本(.xbhot)→ 后台上传 → 客户下次启动自动拉新脚本
APK 不用动,客户完全无感。
打包类型选 打包脚本
→
得到 .xbhot 文件
→
后台「热更新」上传
→
客户启动自动生效
两个前提
① 打包 APK 时没勾「最强加密(AOT)」(勾了就不能热更新);
② APK 里勾了「自检最新版」(默认开)。
第 7 章

7.2打包脚本 + 上传

  1. 工具栏「打包」→ 打包类型选 打包脚本
  2. 版本码填一个比上次大的整数(比如上次 3,这次填 4)
  3. 点开始打包 → 产物是 android\AI\项目名(4).xbhot
  4. 打开浏览器进客户后台 → 热更新 → 选项目 → 选这个 .xbhot → 版本号(留空自动 +1)→ 填更新说明 → 上传
你会关心的问题答案
客户怎么才能拿到新版APK 启动时自动去拉,不用客户点任何东西
调试版会拉吗不会。电脑推脚本的调试版自动跳过热更新,只有打包版才拉
能存几个版本只自动保留最近 5 个,旧的会被删
发错了怎么办版本列表里点「替换」切回上一版(5 秒内只能切一次)
能不能传明文 .lua可以,但传上去服务器还会再加一层加密
推荐节奏
小改动用热更新(改错字、调阈值、加个按钮);大改动(换架构、加权限、换图标)才重新打包 APK。
第 8 章

8.1登录客户后台,先建项目

浏览器打开官网 → 登录 → 进「客户后台」。左侧一般有这几项:卡密、资费说明、个人信息、热更新、云函数、对接文档。

客户后台(示意图)
卡密
资费说明
个人信息
热更新
云函数
对接文档
项目信息
项目名称:自动打怪
项目ID:1000123(点一下复制)
项目密钥:a1b2c3…(点一下复制)
项目ID 和 项目密钥 = 你的身份证,别乱发
这两个是脚本/客户端跟服务器说话的凭证。项目密钥泄露 = 别人能盗刷你的卡密和云函数。真泄露了就在这一页点「重置密钥」。
项目数量
前 5 个免费,超过每个扣 30 元(从余额扣)。
第 8 章

8.2项目设置:这些开关直接影响客户体验

设置项作用建议
默认窗口一张卡密能同时在几台设备上登录新手设 1(一台一卡)
默认类型生成卡密默认是小时/天/周/月/季/年月卡最多就设「月」
卡密长度生成的卡密字符数(≥6)12~16,太短容易撞
在线判定(秒)多久没心跳算离线(默认 300)默认就行
心跳间隔(秒)客户端多久报一次(默认 120,最低 120)建议不超过「在线判定」的一半
允许自助解绑客户换手机时能不能自己解绑开(不然天天找你解绑)
解绑扣时(小时)每解绑一台扣多少时长(2~720,默认 6)6~24,太少客户会反复换机
每日解绑上限一天最多解绑几次(1~99)1~3,防共享卡密轮流踢
允许自助改窗口客户能不能自己加设备数看你的定价策略
允许自助续费客户能不能自己买卡续时长开,能多赚钱
项目公告脚本登录时带回给客户看(停机通知等)经常写一句
旧版本作废重新打包后,老 APK 是否立刻失效强制升级时开,平时别开
项目开关紧急停用整个项目出事时的急停按钮
换手机自动解绑(很实用)
客户换手机登录时,如果窗口满了,系统会自动顶掉最老的那台设备,并按「解绑扣时」扣时长,同时弹窗告诉客户「已自动解绑旧设备(扣 X 小时)」。
客户不用再找你 → 你省事 → 时长照扣,不吃亏。
第 8 章

8.3生成卡密、发卡、查卡

卡密 → 生成(示意图)
10
← 生成几张(批量就改这里)
1
← 天/月/年,跟「默认类型」配合
VIP
11月活动
生成
客户说"卡密用不了",先看日志
卡密日志能看到:什么时候激活、绑了哪台设备、有没有被解绑、剩余时长。比问客户靠谱。
第 8 章

8.4客户最常问的 4 句话,怎么回答

客户说真实原因你怎么办
"提示窗口上限"卡密已经在别的手机登录了开了自助解绑的话让他自己解(扣时长);没开就去后台「解绑」
"卡密无效"输错、粘到空格、把大写当小写(卡密是小写字母数字)让他复制粘贴,别手打
"到期了想续"时长用完发新卡让他用「续费」功能(后台开「允许自助续费」)
"换手机了"设备绑在旧机上新版客户端会自动解绑并扣时,不用你动手
手动解绑是免费的,自助解绑是扣时长的
  • 你去后台点「解绑」= 不扣客户时长(人情)
  • 客户自己换机触发自动解绑 = 按「解绑扣时」扣(防止无限换设备白嫖)
第 9 章

9.1云函数是什么:把代码放在服务器上

正常情况下脚本在客户手机上跑,代码就在 APK 里,被人扒出来就完了。云函数是把核心逻辑放在服务器,手机上只拿到执行结果。

不用云函数
手机:if 血量 < 30 then 加血() end
逻辑在 APK 里,反编译能看到
用云函数
手机:local 配置 = 云函数表(项目ID, 密钥, "打怪配置")
逻辑在服务器,手机只拿到参数

后台怎么建

  1. 客户后台 → 云函数 → 选项目 → 新建云函数
  2. 填:名称(脚本里用它调用)、窗口(默认 1)、版本号、最低客户端版本码(0 = 不限)、Lua 代码
  3. 保存 → 手机上跑脚本就能拉到
数量限制
每个项目免费 1 个云函数,再加每个 30 元。
第 9 章

9.2脚本里怎么调用

main.lua复制
local 项目ID = "1000123" local 密钥 = "你的项目密钥" -- 方式一:直接拿回一个表(最常用) local 配置 = 云函数表(项目ID, 密钥, "打怪配置") if 配置 ~= nil then local 地图 = 配置.地图 or "新手村" local 低血 = 配置.低血线 or 30 print("云端配置:", 地图, 低血) end -- 方式二:拿源码自己处理(进阶,一般不用) local 结果 = 云函数(项目ID, 密钥, "打怪配置") if 结果 ~= nil and 结果.code == 0 then print("云端返回成功") end
云函数最实用的两个场景
① 远程调参:改阈值/地图名不用发版,后台改完客户下次启动就生效;
② 藏核心逻辑:把判断流程放云端,学生扒包也看不到完整逻辑。
拉不到云函数
项目ID对不上、密钥错、云函数名写错、客户端版本码低于「最低客户端版本码」、或者卡密没登录成功 —— 全部拉不到。
所以:云函数失败不能导致脚本直接崩,一定要给默认值(上面 or "新手村" 就是干这个的)。
第 10 章

10.1先注册一个「统计账号」

数据统计和卡密后台不是同一套账号,要单独注册(在官网的「数据统计 / 云数据」入口)。

注册统计账号
→
建表头(列名)
→
脚本里 上报数据()
→
网页看/导出 CSV
它能干嘛
客户每台机器的进度、金币、等级、时长全都能上报上来,你在网页上按设备名筛选、按列排序、导出 Excel。
还能当"云存档"用:客户的配置存在云上,换手机一键恢复。
第 10 章

10.2加表头 + 上报数据

① 网页上加列

统计页 → 表头设置 → + 加一列 → 填列名(≤ 8 个字,比如「泰拉」「等级」)→ 保存表头。

② 脚本里上报

main.lua复制
-- 上报数据(统计账号, 密码, 设备名, 数据表) -- 第三个参数"设备名"是你自己起的标识,网页上按它查;用 设备型号() 拼一下最省事 上报数据("myuser", "mypass", 设备型号() .. "-1区", { 泰拉 = 12345, 等级 = 80, 金币 = 999, })
三个坑
① 表里的键名必须和网页上的列名一模一样(少一个字就是空列);
② 设备名建议用 设备名() 或者你自己拼("区1-角色A"),后面查的时候好找;
③ 别每秒都上报,30 秒~5 分钟一次就够,不然数据表爆炸。

③ 云配置(换手机不用重设参数)

保存 / 读取复制
保存云配置("账号", "密码", "我的配置") -- 把当前设置存到云 local 行 = 云配置列表("账号", "密码") -- 看有哪些配置 获取云配置("账号", "密码", "我的配置") -- 换手机后一键恢复
第 11 章 · 进阶

11.1YOLO 和找图有什么不一样

对比找图YOLO
原理像素逐点比对AI 模型识别"物体"
换皮肤/换角度立刻失效照样认得出
一次找多个同类麻烦(要写多次)一次返回全部(带坐标)
需要什么截图一张训练好的 .onnx 模型
速度快慢一些(吃性能)
什么时候值得用
怪物/道具长得不一样但属于同一类、或者要同时找好几个目标的时候。固定按钮还是老老实实用找图。
模型从哪来
需要自己训练一个 YOLO 模型导出成 .onnx(官方有配套的模型训练工具)。模型文件放进项目「资源」分区。
第 11 章 · 进阶

11.2三行代码用起来

main.lua复制
-- 1) 加载模型(只在开头加载一次,别放循环里) local ok = 模型加载("怪物.onnx") if not ok then print("模型加载失败", 模型信息()) return end -- 2) 检测:区域 + 置信度门限 while true do local 结果 = 模型检测(0, 0, 9999, 9999, 0.35) if 结果 ~= nil then for i = 1, #结果 do local 物 = 结果[i] print("发现", 物.cls, 物.prob, 物.cx, 物.cy) 点击(物.cx, 物.cy) -- 点它的中心点 延时(500) end end 延时(800) end
字段含义
cls类别名(比如 "怪物")
prob置信度 0~1,越大越确定
x, y, w, h左上角坐标 + 宽高
cx, cy中心点(点击就用它)
两个常见错误
① 把 模型加载 写进 while 循环 → 每秒加载一次模型,手机直接卡死;
② 置信度调到 0.1 → 满屏假目标乱点。先用 0.35~0.5 试。
第 12 章

12.1最常见的问题(按出现频率排)

现象原因与解决
脚本跑几分钟就停被系统杀了。开:悬浮窗权限 + 允许后台运行 + 电池「不优化」+ 关省电模式;部分机型还要在最近任务里「锁定」
点了运行手机没反应没连上;或连的是另一台手机;或脚本第一行就死循环没延时
找图一直找不到① 图片没放进资源区;② 相似度 0.8 太高/太低;③ 截图带了背景;④ 分辨率没设 设置设计分辨率
换手机就点歪同上,加 设置设计分辨率(宽, 高)
打包提示"还没开通打包"后台没包月 / 没有次卡 / 不在免费时段
打包失败说项目太大超过 8MB,删掉大图或改用热更新
热更新不生效用的是调试版(调试版跳过热更新);或打包时勾了 AOT;或版本码没变大
客户装上闪退架构没勾 arm64-v8a;或安卓版本太低;或没给权限
第 12 章

12.2新手学习路线(照着走不迷路)

第 1 周 能跑通"print + 点击 + 找图",看懂 if 和 while
第 2 周 能写一个"点开始 → 等结算 → 点确定"的循环,会用 找并点/等图 封装
第 3 周 能读数字做判断、会用表存按钮坐标、能给脚本加防卡死
第 4 周 能打包、能上架卡密、能热更新,第一个客户跑起来
三条经验(比教程更重要)
① 先抄后改:别从零写,找一段能跑的,改成你要的;
② 勤存版本:每改好一次就另存一个 main_v2.lua,改坏了能退回去;
③ 先看日志:报错行号都给你了,别硬猜。
卡住了怎么办
  1. 看日志最后一行报什么错,跳到那一行
  2. 把可疑代码注释掉(前面加 --),二分法找问题行
  3. 只留最核心的几行跑,能跑通再一点点加回来
  4. 还不行就问客服,带上截图和日志,别只说"不能用"
🎉
到这里你就算入门了
剩下的都是熟练度问题

把第 1~6 章照着做一遍,你就能做出第一个能发给客户的成品。
第 7~11 章是让你卖得更好、维护更省事的东西,等你有了第一个客户再回来看。

会解压安装
→
会写 if/循环
→
会用找图认字
→
会打包卖钱

教程里没覆盖到的函数,去软件右侧「函数说明」里搜名字,那里是完整的。