chore: add coppers to resource updater

and GO-OpenOcr

.clangd

@@ -0,0 +1,2 @@
+CompileFlags:
+  CompilationDatabase: build

.devcontainer/0/Dockerfile

@@ -2,29 +2,25 @@ FROM mcr.microsoft.com/devcontainers/base:ubuntu
 
 USER vscode
 
-ENV CONDA_DIR=/home/vscode/miniconda
-ENV PATH="$CONDA_DIR/bin:$PATH"
+ENV PATH="/home/vscode/.local/bin:${PATH}"
 
-ARG PYTHON_VERSION=3.12
+ARG PYTHON_VERSION=3.12.11
 ARG NODEJS_VERSION=24
 
-# Install Miniconda
-RUN wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh \
-    && bash ~/miniconda.sh -b -p $CONDA_DIR \
-    && rm ~/miniconda.sh \
-    && conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main \
-    && conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
+# Install and setup mise and uv
+RUN curl https://mise.run | sh
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# Configure conda environment
-RUN eval "$(conda shell.bash hook)" \
-    && conda create -n maa \
-    && conda activate maa \
-    && conda install -y \
-    python=$PYTHON_VERSION \
-    conda-forge::nodejs=$NODEJS_VERSION \
-    && pip install pre-commit
+# Activate mise
+RUN echo 'eval "$(mise activate bash)"' >> ~/.bashrc
 
-# Finalize conda setup
-RUN conda init \
-    && conda config --set auto_activate false \
-    && echo "conda activate maa" >> ~/.bashrc
+# Setup Python and Node.js
+RUN mise use -g node@$NODEJS_VERSION
+RUN uv python install $PYTHON_VERSION
+
+# Create and activate venv
+RUN uv venv --clear ~/.venv/maa
+RUN echo "source ~/.venv/maa/bin/activate" >> ~/.bashrc
+
+# Install tools
+RUN uv tool install prek

.devcontainer/0/post-create.sh

@@ -1,8 +1,6 @@
 #!/bin/bash
 WORKSPACE=$(pwd)
 
-# conda activate maa
-
 echo "===================="
 cd "$WORKSPACE"
 echo "Setting up git safe.directory..."

.devcontainer/1/Dockerfile

@@ -2,36 +2,51 @@ FROM mcr.microsoft.com/devcontainers/base:ubuntu
 
 USER vscode
 
-ENV CONDA_DIR=/home/vscode/miniconda
-ENV PATH="$CONDA_DIR/bin:$PATH"
+ENV PATH="/home/vscode/.local/bin:${PATH}"
 
 ARG CLANGD_VERSION=20
-ARG PYTHON_VERSION=3.12
+ARG PYTHON_VERSION=3.12.11
 ARG NODEJS_VERSION=24
 
+# Add kitware's apt repository (for cmake)
+RUN curl -fsSL https://apt.kitware.com/keys/kitware-archive-latest.asc | sudo gpg --dearmor -o /usr/share/keyrings/kitware-archive-keyring.gpg
+RUN cat <<EOF | sudo tee /etc/apt/sources.list.d/kitware.sources
+Types: deb
+URIs: https://apt.kitware.com/ubuntu
+Suites: $(lsb_release -cs)
+Components: main
+Architectures: $(dpkg --print-architecture)
+Signed-By: /usr/share/keyrings/kitware-archive-keyring.gpg
+EOF
+
 # Install system dependencies
 RUN sudo apt update \
     && sudo apt upgrade -y \
     && sudo apt install -y \
-    cmake
+    cmake \
+    fish \
+    && sudo rm -rf /var/lib/apt/lists/*
 
-# Install Miniconda
-RUN wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh -O ~/miniconda.sh \
-    && bash ~/miniconda.sh -b -p ${CONDA_DIR} \
-    && rm ~/miniconda.sh \
-    && conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/main \
-    && conda tos accept --override-channels --channel https://repo.anaconda.com/pkgs/r
+# Initialize fish
+RUN fish -c exit
 
-# Configure conda environment
-RUN eval "$(conda shell.bash hook)" \
-    && conda create -n maa \
-    && conda activate maa \
-    && conda install -y \
-    python=${PYTHON_VERSION} \
-    conda-forge::nodejs=${NODEJS_VERSION} \
-    && pip install pre-commit black isort
+# Install and setup mise and uv
+RUN curl https://mise.run | sh
+RUN curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# Finalize conda setup
-RUN conda init \
-    && conda config --set auto_activate false \
-    && echo "conda activate maa" >> ~/.bashrc
+# Activate mise
+RUN echo 'eval "$(mise activate bash)"' >> ~/.bashrc
+RUN echo 'mise activate fish | source' >> ~/.config/fish/config.fish
+
+# Setup Python and Node.js
+RUN mise use -g node@$NODEJS_VERSION
+RUN uv python install $PYTHON_VERSION
+
+# Create and activate venv
+RUN uv venv --clear ~/.venv/maa
+RUN echo "source ~/.venv/maa/bin/activate" >> ~/.bashrc
+RUN echo "source ~/.venv/maa/bin/activate.fish" >> ~/.config/fish/config.fish
+
+# Install tools
+RUN uv tool install prek
+RUN uv tool install ruff

.devcontainer/1/devcontainer.json

@@ -25,8 +25,7 @@
                 "xaver.clang-format",
                 "llvm-vs-code-extensions.vscode-clangd",
                 "ms-python.python",
-                "ms-python.black-formatter",
-                "ms-python.isort",
+                "charliermarsh.ruff",
                 "esbenp.prettier-vscode",
                 "DavidAnson.vscode-markdownlint",
                 "yzhang.markdown-all-in-one",
@@ -43,7 +42,7 @@
 
                 // Language-specific formatting
                 "[python]": {
-                    "editor.defaultFormatter": "ms-python.black-formatter",
+                    "editor.defaultFormatter": "charliermarsh.ruff",
                     "editor.codeActionsOnSave": {
                         "source.organizeImports": "explicit"
                     }
@@ -55,19 +54,12 @@
                     "editor.defaultFormatter": "xaver.clang-format"
                 },
 
-                // Python formatting and linting
-                "isort.args": ["--profile", "black"],
-
                 // Python runtime
                 "python.terminal.launchArgs": ["-u"],
-                "python.defaultInterpreterPath": "/home/vscode/miniconda/envs/maa/bin/python",
+                "python.defaultInterpreterPath": "/home/vscode/.venv/maa/bin/python",
                 "python.terminal.activateEnvironment": false,
 
                 // CMake settings
-                "cmake.configureSettings": {
-                    "BUILD_DEBUG_DEMO": "ON",
-                    "CMAKE_TOOLCHAIN_FILE": "src/MaaUtils/MaaDeps/cmake/maa-x64-linux-toolchain.cmake"
-                },
                 "cmake.configureOnOpen": false,
 
                 // Performance optimizations

.devcontainer/1/post-create.sh

@@ -1,8 +1,6 @@
 #!/bin/bash
 WORKSPACE=$(pwd)
 
-# conda activate maa
-
 echo "===================="
 cd "$WORKSPACE"
 echo "Setting up git safe.directory..."
@@ -27,14 +25,14 @@ echo "Installing Python dependencies..."
 for req_file in tools/*/requirements.txt; do
     if [ -f "$req_file" ]; then
         echo "Installing from $req_file"
-        pip install -r "$req_file"
+        uv pip install -r "$req_file"
     fi
 done
 
 for req_file in tools/*/requirements-dev.txt; do
     if [ -f "$req_file" ]; then
         echo "Installing from $req_file"
-        pip install -r "$req_file"
+        uv pip install -r "$req_file"
     fi
 done
 

.git-blame-ignore-revs

@@ -55,3 +55,4 @@ dce6e317c8e56836662b64ac4b3d1a69b4ff4dd8
 # as they are automatically appended
 # --------------------------------------------------- #
 f7772bc814c52f9a5e65af02404cf54b70fe0a32
+ca9807ce099e5cae133293df8dfcd2b56b0e06bd

.github/.last-blame-ignore-commit

@@ -1 +1 @@
-272d71fa2938f945832f86232532b86a9e5406b8
+1944164d9c47549d71c3b25987e9299404cc16f3

.github/issue-checker.yml

@@ -252,7 +252,7 @@ labels:
   # `module: fight`
   - name: fight
     content: "module: fight"
-    regexes: "刷图|刷理智|剿灭|刷.{0,6}材料|关卡选择|战斗|作战|[戰戦][鬥闘]|[Ff]ight|[Bb]attle|[Aa]nihilation"
+    regexes: "刷图|理智|剿灭|刷.{0,6}材料|关卡选择|战斗|作战|[戰戦][鬥闘]|[Ff]ight|[Bb]attle|[Aa]nihilation"
     skip-if:
       - skip all
       - skip module

.github/pr_cache_remover.ps1

@@ -1,38 +1,46 @@
 $totalClearedSize = 0
 $cacheList = gh cache list --json id,ref,sizeInBytes | ConvertFrom-Json
-$prCaches = $cacheList | Where-Object { $_.ref -like "*merge*" }
-
-if (-not $prCaches) {
-    Write-Output "No PR caches found."
-    exit
+$branchSet = @{}
+git ls-remote --heads origin | ForEach-Object { 
+    if ($_ -match 'refs/heads/(.+)$') { $branchSet[$matches[1]] = $true }
 }
 
-foreach ($cache in $prCaches) {
-    $cacheId = $cache.id
-    $cacheRef = $cache.ref
-    $cacheSizeInBytes = $cache.sizeInBytes  
+foreach ($cache in $cacheList) {
+    $shouldDelete = $false
 
-    if ($cacheRef -match "refs/pull/(\d+)/merge") {
+    if ($cache.ref -match "refs/pull/(\d+)/merge") {
         $prNumber = $matches[1]
- 
         Write-Host "PR #${prNumber}: " -NoNewline
- 
-        $prStatus = gh pr view $prNumber --json state | ConvertFrom-Json
- 
-        Write-Host $prStatus.state -NoNewline
- 
-        if ($prStatus.state -eq "MERGED" -or $prStatus.state -eq "CLOSED") {
-            Write-Host " -> DELETING"
-            
-            gh cache delete $cacheId
+        
+        try {
+            $prStatus = (gh pr view $prNumber --json state | ConvertFrom-Json).state
+            Write-Host "$prStatus" -NoNewline
+            $shouldDelete = $prStatus -in @("MERGED", "CLOSED")
+        }
+        catch {
+            Write-Host "NOT FOUND" -NoNewline
+            $shouldDelete = $true
+        }
+    }
+    elseif ($cache.ref -match "refs/heads/(.+)" -and $matches[1] -ne "dev") {
+        $branchName = $matches[1]
+        $exists = $branchSet.ContainsKey($branchName)
+        
+        Write-Host "Branch '$branchName': $(if ($exists) { 'EXISTS' } else { 'DELETED' })" -NoNewline
+        $shouldDelete = -not $exists
+    }
+    else {
+        continue
+    }
 
-            $totalClearedSize += $cacheSizeInBytes
-        }
-        else {
-            Write-Host ""
-        }
+    if ($shouldDelete) {
+        Write-Host " -> DELETING"
+        gh cache delete $cache.id
+        $totalClearedSize += $cache.sizeInBytes
+    }
+    else {
+        Write-Host ""
     }
 }
 
-$formattedSize = "{0:N2}" -f ($totalClearedSize / 1MB)
-Write-Output "Cleared size: $formattedSize MB"
+Write-Output "Cleared size: $("{0:N2}" -f ($totalClearedSize / 1MB)) MB"

.github/stale_cache_cleanup.ps1

@@ -11,7 +11,8 @@ $keyPatterns = @(
     "macOS-arm64-maadeps",
     "Linux-x64-maadeps",
     "Linux-arm64-maadeps",
-    "Smoke-testing"
+    "Smoke-testing",
+    "prek-v1|Linux|X64"
 )
 
 # Filter caches matching any of our key patterns

.github/stale_cache_dev.ps1

@@ -19,7 +19,8 @@ $keyPatterns = @(
     "macOS-arm64-maadeps",
     "Linux-x64-maadeps",
     "Linux-arm64-maadeps",
-    "Smoke-testing"
+    "Smoke-testing",
+    "prek-v1|Linux|X64"
 )
 
 foreach ($pattern in $keyPatterns) {

.github/workflows/blame-ignore.yml

@@ -20,6 +20,7 @@ jobs:
 
       - name: Check blame
         id: check_changes
+        continue-on-error: true
         run: |
           LAST_CHECKED_COMMIT=$(cat .github/.last-blame-ignore-commit 2>/dev/null || git rev-list --max-parents=0 HEAD)
 

.github/workflows/ci.yml

@@ -4,18 +4,6 @@ on:
   push:
     tags:
       - "v*"
-    branches-ignore:
-      - "master"
-    paths:
-      - ".github/workflows/ci.yml"
-      - "3rdparty/include/**"
-      - "cmake/**"
-      - "CMakeLists.txt"
-      - "include/**"
-      - "src/**"
-      - "tools/maadeps-download.py"
-      - "!**/*.md"
-  pull_request:
     branches:
       - "dev"
     paths:
@@ -23,6 +11,18 @@ on:
       - "3rdparty/include/**"
       - "cmake/**"
       - "CMakeLists.txt"
+      - "CMakePresets.json"
+      - "include/**"
+      - "src/**"
+      - "tools/maadeps-download.py"
+      - "!**/*.md"
+  pull_request:
+    paths:
+      - ".github/workflows/ci.yml"
+      - "3rdparty/include/**"
+      - "cmake/**"
+      - "CMakeLists.txt"
+      - "CMakePresets.json"
       - "include/**"
       - "src/**"
       - "tools/maadeps-download.py"
@@ -30,7 +30,7 @@ on:
   workflow_dispatch:
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}-${{ github.ref == 'refs/heads/dev' && github.sha }}
+  group: ${{ github.workflow }}-${{ github.event.pull_request.head.repo.full_name || github.repository }}-${{ github.head_ref || github.ref_name }}${{ github.ref == 'refs/heads/dev' && format('-{0}', github.sha) || '' }}
   cancel-in-progress: true
 
 jobs:
@@ -41,6 +41,10 @@ jobs:
       tag: ${{ steps.set_tag.outputs.tag }}
       prerelease: ${{ steps.set_pre.outputs.prerelease }}
     steps:
+      - name: Show concurrency group
+        run: |
+          echo "Concurrency Group: ${{ github.workflow }}-${{ github.event.pull_request.head.repo.full_name || github.repository }}-${{ github.head_ref || github.ref_name }}${{ github.ref == 'refs/heads/dev' && format('-{0}', github.sha) || '' }}"
+
       - name: Checkout repository
         uses: actions/checkout@v6
         with:
@@ -84,7 +88,7 @@ jobs:
           echo "[已有 Mirror酱 CDK？前往 Mirror酱 高速下载](https://mirrorchyan.com/zh/projects?rid=MAA&source=maagh-release)" >> CHANGELOG.md
 
       - name: Upload changelog to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         if: startsWith(github.ref, 'refs/tags/v')
         with:
           name: changelog
