docs: 升级依赖，调整视觉效果 (#8202)

docs: 升级依赖，调整视觉效果
2026-07-16 17:57:01 +08:00 · 2024-02-07 23:27:38 +08:00
parent 369b57ec38 e22aa3a217
commit bab14c12bd
8 changed files with 2542 additions and 16171 deletions
--- a/docs/.vuepress/config.ts
+++ b/docs/.vuepress/config.ts
@@ -1,35 +1,35 @@
-import { defineUserConfig } from 'vuepress';
-import Theme from './theme';
-import SearchPlugin from './plugins/search';
+import { defineUserConfig } from "vuepress";
+import { viteBundler } from "@vuepress/bundler-vite";
+import Theme from "./theme";

 export default defineUserConfig({
-  base: '/docs/',
+  base: "/docs/",
  lang: "zh-CN",
  title: "MaaAssistantArknights",
  description: "MAA",
  port: 3001,

  locales: {
-    '/': {
-      lang: 'zh-CN',
-      description: '开发者文档',
+    "/": {
+      lang: "zh-CN",
+      description: "开发者文档",
    },
-    '/zh-tw/': {
-      lang: 'zh-TW',
-      description: '開發者文件',
+    "/zh-tw/": {
+      lang: "zh-TW",
+      description: "開發者文件",
    },
-    '/en-us/': {
-      lang: 'en-US',
-      title: 'Documents'
+    "/en-us/": {
+      lang: "en-US",
+      title: "Documents",
    },
-    '/ja-jp/': {
-      lang: 'ja-JP',
-      description: 'ドキュメント'
+    "/ja-jp/": {
+      lang: "ja-JP",
+      description: "ドキュメント",
+    },
+    "/ko-kr/": {
+      lang: "ko-KR",
+      description: "문서",
    },
-    '/ko-kr/': {
-      lang: 'ko-KR',
-      description: '문서'
-    }
  },

  markdown: {
@@ -40,7 +40,39 @@ export default defineUserConfig({

  theme: Theme,

-  plugins: [
-    SearchPlugin(),
+  plugins: [],
+
+  head: [
+    ["link", { rel: "preconnect", href: "https://fonts.googleapis.com" }],
+    [
+      "link",
+      { rel: "preconnect", href: "https://fonts.gstatic.com", crossorigin: "" },
+    ],
+    [
+      "link",
+      {
+        href: "https://fonts.googleapis.com/css?family=Noto+Sans+SC:300,400,500,700,900&display=swap",
+        rel: "stylesheet",
+      },
+    ],
+    [
+      "link",
+      {
+        href: "https://fonts.googleapis.com/css2?family=Noto+Serif+SC:400;500;700&display=swap",
+        rel: "stylesheet",
+      },
+    ],
+    [
+      "link",
+      {
+        href: "https://fonts.googleapis.com/css2?family=Jetbrains+Mono:wght@300,400,500,700;700&display=swap",
+        rel: "stylesheet",
+      },
+    ],
  ],
+
+  bundler: viteBundler({
+    viteOptions: {},
+    vuePluginOptions: {},
+  }),
 });
--- a/docs/.vuepress/plugins/search.ts
+++ b/docs/.vuepress/plugins/search.ts
@@ -1,7 +1,4 @@
-import { docsearchPlugin } from "@vuepress/plugin-docsearch";
-
-export default function SearchPlugin() {
-  return docsearchPlugin({
+export default {
    appId: '99JM20SIFG',
    apiKey: '32ad931040facd36d2e99c3cb8e425e1',
    indexName: 'maa',
@@ -123,6 +120,5 @@ export default function SearchPlugin() {
      '/ja-jp/': {
        placeholder: '検索する',
      }
-    }
-  })
+  }
 }
--- a/docs/.vuepress/styles/palette.scss
+++ b/docs/.vuepress/styles/palette.scss
@@ -1,7 +1,9 @@
 $sidebar-width: 16rem;
 $content-width: 1000px;

-$font-family-mono: '"Sarasa Gothic", "Jetbrains mono", consolas';
+$font-family: '-apple-system, BlinkMacSystemFont, "Noto Sans SC", "Segoe UI", Roboto, Oxygen, Ubuntu, Cantarell, "Fira Sans", "Droid Sans", "Helvetica Neue", STHeiti, "Microsoft YaHei", sans-serif';
+$font-family-heading: 'Georgia, -apple-system, "Nimbus Roman No9 L", "PingFang SC", "Hiragino Sans GB", "Noto Serif SC", "Microsoft Yahei", "WenQuanYi Micro Hei", "ST Heiti", sans-serif';
+$font-family-mono: '"Sarasa Gothic", "Jetbrains mono", "Fira Code", "Noto Sans SC", Consolas, monospace';

 html[lang="ja-JP"] {
  $font-family: "Helvetica Neue, Arial, Hiragino Kaku Gothic ProN, Hiragino Sans, Meiryo, sans-serif";
--- a/docs/.vuepress/theme.ts
+++ b/docs/.vuepress/theme.ts
@@ -1,4 +1,5 @@
 import { hopeTheme } from "vuepress-theme-hope";
+import DocSearchConfig from './plugins/search';
 import { zhcnNavbar, zhtwNavbar, enusNavbar, jajpNavbar, kokrNavbar } from "./navbar/index";
 import { zhcnSidebar, zhtwSidebar, enusSidebar, jajpSidebar, kokrSidebar } from "./sidebar/index";

@@ -71,21 +72,21 @@ export default hopeTheme({
      license: "AGPL-3.0",
    },

+    docsearch: DocSearchConfig,
+
    mdEnhance: {
      align: true,
-      card: true,
-      chart: true,
      codetabs: true,
-      container: true,
-      echarts: true,
+      //echarts: true,
      footnote: true,
      gfm: true,
+      hint: true,
      imgLazyload: true,
      imgMark: true,
      imgSize: true,
-      mathjax: true,
+      //mathjax: true,
      mark: true,
-      mermaid: true,
+      //mermaid: true,
      tabs: true,
      tasklist: true,
      vPre: true,
--- a/docs/package-lock.json
+++ b/docs/package-lock.json
--- a/docs/package.json
+++ b/docs/package.json
@@ -7,14 +7,14 @@
  "author": "bakashigure <me@shigure.fun>",
  "license": "AGPL-3.0",
  "devDependencies": {
-    "@vuepress/client": "2.0.0-beta.66",
-    "@vuepress/plugin-docsearch": "2.0.0-beta.66",
+    "@vuepress/bundler-vite": "2.0.0-rc.2",
+    "@vuepress/plugin-docsearch": "2.0.0-rc.3",
    "markdown-it": "^13.0.1",
    "markdown-it-anchor": "^8.6.7",
    "markdownlint-cli": "^0.32.2",
-    "vue": "^3.2.47",
-    "vuepress": "2.0.0-beta.66",
-    "vuepress-theme-hope": "2.0.0-beta.234"
+    "vue": "^3.4.15",
+    "vuepress": "2.0.0-rc.2",
+    "vuepress-theme-hope": "2.0.0-rc.18"
  },
  "scripts": {
    "dev": "vuepress dev .",
@@ -22,4 +22,4 @@
    "clean": "vuepress dev . --clean-cache",
    "lintfix": "markdownlint \"**/*.md\" --fix"
  }
-}
+}
--- a/docs/用户手册/常见问题.md
+++ b/docs/用户手册/常见问题.md
@@ -8,26 +8,28 @@ icon: ph:question-fill

 ### 可能性 0 : 下载的压缩包不完整

- 完整 MAA 软件压缩包命名格式为 "MAA-`版本`-`平台`-`架构`.zip"，其余均为无法单独使用的“零部件”，请仔细阅读。
- 若在某次自动更新后无法使用，可能是自动更新功能存在一些 bug, 可以尝试重新下载并解压完整包后手动迁移 `config` 文件夹。
+完整 MAA 软件压缩包命名格式为 "MAA-`版本`-`平台`-`架构`.zip"，其余均为无法单独使用的“零部件”，请仔细阅读。
+若在某次自动更新后无法使用，可能是自动更新功能存在一些 bug, 可以尝试重新下载并解压完整包后手动迁移 `config` 文件夹。

 ### 可能性 1 : 架构错误

- 在绝大部分情况下，您需要使用 x64 架构的 MAA，即您需要下载 `MAA-*-win-x64.zip`，而非 `MAA-*-win-arm64.zip`。MAA 不会支持 32 位操作系统。
+在绝大部分情况下，您需要使用 x64 架构的 MAA，即您需要下载 `MAA-*-win-x64.zip`，而非 `MAA-*-win-arm64.zip`。MAA 不会支持 32 位操作系统。

 ### 可能性 2 : 运行库问题

-> 此处仅列出官方安装方法，我们无法保证第三方整合包的可靠性。
+::: info 注意
+此处仅列出官方安装方法，我们无法保证第三方整合包的可靠性。
+:::

 - 请安装 [Visual C++ Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe)、[.NET 8](https://dotnet.microsoft.com/download/dotnet/thank-you/runtime-desktop-8.0.1-windows-x64-installer) 并重新启动计算机后再次尝试运行本软件。

 #### Windows N/KN 相关

- 如果您正在使用 Windows 8/8.1/10/11 N/KN（欧洲/韩国）版本，您还需要安装[媒体功能包](https://support.microsoft.com/zh-cn/topic/c1c6fffa-d052-8338-7a79-a4bb980a700a)。
+如果您正在使用 Windows 8/8.1/10/11 N/KN（欧洲/韩国）版本，您还需要安装[媒体功能包](https://support.microsoft.com/zh-cn/topic/c1c6fffa-d052-8338-7a79-a4bb980a700a)。

 #### Windows 7 相关

- 如果您正在使用 Windows 7，在安装运行库之前，您还需要检查以下补丁是否已安装：
+如果您正在使用 Windows 7，在安装运行库之前，您还需要检查以下补丁是否已安装：

  1. [Windows 7 Service Pack 1](https://support.microsoft.com/zh-cn/windows/b3da2c0f-cdb6-0572-8596-bab972897f61)
  2. SHA-2 代码签名补丁：
@@ -37,31 +39,40 @@ icon: ph:question-fill

 #### 官方整合包（确信）

- 安装 [Microsoft C++ 生成工具](https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/) 进行完整的开发环境配置（仅需要安装 .NET 及 C++ 开发环境）。
+::: info 注意
+此项操作将会耗费 10GB 左右的磁盘空间，请务必在排查完其他可能性后使用
+:::

- **请注意，此项操作将会耗费 10GB 左右的磁盘空间，请务必在排查完其他可能性后使用。**
+安装 [Microsoft C++ 生成工具](https://visualstudio.microsoft.com/zh-hans/visual-cpp-build-tools/) 进行完整的开发环境配置（仅需要安装 .NET 及 C++ 开发环境）。

 ### 可能性 3 : 系统组件问题

- 以上运行库安装均需要依赖组件存储服务（CBS、TrustedInstaller/TiWorker、WinSxS）。如果组件存储服务被破坏，将不能正常安装。
+以上运行库安装均需要依赖组件存储服务（CBS、TrustedInstaller/TiWorker、WinSxS）。如果组件存储服务被破坏，将不能正常安装

- 我们无法提供重装系统以外的修复建议，请避免使用所谓“精简版”系统。
+我们无法提供重装系统以外的修复建议，请避免使用所谓“精简版”系统。

 ## 连接错误

- 提示：请参阅 [模拟器支持](./模拟器和设备支持/Windows模拟器.md) 确定正在使用的模拟器通过了支持性测试。
- 若使用了游戏加速器等软件，请关闭软件并 **重启电脑** 后再次尝试。
+::: tip
+请参阅 [模拟器支持](./模拟器和设备支持/Windows模拟器.md) 确定正在使用的模拟器通过了支持性测试
+:::
+
+若使用了游戏加速器等软件，请关闭软件并 **重启电脑** 后再次尝试。

 ### 方式 1 : 确认 adb 及连接地址正确

- 确认 MAA `设置` - `连接设置` - `adb 路径` 是否已自动填写，若已填写请忽略这步。若未填写：
-  - 找到模拟器安装路径，Windows 可在运行模拟器时在任务管理器中右键进程点击 `打开文件所在的位置`。
-  - 顶层或下层目录中大概率会有一个 `adb.exe`（不一定就叫这个名字，可能叫 `nox_adb.exe`；`HD-adb.exe`；`adb_server.exe` 等等，总之是名字带 `adb` 的 exe），搜索它，选择它！
+- 确认 MAA `设置` - `连接设置` - `adb 路径` 是否已自动填写，若已填写请忽略这步
+
+::: details 若未填写
+ 找到模拟器安装路径，Windows 可在运行模拟器时在任务管理器中右键进程点击 `打开文件所在的位置`。
+ 顶层或下层目录中大概率会有一个 `adb.exe`（不一定就叫这个名字，可能叫 `nox_adb.exe`；`HD-adb.exe`；`adb_server.exe` 等等，总之是名字带`adb` 的 exe），搜索它，选择它！
+:::
+
 - 确认连接地址填写正确。可在网上搜索正在使用的模拟器 adb 调试地址是什么，一般是类似 `127.0.0.1:5555` 这样的格式（雷电模拟器除外）。

 #### 模拟器调试端口

- 相关文档及参考端口：
+相关文档及参考端口：

  - [Bluestacks](https://support.bluestacks.com/hc/zh-tw/articles/360061342631-%E5%A6%82%E4%BD%95%E5%B0%87%E6%82%A8%E7%9A%84%E6%87%89%E7%94%A8%E5%BE%9EBlueStacks-4%E8%BD%89%E7%A7%BB%E5%88%B0BlueStacks-5#%E2%80%9C2%E2%80%9D) `5555`
  - [MuMu 12](https://mumu.163.com/help/20230214/35047_1073151.html) `16384`
@@ -69,19 +80,19 @@ icon: ph:question-fill
  - [逍遥](https://bbs.xyaz.cn/forum.php?mod=viewthread&tid=365537) `21503`
  - [夜神](https://support.yeshen.com/zh-CN/qt/ml) `62001`

- 其他模拟器可参考 [赵青青的博客](https://www.cnblogs.com/zhaoqingqing/p/15238464.html)。
+其他模拟器可参考 [赵青青的博客](https://www.cnblogs.com/zhaoqingqing/p/15238464.html)。

 ### 方式 2 : 关闭冗余 adb 进程

- 关闭 MAA 后查找 `任务管理器` - `详细信息` 中有无名称包含 `adb` 的进程（通常和上文中填写的 `adb` 文件同名），如有，结束它后重试连接。
+关闭 MAA 后查找 `任务管理器` - `详细信息` 中有无名称包含 `adb` 的进程（通常和上文中填写的 `adb` 文件同名），如有，结束它后重试连接。

 ### 方式 3 : 重启电脑

- 重启能解决 98% 的问题。（确信
+重启能解决 98% 的问题。（确信

 ### 方式 4 : 换模拟器

- 请参阅 [模拟器支持](./模拟器和设备支持/Windows模拟器.md)。
+请参阅 [模拟器支持](./模拟器和设备支持/Windows模拟器.md)。

 ## 连接正常，但是无操作

@@ -108,7 +119,6 @@ icon: ph:question-fill
 在`gui.json`中搜索 `Bluestacks.Config.Keyword` 字段，内容为`"bst.instance.模拟器编号.status.adb_port"`，模拟器编号可在模拟器路径的`BlueStacks_nxt\Engine`中看到

 ::: details 示例
-
 Nougat64 核心：

 ```json
@@ -120,7 +130,6 @@ Pie64_2 核心：（核心名称后的数字代表这是一个多开核心）
 ```json
 "Bluestacks.Config.Keyword": "bst.instance.Pie64_2.status.adb_port",
 ```
-
 :::

 ### 指定 `Bluestacks.Config.Path`
--- a/docs/用户手册/详细介绍.md
+++ b/docs/用户手册/详细介绍.md
@@ -9,29 +9,27 @@ icon: ic:baseline-article
 ### 一键长草：刷理智

 - 若关卡选择中没有你需要的关卡，请在 MAA 中选择 `当前/上次`，然后在游戏中手动定位关卡，确保画面停留在有 **开始按钮** 和 **代理指挥** 的关卡详情界面。
-  - 若当前不处于此界面，则 `当前/上次` 会自动进入终端首页右下角“上次作战”的关卡。
-  - 也可以在 `任务设置` - `刷理智` - `高级设置` 中启用 `手动输入关卡名` 手动输入关卡编号。目前支持导航的关卡有：
-    - 全部主线关卡。可在关卡末尾添加 `-NORMAL` 或 `-HARD` 来切换标准或磨难关卡。
-    - 龙门币、作战记录的 5 / 6 关，但必须输入 `CE-6` / `LS-6`。MAA 会在第六关无法代理的情况下自动切换至第五关。
-    - 技能书、采购凭证、碳本第 5 关，必须输入 `CA-5` / `AP-5` / `SK-5`。
-    - 所有芯片本。必须输入完整关卡编号，如 `PR-A-1`。
-    - 剿灭作战。必须输入 `Annihilation`。
-    - 别传中的 `OF-1` / `OF-F3` / `GT-5`。
-    - 当期 SS 活动 后三关。在自动访问 [API](https://ota.maa.plus/MaaAssistantArknights/api/gui/StageActivity.json) 下载更新后会在主界面下方显示。
-    - 复刻的 SS 活动。输入 `SSReopen-<关卡前缀>` ，可一次性刷完 XX-1~XX-9 关，如 `SSReopen-IC`。
-
-<details><summary>示例画面</summary>
+- 若当前不处于此界面，则 `当前/上次` 会自动进入终端首页右下角“上次作战”的关卡。
+- 也可以在 `任务设置` - `刷理智` - `高级设置` 中启用 `手动输入关卡名` 手动输入关卡编号。目前支持导航的关卡有：
+  - 全部主线关卡。可在关卡末尾添加 `-NORMAL` 或 `-HARD` 来切换标准或磨难关卡。
+  - 龙门币、作战记录的 5 / 6 关，但必须输入 `CE-6` / `LS-6`。MAA 会在第六关无法代理的情况下自动切换至第五关。
+  - 技能书、采购凭证、碳本第 5 关，必须输入 `CA-5` / `AP-5` / `SK-5`。
+  - 所有芯片本。必须输入完整关卡编号，如 `PR-A-1`。
+  - 剿灭作战。必须输入 `Annihilation`。
+  - 别传中的 `OF-1` / `OF-F3` / `GT-5`。
+  - 当期 SS 活动 后三关。在自动访问 [API](https://ota.maa.plus/MaaAssistantArknights/api/gui/StageActivity.json) 下载更新后会在界面下方显示。
+  - 复刻的 SS 活动。输入 `SSReopen-<关卡前缀>` ，可一次性刷完 XX-1~XX-9 关，如 `SSReopen-IC`。

+::: details 示例画面
 ![示例画面](https://user-images.githubusercontent.com/5153875/196309375-73a93b83-e59b-441c-913f-122d4a9fc46c.png)
-
-</details>
+:::

 - 主界面上的 `吃理智`、`吃石头`、`指定次数`、`指定材料` 四个选项为**短路开关（或门）**，即达成四个选项中的任一条件，均会视为任务完成，停止刷理智。
-  - 其中：
-    - `吃理智` 指定吃几瓶理智药（一次可能吃多瓶）。
-    - `吃石头` 指定碎石多少次（每次 1 颗）。
-    - `指定次数` 指定刷多少次图（例如“刷 15 次后停止”）。
-    - `指定材料` 指定刷多少个指定的材料（例如“获取 5 个固源岩后停止”）。
+  其中：
+  - `吃理智` 指定吃几瓶理智药（一次可能吃多瓶）。
+  - `吃石头` 指定碎石多少次（每次 1 颗）。
+  - `指定次数` 指定刷多少次图（例如“刷 15 次后停止”）。
+  - `指定材料` 指定刷多少个指定的材料（例如“获取 5 个固源岩后停止”）。

 | 例  | 吃理智药 | 吃石头 | 指定次数 |  指定材料  | 结果                                                                                                                                                                      |
 | :-: | :------: | :----: | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |