Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .vitepress/config/en.ts
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@ export const enThemeConfig: DefaultTheme.Config = {
text: "Advanced Features",
link: "/en/docs/advanced-features/",
items: [
{ text: "Game Check-in", link: "/en/docs/advanced-features/game-sign" },
{ text: "Emulator Management", link: "/en/docs/advanced-features/emulator" },
{ text: "Notifications", link: "/en/docs/advanced-features/notification" },
{ text: "MCP Service", link: "/en/docs/advanced-features/mcp" },
Expand Down
85 changes: 39 additions & 46 deletions docs/FAQ.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,8 @@
# 常见问题

更多问题请参考 <Pill name="AUTO-MAS GitHub Issues" :image="{ light: '/icons/github.svg', dark: '/icons/github-dark.svg', }" link="https://github.com/AUTO-MAS-Project/AUTO-MAS/issues"/> 。
这里没有的问题,去 <Pill name="AUTO-MAS GitHub Issues" :image="{ light: '/icons/github.svg', dark: '/icons/github-dark.svg', }" link="https://github.com/AUTO-MAS-Project/AUTO-MAS/issues"/> 翻一下

脚本软件问题请阅读脚本文档或咨询脚本开发者
如果问题出在脚本本身(比如 MAA 识别不出关卡),那是脚本的事,请查该脚本的文档或问脚本作者——AUTO-MAS 只负责调度它们。

## 疑问解答

Expand All @@ -11,89 +11,82 @@
- 代肝用 AUTO-MAS 就是利好代肝,用户用 AUTO-MAS 就是利好用户。
- 而且 AUTO-MAS 的传播范围越广,就越利好用户,所以还不快帮 AUTO-MAS 宣传一波!

### 我的数据(账号密码)安全吗
### 我的账号密码安全吗

为了确保您的敏感信息(如登录凭据、访问令牌等)在本地安全存储,我们使用了 **Windows 数据保护 API(DPAPI)**
安全。你填的密码、Token 这类东西,是交给 Windows 自带的加密功能(DPAPI)加密后存在本地的,AUTO-MAS 不会把它们传到任何服务器

**DPAPI** 是 Windows 提供的一套用于加密和解密敏感数据的本地安全机制,主密钥(Master Key)由用户的登录密码(或系统启动密钥)派生而来,并通过操作系统内核保护,不会明文暴露给应用程序。这意味着
这套加密和你的 Windows 登录账号绑在一起,所以

- 只有您本人登录 **Windows 账号** 时,程序才能解密这些数据。
- 即使他人复制了配置文件,也无法在其他电脑或账户中解密数据。
- 加解密过程和密钥管理完全由 Windows 系统自动处理,安全且可靠。
- 只有你本人登录这台电脑的这个 Windows 账号时,程序才解得开。
- 别人就算把配置文件整个拷走,换台电脑也解不开。

::: warning 警告
在以下情况下,系统可能无法解密原有数据
::: warning 代价是:换环境就解不开了
下面三种情况,旧的密码数据会失效,需要你重新填一遍。这不是 bug

1. **更换或重装系统**
如果您重新安装 Windows 或使用新的电脑账户,原账户的加密密钥将丢失,程序将无法读取旧数据。
2. **删除或重置用户账户密码**
DPAPI 的加密密钥与您的 Windows 登录凭据绑定。
如果您使用非正常方式重置密码(如离线修改、系统修复工具修改等),Windows 无法重新解密旧的加密文件。
3. **复制数据到其他电脑或账户**
DPAPI 加密的数据仅在原账户和计算机上有效。复制配置文件到其他环境时,数据会因密钥不匹配而无法解密。
1. **重装系统,或换了新的 Windows 账户** —— 旧账户的密钥没了。
2. **用非正常手段重置了 Windows 登录密码**(离线改密、系统修复工具改密等)——正常在系统里改密码没问题,绕过系统改就会丢。
3. **把配置拷到别的电脑或别的 Windows 账户下用** —— 加密数据只在原来那台电脑的原账户下有效。
:::

## 故障排查

### 后端启动失败,跳过后应用内不停报错 Network Error
### 软件一直在报 Network Error

在前端报错页面或打开 `debug/app.log` 查看错误信息。
这说明后端没起来。先在报错页面上,或者打开 `debug/app.log`,找到具体错误,再对着下面处理:

- **[Errno 10048] error while attempting to bind on address ('0.0.0.0', 36163): 通常每个套接字地址(协议/网络地址/端口)只允许使用一次。**
- **`[Errno 10048] error while attempting to bind on address ('0.0.0.0', 36163)`**

**端口被占用**,AUTO-MAS 后端默认端口为 `36163`,请检查端口是否被占用
端口被别的程序占了。AUTO-MAS 后端用的是 `36163` 端口,查一下是谁占着,把它关掉

- **ModuleNotFoundError: No module named 'xxx'**
- **`ModuleNotFoundError: No module named 'xxx'`**

**缺少依赖**,删除软件根目录下 `environment/.requirements_hash` 文件并重启软件,仍无法解决请删除 `environment` 文件夹并重启软件
依赖没装全。删掉安装目录下的 `environment/.requirements_hash` 再重启软件,让它重装一遍。还不行就把整个 `environment` 文件夹删掉重启

- **ImportError: DLL load failed while importing onnxruntime_pybind11_state: 动态链接库(DLL)初始化例程失败。**
- **`ImportError: DLL load failed while importing onnxruntime_pybind11_state`**

**缺少系统环境**,AUTO-MAS 运行依赖于 **Microsoft Visual C++** 系统环境,若缺失该环境,您需要手动从 [Microsoft Visual C++](https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-supported-redistributable-version) 或直接从 [Microsoft Visual C++ x64](https://aka.ms/vc14/vc_redist.x64.exe) 中下载并安装
系统缺 **Microsoft Visual C++ 运行库**。装一下就好:[直接下载 x64 版](https://aka.ms/vc14/vc_redist.x64.exe)(或从 [微软官方页面](https://learn.microsoft.com/zh-cn/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-supported-redistributable-version) 挑版本)

::: tip 注意
::: tip 报错页面和日志里都看不到错误怎么办

若前端报错页面与日志文件中均为发现报错日志,请以管理员身份运行终端(或 PowerShell、CMD),执行以下命令
手动跑一次后端,把错误逼出来。以管理员身份打开终端(PowerShell 或 CMD),执行

```bash
cd {AUTO-MAS 根目录}
.\environment\python\python.exe main.py
```

其中 `{AUTO-MAS 根目录}` 需要自行替换为 AUTO-MAS 安装目录位置。

此时终端会输出错误日志,请据此进行故障排查。
`{AUTO-MAS 根目录}` 换成你的实际安装路径。终端里打出来的报错,就是排查线索。

:::

### 模拟器启动失败

- AUTO-MAS 启动的所有脚本与应用都将带有 **管理员权限**。由于模拟器多开时,一部分模拟器实例无管理员权限时,无法以管理员权限启动新的模拟器实例,您需要保证当前所有模拟器实例都以管理员权限启动,包括模拟器多开器。具体操作如下:
原因基本都是权限不一致。AUTO-MAS 启动的脚本和模拟器一律带管理员权限,但如果此时已经有模拟器实例是用普通权限开着的,就没法再以管理员权限启动新实例了。所以**只要有一个实例是普通权限开的,后面的多开就会失败**。

1. 关闭所有模拟器实例与模拟器多开器
2. AUTO-MAS 重新启动任务,检查能否正常运行,若仍无法运行,尝试重启电脑后直接在 AUTO-MAS 中启动任务
3. 后续使用模拟器或模拟器多开器时,请 **右键 > 以管理员身份运行**。为方便使用,您可以考虑创建对应快捷方式,并 **右键 > 属性 > 快捷方式 > 高级 > 勾选用管理员身份运行**
1. 把所有模拟器实例和多开器全部关掉
2. AUTO-MAS 重新启动任务。还不行就重启电脑,然后直接从 AUTO-MAS 启动,中间别手动开模拟器
3. 以后自己手动开模拟器和多开器时,都要 **右键 > 以管理员身份运行**。嫌麻烦就给它建个快捷方式,**右键 > 属性 > 快捷方式 > 高级 > 勾选"用管理员身份运行"**,之后双击就是管理员权限

### 为什么 AUTO-MAS 无法打开 MAA 设置窗口?
### 点了配置 MAA,但 MAA 窗口没出来

- 若您在 MAA 中启用了 **启动 MAA 后直接最小化** **最小化时隐藏至托盘**,请您从托盘区找到 MAA 后继续配置。若您认为该操作过于费时,可尝试启用 **静默模式**。
MAA 大概是躲到托盘里去了。如果你在 MAA 里开了 **启动后直接最小化** **最小化时隐藏至托盘**,就会这样——去右下角托盘区把它点出来继续配。觉得每次都这样太烦,可以改用 **静默模式**。

### 脚本配置时报错:主程序必须是脚本根目录的子路径
### 报错"主程序必须是脚本根目录的子路径"

- 请先检查你的 **脚本根目录** 选项是否正确,你必须先设定此值,才能设置主程序路径等路径
**脚本根目录** 没设或者设错了。这个值是其他路径的基准,必须先把它设对,才能设主程序路径。

### **如何安全保存 MAA 的设置?**
### MAA 的设置怎么才算保存成功?

- 请在 AUTO-MAS 中进行 MAA 配置,并在完成配置后点击 **保存配置**。
AUTO-MAS 里点进去配 MAA,配完回到 AUTO-MAS 点 **保存配置**。绕过 AUTO-MAS 直接开 MAA 改的设置,不会被记录

### **打开静默模式后模拟器仍未能自动最小化?**
### 开了静默模式,模拟器却没最小化

- 请检查是否正确填写模拟器老板键,并确认是否存在按键冲突情况
检查模拟器 **老板键** 填对了没,以及这个按键有没有被别的软件抢走(快捷键冲突)

### **调度队列为何没有自动运行?**
### 调度队列到点了却没自动跑

- 请确认调度队列的 **定时运行** 已 **开启**,并且 **软件未被意外关闭**,任何睡眠休眠等情况均无法运行AUTO-MAS(见下)。
两件事挨个查:**定时运行** 的开关是不是真的启用了;软件是不是被关掉了,或者电脑睡眠/休眠了(见下条)。

### 可以休眠/睡眠运行 AUTO-MAS 吗
### 睡眠 / 休眠状态下能跑吗

- **不能**,已知的所有脚本都不支持在睡眠/休眠中运行
**不能。** 睡眠休眠时程序整个是停住的,目前所有脚本都不支持这么用。要定时跑就得让电脑保持唤醒
56 changes: 21 additions & 35 deletions docs/advanced-features/emulator.md
Original file line number Diff line number Diff line change
@@ -1,49 +1,35 @@
# 模拟器管理

模拟器管理是MAS的特色功能,用以一劳永逸的解决部分因为模拟器和模拟器适配相关的各种bug
在这里把模拟器登记一次,各个脚本的模拟器相关配置就由 AUTO-MAS 统一填写,不用你一个个脚本手动对。多开、连不上之类的老问题多半就此解决。

![notification-1](../img/advanced-features/emulator-1.png)

*图中内容为示例内容,需进行配置才会如此*

## 搜索模拟器

初次进行配置时,可以进行自动搜索和手动搜索,如果你使用自动搜索多开器,点一下就行。
说白了它就是个多开器:用命令行问模拟器要到实例信息(端口、实例号等),再自动填进各脚本的配置里。

MAS会自动搜索安装在 **默认安装路径** 下的模拟器。

如果你修改了默认地址,就无法找到,需要进行手动添加。
![notification-1](../img/advanced-features/emulator-1.png)

让我们先解释以下配置
*图中是示例内容,你需要自己配置*

## 配置解释
## 添加模拟器

**模拟器名称**:字面意思,仅存在于MAS中给你看的
点自动搜索就行——AUTO-MAS 会扫 **默认安装路径**。

**模拟器类型**:模拟器软件名,如mumu模拟器/雷电模拟器,有下拉框可以选择
如果你装模拟器时改过安装位置,自动搜索找不到,得手动添加。

::: tip 最佳实践
## 各项配置怎么填

AUTO-MAS 强烈推荐使用mumu12或雷电模拟器,因其拥有良好的性能和截图效果并且多开器适配完善,如果你从零安装模拟器,务必考虑。
| 配置项 | 填什么 |
| --- | --- |
| **模拟器名称** | 随便起,只在 AUTO-MAS 里显示给你自己看 |
| **模拟器类型** | 从下拉框选你用的是哪款,如 MuMu / 雷电 |
| **模拟器路径** | 选**多开器**的位置,不是模拟器主程序 |
| **最大等待时间** | 等模拟器启动多久。模拟器起来之后才会启动脚本,机器慢就调大 |
| **老板键** | 静默模式下 AUTO-MAS 会自动按这个键把模拟器藏起来 |

::: tip 常见的多开器路径
- MuMu12 v4:`mumu安装目录\shell\MuMuManager.exe`
- MuMu12 v5:`mumu安装目录\nx_main\MuMuManager.exe`
- 雷电:`雷电安装目录\LDPlayer9\dnplayer.exe`
:::

**模拟器路径**:对应软件的模拟器**多开器**所在目录

::: tip 常见模拟器路径

mumu12v4:mumu安装目录\shell\MuMuManager.exe

mumu12v5:mumu安装目录\nx_main\MuMuManager.exe

雷电模拟器:雷电安装目录\LDPlayer9\dnplayer.exe

::: tip 还没装模拟器的话,选 MuMu12 或雷电
这两款性能和截图效果都不错,多开器适配也最完善,AUTO-MAS 对它们的支持最好。用别的模拟器可能会遇到没人踩过的坑。
:::

**最大等待时间**:即脚本使用此模拟器时,等待多久模拟器才会启动,模拟器启动后才会启动脚本程序

**老板键**:如果使用静默模式,则会自动按下

## 碎碎念

模拟器管理的本质就是一个多开器,通过一系列的命令行命令来获得模拟器的各项信息,然后自动填入进对应脚本的配置项里。
Loading