@@ -112,7 +116,7 @@ jobs:
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: |
@@ -126,23 +130,30 @@ jobs:
         run: |
           python3 tools/maadeps-download.py ${{ matrix.arch }}-windows
 
-      - name: Config cmake
+      - name: Configure, build and install
         run: |
-          mkdir -p build
-          cmake -B build ${{ matrix.arch == 'arm64' && '-A ARM64' }} -DCMAKE_BUILD_TYPE=RelWithDebInfo -DMAADEPS_TRIPLET='maa-${{ matrix.arch }}-windows' -DINSTALL_RESOURCE=ON -DINSTALL_PYTHON=ON -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}' -DBUILD_WPF_GUI=OFF
+          cmake -B build --preset ${{ matrix.arch == 'arm64' && 'windows-publish-arm64' || 'windows-publish-x64' }} -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}'
+          cmake --build --preset ${{ matrix.arch == 'arm64' && 'windows-publish-arm64' || 'windows-publish-x64' }} --parallel $env:NUMBER_OF_PROCESSORS
+          cmake --install build --config RelWithDebInfo
 
-      - name: Build
-        run: |
-          cmake --build build --config RelWithDebInfo --parallel $env:NUMBER_OF_PROCESSORS
+      - name: Download MaaFramework
+        if: matrix.arch == 'x64'
+        uses: robinraju/release-downloader@v1
+        with:
+          repository: MaaXYZ/MaaFramework
+          latest: true
+          fileName: '*win-x86_64*.zip'
+          extract: true
+          out-file-path: MaaFramework-temp
 
-      - name: Install
+      - name: Copy MaaWin32ControlUnit
+        if: matrix.arch == 'x64'
         run: |
-          mkdir -p install
-          cmake --install build --prefix install --config RelWithDebInfo
+          cp MaaFramework-temp/bin/*Win32ControlUnit* install/
 
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: |
@@ -184,7 +195,7 @@ jobs:
         continue-on-error: true
 
       - name: Upload PDB files
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAAComponent-DebugSymbol-win-${{ matrix.arch }}
           path: install/MAAComponent-DebugSymbol-${{ needs.meta.outputs.tag }}-win-${{ matrix.arch }}.zip
@@ -205,7 +216,7 @@ jobs:
           Compress-Archive -Destination MAA-${{ needs.meta.outputs.tag }}-win-${{ matrix.arch }}.zip -Path ./*
 
       - name: Upload MAA to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAA-win-${{ matrix.arch }}
           path: install/MAA-*.zip
@@ -232,7 +243,7 @@ jobs:
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: ./src/MaaUtils/MaaDeps
@@ -245,28 +256,14 @@ jobs:
         run: |
           python3 tools/maadeps-download.py ${{ matrix.arch == 'x86_64' && 'x64' || 'arm64' }}-linux
 
-      - name: Config cmake
+      - name: Configure, build and install
         run: |
-          mkdir -p build
-          cmake -B build \
-            -DCMAKE_BUILD_TYPE=RelWithDebInfo \
-            -DMAADEPS_TRIPLET='maa-${{ matrix.arch == 'x86_64' && 'x64' || 'arm64' }}-linux' \
-            -DINSTALL_RESOURCE=ON \
-            -DINSTALL_PYTHON=ON \
-            -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}' \
-            -DCMAKE_TOOLCHAIN_FILE=src/MaaUtils/MaaDeps/cmake/maa-${{ matrix.arch == 'x86_64' && 'x64' || 'arm64' }}-linux-toolchain.cmake
-
-      - name: Build
-        run: |
-          cmake --build build --config RelWithDebInfo --parallel $(nproc)
+          cmake --preset ${{ matrix.arch == 'x86_64' && 'linux-publish-x64' || 'linux-publish-arm64' }} -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}'
+          cmake --build --preset ${{ matrix.arch == 'x86_64' && 'linux-publish-x64' || 'linux-publish-arm64' }} --parallel $(nproc)
+          cmake --install build --config RelWithDebInfo
         env:
           CLICOLOR_FORCE: 1
 
-      - name: Install
-        run: |
-          mkdir -p install
-          cmake --install build --prefix install --config RelWithDebInfo
-
       - name: Setup cross compile toolchains for CLI
         uses: ./src/maa-cli/.github/actions/setup
         with:
@@ -274,10 +271,10 @@ jobs:
 
       - name: Build CLI
         run: |
-          cargo build --release --locked --package maa-cli --features vendored-openssl
+          cargo build --release --locked --package maa-cli --features git2/vendored-openssl
           cp -v target/$CARGO_BUILD_TARGET/release/maa $GITHUB_WORKSPACE/install/maa
           cargo build --release --locked --package maa-cli --no-default-features \
-            --features git2,vendored-openssl
+            --features git2,git2/vendored-openssl
           cp -v target/$CARGO_BUILD_TARGET/release/maa $GITHUB_WORKSPACE/appimage-maa
         working-directory: src/maa-cli
 
@@ -324,7 +321,7 @@ jobs:
           tar czvf $GITHUB_WORKSPACE/release/MAA-${{ needs.meta.outputs.tag }}-linux-${{ matrix.arch }}.tar.gz .
 
       - name: Upload MAA to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAA-linux-${{ matrix.arch }}
           path: |
@@ -356,7 +353,7 @@ jobs:
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: ./src/MaaUtils/MaaDeps
@@ -368,23 +365,14 @@ jobs:
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
 
-      - name: Config cmake
+      - name: Configure, build and install
         run: |
-          cmake -B build -GNinja \
-            -DCMAKE_BUILD_TYPE=RelWithDebInfo \
-            -DCMAKE_OSX_ARCHITECTURES='${{ matrix.arch }}' \
-            -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}'
-
-      - name: Build
-        run: |
-          cmake --build build --config RelWithDebInfo --parallel $(sysctl -n hw.logicalcpu)
-
-      - name: Install
-        run: |
-          cmake --install build --prefix install --config RelWithDebInfo
+          cmake -B build --preset ${{ matrix.arch == 'x86_64' && 'macos-publish-x64' || 'macos-publish-arm64' }} -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}'
+          cmake --build --preset ${{ matrix.arch == 'x86_64' && 'macos-publish-x64' || 'macos-publish-arm64' }} --parallel $(sysctl -n hw.logicalcpu)
+          cmake --install build --config RelWithDebInfo
 
       - name: Upload MAA to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAACore-macos-${{ matrix.arch }}
           path: "install/*.dylib"
@@ -410,27 +398,27 @@ jobs:
           git submodule update --init --depth 1 src/MaaMacGui
 
       - name: Download MAA (arm64) from GitHub
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           name: MAACore-macos-arm64
           path: install-arm64
 
       - name: Download MAA (x64) from GitHub
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           name: MAACore-macos-x86_64
           path: install-x86_64
 
       - name: Install Developer ID certificate
         if: startsWith(github.ref, 'refs/tags/v')
-        uses: apple-actions/import-codesign-certs@v5
+        uses: apple-actions/import-codesign-certs@v6
         with:
           p12-file-base64: ${{ secrets.HGUANDL_SIGN_CERT_P12 }}
           p12-password: ${{ secrets.HGUANDL_SIGN_CERT_PASSWD }}
 
       - name: Download provisioning profiles
         if: startsWith(github.ref, 'refs/tags/v')
-        uses: apple-actions/download-provisioning-profiles@v4
+        uses: apple-actions/download-provisioning-profiles@v5
         with:
           bundle-id: "com.hguandl.MeoAsstMac"
           issuer-id: ${{ secrets.HGUANDL_APPSTORE_ISSUER }}
@@ -462,7 +450,7 @@ jobs:
           zip -yrX9 "$name.zip" "$name"
 
       - name: Upload MAA runtime to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAA-macos-runtime-universal
           path: runtime/MAA-${{ needs.meta.outputs.tag }}-macos-runtime-universal.zip
@@ -544,7 +532,7 @@ jobs:
         working-directory: release
 
       - name: Upload MAA to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAA-macos-universal
           path: ${{ startsWith(github.ref, 'refs/tags/v') && 'release/MAA*' || 'src/MaaMacGui/MAA.xcarchive/**' }}
@@ -556,7 +544,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Download MAA from GitHub
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           path: assets
 
@@ -569,7 +557,7 @@ jobs:
           find . -type f | while read f; do mv -fvt . $f; done
 
       - name: Publish release to GitHub
-        uses: softprops/action-gh-release@v2.4.2
+        uses: softprops/action-gh-release@v2.5.0
         with:
           body_path: CHANGELOG.md
           files: |

.github/workflows/codeql-core.yml

@@ -1,56 +0,0 @@
-name: CodeQL Code Analysis
-
-on:
-  pull_request:
-    branches: ["dev"]
-    paths:
-      - ".github/workflows/codeql-core.yml"
-      - "3rdparty/include/**"
-      - "cmake/**"
-      - "CMakeLists.txt"
-      - "include/**"
-      - "src/**"
-      - "!**/*.md"
-      - "!**/*.xaml"
-  schedule:
-    - cron: "45 11 * * *" # Runs daily at 11:45 UTC
-  workflow_dispatch:
-
-permissions:
-  actions: write
-  contents: read
-  packages: read
-  security-events: write
-
-jobs:
-  analyze-manual:
-    name: Analyze MaaCore and MaaWpfGui
-    if: github.repository_owner == 'MaaAssistantArknights'
-    runs-on: windows-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-        with:
-          show-progress: false
-
-      - name: Setup CodeQL
-        uses: github/codeql-action/init@v4
-        with:
-          languages: c-cpp,csharp
-          build-mode: manual
-
-      - name: Run CodeQL
-        uses: github/codeql-action/analyze@v4
-
-      - name: Delete old caches
-        shell: pwsh
-        run: |
-          $oldCaches = gh cache list --key codeql --order asc --json key | ConvertFrom-Json | Select-Object -SkipLast 1
-            foreach ($cache in $oldCaches) {
-              if ($cache.key) {
-                Write-Host "Deleting cache: $($cache.key)"
-                gh cache delete $cache.key
-              }
-            }
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/codeql-wf.yml

@@ -1,37 +0,0 @@
-name: CodeQL Workflow Analysis
-
-on:
-  pull_request:
-    branches: ["dev"]
-    paths:
-      - ".github/**/*.yml"
-  schedule:
-    - cron: "00 12 * * *" # Runs daily at 12:00 UTC
-  workflow_dispatch:
-
-permissions:
-  actions: write
-  contents: read
-  security-events: write
-
-jobs:
-  analyze-workflows:
-    name: Analyze GitHub Workflows
-    if: github.repository_owner == 'MaaAssistantArknights'
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
-        with:
-          show-progress: false
-
-      - name: Setup CodeQL for GitHub Actions
-        uses: github/codeql-action/init@v4
-        with:
-          languages: actions
-          build-mode: none
-
-      - name: Run CodeQL Analysis
-        uses: github/codeql-action/analyze@v4
-        with:
-          category: "/language:multi-none"

.github/workflows/markdown-checker.yml

@@ -36,7 +36,7 @@ jobs:
           show-progress: false
 
       - name: Cache lychee responses
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: .lycheecache

.github/workflows/optimize-templates.yml

@@ -18,18 +18,19 @@ jobs:
   optimize-png:
     name: Optimize PNG Images
     # Skip workflow to prevent double consecutive runs
-    # Skip workflow on PR merges
-    if: github.repository_owner == 'MaaAssistantArknights' && ${{ github.event.head_commit.author.email != '41898282+github-actions[bot]@users.noreply.github.com' }}
+    if: github.repository_owner == 'MaaAssistantArknights' && github.event.head_commit.author.email != '41898282+github-actions[bot]@users.noreply.github.com'
     runs-on: ubuntu-latest
     steps:
+      # Skip workflow on PR merges
       - name: Check if it is a direct push
         id: check_push
         run: |
           if [[ "${{ github.event_name }}" != "workflow_dispatch" ]]; then
-            pr_merge_status=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
-              "https://api.github.com/repos/${{ github.repository }}/commits/${{ github.event.after }}/pulls" | xargs)
+            pr_count=$(curl -s -H "Authorization: token ${{ secrets.GITHUB_TOKEN }}" \
+              "https://api.github.com/repos/${{ github.repository }}/commits/${{ github.event.after }}/pulls" \
+              | jq 'length')
 
-            if [[ "$pr_merge_status" == "[ ]" ]]; then
+            if [[ "$pr_count" == "0" ]]; then
               echo "Direct push detected. Proceeding..."
               echo "is_pr=False" >> $GITHUB_OUTPUT
             else

.github/workflows/pre-commit-scheduled.yml

@@ -0,0 +1,36 @@
+name: Scheduled Pre-commit
+
+on:
+  schedule:
+    # 每天 UTC 21:00 运行（北京时间 5:00）
+    - cron: "0 21 * * *"
+  workflow_dispatch: # 允许手动触发
+
+jobs:
+  pre-commit:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          show-progress: false
+
+      - name: Setup and run Prek
+        uses: j178/prek-action@v1
+        id: pre-commit
+        continue-on-error: true
+        with:
+          extra-args: '--all-files'
+
+      - name: Commit and push changes
+        if: steps.pre-commit.outcome == 'failure' && github.repository_owner == 'MaaAssistantArknights'
+        uses: actions-js/push@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          message: "chore: Auto update by pre-commit hooks
+
+            https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
+
+            [skip changelog]"
+          branch: ${{ github.ref }}

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

@@ -171,7 +171,7 @@ jobs:
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: |
@@ -185,23 +185,30 @@ jobs:
         run: |
           python3 tools/maadeps-download.py ${{ matrix.arch }}-windows
 
-      - name: Config cmake
+      - name: Configure, build and install
         run: |
-          mkdir -p build
-          cmake -B build ${{ matrix.arch == 'arm64' && '-A ARM64' }} -DCMAKE_BUILD_TYPE=RelWithDebInfo -DMAADEPS_TRIPLET='maa-${{ matrix.arch }}-windows' -DINSTALL_RESOURCE=ON -DINSTALL_PYTHON=ON -DMAA_HASH_VERSION='${{ steps.set_tag.outputs.tag }}' -DBUILD_WPF_GUI=OFF
+          cmake -B build --preset ${{ matrix.arch == 'arm64' && 'windows-publish-arm64' || 'windows-publish-x64' }} -DMAA_HASH_VERSION='${{ steps.set_tag.outputs.tag }}'
+          cmake --build --preset ${{ matrix.arch == 'arm64' && 'windows-publish-arm64' || 'windows-publish-x64' }} --parallel $env:NUMBER_OF_PROCESSORS
+          cmake --install build --config RelWithDebInfo
 
-      - name: Build
-        run: |
-          cmake --build build --config RelWithDebInfo --parallel $env:NUMBER_OF_PROCESSORS
+      - name: Download MaaFramework
+        if: matrix.arch == 'x64'
+        uses: robinraju/release-downloader@v1
+        with:
+          repository: MaaXYZ/MaaFramework
+          latest: true
+          fileName: '*win-x86_64*.zip'
+          extract: true
+          out-file-path: MaaFramework-temp
 
-      - name: Install
+      - name: Copy MaaWin32ControlUnit
+        if: matrix.arch == 'x64'
         run: |
