Release 5.12.2 (#11630)

* fix: 反复进出训练室

* fix: 宿舍识别错误

* chore: 更新基建模板

* chore: Auto update by pre-commit hooks [skip changelog]

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

.clang-format

@@ -1,12 +1,9 @@
 # https://clang.llvm.org/docs/ClangFormatStyleOptions.html
 # for clang-format 17.0.1
-Language: Json
-IndentWidth: 4
----
 Language: Cpp
-BasedOnStyle: 'WebKit'
+BasedOnStyle: "WebKit"
 # AccessModifierOffset: 2
-AlignAfterOpenBracket: 'AlwaysBreak'
+AlignAfterOpenBracket: "AlwaysBreak"
 AlignArrayOfStructures: None
 AlignConsecutiveAssignments: None
 AlignConsecutiveBitFields: None
@@ -63,15 +60,15 @@ BraceWrapping:
 BreakAfterAttributes: Never
 BreakAfterJavaFieldAnnotations: true
 BreakArrays: true
-BreakBeforeBinaryOperators: NonAssignment
+BreakBeforeBinaryOperators: None
 BreakBeforeBraces: Custom
 BreakBeforeConceptDeclarations: Always
 BreakBeforeInlineASMColon: OnlyMultiline
 BreakBeforeTernaryOperators: true
-BreakConstructorInitializers: BeforeComma
-BreakInheritanceList: BeforeComma
+BreakConstructorInitializers: AfterColon
+BreakInheritanceList: AfterColon
 BreakStringLiterals: true
-ColumnLimit: 100
+ColumnLimit: 120
 # CommentPragmas: '^ MEO pragma:'
 CompactNamespaces: false
 ConstructorInitializerIndentWidth: 4
@@ -87,12 +84,12 @@ FixNamespaceComments: true
 #   - foreach
 #   - Q_FOREACH
 #   - BOOST_FOREACH
-# IfMacros: 
+# IfMacros:
 #   - 'KJ_IF_MAYBE'
 IncludeBlocks: Preserve
 # IncludeCategories:
-# IncludeIsMainRegex: 
-# IncludeIsMainSourceRegex: 
+# IncludeIsMainRegex:
+# IncludeIsMainSourceRegex:
 IndentAccessModifiers: false
 IndentCaseBlocks: false
 IndentCaseLabels: false
@@ -130,7 +127,7 @@ NamespaceIndentation: None
 # ObjCSpaceAfterProperty:
 # ObjCSpaceBeforeProtocolList:
 PackConstructorInitializers: Never
-# PenaltyBreakAssignment: 
+# PenaltyBreakAssignment:
 # PenaltyBreakBeforeFirstCallParameter:
 # PenaltyBreakComment:
 # PenaltyBreakFirstLessLess:
@@ -183,7 +180,7 @@ SpacesInLineCommentPrefix:
 SpacesInParens: Never
 SpacesInSquareBrackets: false
 Standard: c++20
-# StatementAttributeLikeMacros: 
+# StatementAttributeLikeMacros:
 # StatementMacros:
 TabWidth: 4
 # TypeNames:

.devcontainer/devcontainer.json

@@ -7,10 +7,7 @@
     "postCreateCommand": "sudo sh -ce 'apt update && apt install g++-12 -y && echo export CC=gcc-12 CXX=g++-12 >> /etc/profile.d/set-compiler.sh'",
     "customizations": {
         "vscode": {
-            "extensions": [
-                "llvm-vs-code-extensions.vscode-clangd",
-                "DavidAnson.vscode-markdownlint"
-            ]
+            "extensions": ["llvm-vs-code-extensions.vscode-clangd", "DavidAnson.vscode-markdownlint"]
         }
     }
 }

.git-blame-ignore-revs

@@ -22,6 +22,7 @@ a5daac889a55baf8895918d4964f20dad1938470
 206df466fd5e3d8ef80387049b0c5011fb58cada
 c9b5aa638a97397ab8666031ea646904527afc09
 559c913fca0dd0966896396e251be13f76ea3e52
+
 # Re-structure again.
 4b3b84df8f487be0ac86506c28dbebc4635f1282
 91abbb7f175b93a58368a136acf3799666f770d2
@@ -29,3 +30,21 @@ c9b5aa638a97397ab8666031ea646904527afc09
 bae271c09bb79e5cc2a7f8491ce882d276ac97b4
 3d83b80dd67d996a5f4f1732fe1eb36cacc7605e
 21617270bcef2456cb7f89e54560ca6788450711
+
+# resource/*.json prettier mass styling
+d84da5d01a872540d520bc87408d4524e07cfa39
+546bfc399cdd140a9812f44b5e6bc89fccfda5fa
+f0bdccdf0da7fac29f475951f0f43d3ab56a7ffe
+7a758bce844bc2778f04a789195efbd17681dac7
+5f3730b76785b1168125eb3b5edbed399722f8f9
+bc3ad67a02cb3b8e154c06955cf17091c4265000
+
+# oxipng template optimization
+e3d63894b28b2ef5e2405e144a32a6981de5e1b2
+
+# usage: add "[blame ignore]" to the commit message
+# This file is managed by an automated workflow
+# Do not add, remove or modify lines below this comment
+# as they are automatically appended
+# --------------------------------------------------- #
+f7772bc814c52f9a5e65af02404cf54b70fe0a32

.gitattributes

@@ -8,4 +8,5 @@
 
 *.json   text eol=lf
 *.md     text eol=lf
+*.yml    text eol=lf
 *.yaml   text eol=lf

.github/.last-blame-ignore-commit

@@ -0,0 +1 @@
+272d71fa2938f945832f86232532b86a9e5406b8

.github/ISSUE_TEMPLATE/cn-bug-report.yaml

@@ -1,20 +1,22 @@
 name: Bug 反馈（使用中文）
 description: 识别错误、操作异常、连接错误等
-labels: ['bug']
+labels: ["bug"]
 body:
   - type: checkboxes
     id: checks
     attributes:
       label: 在提问之前...
+      description: |
+        请确认自己完成了要求之后再进行勾选
       options:
-      - label: 我理解 Issue 是用于反馈和解决问题的，而非吐槽评论区，将尽可能提供更多信息帮助问题解决
-        required: true
-      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
-        required: true
-      - label: 我已查看最新测试版本的更新内容，并未提及该 Bug 已被修复的情况
-        required: true
-      - label: 我已检查了置顶议题（pinned issue），确认我的问题未被提及
-        required: true
+        - label: 我理解 Issue 是用于反馈和解决问题的，而非吐槽评论区，将尽可能提供更多信息帮助问题解决
+          required: true
+        - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
+          required: true
+        - label: 我使用的是当前更新版本的最新版，且已查看版本发布至今和 Pull Requests 中尚未发布的更新内容，并未提及该 Bug 已被修复的情况
+          required: true
+        - label: 我已检查了置顶议题（Pinned Issue）（公告）、活跃议题（Open Issue）、已关闭议题（Closed Issue），确认我的问题未被提及
+          required: true
   - type: textarea
     id: describe
     attributes:
@@ -30,28 +32,45 @@ body:
         请提供 MAA 版本。可在 MAA -> 设置 -> 软件更新中找到（点击图标可复制）。
       placeholder: |
         Resource Version:
-        UI Version:
-        Core Version:
+        MAA Version:
     validations:
       required: true
   - type: textarea
     id: logs
     attributes:
-      label: 日志文件
+      label: 日志和配置文件
       description: |
-        **请在关闭MAA后，上传 `debug` 文件夹中的 `asst.log` 和 `gui.log` 日志文件，并说明问题出现的大致时间点**
+        **请在关闭 MAA 后，上传以下 5 个文件：**
+          1. `debug` 文件夹中的 `asst.log` `gui.log` `asst.bak.log` 和 `gui.bak.log` 日志文件，并说明问题出现的大致时间点
+          2. `config` 文件夹中的 `gui.json` 配置文件
+
+        如果你在使用 MacBook，请点击屏幕左上角的“文件”，点击“打开日志文件夹”
         **请直接将完整的文件拖拽进来，而非自己裁切或复制的片段；若文件体积过大可压缩后再上传**
+      placeholder: |
+        请确认上传文件前已关闭 MAA
+    validations:
+      required: true
+  - type: textarea
+    id: configuration
+    attributes:
+      label: 配置信息
+      description: |
+        请说明操作系统及版本、模拟器品牌、模拟器分辨率、DPI、帧率；
+        若正在使用 MuMu 12 或雷电 9，请说明截图增强是否开启；
+        最后请说明 GPU 加速推理是否开启，若开启请提供 GPU 型号。
     validations:
       required: true
   - type: textarea
     id: screenshots
     attributes:
-      label: 截图
+      label: 截图或录屏
       description: |
-        如果有，添加屏幕截图以帮助解释你的问题，包括但不限于 MAA 软件截图、游戏画面截图
+        `debug` 目录下按功能分类的文件夹内，有一些自动截图的错误图片，若有相关的，请一并打包上传
+
+        可上传屏幕截图或录制以帮助解释你的问题，包括但不限于 MAA 软件截图、游戏画面截图
         若是**识别相关问题**，请尽可能提供模拟器自带的截图工具截取的无遮挡的**原图**（或通过 adb 截取原图）
-        用其他的工具（如QQ）截取的图片包含窗口边框，不利于我们排除bug
-        `debug` 文件夹下有一些自动截图的错误图片，若有相关的，请一并打包上传
+        用其他的工具（如QQ/微信）截取的图片包含窗口边框且长宽比、分辨率不固定，不利于我们排除bug
+        若文件体积过大可压缩后再上传
     validations:
       required: false
   - type: textarea
@@ -59,7 +78,6 @@ body:
     attributes:
       label: 还有别的吗？
       description: |
-        使用的模拟器？操作系统？相关的配置？链接？参考资料？
         任何能让我们对你所遇到的问题有更多了解的东西
     validations:
       required: false

.github/ISSUE_TEMPLATE/cn-feature-request.yaml

@@ -1,16 +1,20 @@
 name: 需求建议（使用中文）
 description: 新功能、建议等
-labels: ['enhancement']
+labels: ["enhancement"]
 body:
   - type: checkboxes
     id: checks
     attributes:
       label: 在提问之前...
       options:
-      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
-        required: true
-      - label: 我基本确定这是一个新功能/建议，而不是遇到了 Bug（不确定的话请附上日志）
-        required: true
+        - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
+          required: true
+        - label: 我基本确定这是一个新功能/建议，而不是遇到了 Bug（不确定的话请附上日志）
+          required: true
+        - label: 我使用的是当前更新版本的最新版，且已查看版本发布至今和 Pull Requests 中尚未发布的更新内容，确认我的建议未被提及
+          required: true
+        - label: 我已检查了置顶议题（Pinned Issue）（公告）、活跃议题（Open Issue）、已关闭议题（Closed Issue），确认我的建议未被提及
+          required: true
   - type: textarea
     id: describe
     attributes:

.github/ISSUE_TEMPLATE/cn-ld-report.yaml

@@ -0,0 +1,85 @@
+name: 雷电截图增强反馈（使用中文）
+description: 有关雷电 9 截图增强功能的集中反馈
+labels: ["LD9 API"]
+body:
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: 在提问之前...
+      options:
+        - label: 我理解 Issue 是用于反馈和解决问题的，而非吐槽评论区，将尽可能提供更多信息帮助问题解决
+          required: true
+        - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
+          required: true
+        - label: 我已检查了置顶议题（Pinned Issue），确认我的问题未被提及
+          required: true
+        - label: 我正在使用最新的 MAA 公测版本和最新的官版雷电 9 模拟器
+          required: true
+        - label: 我已参考文档确定安装路径、实例编号填写正确，并确认在关闭截图增强模式后问题消失
+          required: true
+        - label: 我未开启高帧率，且模拟器帧数设置为 60
+          required: false
+  - type: textarea
+    id: describe
+    attributes:
+      label: 问题描述
+      description: 描述问题时请尽可能详细
+    validations:
+      required: true
+  - type: textarea
+    id: version
+    attributes:
+      label: Version
+      description: |
+        请提供 MAA 版本和雷电 9 版本。MAA 版本可在 MAA -> 设置 -> 软件更新中找到（点击图标可复制）。
+        雷电 9 版本可在右上角菜单按钮 -> 关于雷电 中找到。
+      placeholder: |
+        Resource Version:
+        MAA Version:
+        雷电 9 版本号:
+    validations:
+      required: true
+  - type: textarea
+    id: logs
+    attributes:
+      label: MAA 日志和配置文件
+      description: |
+        **请在关闭 MAA 后，上传以下三个文件：**
+        1. `debug` 文件夹中的 `asst.log` 和 `gui.log` 日志文件，并说明问题出现的大致时间点
+          若 asst.log 文件小于 10 KB，则需同时上传 asst.log.bak 文件
+        2. `config` 文件夹中的 `gui.json` 配置文件
+        **请直接将完整的文件拖拽进来，而非自己裁切或复制的片段；若文件体积过大可压缩后再上传**
+      placeholder: |
+        请确认上传文件前已关闭 MAA
+    validations:
+      required: true
+  - type: textarea
+    id: ldlogs
+    attributes:
+      label: 雷电 9 诊断信息
+      description: |
+        **在雷电 9 右上角菜单按钮 -> 诊断信息 中点击 复制信息，并将全部内容粘贴进来。**
+    validations:
+      required: true
+  - type: textarea
+    id: screenshots
+    attributes:
+      label: 截图
+      description: |
+        `debug` 目录下按功能分类的文件夹内，有一些自动截图的错误图片，若有相关的，请一并打包上传
+
+        可上传屏幕截图或录制以帮助解释你的问题，包括但不限于 MAA 软件截图、游戏画面截图
+        若是**识别相关问题**，请尽可能提供模拟器自带的截图工具截取的无遮挡的**原图**（或通过 adb 截取原图）
+        用其他的工具（如QQ/微信）截取的图片包含窗口边框且长宽比、分辨率不固定，不利于我们排除bug
+        若文件体积过大可压缩后再上传
+    validations:
+      required: false
+  - type: textarea
+    id: others
+    attributes:
+      label: 其他
+      description: |
+        GPU 加速推理是否开启，若开启请提供 GPU 型号。
+        亦或者任何能让我们对你所遇到的问题有更多了解的东西
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/cn-mumu-report.yaml

@@ -1,26 +1,24 @@
 name: MuMu 截图增强反馈（使用中文）
 description: 有关 MuMu 截图增强功能的集中反馈
-labels: ['mumu api']
+labels: ["MuMu API"]
 body:
   - type: checkboxes
     id: checks
     attributes:
       label: 在提问之前...
       options:
-      - label: 我理解 Issue 是用于反馈和解决问题的，而非吐槽评论区，将尽可能提供更多信息帮助问题解决
-        required: true
-      - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
-        required: true
-      - label: 我已检查了置顶议题（Pinned Issue），确认我的问题未被提及
-        required: true
-      - label: 我正在使用最新的 MAA 内测版本和最新的**官版** MuMu 模拟器
-        required: true
-      - label: 我已参考文档确定安装路径、实例编号、屏幕编号填写正确，并确认在关闭截图增强模式后问题消失
-        required: true
-      - label: 我未开启高帧率模式，且显存使用策略为“画面表现更好”
-        required: false
-      - label: 我正在使用后台保活功能，并确定该问题仅在开启后台保活时出现
-        required: false
+        - label: 我理解 Issue 是用于反馈和解决问题的，而非吐槽评论区，将尽可能提供更多信息帮助问题解决
+          required: true
+        - label: 我填写了简短且清晰明确的标题，以便开发者在翻阅 Issue 列表时能快速确定大致问题。而不是“一个建议”、“卡住了”等
+          required: true
+        - label: 我已检查了置顶议题（Pinned Issue），确认我的问题未被提及
+          required: true
+        - label: 我正在使用最新的 MAA 公测版本和最新的官版或方舟专版 MuMu 模拟器
+          required: true
+        - label: 我已参考文档确定安装路径、实例编号、屏幕编号填写正确，并确认在关闭截图增强模式后问题消失
+          required: true
+        - label: 我未开启后台保活，模拟器帧数为 60，显存使用策略为“画面表现更好”
+          required: false
   - type: textarea
     id: describe
     attributes:
@@ -32,22 +30,27 @@ body:
     id: version
     attributes:
       label: Version
-      description: >-
-        请提供 MAA 版本和 MuMu 版本。MAA 版本可在 MAA -> 设置 -> 软件更新中找到（点击图标可复制）。MuMu 版本可在右上角菜单按钮 -> 关于 MuMu 中找到。
+      description: |
+        请提供 MAA 版本和 MuMu 版本。MAA 版本可在 MAA -> 设置 -> 软件更新中找到（点击图标可复制）。
+        MuMu 版本可在右上角菜单按钮 -> 关于 MuMu 中找到。
       placeholder: |
-        Resource Version: 
-        UI Version: 
-        Core Version: 
-        MuMu 版本号: 
+        Resource Version:
+        MAA Version:
+        MuMu 版本号:
     validations:
       required: true
   - type: textarea
     id: logs
     attributes:
-      label: MAA 日志文件
+      label: MAA 日志和配置文件
       description: |
-        **上传 `debug` 文件夹中的 `asst.log` 和 `gui.log` 日志文件，并说明问题出现的大致时间点**
+        **请在关闭 MAA 后，上传以下三个文件：**
+        1. `debug` 文件夹中的 `asst.log` 和 `gui.log` 日志文件，并说明问题出现的大致时间点
+          若 asst.log 文件小于 10 KB，则需同时上传 asst.log.bak 文件
+        2. `config` 文件夹中的 `gui.json` 配置文件
         **请直接将完整的文件拖拽进来，而非自己裁切或复制的片段；若文件体积过大可压缩后再上传**
+      placeholder: |
+        请确认上传文件前已关闭 MAA
     validations:
       required: true
   - type: textarea
@@ -64,18 +67,20 @@ body:
     attributes:
       label: 截图
       description: |
-        如果有，添加屏幕截图以帮助解释你的问题，包括但不限于 MAA 软件截图、游戏画面截图
+        `debug` 目录下按功能分类的文件夹内，有一些自动截图的错误图片，若有相关的，请一并打包上传
+
+        可上传屏幕截图或录制以帮助解释你的问题，包括但不限于 MAA 软件截图、游戏画面截图
         若是**识别相关问题**，请尽可能提供模拟器自带的截图工具截取的无遮挡的**原图**（或通过 adb 截取原图）
-        用其他的工具（如QQ）截取的图片包含窗口边框，不利于我们排除bug
-        `debug` 文件夹下有一些自动截图的错误图片，若有相关的，请一并打包上传
+        用其他的工具（如QQ/微信）截取的图片包含窗口边框且长宽比、分辨率不固定，不利于我们排除bug
+        若文件体积过大可压缩后再上传
     validations:
       required: false
   - type: textarea
     id: others
     attributes:
-      label: 还有别的吗？
+      label: 其他
       description: |
-        操作系统？相关的配置？链接？参考资料？
-        任何能让我们对你所遇到的问题有更多了解的东西
+        GPU 加速推理是否开启，若开启请提供 GPU 型号。
+        亦或者任何能让我们对你所遇到的问题有更多了解的东西
     validations:
       required: false

.github/ISSUE_TEMPLATE/cn-others.yaml

@@ -1,6 +1,6 @@
 name: 其他议题（使用中文）
 description: 提出问题，而不是 Bug 反馈或需求建议
-labels: ['question']
+labels: ["question"]
 body:
   - type: textarea
     id: describe

.github/ISSUE_TEMPLATE/en-bug-report.yaml

@@ -2,32 +2,35 @@ name: Bug Report (in English)
 description: >-
   Recognition errors, operation abnormalities,
   connection errors, etc.
-labels: ['bug']
+labels: ["bug"]
 body:
   - type: checkboxes
     id: checks
     attributes:
       label: Before raising the issue...
+      description: |
+        Please ensure that you have completed the requirements before checking the box.
       options:
-      - label: >-
-          I understand that Issues are for feedback and problem solving,
-          not trolling the comments section, and will provide as
-          much information as possible to help solve the problem.
-        required: true
-      - label: >-
-          I filled in a short, clear title
-          so that developers could quickly identify the general problem
-          when going through the issue list.
-          Instead of "Some suggestions", "Stuck", etc.
-        required: true
-      - label: >-
-          I have checked the latest beta update and there is no mention
-          of the bug being fixed.
-        required: true
-      - label: >-
-          I have reviewed the pinned issues and confirmed that my issue
-          is not mentioned.
-        required: true
+        - label: >-
+            I understand that Issues are for feedback and problem solving,
+            not trolling the comments section, and will provide as
+            much information as possible to help solve the problem.
+          required: true
+        - label: >-
+            I filled in a short, clear title
+            so that developers could quickly identify the general problem
+            when going through the issue list.
+            Instead of "Some suggestions", "Stuck", etc.
+          required: true
+        - label: >-
+            I am using the latest version of the current update and have reviewed
+            both the updates released so far and the unreleased changes in the Pull Requests,
+            there is no mention of the bug being fixed.
+          required: true
+        - label: >-
+            I have reviewed the Pinned issue (Announcements), Open issues, and Closed issues
+            to ensure that my issue has not been mentioned.
+          required: true
   - type: textarea
     id: describe
     attributes:
@@ -43,28 +46,45 @@ body:
         Please provide the MAA version. Can be found in MAA -> Settings -> Update. (Click to copy)
       placeholder: |
         Resource Version:
-        UI Version:
-        Core Version:
+        MAA Version:
     validations:
       required: true
   - type: textarea
     id: logs
     attributes:
-      label: Log files
+      label: Log and config files
       description: >-
-        **After closing the MAA, upload the `asst.log` and `gui.log` log file in the `debug` folder and**
-        **indicate the approximate point in time when the problem occurred.**
+        **After closing MAA, upload the following 5 files:**
+          1. The `asst.log` `gui.log` `asst.bak.log` and `gui.bak.log` log file in the `debug` folder, and indicate the approximate point in time when the problem occurred.
+          2. The `gui.json` config file in the `config` folder
 
+        If you are using MacBook, please click the "File" option in the top-left corner of the screen, then click "Open Log Folder".
         **Please drag and drop the full file in, not your own cuttings or copies;**
         **compress it before uploading if too large.**
+      placeholder: |
+        Please confirm that MAA is not running before uploading files.
+    validations:
+      required: true
+  - type: textarea
+    id: configuration
+    attributes:
+      label: Configuration information
+      description: |
+        Please specify the operating system and version, emulator brand, emulator resolution, DPI, and frame rate;
+        If you are using MuMu 12 or LDPlayer 9, please specify whether Screenshot Enhancement is enabled;
+        Finally, please specify whether GPU accelerated inference is enabled, and if so, provide the GPU model.
     validations:
       required: true
   - type: textarea
     id: screenshots
     attributes:
-      label: Screenshots
+      label: Screenshots or recordings
       description: >-
-        If available, add screenshots to help explain your problem,
+        In the `debug` directory, within the functionally categorized folders, 
+        there are some error images captured automatically.
+        If related to this issue, please upload them together.
+
+        If available, upload screenshots and recordings to help explain your problem,
         including but not limited to screenshots of MAA software,
         screenshots of game screens.
 
@@ -72,11 +92,11 @@ body:
         the **original image** taken by the emulator's own screenshot tool
         (or via adb).
 
-        Screenshots taken with other tools may contain the frames of the window/emulator, which makes it harder for us to debug.
+        Screenshots taken with other tools may contain the frames of the window/emulator
+        and their aspect ratio and resolution are inconsistent,
+        which makes it harder for us to debug.
 
-        The `debug` folder has some automatic screenshots of the error images,
-        if you have any,
-        please upload them together.
+        If the file siz is too large, you may compress it before uploading.
 
     validations:
       required: false
@@ -84,11 +104,7 @@ body:
     id: others
     attributes:
       label: Anthing else?
-      description: >-
-        Emulator used, operating system, related configuration, links,
-        reference material, etc.
-
-        Anything that will give us more insight into the problem
-        you are having.
+      description: |
+        Anything that will give us more insight into the problem you are having.
     validations:
       required: false

.github/ISSUE_TEMPLATE/en-feature-request.yaml

@@ -1,16 +1,20 @@
 name: Feature Request (in English)
 description: New features, suggestions, etc.
-labels: ['enhancement']
+labels: ["enhancement"]
 body:
   - type: checkboxes
     id: checks
     attributes:
       label: Before raising the issue...
       options:
-      - label: I filled in a short, clear title so that developers could quickly identify the general problem when going through the issue list. Instead of "Some suggestions", "Stuck", etc.
-        required: true
-      - label: I'm probably sure this is a new feature/suggestion and not a bug encountered (please attach logs if you're not sure)
-        required: true
+        - label: I filled in a short, clear title so that developers could quickly identify the general problem when going through the issue list. Instead of "Some suggestions", "Stuck", etc.
+          required: true
+        - label: I'm probably sure this is a new feature/suggestion and not a bug encountered (please attach logs if you're not sure)
+          required: true
+        - label: I am using the latest version of the current update and have reviewed both the updates released so far and the unreleased changes in the Pull Requests, but there is no mention of this feature/suggestion being added.
+          required: true
+        - label: I have reviewed the Pinned issue (Announcements), Open issues, and Closed issues to ensure that my feature/suggestion has not been mentioned.
+          required: true
   - type: textarea
     id: describe
     attributes:

.github/ISSUE_TEMPLATE/en-others.yaml

@@ -1,6 +1,6 @@
 name: Others (in English)
 description: Ask a question rather than a bug report or feature request.
-labels: ['question']
+labels: ["question"]
 body:
   - type: textarea
     id: describe

.github/dependabot.yaml

@@ -0,0 +1,18 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /.github/workflows
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: ci
+    assignees:
+      - constrat
+      - AnnAngela
+    groups:
+      github-actions:
+        patterns:
+          - "*"
+    ignore:
+      - dependency-name: "Nerixyz/actionsx-prettier"
+        versions: ["3.0.0"]

.github/release_reviewers.yaml

@@ -11,7 +11,6 @@ reviewers:
 # A list of assignees to be added to pull requests (GitHub user name)
 assignees:
   - AnnAngela
-
 # A list of keywords to be skipped the process that add reviewers if pull requests include it
 # skipKeywords:
 #   - wip

.github/stale_cache_remover.ps1

@@ -0,0 +1,38 @@
+$totalClearedSize = 0
+$cacheList = gh cache list --json id,ref,sizeInBytes | ConvertFrom-Json
+$prCaches = $cacheList | Where-Object { $_.ref -like "*merge*" }
+
+if (-not $prCaches) {
+    Write-Output "No PR caches found."
+    exit
+}
+
+foreach ($cache in $prCaches) {
+    $cacheId = $cache.id
+    $cacheRef = $cache.ref
+    $cacheSizeInBytes = $cache.sizeInBytes  
+
+    if ($cacheRef -match "refs/pull/(\d+)/merge") {
+        $prNumber = $matches[1]
+ 
+        Write-Host "PR #${prNumber}: " -NoNewline
+ 
+        $prStatus = gh pr view $prNumber --json state | ConvertFrom-Json
+ 
+        Write-Host $prStatus.state -NoNewline
+ 
+        if ($prStatus.state -eq "MERGED" -or $prStatus.state -eq "CLOSED") {
+            Write-Host " -> DELETING"
+            
+            gh cache delete $cacheId
+
+            $totalClearedSize += $cacheSizeInBytes
+        }
+        else {
+            Write-Host ""
+        }
+    }
+}
+
+$formattedSize = "{0:N2}" -f ($totalClearedSize / 1MB)
+Write-Output "Cleared size: $formattedSize MB"

.github/workflows/blame-ignore.yml

