魔域官方外挂规则明确禁止设计、编制、使用、传播危害游戏正常运行或破坏平衡性的附加程序，第三方软件、插件、外挂、同步器等都在限制范围，违规可进入外挂监狱并按程度处罚 。官方安全公告按主线任务、九星、星级副本、合副宠、野外BOSS等场景统计外挂处罚，并持续增强反外挂检测与防绕过 ；用户行为准则同时禁止制作买卖使用外挂、利用漏洞篡改数据、以盈利目的批量产出虚拟物品 。下面只写本人设备学习用的UI自动化技术框架，不提供自动打怪、自动拾取、脱机、内存修改、协议伪造、多开同步、打金变现方案。
一、适用边界先定清楚
只做两件事：学习安卓自动化工具原理、把游戏内已提供的官方功能做成提醒型流程。自动点击攻击、自动放技能、自动跑图刷精英、自动合宠、自动九星、自动野外BOSS、自动买卖捡物，都属于高违规风险，不建议写。若仅做学习Demo，优先选非游戏App练习找控件、找图、定时；真要在魔域里用，只保留“识别弹窗并提醒人工处理”“读取官方活动列表后弹通知”“截图归档日志”等不直接代替战斗和产出的动作。
二、环境准备
安卓实体机装Auto.js类无障碍自动化工具，开系统设置-无障碍-对应应用服务；电脑侧可用VS Code装Auto.js插件做远程调试，手机和电脑同网，工具内开启调试服务后推送运行 。无Root可完成大部分点击、截图、控件操作；Root、Xposed、Frida、内存修改、抓包重发都不纳入学习范围。模拟器运行游戏再加脚本会被行为检测标记同步特征，多开相同操作更危险 。
权限最小集：无障碍服务、存储读取截图、必要时的定时自启动白名单。电池优化关掉，保证后台不杀；锁屏密码会让定时脚本无法解锁，学习阶段用无密码或仅亮屏测试 。
三、界面元素提取
游戏画面分两类。原生控件界面如系统设置弹窗、部分H5活动页，用控件选择器取text、id、desc、className；纯游戏渲染画面如战斗、小地图、血条、技能图标，控件树拿不到，只能用截图找图或找色 。
控件示例：
auto.waitFor();
let btn=text("确定").findOne(5000);
if(btn){btn.click();} else {console.log("未找到确定");}
无文本图标用desc或id代替；findOne超时返回空必须判空，避免后续click空对象崩溃 。
找图示例：
let img=images.read("/sdcard/moyu/icon_daily.png");
let scr=captureScreen();
let p=findImage(scr,img,{threshold:0.8,region:[0,0,device.width,device.height/2]});
if(p){click(p.x,p.y);} else {console.log("日常图标未出现");}
threshold 0.8起调，游戏换肤、分辨率缩放、夜间模式会导致匹配失败；region缩小到顶部菜单区域比全屏快很多 。
找色示例：
let s=captureScreen();
if(images.detectsColor(s,"#ffd700",x,y,16,true)){
console.log("目标金色提示出现");
}else{
console.log("未识别");
}
单色点适合固定按钮，不适合整块动态技能特效；多点比色比单点稳，但维护成本高。
四、任务流程抽象
把人工操作拆成状态机，不写死“一直打”。通用模板：
1. 取屏：captureScreen存入变量，按区域裁剪。
2. 识态：判断当前在登录页、主城、战斗、副本结算、断线重连、系统弹窗。
3. 决策：仅对白名单状态执行点击；未知状态截图写日志并停止。
4. 操作：click/swipe/input，完成后sleep随机值。
5. 校验：再次取屏确认状态转移；失败重试N次后人工告警。
6. 归档：写JSON日志，包含时间、设备、界面标签、点击坐标、截图路径。
伪代码：
function step(){
let st=detectState();
if(st==="login"){ handleLogin(); return; }
if(st==="dialog"){ handleDialog(); return; }
if(st==="daily_remind"){ notify("日常可手动处理"); stop(); return; }
log("unknown:"+st);
screenshot("/sdcard/moyu/log/"+Date.now()+".png");
stop();
}
这种结构不自动进战斗、不自动接任务，只做状态识别和人工提醒，违规面最低。
五、定时与循环
Auto.js支持cron注释做定时任务，例如每天固定时间运行签到提醒脚本 。纯学习用：
// @cron 30 9 *
auto.waitFor();
checkDailyIcons();
游戏场景不要写while(true)无限点击；若做本地Demo用固定轮次：
for(let i=0;i<5;i++){
let p=findDailyButton();
if(p){click(p.x,p.y);}
sleep(randomDelay(1500,3000));
}
randomDelay返回1500到3000毫秒随机数，避免固定间隔；固定周期、固定坐标、长时间无人工干预，都会被行为模型记异常 。
六、日志与异常
日志字段建议：runId、deviceModel、screenW、screenH、state、action、x、y、threshold、result、screenshotPath、errorStack。写文件用JSON一行一条，后期可统计哪些界面识别率低。
异常分支：
• 无障碍断开：监听服务状态，重开设置页并停止脚本。
• 游戏更新后图标变色：自动降级到人工，不强行低阈值乱点。
• 断线重连弹窗：只识别“重连/确定”并写日志，不自动输账号密码。
• 长时间无状态变化：超过预设次数停止并通知，不自动回城、不自动复活、不自动换线。
• 截图全黑：检查无障碍、悬浮窗、系统录屏权限，不继续点击。
七、魔域专项风险点
自动打怪/精英：图色能识别红名、血条、小地图红点，但官方行为检测看移动轨迹、攻击节奏、在线时长、产出效率，图色不碰内存也会被封 。九星、合副宠、野外BOSS是官方重点处罚场景，自动脚本风险最高 。多开同步器一套键鼠控多端，属于规则明文限制 。云手机跑官方自动战斗加人工巡检比本地全自动安全，但仍不能做自动拾取、自动交易、自动合宠打金 。来路“免封脚本”“防检测补丁”常带木马或盗号，官方申诉渠道为gm.99.com，误封可提交录屏和操作记录 。
八、合规自查清单
写任何面向魔域的自动化前逐条核对：不修改客户端文件；不读取/写入游戏内存；不伪造或重发网络包；不自动释放技能、自动攻击、自动拾取；不自动完成副本、boss、合宠、跑商、交易；不多开同步；不接打金变现；不关闭或绕过反外挂；仅用无障碍截图和控件做提醒、归档、本人手动流程辅助。全部满足再写Demo，任意一条不满足就改造成纯离线学习或放弃。
九、学习替代路径
零基础先拿系统设置、计算器、文件管理器练控件和找色；再拿任意非网游H5页面练定时；最后只做魔域“弹窗识别+本地通知+截图日志”工具。需要更深自动化理论再看Auto.js的images、UiSelector、cron、console模块文档 ，不要直接搜“魔域自动打怪源码”，相关结果多为外挂销售和封号教程 。官方反外挂会持续升级，技术练习以保持可审计、可停止、不替代核心玩法为原则，账号安全优于省事。
一、适用边界先定清楚
只做两件事：学习安卓自动化工具原理、把游戏内已提供的官方功能做成提醒型流程。自动点击攻击、自动放技能、自动跑图刷精英、自动合宠、自动九星、自动野外BOSS、自动买卖捡物，都属于高违规风险，不建议写。若仅做学习Demo，优先选非游戏App练习找控件、找图、定时；真要在魔域里用，只保留“识别弹窗并提醒人工处理”“读取官方活动列表后弹通知”“截图归档日志”等不直接代替战斗和产出的动作。
二、环境准备
安卓实体机装Auto.js类无障碍自动化工具，开系统设置-无障碍-对应应用服务；电脑侧可用VS Code装Auto.js插件做远程调试，手机和电脑同网，工具内开启调试服务后推送运行 。无Root可完成大部分点击、截图、控件操作；Root、Xposed、Frida、内存修改、抓包重发都不纳入学习范围。模拟器运行游戏再加脚本会被行为检测标记同步特征，多开相同操作更危险 。
权限最小集：无障碍服务、存储读取截图、必要时的定时自启动白名单。电池优化关掉，保证后台不杀；锁屏密码会让定时脚本无法解锁，学习阶段用无密码或仅亮屏测试 。
三、界面元素提取
游戏画面分两类。原生控件界面如系统设置弹窗、部分H5活动页，用控件选择器取text、id、desc、className；纯游戏渲染画面如战斗、小地图、血条、技能图标，控件树拿不到，只能用截图找图或找色 。
控件示例：
auto.waitFor();
let btn=text("确定").findOne(5000);
if(btn){btn.click();} else {console.log("未找到确定");}
无文本图标用desc或id代替；findOne超时返回空必须判空，避免后续click空对象崩溃 。
找图示例：
let img=images.read("/sdcard/moyu/icon_daily.png");
let scr=captureScreen();
let p=findImage(scr,img,{threshold:0.8,region:[0,0,device.width,device.height/2]});
if(p){click(p.x,p.y);} else {console.log("日常图标未出现");}
threshold 0.8起调，游戏换肤、分辨率缩放、夜间模式会导致匹配失败；region缩小到顶部菜单区域比全屏快很多 。
找色示例：
let s=captureScreen();
if(images.detectsColor(s,"#ffd700",x,y,16,true)){
console.log("目标金色提示出现");
}else{
console.log("未识别");
}
单色点适合固定按钮，不适合整块动态技能特效；多点比色比单点稳，但维护成本高。
四、任务流程抽象
把人工操作拆成状态机，不写死“一直打”。通用模板：
1. 取屏：captureScreen存入变量，按区域裁剪。
2. 识态：判断当前在登录页、主城、战斗、副本结算、断线重连、系统弹窗。
3. 决策：仅对白名单状态执行点击；未知状态截图写日志并停止。
4. 操作：click/swipe/input，完成后sleep随机值。
5. 校验：再次取屏确认状态转移；失败重试N次后人工告警。
6. 归档：写JSON日志，包含时间、设备、界面标签、点击坐标、截图路径。
伪代码：
function step(){
let st=detectState();
if(st==="login"){ handleLogin(); return; }
if(st==="dialog"){ handleDialog(); return; }
if(st==="daily_remind"){ notify("日常可手动处理"); stop(); return; }
log("unknown:"+st);
screenshot("/sdcard/moyu/log/"+Date.now()+".png");
stop();
}
这种结构不自动进战斗、不自动接任务，只做状态识别和人工提醒，违规面最低。
五、定时与循环
Auto.js支持cron注释做定时任务，例如每天固定时间运行签到提醒脚本 。纯学习用：
// @cron 30 9 *
auto.waitFor();
checkDailyIcons();
游戏场景不要写while(true)无限点击；若做本地Demo用固定轮次：
for(let i=0;i<5;i++){
let p=findDailyButton();
if(p){click(p.x,p.y);}
sleep(randomDelay(1500,3000));
}
randomDelay返回1500到3000毫秒随机数，避免固定间隔；固定周期、固定坐标、长时间无人工干预，都会被行为模型记异常 。
六、日志与异常
日志字段建议：runId、deviceModel、screenW、screenH、state、action、x、y、threshold、result、screenshotPath、errorStack。写文件用JSON一行一条，后期可统计哪些界面识别率低。
异常分支：
• 无障碍断开：监听服务状态，重开设置页并停止脚本。
• 游戏更新后图标变色：自动降级到人工，不强行低阈值乱点。
• 断线重连弹窗：只识别“重连/确定”并写日志，不自动输账号密码。
• 长时间无状态变化：超过预设次数停止并通知，不自动回城、不自动复活、不自动换线。
• 截图全黑：检查无障碍、悬浮窗、系统录屏权限，不继续点击。
七、魔域专项风险点
自动打怪/精英：图色能识别红名、血条、小地图红点，但官方行为检测看移动轨迹、攻击节奏、在线时长、产出效率，图色不碰内存也会被封 。九星、合副宠、野外BOSS是官方重点处罚场景，自动脚本风险最高 。多开同步器一套键鼠控多端，属于规则明文限制 。云手机跑官方自动战斗加人工巡检比本地全自动安全，但仍不能做自动拾取、自动交易、自动合宠打金 。来路“免封脚本”“防检测补丁”常带木马或盗号，官方申诉渠道为gm.99.com，误封可提交录屏和操作记录 。
八、合规自查清单
写任何面向魔域的自动化前逐条核对：不修改客户端文件；不读取/写入游戏内存；不伪造或重发网络包；不自动释放技能、自动攻击、自动拾取；不自动完成副本、boss、合宠、跑商、交易；不多开同步；不接打金变现；不关闭或绕过反外挂；仅用无障碍截图和控件做提醒、归档、本人手动流程辅助。全部满足再写Demo，任意一条不满足就改造成纯离线学习或放弃。
九、学习替代路径
零基础先拿系统设置、计算器、文件管理器练控件和找色；再拿任意非网游H5页面练定时；最后只做魔域“弹窗识别+本地通知+截图日志”工具。需要更深自动化理论再看Auto.js的images、UiSelector、cron、console模块文档 ，不要直接搜“魔域自动打怪源码”，相关结果多为外挂销售和封号教程 。官方反外挂会持续升级，技术练习以保持可审计、可停止、不替代核心玩法为原则，账号安全优于省事。