-          mkdir -p install
-          cmake --install build --prefix install --config RelWithDebInfo
+          cp MaaFramework-temp/bin/*Win32ControlUnit* install/
 
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: |
@@ -233,7 +240,7 @@ jobs:
 
       - name: Publish WPF GUI
         run: |
-          dotnet publish src/MaaWpfGui/MaaWpfGui.csproj -c Release -o install
+          dotnet publish src/MaaWpfGui/MaaWpfGui.csproj -c Release -p:Platform=${{ matrix.arch == 'arm64' && 'ARM64' || 'x64' }} -o install
 
       - name: Collect PDB files
         run: |
@@ -242,7 +249,7 @@ jobs:
         continue-on-error: true
 
       - name: Upload PDB files
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAAComponent-DebugSymbol-win-${{ matrix.arch }}
           path: install/MAAComponent-DebugSymbol-${{ steps.set_tag.outputs.tag }}-win-${{ matrix.arch }}.zip
@@ -258,7 +265,7 @@ jobs:
           cp tools/DependencySetup_依赖库安装.bat install
 
       - name: Upload MAA to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MAA-win-${{ matrix.arch }}
           path: install
@@ -319,7 +326,7 @@ jobs:
           show-progress: false
 
       - name: Download MAA from GitHub
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           name: MAA-win-${{ matrix.target }}
           path: ${{ format('{0}/{1}', 'build-ota', needs.build-win-nightly.outputs.tag) }}

.github/workflows/release-ota.yml

@@ -77,7 +77,7 @@ jobs:
           PUSH_REMOTE: https://github-actions[bot]:${{ secrets.MAARELEASE_RELEASE }}@github.com/${{ github.repository_owner }}/MaaRelease
 
       - name: Upload release config to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: MaaReleaseConfig
           path: ./build-ota/config
@@ -96,7 +96,7 @@ jobs:
           - x64
     steps:
       - name: Download release config
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           name: MaaReleaseConfig
           path: ./MaaReleaseConfig

.github/workflows/release-package-distribution.yml

@@ -18,6 +18,11 @@ on:
         type: boolean
         required: false
         default: true
+      maa_cos:
+        description: "Upload to MAA COS"
+        type: boolean
+        required: false
+        default: true
 
 env:
   RELEASE_TAG_RAW: ${{ github.event.inputs.release_tag || 'latest' }}
@@ -55,78 +60,49 @@ jobs:
     name: Upload to MirrorChyan
     needs: meta
     if: ${{ github.event.inputs.mirrorchyan == 'true' }}
-    runs-on: macos-latest
+    runs-on: ubuntu-latest
     continue-on-error: true
 
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: win
+            arch: x64
+            filename: "*MAA-*-win-x64.zip"
+            extra_zip: false
+          - os: win
+            arch: arm64
+            filename: "*MAA-*-win-arm64.zip"
+            extra_zip: false
+          - os: macos
+            arch: arm64
+            filename: "MAA-*-macos-universal.dmg"
+            extra_zip: true
+          - os: macos
+            arch: x64
+            filename: "MAA-*-macos-universal.dmg"
+            extra_zip: true
+
     env:
       RELEASE_TAG: ${{ needs.meta.outputs.RELEASE_TAG }}
 
     steps:
-      - name: Upload MAA win x64
+      - name: Upload MAA ${{ matrix.os }} ${{ matrix.arch }}
         uses: MirrorChyan/uploading-action@v1
         continue-on-error: true
         with:
           filetype: latest-release
-          filename: "*MAA-*-win-x64.zip"
+          filename: ${{ matrix.filename }}
+          extra_zip: ${{ matrix.extra_zip }}
           tag: ${{ env.RELEASE_TAG }}
           mirrorchyan_rid: MAA
-
           github_token: ${{ secrets.GITHUB_TOKEN }}
           owner: ${{ github.repository_owner }}
           repo: ${{ github.event.repository.name }}
           upload_token: ${{ secrets.MirrorChyanUploadToken }}
-          os: win
-          arch: x64
-
-      - name: Upload MAA win arm64
-        uses: MirrorChyan/uploading-action@v1
-        continue-on-error: true
-        with:
-          filetype: latest-release
-          filename: "*MAA-*-win-arm64.zip"
-          tag: ${{ env.RELEASE_TAG }}
-          mirrorchyan_rid: MAA
-
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          owner: ${{ github.repository_owner }}
-          repo: ${{ github.event.repository.name }}
-          upload_token: ${{ secrets.MirrorChyanUploadToken }}
-          os: win
-          arch: arm64
-
-      - name: Upload MAA macos arm64
-        uses: MirrorChyan/uploading-action@v1
-        continue-on-error: true
-        with:
-          filetype: latest-release
-          filename: "MAA-*-macos-universal.dmg"
-          extra_zip: true
-          tag: ${{ env.RELEASE_TAG }}
-          mirrorchyan_rid: MAA
-
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          owner: ${{ github.repository_owner }}
-          repo: ${{ github.event.repository.name }}
-          upload_token: ${{ secrets.MirrorChyanUploadToken }}
-          os: macos
-          arch: arm64
-
-      - name: Upload MAA macos x64
-        uses: MirrorChyan/uploading-action@v1
-        continue-on-error: true
-        with:
-          filetype: latest-release
-          filename: "MAA-*-macos-universal.dmg"
-          extra_zip: true
-          tag: ${{ env.RELEASE_TAG }}
-          mirrorchyan_rid: MAA
-
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          owner: ${{ github.repository_owner }}
-          repo: ${{ github.event.repository.name }}
-          upload_token: ${{ secrets.MirrorChyanUploadToken }}
-          os: macos
-          arch: x64
+          os: ${{ matrix.os }}
+          arch: ${{ matrix.arch }}
 
   winget:
     name: Upload to WinGet
@@ -149,3 +125,30 @@ jobs:
           release-tag: ${{ env.RELEASE_TAG }}
           fork-user: MaaAssistantArknights
           token: ${{ secrets.MAABOT_WINGET_TOKEN }}
+
+  maa_cos:
+    name: Upload to MAA COS
+    needs: meta
+    if: ${{ github.event.inputs.maa_cos == 'true' && !contains(needs.meta.outputs.RELEASE_TAG, '-') }}
+    runs-on: ubuntu-latest
+    continue-on-error: true
+    env:
+      FILENAME: MAA-${{ needs.meta.outputs.RELEASE_TAG }}-win-x64.zip
+
+    steps:
+      - uses: robinraju/release-downloader@v1
+        with:
+          repository: 'MaaAssistantArknights/MaaAssistantArknights'
+          latest: true
+          fileName: ${{ env.FILENAME }}
+          out-file-path: 'downloads'
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Upload to COS
+        uses: zkqiang/tencent-cos-action@v0.1.0
+        with:
+          args: upload -rs downloads/${{ env.FILENAME }} MAA/${{ env.FILENAME }}
+          secret_id: ${{ secrets.MISTEO_MAA_COS_SECRET_ID }}
+          secret_key: ${{ secrets.MISTEO_MAA_COS_SECRET_KEY }}
+          bucket: ${{ secrets.MISTEO_MAA_COS_BUCKET }}
+          region: ${{ secrets.MISTEO_MAA_COS_REG }}

.github/workflows/release-preparation.yml

@@ -80,7 +80,7 @@ jobs:
           git commit -m "$commit_msg"
 
       - name: Create changelog PR
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v8
         with:
           sign-commits: true
           token: ${{ secrets.GITHUB_TOKEN }}
@@ -95,7 +95,7 @@ jobs:
             AnnAngela
 
       - name: Assign reviewers to release PR
-        uses: kentaro-m/auto-assign-action@v2.0.0
+        uses: kentaro-m/auto-assign-action@v2.0.1
         with:
           configuration-path: ".github/release_reviewers.yaml"
 

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

@@ -37,7 +37,7 @@ jobs:
             /gamedata/excel/activity_table.json
 
       - name: Upload Official resources
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: official
           path: ./Official
@@ -80,7 +80,7 @@ jobs:
             /kr/gamedata/excel/activity_table.json
 
       - name: Upload Overseas resources
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: overseas
           path: ./Overseas
@@ -133,7 +133,7 @@ jobs:
           fi
 
       - name: Upload Taiwan resources
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: txwy
           path: ./excel
@@ -159,7 +159,7 @@ jobs:
 
       - name: Restore ResourceUpdater from cache
         id: resupd-cache
-        uses: actions/cache/restore@v4
+        uses: actions/cache/restore@v5
         continue-on-error: true
         with:
           key: ResourceUpdater-${{ runner.os }}-${{ hashFiles('tools/ResourceUpdater/main.cpp') }}
@@ -170,7 +170,7 @@ jobs:
       - name: Cache MaaDeps
         if: steps.resupd-cache.outputs.cache-hit != 'true'
         id: maadeps-cache
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: |
@@ -184,29 +184,17 @@ jobs:
         run: |
           python3 tools/maadeps-download.py arm64-osx
 
-      - name: Config cmake
+      - name: Config, Build & Install ResourceUpdater
         if: steps.resupd-cache.outputs.cache-hit != 'true'
         run: |
           cd tools/ResourceUpdater
-          mkdir -p build
-          cmake -B build -GNinja \
-            -DCMAKE_BUILD_TYPE=Release \
-            -DMAADEPS_TRIPLET='maa-arm64-osx' \
-            -DWITH_HASH_VERSION=ON
-
-      - name: Build
-        if: steps.resupd-cache.outputs.cache-hit != 'true'
-        run: |
-          cmake --build tools/ResourceUpdater/build --config Release --parallel $(sysctl -n hw.logicalcpu)
-
-      - name: Install
-        if: steps.resupd-cache.outputs.cache-hit != 'true'
-        run: |
-          cmake --install tools/ResourceUpdater/build --prefix tools/ResourceUpdater --config Release
+          cmake --preset res-updater-macos-arm64
+          cmake --build --preset res-updater-macos-arm64 --parallel $(sysctl -n hw.logicalcpu)
+          cmake --install build --config Release
 
       - name: Save ResourceUpdater to cache
         if: always() && steps.resupd-cache.outputs.cache-hit != 'true'
-        uses: actions/cache/save@v4
+        uses: actions/cache/save@v5
         continue-on-error: true
         with:
           key: ResourceUpdater-${{ runner.os }}-${{ hashFiles('tools/ResourceUpdater/main.cpp') }}
@@ -225,19 +213,19 @@ jobs:
           ttl: 15
 
       - name: Download txwy
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           name: txwy
           path: ./tools/ResourceUpdater/Overseas/tw/gamedata/excel
 
       - name: Download Overseas
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           name: overseas
           path: ./tools/ResourceUpdater/Overseas
 
       - name: Download Official
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@v7
         with:
           name: official
           path: ./tools/ResourceUpdater/Official
@@ -271,7 +259,7 @@ jobs:
       - name: Cache python packages
         if: always() && steps.update_version.outputs.contains_png == 'True'
         id: cache_python
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: ${{ env.pythonLocation }}/Lib/site-packages
@@ -291,7 +279,7 @@ jobs:
       - name: Optimize png images
         if: steps.update_version.outputs.contains_png == 'True'
         run: |
-          python3 tools/OptimizeTemplates/optimize_templates.py -p resource/template/items/ resource/template/infrast/
+          python3 tools/OptimizeTemplates/optimize_templates.py --no-cleanup -p resource/template/items/ resource/template/infrast/
 
       - name: Commit changes
         if: steps.update_version.outputs.changes == 'True'

.github/workflows/smoke-testing.yml

@@ -4,6 +4,8 @@ permissions:
 
 on:
   push:
+    branches:
+      - "dev"
     paths:
       - ".github/workflows/smoke-testing.yml"
       - "3rdparty/include/**"
@@ -32,7 +34,7 @@ on:
   workflow_dispatch:
 
 concurrency:
-  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}-${{ github.ref == 'refs/heads/dev' && github.sha }}
+  group: ${{ github.workflow }}-${{ github.event.pull_request.head.repo.full_name || github.repository }}-${{ github.head_ref || github.ref_name }}${{ github.ref == 'refs/heads/dev' && format('-{0}', github.sha) || '' }}
   cancel-in-progress: true
 
 jobs:
@@ -54,7 +56,7 @@ jobs:
       - name: Restore cache for Smoke Test
         if: ${{ steps.cache_key.outputs.key != '' }}
         id: smoke-cache
-        uses: actions/cache/restore@v4
+        uses: actions/cache/restore@v5
         continue-on-error: true
         with:
           key: ${{ steps.cache_key.outputs.key }}
@@ -74,7 +76,7 @@ jobs:
       - name: Cache MaaDeps
         if: steps.smoke-cache.outputs.cache-hit != 'true'
         id: maadeps-cache
-        uses: actions/cache@v4
+        uses: actions/cache@v5
         continue-on-error: true
         with:
           path: ./src/MaaUtils/MaaDeps
@@ -87,27 +89,12 @@ jobs:
         run: |
           python3 tools/maadeps-download.py arm64-osx
 
-      - name: Config cmake
+      - name: Configure, build and install
         if: steps.smoke-cache.outputs.cache-hit != 'true'
         run: |
-          mkdir -p build
-          cmake -B build -GNinja \
-            -DCMAKE_BUILD_TYPE=Debug \
-            -DMAADEPS_TRIPLET='maa-arm64-osx' \
-            -DBUILD_SMOKE_TEST=ON \
-            -DINSTALL_RESOURCE=ON \
-            -DWITH_HASH_VERSION=ON
-
-      - name: Build
-        if: steps.smoke-cache.outputs.cache-hit != 'true'
-        run: |
-          cmake --build build --config Debug --parallel $(sysctl -n hw.logicalcpu)
-
-      - name: Install
-        if: steps.smoke-cache.outputs.cache-hit != 'true'
-        run: |
-          mkdir -p install
-          cmake --install build --prefix install --config Debug
+          cmake -B build --preset smoke-test
+          cmake --build build --preset smoke-test --parallel $(sysctl -n hw.logicalcpu)
+          cmake --install build --config Debug
 
       - name: Make link to Smoke Test cache
         if: steps.smoke-cache.outputs.cache-hit == 'true'
@@ -120,21 +107,21 @@ jobs:
 
       - name: Save cache for Smoke Test (only in dev)
         if: steps.smoke-cache.outputs.cache-hit != 'true' && github.ref == 'refs/heads/dev'
-        uses: actions/cache/save@v4
+        uses: actions/cache/save@v5
         continue-on-error: true
         with:
           key: ${{ steps.cache_key.outputs.key }}
           path: |
             ./install/libfastdeploy_ppocr.dylib
-            ./install/libMaaUtils.dylib
             ./install/libMaaCore.dylib
+            ./install/libMaaUtils.dylib
             ./install/libonnxruntime.1.19.2.dylib
             ./install/libopencv_world4.4.11.0.dylib
             ./install/smoke_test
 
       - name: Upload logs
         if: always()
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: logs
           path: ./install/debug

.github/workflows/website-workflow.yml

@@ -61,7 +61,7 @@ jobs:
         working-directory: "./docs"
 
       - name: Upload artifact to GitHub
-        uses: actions/upload-artifact@v5
+        uses: actions/upload-artifact@v6
         with:
           name: dist
           path: "./docs/.vuepress/dist"

.gitignore

@@ -411,10 +411,10 @@ FodyWeavers.xsd
 # VS Code files for those working on multiple tools
 **/.vscode/*
 .vscode/*
-!.vscode/settings.json
-!.vscode/tasks.json
-!.vscode/launch.json
-!.vscode/extensions.json
+# !.vscode/settings.json
+# !.vscode/tasks.json
+# !.vscode/launch.json
+# !.vscode/extensions.json
 *.code-workspace
 
 # Local History for Visual Studio Code
@@ -434,7 +434,6 @@ FodyWeavers.xsd
 screen.png
 adb_screen.png
 tools/**/*.png