@@ -0,0 +1,49 @@
+name: Git Blame Ignore
+
+on:
+  schedule:
+    - cron: "45 21 * * *" # Runs daily at 22:00 UTC
+  workflow_dispatch:
+
+jobs:
+  blame-ignore:
+    if: github.repository_owner == 'MaaAssistantArknights'
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          persist-credentials: false # Needed to bypass protection rules in Push changes
+
+      - name: Check blame
+        id: check_changes
+        run: |
+          LAST_CHECKED_COMMIT=$(cat .github/.last-blame-ignore-commit 2>/dev/null || git rev-list --max-parents=0 HEAD)
+
+          git log $LAST_CHECKED_COMMIT..HEAD --pretty=format:"%H %s" --grep="\[blame ignore\]" | awk '{print $1}' >> .git-blame-ignore-revs
+
+          git diff --quiet .git-blame-ignore-revs
+
+      - name: Commit and Push changes
+        if: ${{ steps.check_changes.outcome == 'failure' }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          git rev-parse HEAD > .github/.last-blame-ignore-commit
+
+          git add .github/.last-blame-ignore-commit .git-blame-ignore-revs
+          git commit -m "chore: auto blame ignore" -m "[skip changelog]"
+
+      - name: Push changes
+        if: ${{ steps.check_changes.outcome == 'failure' }}
+        uses: ad-m/github-push-action@master
+        with:
+          branch: ${{ github.ref }}
+          github_token: ${{ secrets.MAA_RESOURCE_SYNC }}
+
+      - name: Stop if no changes
+        if: ${{ steps.check_changes.outcome == 'success' }}
+        uses: andymckay/cancel-action@0.5

.github/workflows/cache-delete.yml

@@ -0,0 +1,39 @@
+name: Delete Cache
+
+on:
+  pull_request:
+    types: [closed]
+  workflow_dispatch:
+    inputs:
+      pr_number:
+        description: "PR Number"
+        required: true
+
+jobs:
+  cache-delete:
+    # Run only on organization branches with PRs
+    if: github.event_name == 'workflow_dispatch' ||
+      github.event.pull_request.head.repo.full_name ==
+      github.event.pull_request.base.repo.full_name
+    runs-on: ubuntu-latest
+    steps:
+      - name: Delete cache on PR merged
+        run: |
+          if [ "${{ github.event_name }}" == "workflow_dispatch" ]; then
+            PR_NUMBER=${{ github.event.inputs.pr_number }}
+          else
+            PR_NUMBER=${{ github.event.pull_request.number }}
+          fi
+          echo "PR Number: $PR_NUMBER"
+
+          curl -s -L https://api.github.com/repos/Maaassistantarknights/Maaassistantarknights/actions/caches |
+          jq -r --arg PR_NUMBER "refs/pull/$PR_NUMBER/merge" '.actions_caches[] | select(.ref == $PR_NUMBER) | .id' |
+          while read -r id; do
+            echo "Deleting cache with ID: $id"
+
+            curl -L -X DELETE \
+              -H "Accept: application/vnd.github+json" \
+              -H "Authorization: Bearer ${{ secrets.GITHUB_TOKEN }}" \
+              -H "X-GitHub-Api-Version: 2022-11-28" \
+              "https://api.github.com/repos/MaaAssistantArknights/MaaAssistantArknights/actions/caches/$id"
+          done

.github/workflows/ci.yml

@@ -28,8 +28,17 @@ on:
       - "!**/*.md"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   meta:
+    # Prevent duplicate runs on organization branches with PRs
+    if: github.event_name != 'pull_request' ||
+      github.event.pull_request.head.repo.full_name !=
+      github.event.pull_request.base.repo.full_name
+
     runs-on: ubuntu-latest
     outputs:
       tag: ${{ steps.set_tag.outputs.tag }}
@@ -89,6 +98,11 @@ jobs:
           path: CHANGELOG.md
 
   windows:
+    # Prevent duplicate runs on organization branches with PRs
+    if: github.event_name != 'pull_request' ||
+      github.event.pull_request.head.repo.full_name !=
+      github.event.pull_request.base.repo.full_name
+
     needs: meta
     strategy:
       matrix:
@@ -106,7 +120,10 @@ jobs:
         uses: actions/checkout@v4
         with:
           show-progress: false
-          submodules: recursive
+
+      - name: Fetch submodules
+        run: |
+          git submodule update --init --depth 1 3rdparty/EmulatorExtras
 
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget
@@ -121,7 +138,16 @@ jobs:
         if: steps.cache-nuget.outputs.cache-hit != 'true'
         run: dotnet restore
 
+      - name: Cache MaaDeps
+        id: cache-maadeps
+        uses: actions/cache@v4
+        with:
+          path: |
+            ./MaaDeps
+          key: ${{ runner.os }}-${{ matrix.lowercase_target }}-maadeps-${{ hashFiles('./maadeps-download.py') }}
+
       - name: Bootstrap MaaDeps
+        if: steps.cache-maadeps.outputs.cache-hit != 'true'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
@@ -179,17 +205,28 @@ jobs:
           path: artifacts
 
   ubuntu:
+    # Prevent duplicate runs on organization branches with PRs
+    if: github.event_name != 'pull_request' ||
+      github.event.pull_request.head.repo.full_name !=
+      github.event.pull_request.base.repo.full_name
+
     needs: meta
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-22.04
     strategy:
       matrix:
         arch: [aarch64, x86_64]
+    permissions:
+      actions: write
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
           show-progress: false
-          submodules: recursive
+
+      - name: Fetch submodules
+        run: |
+          git submodule update --init --depth 1 3rdparty/EmulatorExtras
+          git submodule update --init --depth 1 src/maa-cli
 
       - name: Install cross compile toolchains
         if: ${{ matrix.arch != 'x86_64' }}
@@ -197,11 +234,7 @@ jobs:
           sudo apt-get update
           sudo apt-get install g++-12-aarch64-linux-gnu g++-12-aarch64-linux-gnu
 
-      - name: Setup ccache
-        uses: Chocobo1/setup-ccache-action@v1
-        with:
-          remove_stale_cache: false
-
+      # Caching not necessary on ubuntu runner
       - name: Bootstrap MaaDeps
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -212,6 +245,7 @@ jobs:
         run: |
           mkdir -p build
           cmake -B build \
+            -DCMAKE_COMPILE_WARNING_AS_ERROR=ON \
             -DMAADEPS_TRIPLET='maa-${{ matrix.arch == 'x86_64' && 'x64' || 'arm64' }}-linux' \
             -DINSTALL_THIRD_LIBS=ON \
             -DINSTALL_RESOURCE=ON \
@@ -222,8 +256,12 @@ jobs:
           mkdir -p install
           cmake --install build --prefix install
         env:
-          CC: ${{ matrix.arch == 'x86_64' && 'ccache gcc-12' || 'ccache aarch64-linux-gnu-gcc-12' }}
-          CXX: ${{ matrix.arch == 'x86_64' && 'ccache g++-12' || 'ccache aarch64-linux-gnu-g++-12' }}
+          CC: ${{ matrix.arch == 'x86_64' && 'gcc-12' || 'aarch64-linux-gnu-gcc-12' }}
+          CXX: ${{ matrix.arch == 'x86_64' && 'g++-12' || 'aarch64-linux-gnu-g++-12' }}
+          CMAKE_COLOR_DIAGNOSTICS: ON
+          CLICOLOR_FORCE: 1
+          CXXFLAGS: | # workaround for gcc bugs
+            -Wno-error=restrict -Wno-error=array-bounds -Wno-error=stringop-overread -Wno-error=missing-field-initializers
 
       - name: Setup Cross Compile Toolchains for CLI
         uses: ./src/maa-cli/.github/actions/setup
@@ -270,9 +308,9 @@ jobs:
           cp -v tools/AppImage/io.github.maaassistantarknights.maaassistantarknights.metainfo.xml Maa.AppDir/usr/share/metainfo/
           wget "https://github.com/AppImage/AppImageKit/releases/download/continuous/appimagetool-x86_64.AppImage"
           # appimagetool with embedded runtime does not support cross build, till AppImage/appimagetool 7a10b8
-          wget "https://github.com/AppImage/type2-runtime/releases/download/continuous/runtime-${{ matrix.arch }}"
+          wget "https://github.com/AppImage/type2-runtime/releases/download/old/runtime-fuse3-${{ matrix.arch }}"
           chmod a+x appimagetool-x86_64.AppImage
-          ARCH=${{ matrix.arch }} ./appimagetool-x86_64.AppImage --runtime-file runtime-${{ matrix.arch }} Maa.AppDir
+          ARCH=${{ matrix.arch }} ./appimagetool-x86_64.AppImage --runtime-file runtime-fuse3-${{ matrix.arch }} Maa.AppDir
           chmod a+x MaaAssistantArknights-${{ matrix.arch }}.AppImage
           mv -v MaaAssistantArknights-${{ matrix.arch }}.AppImage $GITHUB_WORKSPACE/release/MAA-${{ needs.meta.outputs.tag }}-linux-${{ matrix.arch }}.AppImage
 
@@ -291,6 +329,11 @@ jobs:
             release/*.tar.gz
 
   macOS-Core:
+    # Prevent duplicate runs on organization branches with PRs
+    if: github.event_name != 'pull_request' ||
+      github.event.pull_request.head.repo.full_name !=
+      github.event.pull_request.base.repo.full_name
+
     needs: meta
     runs-on: macos-14
     strategy:
@@ -306,6 +349,7 @@ jobs:
         run: |
           brew install ninja
 
+      # Caching not necessary on macOS runner
       - name: Bootstrap MaaDeps
         run: |
           [[ ${{ matrix.arch }} = "arm64" ]] && triplet="arm64-osx" || triplet="x64-osx"
@@ -329,6 +373,11 @@ jobs:
           path: "install/*.dylib"
 
   macOS-GUI:
+    # Prevent duplicate runs on organization branches with PRs
+    if: github.event_name != 'pull_request' ||
+      github.event.pull_request.head.repo.full_name !=
+      github.event.pull_request.base.repo.full_name
+
     needs: [meta, macOS-Core]
     runs-on: macos-14
     steps:
@@ -336,7 +385,10 @@ jobs:
         uses: actions/checkout@v4
         with:
           show-progress: false
-          submodules: recursive
+
+      - name: Fetch submodules
+        run: |
+          git submodule update --init --depth 1 src/MaaMacGui
 
       - name: Download Arm64 MAA from Github
         uses: actions/download-artifact@v4
@@ -357,6 +409,11 @@ jobs:
           p12-file-base64: ${{ secrets.HGUANDL_SIGN_CERT_P12 }}
           p12-password: ${{ secrets.HGUANDL_SIGN_CERT_PASSWD }}
 
+      - name: Setup Xcode Toolchain
+        if: true
+        run: |
+          sudo xcode-select -s /Applications/Xcode_15.3.app/Contents/Developer
+
       - name: Build Universal Binaries
         run: |
           mkdir build
@@ -364,6 +421,24 @@ jobs:
             lipo -create install-arm64/$LIB_NAME install-x86_64/$LIB_NAME -output build/$LIB_NAME
           done
 
+      - name: Archive Runtime Files
+        run: |
+          mkdir runtime && cd runtime
+          name='MAA-${{ needs.meta.outputs.tag }}-macos-runtime-universal'
+          mkdir "$name" && cd "$name"
+          cp -v ../../build/*.dylib .
+          ln -vs libonnxruntime*.dylib libonnxruntime.dylib
+          ln -vs libopencv_world4*.dylib libopencv_world4.dylib
+          cp -vr ../../resource .
+          cd .. || exit 1
+          zip -yrX9 "$name.zip" "$name"
+
+      - name: Upload MAA runtime to Github
+        uses: actions/upload-artifact@v4
+        with:
+          name: MAA-macos-runtime-universal
+          path: runtime/MAA-${{ needs.meta.outputs.tag }}-macos-runtime-universal.zip
+
       - name: Build XCFramework
         run: |
           xcodebuild -create-xcframework -library libMaaCore.dylib -headers ../include -output MaaCore.xcframework
@@ -439,8 +514,12 @@ jobs:
           path: ${{ startsWith(github.ref, 'refs/tags/v') && 'release/MAA*' || 'src/MaaMacGui/MAA.xcarchive/**' }}
 
   release:
-    if: startsWith(github.ref, 'refs/tags/v')
-    needs: [meta, windows, ubuntu, macOS-GUI]
+    # Prevent duplicate runs on organization branches with PRs
+    if: (github.event_name != 'pull_request' ||
+      github.event.pull_request.head.repo.full_name !=
+      github.event.pull_request.base.repo.full_name) && startsWith(github.ref, 'refs/tags/v')
+
+    needs: [meta, windows, ubuntu, macOS-Core, macOS-GUI]
     runs-on: ubuntu-latest
     steps:
       - name: Download MAA from Github
@@ -457,7 +536,7 @@ jobs:
           find . -type f | while read f; do mv -fvt . $f; done
 
       - name: Release to Github
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
         with:
           body_path: CHANGELOG.md
           files: |

.github/workflows/gen-changelog.yml

@@ -2,7 +2,7 @@ name: gen-changelog
 
 on:
   pull_request:
-    types: 
+    types:
       - opened
       - reopened
       - ready_for_review
@@ -79,8 +79,9 @@ jobs:
           git commit -m "$commit_msg"
 
       - name: Create PR
-        uses: peter-evans/create-pull-request@v5
+        uses: peter-evans/create-pull-request@v7
         with:
+          sign-commits: true
           token: ${{ secrets.GITHUB_TOKEN }}
           title: ${{ steps.extract_tag.outputs.pr_title }}
           body-path: ${{ format('{0}/{1}', runner.temp, 'output' ) }}
@@ -93,6 +94,6 @@ jobs:
             AnnAngela
 
       - name: Add reviewers to release PR
-        uses: kentaro-m/auto-assign-action@v1.2.5
+        uses: kentaro-m/auto-assign-action@v2.0.0
         with:
           configuration-path: ".github/release_reviewers.yaml"

.github/workflows/issue-checker.yml

@@ -1,4 +1,5 @@
 name: "Issue Checker"
+
 on:
   issues:
     types: [opened, edited]
@@ -16,7 +17,7 @@ jobs:
   triage:
     runs-on: ubuntu-latest
     steps:
-      - uses: zzyyyl/issue-checker@v1.8
+      - uses: MaaAssistantArknights/issue-checker@v1.14
         with:
           repo-token: "${{ secrets.GITHUB_TOKEN }}"
           configuration-path: .github/issue-checker.yml

.github/workflows/markdown-checker.yml

@@ -1,49 +1,56 @@
-name: Lint Markdown files
+name: Check Dead Links
 
 on:
-  push:
-    paths:
-      - "**/*.md"
-      - ".github/workflows/lint-markdown.yml"
-  pull_request:
-    paths:
-      - "**/*.md"
-      - ".github/workflows/lint-markdown.yml"
   schedule:
-    - cron: "44 7 * * 2"
+    - cron: "0 0 * * 2" # Every Tuesday at 00:00 UTC
+  push:
+    branches:
+      - dev
+    paths:
+      - "**/*.md"
+      - "docs/**"
+      - ".github/workflows/markdown-checker.yml"
+  pull_request:
+    branches:
+      - dev
+    paths:
+      - "**/*.md"
+      - "docs/**"
+      - ".github/workflows/markdown-checker.yml"
   workflow_dispatch:
 
 jobs:
-  lint:
-    name: Lint Markdown
+  check-links:
+    if: github.repository_owner == 'MaaAssistantArknights' && github.event.head_commit.author.email != '41898282+github-actions[bot]@users.noreply.github.com'
+    name: Check Dead Links
     runs-on: ubuntu-latest
+    permissions:
+      pull-requests: write
     steps:
       - name: Check out code
         uses: actions/checkout@v4
         with:
           show-progress: false
 
-      - name: Lint Markdown
-        uses: DavidAnson/markdownlint-cli2-action@v16
+      - name: Check dead links
+        uses: lycheeverse/lychee-action@v2
         with:
-          config: docs/.markdownlint.yaml
-          globs: |
-            README.md
-            docs/**/*.md
+          # 仅检查内部链接和 Github 相关链接
+          args: >
+            --verbose --no-progress --cache --max-cache-age 1d
+            --exclude 'https?://.*'
+            --include 'https?://github\.com/.*'
+            --include 'https?://raw\.githubusercontent\.com/.*'
+            --include 'https?://user-images\.githubusercontent\.com/.*'
+            --exclude-path 'docs/zh-tw/manual/introduction/introduction_old.md'
+            --exclude-path 'docs/ja-jp/manual/introduction/introduction_old.md'
+            --exclude 'files/MAA_Runtime_Fix_Pwsh.ps1$'
+            -- './docs/**/*.md' './README.md'
 
-#  check-links:
-#    name: Check Dead Links
-#    runs-on: ubuntu-latest
-#    steps:
-#      - name: Check out code
-#        uses: actions/checkout@v4
-#        with:
-#          show-progress: false
-#
-#      - name: Check Dead Link
-#        uses: umbrelladocs/action-linkspector@v1
-#        with:
-#          # Use github-pr-review when triggered by a pull request; otherwise, use github-check
-#          reporter: ${{ github.event_name == 'pull_request' && 'github-pr-review' || 'github-check' }}
-#          filter_mode: nofilter
-#          fail_on_error: true
+      - name: Comment (only for PR)
+        if: failure() && github.event_name == 'pull_request'
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          message: |
+            Dead links found in the documentation. Please fix them.
+            Details: https://github.com/MaaAssistantArknights/MaaAssistantArknights/actions/runs/${{ github.run_id }}

.github/workflows/optimize-templates.yml

@@ -0,0 +1,108 @@
+name: Optimize PNG Templates
+
+on:
+  push:
+    branches:
+      - "dev"
+    paths:
+      - "resource/**/*.png"
+      - "docs/.vuepress/public/images/**"
+      - "website/apps/web/public/**"
+      - "website/apps/web/src/assets/links/**"
+  workflow_dispatch:
+    inputs:
+      commit_message:
+        description: "Commit Message"
+        type: string
+        required: false
+
+jobs:
+  optimize-png:
+    # Skip workflow to prevent double consecutive runs
+    # Skip workflow on PR merges
+    if: github.repository_owner == 'MaaAssistantArknights' && ${{ github.event.head_commit.author.email != '41898282+github-actions[bot]@users.noreply.github.com' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check for direct push
+        id: check_push
+        run: |
+          if [[ "${{ github.event_name }}" != "workflow_dispatch" ]]; then
+            pr_merge_status=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+              "https://api.github.com/repos/${{ github.repository }}/commits/${{ github.event.after }}/pulls" | xargs)
+
+            if [[ "$pr_merge_status" == "[ ]" ]]; then
+              echo "Direct push detected. Proceeding..."
+              echo "is_pr=False" >> $GITHUB_OUTPUT
+            else
+              echo "PR merge detected. Exiting."
+              echo "is_pr=True" >> $GITHUB_OUTPUT
+            fi
+          else
+            echo "Manual trigger detected. Proceeding..."
+            echo "is_pr=False" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Checkout repository
+        if: steps.check_push.outputs.is_pr != 'True'
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          persist-credentials: false
+
+      - name: Setup python
+        if: steps.check_push.outputs.is_pr != 'True'
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Cache Python packages
+        id: cache_python
+        if: steps.check_push.outputs.is_pr != 'True' && always()
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.pythonLocation }}/lib/python3.11/site-packages
+          key: ${{ runner.os }}-pip-optimize-templates-${{ hashFiles('./tools/OptimizeTemplates/requirements.txt') }}
+
+      - name: Install dependencies
+        if: steps.check_push.outputs.is_pr != 'True' && steps.cache_python.outputs.cache-hit != 'true'
+        run: |
+          pip install -r tools/OptimizeTemplates/requirements.txt
+
+      - name: Setup oxipng
+        if: steps.check_push.outputs.is_pr != 'True'
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: oxipng
+
+      - name: Run optimize_templates
+        if: steps.check_push.outputs.is_pr != 'True'
+        run: |
+          python3 tools/OptimizeTemplates/optimize_templates.py
+
+      - name: Commit changes
+        id: commit_changes
+        if: steps.check_push.outputs.is_pr != 'True'
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+          git add .
+
+          if git diff-index --quiet HEAD --; then
+            echo "No changes to commit"
+          else
+            commit_msg="${{ github.event.inputs.commit_message }}"
+            if [ -z "$commit_msg" ]; then
+              commit_msg="chore: Auto Templates Optimization"
+            fi
+            git commit -m "$commit_msg" -m "Triggered by ${{github.sha}}" -m "[skip changelog]"
+            git pull origin $(git rev-parse --abbrev-ref HEAD) --unshallow --rebase
+            echo "have_commits=True" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Push changes
+        if: steps.check_push.outputs.is_pr != 'True' && steps.commit_changes.outputs.have_commits == 'True'
+        uses: ad-m/github-push-action@master
+        with:
+          github_token: ${{ secrets.MAA_RESOURCE_SYNC }}
+          branch: ${{ github.ref }}

.github/workflows/pr-checker.yml

@@ -4,7 +4,6 @@ on:
   pull_request_target:
     types: [opened, edited, ready_for_review, reopened, synchronize]
 
-
 jobs:
   check_commit_name_in_pr:
     if: ${{ !github.event.pull_request.merged && github.base_ref != 'master' }}
@@ -39,7 +38,7 @@ jobs:
               per_page: 100
             });
 
-            const regex = /^((build|chore|ci|docs?|feat!?|fix|perf|refactor|rft|style|test|i18n|typo)[\:\.\(\,]|[Rr]evert|[Rr]elease)/;
+            const regex = /^((build|chore|ci|docs?|feat!?|fix|perf|refactor|rft|style|test|i18n|typo|debug)[\:\.\(\,]|[Rr]evert|[Rr]elease)/;
             const invalidCommits = commits.filter(commit => !regex.test(commit.commit.message) || commit.parents.length > 1);
 
             console.log(`Checked ${commits.length} commit(s)`);
@@ -52,8 +51,8 @@ jobs:
                 owner: context.repo.owner,
                 repo: context.repo.repo,
                 issue_number: context.payload.pull_request.number,
-                body: `## ⚠️ Found ${invalidCommits.length} invalid commit(s):\n\n${invalidCommitInfoList}\n\n---\nPlease follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) format.`
+                body: `## ⚠️ Found ${invalidCommits.length} invalid commit(s):\n\n${invalidCommitInfoList}\n\n---\nPlease follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) format, and do not use merge commits.`
               });
 
               core.setFailed(`Found ${invalidCommits.length} invalid commit(s):\n${invalidCommitNames.join("\n-------------------\n")}`);
-            }
+            }

.github/workflows/release-nightly-ota.yml

@@ -1,6 +1,8 @@
 name: release-nightly-ota
 
 on:
+  schedule:
+    - cron: "0 22 * * *" # Runs daily at 22:00 UTC
   workflow_dispatch:
     inputs:
       release_body:
@@ -11,25 +13,24 @@ on:
         description: "Commit to build (git checkout)"
         type: string
         required: false
-      limit:
+      limit_maa:
         description: "Number of releases to fetch from MaaAssistantArknights"
         required: true
-        default: 30
+        default: "10"
         type: number
-      limit_2:
+      limit_mr:
         description: "Number of releases to fetch from MaaRelease"
         required: true
-        default: 30
+        default: "10"
         type: number
 
 jobs:
   build-win-nightly:
+    if: github.repository_owner == 'MaaAssistantArknights'
     runs-on: windows-latest
     strategy:
       matrix:
-        include:
-          - msbuild_target: x64
-            lowercase_target: x64
+        msbuild_target: [x64]
       fail-fast: false
     env:
       MAABUILDER_TARGET_PLATFORM: ${{ matrix.msbuild_target }}
@@ -37,73 +38,133 @@ jobs:
       tag: ${{ steps.set_tag.outputs.tag }}
       pre_version: ${{ steps.set_tag.outputs.pre_version }}
       main_tag_name: ${{ steps.push_main_tag.outputs.main_tag_name }}
-      changelog: ${{ steps.generate_changelog.outputs.changelog }}
+      changelog: ${{ steps.read_changelog.outputs.content }}
     steps:
       - uses: actions/checkout@v4
         with:
           # repository: 'MaaAssistantArknights/MaaAssistantArknights'
-          submodules: recursive
           #ref: ${{ inputs.ref }}
-          fetch-depth: 0
           token: ${{ secrets.GITHUB_TOKEN }}
+          fetch-depth: 250
+          fetch-tags: true
 
-      - name: Checkout ref
+      - name: Fetch submodules
         run: |
-          if ("${{ inputs.ref }}" -ne "") {
-            git checkout --progress --recurse-submodules ${{ inputs.ref || 'dev' }}
-          }
+          git submodule update --init --depth 1 3rdparty/EmulatorExtras
 
-      - name: Install semver
+      - name: Checkout ref (if provided)
+        if: inputs.ref != ''
         run: |
-          npm install --global --progress semver
+          git checkout --progress --recurse-submodules ${{ inputs.ref }}
 
-      - name: Set tag
+      - name: Check for Changes and Set tag
         id: set_tag
         run: |
