From e92b6ecfe64404eed8587643257e9bca18c59f7b Mon Sep 17 00:00:00 2001 From: DLmaster Date: Wed, 29 Jan 2025 10:24:03 +0800 Subject: [PATCH 1/2] =?UTF-8?q?fix(maa):=20=E4=BF=AE=E6=AD=A3=E4=BA=BA?= =?UTF-8?q?=E5=B7=A5=E6=8E=92=E6=9F=A5=E6=96=87=E6=A1=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- app/models/MAA.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/app/models/MAA.py b/app/models/MAA.py index 0bb51d1..939497d 100644 --- a/app/models/MAA.py +++ b/app/models/MAA.py @@ -400,7 +400,7 @@ class MaaManager(QObject): if run_book[0] and not self.isInterruptionRequested: if self.push_question( - "操作提示", "请检查用户代理情况，是否将该用户标记为异常？" + "操作提示", "请检查用户代理情况，该用户是否正确完成代理任务？" ): run_book[1] = True From 3f0f1612e3f22f78f98e2587cc87025632901076 Mon Sep 17 00:00:00 2001 From: DLmaster Date: Fri, 31 Jan 2025 21:52:31 +0800 Subject: [PATCH 2/2] =?UTF-8?q?doc:=20README=E5=90=8C=E6=AD=A5=E8=87=B3v4.?= =?UTF-8?q?2.2=E7=89=88=E6=9C=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 77 +++++++++++++++++++++++++++---------------------------- 1 file changed, 38 insertions(+), 39 deletions(-) diff --git a/README.md b/README.md index 381448b..f4e2d35 100644 --- a/README.md +++ b/README.md @@ -32,7 +32,8 @@ MAA多账号管理与自动化软件 ### 优势 - **节省运行开销：** 只需要一份MAA软件与一个模拟器，无需多开就能完成多账号代理，羸弱的电脑也能代理日常。 -- **自定义空间大：** 依靠高级用户配置模式，支持MAA几乎所有设置选项自定义，同时保留对模拟器多开的支持。 +- **自定义空间大：** 依靠高级用户配置模式，支持MAA几乎所有设置选项自定义，支持模拟器多开。 +- **调度方法自由：** 通过调度队列功能，自由实现MAA多开等多种调度方式。 - **一键代理无忧：** 无须中途手动修改MAA配置，将繁琐交给AUTO_MAA，把游戏留给自己。 - **代理结果复核：** 通过人工排查功能核实各用户代理情况，堵住自动代理的最后一丝风险。 @@ -44,8 +45,7 @@ MAA多账号管理与自动化软件 - **使用：** AUTO_MAA使用者可以按自己的意愿自由使用本软件。依据GPL，对于由此可能产生的损失，AUTO_MAA项目组不负任何责任。 - **分发：** AUTO_MAA允许任何人自由分发本软件，包括进行商业活动牟利。若为直接分发本软件，必须遵循GPL向接收者提供本软件项目地址、完整的软件源码与GPL协议原文（件）；若为修改软件后进行分发，必须遵循GPL向接收者提供本软件项目地址、修改前的完整软件源码副本与GPL协议原文（件），违反者可能会被追究法律责任。 - **传播：** AUTO_MAA原则上允许传播者自由传播本软件，但无论在何种传播过程中，不得删除项目作者与开发者所留版权声明，不得隐瞒项目作者与相关开发者的存在。由于软件性质，项目组不希望发现任何人在明日方舟官方媒体（包括官方媒体账号与森空岛社区等）或明日方舟游戏相关内容（包括同好群、线下活动与游戏内容讨论等）下提及AUTO_MAA或MAA，希望各位理解。 -- **衍生：** AUTO_MAA允许任何人对软件本体或软件部分代码进行二次开发或利用。但依据GPL，相关成果也必须使用GPL开源。 -- **授权：** 如果希望在使用AUTO_MAA的相关成果后仍保持自己的项目闭源，请在Issues中说明来意。得到项目组认可后，我们可以提供另一份使用不同协议的代码，此协议主要内容如下：被授权者可以自由使用该代码并维持闭源；被授权者必须定期为AUTO_MAA作出贡献。 +- **衍生：** AUTO_MAA允许任何人对软件本体或软件部分代码进行二次开发或利用。但依据GPL，相关成果再次分发时也必须使用GPL或兼容的协议开源。 - **贡献：** 不论是直接参与软件的维护编写，或是撰写文档、测试、反馈BUG、给出建议、参与讨论，都为AUTO_MAA项目的发展完善做出了不可忽视的贡献。项目组提倡各位贡献者遵照GitHub开源社区惯例，发布Issues参与项目。避免私信或私发邮件（安全性漏洞或敏感问题除外），以帮助更多用户。 以上细则是本项目对GPL的相关补充与强调。未提及的以GPL为准，发生冲突的以本细则为准。如有不清楚的部分，请发Issues询问。若发生纠纷，相关内容也没有在Issues上提及的，项目组拥有最终解释权。 @@ -95,58 +95,46 @@ MAA多账号管理与自动化软件 首次启动时会要求设置管理密钥。 - 管理密钥是解密用户密码的唯一凭证，与数据库绑定。 + 管理密钥是解密用户密码的唯一凭证，与用户数据库绑定。 密钥丢失或data/key/目录下任一文件损坏都将导致解密无法正常进行。 本项目采用自主开发的混合加密模式，项目组也无法找回您的管理密钥或修复data/key/目录下的文件。 - 如果不幸的事发生，建议您删除data/key/目录与data/data.db文件后重新录入信息。 + 如果不幸的事发生，建议您删除data/key目录与config目录后重新录入信息。 ``` ### 配置信息 -#### 设置MAA +#### 设置脚本实例 -1. 通过`浏览`绑定MAA后，单击`设置MAA`进行MAA全局设置。 - -2. 在打开的MAA界面完成`性能设置`、`游戏设置`、`连接设置`、`启动设置`、`界面设置`、`软件更新`等基本配置以及代理任务的详细配置。 - -3. 完成基本配置后，关闭MAA页面，AUTO_MAA会自动保存您的配置。 +1. 单击`+`并选择`MAA`以添加MAA脚本实例。 +2. 在`MAA目录`选项卡中通过`选择文件夹`打开MAA软件目录以绑定MAA。 +3. 在`MAA全局配置`选项卡中通过`设置`进行MAA全局设置。在打开的MAA界面完成`性能设置`、`游戏设置`、`连接设置`、`启动设置`、`界面设置`、`软件更新`等基本配置以及代理任务的详细配置。 +4. 完成基本配置后，关闭MAA页面，AUTO_MAA会自动保存您的配置。 - 注意：在MAA的设置过程中，若MAA要求`立刻重启应用更改`，请选择`稍后`。否则，MAA重启后的一切更改都不会被程序记录。 -- 特别的，您需要确保自己： +- 特别的，在设置MAA过程中，您需要确保自己： + - 在`切换配置`选项卡中选择了`Default`项。 - 取消勾选`开机自启动MAA`。 - 配置自己模拟器所在的位置并根据实际情况填写`等待模拟器启动时间`（建议预留10s以防意外）。 - 如果是模拟器多开用户，还需要填写`附加命令`，具体填写值参见多开模拟器对应快捷方式路径（如`-v 1`）。 ![MAA配置](https://github.com/DLmaster361/AUTO_MAA/blob/main/resources/images/README/MAA配置.png "MAA配置") -#### 设置AUTO_MAA - -本项目已基本完成GUI开发，您可以直接在设置页配置AUTO_MAA相关信息，页面简介如下： -- `MAA路径`：该项无法直接编辑，仅用于展示当前程序所绑定MAA的路径。 -- `浏览`：选择MAA文件夹。 -- `设置MAA`：编辑MAA全局配置，具体使用方法参见前文。 -- `日常限制`：执行自动代理的日常部分时的超时阈值，当MAA日志无变化时间超过阈值时，视为超时。 -- `剿灭限制`：执行自动代理的剿灭部分时的超时阈值，当MAA日志无变化时间超过阈值时，视为超时。 -- `运行失败重试次数上限`：对于每一用户，若超过该次数限制仍未完成代理，视为代理失败。 -- `开机自动启动AUTO_MAA`：实现AUTO_MAA的自启动。 -- `AUTO_MAA启动时禁止电脑休眠`：仅阻止电脑自动休眠，不会影响屏幕是否熄灭。 -- `启动AUTO_MAA后直接代理`：在AUTO_MAA启动后立即执行代理任务。 -- `通过邮件通知结果`：在AUTO_MAA完成任务后将结果发送至用户指定邮箱。 -- `检查版本更新`：从GitHub镜像源获取版本更新信息，并调起更新器完成程序更新，更新器已支持多个代理地址。 -- `修改管理密钥`：修改管理密钥，当用户列表中无用户时，将跳过验证旧管理密钥。 #### 设置用户配置 -本项目已基本完成GUI开发，您可以直接在用户管理页配置用户相关信息，页面简介如下： -- `新建`、`删除`：新建一个用户到当前用户配置列表、删除当前所选第一行所对应的用户。 -- `转为高级/简洁`：将当前所选第一行所对应的用户转为高级/简洁配置模式。 +每一个脚本实例都有独立的用户数据库，您可以直接在`用户列表`选项卡配置用户相关信息，页面简介如下： +- `新建用户`、`删除用户`：新建一个用户到当前用户配置列表、删除当前所选第一行所对应的用户。 +- `向上移动`、`向下移动`：移动用户位置，用户位置即代理顺序。 +- `模式转换`：将当前所选第一行所对应的用户转为高级/简洁配置模式。 +- `用户选项配置`：选择用户与对应配置项目，执行对应配置流程。 + - `自定义基建`：选择自定义基建配置文件。 + - `日常`、`剿灭`：打开MAA界面进行设置，设置方法与MAA全局配置相同。 - `显示密码`：输入管理密钥以显示用户密码，仅当管理密钥正确时能够修改`密码栏目`。 -- `刷新`：清除临时保存的管理密钥。 - `简洁用户配置列表`：仅支持核心代理选项的设置，其它设置选项沿用MAA的全局设置，部分代理核心功能选项由程序托管。 -- `高级用户配置列表`：支持几乎所有代理选项的设置，通过`修改配置`进行MAA自定义，仅部分代理核心功能选项由程序托管。 -- `用户配置列表栏目`：详解如下： +- `高级用户配置列表`：支持几乎所有代理选项的设置，通过`用户选项配置`进行MAA自定义，仅部分代理核心功能选项由程序托管。 +- `用户配置列表栏目`详解如下： - `用户名`：展示在执行界面的用户名，用于区分不同用户。 - `账号ID`：MAA进行账号切换所需的凭据，官服用户请输入手机号码、B服请输入B站ID。 - `服务器`：当前支持官服、B服。 @@ -165,25 +153,35 @@ MAA多账号管理与自动化软件 - 程序会读取`data/gameid.txt`中的数据，依据此进行关卡号的替换，便于常用关卡的使用。 - `gameid.txt`会在程序首次运行时生成，其中将预置一些常用资源本的替换方案。 +#### 设置调度队列 + +- 单个调度队列可包含至多10个定时与至多10个任务实例。 +- 调度队列状态为关闭时，将不会定时启动该调度队列，但仍能在主调度台直接运行该调度队列。 +- 同一调度队列内任务实例被依次挨个调起运行，非同一调度队列内的不同任务实例可被同时调起。 +- 同一时间内，任何脚本实例或调度队列都不会被重复调起，若某一任务运行时发现同一任务已在运行，将自动跳过。 + +#### 设置AUTO_MAA + +- 详见软件中对应选项卡的注解。 + ![gameid](https://github.com/DLmaster361/AUTO_MAA/blob/main/resources/images/README/gameid.png "gameid") ## 运行代理任务 ### 直接运行 -- 在执行页单击`立即执行`直接运行。 +- 在`调度中心`的`主调度台`选择对应任务与`自动代理`模式，单击`开始任务`即可开始代理。 ### 定时运行 -- 在执行页的`定时执行`栏设置时间。 - -- 保持软件打开，软件会在设定的时间自动运行。 +- 将调度队列状态设为开启，并在`定时`选项卡设置定时启动时间。 +- 保持软件开启，软件会在设定的时间自动运行。 ## 人工排查代理结果 ### 直接开始人工排查 -- 在执行页单击`开始排查`启动排查进程。 +- 在`调度中心`的`主调度台`选择对应任务与`人工排查`模式，单击`开始任务`即可开始人工排查。 - 软件将调起MAA，依次登录各用户的账号。 @@ -202,7 +200,8 @@ MAA多账号管理与自动化软件 - [ ] 尝试接入更多开源社区成果 - [ ] 支持对MAA运行状况的进一步识别 - [x] 添加更多通知手段 -- [ ] GUI界面美化 +- [x] GUI界面美化 +- [ ] 软件相关web功能开发 ## 贡献者