-.vscode
 enc_temp_folder/*
 
 # RoguelikeRecruitmentTool 导出的 Excel 文件
@@ -479,3 +478,6 @@ install
 
 # pnpm cache
 .pnpm-store
+
+# CMake user presets
+CMakeUserPresets.json

.pre-commit-config.yaml

@@ -1,23 +1,22 @@
 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.5
+    rev: v10.0.0
     hooks:
       - id: oxipng
         name: PNG Image Compression
         args: ["-q", "-o", "2", "-s", "--ng"]
+
   - repo: https://github.com/pre-commit/mirrors-clang-format
-    rev: v21.1.1
+    rev: v21.1.8
     hooks:
       - id: clang-format
         name: Clang-Format (MaaCore)
         files: ^src/MaaCore/.*
         args: ["--assume-filename", ".clang-format"]
+
   - repo: https://github.com/rbubley/mirrors-prettier
-    rev: v3.6.2
+    rev: v3.7.4
     hooks:
       - id: prettier
         name: Prettier (Config Files)
@@ -28,17 +27,13 @@ repos:
       - id: prettier
         name: Prettier (Documentation)
         files: ^docs/.*
-  - repo: https://github.com/psf/black
-    rev: 25.9.0
+
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.10
     hooks:
-      - id: black
-        name: Black Formatter (Python)
-  - repo: https://github.com/pycqa/isort
-    rev: 6.0.1
-    hooks:
-      - id: isort
-        name: Isort (Python)
-        args: ["--profile", "black", "--filter-files"]
+      - id: ruff-format
+        name: Ruff format (Python)
+
   - repo: https://github.com/DavidAnson/markdownlint-cli2
     rev: v0.18.1
     hooks:

.vscode/settings.json

@@ -15,5 +15,6 @@
     "files.associations": {
         "**/resource/tasks/**/*.json": "jsonc"
     },
-    "C_Cpp.exclusionPolicy": "checkFilesAndFolders"
+    "C_Cpp.exclusionPolicy": "checkFilesAndFolders",
+    "cmake.outputLogEncoding": "UTF-8"
 }

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

@@ -115,15 +115,15 @@ static constexpr double rel_pos_x = 1.3143386840820312;
 static constexpr double rel_pos_y = 1.314337134361267;
 static constexpr double rel_pos_z = -0.3967874050140381;
 
-inline auto get_retreat_screen_pos(const Level& level)
+inline auto get_retreat_screen_pos(const Level& level, bool has_multi_stages = false)
 {
-    const vec3d relative_pos = { -rel_pos_x, +rel_pos_y, rel_pos_z };
+    const vec3d relative_pos = { -rel_pos_x + (has_multi_stages ? level.view[0].x : 0), +rel_pos_y, rel_pos_z };
     return world_to_screen(level, relative_pos, true);
 }
 
-inline auto get_skill_screen_pos(const Level& level)
+inline auto get_skill_screen_pos(const Level& level, bool has_multi_stages = false)
 {
-    const vec3d relative_pos = { +rel_pos_x, -rel_pos_y, rel_pos_z };
+    const vec3d relative_pos = { +rel_pos_x + (has_multi_stages ? level.view[0].x : 0), -rel_pos_y, rel_pos_z };
     return world_to_screen(level, relative_pos, true);
 }
 

CHANGELOG.md

@@ -1,276 +1,268 @@
-## v5.28.5
+## v6.3.2
 
-### Highlights
+### 拉电线不知天地为何物 | Highlight
 
-#### 继续修 BUG
+本次版本更新真的是千呼万唤始出来，也恰逢新年版本和 PC 端的发布，我们在这个版本提供了对 PC 端的初步支持，也合并了 SideStory ｢辞岁行｣ 的数据。
 
-在这个版本，我们继续修复了大量 BUG，并且优化了遇到各类错误时的调试体验。
+#### Windows 端一键长草任务配置重构
 
-#### 错误处理方面
+本次更新我们对 Windows 端 ｢一键长草｣ 任务配置进行了重构，解决了一些痛点。
 
-* 出错时鼠标悬浮在任务错误日志上即可查看出错时的截图，方便快速定位问题。
-* ｢生成日志压缩包｣ 功能现在支持同时打包 `debug` 文件夹的截图，并支持分卷压缩，在 GitHub 之类有文件大小限制的地方可以传分卷包（单个分卷最大 20 MB），更加灵活方便。
+现在牛牛支持添加多个重复类型任务，并支持重命名。现在你可以通过 ｢一键长草｣ 任务左下角的加号按钮添加多个同类型任务，并可以通过拖拽任务来调整任务执行顺序，以及右键点击任务右侧的齿轮图标重命名和删除任务，这样你就可以更灵活地管理任务。
 
-#### 自动战斗方面
+牛牛也新增了理智作战任务的周计划设置，可按星期数（如星期三、星期二、星期五等）设置任务是否执行。这样你就可以结合上面提到的添加任务，<u>在理智作战任务前添加另一个理智作战任务，并将其设置为仅打当期剿灭、仅在星期一运行</u>，更多用法等你探索~
 
-* 自动战斗在只缺一个干员的时候，现在支持自动借缺少的干员，让自动战斗更加智能和便捷。
-* 根据 B 站官号投票动态的结果，我们优化了自动战斗界面的显示效果，布局更加合理，操作更加便捷。
+另外，在牛牛执行一键长草流程时，各个任务的勾选框会根据其运行状态以不同颜色进行区分，直观反馈任务被跳过、已完成、运行中或执行失败等状态。
 
-#### 肉鸽相关修复
+注：由于牛牛现已支持 ｢理智作战｣ 周计划并可添加多个同类型任务，本次更新**移除了原有 ｢剿灭作战｣ 任务失败后自动尝试下一个已开放的备选逻辑**，如有需要请参照上方的示例添加对应任务。
 
-修复了大量集成战略相关问题，包括界园肉鸽 boss 识别、通宝配置解析、不期而遇事件识别、萨米肉鸽任务链等，提升了肉鸽自动化的稳定性。
+#### PC 端初步支持
+
+本次更新，牛牛已支持控制 PC 端明日方舟了~不过有以下限制：
+
+* 由于 Windows 的限制，PC 端在被控制时**不可以处于最小化窗口状态**，否则游戏画面不会被渲染，也就无法被牛牛识别；
+* 由于 Win32 API 和某反作弊软件的限制，牛牛在控制 PC 端时**必须要直接控制鼠标（不能模拟点击）**，期间不建议你使用鼠标。
+
+另外，由于维护人手有限，PC 端的适配可能长期处于不稳定状态，部分功能可能出现异常或暂时无法使用。
+
+我们非常欢迎社区开发者协助适配并提交改进，共同完善对 PC 端的支持。
 
 #### 其他方面
 
-我们发现，牛牛在使用 GPU 推理时，如果 GPU 驱动过旧可能会产生兼容性问题，因此我们添加了一项检测，当发现你的 GPU 驱动超过 2 年没有更新时会给出提示，我们建议你更新驱动以获得更好的体验。
-
-#### 基建会客室线索处理（v5.28.5 及以上版本）
-
-* 支持会客室快捷置入线索与一键赠送重复线索功能，提升基建线索管理效率。
+* 我们继续对界园肉鸽进行适配，包括 DLC 2 的更新支持；
+* 我们优化了自动编队的识别，现在支持对作业要求的精英化、等级和模组的识别，如果发现你的干员不满足要求将会有对应提示；
+* 相应的，干员识别功能也支持显示精英化和等级了。
 
 ----
 
-In this version, we continued to fix numerous bugs and optimized the debugging experience when encountering various types of errors.
+#### Restructuring of *Farming* Configuration for Windows
 
-#### Mini-game - PV-Fireworks Committee (v5.28.2 and above)
+In this update, we have restructured the *Farming* configuration for Windows, addressing several pain points.
 
-Added support for the PV-Fireworks Committee mini-game. Start from the leftmost side of the mini-game interface.
+MAA now supports adding multiple tasks of the same type and renaming them. You can add multiple tasks of the same type using the plus button at the bottom left of the *Farming* panel, adjust the execution order by dragging tasks, and rename or delete tasks by right-clicking the gear icon on the right side of each task. This allows for more flexible task management.
 
-#### Error Handling
+MAA also supports weekly schedule settings for *Combat* tasks, allowing you to specify on which days of the week (e.g., Monday, Thursday) a task should run. For example, you can add another *Combat* task before your existing one and set it to only run Current Annihilation on Mondays. More usage scenarios await your exploration!
 
-* When an error occurs, hovering the mouse over the task error log now displays a screenshot, allowing you to quickly locate the problem.
-* The "Generate Support Payload" feature now supports packaging screenshots of the `debug` folder simultaneously and supports multi-part compression. This allows for uploading multi-part packages (each part up to 20 MB) to platforms with file size limits, such as GitHub.
+Additionally, when MAA executes the *Farming* process, the checkboxes for each task will be color-coded to indicate their status: skipped, completed, running, or failed, providing intuitive feedback.
 
-#### *EN Only* I.S. stuck issues.
+Note: Since MAA now supports weekly schedules for *Combat* tasks and allows adding multiple tasks of the same type, this update **removes the previous logic that automatically attempted the next available alternative stage after a "Current Annihilation" task failure**. If needed, please refer to the example above to add corresponding tasks.
 
-* The maintainers are aware of MAA getting stuck in the formation before starting an I.S. fighting stage. We still haven't been able to 100% deduct (and reproduce) the issue. Multiple fixes have been attempted. This stable version attemps to fix by completely overwriting the current template `Quick Select`. After various discussions on the Discord support channel, it appears the template really was the issue(?). Comparing with the older template (pre Tragodia update) the position seems slightly changed (and apparently) even the clicking box hence why the issues.
+#### Preliminary PC Client Support (**[CN ONLY]**)
 
-#### *Copilot*
+In this update, MAA now supports controlling the PC client of Arknights.
 
-* When only one operator is missing in *Copilot*, MAA can now supports automatically borrow the missing Support Unit, making *Copilot* more intelligent and convenient.
-* Based on the results of a poll on the official Bilibili account, we optimized the layout of the *Copilot* interface, making it more intuitive and easier to use.
+However, due to limited maintenance resources, PC client adaptation may remain unstable for a long period, and some features may experience issues or be temporarily unavailable.
 
-#### *Auto I.S.* Fixes
+We warmly welcome community developers to assist with adaptation and submit improvements to collectively enhance PC client support.
 
-We fixed numerous issues related to *Auto I.S.*, including Boss recognition in the *Sui's Garden of Grotesqueries*, Tongbao configuration parsing, Encounter event recognition, and quest chains in the *Expeditioner's Jǫklumarkar*, improving the stability of *Auto I.S.*.
+#### Other Updates
 
-#### Other Aspects
-
-We found that outdated GPU drivers may cause compatibility issues when MAA performs GPU inference. Therefore, we added a detection feature that alerts you when your GPU driver has not been updated for more than 2 years and recommends updating it for a better experience.
-
-#### *Infrastructure* Reception Room Clue Handling (v5.28.5 and above)
-
-* Support for quick clue insertion and one-click sending of duplicate clues in the Reception Room, improving infrastructure clue management efficiency.
+* Continued adaptation for *Sui's Garden of Grotesqueries*, including support for DLC 2 updates (**[CN ONLY]**)
+* Optimized recognition in *Auto Squad*, which now supports identifying elite, level, and module requirements. If your operators do not meet the requirements, you will receive corresponding prompts.
+* The operator recognition feature now also supports displaying elite and level information.
 
 ----
 
 以下是详细内容：
 
-## v5.28.0
+## v6.3.2
 
 ### 新增 | New
 