-          # pre_version是上一个公版，这里需要拉上一个tag，避免堆积过多commit
-          $latest_tag=$(git describe --tags --abbrev=0)
-          echo "latest_tag=$latest_tag" >> $env:GITHUB_OUTPUT
-          $described = $(git describe --tags --long --match 'v*')
-          $ids = $($described -split "-")
-          if ($ids.length -eq 3) {
-            $ver = "v$(semver --increment $ids[0].Substring(1))"
-            $pre_version = "$($ids[0])"
-            $dist = `printf "%03d"` $ids[1]
-            echo "tag=$ver-alpha.1.d$($dist).$($ids[2])" >> $env:GITHUB_OUTPUT
-            echo "pre_version=$pre_version" >> $env:GITHUB_OUTPUT
+          # Fetch the latest tag from the repository
+          $latest_tag = git describe --tags --abbrev=0
+
+          # Check for changes between the latest tag and HEAD
+          $recent_changes = git log "$latest_tag..HEAD" --oneline
+
+          if (-not $recent_changes) {
+            Write-Output "No commits. Cancelling workflow..."
+            Write-Output "cancel_run=true" >> $env:GITHUB_ENV
+            exit 0
+          } else {
+            Write-Output "Recent commits: $recent_changes"
+            Write-Output "Commits found. Continuing build..."
+            Write-Output "cancel_run=false" >> $env:GITHUB_ENV
+          }
+
+          Write-Output "Previous Tag: $latest_tag"
+          Write-Output "latest_tag=$latest_tag" >> $env:GITHUB_OUTPUT
+
+          # Get the full description of the current commit
+          $described = git describe --tags --long --match 'v*'
+          Write-Output "New Described: $described"
+          $ids = $described -split "-"
+
+          if ($ids.Length -eq 3) {
+            # Extract and parse the current version
+            $current_version = $ids[0].Substring(1)
+            $parts = $current_version -split '\.'
+            if ($parts.Length -ne 3) {
+              Write-Error "Invalid version format: $current_version. Expected 'major.minor.patch'."
+              exit 1
+            }
+
+            # Increment the patch version
+            $parts[2] = [int]$parts[2] + 1
+            $new_version = "$($parts[0]).$($parts[1]).$($parts[2])"
+
+            # Construct the new tag and pre_version
+            $ver = "v$new_version"
+            $pre_version = $ids[0]
+            $dist = "{0:D3}" -f [int]$ids[1]
+
+            Write-Output "pre_version=$pre_version" >> $env:GITHUB_OUTPUT
+            Write-Output "New Tag: $ver-alpha.1.d$dist.$($ids[2])"
+            Write-Output "tag=$ver-alpha.1.d$dist.$($ids[2])" >> $env:GITHUB_OUTPUT
+
             exit 0
           }
-          if ($ids.length -eq 4) {
-            $dist = `printf "%03d"` $ids[2]
-            $pre_version = "$($ids[0])""-""$($ids[1])"
-            echo "tag=$($ids[0])-$($ids[1]).d$($dist).$($ids[3])" >> $env:GITHUB_OUTPUT
-            echo "pre_version=$pre_version" >> $env:GITHUB_OUTPUT
+
+          if ($ids.Length -eq 4) {
+            $dist = "{0:D3}" -f [int]$ids[2]
+            $pre_version = "$($ids[0])-$($ids[1])"
+
+            Write-Output "Pre Version: $pre_version"
+            Write-Output "pre_version=$pre_version" >> $env:GITHUB_OUTPUT
+
+            Write-Output "tag: $pre_version.d$dist.$($ids[3])"
+            Write-Output "tag=$pre_version.d$dist.$($ids[3])" >> $env:GITHUB_OUTPUT
+
             exit 0
           }
+
           exit 1
 
-      - name: Push tag to main repo
-        id: push_main_tag
+      - name: Stop if no changes
+        if: env.cancel_run == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          git config user.name 'github-actions[bot]'
-          git config user.email 'github-actions[bot]@users.noreply.github.com'
+          curl -s -L -X POST `
+            -H "Accept: application/vnd.github+json" `
+            -H "Authorization: Bearer ${{ secrets.MAA_ACTION_READ_WRITE }}" `
+            -H "X-GitHub-Api-Version: 2022-11-28" `
+            "https://api.github.com/repos/MaaAssistantArknights/MaaAssistantArknights/actions/runs/${{ github.run_id }}/cancel" > $null
 
-          $main_tag_name=$(echo "alpha/${{ steps.set_tag.outputs.tag }}")
-          git tag $main_tag_name -f
-          git push --tags origin HEAD:refs/tags/$main_tag_name -f
-          echo "main_tag_name=$main_tag_name" >> $env:GITHUB_OUTPUT
+          gh run watch ${{ github.run_id }}
 
       - name: Generate Changelog
         id: generate_changelog
         run: |
           python3 tools/ChangelogGenerator/changelog_generator.py --latest "${{ steps.set_tag.outputs.latest_tag }}" --tag "${{ steps.set_tag.outputs.tag }}"
-          $content=$(((Get-Content .\changelog.md) | Select-Object -Skip 2) -join "\n\n") 
-          echo "changelog=$content" >> $env:GITHUB_OUTPUT
-          echo $content
+          Get-Content .\changelog.md | Select-Object -Skip 2 | Out-File -FilePath changelog_notag.md -Encoding utf8
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PYTHONIOENCODING: "utf-8"
 
+      - name: Stop if no changes
+        if: steps.generate_changelog.outputs.cancel_run == 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          curl -s -L -X POST `
+            -H "Accept: application/vnd.github+json" `
+            -H "Authorization: Bearer ${{ secrets.MAA_ACTION_READ_WRITE }}" `
+            -H "X-GitHub-Api-Version: 2022-11-28" `
+            "https://api.github.com/repos/MaaAssistantArknights/MaaAssistantArknights/actions/runs/${{ github.run_id }}/cancel" > $null
+
+          gh run watch ${{ github.run_id }}
+
+      - name: Read Changelog to variable
+        id: read_changelog
+        uses: juliangruber/read-file-action@v1
+        with:
+          path: ./changelog_notag.md
+
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget
         uses: actions/cache@v4
@@ -111,17 +172,26 @@ jobs:
           path: |
             .nuke/temp
             ~/.nuget/packages
-          key: ${{ runner.os }}-${{ hashFiles('**/global.json', '**/*.csproj') }}
+          key: ${{ runner.os }}-${{ matrix.msbuild_target }}-${{ hashFiles('**/global.json', '**/*.csproj') }}
 
       - name: Restore dependencies
         if: steps.cache-nuget.outputs.cache-hit != 'true'
         run: dotnet restore
 
+      - name: Cache MaaDeps
+        id: cache-maadeps
+        uses: actions/cache@v4
+        with:
+          path: |
+            ./MaaDeps
+          key: ${{ runner.os }}-${{ matrix.msbuild_target }}-maadeps-${{ hashFiles('./maadeps-download.py') }}
+
       - name: Bootstrap MaaDeps
-        run: |
-          python3 maadeps-download.py ${{ matrix.lowercase_target }}-windows
+        if: steps.cache-maadeps.outputs.cache-hit != 'true'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          python3 maadeps-download.py ${{ matrix.msbuild_target }}-windows
 
       - name: Taggify Version
         run: |
@@ -159,10 +229,22 @@ jobs:
       - name: Upload MAA to Github
         uses: actions/upload-artifact@v4
         with:
-          name: MAA-win-${{ matrix.lowercase_target }}
+          name: MAA-win-${{ matrix.msbuild_target }}
           path: artifacts
 
+      - name: Push tag to main repo
+        id: push_main_tag
+        run: |
+          git config user.name 'github-actions[bot]'
+          git config user.email 'github-actions[bot]@users.noreply.github.com'
+
+          $main_tag_name=$(echo "alpha/${{ steps.set_tag.outputs.tag }}")
+          git tag $main_tag_name -f
+          git push --tags origin HEAD:refs/tags/$main_tag_name -f
+          echo "main_tag_name=$main_tag_name" >> $env:GITHUB_OUTPUT
+
   push-tag:
+    if: github.repository_owner == 'MaaAssistantArknights'
     needs: build-win-nightly
     runs-on: ubuntu-latest
     steps:
@@ -185,6 +267,7 @@ jobs:
           git push --tags origin HEAD:refs/tags/${{ needs.build-win-nightly.outputs.tag }}
 
   make-ota:
+    if: github.repository_owner == 'MaaAssistantArknights'
     needs: [build-win-nightly, push-tag]
     strategy:
       matrix:
@@ -212,8 +295,17 @@ jobs:
         run: |
           mkdir -pv build-ota && cd build-ota
 
-          gh release list --repo 'MaaAssistantArknights/MaaAssistantArknights' --limit ${{ inputs.limit || 30 }} | tee ./release_maa.txt
-          gh release list --repo "${{ github.repository_owner }}/MaaRelease" --limit ${{ inputs.limit_2 || 30 }} | tee ./release_mr.txt
+          # Convert inputs to integers
+          limit_maa=${{ inputs.limit_maa || 10 }}
+          limit_maa=${limit_maa%.*}
+          echo "Parsed limit_maa: $limit_maa"
+
+          limit_mr=${{ inputs.limit_mr || 10 }}
+          limit_mr=${limit_mr%.*}
+          echo "Parsed limit_mr: $limit_mr"
+
+          gh release list --repo 'MaaAssistantArknights/MaaAssistantArknights' --limit $limit_maa | tee ./release_maa.txt
+          gh release list --repo "${{ github.repository_owner }}/MaaRelease" --limit $limit_mr | tee ./release_mr.txt
           echo ${{ needs.build-win-nightly.outputs.tag }} > ./config
 
           cat ./release_maa.txt | awk '{ print $1 }' > ./tags_maa.txt
@@ -242,22 +334,6 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Make release body
-        id: make_release_body
-        shell: bash
-        run: |
-          pre_version=${{ needs.build-win-nightly.outputs.pre_version }}
-          cur_version=${{ needs.build-win-nightly.outputs.main_tag_name }}
-          echo -e "${{ inputs.release_body || '' }}\n\n${{ needs.build-win-nightly.outputs.changelog }}\n\n**Full Changelog**: [$pre_version -> $cur_version](https://github.com/$GITHUB_REPOSITORY/compare/$pre_version...$cur_version)" > alpha_changelog.md
-          export r=$(cat alpha_changelog.md)
-
-          # https://github.com/svenstaro/upload-release-action
-          r="${r//'%'/'%25'}"                               # Multiline escape sequences for %
-          r="${r//$'\n'/'%0A'}"                             # Multiline escape sequences for '\n'
-          r="${r//$'\r'/'%0D'}"                             # Multiline escape sequences for '\r'
-          echo $r
-          echo "full_release_body=$r" >> $GITHUB_OUTPUT
-
       - name: Upload to MaaRelease
         uses: svenstaro/upload-release-action@v2
         with:
@@ -268,7 +344,12 @@ jobs:
           tag: ${{ env.release_tag }}
           prerelease: true
           overwrite: true
-          body: ${{ steps.make_release_body.outputs.full_release_body }}
+          body: |
+            ${{ inputs.release_body || '' }}
+
+            ${{ needs.build-win-nightly.outputs.changelog }}
+
+            **Full Changelog**: [${{ needs.build-win-nightly.outputs.pre_version }} -> ${{ needs.build-win-nightly.outputs.main_tag_name }}](https://github.com/${{ github.repository }}/compare/${{ needs.build-win-nightly.outputs.pre_version }}...${{ needs.build-win-nightly.outputs.main_tag_name }})
 
       - name: Setup release mirror
         run: |

.github/workflows/release-ota.yml

@@ -9,12 +9,12 @@ on:
       limit:
         description: Number of releases to fetch from MaaAssistantArknights, 2 at least
         required: false
-        default: '31'
+        default: "31"
         type: number
       limit_2:
         description: Number of releases to fetch from MaaRelease
         required: false
-        default: '30'
+        default: "30"
         type: number
 
 env:
@@ -37,8 +37,18 @@ jobs:
         id: fetchReleaseInfo
         run: |
           mkdir -pv build-ota && cd build-ota
-          gh release list --repo 'MaaAssistantArknights/MaaAssistantArknights' --limit ${{ inputs.limit || 31 }} | tee ./release_maa.txt
-          gh release list --repo "MaaAssistantArknights/MaaRelease" --limit ${{ inputs.limit_2 || 30 }} | tee ./release_mr.txt
+
+          # Convert inputs to integers
+          limit=${{ inputs.limit || 31 }}
+          limit=${limit%.*}
+          echo "Parsed limit: $limit"
+
+          limit_2=${{ inputs.limit_2 || 30 }}
+          limit_2=${limit_2%.*}
+          echo "Parsed limit_2: $limit_2"
+
+          gh release list --repo 'MaaAssistantArknights/MaaAssistantArknights' --limit $limit | tee ./release_maa.txt
+          gh release list --repo "MaaAssistantArknights/MaaRelease" --limit $limit_2 | tee ./release_mr.txt
           head -n 1 ./release_maa.txt | awk '{ print $1 }' > ./config
 
           tail -n +1 ./release_maa.txt | awk '{ print $1 }' > ./tags_maa.txt
@@ -156,31 +166,6 @@ jobs:
         run: |
           find ./packages -type f ! \( -name 'MAA-${{ needs.create-tag.outputs.release_tag }}-macos-universal.dmg' -o -name '*.delta' -o -name '*.xml' \) -print -delete
 
-      - name: Unpack the .dmg files for .dylib
-        run: |
-          cd ${{ runner.temp }}
-          mkdir -p macos-runtime-temp
-          echo ::group::Attaching release package...
-          hdiutil attach ${{ github.workspace }}/packages/MAA-${{ needs.create-tag.outputs.release_tag }}-macos-universal.dmg
-          echo ::endgroup::
-          echo ::group::Copying files...
-          cp -v /Volumes/MAA/MAA.app/Contents/Frameworks/*.dylib macos-runtime-temp/
-          cp -vr /Volumes/MAA/MAA.app/Contents/Resources/resource macos-runtime-temp/resource
-          echo ::endgroup::
-          echo ::group::Linking files...
-          libonnxruntime_file=$(basename macos-runtime-temp/libonnxruntime*.dylib)
-          ln -vs $libonnxruntime_file macos-runtime-temp/libonnxruntime.dylib
-          libopencv_world_file=$(basename macos-runtime-temp/libopencv_world*.dylib)
-          ln -vs $libopencv_world_file macos-runtime-temp/libopencv_world4.dylib
-          echo ::endgroup::
-          cd macos-runtime-temp
-          echo ::group::Compressing files...
-          zip -yrX9 ${{ github.workspace }}/packages/MAA-${{ needs.create-tag.outputs.release_tag }}-macos-runtime-universal.zip *
-          echo ::endgroup::
-          echo ::group::Detaching release package...
-          hdiutil detach /Volumes/MAA
-          echo ::endgroup::
-
       - name: Upload to MaaRelease
         uses: svenstaro/upload-release-action@v2
         with:

.github/workflows/res-update-game.yml

@@ -2,7 +2,7 @@ name: res-update-game
 
 on:
   schedule:
-    - cron: "*/20 * * * *"
+    - cron: "*/20 * * * *" # Runs every 20 minutes
   workflow_dispatch:
     inputs:
       commit_message:
@@ -11,38 +11,18 @@ on:
         required: false
 
 jobs:
-  update-game-resources:
+  clone-resources-official:
     if: github.repository_owner == 'MaaAssistantArknights'
-    runs-on: windows-latest
-    env:
-      GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}
+    runs-on: ubuntu-latest
     steps:
-      - name: Checkout MAA
-        uses: actions/checkout@v4
-        with:
-          show-progress: false
-          token: ${{ secrets.MISTEOWORKFLOW }}
-
-      - name: Bootstrap MaaDeps
-        run: |
-          python3 maadeps-download.py x64-windows
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Add msbuild to PATH
-        uses: microsoft/setup-msbuild@v1
-
-      - name: Build Resource Updater
-        run: |
-          MSBUILD tools/ResourceUpdater/ResourceUpdater.vcxproj /t:rebuild /p:Configuration="Release" /p:Platform="x64" /p:BuildProjectReferences=false /m
-
       - name: Clone ArknightsGameResource for Official
         uses: actions/checkout@v4
         with:
           show-progress: false
           repository: yuanyan3060/ArknightsGameResource
           ref: main
-          path: .\tools\ResourceUpdater\x64\Release\Official
+          path: ./Official
+          sparse-checkout-cone-mode: false
           sparse-checkout: |
             /levels.json
             /item
@@ -54,15 +34,26 @@ jobs:
             /gamedata/excel/gacha_table.json
             /gamedata/excel/roguelike_topic_table.json
             /gamedata/excel/activity_table.json
-          sparse-checkout-cone-mode: false
 
+      - name: Upload Official
+        uses: actions/upload-artifact@v4
+        with:
+          name: official
+          path: ./Official
+          compression-level: 0
+
+  clone-resources-overseas:
+    if: github.repository_owner == 'MaaAssistantArknights'
+    runs-on: ubuntu-latest
+    steps:
       - name: Clone ArknightsGameResource_Yostar for Overseas
         uses: actions/checkout@v4
         with:
           show-progress: false
           repository: Kengxxiao/ArknightsGameData_Yostar
           ref: main
-          path: .\tools\ResourceUpdater\x64\Release\Overseas
+          path: ./Overseas
+          sparse-checkout-cone-mode: false
           sparse-checkout: |
             /en_US/gamedata/excel/item_table.json
             /en_US/gamedata/excel/building_data.json
@@ -85,105 +76,273 @@ jobs:
             /ko_KR/gamedata/excel/gacha_table.json
             /ko_KR/gamedata/excel/roguelike_topic_table.json
             /ko_KR/gamedata/excel/activity_table.json
-          sparse-checkout-cone-mode: false
 
+      - name: Upload Official
+        uses: actions/upload-artifact@v4
+        with:
+          name: overseas
+          path: ./Overseas
+          compression-level: 0
+
+  clone-resources-txwy:
+    if: github.repository_owner == 'MaaAssistantArknights'
+    runs-on: ubuntu-latest
+    steps:
       - name: Clone arknights-toolbox-update for Taiwan
         uses: actions/checkout@v4
         with:
           show-progress: false
           repository: arkntools/arknights-toolbox-update
           ref: data-tw
-          path: .\tools\ResourceUpdater\x64\Release\Overseas\zh_TW\gamedata\excel
+          path: ./excel
           token: ${{ secrets.ARKNTOOLS_MAA_RESOURCE_UPDATER}}
 
+      - name: Download stages.json from Penguin Stats
+        run: |
+          cd "./excel"
+
+          baseUrl="https://penguin-stats.io/PenguinStats/api/v2/stages?server="
+
+          parameters=("CN" "US" "JP" "KR")
+
+          for param in "${parameters[@]}"; do
+            {
+              if curl -s -o "stages_${param}.json" "${baseUrl}${param}"; then
+                echo "Successfully fetched data for ${param}"
+              else
+                echo "Failed to fetch data for ${param}" >&2
+                exit 1
+              fi
+            } &
+          done
+          wait
+
+      - name: Upload Official
+        uses: actions/upload-artifact@v4
+        with:
+          name: txwy
+          path: ./excel
+          compression-level: 0
+
+  update-game-resources:
+    # In case of rate limitations on the runners/instances, add dependency, by removing the comment
+
+    # needs: [clone-resources-official, clone-resources-overseas, clone-resources-txwy]
+    if: github.repository_owner == 'MaaAssistantArknights'
+    runs-on: windows-latest
+    steps:
+      - name: Checkout MAA
+        uses: actions/checkout@v4
+        with:
+          # TL;DR https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/9872#issuecomment-2251378371
+          # actions/checkout uses ${{ secrets.GITHUB_TOKEN }} by default, meaning all steps will inherit it
+          persist-credentials: false # Needed to bypass protection rules in Push changes
+          show-progress: false
+          fetch-depth: 3
+
+      - name: Restore ResourceUpdater.exe from cache
+        id: cache-resupd
+        uses: actions/cache/restore@v4
+        with:
+          key: Resource-updater-${{ hashFiles('./tools/ResourceUpdater/main.cpp') }}
+          path: |
+            ./tools/ResourceUpdater/x64/Release/opencv_world4_maa.dll
+            ./tools/ResourceUpdater/x64/Release/ResourceUpdater.exe
+
+      - name: Cache MaaDeps
+        if: steps.cache-resupd.outputs.cache-hit != 'true'
+        id: cache-maadeps
+        uses: actions/cache@v4
+        with:
+          path: |
+            ./MaaDeps
+          key: ${{ runner.os }}-x64-maadeps-${{ hashFiles('./maadeps-download.py') }}
+
+      - name: Bootstrap MaaDeps
+        if: steps.cache-resupd.outputs.cache-hit != 'true' && steps.cache-maadeps.outputs.cache-hit != 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          python3 maadeps-download.py x64-windows
+
+      - name: Add msbuild to PATH
+        if: steps.cache-resupd.outputs.cache-hit != 'true'
+        uses: microsoft/setup-msbuild@v2
+
+      - name: Build Resource Updater
+        if: steps.cache-resupd.outputs.cache-hit != 'true'
+        run: |
+          MSBUILD tools/ResourceUpdater/ResourceUpdater.vcxproj /t:rebuild /p:Configuration="Release" /p:Platform="x64" /p:BuildProjectReferences=false /m
+
+      - name: Save ResourceUpdater.exe to cache
+        if: always() && steps.cache-resupd.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v4
+        with:
+          key: Resource-updater-${{ hashFiles('./tools/ResourceUpdater/main.cpp') }}
+          path: |
+            ./tools/ResourceUpdater/x64/Release/opencv_world4_maa.dll
+            ./tools/ResourceUpdater/x64/Release/ResourceUpdater.exe
+
+      - name: Download txwy
+        id: download-txwy
+        uses: actions/download-artifact@v4.1.8
+        continue-on-error: true
+        with:
+          name: txwy
+          path: ./tools/ResourceUpdater/x64/Release/Overseas/zh_TW/gamedata/excel
+
+      - name: Delay txwy
+        if: steps.download-txwy.outcome == 'failure'
+        run: |
+          Start-Sleep -s 20
+
+      - name: Re-download txwy
+        if: steps.download-txwy.outcome == 'failure'
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: txwy
+          path: ./tools/ResourceUpdater/x64/Release/Overseas/zh_TW/gamedata/excel
+
+      - name: Download Overseas
+        id: download-overseas
+        uses: actions/download-artifact@v4.1.8
+        continue-on-error: true
+        with:
+          name: overseas
+          path: ./tools/ResourceUpdater/x64/Release/Overseas
+
+      - name: Delay Overseas
+        if: steps.download-overseas.outcome == 'failure'
+        run: |
+          Start-Sleep -s 20
+
+      - name: Re-download Overseas
+        if: steps.download-overseas.outcome == 'failure'
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: overseas
+          path: ./tools/ResourceUpdater/x64/Release/Overseas
+
+      - name: Download Official
+        id: download-official
+        uses: actions/download-artifact@v4.1.8
+        continue-on-error: true
+        with:
+          name: official
+          path: ./tools/ResourceUpdater/x64/Release/Official
+
+      - name: Delay Official
+        if: steps.download-official.outcome == 'failure'
+        run: |
+          Start-Sleep -s 20
+
+      - name: Re-download Official
+        if: steps.download-official.outcome == 'failure'
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: official
+          path: ./tools/ResourceUpdater/x64/Release/Official
+
       - name: Run Resource Updater
         run: |
-          .\tools\ResourceUpdater\x64\Release\ResourceUpdater.exe
+          ./tools/ResourceUpdater/x64/Release/ResourceUpdater.exe
 
-      - name: Overseas Tasks Ordering
+      - name: Task Sorting
+        id: task_sorting
         run: |
           python3 tools/TaskSorter/TaskSorter.py
+          Write-Output "gitdiff=$(git diff --name-only --diff-filter=ACM 2>$null | Select-String -Pattern '\.json$' -List)" >> $env:GITHUB_OUTPUT
 
-      - name: Check if only sorted
-        id: check_only_sorted
+      - name: Run prettier
+        uses: Nerixyz/actionsx-prettier@v3-adj
+        with:
+          args: -w ${{ steps.task_sorting.outputs.gitdiff }}
+
+      - name: Check if only sorted and Templates
+        id: check_sorted_templates
+        run: pwsh tools/ResourceUpdater/validator.ps1
+
+      - name: Setup python
+        if: steps.check_sorted_templates.outputs.contains_png == 'True'
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Cache Python packages
+        if: always() && steps.check_sorted_templates.outputs.contains_png == 'True'
+        id: cache_python
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.pythonLocation }}/Lib/site-packages
+          key: ${{ runner.os }}-pip-optimize-templates-${{ hashFiles('./tools/OptimizeTemplates/requirements.txt') }}
+
+      - name: Install dependencies
+        if: steps.cache_python.outputs.cache-hit != 'true' && steps.check_sorted_templates.outputs.contains_png == 'True'
         run: |
