docs: 更新用户手册

MaaXYZ · Jan 5, 2025 · dd3ac38 · dd3ac38
1 parent 8bfd13a
commit dd3ac38
Show file tree

Hide file tree

Showing 5 changed files with 120 additions and 56 deletions.
diff --git a/README.md b/README.md
@@ -20,13 +20,13 @@
 
 ## 使用说明
 
-- [新手上路](./docs/zh_cn/manual/%E6%96%B0%E6%89%8B%E4%B8%8A%E8%B7%AF.md)(必看)
+- [新手上路](./docs/zh_cn/manual/%E6%96%B0%E6%89%8B%E4%B8%8A%E8%B7%AF.md)(**使用前必看**)
 
-- [部分功能介绍](./docs/zh_cn/manual/%E9%83%A8%E5%88%86%E5%8A%9F%E8%83%BD%E4%BB%8B%E7%BB%8D.md)(推荐)
+- [功能介绍](./docs/zh_cn/manual/%E5%8A%9F%E8%83%BD%E4%BB%8B%E7%BB%8D.md)
 
-- [连接设置](./docs/zh_cn/manual/%E8%BF%9E%E6%8E%A5%E8%AE%BE%E7%BD%AE.md)(推荐)
+- [连接设置](./docs/zh_cn/manual/%E8%BF%9E%E6%8E%A5%E8%AE%BE%E7%BD%AE.md)
 
-- [常见问题](./docs/zh_cn/manual/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98.md)(推荐)
+- [常见问题](./docs/zh_cn/manual/%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98.md)
 
 ## 开发相关
 