-* 任务错误日志鼠标悬浮可以查看出错时截图 @ABA2396
-* 自动战斗支持切换技能用法使用坐标 @status102
-* 为 GPU 加速添加超过 2 年的驱动版本检测 (#14690) @Rbqwow @status102
+* 睡眠休眠前增加倒计时弹窗 @ABA2396
+* 生息演算支援道具名称改为全字匹配 @ABA2396
 
 ### 改进 | Improved
 
-* 改进自动借助战功能 (#11105) @Alan-Charred
-* 优化自动战斗界面显示 (#14795) @ABA2396 @HX3N @Constrat @Manicsteiner @status102
-* 日志汇报打包 debug 截图，支持分卷，修改存储路径 @ABA2396
-* 拆分多主题识别任务 (#14774) @SherkeyXD
-
-### 修复 | Fix
-
-* 部分名片无法进入线索交接 @ABA2396
-* 修复放弃通宝的后续任务逻辑 (#14840) @travellerse
-* 在未进入缩小的全局总览的时可能进错宿舍 @ABA2396
-* 修复 "入暂亭" 事件 (#14684) @Alan-Charred
-* 修复界园肉鸽第 3 层与第 5 层 boss 无法区分、第 5 层 boss 前暂停设置无效 @ABA2396
-* 修复界园树洞偶发点击到剩余烛火，导致无法进入下一个节点 (#14806) @travellerse
-* 修复通宝配置解析逻辑及左侧通宝解析失败的情况 (#14802, #14820) @travellerse
-* 修正通宝识别中的坐标 (#14829) @travellerse
-* 修复集成战略萨米主题下凹密闻板相关功能 (#14755) @Alan-Charred
-* 简化萨米肉鸽 "诡秘的预感" 相关任务链 (#14749) @Alan-Charred
-* 修正不期而遇事件名 OCR 以区分禳解的 3 个相近选项，添加不期而遇事件名 OCR 替换 (#14799, #14588) @travellerse
-* 肉鸽可能卡进剧目获取界面和收藏品界面 @Saratoga-Official
-* 肉鸽允许跳过招募组合直接开始初始招募 (#14713) @Alan-Charred
-* 保存招募券结束后等待确认招募按钮消失 (#14773) @travellerse
-* 防止生息演算重置地图视图时因截图延迟卡死 (#14721) @Alan-Charred
-* 给 open_series_list 加上失败截图机制 (#14693) @Alan-Charred
-* 投资入口识别失败 @Saratoga-Official
-* 进一步调整 WpfGui 助战选项显示布局 @Alan-Charred
-* 上调助战栏位匹配分数阈值 (#14796) @Alan-Charred
-* 单文件模式下总是传递借助战 @ABA2396
-* 自动借助战错误显示 @ABA2396
-* 干员识别包含 盟约·辅助干员 和 领主·Sharp @ABA2396
-* 干员识别复制结果到剪贴板时丢失未拥有干员 @status102
-* 关卡复核会把 8 识别成 g @Saratoga-Official
-* 通关角标识别错误 @ABA2396
-* 刷理智指定次数未完全消耗警告在剩余理智也会提示 @status102
-* 避免输出空矩阵 @ABA2396
-* RA 导航错误 @ABA2396
-* build WpfGui for ARM architecture (#14722) @Alan-Charred
-* copilot file name (#14821) @Manicsteiner
-* JP paradox @Manicsteiner
-* KR 引航任务识别 @Daydreamer114
-* KR AD navigation (#14742) @HX3N
-* ocrReplace for EN (#14740) @Alan-Charred @Saratoga-Official
-* reduce template size for QuickFormation RL @Constrat
-* Sami IS EN 3rd floor regex @Constrat
-* regex AD navigation EN @Constrat
-
-### 文档 | Docs
-
-* 自动战斗文档添加 copilot_list, is_raid, is_paradox, loop_times 注释 @Alan-Charred
-
-### 其他 | Other
-
-* 移除过旧的 `add_user_additional` 参数弃用提示 @status102
-* 简化 ROI 修正逻辑 @ABA2396
-* 调整 ExportOperBox 内的变量命名与结构 @ABA2396
-* 清日志时手动清除 ToolTip @ABA2396
-* std::signal 自动舍弃 abort / terminate 上方栈 @status102
-* 分卷压缩包大小改成 20 MB @ABA2396
-* 向 MaaCore 工程增加 tasks 文件以便检索 (#14731) @status102
-* 更新多模板截图工具 @SherkeyXD
-* 移除部分无需的 include @status102
-* 路径迁移 @status102
-* 修复 UI 细节 @hguandl
+* 干员识别按照 稀有度->精英化->等级->潜能->Id 排序 @ABA2396
+* 优化识别工具中列表小于 5 时的显示效果 @ABA2396
 * optimize templates @Constrat
-* JP ocr edits (#14748) @Manicsteiner
-* KR tweak SupportUnitUsage translation @HX3N
-* KR @hguandl
-* SSS#8 for global (#14803) @Manicsteiner
-
-----
-
-## v5.28.1
-
-### 新增 | New
-
-* PV-烟花筹委会 小游戏 @ABA2396 @weinibuliu
-* 刷理智失败次数达到上限时报错 @ABA2396
-* update meojson to v5.0.0 (#14849) @MistEO
-
-### 改进 | Improved
-
-* wpf Debug 压缩包切片增加时间前缀 @status102
-* 改进 ImageCropper @weinibuliu
-* 更新肉鸽协议文档和界园肉鸽商品列表 (#14873) @DavidWang19
+* increase score for AddOperatorTradeAggressive EN @Constrat
 
 ### 修复 | Fix
 
-* 基建换班卡死在无人机使用界面 @ABA2396
-* 齐聚主题会在基建同时存在红蓝两个提示的时候无法进入 @ABA2396
-* 战斗列表只有第一关会使用助战干员 @status102
-* 避免通宝插件通过任务链作用到通宝以外的地方 (#14867) @travellerse
-* 功能入口添加重试机制 (#14872) @ABA2396
-* fix regex_error(error_badrepeat) @Constrat
+* 4 星公招时间显示错误 @ABA2396
+* 刷理智自定义剿灭关卡在特定情况的绑定错误 @status102
+* 在禁用刷理智-自定义剿灭关卡后需要手动切换任务以刷新列表中显示的剿灭关卡, 尽管不影响实际运行 @status102
+* 会客室任务失败重试时尝试关闭赠送线索界面 @ABA2396
+* 肉鸽开局种子无法通过 Wpf 设置两位数难度 @status102
+* 小工具-公招识别 3~5 星选择时间无法修改 @status102
+* 小工具-干员识别 开始识别按钮启用状态绑定失效 @status102
+* 自动公招任务 3~5 星确认时间在修改后未能刷新 UI @status102
+* EN AveMujica terminal new template @Constrat
+* EN IS tentative fix increasing roi for encounter and more replace regex @Constrat
+* English text overflow on long strings in middle column @Constrat
 
 ### 文档 | Docs
 
-* issue 模板修改 25 MB 压缩包上传提示 (#14850) @Rbqwow
+* 删除一些过时内容 (#15700) @JasonHuang79
 
 ### 其他 | Other
 
-* 遗漏的 MaaCore.pdb 和 MaaUtils/pdb
-* 整理截图 @ABA2396
-* 调整 StartToVisit 阈值 @ABA2396
-* remove and sort usings (#14877) @SherkeyXD
+* 增加 id 格式验证 @ABA2396
+* 明确周计划和定时更新使用游戏时间而非现实时间 @ABA2396
+* 移除老主线导航逻辑 (#15644) @SherkeyXD
+* 繁中服「夢鄉」主題 (#15699) @momomochi987
+* Yostar servers SSS#9 and ShamareThumbnail (#15732) @Manicsteiner @Constrat
 
-----
-
-## v5.28.2
-
-### 修复 | Fix
-
-* 概率无法进入小游戏第八关之后的关卡 @weinibuliu
-
-----
-
-## v5.28.3
+## v6.3.1
 
 ### 新增 | New
 
-* 支持 PV 小游戏从当前关卡开始 @ABA2396
-* PV 小游戏 macOS 支持 @hguandl
+* OperNameAnalyzer 支持左对齐检测 (#15682) @ABA2396
 
 ### 改进 | Improved
 
-* 优化 PV 小游戏识别范围与部分复杂背景关卡的识别 @ABA2396
-* 优化卫戍协议流程 @ABA2396
-* 调整小游戏描述 @ABA2396
+* 配置迁移自动为启用备选且首个关卡为剿灭模式的刷理智任务自动添加额外的刷理智任务 @status102
+* 忽略干员属性要求 不再允许跳过精英化要求 (#15697) @status102 @Constrat @HX3N
 
 ### 修复 | Fix
 
-* 修复宿舍确认按钮识别（yj 的小杯 UI） @ABA2396
-* 修复 PV 小游戏进入关卡时遇到网络连接会少选烟花样片 @ABA2396
-* 修复 MaaCore 异常日志基址解析 @status102
-* 修复 Windows 平台的 pdb 文件压缩 @status102
-
-### 其他 | Other
-
-* Debug 截图默认保存最近 10 张 @ABA2396
-* 繁中服「眾生行記」活動導航 @momomochi987
-* 繁中服「爭鋒頻道：青草城」小遊戲 @momomochi987
-
-----
-
-## v5.28.4
-
-### 新增 | New
-
-* 关卡选择验证输入，非当期活动的关卡名会当做未开放关卡 @ABA2396
-* 當左上角進行中活動因太多被折疊時，增加展開領取的狀態判斷 (#14957) @momomochi987
-* UR 活动导航 @ABA2396
-
-### 改进 | Improved
-
-* 优化小游戏任务选择逻辑及提示 (#14951) @Daydreamer114 @ABA2396
-
-### 修复 | Fix
-
-* 繁中服周年月卡領取及贈送單抽的處理錯誤 (#14953) @momomochi987
-* 卫戍协议因网络问题卡在结算界面 @Saratoga-Official
-* 代理失败后等待动画结束后再点击任务失败 @ABA2396
-* 自定义基建排班使用无人机加速未进驻干员的设施导致卡死 @ABA2396
-* 干员识别异常（荒芜拉普兰德） (#14934) @dikxingmengya
-* issue-checker.yml 中 MacGui 正则不包含 MacGui @Rbqwow
-* 预提交模板优化配置 @Constrat
-
-### 其他 | Other
-
-* 調整繁中服傀影肉鴿能夠選擇的難度 (#14952) @momomochi987
-
-----
-
-## v5.28.5
-
-### 新增 | New
-
-* 支持会客室快捷置入线索与一键赠送重复线索 (#14966) @ABA2396
-* 通知渠道支持钉钉 (#14884) @Kagura-Nanaa
-* 下载日志独立展示，更新设置中新增下载进度提示 @ABA2396
-* LogDebug 宏支持 DEBUG.txt 特性 (#14977) @status102
-
-### 改进 | Improved
-
-* 优化会客室线索识别范围 @ABA2396
-* 优化绑定 @ABA2396
-
-### 修复 | Fix
-
-* 主线/故事集/SideStory 禁用循环次数 @ABA2396
-* 未勾选自动下载时仍提示下载 @ABA2396
+* JP AveMujica event ocr @Manicsteiner
+* EN IS StageRefresh @Constrat
+* i'm kinda stupid @Constrat
+* update refresh node EN IS5 @Constrat
+* EN IS fix trader store templates AGAIN @Constrat
+* EN Yu OCR for Yutenji @Constrat
+* 自动编队选择技能时点击到技能描述/技能范围 @status102
+* 自动编队期间如有干员属性要求被忽略, 则禁用自动化投票 @status102
 
 ### 文档 | Docs
 
-* 自动战斗编队注释 @ABA2396
-* 更新基建会客室线索相关文档 @ABA2396
+* 更新 api 链接 @ABA2396
 
 ### 其他 | Other
 
-* 模板优化 @Constrat
-* YostarKR CharsNameOcrReplace remove space @ABA2396
+* UserAdditional 非 json 格式返回原始字符串 @status102
+* 使用屏幕宽高常量代替硬编码 @status102
+* 屏幕外的干员跳过技能就绪检测 @status102
+* 調整繁中服界園肉鴿 OCR (2/?) @momomochi987
+* color [INF] for smoke testing as well @Constrat
+* 调整单字干员正则 @ABA2396
+* 調整繁中服界園肉鴿 OCR (#15678) @momomochi987
+* 删除干员名开头/末尾的_<> @ABA2396
+* 添加响石、赤刃明霄陈基建技能加成 (#15674) @drway
+* 保全派驻自动战斗使用二值化结果识别干员名 @ABA2396
+* 删除无用的正则替换 @ABA2396
+* 自动战斗使用二值化结果识别干员名 @ABA2396
+* 仅在 VS Code 中添加辅助项目 (#15669) @status102
+* JP OperNameAnalyzer specialParams @Manicsteiner
+
+## v6.3.0
+
+### 新增 | New
+
+* 支持 PC 端明日方舟 (#15407) @MistEO @ABA2396
+* SideStory「辞岁行」导航及地图数据更新 @SherkeyXD @status102
+* 界园肉鸽 DLC 2 分队更新、通宝数据更新、可选难度提高至 18、支持指定种子开局 (#15588) @SherkeyXD @status102 @HX3N @Manicsteiner
+* 繁中服界園肉鴿初步適配 (#15605) @momomochi987
+* 干员识别支持显示精英化、等级与潜能 @ABA2396
+* 自动编队识别精英化、等级及模组要求 (#15161) @status102 @Manicsteiner @Constrat @HX3N
+* 芯片本支持显示库存数量 @ABA2396
+* 新增注入弹窗不再提醒的勾选框，勾选后使用软件渲染 @ABA2396
+* WpfGui 清空缓存按钮 (#15582) @soundofautumn @Constrat @HX3N @momomochi987
+* 自定干员名称无效时的错误处理及本地化支持 (#15556) @yali-hzy @HX3N
+* 设置指引增加右键重命名/删除提示 @ABA2396
+* 新 Config 加载时移除旧 Config 中不存在的配置 @status102
+* 日志中额外记录 TaskChain 与 taskId ~~免得有人把 Fight 改成开始唤醒~~ @ABA2396
+* YostarEN/JP/KR Dreamland、JieGarden 和 AveMujica 主题支持 @Constrat @Manicsteiner @HX3N
+
+### 改进 | Improved
+
+* Wpf 一键长草任务配置重构，支持添加多个同类型任务、重命名和周计划设置 (#15385) @status102 @ABA2396 @momomochi987 @HX3N
+* 刷理智过期关卡逻辑/样式优化 @status102 @ABA2396
+* 关卡候选列表刷新及关卡选择下拉列表刷新 (#15562) @status102 @HX3N @Constrat @Manicsteiner @momomochi987
+* 优化自动战斗界面布局 (#15512) @yali-hzy
+* 优化任务设置按钮悬浮提示 @ABA2396
+* 优化设置右键菜单布局 @ABA2396
+* 优化干员识别、仓库识别显示 @ABA2396
+* 配置迁移检查优化与简化 @status102 @ABA2396
+* 开始唤醒任务未设置账号切换时，禁用手动切换按钮 @status102
+* 自动战斗掉线重连、自动肉鸽在战斗结束前延迟｢停止｣动作添加多任务共用提示 @ABA2396 @status102
+* 剿灭卡使用到上限时不报错停止 @ABA2396
+* 剿灭关卡通过 ends_with 判断 @ABA2396
+* 刷理智任务高级设置 UI 调整选项顺序和显示优化 @status102
+* 自动战斗自动编队检查`干员等级&精英化`及`技能等级`拆分 @status102
+* 自动战斗不支持技能重置说明中，干员名遵循干员名语言设置 @status102
+* 自动战斗作业列表使用相对路径代替绝对路径 @status102
+* TaskQueue 重命名与移除时显示任务序号 @status102
+* TaskQueue 任务开始&完成显示修改后的任务名 @status102
+* 追加自定干员允许不切换技能 @status102
+* 存在 crash.log 时，Wpf 尝试获取 dumps 文件 (#15432) @status102
+* 移除过时的参数兼容 @status102
+* 消除部分编译警告 (#15578) @yali-hzy
+* NumberOcrReplace 新增规则 (#14186) @Manicsteiner
+
+### 修复 | Fix
+
+* 配置迁移相关问题修复：迁移后切换回原配置、删除配置时未删除 .new、多配置用户删除 Default 配置时迁移异常、剩余理智启用状态和关卡选择迁移问题 @status102 @ABA2396
+* 刷理智任务相关修复：切换刷理智任务时读取错误关卡列表、运行时不允许添加关卡 @status102
+* 自动编队相关修复：识别技能等级匹配失败、干员技能描述过长时点击位置错误、禁用快速选中以修复外服干员技能描述过长的错误选中、干员等级跨精英化时判断出错、干员等级不足 i18n 未启用、干员组干员未解析精英化及等级属性、先兼容旧作业中不合理的技能选择 @status102
+* 公招加速券识别问题修复 @status102
+* LoadApiCache 路径拼接错误 @ABA2396
+* 主线导航及外服主线导航问题修复 @SherkeyXD @ABA2396
+* 在赠送线索时弹出上次线索交流结束的提示时无法返回 @ABA2396
+* 粘贴作业集代码后下方的链接未重置为作业站链接 @ABA2396
+* 修复移动已打开设置的任务后，当前的设置面板无法继续修改的问题 @ABA2396
+* 萨米肉鸽刷开局功能异常 @ABA2396
+* 肉鸽烧水分队切换界面后错误重置 @status102
+* 保证通宝优先级未定义时不会加载崩溃 fallback 到默认值 @SherkeyXD
+* SEH 错误终止运行 @status102
+* 启动 MAA 时若没有任何任务，则追加一套默认任务 @status102
+* 启动客户端绑定失效问题修复 @status102
+* 关卡列表显示不刷新 @status102
+* 选中完成后动作时添加新任务未能隐藏完成后动作设置 UI @status102
+* 刷理智使用源石 CheckBox 勾选后不生效 @status102
+* 退出 MAA 时重置变量不再刷新 UI @status102
+* 初始化 StartEnabled 属性为 true (#15596) @yali-hzy
+* 自动战斗切换活动类型未清空解析缓存 @status102
+* 修复任务出错日志可能晚于任务完成日志显示的问题 @ABA2396
+* 开始干员识别前重置潜能状态 @ABA2396
+* 修复生息演算商店无法正常购买皮肤的问题 (#15585) @drway
+* 手动输入关卡名时，不移除过期关卡 @status102
+* 过期关卡重置模式补充自动迁移 @status102
+* OR 关卡掉落界面关卡名识别问题 @ABA2396
+* EX 关符合时 1 被识别为 | @ABA2396
+* NumberOcrReplace 移除`|`和`/` (#15625) @status102
+* 移除单字干员 ocr 替换中的 +*？避免误判 @Saratoga-Official
+* 涤火杰西卡识别 @ABA2396
+* 日服酒神、見字祠识别 @Saratoga-Official
+* YostarKR Roguelike@ChooseOperConfirm @HX3N
+* YostarKR use ' ' in ocrReplace to preserve '\n' for InfrastTrainingTask @HX3N
+* EN Greyy Alter regex @Constrat
+* EN IS6 encounter @Constrat
+* EN IS TradeInvest templates text font change @Constrat
+* EN IS ShoppingConfirm text font change @Constrat
+* EN refresh node template @Constrat
+* JP AT minigame confirm (#15427) @Manicsteiner
+* JP JieGardenStrategyChange @Saratoga-Official
+* add MaaWin32ControlUnit to nightly build (#15447) @Manicsteiner
+
+### 文档 | Docs
+
+* 集成文档统一格式，同时显示 field-group 和示例代码 (#15409) @ABA2396 @Manicsteiner @Constrat @momomochi987
+* 繁中文件大更新 (#15480) @momomochi987
+* 修正开发文档中的格式错误及笔误 (#15516) @yali-hzy
+* 自动战斗作业文档干员技能值范围补上 0 @status102
+
+### 其他 | Other
+
+* 作业集 Parse 后不删除历史记录，避免错过作业抛出的错误 @ABA2396
+* 辞岁行地图 2026-02-10 Map 更新 @status102
+* 繁中服不上报企鹅物流 @ABA2396
+* devcontainer 适配 CMakePresets.json (#15606) @lucienshawls
+* 移除不再使用的 VirtualizingWrapPanel 与 NoAutomationDataGrid @ABA2396
+* 调整清理图片缓存样式，增加提示 @ABA2396
+* 补全缺少的翻译 @ABA2396
+* 优化 emoji @ABA2396
+* 自动战斗-自动编队干员不支持技能说明国际化 (#15609) @status102 @Constrat @HX3N @Manicsteiner
+* 自动战斗编队技能等级不足 i18n，CN 使用理智药及碎石文案 (#15435) @status102 @HX3N
+* 增加借助战 OF-1 在后续刷理智选择`当前/上次`导致禁用时的输出 (#15478) @status102 @Manicsteiner @Constrat @HX3N @ABA2396 @momomochi987
+* remove regex from `text` field in EN Sui IS @Constrat
+* KR AnnouncementNotFinishedConfirm、ReceptionOptionsRequireInfrast、CreditFightWhenOF-1Warning、MiniGame ConversationRoom and HoneyFruit 支持 @HX3N
+* EN minigame honeyfruit、IS6 tip 支持 @Constrat
+* JP MiniGame HoneyFruit 支持 @Manicsteiner
+* YostarJP ocr fix for roguelike @Manicsteiner
+* manual data for txwy @Constrat
+* optimize templates @Constrat
+* fix casing typo and related context (#15656) @ittuann @Daydreamer114

CMakeLists.txt

@@ -35,6 +35,13 @@ if(BUILD_WPF_GUI)
     include_external_msproject(MaaWpfGui ${PROJECT_SOURCE_DIR}/src/MaaWpfGui/MaaWpfGui.csproj)
 
     add_dependencies(MaaWpfGui MaaCore)
+    if(DEFINED ENV{VSCODE_PID})
+        add_custom_target(run-MaaWpfGui
+            COMMAND "${CMAKE_BINARY_DIR}/bin/$<CONFIG>/MAA.exe"
+            DEPENDS MaaWpfGui
+            WORKING_DIRECTORY "${CMAKE_BINARY_DIR}/bin/$<CONFIG>"
+        )
+    endif()
 endif()
 
 if(INSTALL_PYTHON)

CMakePresets.json

@@ -0,0 +1,348 @@
+{
+    "version": 10,
+    "cmakeMinimumRequired": {
+        "major": 3,
+        "minor": 23,
+        "patch": 0
+    },
+    "configurePresets": [
+        {
+            "name": "windows-base",
+            "hidden": true,
+            "generator": "Visual Studio 18 2026",
+            "binaryDir": "${sourceDir}/build",
+            "$comment": [
+                "Base for Windows presets; Visual Studio is multi-config (Debug/Release/RelWithDebInfo in same build dir)",
+                "see https://cmake.org/cmake/help/latest/generator/Visual%20Studio%2018%202026.html"
+            ],
+            "cacheVariables": {
+                "BUILD_WPF_GUI": "ON",
+                "BUILD_DEBUG_DEMO": "ON",
+                "INSTALL_RESOURCE": "OFF",
+                "INSTALL_PYTHON": "OFF"
+            },
+            "condition": {
+                "type": "equals",
+                "lhs": "${hostSystemName}",
+                "rhs": "Windows"
+            }
+        },
+        {
+            "name": "linux-base",
+            "hidden": true,
+            "generator": "Ninja Multi-Config",
+            "binaryDir": "${sourceDir}/build",
+            "$comment": [
+                "Base for Linux presets; Ninja is multi-config (Debug/Release/RelWithDebInfo in same build dir)",
+                "see https://cmake.org/cmake/help/latest/generator/Ninja%20Multi-Config.html",
+                "clangd uses compile_commands.json to provide code completion and navigation",
+                "so CMAKE_EXPORT_COMPILE_COMMANDS is set to ON",
+                "see https://clangd.llvm.org/installation.html"
+            ],
+            "cacheVariables": {
+                "CMAKE_EXPORT_COMPILE_COMMANDS": "ON"
+            },
+            "condition": {
+                "type": "equals",
+                "lhs": "${hostSystemName}",
+                "rhs": "Linux"
+            }
+        },
+        {
+            "name": "macos-base",
+            "hidden": true,
+            "generator": "Ninja Multi-Config",
+            "binaryDir": "${sourceDir}/build",
+            "$comment": [
+                "Base for macOS presets; Ninja is multi-config (Debug/Release/RelWithDebInfo in same build dir)",
+                "see https://cmake.org/cmake/help/latest/generator/Ninja%20Multi-Config.html",
+                "clangd uses compile_commands.json to provide code completion and navigation",
+                "so CMAKE_EXPORT_COMPILE_COMMANDS is set to ON",
+                "see https://clangd.llvm.org/installation.html"
+            ],
+            "cacheVariables": {
+                "CMAKE_EXPORT_COMPILE_COMMANDS": "ON"
+            },
+            "condition": {
+                "type": "equals",
+                "lhs": "${hostSystemName}",
+                "rhs": "Darwin"
+            }
+        },
+        {
+            "name": "windows-x64",
+            "inherits": "windows-base",
+            "displayName": "Windows x64",
+            "architecture": "x64",
+            "cacheVariables": {
+                "MAADEPS_TRIPLET": "maa-x64-windows"
+            }
+        },
+        {
+            "name": "windows-arm64",
+            "inherits": "windows-base",
+            "displayName": "Windows arm64",
+            "architecture": "ARM64",
+            "cacheVariables": {
+                "MAADEPS_TRIPLET": "maa-arm64-windows"
+            }
+        },
+        {
+            "name": "linux-x64",
+            "inherits": "linux-base",
+            "displayName": "Linux x64",
+            "toolchainFile": "src/MaaUtils/MaaDeps/cmake/maa-x64-linux-toolchain.cmake",
+            "cacheVariables": {
+                "MAADEPS_TRIPLET": "maa-x64-linux"
+            }
+        },
+        {
+            "name": "linux-arm64",
+            "inherits": "linux-base",
+            "displayName": "Linux arm64",
+            "toolchainFile": "src/MaaUtils/MaaDeps/cmake/maa-arm64-linux-toolchain.cmake",
+            "cacheVariables": {
+                "MAADEPS_TRIPLET": "maa-arm64-linux"
+            }
+        },
+        {
+            "name": "macos-arm64",
+            "inherits": "macos-base",
+            "displayName": "macOS arm64",
+            "cacheVariables": {
+                "CMAKE_OSX_ARCHITECTURES": "arm64"
+            }
+        },
+        {
+            "name": "macos-x64",
+            "inherits": "macos-base",
+            "displayName": "macOS x64",
+            "cacheVariables": {
+                "CMAKE_OSX_ARCHITECTURES": "x86_64"
+            }
+        },
+        {
+            "name": "publish-base",
+            "$comment":[
+                "All the name contains 'publish' are used for github actions",
+                "see .github/workflows/ci.yml"
+            ],
+            "hidden": true,
+            "installDir": "install",
+            "cacheVariables": {
+                "CMAKE_BUILD_TYPE": "RelWithDebInfo",
+                "INSTALL_RESOURCE": "ON",
+                "INSTALL_PYTHON": "ON",
+                "BUILD_WPF_GUI": "OFF",
+                "BUILD_DEBUG_DEMO": "OFF"
+            }
+        },
+        {
+            "name": "windows-publish-x64",
+            "inherits": ["publish-base", "windows-x64"],
+            "$comment": [
+                "github actions only support Visual Studio 17 2022",
+                "see https://github.com/actions/runner-images/issues/13291"
+            ],
+            "generator": "Visual Studio 17 2022",
+            "displayName": "Windows x64 Publish"
+        },
+        {
+            "name": "windows-publish-arm64",
+            "inherits": ["publish-base", "windows-arm64"],
+            "$comment": [
+                "github actions only support Visual Studio 17 2022",
+                "see https://github.com/actions/runner-images/issues/13291"
+            ],
+            "generator": "Visual Studio 17 2022",
+            "displayName": "Windows arm64 Publish"
+        },
+        {
+            "name": "linux-publish-x64",
+            "inherits": ["publish-base", "linux-x64"],
+            "displayName": "Linux x64 Publish"
+        },
+        {
+            "name": "linux-publish-arm64",
+            "inherits": ["publish-base", "linux-arm64"],
+            "displayName": "Linux arm64 Publish"
+        },
+        {
+            "name": "macos-publish-x64",
+            "inherits": ["publish-base", "macos-x64"],
+            "displayName": "macOS x64 Publish"
+        },
+        {
+            "name": "macos-publish-arm64",
+            "inherits": ["publish-base", "macos-arm64"],
+            "displayName": "macOS arm64 Publish"
+        },
+        {
+            "name": "smoke-test",
+            "$comment":[
+                "this preset is used for smoke testing",
+                "see .github/workflows/smoke-testing.yml"
+            ],
+            "inherits": "macos-arm64",
+            "displayName": "macOS arm64 Smoke Test",
+            "installDir": "install",
+            "cacheVariables": {
+                "BUILD_SMOKE_TEST": "ON",
+                "INSTALL_RESOURCE": "ON",
+                "WITH_HASH_VERSION": "ON"
+            }
+        }
+    ],
+    "buildPresets": [
+        {
+            "name": "windows-x64-Debug",
+            "displayName": "Build Windows x64 Debug",
+            "configurePreset": "windows-x64",
+            "configuration": "Debug"
+        },
+        {
+            "name": "windows-x64-Release",
+            "displayName": "Build Windows x64 Release",
+            "configurePreset": "windows-x64",
+            "configuration": "Release"
+        },
+        {
+            "name": "windows-x64-RelWithDebInfo",
+            "displayName": "Build Windows x64 RelWithDebInfo",
+            "configurePreset": "windows-x64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "windows-arm64-Debug",
+            "displayName": "Build Windows arm64 Debug",
+            "configurePreset": "windows-arm64",
+            "configuration": "Debug"
+        },
+        {
+            "name": "windows-arm64-Release",
+            "displayName": "Build Windows arm64 Release",
+            "configurePreset": "windows-arm64",
+            "configuration": "Release"
+        },
+        {
+            "name": "windows-arm64-RelWithDebInfo",
+            "displayName": "Build Windows arm64 RelWithDebInfo",
+            "configurePreset": "windows-arm64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "linux-x64-Debug",
+            "displayName": "Build Linux x64 Debug",
+            "configurePreset": "linux-x64",
+            "configuration": "Debug"
+        },
+        {
+            "name": "linux-x64-Release",
+            "displayName": "Build Linux x64 Release",
+            "configurePreset": "linux-x64",
+            "configuration": "Release"
+        },
+        {
+            "name": "linux-x64-RelWithDebInfo",
+            "displayName": "Build Linux x64 RelWithDebInfo",
+            "configurePreset": "linux-x64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "linux-arm64-Debug",
+            "displayName": "Build Linux arm64 Debug",
+            "configurePreset": "linux-arm64",
+            "configuration": "Debug"
+        },
+        {
+            "name": "linux-arm64-Release",
+            "displayName": "Build Linux arm64 Release",
+            "configurePreset": "linux-arm64",
+            "configuration": "Release"
+        },
+        {
+            "name": "linux-arm64-RelWithDebInfo",
+            "displayName": "Build Linux arm64 RelWithDebInfo",
+            "configurePreset": "linux-arm64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "macos-x64-Debug",
+            "displayName": "Build macOS x64 Debug",
+            "configurePreset": "macos-x64",
+            "configuration": "Debug"
+        },
+        {
+            "name": "macos-x64-Release",
+            "displayName": "Build macOS x64 Release",
+            "configurePreset": "macos-x64",
+            "configuration": "Release"
+        },
+        {
+            "name": "macos-x64-RelWithDebInfo",
+            "displayName": "Build macOS x64 RelWithDebInfo",
+            "configurePreset": "macos-x64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "macos-arm64-Debug",
+            "displayName": "Build macOS arm64 Debug",
+            "configurePreset": "macos-arm64",
+            "configuration": "Debug"
+        },
+        {
+            "name": "macos-arm64-Release",
+            "displayName": "Build macOS arm64 Release",
+            "configurePreset": "macos-arm64",
+            "configuration": "Release"
+        },
+        {
+            "name": "macos-arm64-RelWithDebInfo",
+            "displayName": "Build macOS arm64 RelWithDebInfo",
+            "configurePreset": "macos-arm64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "windows-publish-x64",
+            "displayName": "Build Windows x64 Publish",
+            "configurePreset": "windows-publish-x64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "windows-publish-arm64",
+            "displayName": "Build Windows arm64 Publish",
+            "configurePreset": "windows-publish-arm64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "linux-publish-x64",
+            "displayName": "Build Linux x64 Publish",
+            "configurePreset": "linux-publish-x64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "linux-publish-arm64",
+            "displayName": "Build Linux arm64 Publish",
+            "configurePreset": "linux-publish-arm64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "macos-publish-x64",
+            "displayName": "Build macOS x64 Publish",
+            "configurePreset": "macos-publish-x64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "macos-publish-arm64",
+            "displayName": "Build macOS arm64 Publish",
+            "configurePreset": "macos-publish-arm64",
+            "configuration": "RelWithDebInfo"
+        },
+        {
+            "name": "smoke-test",
+            "displayName": "Build macOS arm64 Smoke Test",
+            "configurePreset": "smoke-test",
+            "configuration": "Debug"
+        }
+    ]
+}

README.md

@@ -46,7 +46,7 @@ MAA 的意思是 MAA Assistant Arknights
 
 ## 亮点功能
 
-- 刷理智，掉落识别及上传 [企鹅物流](https://penguin-stats.cn/)，[一图流](https://ark.yituliu.cn/)
+- 理智作战，掉落识别及上传 [企鹅物流](https://penguin-stats.cn/)，[一图流](https://ark.yituliu.cn/)
 - 智能基建换班，自动计算干员效率，单设施内最优解；同时也支持 [自定义排班](https://docs.maa.plus/zh-cn/protocol/base-scheduling-schema.html)
 - 自动公招，可选使用加急许可，一次全部刷完！公招数据自动上传 [企鹅物流](https://penguin-stats.cn/result/stage/recruit/recruit)，[一图流](https://ark.yituliu.cn/survey/maarecruitdata)
 - 支持手动识别公招界面，方便对高星公招做出选择 ~~（你的这个高资回费出的是推王呢还是推王呢）~~

SECURITY.md

@@ -2,11 +2,11 @@
 
 ## 受支持的版本 / Supported Versions
 
-我们仅对 v5 的最新稳定版提供安全支持，如有安全问题，我们将会尽可能快地发布新的稳定版解决。
+我们仅对 v6 的最新稳定版提供安全支持，如有安全问题，我们将会尽可能快地发布新的稳定版解决。
 
 内测版、公测版仅供测试，我们不会对其提供安全支持。
 
-We only provide security support for the latest Stable Release versions of v5. If there are security issues, we will release a new stable version as soon as possible to solve them.
+We only provide security support for the latest Stable Release versions of v6. If there are security issues, we will release a new stable version as soon as possible to solve them.
 
 The Nightly Release version and the Beta Release version are for testing only, and we will not provide security support for them.
 

cmake/macos.cmake

@@ -1,33 +1,81 @@
 if (BUILD_XCFRAMEWORK)
-    add_custom_command(OUTPUT MaaCore.xcframework
-        COMMAND rm -rf MaaCore.xcframework
-        COMMAND xcodebuild -create-xcframework -library libMaaCore.dylib -headers ${PROJECT_SOURCE_DIR}/include -output MaaCore.xcframework
+    set(XCFRAMEWORK_DIR "${CMAKE_BINARY_DIR}/xcframework")
+    file(MAKE_DIRECTORY ${XCFRAMEWORK_DIR})
+
+    # Macro to find a unique library file
+    macro(find_unique_library lib_name glob_pattern output_var)
+        file(GLOB _libs CONFIGURE_DEPENDS "${MAADEPS_DIR}/runtime/${MAADEPS_TRIPLET}/${glob_pattern}")
+        if(_libs)
+            list(LENGTH _libs _cnt)
+            if(_cnt EQUAL 1)
+                list(GET _libs 0 ${output_var})
+                message(STATUS "Found ${lib_name}: ${${output_var}}")
+            else()
+                message(FATAL_ERROR "Ambiguous ${lib_name} dylibs: ${_libs}")
+            endif()
+        else()
+            message(FATAL_ERROR "${lib_name} library not found in ${MAADEPS_DIR}/runtime/${MAADEPS_TRIPLET}/")
+        endif()
+    endmacro()
+
+    add_custom_command(OUTPUT ${XCFRAMEWORK_DIR}/MaaCore.xcframework
+        COMMAND ${CMAKE_COMMAND} -E rm -rf "${XCFRAMEWORK_DIR}/MaaCore.xcframework"
+        COMMAND xcodebuild -create-xcframework 
+            -library $<TARGET_FILE:MaaCore> 
+            -headers ${PROJECT_SOURCE_DIR}/include 
+            -output MaaCore.xcframework
         DEPENDS MaaCore
+        WORKING_DIRECTORY ${XCFRAMEWORK_DIR}
+        COMMENT "Generating MaaCore.xcframework"
     )
     
-    add_custom_command(OUTPUT MaaUtils.xcframework
-        COMMAND rm -rf MaaUtils.xcframework
-        COMMAND xcodebuild -create-xcframework -library libMaaUtils.dylib -output MaaUtils.xcframework
+    add_custom_command(OUTPUT ${XCFRAMEWORK_DIR}/MaaUtils.xcframework
+        COMMAND ${CMAKE_COMMAND} -E rm -rf "${XCFRAMEWORK_DIR}/MaaUtils.xcframework"
+        COMMAND xcodebuild -create-xcframework 
+            -library $<TARGET_FILE:MaaUtils> 
+            -output MaaUtils.xcframework
         DEPENDS MaaUtils
+        WORKING_DIRECTORY ${XCFRAMEWORK_DIR}
+        COMMENT "Generating MaaUtils.xcframework"
     )
 
-    add_custom_command(OUTPUT OpenCV.xcframework
-        COMMAND rm -rf OpenCV.xcframework
-        COMMAND xcodebuild -create-xcframework -library "${MAADEPS_DIR}/runtime/${MAADEPS_TRIPLET}/libopencv_world4.408.dylib" -output OpenCV.xcframework
+    find_unique_library("OpenCV" "libopencv_world*.dylib" OPENCV_LIB)
+    add_custom_command(OUTPUT ${XCFRAMEWORK_DIR}/OpenCV.xcframework
+        COMMAND ${CMAKE_COMMAND} -E rm -rf "${XCFRAMEWORK_DIR}/OpenCV.xcframework"
+        COMMAND xcodebuild -create-xcframework 
+            -library "${OPENCV_LIB}" 
+            -output OpenCV.xcframework
+        WORKING_DIRECTORY ${XCFRAMEWORK_DIR}
+        COMMENT "Generating OpenCV.xcframework"
     )
 
-    add_custom_command(OUTPUT ONNXRuntime.xcframework
-        COMMAND rm -rf ONNXRuntime.xcframework
-        COMMAND xcodebuild -create-xcframework -library "${MAADEPS_DIR}/runtime/${MAADEPS_TRIPLET}/libonnxruntime.1.18.0.dylib" -output ONNXRuntime.xcframework
+    find_unique_library("ONNXRuntime" "libonnxruntime*.dylib" ONNXRUNTIME_LIB)
+    add_custom_command(OUTPUT ${XCFRAMEWORK_DIR}/ONNXRuntime.xcframework
+        COMMAND ${CMAKE_COMMAND} -E rm -rf "${XCFRAMEWORK_DIR}/ONNXRuntime.xcframework"
+        COMMAND xcodebuild -create-xcframework 
+            -library "${ONNXRUNTIME_LIB}" 
+            -output ONNXRuntime.xcframework
+        WORKING_DIRECTORY ${XCFRAMEWORK_DIR}
+        COMMENT "Generating ONNXRuntime.xcframework"
     )
 
-    add_custom_command(OUTPUT fastdeploy_ppocr.xcframework
-        COMMAND rm -rf fastdeploy_ppocr.xcframework
-        COMMAND xcodebuild -create-xcframework -library "${MAADEPS_DIR}/runtime/${MAADEPS_TRIPLET}/libfastdeploy_ppocr.dylib" -output fastdeploy_ppocr.xcframework
+    add_custom_command(OUTPUT ${XCFRAMEWORK_DIR}/fastdeploy_ppocr.xcframework
+        COMMAND ${CMAKE_COMMAND} -E rm -rf "${XCFRAMEWORK_DIR}/fastdeploy_ppocr.xcframework"
+        COMMAND xcodebuild -create-xcframework 
+            -library "${MAADEPS_DIR}/runtime/${MAADEPS_TRIPLET}/libfastdeploy_ppocr.dylib" 
+            -output fastdeploy_ppocr.xcframework
+        WORKING_DIRECTORY ${XCFRAMEWORK_DIR}
+        COMMENT "Generating fastdeploy_ppocr.xcframework"
     )
 
     add_custom_target(MaaXCFramework ALL
-        DEPENDS MaaCore MaaCore.xcframework MaaUtils MaaUtils.xcframework OpenCV.xcframework ONNXRuntime.xcframework fastdeploy_ppocr.xcframework
+        DEPENDS 
+            MaaCore 
+            ${XCFRAMEWORK_DIR}/MaaCore.xcframework 
+            MaaUtils 
+            ${XCFRAMEWORK_DIR}/MaaUtils.xcframework 
+            ${XCFRAMEWORK_DIR}/OpenCV.xcframework 
+            ${XCFRAMEWORK_DIR}/ONNXRuntime.xcframework 
+            ${XCFRAMEWORK_DIR}/fastdeploy_ppocr.xcframework
     )
 endif (BUILD_XCFRAMEWORK)
-

cmake/utils.cmake

@@ -12,7 +12,7 @@ function(create_resource_link TARGET_NAME OUTPUT_DIR)
             COMMENT "Creating junction for resource directory for ${TARGET_NAME}"
         )
     else()
-        # Unix/Linux/macOS 使用符号链接
+        # UNIX/Linux/macOS 使用符号链接
         add_custom_command(
             TARGET ${TARGET_NAME}
             POST_BUILD

docs/.vuepress/plugins/search.ts

@@ -2,7 +2,7 @@ export default {
   provider: 'algolia' as const,
   appId: '9ARM1N4899',
   apiKey: 'f42bf1d18c786d5a46da30eccac5cb34',
-  indexName: 'maa',
+  indexName: 'MaaAssistantArknights',
   locales: {
     '/zh-cn/': {
       placeholder: '搜索',

docs/en-us/develop/development.md

@@ -15,7 +15,7 @@ You can [Ask DeepWiki](https://deepwiki.com/MaaAssistantArknights/MaaAssistantAr
 
 ## I don't know programming but just want to modify some JSON files/documents, how can I do it?
 
-Welcome to the [Web-based PR Tutorial](./pr-tutorial.md) that anyone can understand (purely web-based on Github.com)
+Welcome to the [Web-based PR Tutorial](./pr-tutorial.md) that anyone can understand (purely web-based on GitHub.com)
 
 ## I want to make simple modifications to a few lines of code, but configuring the environment is too tedious and pure web editing is difficult to use. What should I do?
 
@@ -58,32 +58,44 @@ We've preset several different development environments for you to choose from:
    ```
 
 5. Configure development environment
-   - Download and install `Visual Studio 2022 Community`, selecting `Desktop development with C++` and `.NET Desktop Development` during installation.
+   - Download and install `CMake`
+   - Download and install `Visual Studio 2026 Community`, selecting `Desktop development with C++` and `.NET Desktop Development` during installation.
 
-6. Double-click `MAA.sln` to open the project in Visual Studio.
-7. Configure Visual Studio settings
-   - Select `RelWithDebInfo` and `x64` in the top configuration bar (Skip for Release builds or ARM platforms)
-   - Right-click `MaaWpfGui` → Properties → Debug → Enable native debugging (This enables breakpoints in C++ Core)
+6. Execute cmake project configuration
 
-8. Now you're ready to happily ~~mess around~~ start developing!
-9. Commit regularly with meaningful messages during development  
-   If you're not familiar with git usage, you might want to create a new branch for changes instead of committing directly to `dev`:
-
-   ```bash
-   git branch your_own_branch
-   git checkout your_own_branch
+   ```cmd
+   cmake --preset windows-x64
    ```
 
-   This keeps your changes isolated from upstream `dev` updates.
+7. Double-click `build/MAA.slnx` to open the project in Visual Studio.
+8. Configure Visual Studio settings
+   - Select `Debug` and `x64` in the top configuration bar
+   - Right-click `MaaWpfGui` - Set as Startup Project
+   - Press F5 to run
 
-10. After development, push your local branch (e.g. `dev`) to your remote repository:
+   ::: tip
+   To debug Win32Controller (Windows window control) features, you need to manually download the corresponding platform package from [MaaFramework Releases](https://github.com/MaaXYZ/MaaFramework/releases), and place `MaaWin32ControlUnit.dll` from the `bin` directory into MAA's DLL directory (e.g. `build/bin/Debug`). PRs for an auto-download script are welcome!
+   :::
+
+9. Now you're ready to happily ~~mess around~~ start developing!
+10. Commit regularly with meaningful messages during development  
+    If you're not familiar with git usage, you might want to create a new branch for changes instead of committing directly to `dev`:
+
+    ```bash
+    git branch your_own_branch
+    git checkout your_own_branch
+    ```
+
+    This keeps your changes isolated from upstream `dev` updates.
+
+11. After development, push your local branch (e.g. `dev`) to your remote repository:
 
     ```bash
     git push origin dev
     ```
 
-11. Submit a Pull Request at the [MAA main repository](https://github.com/MaaAssistantArknights/MaaAssistantArknights). Ensure your changes are based on the `dev` branch, not `master`.
-12. To sync upstream changes:
+12. Submit a Pull Request at the [MAA main repository](https://github.com/MaaAssistantArknights/MaaAssistantArknights). Ensure your changes are based on the `dev` branch, not `master`.
+13. To sync upstream changes:
     1. Add upstream repository:
 
        ```bash
@@ -108,12 +120,48 @@ We've preset several different development environments for you to choose from:
        git merge # merge
        ```
 
-    4. Repeat steps 7, 8, 9, 10.
+    4. Repeat steps 8, 9, 10, 11.
 
 ::: tip
 After opening Visual Studio, Git operations can be performed using VS's built-in "Git Changes" instead of command-line tools.
 :::
 
+## Using VS Code for Development (Optional)
+
+::: warning
+**Visual Studio is the recommended IDE for development.** The MAA project is primarily built around Visual Studio, and the complete environment setup described above covers all development needs with the best out-of-the-box experience. The VS Code workflow is provided only as an alternative for developers already familiar with VS Code + CMake + clangd, and requires more configuration effort.
+:::
+
+If you prefer VS Code, you can use CMake, clangd, and related extensions for code completion, navigation, and debugging. After completing steps 1–6 above (clone, dependencies, CMake configuration), follow these steps:
+
+### Recommended Extensions
+
+Install from the VS Code marketplace:
+
+| Extension                                                                                           | Purpose                                                    |
+| --------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| [CMake Tools](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cmake-tools)            | CMake configure, build, and debug integration              |
+| [clangd](https://marketplace.visualstudio.com/items?itemName=llvm-vs-code-extensions.vscode-clangd) | C++ IntelliSense, code navigation, diagnostics (LSP-based) |
+| [C/C++](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools)                     | Debug C++ programs (works with CMake Tools or launch.json) |
+
+::: tip
+When using clangd, set `C_Cpp.intelliSenseEngine` to `disabled` to avoid conflicts with the C/C++ extension's IntelliSense.
+:::
+
+### Setup Steps
+
+1. Open the project root folder in VS Code
+2. **CMake Tools**:
+   - Select a Configure Preset from the status bar (e.g. `windows-x64`, `linux-x64`)
+   - Select a Build Preset and run configure/build
+3. **clangd**: Works on Windows with MSVC without needing `compile_commands.json`. On Linux/macOS, presets enable `CMAKE_EXPORT_COMPILE_COMMANDS` and clangd uses `build/compile_commands.json` automatically
+4. **Debugging**: The project includes `.vscode/launch.json` for launching MaaWpfGui or Debug Demo
+
+### Build and Debug Shortcuts
+
+- **Build**: `Ctrl+Shift+B` or via CMake Tools status bar
+- **Debug**: F5 or choose a configuration from the Run and Debug panel
+
 ## MAA File Formatting Requirements
 
 MAA uses a series of formatting tools to ensure that the code and resource files in the repository are visually unified for easy maintenance and reading.
@@ -125,7 +173,7 @@ The currently enabled formatting tools are as follows:
 | File Type | Format Tool                                                     |
 | --------- | --------------------------------------------------------------- |
 | C++       | [clang-format](https://clang.llvm.org/docs/ClangFormat.html)    |
-| Json/Yaml | [Prettier](https://prettier.io/)                                |
+| JSON/YAML | [Prettier](https://prettier.io/)                                |
 | Markdown  | [markdownlint](https://github.com/DavidAnson/markdownlint-cli2) |
 
 ### Use Pre-commit Hooks to Automatically Format Code

docs/en-us/develop/vsc-ext-tutorial.md

@@ -3,14 +3,23 @@ order: 8
 icon: iconoir:code-brackets
 ---
 
-# Dedicated VSCode Extension Tutorial
+# Dedicated VS Code Extension Tutorial
 
-- [Extension Store](https://marketplace.visualstudio.com/items?itemName=nekosu.maa-support)
-- [Repository](https://github.com/neko-para/maa-support-extension)
+The extension provides a series of convenient development capabilities for MaaAssistantArknights/MaaFramework, including but not limited to the following features:
+
+- tasks.json support, including `template preview`, `next jump`, `task reference`, etc.
+- Screenshot / Crop image
+
+For details, please visit [Extension Store](https://marketplace.visualstudio.com/items?itemName=nekosu.maa-support) or [Repository](https://github.com/neko-para/maa-support-extension).
 
 ## Installation
 
-Searching `Maa` and installing it from VSCode extensions list is recommended.
+Searching `Maa` and installing it from VS Code extensions list is recommended.
+
+::: tip
+When used for the first time, the extension will automatically download the preset version of resources.
+Search command `Maa: select fetch registry` to switch the download source (npm / cnpm).
+:::
 
 ## Features
 
@@ -36,7 +45,9 @@ If you find that the editing json isn't hinted by the extension, please check if
 
 The extension supports Jump to task defs, Jump to task refs and View task defs.
 
-When enabling the `Maa` compatible mode, the extension will be able to parse `template task`, supporting querying task defs and task refs in conjunction with base tasks. Images that has the same name of the task will be shown when hovering the task defs.
+When enabling the `Maa` compatible mode, the extension will be able to parse `template task`, supporting querying task defs and task refs in conjunction with base tasks. Images that have the same name as the task will be shown when hovering the task defs.
+
+Use `Ctrl+T` to quickly query and jump to a task definition.
 
 #### Query / open images
 
@@ -77,17 +88,37 @@ Evaluating the expanded task object and the sources of each properties, and the
 
 Scanning and selecting controllers, selecting resource, adding and manipulating tasks, and launching tasks can be done via the control panel.
 
-### Take screenshots and crop images
+### Take screenshots and crop images / Quick recognition
 
-Searching and launching `Maa: open crop tool` inside VSCode command panel can open `Screenshots / Crop` panel.
+Searching and launching `Maa: open crop tool` inside VS Code command panel can open `Screenshots / Crop` panel.
 
-> Use `Ctrl+Shift+P` (`Command+Shift+P` on MacOS) to open command panel
+> Use `Ctrl+Shift+P` (`Command+Shift+P` on macOS) to open command panel
 
 - After selecting and connecting to the controller, use `Screencap` button to obtain screenshots
 - Use `Upload` button to manually upload images.
 - Hold `Ctrl` key and select cropping area
 - Use wheels to zoom
 - After finishing cropping, use `Download` button to save the cropping result to the folder of the topest layer of the activated resource
+- Use `Copy` button to copy the ROI as an array to the clipboard.
+- Click `Tool` button to open the recognition tool panel, where you can directly test recognition on the current image.
+
+::: warning
+
+If OCR recognition returns an empty result, please check whether the [OCR model](https://github.com/MaaXYZ/MaaFramework/blob/main/docs/en_us/1.1-QuickStarted.md#text-recognition-model-files) is configured correctly.
+
+For MAA, the extension will maintain the models used automatically; you only need to select the proper resource.
+
+:::
+
+### Log View
+
+#### MaaFramework Log
+
+Search and execute `Maa: open maa log` in the VS Code command panel to view the `maa.log` generated during debugging.
+
+#### Maa Pipeline Support Extension Log
+
+Search and execute `Maa: open extension log` in the VS Code command panel to view the `mse.log` generated during debugging.
 
 ### Bottom status bar
 
@@ -95,10 +126,6 @@ Searching and launching `Maa: open crop tool` inside VSCode command panel can op
 
 Click to reveal control panel
 
-#### MaaFramework \[MaaFw Version\]
+#### MaaFramework [MaaFw Version]
 
-Click to switch `MaaFramework` version used by the extension
-
-> When used for the first time, the preset version will be downloaded.
->
-> Search command `Maa: select fetch registry` to switch downloading source (npm / cnpm).
+Click to switch `MaaFramework` version used by the extension. The selectable versions are limited to those supported by the current extension. If the version you need is not in the list, please consider changing the extension version.

docs/en-us/manual/cli/install.md

@@ -3,123 +3,194 @@ order: 1
 icon: material-symbols:download
 ---
 
-# Install and Build
+# Installation and Compilation
 
-There are multiple ways to install maa-cli, including package managers, precompiled binaries, and building from source with `cargo`.
+There are multiple ways to install maa-cli, including pre-compiled binaries, package managers, and building from source with `cargo`.
+
+## Pre-compiled Binaries
+
+The easiest way to install maa-cli is by using the installation script:
+
+::: tabs#pre-compile
+
+@tab:active Linux and macOS
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/MaaAssistantArknights/maa-cli/main/install.sh | bash
+```
+
+@tab Windows (PowerShell)
+
+```powershell
+Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MaaAssistantArknights/maa-cli/main/install.ps1" -OutFile install.ps1; .\install.ps1
+```
+
+:::
+
+You can later update maa-cli by running `maa self update`.
+
+If your platform is not listed above, you can try to [build from source](#build-from-source).
 
 ## Install via Package Manager
 
-For macOS and supported Linux distributions, it is recommended to install maa-cli using a package manager.
+For macOS and supported Linux distributions, you can install maa-cli using a package manager.
 
 ### macOS
 
 Homebrew users can install maa-cli via the unofficial [tap](https://github.com/MaaAssistantArknights/homebrew-tap/):
 
-- Stable release:
+::: code-tabs
 
-  ```bash
-  brew install MaaAssistantArknights/tap/maa-cli
-  ```
+@tab:active Stable
 
-- Beta releases:
+```bash :no-line-numbers
+brew install MaaAssistantArknights/tap/maa-cli
+```
 
-  ```bash
-  brew install MaaAssistantArknights/tap/maa-cli-beta
-  ```
+@tab Unstable/Pre-release
+
+```bash :no-line-numbers
+brew install MaaAssistantArknights/tap/maa-cli-beta
+```
+
+:::
 
 ### Linux
 
-- Arch Linux users can install the [AUR package](https://aur.archlinux.org/packages/maa-cli/):
+Arch, Nix, and Linux Homebrew users can install maa-cli via their package managers.
 
-  ```bash
-  yay -S maa-cli
-  ```
+#### Arch Linux
 
-- ❄️ Nix users can run directly:
+You can install the [AUR package](https://aur.archlinux.org/packages/maa-cli/):
 
-  ```bash
-  # Stable release
-  nix run nixpkgs#maa-cli
-  ```
+::: code-tabs
 
-  ```bash
-  # Nightly build
-  nix run github:Cryolitia/nur-packages#maa-cli-nightly
-  ```
+@tab:active paru
 
-  Stable is packaged in [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-cli/package.nix), using the nixpkgs Rust toolchain; Nightly is in [NUR](https://github.com/Cryolitia/nur-packages/blob/master/pkgs/maa-assistant-arknights/maa-cli.nix), using the Beta Channel Rust toolchain, automatically updated and built daily by GitHub Actions.
+```bash :no-line-numbers
+paru -S maa-cli
+```
 
-- Users using Homebrew on Linux please refer to the macOS installation method above.
+@tab yay
 
-## Precompiled Binaries
+```bash :no-line-numbers
+yay -S maa-cli
+```
 
-If package managers are not available on your system or you prefer not to use them, you can download the precompiled binaries for your platform from the following links. After decompressing, place the executable file in your `PATH` to use.
+:::
 
-- [macOS](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-universal-apple-darwin.zip)
-- [Linux x86_64 (x64, amd64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-x86_64-unknown-linux-gnu.tar.gz)
-- [Linux aarch64 (arm64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-aarch64-unknown-linux-gnu.tar.gz)
-- [Windows x86_64 (x64, amd64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-x86_64-pc-windows-msvc.zip)
-- [Windows aarch64 (arm64)](https://github.com/MaaAssistantArknights/maa-cli/releases/latest/download/maa_cli-aarch64-pc-windows-msvc.zip)
+#### ❄️ Nix
 
-If your platform is not listed above, you can try to compile and install it yourself (see below).
+Users can run directly:
+
+::: code-tabs
+
+@tab:active Stable
+
+```bash :no-line-numbers
+nix run nixpkgs#maa-cli
+```
+
+@tab Nightly Build
+
+```bash :no-line-numbers
+nix run github:Cryolitia/nur-packages#maa-cli-nightly
+```
+
+:::
+
+The stable version is packaged in [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-cli/package.nix), using the Rust toolchain from `nixpkgs`; the nightly build is in [NUR](https://github.com/Cryolitia/nur-packages/blob/master/pkgs/maa-assistant-arknights/maa-cli.nix), using the Beta channel Rust toolchain, and is automatically updated and verified daily by a GitHub Actions.
+
+#### Homebrew
+
+For users who use Homebrew on Linux, please refer to the macOS installation method.
+
+#### Other Distributions
+
+Please use the [pre-compiled binaries](#pre-compiled-binaries) or [build from source](#build-from-source).
+
+We welcome interested developers to submit maa-cli to the official or user repositories of more distributions!
 
 ## Build from Source
 
-Rust developers can compile and install maa-cli themselves via `cargo`:
+Rust developers can compile and install maa-cli using `cargo`:
 
-- Stable version:
+::: code-tabs
 
-  ```bash
-  cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --tag stable --locked
-  ```
+@tab:active Stable Version
 
-- Development version:
+```bash :no-line-numbers
+cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --tag stable --locked
+```
 
-  ```bash
-  cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --locked
-  ```
+@tab Development Version
 
-### Features
+```bash :no-line-numbers
+cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --locked
+```
 
-When compiling from source, you can disable the default features with `--no-default-features` and then enable specific features with `--features`. The available features are:
+:::
 
-- `cli_installer`: Provide `maa self update` command to update self, this feature is enabled by default;
-- `core_installer`: Provide `maa install` and `maa update` commands to install and update MaaCore and resources, this feature is enabled by default;
-- `git2`: Provide `libgit2` resource backend, this feature is enabled by default;
-- `vendored-openssl`: Build OpenSSL library by self instead of using system library, this feature is disabled by default;
+::: warning
+The Minimum Supported Rust Version (MSRV) for maa-cli is currently 1.88. Please note that the MSRV may change at any time, and we recommend always using the latest Rust toolchain for the best experience.
+:::
 
-## Install MaaCore
+### Build Options
 
-maa-cli only provides an interface for MaaCore, it needs MaaCore and resources to run tasks, which can be installed by maa-cli once it is installed:
+When compiling from source, you can disable default features with `--no-default-features` and then enable specific features with `--features`. The available features are:
 
-```bash
+- `cli_installer`: Enables the `maa self update` command for self-updating. Enabled by default.
+- `core_installer`: Enables the `maa install` and `maa update` commands for installing and updating MaaCore and its resources. Enabled by default.
+- `git2`: Provides the `libgit2` backend for resource updates. Enabled by default.
+
+## Install MaaCore and Resources
+
+maa-cli only provides a command-line interface; it requires MaaCore and resources to run tasks.
+
+Your steps will differ depending on the installation method and platform:
+
+::: tabs#maacore
+
+@tab:active Pre-compiled
+For users of pre-compiled binaries or those who built from source, maa-cli can help you install and update:
+
+```bash :no-line-numbers
 maa install
 ```
 
-For Windows platform users, before running the `maa install` command, please run the following command as administrator in Command Prompt or PowerShell to install the required VC++ toolset:
+@tab Windows
+For Windows users, before running `maa install`, please run the following command as an administrator in Command Prompt or PowerShell to install the necessary VC++ runtime:
 
-- Windows:
+```bat :no-line-numbers
+winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force
+```
 
-  ```bat
-  winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force
-  ```
+Then run `maa install`.
 
-For users who installed via package managers, MaaCore can also be installed via package managers:
+@tab Arch
+You can use maa-cli to install the pre-compiled MaaCore:
 
-- Homebrew：
+```bash :no-line-numbers
+maa install
+```
 
-  ```bash
-  brew install MaaAssistantArknights/tap/maa-core
-  ```
+You can also install maa-core via the [AUR](https://aur.archlinux.org/packages/maa-assistant-arknights/):
 
-- Arch Linux：
+```bash :no-line-numbers
+paru -S maa-assistant-arknights
+```
 
-  ```bash
-  yay -S maa-assistant-arknights
-  ```
+or
 
-- Nix：
+```bash :no-line-numbers
+yay -S maa-assistant-arknights
+```
 
-  maa-cli on Nix depends on the MaaCore package, so no additional installation is required.
+@tab Nix
+maa-cli on Nix has a hard dependency on MaaCore, so Nix users do not need to, and should not, install MaaCore manually.
 
-**NOTE**: Only users who installed maa-cli via package managers can install MaaCore via package managers. Otherwise, please use the `maa install` command to install. In addition, the `maa install` downloads the official precompiled MaaCore, while the MaaCore installed by package managers has different compilation options and dependency versions from the official precompiled version, potentially causing variations in behavior and performance.
+:::
+
+::: warning
+`maa install` downloads the officially pre-compiled MaaCore. MaaCore installed via package managers may use different compile options and dependency versions, which might lead to slight differences in performance and functionality.
+:::

docs/en-us/manual/cli/usage.md

@@ -7,6 +7,12 @@ icon: material-symbols:summarize
 
 maa-cli's main functionality is to automate Arknights game tasks by calling MaaCore. Additionally, for convenience, maa-cli also provides functions to manage MaaCore.
 
+::: tip
+
+For users who installed maa-cli via the Windows Package Manager (winget) , `maa` in the following commands needs to be replaced with `maa-cli` .
+
+:::
+
 ## Manage MaaCore
 
 maa-cli can install and update MaaCore and resources by running the following commands: