Release v5.7.0 (#10716)

* chore: v5.7.0 highlight

* chore: Update CHANGELOG.md

.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,17 @@ c9b5aa638a97397ab8666031ea646904527afc09
 bae271c09bb79e5cc2a7f8491ce882d276ac97b4
 3d83b80dd67d996a5f4f1732fe1eb36cacc7605e
 21617270bcef2456cb7f89e54560ca6788450711
+
+# resource/*.json prettier mass styling
+d84da5d01a872540d520bc87408d4524e07cfa39
+546bfc399cdd140a9812f44b5e6bc89fccfda5fa
+f0bdccdf0da7fac29f475951f0f43d3ab56a7ffe
+7a758bce844bc2778f04a789195efbd17681dac7
+5f3730b76785b1168125eb3b5edbed399722f8f9
+bc3ad67a02cb3b8e154c06955cf17091c4265000
+
+# 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
+# --------------------------------------------------- #

.gitattributes

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

.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，请说明 MuMu 截图增强是否开启；
+        最后请说明 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,16 @@
 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
   - 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, 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, please specify whether MuMu 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,16 @@
 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
   - 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,15 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /.github/workflows
+    schedule:
+      interval: weekly
+    commit-message:
+      prefix: ci
+    assignees:
+      - constrat
+      - AnnAngela
+    groups:
+      github-actions:
+        patterns:
+          - "*"

.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/workflows/blame-ignore.yml

@@ -0,0 +1,38 @@
+name: Blame Ignore Commit
+
+on:
+  workflow_dispatch:
+
+jobs:
+  blame-ignore:
+    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: Get last checked commit
+        run: |
+          LAST_CHECKED_COMMIT=$(cat .last-checked-commit 2>/dev/null || git rev-list --max-parents=0 HEAD)
+          echo "LAST_CHECKED_COMMIT=$LAST_CHECKED_COMMIT" >> $GITHUB_ENV
+
+      - name: Process commits and update blame ignore list
+        run: |
+          git log ${{ env.LAST_CHECKED_COMMIT }}..HEAD --pretty=format:"%H %s" --grep="\[blame ignore\]" | awk '{print $1}' >> .git-blame-ignore-revs
+
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+
+          git rev-parse HEAD > .last-checked-commit
+
+          git add .last-checked-commit .git-blame-ignore-revs
+          git commit -m "chore: auto blame ignore" -m "[skip changelog]"
+
+      - name: Push changes
+        uses: ad-m/github-push-action@master
+        with:
+          branch: ${{ github.ref }}
+          github_token: ${{ secrets.MAA_RESOURCE_SYNC }}

.github/workflows/ci.yml

@@ -28,6 +28,10 @@ on:
       - "!**/*.md"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   meta:
     runs-on: ubuntu-latest
@@ -184,6 +188,8 @@ jobs:
     strategy:
       matrix:
         arch: [aarch64, x86_64]
+    permissions:
+      actions: write
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -199,8 +205,6 @@ jobs:
 
       - name: Setup ccache
         uses: Chocobo1/setup-ccache-action@v1
-        with:
-          remove_stale_cache: false
 
       - name: Bootstrap MaaDeps
         env:
@@ -270,9 +274,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
 
@@ -357,6 +361,10 @@ jobs:
           p12-file-base64: ${{ secrets.HGUANDL_SIGN_CERT_P12 }}
           p12-password: ${{ secrets.HGUANDL_SIGN_CERT_PASSWD }}
 
+      - name: Setup Xcode Toolchain
+        run: |
+          sudo xcode-select -s /Applications/Xcode_15.0.1.app/Contents/Developer
+
       - name: Build Universal Binaries
         run: |
           mkdir build
@@ -364,6 +372,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
@@ -457,7 +483,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

@@ -16,7 +16,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,65 @@
-name: Lint Markdown files
+name: Check Dead Links
 
 on:
   push:
+    branches:
+      - dev
     paths:
       - "**/*.md"
-      - ".github/workflows/lint-markdown.yml"
+      - "docs/**"
+      - ".github/workflows/markdown-checker.yml"
   pull_request:
+    branches:
+      - dev
     paths:
       - "**/*.md"
-      - ".github/workflows/lint-markdown.yml"
+      - "docs/**"
+      - ".github/workflows/markdown-checker.yml"
   schedule:
-    - cron: "44 7 * * 2"
+    - cron: "44 7 * * 2" # Every Tuesday at 7:44 AM UTC
   workflow_dispatch:
 
 jobs:
-  lint:
-    name: Lint Markdown
+  check-links:
+    if: ${{ 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: Cache lychee
+        uses: actions/cache@v4
         with:
-          config: docs/.markdownlint.yaml
-          globs: |
-            README.md
-            docs/**/*.md
+          path: .lycheecache
+          key: cache-lychee-${{ github.sha }}
+          restore-keys: cache-lychee-
 
-#  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: Check dead links
+        uses: lycheeverse/lychee-action@v1
+        with:
+          # 仅检查内部链接和 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' 
+            -- './docs/**/*.md' './README.md'
+
+      - name: Comment (only for PR)
+        if: github.event_name == 'pull_request' && env.lychee_exit_code != 0
+        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 }}
+
+      - name: Exit with lychee exit code
+        run: exit ${{ env.lychee_exit_code }}

.github/workflows/optimize-templates.yml

@@ -0,0 +1,83 @@
+name: Auto Optimize PNG Templates
+
+on:
+  push:
+    branches:
+      - "dev"
+    paths:
+      - "resource/**/*.png"
+      - "docs/.vuepress/public/image/**"
+      - "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
+    if: ${{ github.event.head_commit.author.email != '41898282+github-actions[bot]@users.noreply.github.com' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          persist-credentials: false
+
+      - name: Setup python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Cache Python packages
+        id: cache_python
+        if: 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.cache_python.outputs.cache-hit != 'true'
+        run: |
+          pip install -r tools/OptimizeTemplates/requirements.txt
+
+      - name: Setup oxipng
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: oxipng
+
+      - name: Run optimize_templates
+        run: |
+          python3 tools/OptimizeTemplates/optimize_templates.py
+
+      - name: Commit changes
+        id: commit_changes
+        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.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

@@ -14,12 +14,12 @@ on:
       limit:
         description: "Number of releases to fetch from MaaAssistantArknights"
         required: true
-        default: 30
+        default: "30"
         type: number
       limit_2:
         description: "Number of releases to fetch from MaaRelease"
         required: true
-        default: 30
+        default: "30"
         type: number
 
 jobs:
@@ -37,7 +37,7 @@ 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:
@@ -75,9 +75,9 @@ jobs:
           }
           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
+            $pre_version = "$($ids[0])-$($ids[1])"
             echo "pre_version=$pre_version" >> $env:GITHUB_OUTPUT
+            echo "tag=$pre_version.d$($dist).$($ids[3])" >> $env:GITHUB_OUTPUT
             exit 0
           }
           exit 1
@@ -97,13 +97,17 @@ jobs:
         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: 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
@@ -212,8 +216,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=${{ inputs.limit || 30 }}
+          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 "${{ github.repository_owner }}/MaaRelease" --limit $limit_2 | tee ./release_mr.txt
           echo ${{ needs.build-win-nightly.outputs.tag }} > ./config
 
           cat ./release_maa.txt | awk '{ print $1 }' > ./tags_maa.txt
@@ -242,22 +255,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 +265,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-unix.yml

@@ -0,0 +1,306 @@
+name: res-update-game-unix
+
+on:
+  # schedule:
+  #   - cron: "*/20 * * * *"
+  workflow_dispatch:
+    inputs:
+      commit_message:
+        description: "Commit Message"
+        type: string
+        required: false
+
+jobs:
+  clone-resources-official:
+    if: github.repository_owner == 'MaaAssistantArknights'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Clone ArknightsGameResource for Official
+        uses: actions/checkout@v4
+        with:
+          show-progress: false
+          repository: yuanyan3060/ArknightsGameResource
+          ref: main
+          path: ./Official
+          sparse-checkout-cone-mode: false
+          sparse-checkout: |
+            /levels.json
+            /item
+            /building_skill
+            /gamedata/excel/item_table.json
+            /gamedata/excel/building_data.json
+            /gamedata/excel/range_table.json
+            /gamedata/excel/character_table.json
+            /gamedata/excel/gacha_table.json
+            /gamedata/excel/roguelike_topic_table.json
+            /gamedata/excel/activity_table.json
+
+      - name: Upload Official
+        uses: actions/upload-artifact@v4.3.4
+        with:
+          name: official
+          path: ./Official
+
+  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: ./Overseas
+          sparse-checkout-cone-mode: false
+          sparse-checkout: |
+            /en_US/gamedata/excel/item_table.json
+            /en_US/gamedata/excel/building_data.json
+            /en_US/gamedata/excel/range_table.json
+            /en_US/gamedata/excel/character_table.json
+            /en_US/gamedata/excel/gacha_table.json
+            /en_US/gamedata/excel/roguelike_topic_table.json
+            /en_US/gamedata/excel/activity_table.json
+            /ja_JP/gamedata/excel/item_table.json
+            /ja_JP/gamedata/excel/building_data.json
+            /ja_JP/gamedata/excel/range_table.json
+            /ja_JP/gamedata/excel/character_table.json
+            /ja_JP/gamedata/excel/gacha_table.json
+            /ja_JP/gamedata/excel/roguelike_topic_table.json
+            /ja_JP/gamedata/excel/activity_table.json
+            /ko_KR/gamedata/excel/item_table.json
+            /ko_KR/gamedata/excel/building_data.json
+            /ko_KR/gamedata/excel/range_table.json
+            /ko_KR/gamedata/excel/character_table.json
+            /ko_KR/gamedata/excel/gacha_table.json
+            /ko_KR/gamedata/excel/roguelike_topic_table.json
+            /ko_KR/gamedata/excel/activity_table.json
+
+      - name: Upload Official
+        uses: actions/upload-artifact@v4.3.4
+        with:
+          name: overseas
+          path: ./Overseas
+
+  clone-resources-txwy:
+    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: ./excel
+          token: ${{ secrets.ARKNTOOLS_MAA_RESOURCE_UPDATER}}
+
+      - name: Upload Official
+        uses: actions/upload-artifact@v4.3.4
+        with:
+          name: txwy
+          path: ./excel
+
+  update-game-resources:
+    if: github.repository_owner == 'MaaAssistantArknights'
+    runs-on: ubuntu-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
+
+      - name: Restore ResourceUpdater.exe from cache
+        id: cache-resupd
+        uses: actions/cache/restore@v4
+        with:
+          key: ${{ runner.os }}-resource-updater-unix-${{ hashFiles('./tools/ResourceUpdaterUnix/main.cpp') }}
+          path: |
+            ./tools/ResourceUpdaterUnix/build/ResourceUpdaterUnix
+
+      - name: Bootstrap MaaDeps
+        if: steps.cache-resupd.outputs.cache-hit != 'true'
+        run: |
+          python3 maadeps-download.py x64-linux
+
+      - name: Build ResourceUpdater
+        if: steps.cache-resupd.outputs.cache-hit != 'true'
+        run: |
+          cmake -S . -B build
+          cd build
+          make -j$(nproc)
+
+      - name: Save ResourceUpdater.exe to cache
+        if: always() && steps.cache-resupd.outputs.cache-hit != 'true'
+        uses: actions/cache/save@v4
+        with:
+          key: ${{ runner.os }}-resource-updater-unix-${{ hashFiles('./tools/ResourceUpdaterUnix/main.cpp') }}
+          path: |
+            ./tools/ResourceUpdaterUnix/build/ResourceUpdaterUnix
+
+      - name: Download txwy
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: txwy
+          path: ./tools/ResourceUpdaterUnix/build/Overseas/zh_TW/gamedata/excel
+
+      - name: Download Overseas
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: overseas
+          path: ./tools/ResourceUpdaterUnix/build/Overseas
+
+      - name: Download Official
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: official
+          path: ./tools/ResourceUpdaterUnix/build/Official
+
+      - name: Run Resource Updater
+        run: |
+          ./tools/ResourceUpdaterUnix/build/ResourceUpdaterUnix
+
+      - name: Task Sorting
+        run: |
+          python3 tools/TaskSorter/TaskSorter.py
+
+      - name: Cache Prettier
+        id: cache-prettier
+        uses: actions/cache@v4
+        with:
+          key: ${{ runner.os }}-prettier
+          path: ./node_modules
+
+      - name: Install Prettier
+        if: steps.cache-prettier.outputs.cache-hit != 'true'
+        run: |
+          npm i prettier --no-save
+
+      - name: Run Prettier on modified Jsons
+        run: |
+          npx prettier -w $(git diff --name-only --diff-filter=ACM 2>/dev/null | grep '\.json$')
+
+      - name: Check if only sorted and Templates
+        id: check_sorted_templates
+        run: |
+          git status
+
+          gd=$(git diff --numstat HEAD 2>/dev/null | grep -i resource)
+          if [ $? -ne 0 ]; then
+            echo "no diff"
+            exit 0
+          fi
+
+          echo ""
+          echo "$gd"
+          echo ""
+
+          diff=false
+          hasPng=false
+
+          IFS=$'\n' read -rd '' -a diffLines <<<"$gd"
+
+          for line in "${diffLines[@]}"; do
+            parts=($line)
+            filePath=${parts[2]}
+            firstNumber=${parts[0]}
+            secondNumber=${parts[1]}
+
+            if [[ $filePath =~ \.png$ ]]; then
+              hasPng=true
+            fi
+
+            if [[ $firstNumber -gt 1 || $firstNumber -ne $secondNumber ]]; then
+              diff=true
+            fi
+
+            if $hasPng && $diff; then
+              break
+            fi
+          done
+
+          changes=$($hasPng || $diff)
+
+          echo "diff: $diff"
+          echo "hasPng: $hasPng"
+          echo "changes: $changes"
+
+          echo "contains_png=$hasPng" >> $GITHUB_OUTPUT
+          echo "changes=$changes" >> $GITHUB_OUTPUT
+          - name: Setup python
+          uses: actions/setup-python@v5
+          with:
+            python-version: "3.11"
+
+      - name: Cache Python packages
+        id: cache_python
+        if: 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.cache_python.outputs.cache-hit != 'true'
+        run: |
+          pip install -r tools/OptimizeTemplates/requirements.txt
+
+      - name: Setup oxipng
+        uses: baptiste0928/cargo-install@v3
+        with:
+          crate: oxipng
+
+      - name: Optimize Templates
+        if: steps.check_sorted_templates.outputs.contains_png == 'True'
+        run: |
+          python3 tools/OptimizeTemplates/optimize_templates.py resource/template/items/ resource/template/infrast/
+
+      - name: Cancelling
+        if: steps.check_sorted_templates.outputs.changes != 'True'
+        uses: andymckay/cancel-action@0.5
+
+      - name: Add files to git
+        if: steps.check_sorted_templates.outputs.changes == 'True'
+        id: add_files
+        run: |
+          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 [ -n "$commit_msg" ]; then
+            commit_msg=$(echo "$commit_msg" | xargs)  # Trim whitespace
+          else
+            commit_msg="chore: Auto Update Game Resources - $(date +'%Y-%m-%d')"
+          fi
+
+          git commit -m "$commit_msg" -m "[skip changelog]"
+          if [ $? -eq 0 ]; then
+            echo "have_commits=True" >> $GITHUB_OUTPUT
+          fi
+
+          git pull origin $(git rev-parse --abbrev-ref HEAD) --unshallow --rebase
+
+      - name: Cancelling
+        if: steps.add_files.outputs.have_commits != 'True'
+        uses: andymckay/cancel-action@0.5
+
+      - name: Push changes
+        if: steps.add_files.outputs.have_commits == 'True'
+        uses: ad-m/github-push-action@master
+        with:
+          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: 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"

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

@@ -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,25 @@ 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.3.4
+        with:
+          name: official
+          path: ./Official
+
+  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 +75,206 @@ 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.3.4
+        with:
+          name: overseas
+          path: ./Overseas
+
+  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.3.4
+        with:
+          name: txwy
+          path: ./excel
+
+  update-game-resources:
+    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
+
+      - name: Restore ResourceUpdater.exe from cache
+        id: cache-resupd
+        uses: actions/cache/restore@v4
+        with:
+          key: ${{ runner.os }}-resource-updater-main-cpp-${{ hashFiles('./tools/ResourceUpdater/main.cpp') }}
+          path: |
+            ./tools/ResourceUpdater/x64/Release/opencv_world4_maa.dll
+            ./tools/ResourceUpdater/x64/Release/ResourceUpdater.exe
+
+      - name: Bootstrap MaaDeps
+        if: steps.cache-resupd.outputs.cache-hit != 'true'
+        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: ${{ runner.os }}-resource-updater-main-cpp-${{ hashFiles('./tools/ResourceUpdater/main.cpp') }}
+          path: |
+            ./tools/ResourceUpdater/x64/Release/opencv_world4_maa.dll
+            ./tools/ResourceUpdater/x64/Release/ResourceUpdater.exe
+
+      - name: Download txwy
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: txwy
+          path: ./tools/ResourceUpdater/x64/Release/Overseas/zh_TW/gamedata/excel
+
+      - name: Download Overseas
+        uses: actions/download-artifact@v4.1.8
+        with:
+          name: overseas
+          path: ./tools/ResourceUpdater/x64/Release/Overseas
+
+      - name: Download Official
+        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: actionsx/prettier@v3
+        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: 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

@@ -25,6 +25,10 @@ on:
       - "!**/*.md"
   workflow_dispatch:
 
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
 jobs:
   smoke-testing:
     runs-on: windows-latest
@@ -34,10 +38,10 @@ jobs:
         with:
           show-progress: false
           submodules: recursive
-          
+
       - name: Restore dependencies
         run: dotnet restore
-      
+
       - name: Bootstrap MaaDeps
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -45,7 +49,8 @@ jobs:
           python3 maadeps-download.py x64-windows
 
       - name: Add msbuild to PATH
-        uses: microsoft/setup-msbuild@v1
+        uses: microsoft/setup-msbuild@v2
+
       - name: Build MaaSample
         run: |
           MSBUILD src/Cpp/MaaSample.slnf /t:rebuild /p:Configuration="Debug" /p:Platform="x64" /m
@@ -57,15 +62,15 @@ jobs:
       - name: Run tests - YostarJP
         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

.github/workflows/stale.yml

@@ -0,0 +1,38 @@
+name: "Inactive Issues auto close"
+
+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
+
+on:
+  schedule:
+    - cron: "0 0 * * *" # Runs daily at UTC 00:00
+  workflow_dispatch: # Allows manual triggering
+
+jobs:
+  stale:
+    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: 500
+          debug-only: false

.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

.last-checked-commit

@@ -0,0 +1 @@
+7521b526ee2a272d267ff9cb60651ab0e012b63f

.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,56 @@
+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-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"]
+  #- repo: https://github.com/lycheeverse/lychee
+  #  rev: v0.15.1
+  #  hooks:
+  #    - id: lychee
+  #      files: ^docs/.*|^README\.md$
+  #      types:
+  #        - markdown
+  #      args:
+  #        #- --verbose
+  #        - --quiet
+  #        - --no-progress
+  #        - --exclude
+  #        - 'https://map\.ark-nights\.com/areas'
+  #        - --exclude
+  #        - 'https://.*\.maa-org\.net/.*'
+  #        - --exclude
+  #        - 'https://support\.bluestacks\.com/.*'
+  #        - --exclude
+  #        - 'https://www\.bigfun\.cn/.*'
+  #        - --exclude
+  #        - 'https://myqqbot\.com/.*'
+  #        - --exclude
+  #        - 'http://xn--\w+\.com/'
+  #        - --exclude
+  #        - 'https://mywebsite\.com/.*'
+  #        - --exclude
+  #        - '/image/*'
+  #        - --exclude-path
+  #        - "docs/zh-tw/manual/introduction/introduction_old.md"
+  #        - --exclude-path
+  #        - "docs/ja-jp/manual/introduction/introduction_old.md"

.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,101 @@
-## v5.4.1
+## v5.7.0
+
+### 发生甚么事了 | Highlight
+
+从本次版本开始，我们将会对正式版的更新笔记编写一份简要说明，以帮助你更好地掌握我们更新了啥。
+
+* __对雷电模拟器支持截图增强模式__
+
+  在这个版本，我们新增了对雷电模拟器<del>（黄色 MuMu）</del>的截图增强模式支持，现在你也可以在雷电模拟器上看到两位数甚至一位数的截图延迟了，大幅度提升各项任务，特别是自动战斗、自动肉鸽、仓库和干员识别的效率。
+
+  目前需要雷电模拟器更新至 9.0.78 及以上版本，__注意 9.1.x 版本为 Vulkan 版暂时不支持截图增强__。
+
+* __将生息演算的 `策略` 选项移至常规设置__
+
+  以前总有用户找不到生息验算任务的策略选项，运行结果与期待不符，以为出 bug 了，实际上是没选对策略。在这个版本，我们将策略选项从高级设置移动到常规设置中，方便用户更直观地选择所需的策略。
+
+* __喜报！MAA 报错了！__
+
+  总有用户不看报错信息（__特别是里面的解决方案部分__），只会用口述表达，这个版本我们让报错信息窗口以喜报的形式呈现，希望你能先读完再按要求反馈问题。
+
+* __修复了一些已知 bug，提升了 MAA 稳定性__
+
+  在这个版本对部分 bug 进行了修复，例如自动编队时偶现无法选择右侧职业筛选的问题。
+
+* __资源与品质级更新__
+
+  这个版本随附游戏资源文件更新至24年10月矢量突破版本，新增了主线 14 章关卡自动导航数据，并优化了部分界面功能。
+
+----
+
+以下是本次更新详细内容。
+
+### 新增 | New
+
+* ZT關卡導引更新 @XuQingTW
+* 掉落统计显示当前关卡名称 @ABA2396
+* 喜报！(报错界面) (#10578) @ABA2396 @SherkeyXD
+* LD 截图 (#10581) @ABA2396
+
+### 改进 | Improved
+
+* 将生息演算的 `策略` 选项移至常规设置 @ABA2396
+* 优化编队模板图片，识别不到对应职业图标时在 `全部` 中寻找 @ABA2396
+* 截图延迟过高时自动降低目标帧率 @ABA2396
+* 优化可清除内容的下拉框显示效果 @ABA2396 @Alan-Charred
+* 启动后对已有配置排序 @ABA2396
+
+### 修复 | Fix
+
+* 修复漏了的初始化 @MistEO
+* 肉鸽重新编队应在首页执行 @YueLengM
+* 自动编队偶现无法匹配职业图标 @ABA2396
+* 强制定时启动前显示窗口 导致程序崩溃 @ABA2396
+* 强制定时启动报错 @ABA2396
+* 下干员操作不显示干员组名字 @ABA2396
+* CV-4 navigation @SherkeyXD
+* Dormitory theme may block OCR sequence in EN fix #10645 @Constrat
+* YostarKR ocr fix @HX3N
 
 ### 文档 | 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
+* 更新 bug-issue 模板 (#10675) @Daydreamer114
+* LD screenshot JP translate (#10659) @Manicsteiner @ABA2396
+* 更新雷电截图增强文档和 Issue 模板 (#10638) @Rbqwow @Constrat @HX3N
+* 文档错别字 @ABA2396
 
-### For Overseas
+### 其他 | Other
 
-#### YostarEN
-
-* YoStarEN resolution warning on client switch (#9539) @Constrat @ABA2396
+* switch to StageSideStory.png for OD YostarKR @HX3N
+* switch to StageSideStory.png for OD YostarEN @Constrat
+* YostarKR switch OD navigation to template @HX3N
+* switch OD navigation to template @Constrat
+* txwy gamedata + various refactoring for resource updater @Constrat
+* perf!: Full multithread implementation for ResourceUpdater.exe + method refactoring @Constrat
+* InvokeAsync 前判断是否已经在 ui 线程 @ABA2396
+* 执行完成后动作前输出当前选择的动作 @ABA2396
+* uncommented update stages section. @Constrat
+* 调整肉鸽 StageTraderRefreshWithDice 任务的 roi 参数 (#10686) @Alan-Charred
+* renamed input directory @Constrat
+* resupd clone data script wrong location @Constrat
+* 降低 Tales@RA@LeaveCurrentZone 任务的 templThreshold (#10658) @Alan-Charred
+* ResourceUpdater always returning 0 even on error @Constrat
+* ResourceUpdater git diff not finding pngs @Constrat
+* ResourceUpdater.exe implements multi-threading + fix for missing foldartals Lighter implementation compared to #10683 @Constrat
+* 移除 ConnectSettingsUserControl 设计时高度限制 @ABA2396
+* removed wrong tooltip from AllowUseStoneSave @Constrat
+* EN tweak for Use Originium option @Constrat
+* EN tweak @Constrat
+* 调整 bug report @ABA2396
+* TimerSettings 改用 NumericUpDown 验证输入 @ABA2396
+* 定时启动添加日志 @ABA2396
+* 主定时器改用 Timer @ABA2396
+* 在 ui 线程清除日志 @ABA2396
+* 优化 RecognizerViewModel (#10641) @ABA2396 @status102
+* 截图测试使用GetFreshImage替代添加冗余任务 @status102
+* capture fresh image (#10460) @ABA2396
+* ss-open 使用 StageSideStory.png @ABA2396
+* OD tasks for navigation (from MaaRelease) @Constrat
+* SSS log EN tweak @Constrat
+* zh任务链完成耗时 @status102
+* tasks.json 十四章内容补充 (#10644) @Daydreamer114

CMakeLists.txt

@@ -48,6 +48,12 @@ else ()
     if (CMAKE_CXX_COMPILER_ID MATCHES "GNU" AND CMAKE_CXX_COMPILER_VERSION VERSION_LESS 13)
         target_compile_options(MaaCore PRIVATE "-Wno-restrict")
     endif()
+    # 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)

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,9 @@
 	<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/=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>
@@ -47,6 +52,7 @@
 	<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 +67,10 @@
 	<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/=ldconsole/@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>
@@ -88,6 +97,7 @@
 	<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>

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/image/maa-logo_512x512.png" width="256" height="256" />
 
 # MaaAssistantArknights
 
@@ -77,10 +77,7 @@ MAA 的意思是 MAA Assistant Arknights
 
 ## 下载地址
 
-前往[官网](https://maa.plus)自动匹配镜像源并下载稳定版，或：
-
-- [稳定版/公测版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
-- [内测版](https://github.com/MaaAssistantArknights/MaaRelease/releases)
+[官网](https://maa.plus) 或 [Releases](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
 
 ## 使用说明
 
@@ -98,7 +95,7 @@ MAA 的意思是 MAA Assistant Arknights
 - 下载到一半提示“登陆”/“鉴权”；
 - 连接正常，任务开始了，但是没反应。
 
-请参阅 [常见问题](https://maa.plus/docs/zh-cn/manual/faq.html)
+请参阅 [常见问题](https://maa.plus/docs/zh-cn/manual/faq.html)。
 
 ### 外服支持
 
@@ -107,7 +104,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 +195,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)
 
 ## 声明
 
@@ -216,7 +213,7 @@ MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）
 
 用户交流 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)  
+自动战斗 JSON 作业分享：[prts.plus](https://prts.plus)  
 Bilibili 直播间：[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码，近期很长一段时间应该都是在写本软件~  
 
 技术群（舟无关、禁水）：[内卷地狱！(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)  

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.',
-            }
-          }
-        }
-      },
-}
+        },
+    },
+};