-          git status
+          pip install -r tools/OptimizeTemplates/requirements.txt
 
-          $diff = $(git diff --numstat HEAD | findstr -i resource)
-          if ($LASTEXITCODE -ne 0) {
-            echo "no diff"
-            exit 0
-          }
+      - name: Setup oxipng
+        if: steps.check_sorted_templates.outputs.contains_png == 'True'
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: oxipng
 
-          echo "diff: "$diff
-          $sp = $($diff -split "\s+")
-          $numbers = $($sp | Where-Object { $_ -match "^\d+$" })
-          echo "numbers: "$numbers
-
-          $length = $numbers.Length
-          $noDiff = $true
-          for ($i = 0; $i -lt $length; $i += 2) {
-            $firstNumber = $numbers[$i]
-            $secondNumber = $numbers[$i+1]
-
-            if ($firstNumber -gt 1) {
-              $noDiff = $false
-              break
-            }
-            
-            if ($firstNumber -ne $secondNumber) {
-                $noDiff = $false
-                break
-            }
-          }
-          echo "noDiff: "$noDiff
-          echo "only_sorted=$noDiff" >> $env:GITHUB_OUTPUT
-
-      - name: Cancelling
-        if: steps.check_only_sorted.outputs.only_sorted == 'True'
-        uses: andymckay/cancel-action@0.3
+      - name: Run optimize_templates
+        if: steps.check_sorted_templates.outputs.contains_png == 'True'
+        run: |
+          python3 tools/OptimizeTemplates/optimize_templates.py -p resource/template/items/ resource/template/infrast/
 
       - name: Add files to git
-        if: steps.check_only_sorted.outputs.only_sorted != 'True'
+        if: steps.check_sorted_templates.outputs.changes == 'True'
         id: add_files
         run: |
-          git status
-
-          git config user.name "$env:GITHUB_ACTOR"
-          git config user.email "$env:GITHUB_ACTOR@users.noreply.github.com"
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git add .
 
           $commit_msg = "${{ github.event.inputs.commit_message }}"
-          if (-not [string]::IsNullOrWhiteSpace($commit_msg)) {
-            $commit_msg = $commit_msg.Trim()
-          } else {
+          if ([string]::IsNullOrWhiteSpace($commit_msg)) {
             $commit_msg = "chore: Auto Update Game Resources - $(Get-Date -Format 'yyyy-MM-dd')"
+          } else {
+            $commit_msg = $commit_msg.Trim()
           }
-          git commit -m "$commit_msg" -m "[skip changelog]"
+
+          $run_url = "https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}"
+
+          git commit -m "$commit_msg" -m "$run_url" -m "[skip changelog]"
           if ($LASTEXITCODE -eq 0) {
-            echo "have_commits=True" >> $env:GITHUB_OUTPUT
+            Write-Output "have_commits=True" >> $env:GITHUB_OUTPUT
           }
 
-          git pull origin $(git rev-parse --abbrev-ref HEAD) --unshallow --rebase
+          git pull origin ${{ github.ref_name }} --rebase
 
-      - name: Cancelling
-        if: steps.add_files.outputs.have_commits != 'True'
-        uses: andymckay/cancel-action@0.3
-
-      - name: Push changes # push the output folder to your repo
+      - name: Push changes
         if: steps.add_files.outputs.have_commits == 'True'
         uses: ad-m/github-push-action@master
         with:
-          github_token: ${{ secrets.MISTEOWORKFLOW }}
+          branch: ${{ github.ref }}
+          github_token: ${{ secrets.MAA_RESOURCE_SYNC }}
 
       - name: Update OTA resource
         if: steps.add_files.outputs.have_commits == 'True'
+        env:
+          GH_TOKEN: ${{ secrets.MAA_RESOURCE_SYNC }}
         run: |
           gh workflow --repo MaaAssistantArknights/MaaRelease run update-resource.yml
 
+      # - name: Delete cache
+      #   if: always()
+      #   env:
+      #     GH_TOKEN: ${{ github.token }}
+      #   run: |
+      #     echo "Deleting the cache..."
+      #     gh cache delete
+
+      - name: Add cancelled status
+        if: steps.check_sorted_templates.outputs.changes != 'True' || steps.add_files.outputs.have_commits != 'True'
+        uses: andymckay/cancel-action@0.5
+
     #   - name: Release # ref: https://docs.github.com/en/actions/using-workflows/triggering-a-workflow#triggering-a-workflow-from-a-workflow
     #     if: steps.add_files.outputs.have_commits == 'True'
     #     run: |
     #       gh workflow run release-nightly-ota -f release_body="Auto Release of Resource Updates"
-    #     env:
-    #       GH_TOKEN: ${{ github.token }}

.github/workflows/smoke-testing.yml

@@ -1,78 +1,121 @@
-name: test
+name: smoke-testing
 
 on:
   push:
     paths:
       - "3rdparty/include/**"
       - "include/**"
-      - "src/**"
-      - "cmake/**"
-      - "CMakeLists.txt"
+      - "src/Cpp/**"
+      - "src/MaaCore/**"
+      - "src/SyncRes/**"
       - "MAA.sln"
       - "resource/**"
-      - "MaaDeps/**"
       - "!**/*.md"
   pull_request:
     paths:
       - "3rdparty/include/**"
       - "include/**"
-      - "src/**"
-      - "cmake/**"
-      - "CMakeLists.txt"
+      - "src/Cpp/**"
+      - "src/MaaCore/**"
+      - "src/SyncRes/**"
       - "MAA.sln"
       - "resource/**"
-      - "MaaDeps/**"
       - "!**/*.md"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   smoke-testing:
+    # Prevent duplicate runs on organization branches with PRs
+    if: github.event_name != 'pull_request' ||
+      github.event.pull_request.head.repo.full_name !=
+      github.event.pull_request.base.repo.full_name
     runs-on: windows-latest
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
         with:
           show-progress: false
-          submodules: recursive
-          
-      - name: Restore dependencies
-        run: dotnet restore
-      
+
+      - name: Generate cache key
+        id: cache_key
+        run: |
+          Write-Output "key=Smoke-testing-${{ hashFiles('src/Cpp/**', 'src/MaaCore/**', 'src/SyncRes/**', '3rdparty/include/**', 'include/**', 'MAA.sln') }}" >> $env:GITHUB_OUTPUT
+
+      - name: Restore cache smoke-testing
+        id: cache-exe
+        uses: actions/cache/restore@v4
+        with:
+          key: ${{ steps.cache_key.outputs.key }}
+          path: |
+            ./x64/Debug/Sample.exe
+            ./x64/Debug/fastdeploy_ppocr.dll
+            ./x64/Debug/MaaCore.dll
+            ./x64/Debug/onnxruntime_maa.dll
+            ./x64/Debug/opencv_world4d_maa.dll
+
+      - name: Fetch submodules
+        if: steps.cache-exe.outputs.cache-hit != 'true'
+        run: |
+          git submodule update --init --depth 1 3rdparty/EmulatorExtras
+
+      - name: Cache MaaDeps
+        if: steps.cache-exe.outputs.cache-hit != 'true'
+        id: cache-maadeps
+        uses: actions/cache@v4
+        with:
+          path: |
+            ./MaaDeps
+          key: ${{ runner.os }}-x64-maadeps-${{ hashFiles('./maadeps-download.py') }}
+
       - name: Bootstrap MaaDeps
+        if: steps.cache-exe.outputs.cache-hit != 'true' && steps.cache-maadeps.outputs.cache-hit != 'true'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           python3 maadeps-download.py x64-windows
 
       - name: Add msbuild to PATH
-        uses: microsoft/setup-msbuild@v1
+        if: steps.cache-exe.outputs.cache-hit != 'true'
+        uses: microsoft/setup-msbuild@v2
+        with:
+          msbuild-architecture: x64
+
       - name: Build MaaSample
+        if: steps.cache-exe.outputs.cache-hit != 'true'
         run: |
-          MSBUILD src/Cpp/MaaSample.slnf /t:rebuild /p:Configuration="Debug" /p:Platform="x64" /m
+          MSBUILD src/Cpp/MaaSample.slnf -t:restore,build -p:Configuration="Debug" -p:Platform="x64" -m
 
-      - name: Run tests - Official #用来判断是不是国服资源出错导致外服全炸
+      - name: Copy resource to build directory
+        if: steps.cache-exe.outputs.cache-hit == 'true'
         run: |
-          .\x64\Debug\Sample.exe
+          (robocopy "resource" "x64/Debug/resource" /E /XD "Arknights-Tile-Pos" /MT:4 > $null);
+          if ($LASTEXITCODE -lt 2) { $global:LASTEXITCODE = $null }
+          (robocopy "resource/Arknights-Tile-Pos" "x64/Debug/resource/Arknights-Tile-Pos" "overview.json" > $null);
+          if ($LASTEXITCODE -lt 2) { $global:LASTEXITCODE= $null }
 
-      - name: Run tests - YostarJP
+      - name: Run tests
         run: |
-          .\x64\Debug\Sample.exe YostarJP
-          
-      - name: Run tests - YostarEN
-        run: |
-          .\x64\Debug\Sample.exe YostarEN
-        
-      - name: Run tests - YostarKR
-        run: |
-          .\x64\Debug\Sample.exe YostarKR
-        
-      - name: Run tests - txwy
-        run: |
-          .\x64\Debug\Sample.exe txwy
+          pwsh tools/SmokeTesting/run_tests.ps1
+
+      - name: Save cache smoke-testing (only in dev)
+        if: steps.cache-exe.outputs.cache-hit != 'true' && github.ref == 'refs/heads/dev'
+        uses: actions/cache/save@v4
+        with:
+          key: ${{ steps.cache_key.outputs.key }}
+          path: |
+            ./x64/Debug/Sample.exe
+            ./x64/Debug/fastdeploy_ppocr.dll
+            ./x64/Debug/MaaCore.dll
+            ./x64/Debug/onnxruntime_maa.dll
+            ./x64/Debug/opencv_world4d_maa.dll
 
       - name: Upload logs
         if: always()
         uses: actions/upload-artifact@v4
         with:
-          name: log
-          path: .\x64\Debug\debug
+          name: logs
+          path: ./x64/Debug/debug

.github/workflows/stale.yml

@@ -0,0 +1,39 @@
+name: "Inactive Issues Closer"
+
+on:
+  schedule:
+    - cron: "0 0 * * *" # Runs daily at UTC 00:00
+  workflow_dispatch: # Allows manual triggering
+
+env: # config
+  daysBeforeStale: 90 # Number of days of inactivity before marking as stale
+  daysBeforeClose: 7 # Number of days to wait after marking as stale before closing
+
+jobs:
+  stale:
+    if: github.repository_owner == 'MaaAssistantArknights'
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write # Workaround for https://github.com/actions/stale/issues/1090
+      issues: write
+      # Completely disable stalling for PRs
+      pull-requests: none
+      contents: none
+    steps:
+      - name: Close inactive issues
+        uses: actions/stale@v9
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          days-before-stale: ${{ env.daysBeforeStale }}
+          days-before-close: ${{ env.daysBeforeClose }}
+          stale-issue-label: "stale"
+          stale-issue-message: |
+            This issue has been inactive for a prolonged period and will be closed automatically in ${{ env.daysBeforeClose }} days.
+            该问题已长时间处于闲置状态，${{ env.daysBeforeClose }} 天后将自动关闭。
+          exempt-issue-labels: "keep-open, MAA Team, enhancement"
+          days-before-pr-stale: -1 # Completely disable stalling for PRs
+          days-before-pr-close: -1 # Completely disable closing for PRs
+
+          # Temporary to reduce the huge issues number
+          operations-per-run: 100
+          debug-only: false

.github/workflows/sync-resource.yml

@@ -1,16 +1,17 @@
 name: sync-resource
 
 on:
-  workflow_dispatch:
   push:
     branches:
       - dev
     paths:
       - "resource/**"
       - ".github/workflows/sync-resource.yml"
+  workflow_dispatch:
 
 jobs:
-  sync-reource:
+  sync-resource:
+    if: github.repository_owner == 'MaaAssistantArknights'
     runs-on: ubuntu-latest
 
     steps:

.github/workflows/website-workflow.yml

@@ -43,7 +43,7 @@ jobs:
         with:
           node-version: 20
           cache: pnpm
-          cache-dependency-path: './website/pnpm-lock.yaml'
+          cache-dependency-path: "./website/pnpm-lock.yaml"
 
       - name: Install dependencies
         run: pnpm install --frozen-lockfile

.gitignore

@@ -437,6 +437,9 @@ tools/**/*.png
 .vscode
 enc_temp_folder/*
 
+# RoguelikeRecruitmentTool 导出的 Excel 文件
+tools/RoguelikeRecruitmentTool/output
+
 # Nuke
 .nuke/temp/*
 
@@ -448,3 +451,9 @@ enc_temp_folder/*
 # CF 活动关卡（异格夜刀），手动改的地图
 /resource/Arknights-Tile-Pos/act24side_09-activities-act24side-level_act24side_09.json
 /src/MaaWpfGui/FodyWeavers.xml
+
+# 链接检查缓存
+.lycheecache
+
+# MaaDeps
+/MaaDeps/*

.gitmodules

@@ -4,11 +4,6 @@
 [submodule "src/MaaMacGui"]
 	path = src/MaaMacGui
 	url = https://github.com/MaaAssistantArknights/MaaMacGui.git
-[submodule "MaaDeps"]
-	path = MaaDeps
-	url = https://github.com/MaaAssistantArknights/MaaDeps
-	shallow = true
-	branch = master
 [submodule "src/maa-cli"]
 	path = src/maa-cli
 	url = https://github.com/MaaAssistantArknights/maa-cli.git

.linkspector.yml

@@ -1,5 +0,0 @@
-dirs:
-  - .
-useGitIgnore: true
-ignorePatterns:
-  - pattern: "^https?://127.0.0.1(:\\d+)?/"

.nuke/build.schema.json

@@ -1,132 +1,127 @@
 {
-  "$schema": "http://json-schema.org/draft-04/schema#",
-  "title": "Build Schema",
-  "$ref": "#/definitions/build",
-  "definitions": {
-    "build": {
-      "type": "object",
-      "properties": {
-        "Continue": {
-          "type": "boolean",
-          "description": "Indicates to continue a previously failed build attempt"
-        },
-        "Help": {
-          "type": "boolean",
-          "description": "Shows the help text for this build assembly"
-        },
-        "Host": {
-          "type": "string",
-          "description": "Host for execution. Default is 'automatic'",
-          "enum": [
-            "AppVeyor",
-            "AzurePipelines",
-            "Bamboo",
-            "Bitbucket",
-            "Bitrise",
-            "GitHubActions",
-            "GitLab",
-            "Jenkins",
-            "Rider",
-            "SpaceAutomation",
-            "TeamCity",
-            "Terminal",
-            "TravisCI",
-            "VisualStudio",
-            "VSCode"
-          ]
-        },
-        "NoLogo": {
-          "type": "boolean",
-          "description": "Disables displaying the NUKE logo"
-        },
-        "Partition": {
-          "type": "string",
-          "description": "Partition to use on CI"
-        },
-        "Plan": {
-          "type": "boolean",
-          "description": "Shows the execution plan (HTML)"
-        },
-        "Profile": {
-          "type": "array",
-          "description": "Defines the profiles to load",
-          "items": {
-            "type": "string"
-          }
-        },
-        "Root": {
-          "type": "string",
-          "description": "Root directory during build execution"
-        },
-        "Skip": {
-          "type": "array",
-          "description": "List of targets to be skipped. Empty list skips all dependencies",
-          "items": {
-            "type": "string",
-            "enum": [
-              "Default",
-              "DevBuild",
-              "DevBuildDefault",
-              "DevBuildReleaseSimulation",
-              "ReleaseMaa",
-              "SetMaaChangeLog",
-              "SetPackageBundled",
-              "SetVersion",
-              "UseClean",
-              "UseCommitVersion",
-              "UseMaaChangeLog",
-              "UseMaaDevBundle",
-              "UseMaaRelease",
-              "UsePublishArtifact",
-              "UsePublishRelease",
-              "UseRsVersion",
-              "UseTagVersion",
-              "WithCompileCoreRelease",
-              "WithCompileWpfRelease",
-              "WithSyncRes"
-            ]
-          }
-        },
-        "Target": {
-          "type": "array",
-          "description": "List of targets to be invoked. Default is '{default_target}'",
-          "items": {
-            "type": "string",
-            "enum": [
-              "Default",
-              "DevBuild",
-              "DevBuildDefault",
-              "DevBuildReleaseSimulation",
-              "ReleaseMaa",
-              "SetMaaChangeLog",
-              "SetPackageBundled",
-              "SetVersion",
-              "UseClean",
-              "UseCommitVersion",
-              "UseMaaChangeLog",
-              "UseMaaDevBundle",
-              "UseMaaRelease",
-              "UsePublishArtifact",
-              "UsePublishRelease",
-              "UseRsVersion",
-              "UseTagVersion",
-              "WithCompileCoreRelease",
-              "WithCompileWpfRelease",
-              "WithSyncRes"
-            ]
-          }
-        },
-        "Verbosity": {
-          "type": "string",
-          "description": "Logging verbosity during build execution. Default is 'Normal'",
-          "enum": [
-            "Minimal",
-            "Normal",
-            "Quiet",
-            "Verbose"
-          ]
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "title": "Build Schema",
+    "$ref": "#/definitions/build",
+    "definitions": {
+        "build": {
+            "type": "object",
+            "properties": {
+                "Continue": {
+                    "type": "boolean",
+                    "description": "Indicates to continue a previously failed build attempt"
+                },
+                "Help": {
+                    "type": "boolean",
+                    "description": "Shows the help text for this build assembly"
+                },
+                "Host": {
+                    "type": "string",
+                    "description": "Host for execution. Default is 'automatic'",
+                    "enum": [
+                        "AppVeyor",
+                        "AzurePipelines",
+                        "Bamboo",
+                        "Bitbucket",
+                        "Bitrise",
+                        "GitHubActions",
+                        "GitLab",
+                        "Jenkins",
+                        "Rider",
+                        "SpaceAutomation",
+                        "TeamCity",
+                        "Terminal",
+                        "TravisCI",
+                        "VisualStudio",
+                        "VSCode"
+                    ]
+                },
+                "NoLogo": {
+                    "type": "boolean",
+                    "description": "Disables displaying the NUKE logo"
+                },
+                "Partition": {
+                    "type": "string",
+                    "description": "Partition to use on CI"
+                },
+                "Plan": {
+                    "type": "boolean",
+                    "description": "Shows the execution plan (HTML)"
+                },
+                "Profile": {
+                    "type": "array",
+                    "description": "Defines the profiles to load",
+                    "items": {
+                        "type": "string"
+                    }
+                },
+                "Root": {
+                    "type": "string",
+                    "description": "Root directory during build execution"
+                },
+                "Skip": {
+                    "type": "array",
+                    "description": "List of targets to be skipped. Empty list skips all dependencies",
+                    "items": {
+                        "type": "string",
+                        "enum": [
+                            "Default",
+                            "DevBuild",
+                            "DevBuildDefault",
+                            "DevBuildReleaseSimulation",
+                            "ReleaseMaa",
+                            "SetMaaChangeLog",
+                            "SetPackageBundled",
+                            "SetVersion",
+                            "UseClean",
+                            "UseCommitVersion",
+                            "UseMaaChangeLog",
+                            "UseMaaDevBundle",
+                            "UseMaaRelease",
+                            "UsePublishArtifact",
+                            "UsePublishRelease",
+                            "UseRsVersion",
+                            "UseTagVersion",
+                            "WithCompileCoreRelease",
+                            "WithCompileWpfRelease",
+                            "WithSyncRes"
+                        ]
+                    }
+                },
+                "Target": {
+                    "type": "array",
+                    "description": "List of targets to be invoked. Default is '{default_target}'",
+                    "items": {
+                        "type": "string",
+                        "enum": [
+                            "Default",
+                            "DevBuild",
+                            "DevBuildDefault",
+                            "DevBuildReleaseSimulation",
+                            "ReleaseMaa",
+                            "SetMaaChangeLog",
+                            "SetPackageBundled",
+                            "SetVersion",
+                            "UseClean",
+                            "UseCommitVersion",
+                            "UseMaaChangeLog",
+                            "UseMaaDevBundle",
+                            "UseMaaRelease",
+                            "UsePublishArtifact",
+                            "UsePublishRelease",
+                            "UseRsVersion",
+                            "UseTagVersion",
+                            "WithCompileCoreRelease",
+                            "WithCompileWpfRelease",
+                            "WithSyncRes"
+                        ]
+                    }
+                },
+                "Verbosity": {
+                    "type": "string",
+                    "description": "Logging verbosity during build execution. Default is 'Normal'",
+                    "enum": ["Minimal", "Normal", "Quiet", "Verbose"]
+                }
+            }
         }
-      }
     }
-  }
-}
+}

.nuke/parameters.json

@@ -1,4 +1,4 @@
 {
-  "$schema": "./build.schema.json",
-  "Solution": "tools/MaaBuilder.sln"
+    "$schema": "./build.schema.json",
+    "Solution": "tools/MaaBuilder.sln"
 }

.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+default_install_hook_types: [pre-commit, prepare-commit-msg]
+ci:
+  autofix_commit_msg: "chore: Auto update by pre-commit hooks [skip changelog]"
+  autofix_prs: true
+repos:
+  - repo: https://github.com/shssoichiro/oxipng
+    rev: v9.1.2
+    hooks:
+      - id: oxipng
+        args: ["-q", "-o", "2", "-s", "--ng"]
+  - repo: https://github.com/pre-commit/mirrors-clang-format
+    rev: v17.0.1
+    hooks:
+      - id: clang-format
+        files: ^src/MaaCore/.*
+        args: ["--assume-filename", ".clang-format"]
+  - repo: https://github.com/pre-commit/mirrors-prettier
+    rev: v4.0.0-alpha.8
+    hooks:
+      - id: prettier
+        types_or:
+          - yaml
+          - json
+  - repo: https://github.com/DavidAnson/markdownlint-cli2
+    rev: v0.13.0
+    hooks:
+      - id: markdownlint-cli2
+        files: ^docs/.*|^README\.md$
+        types:
+          - markdown
+        args: ["--fix", "--config", "docs/.markdownlint.yaml", "#**/node_modules"]

.prettierignore

@@ -0,0 +1,10 @@
+**/node_modules/
+
+MaaDeps/
+3rdparty/
+src/maa-cli
+src/MaaMacGui
+
+website/
+resource/Arknights-Tile-Pos/
+tools/OptimizeTemplates/optimize_templates.json

.prettierrc

@@ -0,0 +1,17 @@
+{
+    "tabWidth": 4,
+    "printWidth": 120,
+    "useTabs": false,
+    "bracketSameLine": true,
+    "bracketSpacing": true,
+    "endOfLine": "auto",
+    "overrides": [
+        {
+            "files": [".clang-format", "**/*.yml", "**/*.yaml"],
+            "options": {
+                "parser": "yaml",
+                "tabWidth": 2
+            }
+        }
+    ]
+}

3rdparty/include/Arknights-Tile-Pos/TileCalc2.hpp

@@ -39,8 +39,8 @@ inline matrix4x4 camera_matrix_from_trans(
     const vec3d& euler,
     double ratio,
     double fov_2_y = 20 * degree,
-    double far = 1000,
-    double near = 0.3)
+    double far_c = 1000,
+    double near_c = 0.3)
 {
     const double cos_y = std::cos(euler[0]);
     const double sin_y = std::sin(euler[0]);
@@ -66,11 +66,11 @@ inline matrix4x4 camera_matrix_from_trans(
         0, -sin_x, -cos_x, 0, //
         0, 0,      0,      1,
     };
-    const matrix4x4 proj = {
+    const matrix4x4 proj = matrix4x4 {
         // clang-format off
         ratio / tan_f,  0,         0, 0,
         0,              1 / tan_f, 0, 0,
-        0,              0,         -(far + near) / (far - near), -(far * near * 2) / (far - near),
+        0,              0,         -(far_c + near_c) / (far_c - near_c), -(far_c * near_c * 2) / (far_c - near_c),
         0,              0,         -1, 0,
         // clang-format on
     };
@@ -78,14 +78,13 @@ inline matrix4x4 camera_matrix_from_trans(
     return proj * matrixX * matrixY * translate;
 }
 
-inline cv::Point
-    world_to_screen(const Level& level, const vec3d& world_pos, bool side, const vec3d& offset = {})
+inline cv::Point world_to_screen(const Level& level, const vec3d& world_pos, bool side, const vec3d& offset = {})
 {
-    static constexpr double width = 1280;
-    static constexpr double height = 720;
+    static constexpr int width = 1280;
+    static constexpr int height = 720;
     const vec3d pos_cam = camera_pos(level, side, width, height) + offset;
     const vec3d euler = camera_euler_angles_yxz(level, side);
-    const matrix4x4 matrix = camera_matrix_from_trans(pos_cam, euler, height / width);
+    const matrix4x4 matrix = camera_matrix_from_trans(pos_cam, euler, static_cast<double>(height) / width);
     auto result = matrix * cv::Point3d(world_pos);
     result = result / result(3);
     result = (result + cv::Vec4d::ones()) / 2.;
@@ -107,12 +106,7 @@ inline vec3d get_tile_world_pos(const Level& level, int tile_y, int tile_x)
     };
 }
 
-inline auto get_tile_screen_pos(
-    const Level& level,
-    int tile_y,
-    int tile_x,
-    bool side = false,
-    const vec3d& offset = {})
+inline auto get_tile_screen_pos(const Level& level, int tile_y, int tile_x, bool side = false, const vec3d& offset = {})
 {
     return world_to_screen(level, get_tile_world_pos(level, tile_y, tile_x), side, offset);
 }

CHANGELOG.md

@@ -1,15 +1,166 @@
-## v5.4.1
+## v5.12.2
+
+### 没有测试的稳定版真的能叫稳定版吗 | Highlight
+
+* 正式版先不更了，之后还是走正常的发版流程。拿了几个号测了测自动和自定义基建都没啥问题。还有问题的点 `设置`-`关于我们`-`问题反馈` 带日志发 issue
+
+### 修复 | Fix
+
+* 基建修复3 (反复进出训练室；宿舍识别错误；会客室识别错误)(#11629) @ABA2396
+* 基建确认按钮 @ABA2396
+
+## v5.12.1
+
+### 新增 | New
+
+* 繁中服 生息演算【沙洲遺聞】 (#11620) @momomochi987
+
+### 修复 | Fix
+
+* 基建修复2 (#11618) @ABA2396
+* “围攻”主题 基建无法打开 (#11615) @ClozyA
+
+## v5.12.0
+
+### 没有测试的稳定版真的能叫稳定版吗 | Highlight
+
+* 为了修基建包的饺子
+
+### 新增 | New
+
+* 繁中服 抽幸運牆的功能 (#11602) @momomochi987
+* Colored logs for I.S. (#11593) @Constrat
+* SideStory「相见欢」导航 (#11597) @SherkeyXD
+* 优化肉鸽刷开局模式的流程和逻辑 (#11559) @DavidWang19 @ABA2396 @status102 @pre-commit-ci[bot] @HX3N @momomochi987 @Constrat
+* 肉鸽月度小队/深入调查基础策略+自动切换 (#11566) @BxFS @Constrat @pre-commit-ci[bot] @status102
+* 萨卡兹肉鸽卫士不语功战斗策略调整 (#11582) @ClozyA @pre-commit-ci[bot]
+* SimpleEncryptionHelper 新增 DataProtectionScope 参数 @ABA2396
+* 萨卡兹肉鸽卫士不语功战斗策略调整 (#11577) @ClozyA
+* 萨卡兹肉鸽添加丛林密布，卡兹瀑布，遮天蔽日，有序清场，血脉之辩 (#11564) @MYAknight @pre-commit-ci[bot] @Daydreamer114
+* Bazaar Orundum activities YostarEN @Constrat
+* InvertNullFunction method @Constrat
+* 优化下载速度显示 (#11541) @502y @status102
+* 萨卡兹肉鸽刷开局 2 构想 (#11277) @Alan-Charred
+* preload YostarEN AS navitation @Constrat
+* 点刺、后勤种子存钱 & ProcessTask 添加 Input 方法 (#11521) @Daydreamer114 @ABA2396
+* 肉鸽满级自动停止选项 (#11466) @BxFS @Constrat @HX3N @momomochi987 @status102
+* 为肉鸽开始探索添加 cd 识别 (#11443) @Daydreamer114
+* 萨卡兹肉鸽冰川期作战策略 @Daydreamer114
+* 萨卡兹内容拓展II点刺进入商店获得构想 (#11509) @Daydreamer114
+* 不自动招募1/5/6星干员时，不计入最大确认招募次数 (#11380) @Roland125 @pre-commit-ci[bot] @horror-proton
+* 干员识别排除当前客户端未出干员 @ABA2396
+* 肉鸽开局干员列表排除当前客户端未出干员 @ABA2396
+
+### 改进 | Improved
+
+* give priority to higher value choices in I.S. encounter.json (#11580) @Constrat
+* 肉鸽战斗完成判定MissionCompletedFlag移除重复模板 @status102
+* WpfGui重构 一键长草任务callback拆分 (#11548) @status102
+* 肉鸽优先拿美愿 (#11558) @WWPXX233
+* 简化萨卡兹肉鸽种子入口 @status102
+* 延后WpfGui肉鸽开始探索次数输出至SubTaskCompleted @status102
+* 肉鸽投资移除手中没钱时的额外检测重试 @status102
+* Wpf重构 拆分模拟器关闭相关 (#11547) @status102
+* Wpf重构 拆分`开始唤醒`任务 (#11533) @status102
+* 肉鸽难度设置移动当前选项至列表顶部 @status102
+* 新增投掷手干员组并调整优先级 @Daydreamer114
+* 优化傀影肉鸽雪山上的来客ew部署 (#11195) @Daydreamer114
+* manual recursion + robocopy for smoke-testing (#11458) @Constrat
+* implement cache for smoke-test (#11457) @Constrat
+
+### 修复 | Fix
+
+* 修复基建 (#11598) @SherkeyXD @pre-commit-ci[bot] @ABA2396
+* 修复基建排班错误和加工站卡住 (#11590) @HauKuen
+* 萨卡兹肉鸽种子存钱分队选择失败 @status102
+* tw 黍 百炼嘉维尔 OcrReplace (#11591) @Saratoga-Official
+* reduce ROI to detect special value in Sami I.S. for EN @Constrat
+* EN Sami GamePassSkip2 @Constrat
+* 萨卡兹肉鸽使用种子刷钱参数存储分类错误 @status102
+* Phantom IS GamePass EN template @Constrat
+* EN Mizuki stuck on end screen @Constrat
+* incorrect ROI AS navigation for YostarEN & KR @Constrat
+* Resource Updater for YostarEN (AS-Event) @Constrat
+* add delay to Roguelike@QuickFormation @Constrat
+* 弹出公告或窗口时开始任务，进度条会显示在新窗口 @ABA2396
+* 修复肉鸽种子模式引起的异常卡死 (#11552) @weinibuliu @Daydreamer114
+* 94a8e01543a420bf70b6eef2539fea46466f2699 (#11553) @status102
+* Return-White.png 识别 (#11469) @BxFS
+* 截图失败时清空image_payload @status102
+* 修复肉鸽开始探索重试时额外占用开始次数 @status102
+* empty string option @Constrat
+* get display for General (#11516) @jbwfu
+* 生息演算为点击右上角天数任务添加重试机制 (#11540) @Alan-Charred
+* 肉鸽烧热水没烧出来会从预设难度开始，而不是返回n0 @ABA2396
+* 删除傀影肉鸽远方来客意义不明的撤退 (#11194) @Daydreamer114
+* delay and retry downloads on resource updater (#11504) @Constrat
+* use read/write secret to delete cache on pr merge @Constrat
+* 博朗台计算等待时间失败数据处理 @status102
+* increase fetch depth for release nightly-ota to generate tags (might need successive increases) @Constrat
+* 修正nothing to select情况下的判断逻辑 @Roland125
+* update Collect Rewards template for EN fix #11485 @Constrat
+* tw OcrReplace 肉鸽招募助战 (#11487) @Saratoga-Official
+* 繁中服作戰失敗畫面卡住 (#11479) @momomochi987
+* InitialDrop.png更新 @Constrat @BxFS
+* txwy duplicates in tasks.json @Constrat
+* checkout depth for nightly ota @Constrat
+* 更新 “视相“ 主题后未关闭退出基建弹窗时无法回到主界面 @ABA2396
+* `手动输入关卡名` 与  `使用剩余理智` 选项无法保存 @ABA2396
 
 ### 文档 | Docs
 
-* website docs (#9287) @ABA2396 @Rbqwow @Constrat @wangl-cc @HX3N @SherkeyXD
-* 修改win7相关问题描述&更新运行库 @Rbqwow
-* fix a bad link @Rbqwow
-* make i18n warnings show only once @Rbqwow
-* 修复字体和评论区分类 @Rbqwow
+* 补充 Roguelike 任务 investment_with_more_score 与 start_with_two_ideas 参数的文档 (#11546) @Alan-Charred
+* changelog to v5.12.0-b1 @status102
+* changelog 难度描述 (#11532) @Daydreamer114
+* changelog @status102
+* Auto Update Changelogs of v5.11.2 (#11530) @github-actions[bot] @Daydreamer114
+* 为肉鸽参数 start_with_seed 添加文档 (#11531) @Daydreamer114
+* 肉鸽辅助协议文档翻译 (#11360) @Windsland52
 
-### For Overseas
+### 其他 | Other
 
-#### YostarEN
-
-* YoStarEN resolution warning on client switch (#9539) @Constrat @ABA2396
+* 我知道稳定版不稳定，所以就叫正式版吧 @ABA2396
+* 隐藏公告关闭窗口，底部添加关闭按钮 @ABA2396
+* refactor：提取 HandlePreviewMouseWheel @ABA2396
+* YostarKR Mizuki DataTraceBack (#11584) @HX3N @pre-commit-ci[bot]
+* YostarJP Mizuki DataTraceBack (#11579) @Manicsteiner
+* 目录下存在 DEBUG_skill_ready.txt 时自动收集技能准备状态截图 (#11571) @ABA2396
+* 不将已进驻的干员放入宿舍能用了吗？修了不知道有没有修好 @ABA2396
+* [ recruitment tool ] use StrEnum instead of Enum for Theme (#11421) @Alan-Charred
+* 长草任务ViewModel调整 @status102
+* YostarKR update OrudumActivities (#11563) @HX3N
+* YostarJP ocr update (#11561) @Manicsteiner
+* 剿灭任务失败不报错 @ABA2396
+* tasks.json配置JsonSchema @status102
+* reapply reclamation rft on taskqueueviewmodel @Constrat
+* WpfGui长草任务迁移至TaskQueue @status102
+* YostarEN Phantom IS update run end skip @Constrat
+* missing templates yostaren phantom IS @Constrat
+* remove -Werror from CMakeLists.txt @horror-proton
+* PlayToolsController start_game及input方法增加log输出提示 @status102
+* YostarKR AS navigation (#11537) @HX3N
+* YostarJP AS navigation (#11535) @Manicsteiner
+* 修改雷电截图增强描述 @ABA2396
+* Release v5.12.0-beta.1 (#11529) @status102
+* Release 模式下，如文件夹中包含 DEBUG.txt 也会输出 DBG 日志 (#11496) @ABA2396
+* 移动企鹅物流及一图流上报设置 至 运行设置 @status102
+* Translations update from MAA Weblate (#11524) @AlisaAkiron
+* ignore blame for e3d63894b28b2ef5e2405e144a32a6981de5e1b2 oxipng optimization @Constrat
+* disable link checker in issues and PRs (#11506) @Constrat
+* use API for cache-deletion @Constrat
+* 移除不再使用的代码 for 最小化启动模拟器 @status102
+* move `push tag` later in the workflow in case or errors (#11480) @Constrat
+* 上报添加 User-Agent @ABA2396
+* 修改上报抬头 @ABA2396
+* Use %B to consider header for skip changelog @Constrat
+* try setup dotnet cache @Constrat
+* EN duplicates in tasks.json + SSS Buffs @Constrat
+* YostarJP phantom roguelike game pass, SSS#6 (#11473) @Manicsteiner
+* 繁中服「源石塵行動」復刻活動導航 @momomochi987
+* battle_data 未实装干员添加字段提示 @ABA2396
+* 别用 1234567890ABCDEF 去连模拟器了 @ABA2396
+* Revert "refactor: move resource copy to test script" @Constrat
+* `启动 MAA 后直接运行` 和 `启动 MAA 后自动开启模拟器` 改为独立配置 @ABA2396
+* 只有一个配置的时候不显示 `此选项页为全局配置` @ABA2396
+* 当前配置不存在时尝试读取全局配置 @ABA2396
+* Config序列化参数不转义中文 @status102

CMakeLists.txt

@@ -44,10 +44,13 @@ if (MSVC)
 
     set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL")
 else ()
-    target_compile_options(MaaCore PRIVATE "-Wall;-Werror;-Wextra;-Wpedantic;-Wno-missing-field-initializers")
-    if (CMAKE_CXX_COMPILER_ID MATCHES "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 13)
-        target_compile_options(MaaCore PRIVATE "-Wno-restrict")
-    endif()
+    target_compile_options(MaaCore PRIVATE "-Wall;-Wextra;-Wpedantic")
+    # LLVM clang 16 will failed with `error: no member named 'join' in namespace 'std::ranges::views'`, but Apple clang 16 won't
+    # value defined in https://cmake.org/cmake/help/latest/variable/CMAKE_LANG_COMPILER_ID.html
+    if ((CMAKE_CXX_COMPILER_ID STREQUAL "AppleClang" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 16)
+        OR (CMAKE_CXX_COMPILER_ID MATCHES "Clang" AND (NOT CMAKE_CXX_COMPILER_ID STREQUAL "AppleClang") AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 17))
+        target_compile_options(MaaCore PRIVATE "-fexperimental-library")
+    endif ()
 endif ()
 
 if (WIN32)

DependencySetup_依赖库安装.bat

@@ -0,0 +1,18 @@
+@echo off
+chcp 65001
+setlocal enabledelayedexpansion
+
+openfiles >nul 2>&1
+if %errorlevel% neq 0 (
+    echo 正在获取管理员权限...
+    echo Obtaining administrator privileges...
+    powershell -Command "Start-Process cmd.exe -ArgumentList '/c %~dpnx0' -Verb RunAs"
+    exit /b
+)
+
+winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force
+winget install "Microsoft.DotNet.DesktopRuntime.8" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force
+
+echo 运行库修复完成，请重启电脑后再次尝试运行 MAA。
+echo The runtime library repair is complete. Please restart your computer and try running MAA again.
+pause

MAA.sln.DotSettings

@@ -1,4 +1,7 @@
 <wpf:ResourceDictionary xml:space="preserve" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml" xmlns:s="clr-namespace:System;assembly=mscorlib" xmlns:ss="urn:shemas-jetbrains-com:settings-storage-xaml" xmlns:wpf="http://schemas.microsoft.com/winfx/2006/xaml/presentation">
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=EN/@EntryIndexedValue">EN</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=KR/@EntryIndexedValue">KR</s:String>
+	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=JP/@EntryIndexedValue">JP</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=GUI/@EntryIndexedValue">GUI</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/CSharpNaming/Abbreviations/=SWMINIMIZE/@EntryIndexedValue">SWMINIMIZE</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/Abbreviations/=AP/@EntryIndexedValue">AP</s:String>
@@ -28,7 +31,14 @@
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/Abbreviations/=WSA/@EntryIndexedValue">WSA</s:String>
 	<s:String x:Key="/Default/CodeStyle/Naming/XamlNaming/Abbreviations/=XYAZ/@EntryIndexedValue">XYAZ</s:String>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=acast/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=acfend/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=acguad/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=acpion/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=acspec/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=acsupo/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=advapi/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Aero/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Affero/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=aguard/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=amedic/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=amiya/@EntryIndexedValue">True</s:Boolean>
@@ -41,12 +51,22 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Bilibili/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Bluestacks/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=bsconsole/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=ccast/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=cdfend/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=cguard/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=cmedic/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Collapsal/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=cpione/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=csnipe/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=cspec/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=csuppo/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ctrler/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=desp/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=dnplayer/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Ehem/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=esource/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Favourite/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=filetime/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=findstr/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=FLASHW/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=FLASHWINFO/@EntryIndexedValue">True</s:Boolean>
@@ -61,7 +81,12 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=hwnd/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Infrast/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Inited/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=iter/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=jsend/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ldconsole/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=ldplayer/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=LD_0027s/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=leidian/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Lolicon/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=lpwndpl/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ls_005B_0022sub/@EntryIndexedValue">True</s:Boolean>
@@ -77,6 +102,7 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=netstat/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Nonfriend/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=notstationed/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=objstr/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=oper/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=opers/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Originite/@EntryIndexedValue">True</s:Boolean>
@@ -88,9 +114,12 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pallas/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=pidl/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Pormpt/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=powrprof/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=ppidl/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Prts/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=pwfi/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=qmsg/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Raidian/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rcast/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rdfend/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rguard/@EntryIndexedValue">True</s:Boolean>
@@ -99,13 +128,16 @@
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Roguelike/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=rsnipe/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Sami/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Sarkaz/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Screencap/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=sctp/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=serilog/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Showminimized/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Shownormal/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=specialaccess/@EntryIndexedValue">True</s:Boolean>
     <s:Boolean x:Key="/Default/UserDictionary/Words/=SSS/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=STGM/@EntryIndexedValue">True</s:Boolean>
+	<s:Boolean x:Key="/Default/UserDictionary/Words/=Stormeye/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=strlen/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=Stylet/@EntryIndexedValue">True</s:Boolean>
 	<s:Boolean x:Key="/Default/UserDictionary/Words/=subtask/@EntryIndexedValue">True</s:Boolean>

README.md

@@ -2,7 +2,7 @@
 
 <div align="center">
 
-<img alt="LOGO" src="https://cdn.jsdelivr.net/gh/MaaAssistantArknights/design@main/logo/maa-logo_512x512.png" width="256" height="256" />
+<img alt="LOGO" src="./docs/.vuepress/public/images/maa-logo_512x512.png" width="256" height="256" />
 
 # MaaAssistantArknights
 
@@ -37,6 +37,10 @@ MAA 的意思是 MAA Assistant Arknights
 
 </div>
 
+## 下载与安装
+
+请阅读[文档](https://maa.plus/docs/zh-cn/manual/newbie.html)后前往 [官网](https://maa.plus) 或 [Releases](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases) 下载，并参考[新手上路](https://maa.plus/docs/zh-cn/manual/newbie.html)进行安装。
+
 ## 亮点功能
 
 - 刷理智，掉落识别及上传 [企鹅物流](https://penguin-stats.cn/)，[一图流](https://ark.yituliu.cn/)
@@ -55,50 +59,31 @@ MAA 的意思是 MAA Assistant Arknights
 <details><summary>话不多说，看图！</summary>
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/1-dark.png">
-  <img alt="zh1" src="./docs/.vuepress/public/image/zh-cn/readme/1-light.png">
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/images/zh-cn/readme/1-dark.png">
+  <img alt="zh1" src="./docs/.vuepress/public/images/zh-cn/readme/1-light.png">
 </picture>
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/2-dark.png">
-  <img alt="zh2" src="./docs/.vuepress/public/image/zh-cn/readme/2-light.png">
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/images/zh-cn/readme/2-dark.png">
+  <img alt="zh2" src="./docs/.vuepress/public/images/zh-cn/readme/2-light.png">
 </picture>
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/3-dark.png">
-  <img alt="zh3" src="./docs/.vuepress/public/image/zh-cn/readme/3-light.png">
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/images/zh-cn/readme/3-dark.png">
+  <img alt="zh3" src="./docs/.vuepress/public/images/zh-cn/readme/3-light.png">
 </picture>
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/image/zh-cn/readme/4-dark.png">
-  <img alt="zh4" src="./docs/.vuepress/public/image/zh-cn/readme/4-light.png">
+  <source media="(prefers-color-scheme: dark)" srcset="./docs/.vuepress/public/images/zh-cn/readme/4-dark.png">
+  <img alt="zh4" src="./docs/.vuepress/public/images/zh-cn/readme/4-light.png">
 </picture>
 
 </details>
 
 <!-- markdownlint-restore -->
 
-## 下载地址
-
-前往[官网](https://maa.plus)自动匹配镜像源并下载稳定版，或：
-
-- [稳定版/公测版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
-- [内测版](https://github.com/MaaAssistantArknights/MaaRelease/releases)
-
 ## 使用说明
 
-### 基本说明
+### 功能介绍
 
-请参阅 [新手上路](https://maa.plus/docs/zh-cn/manual/newbie.html) 与 [功能介绍](https://maa.plus/docs/zh-cn/manual/introduction/)。
-
-### 常见问题
-
-- 软件一打开就闪退；
-- 连接错误、不知道 ADB 路径怎么填写；
-- 连接成功了，但没反应；
-- 如何连接自定义端口；
-- 下载速度慢，且镜像站无法打开网页；
-- 下载到一半提示“登陆”/“鉴权”；
-- 连接正常，任务开始了，但是没反应。
-
-请参阅 [常见问题](https://maa.plus/docs/zh-cn/manual/faq.html)
+请参阅 [用户手册](https://maa.plus/docs/zh-cn/manual/)。
 
 ### 外服支持
 
@@ -107,7 +92,7 @@ MAA 的意思是 MAA Assistant Arknights
 
 ### CLI 支持
 
-MAA 支持命令行界面（CLI）操作，支持 Linux，macOS 和 Windows，可用于自动化脚本或在无图形界面的服务器上使用。请参阅 [CLI 使用指南](https://maa.plus/docs/zh-cn/manual/cli/intro.html)
+MAA 支持命令行界面（CLI）操作，支持 Linux，macOS 和 Windows，可用于自动化脚本或在无图形界面的服务器上使用。请参阅 [CLI 使用指南](https://maa.plus/docs/zh-cn/manual/cli/)
 
 ## 加入我们
 
@@ -198,13 +183,13 @@ MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）
 - ~~干员及基建数据：[PRTS Wiki](http://prts.wiki/)~~
 - 关卡数据：[企鹅物流数据统计](https://penguin-stats.cn/)
 - 游戏数据及资源：[明日方舟客户端素材](https://github.com/yuanyan3060/ArknightsGameResource)
-- ~~游戏数据：[《明日方舟》游戏数据](https://github.com/Kengxxiao/ArknightsGameData)~~
+- 游戏数据：[《明日方舟》Yostar游戏数据](https://github.com/Kengxxiao/ArknightsGameData_YoStar)
 
 ### 贡献/参与者
 
 感谢所有参与到开发/测试中的朋友们，是大家的帮助让 MAA 越来越好！ (\*´▽｀)ノノ
 
-[![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights&max=114514&columns=15)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
+[![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights&max=105&columns=15)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
 
 ## 声明
 
@@ -212,12 +197,26 @@ MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）
 - 本软件 logo 并非使用 AGPL 3.0 协议开源，[耗毛](https://weibo.com/u/3251357314)、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo，不得在未经授权的情况下将本软件 logo 用于任何用途。
 - 本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能由于设备或时间等原因，产生的任何问题及后果与本软件无关。
 
+### DirectML 支持说明
+
+本软件支持 GPU 加速功能，但 GPU 加速依赖于 Microsoft 提供的 DirectML（Microsoft.AI.DirectML）。为了方便用户，我们随安装包附带了一个未修改的 DirectML.dll 文件。
+
+#### 关于 DirectML.dll
+
+- 来源：Microsoft 官方
+- 许可证：请参考 Microsoft 的 DirectML 使用条款
+  [DirectML 官方文档](https://learn.microsoft.com/en-us/windows/ai/directml/)
+
+DirectML.dll 是 Microsoft 提供的独立组件，不属于本软件的开源部分，也不受 AGPL-3.0 的约束。
+
+如果您不需要 GPU 支持，可以安全地删除该 DLL 文件，软件核心功能仍然可以正常运行。
+
 ## 广告
 
 用户交流 QQ 群：[MAA 使用 & 粥游交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)  
 用户交流 TG 群：[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)  
-自动战斗 JSON 作业分享：[prts.plus](https://prts.plus) 或 [抄作业.com](http://抄作业.com)  
-Bilibili 直播间：[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码，近期很长一段时间应该都是在写本软件~  
+自动战斗 JSON 作业分享：[prts.plus](https://prts.plus)  
+Bilibili 直播间：[MrEO 直播间](https://live.bilibili.com/2808861) 直播敲代码 & [MAA-Official 直播间](https://live.bilibili.com/27548877) 游戏/杂谈  
 
 技术群（舟无关、禁水）：[内卷地狱！(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)  
 开发者群：[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)  

cmake/macos.cmake

@@ -7,12 +7,12 @@ if (BUILD_XCFRAMEWORK)
 
     add_custom_command(OUTPUT OpenCV.xcframework
         COMMAND rm -rf OpenCV.xcframework
-        COMMAND xcodebuild -create-xcframework -library "${PROJECT_SOURCE_DIR}/MaaDeps/runtime/${MAADEPS_TRIPLET}/libopencv_world4.407.dylib" -output OpenCV.xcframework
+        COMMAND xcodebuild -create-xcframework -library "${PROJECT_SOURCE_DIR}/MaaDeps/runtime/${MAADEPS_TRIPLET}/libopencv_world4.408.dylib" -output OpenCV.xcframework
     )
 
     add_custom_command(OUTPUT ONNXRuntime.xcframework
         COMMAND rm -rf ONNXRuntime.xcframework
-        COMMAND xcodebuild -create-xcframework -library "${PROJECT_SOURCE_DIR}/MaaDeps/runtime/${MAADEPS_TRIPLET}/libonnxruntime.1.14.1.dylib" -output ONNXRuntime.xcframework
+        COMMAND xcodebuild -create-xcframework -library "${PROJECT_SOURCE_DIR}/MaaDeps/runtime/${MAADEPS_TRIPLET}/libonnxruntime.1.18.0.dylib" -output ONNXRuntime.xcframework
     )
 
     add_custom_command(OUTPUT fastdeploy_ppocr.xcframework

docs/.markdownlint.yaml

@@ -223,6 +223,4 @@ MD052: true
 # MD053/link-image-reference-definitions - Link and image reference definitions should be needed
 MD053:
   # Ignored definitions
-  ignored_definitions: [
-    "//"
-  ]
+  ignored_definitions: ["//"]

docs/.vuepress/client.ts

@@ -1,8 +1,12 @@
 import { defineClientConfig } from "vuepress/client";
-import ImageGrid from "../components/ImageGrid.vue";
+import Image1 from "../components/Image1.vue";
+import Image2 from "../components/Image2.vue";
+import Image4 from "../components/Image4.vue";
 
 export default defineClientConfig({
   enhance: ({ app }) => {
-    app.component("ImageGrid", ImageGrid);
+    app.component("Image1", Image1);
+    app.component("Image2", Image2);
+    app.component("Image4", Image4);
   },
 });

docs/.vuepress/plugins/search.ts

@@ -1,83 +1,88 @@
 export default {
-    appId: '99JM20SIFG',
-    apiKey: '32ad931040facd36d2e99c3cb8e425e1',
-    indexName: 'maa',
+    appId: "99JM20SIFG",
+    apiKey: "7596a5a8c95cd64d4cf3050c9a4f878e",
+    indexName: "maa",
+    // 这里应该把所有本地化配置都放入 locales 中
     locales: {
-      '/': {
-        placeholder: '搜索',
-        translations: {
-          button: {
-            buttonText: '搜索',
-          },
-          modal: {
-            searchBox: {
-              resetButtonTitle: '清除查询条件',
-              cancelButtonText: '取消',
+        "/zh-cn/": {
+            placeholder: "搜索",
+            translations: {
+                button: {
+                    buttonText: "搜索",
+                },
+                modal: {
+                    searchBox: {
+                        resetButtonTitle: "清除查询条件",
+                        cancelButtonText: "取消",
+                    },
+                    startScreen: {
+                        recentSearchesTitle: "搜索历史",
+                        noRecentSearchesText: "没有搜索历史",
+                        saveRecentSearchButtonTitle: "保存至搜索历史",
+                        removeRecentSearchButtonTitle: "从搜索历史中移除",
+                        favoriteSearchesTitle: "收藏",
+                        removeFavoriteSearchButtonTitle: "从收藏中移除",
+                    },
+                    errorScreen: {
+                        titleText: "无法获取结果",
+                        helpText: "你可能需要检查你的网络连接",
+                    },
+                    footer: {
+                        selectText: "选择",
+                        navigateText: "切换",
+                        closeText: "关闭",
+                        searchByText: "搜索提供者",
+                    },
+                    noResultsScreen: {
+                        noResultsText: "无法找到相关结果",
+                        suggestedQueryText: "你可以尝试查询",
+                        reportMissingResultsText: "你认为该查询应该有结果？",
+                        reportMissingResultsLinkText: "点击反馈",
+                    },
+                },
             },
-            startScreen: {
-              recentSearchesTitle: '搜索历史',
-              noRecentSearchesText: '没有搜索历史',
-              saveRecentSearchButtonTitle: '保存至搜索历史',
-              removeRecentSearchButtonTitle: '从搜索历史中移除',
-              favoriteSearchesTitle: '收藏',
-              removeFavoriteSearchButtonTitle: '从收藏中移除',
+        },
+        "/en-us/": {
+            placeholder: "Search",
+            translations: {
+                button: {
+                    buttonText: "Search",
+                },
+                modal: {
+                    searchBox: {
+                        resetButtonTitle: "Clear the query",
+                        cancelButtonText: "Cancel",
+                    },
+                    startScreen: {
+                        recentSearchesTitle: "Recent",
+                        noRecentSearchesText: "No recent searches",
+                        saveRecentSearchButtonTitle: "Save this search",
+                        removeRecentSearchButtonTitle:
+                            "Remove this search from history",
+                        favoriteSearchesTitle: "Favorite",
+                        removeFavoriteSearchButtonTitle:
+                            "Remove this search from favorites",
+                    },
+                    errorScreen: {
+                        titleText: "Unable to fetch results",
+                        helpText:
+                            "You might want to check your network connection.",
+                    },
+                    footer: {
+                        selectText: "to select",
+                        navigateText: "to navigate",
+                        closeText: "to close",
+                        searchByText: "Search by",
+                    },
+                    noResultsScreen: {
+                        noResultsText: "No results for",
+                        suggestedQueryText: "Try searching for",
+                        reportMissingResultsText:
+                            "Believe this query should return results?",
+                        reportMissingResultsLinkText: "Let us know.",
+                    },
+                },
             },
-            errorScreen: {
-              titleText: '无法获取结果',
-              helpText: '你可能需要检查你的网络连接',
-            },
-            footer: {
-              selectText: '选择',
-              navigateText: '切换',
-              closeText: '关闭',
-              searchByText: '搜索提供者',
-            },
-            noResultsScreen: {
-              noResultsText: '无法找到相关结果',
-              suggestedQueryText: '你可以尝试查询',
-              reportMissingResultsText: '你认为该查询应该有结果？',
-              reportMissingResultsLinkText: '点击反馈',
-            },
-          }
-        }
-      },
-      },
-      '/en-us/': {
-        placeholder: 'Search',
-        translations: {
-          button: {
-            buttonText: 'Search',
-          },
-          modal: {
-            searchBox: {
-              resetButtonTitle: 'Clear the query',
-              cancelButtonText: 'Cancel',
-            },
-            startScreen: {
-              recentSearchesTitle: 'Recent',
-              noRecentSearchesText: 'No recent searches',
-              saveRecentSearchButtonTitle: 'Save this search',
-              removeRecentSearchButtonTitle: 'Remove this search from history',
-              favoriteSearchesTitle: 'Favorite',
-              removeFavoriteSearchButtonTitle: 'Remove this search from favorites',
-            },
-            errorScreen: {
-              titleText: 'Unable to fetch results',
-              helpText: 'You might want to check your network connection.',
-            },
-            footer: {
-              selectText: 'to select',
-              navigateText: 'to navigate',
-              closeText: 'to close',
-              searchByText: 'Search by',
-            },
-            noResultsScreen: {
-              noResultsText: 'No results for',
-              suggestedQueryText: 'Try searching for',
-              reportMissingResultsText: 'Believe this query should return results?',
-              reportMissingResultsLinkText: 'Let us know.',
-            }
-          }
-        }
-      },
-}
+        },
+    },
+};

docs/.vuepress/public/files/MAA_Runtime_Fix_Pwsh.ps1

@@ -0,0 +1,101 @@
+# This file MUST use GBK encoding, whatever the system language is.
+# You may do more testing, but at least it works like this for me.
+# Fuck Microsoft.
+# 修改请使用 GBK 编码保存。
+# 如果能用 UTF-8 保存而不乱码，那就去做，我实在是研究不明白微软的屎了。
+# 你或许想加一条 [Console]::OutputEncoding = [System.Text.Encoding]::UTF8 来解决问题。
+# 但很神奇的，这根本不管用，甚至还会让中文汉字渲染重叠在一起。
+# 我在 CMD 里面都能 chcp 65001 换成 UTF-8。
+# 微软什么时候能把 PowerShell 7 集成到系统里。
+# 我由衷的认为 Windows 中预装的 PowerShell 就是一坨屎，甚至不如 CMD。
+# 用 PowerShell 写这东西真成为了一盘醋包的饺子了。
+
+# 检查 PowerShell 脚本运行策略
+# 我真理解不了这个运行策略的存在意义了，明明叫脚本运行策略，却可以用脚本修改。
+# 我既可以在不提权的情况下允许所有脚本运行，也可以直接启动一个运行所有脚本运行的会话。
+# 本脚本在测试时发现，在不修改策略且不提权的情况下也可以正常运行，只是在安装运行库时需要点安装程序的 UAC 弹窗。
+# 而不修改策略且提权时反而因为脚本策略运行不了了，这是什么品种的管理员权限。
+# $ExecutionPolicy = Get-ExecutionPolicy
+# if ($ExecutionPolicy -eq 'Restricted' -or $ExecutionPolicy -eq 'AllSigned') {
+#     Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
+#     Write-Host "已修改当前用户的 PowerShell 脚本运行策略为 RemoteSigned 以便运行此脚本。"
+#     Write-Host "这只需运行一次，且理应不会产生较大的安全风险。"
+#     Write-Host "如果您对此有疑虑，请在脚本运行结束后，在 PowerShell 中运行以下命令将策略值清空。"
+#     Write-Host "Set-ExecutionPolicy -ExecutionPolicy Undefined -Scope CurrentUser"
+#     Pause
+# }
+
+# 获取 UAC 权限并启动一个 RemoteSigned 脚本策略会话
+If (-Not ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltinRole]::Administrator)) {
+    Write-Host "正在获取管理员权限..."
+    Start-Process powershell.exe "-ExecutionPolicy RemoteSigned -File `"$PSCommandPath`" -ArgumentList `"$PSCommandPath`"" -Verb RunAs
+    Exit
+}
+
+# 读取系统代理并应用
+$Internet_Settings = Get-ItemProperty -Path 'HKCU:\Software\Microsoft\Windows\CurrentVersion\Internet Settings'
+if ($Internet_Settings.ProxyEnable -eq 1) {
+    $env:HTTP_PROXY = "http://$($Internet_Settings.ProxyServer)"
+    $env:HTTPS_PROXY = "http://$($Internet_Settings.ProxyServer)"
+    Write-Host "已应用系统代理：$($Internet_Settings.ProxyServer)。"
+}
+# else {
+#     Write-Host "未启用系统代理。"
+# }
+Remove-Variable -Name Internet_Settings
+
+# 新建下载用临时文件夹
+New-Item -Path "$env:TEMP" -Name "MAA_Runtime_Fix_Pwsh" -ItemType "Directory" | Out-Null
+
+# 使用 BITS 下载运行库安装包
+Write-Host "正在下载运行库安装包..."
+# Start-Sleep -Seconds 1
+Start-BitsTransfer -Source "https://aka.ms/vs/17/release/vc_redist.x64.exe" -Destination "$env:TEMP\MAA_Runtime_Fix_Pwsh\vc_redist.x64.exe"
+Start-BitsTransfer -Source "https://builds.dotnet.microsoft.com/dotnet/WindowsDesktop/8.0.11/windowsdesktop-runtime-8.0.11-win-x64.exe" -Destination "$env:TEMP\MAA_Runtime_Fix_Pwsh\windowsdesktop-runtime-8.0.11-win-x64.exe"
+
+# 卸载 vc++ 和 dotnet8
+Write-Host ""
+Write-Host "尝试调用 WinGet 卸载已安装的运行库..."
+winget uninstall "Microsoft.VCRedist.2015+.x64" "Microsoft.DotNet.DesktopRuntime.8" --force --all-versions
+
+# 安装 vc++
+Write-Host ""
+Write-Host "正在安装/修复 Microsoft Visual C++ 可再发行程序包..."
+$vcProcess = Start-Process "$env:TEMP\MAA_Runtime_Fix_Pwsh\vc_redist.x64.exe" -ArgumentList '/repair', '/passive', '/norestart' -PassThru
+$vcProcess.WaitForExit()
+
+# 安装 dotnet8
+Write-Host "正在安装/修复 .NET 桌面运行时 8..."
+$dotnetProcess = Start-Process "$env:TEMP\MAA_Runtime_Fix_Pwsh\windowsdesktop-runtime-8.0.11-win-x64.exe" -ArgumentList '/repair', '/passive', '/norestart' -PassThru
+$dotnetProcess.WaitForExit()
+
+# 删除临时文件夹
+Write-Host ""
+Write-Host "正在清理临时文件..."
+Remove-Item -Path "$env:TEMP\MAA_Runtime_Fix_Pwsh" -Recurse -Force
+
+Write-Host "运行库修复完成，请再次尝试运行 MAA。"
+Write-Host ""
+Pause
+
+# 使用 winget 安装/更新运行库并卸载旧版本
+# winget install "Microsoft.VCRedist.2015+.x64" "Microsoft.DotNet.DesktopRuntime.8" --uninstall-previous --accept-package-agreements
+
+# 使用 winget 下载运行库安装包
+# winget download --id "Microsoft.VCRedist.2015+.x64" -d "$env:TEMP\MAA_Runtime_Fix_Pwsh\"
+# winget download --id "Microsoft.DotNet.DesktopRuntime.8" -d "$env:TEMP\MAA_Runtime_Fix_Pwsh\"
+
+# 不使用 winget 卸载 vc++
+# 会进行卸载 但是卸不掉
+# Get-Package -Name "Microsoft Visual C++ 2015-2022 Redistributable (x64) - *" | Uninstall-Package -Force
+
+# 不使用 winget 卸载 dotnet8
+# 会进行卸载 但是卸不掉
+# Get-Package -Name "Microsoft Windows Desktop Runtime - 8.* (x64)" | Uninstall-Package -Force
+
+# 下载安装包那里注释了一个睡一秒是因为本来下载文件的那个进度条会把上面输出过的所有内容都覆盖掉，上来就只能看到个下载进度条，别的啥也看不到。
+# 但当我去掉新建文件夹时输出的一大坨东西之后，这行就能露出来了。
+# 我建议每个人都去看一下 PowerShell 的 New-Item 新建文件夹能输出多大一坨玩意。
+# 还有 PowerShell 弱智一样的进度条显示机制，非得搞个固定不透明一大坨的浮窗上去干什么，就不能和别人一样在命令底部显示吗。
+
+# 再用 Pwsh 写脚本我就是傻逼。