diff --git a/docs/zh_cn/manual/部分功能介绍.md → docs/zh_cn/manual/功能介绍.md b/docs/zh_cn/manual/部分功能介绍.md → docs/zh_cn/manual/功能介绍.md
@@ -1,4 +1,15 @@
-# 部分功能介绍
+# 功能介绍
+
+- [功能介绍](#功能介绍)
+  - [每日心相（意志解析）](#每日心相意志解析)
+  - [自动深眠](#自动深眠)
+  - [轶事派遣](#轶事派遣)
+  - [切换账号](#切换账号)
+  - [局外演绎：黄昏的音序](#局外演绎黄昏的音序)
+    - [速刷模式](#速刷模式)
+    - [非速刷模式](#非速刷模式)
+      - [置顶演示](#置顶演示)
+      - [置顶成功](#置顶成功)
 
 ## 每日心相（意志解析）
 
@@ -22,8 +33,7 @@
 
 > [!WARNING]
 >
-> 1. 由于深眠的特点，请不要选择上下半为同一编队
-> 2. ~~深眠闪退请关闭GPU加速，详情请看[常见问题-运行自动深眠闪退](./常见问题.md#运行自动深眠闪退)~~
+> 由于深眠的特点，请不要上下半选择同一编队
 
 ## 轶事派遣
 
@@ -36,12 +46,21 @@
 
 ## 切换账号
 
-本功能仅会切换当前最后一个账号（超过3个的账号会忽略），切换后可继续添加任务，以便多账号定制化运行任务。
+本功能仅会切换当前最后一个账号（超过3个的账号会忽略）。  
+切换后可继续添加任务，以便多账号多配置运行任务。
 
 ## 局外演绎：黄昏的音序
 
 最有用的肉鸽刷取信用功能。
 
+### 速刷模式
+
+> [!NOTE]
+>
+> 1. 使用速刷功能前请先将 `刻画生长-指引之歌` 点满
+> 2. 请尽量调高难度等级，以防止分数不够导致刷取信物失败
+> 3. 调整难度的方法为手动选择等级后到第一个节点再退出
+
 ### 非速刷模式
 
 > [!TIP]
@@ -56,7 +75,7 @@
 > 2. M9A不对仅在初次玩肉鸽出现的剧情、引导等做额外处理，使用前需先自行通关一遍
 
 > [!NOTE]
-> 由于本功能实现较为复杂，容易出现奇怪的问题。如果有条件请开启模拟器的录屏，发现问题时尽量保留足够的证据（`debug`目录下`maa.log`、问题发生时间、录屏/截图），以便开发者快速定位问题并解决。[提交问题点击此处](https://github.com/MaaXYZ/M9A/issues/new/choose)
+> 由于本功能实现较为复杂，容易出现奇怪的问题。如果有条件请开启模拟器的录屏，发现问题时尽量保留足够的信息（`debug`目录下`maa.log`、问题发生时间、录屏/截图），以便开发者快速定位问题并解决。[提交问题点击此处](https://github.com/MaaXYZ/M9A/issues/new/choose)
 
 #### 置顶演示
 
@@ -65,8 +84,3 @@
 #### 置顶成功
 
 ![置顶成功](https://github.com/user-attachments/assets/d88fea79-df1b-4651-9d6d-386a40bf3b55)
-
-### 速刷模式
-
-> [!NOTE]
-> 使用速刷功能前请先将 `刻画生长-指引之歌` 点满
diff --git a/docs/zh_cn/manual/常见问题.md b/docs/zh_cn/manual/常见问题.md
@@ -1,16 +1,36 @@
 # 常见问题
 
+- [常见问题](#常见问题)
+  - [软件无法运行/闪退/报错](#软件无法运行闪退报错)
+    - [下载/安装问题](#下载安装问题)
+    - [运行库问题](#运行库问题)
+    - [资源加载问题](#资源加载问题)
+    - [连接问题](#连接问题)
+      - [1. 确认 ADB 及连接地址正确](#1-确认-adb-及连接地址正确)
+      - [2. 关闭现有 ADB 进程](#2-关闭现有-adb-进程)
+      - [3. 正确使用多个 ADB](#3-正确使用多个-adb)
+      - [4. 更换触控方式](#4-更换触控方式)
+      - [5. 改用 MaaPiCli](#5-改用-maapicli)
+      - [6. 避免游戏加速器](#6-避免游戏加速器)
+      - [7. 重启电脑](#7-重启电脑)
+      - [8. 换模拟器](#8-换模拟器)
+  - [文件下载速度慢](#文件下载速度慢)
+  - [其他问题](#其他问题)
+
 ## 软件无法运行/闪退/报错
 
+大部分的问题都能在这个章节解决。  
+分成下载/安装问题、运行库问题、资源加载问题以及连接问题四类。  
+其中大部分问题都属于**运行库问题**和**连接问题**。
+
 ### 下载/安装问题
 
-- 完整 M9A 软件压缩包命名格式为 "M9A-`平台`-`架构`-`版本`.zip"，其余均为无法单独使用的“零部件”，请仔细阅读。
-  在大部分情况下，您需要使用 x64 架构的 M9A，即您需要下载 `M9A-win-x86_64-vXXX.zip`，而非`M9A-win-aarch64-vXXX.zip`。
-- 若在某次更新后无法使用，可能是您覆盖安装造成的, 请尝试重新(下载)解压完整包后新文件夹。
+完整 M9A 软件压缩包命名格式为 "M9A-`平台`-`架构`-`版本`.zip"，其余均为无法单独使用的“零部件”，请仔细阅读。  
+在大部分情况下，您需要使用 x64 架构的 M9A，即您需要下载 `M9A-win-x86_64-vXXX.zip`，而非`M9A-win-aarch64-vXXX.zip`。
 
 ### 运行库问题
 
-特征：
+有以下特征时，说明需要更新运行库：
 
 1. 使用 MFAWPF 时，出现
 
@@ -27,61 +47,57 @@
 
 以上一般便是运行库问题，需要[更新运行库](./新手上路.md#2-安装运行库)
 
-若更新运行库后仍然无法解决，以上两种启动方法均闪退，且在当前目录不生成任何日志文件，则是其它依赖相关问题。  
+若更新运行库后仍然无法解决，以上两种启动方法均**闪退**，且在当前目录不生成任何日志文件，则是其它依赖相关问题。  
 请到[项目Issues页面](https://github.com/MaaXYZ/M9A/issues)反馈。
 
-### 资源加载失败
+### 资源加载问题
 
-删除整个文件夹，[重新下载](https://github.com/MaaXYZ/M9A/releases)安装 M9A 。
+问题出现时提示**资源加载失败**。  
+解决方法是删除整个文件夹，然后[重新下载](https://github.com/MaaXYZ/M9A/releases)安装 M9A 。
 
-## 运行自动深眠闪退
+### 连接问题
 
-> [!NOTE]
->
-> 原问题链接: [自动深眠闪退](https://github.com/MaaXYZ/M9A/issues/242)
->
-> 解决方案:
->
-> 使用MaaPiCli： 将 `config/maa_pi_config.json` 里的 `gpu` 字段改成 -2，即使用 CPU。
->
-> 使用MFAWPF：在[设置]-[高级设置]里将[启用gpu加速]取消勾选
-
-## 连接错误
+问题出现时提示**连接模拟器时发生错误**。  
+造成连接失败有很多原因，请按下面的步骤一步步尝试。
 
-### 确认 ADB 及连接地址正确
+#### 1. 确认 ADB 及连接地址正确
 
 参阅 [连接设置](./连接设置.md#连接设置)
 
 > [!TIP]
 >
 > 不要连到别的模拟器/设备去了！
 
-### 关闭现有 ADB 进程
+#### 2. 关闭现有 ADB 进程
 
 关闭 M9A 后查找 `任务管理器` - `详细信息` 中有无名称包含 `adb` 的进程，如有，结束它后重试连接。
 
-### 正确使用多个 ADB
+#### 3. 正确使用多个 ADB
 
 当 ADB 版本不同时，新启动的进程会关闭旧的进程。因此在需要同时运行多个 ADB，如 Android Studio、Alas、手机助手时，请确认它们的版本相同。
 
-### 改用 MaaPiCli
+#### 4. 更换触控方式
+
+部分模拟器（如蓝叠中国、夜神等）可能 adb 版本较低，可以尝试更换 adb 或更换触控方式。
+
+#### 5. 改用 MaaPiCli
 
-若您使用 MFAWPF 连接失败，请尝试改用 MaaPiCli 。
-[原问题链接](https://github.com/SweetSmellFox/MFAWPF/issues/54)
+若您使用 MFAWPF 连接失败，请尝试改用 MaaPiCli。
 
-### 避免游戏加速器
+#### 6. 避免游戏加速器
 
 部分加速器在启动加速和停止加速之后，都需要重启 MAA、ADB 和模拟器再连接。
 
 同时使用 UU 加速器 和 MuMu 12 可以参考[官方文档](https://mumu.163.com/help/20240321/35047_1144608.html)。
 
-### 重启电脑
+#### 7. 重启电脑
 
 重启能解决 97% 的问题。（确信
 
-### 换模拟器
+#### 8. 换模拟器
 
-请参阅 [模拟器和设备支持](https://maa.plus/docs/zh-cn/manual/device/)。
+请参阅 [模拟器和设备支持](https://maa.plus/docs/zh-cn/manual/device/)。  
+通常来说，建议使用 MuMu 或雷电。
 
 ## 文件下载速度慢
 

diff --git a/docs/zh_cn/manual/新手上路.md b/docs/zh_cn/manual/新手上路.md
@@ -1,5 +1,21 @@
 # 新手上路
 
+- [新手上路](#新手上路)
+  - [前置准备](#前置准备)
+    - [1. 确认版本系统](#1-确认版本系统)
+    - [2. 安装运行库(Windows)](#2-安装运行库windows)
+    - [3. 下载正确的版本](#3-下载正确的版本)
+      - [Windows](#windows)
+      - [macOS](#macos)
+      - [Linux](#linux)
+      - [Android](#android)
+    - [4. 正确解压](#4-正确解压)
+    - [5. 确认模拟器支持](#5-确认模拟器支持)
+    - [6. 正确设置模拟器分辨率](#6-正确设置模拟器分辨率)
+  - [初始配置](#初始配置)
+  - [进阶使用](#进阶使用)
+  - [相关文档](#相关文档)
+
 ## 前置准备
 
 ### 1. 确认版本系统
@@ -33,19 +49,19 @@ M9A 下载（更新）地址：<https://github.com/MaaXYZ/M9A/releases>
 
 #### Windows
 
-* 对于**绝大部分**用户，请下载 `M9A-win-x86_64-vXXX.zip`
-* 若确定自己的电脑是 arm 架构，请下载 `M9A-win-aarch64-vXXX.zip`
+- 对于**绝大部分**用户，请下载 `M9A-win-x86_64-vXXX.zip`
+- 若确定自己的电脑是 arm 架构，请下载 `M9A-win-aarch64-vXXX.zip`
 
 > [!WARNING]
 > 请注意！Windows 的电脑几乎全都是 x86\_64 的，可能占 99.999%，除非你非常确定自己是 arm，否则别下这个！
 
-* 解压后运行 `MaaPiCli.exe`（命令行）或 `MFAWPF.exe`（图形化界面）即可
+- 解压后运行 `MaaPiCli.exe`（命令行）或 `MFAWPF.exe`（图形化界面）即可
 
 #### macOS
 
-* 若使用 Intel 处理器，请下载 `M9A-macos-x86_64-vXXX.zip`
-* 若使用 M1, M2 等 arm 处理器，请下载 `M9A-macos-aarch64-vXXX.zip`
-* 使用方式：
+- 若使用 Intel 处理器，请下载 `M9A-macos-x86_64-vXXX.zip`
+- 若使用 M1, M2 等 arm 处理器，请下载 `M9A-macos-aarch64-vXXX.zip`
+- 使用方式：
 
   ```shell
   chmod a+x MaaPiCli
@@ -58,7 +74,8 @@ M9A 下载（更新）地址：<https://github.com/MaaXYZ/M9A/releases>
 
 #### Android
 
-[相关疑问](https://github.com/MaaXYZ/MaaFramework/issues/475)
+~~一般人用不到~~
+[使用方法](https://github.com/MaaXYZ/MaaFramework/issues/475)
 
 ### 4. 正确解压
 
@@ -84,8 +101,11 @@ M9A 下载（更新）地址：<https://github.com/MaaXYZ/M9A/releases>
 
 ## 进阶使用
 
-* 添加 `-d` 参数可跳过交互直接运行任务，如 `./MaaPiCli.exe -d`
-* 2.0 版本已支持 mumu 后台保活，会在 run task 时获取 mumu 最前台的 tab，并始终使用这个 tab（即使之后被切到后台了）
-* [连接设置](./连接设置.md#连接设置)
-* [部分功能介绍](./部分功能介绍.md)
-* [常见问题](./常见问题.md)
+- 添加 `-d` 参数可跳过交互直接运行任务，如 `./MaaPiCli.exe -d`
+- 2.0 版本已支持 mumu 后台保活，会在 run task 时获取 mumu 最前台的 tab，并始终使用这个 tab（即使之后被切到后台了）
+
+## 相关文档
+
+- [连接设置](./连接设置.md#连接设置)——介绍了adb连接以及模拟器设置
+- [功能介绍](./功能介绍.md)——介绍了部分功能的注意事项
+- [常见问题](./常见问题.md)——介绍了常见问题及解决策略
diff --git a/docs/zh_cn/manual/连接设置.md b/docs/zh_cn/manual/连接设置.md
@@ -1,5 +1,20 @@
 # 连接设置
 
+- [连接设置](#连接设置)
+  - [自动检测](#自动检测)
+  - [ADB 路径](#adb-路径)
+    - [使用模拟器提供的 ADB](#使用模拟器提供的-adb)
+    - [使用谷歌提供的 ADB](#使用谷歌提供的-adb)
+  - [连接地址](#连接地址)
+    - [模拟器相关文档及参考地址](#模拟器相关文档及参考地址)
+    - [获取多开端口](#获取多开端口)
+  - [触控模式](#触控模式)
+  - [M9A 和模拟器多开](#m9a-和模拟器多开)
+  - [MFAWPF 特殊设置](#mfawpf-特殊设置)
+    - [adb 额外参数](#adb-额外参数)
+    - [模拟器启动参数](#模拟器启动参数)
+    - [更新功能](#更新功能)
+
 ## 自动检测
 
 M9A 可以通过当前**正在运行的单个模拟器**自动检测并填充 ADB 路径、连接地址和连接配置。
@@ -21,7 +36,6 @@ M9A 可以通过当前**正在运行的单个模拟器**自动检测并填充 AD
 > 自动检测使用的是模拟器的 ADB，但有时自动检测会出现问题，此时就需要手动设置。  
 > `强制替换 ADB` 是下载谷歌提供的 ADB 后再进行替换，如果自己设置谷歌的 ADB 即可一劳永逸。
 
-
 ### 使用模拟器提供的 ADB
 
 前往模拟器安装路径，Windows 可在模拟器运行时在任务管理器中右键进程点击 `打开文件所在的位置`。