diff --git a/docs/en-us/manual/device/linux.md b/docs/en-us/manual/device/linux.md
index 252d4655dc..868f65f7ce 100644
--- a/docs/en-us/manual/device/linux.md
+++ b/docs/en-us/manual/device/linux.md
@@ -15,11 +15,21 @@ Choose one of the following installation methods:
### Using Wine
-The MAA WPF GUI can currently be run through Wine.
+The MAA WPF GUI can currently be run through Wine. MAA now uses self-contained deployment with the .NET runtime included.
#### Installation Steps
-1. Go to the [.NET download page](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) and download/install the Windows version of .NET **Desktop** Runtime.
+1. Install Visual C++ Redistributable:
+
+ Download and install [Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe):
+
+ ```shell
+ wine vc_redist.x64.exe
+ ```
+
+ ::: tip
+ `DependencySetup_依赖库安装.bat` relies on winget and Windows privilege escalation, which typically doesn't work properly in Wine, so manual installation of runtime libraries is required.
+ :::
2. Download the Windows version of MAA, extract it, and run `wine MAA.exe`.
diff --git a/docs/en-us/manual/faq.md b/docs/en-us/manual/faq.md
index 1bd54311d1..ff961d6cba 100644
--- a/docs/en-us/manual/faq.md
+++ b/docs/en-us/manual/faq.md
@@ -12,16 +12,17 @@ If this is your first time using MAA, please read [Getting Started](./newbie.md)
If MAA fails to run after an update, or if you've arrived here from MAA's error window, it's most likely due to outdated runtime libraries.
The most common issue is related to runtime libraries, and many people keep asking about it without reading the documentation, so we changed the pinned message to this. It's frustrating.
+MAA now uses self-contained deployment with the .NET runtime included, but still requires Visual C++ runtime libraries.
+
Please run `DependencySetup_依赖库安装.bat` in the MAA directory, or execute the following command in terminal:
```sh
-winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
+winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
```
-Or manually download and install these **two** runtime libraries to solve the problem:
+Or manually download and install this runtime library to solve the problem:
- [Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe)
-- [.NET Desktop Runtime 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
:::
@@ -51,7 +52,7 @@ For Windows N/KN (European/Korean versions), you also need to install the [Media
#### Windows 7/8/8.1
-.NET 10 doesn't support Windows 7/8/8.1 systems[source](https://github.com/dotnet/core/issues/7556), so MAA no longer supports them either.
+Due to runtime libraries and system components requiring Windows 10 or above, MAA no longer supports Windows 7/8/8.1 systems.
## Connection errors
diff --git a/docs/en-us/manual/newbie.md b/docs/en-us/manual/newbie.md
index 04511dbd0e..607393963d 100644
--- a/docs/en-us/manual/newbie.md
+++ b/docs/en-us/manual/newbie.md
@@ -25,7 +25,7 @@ Quick start guide!
4. Install runtime libraries
- MAA requires VCRedist x64 and .NET 10. Please run `DependencySetup_依赖库安装.bat` in the MAA directory to install them.
+ MAA now includes the .NET runtime (self-contained deployment), but still requires VCRedist x64. Please run `DependencySetup_依赖库安装.bat` in the MAA directory to install it.
For more information, please refer to the pinned section in [FAQ](./faq.md).
diff --git a/docs/ja-jp/manual/device/linux.md b/docs/ja-jp/manual/device/linux.md
index 5fb06d1334..f987f07655 100644
--- a/docs/ja-jp/manual/device/linux.md
+++ b/docs/ja-jp/manual/device/linux.md
@@ -7,20 +7,79 @@ icon: teenyicons:linux-alt-solid
## 準備作業
-### 1. MAA をインストールする
+以下のインストール方法から一つを選択してください：
-1. Linux ダイナミック ライブラリを [MAA ウェブサイト](https://maa.plus/) からダウンロードし、解凍します
+### maa-cli を使用する
-2. `./MAA-v{バージョン}-linux-{アアーキテクチャ}/Python/` ディレクトリに移動します、 `sample.py` ファイルを開け
+[maa-cli](https://github.com/MaaAssistantArknights/maa-cli) は Rust で書かれたシンプルな MAA コマンドラインツールです。関連するインストールと使用方法については、[CLI 使用ガイド](../cli/) をご覧ください。
-::: tip
-プリコンパイル済みバージョンには、比較的新しいLinuxディストリビューション(Ubuntu 22.04)でコンパイルされた動的ライブラリが含まれており、システムに古いバージョンのlibstdc++がある場合、ABIの非互換性に遭遇する可能性があります
-[Linuxコンパイル・チュートリアル](../../develop/linux-tutorial.md) を参照して再コンパイルまたはコンテナを使用して実行できます
+### Wine を使用する
+
+MAA WPF GUI は現在 Wine を通じて実行できます。MAAは.NETランタイムを内蔵しています（自己完結型デプロイ）。
+
+#### インストール手順
+
+1. Visual C++ Redistributable をインストールする：
+
+ [Visual C++ 再頒布可能パッケージ](https://aka.ms/vc14/vc_redist.x64.exe) をダウンロードしてインストールします：
+
+ ```shell
+ wine vc_redist.x64.exe
+ ```
+
+ ::: tip
+ `DependencySetup_依赖库安装.bat` は winget と Windows の権限昇格機構に依存しているため、Wine では通常正常に動作しません。そのため、ランタイムライブラリは手動でインストールする必要があります。
+ :::
+
+2. Windows 版 MAA をダウンロードし、解凍した後、`wine MAA.exe` を実行します。
+
+::: info 注意
+接続設定で ADB パスを [Windows 版 `adb.exe`](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) に設定する必要があります。
+
+ADB 経由で USB デバイスに接続する必要がある場合は、まず Wine の外で `adb start-server` を実行し、Wine を通じてネイティブ ADB サーバーに接続してください。
:::
-- Arch Linuxシリーズのリリース版は、aur パッケージ [maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)を選択する使用し、インストール後のプロンプトに従ってファイルを編集することができる
+#### Linux ネイティブ MaaCore の使用（実験的機能）
-### 2. `adb` 構成
+[MAA Wine Bridge](https://github.com/MaaAssistantArknights/MaaAssistantArknights/tree/dev/src/MaaWineBridge) のソースコードをダウンロードしてビルドし、生成された `MaaCore.dll`（ELF ファイル）で Windows 版を置き換え、Linux ネイティブ動的ライブラリ（`libMaaCore.so` および依存関係）を同じディレクトリに配置します。
+
+この状態で Wine を通じて `MAA.exe` を実行すると、Linux ネイティブ動的ライブラリが読み込まれます。
+
+::: info 注意
+Linux ネイティブ MaaCore を使用する場合は、接続設定で ADB パスを Linux ネイティブ ADB に設定する必要があります。
+:::
+
+#### Linux デスクトップ統合（実験的機能）
+
+デスクトップ統合は、ネイティブデスクトップ通知サポートと fontconfig フォント設定を WPF にマッピングする機能を提供します。
+
+MAA Wine Bridge で生成された `MaaDesktopIntegration.so` を `MAA.exe` と同じディレクトリに配置すると有効になります。
+
+#### 既知の問題
+
+- Wine DirectWrite は強制的にヒンティングを有効にし、DPI を FreeType に渡さないため、フォント表示が良くありません。
+- ネイティブデスクトップ通知を使用しない場合、通知がポップアップするとシステム全体のマウスフォーカスを奪うため、他のウィンドウを操作できなくなります。`winecfg` で仮想デスクトップモードを有効にするか、デスクトップ通知を無効にすることで緩和できます。
+- Wine-staging ユーザーは、MAA が Wine 環境を正しく検出できるように、`winecfg` の `Wine バージョンを隠す` オプションを無効にする必要があります。
+- Wine の Light テーマは WPF で一部のテキストカラーに異常を引き起こすため、`winecfg` でテーマなし（Windows クラシックテーマ）に切り替えることをお勧めします。
+- Wine は古い XEmbed トレイアイコンを使用しており、GNOME では正常に動作しない可能性があります。
+- Linux ネイティブ MaaCore を使用している場合、自動更新はサポートされていません（~~更新プログラム：Windows 版をダウンロードすべきでしょうか~~）
+
+### Python を使用する
+
+#### MAA 動的ライブラリのインストール
+
+1. Linux ダイナミック ライブラリを [MAA ウェブサイト](https://maa.plus/) からダウンロードし、解凍します、または以下のソフトウェアリポジトリからインストールします：
+ - AUR：[maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)、インストール後のプロンプトに従ってファイルを編集します
+ - Nixpkgs: [maa-assistant-arknights](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix)
+
+2. `./MAA-v{バージョン}-linux-{アアーキテクチャ}/Python/` ディレクトリに移動し、`sample.py` ファイルを開きます
+
+::: tip
+プリコンパイル済みバージョンには、比較的新しいLinuxディストリビューション(Ubuntu 22.04)でコンパイルされた動的ライブラリが含まれており、システムに古いバージョンのlibstdc++がある場合、ABIの非互換性に遭遇する可能性があります。
+[Linuxコンパイル・チュートリアル](../../develop/linux-tutorial.md) を参照して再コンパイルまたはコンテナを使用して実行できます。
+:::
+
+#### ADB 構成
1. [`if asst.connect('adb.exe', '127.0.0.1:5554'):`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L48) セクションを見つける
@@ -50,9 +109,9 @@ icon: teenyicons:linux-alt-solid
4. この時点で、 `$ python3 sample.py` をテストでき、 `接続成功` が返されれば、基本的に成功です
-### 3. タスク構成
+#### タスク構成
-カストムタスク： 必要に応じて [統合ドキュメント](../../protocol/integration.md) を参照し、 `sample.py` の [`# タスクとパラメーターについては 統合ドキュメント`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更する
+カスタムタスク：必要に応じて [統合ドキュメント](../../protocol/integration.md) を参照し、`sample.py` の [`# タスクとパラメーターについては docs/integration.md 参照`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更します
## エミュレータのサポート
diff --git a/docs/ja-jp/manual/faq.md b/docs/ja-jp/manual/faq.md
index 887ba45306..1136809d56 100644
--- a/docs/ja-jp/manual/faq.md
+++ b/docs/ja-jp/manual/faq.md
@@ -12,16 +12,17 @@ icon: ph:question-fill
MAAがアップデート後に動作しなくなった場合、またはエラーメッセージウィンドウを経由してここにたどり着いた場合、それは大体ランタイムが更新されていないことが原因です。
最も多い問題はランタイム関連であり、それにもかかわらず多くの人がドキュメントを読まずに質問するため、トップメッセージをこれに変更しました。とてもイライラします。
+MAAは.NETランタイムを内蔵しています（自己完結型デプロイ）が、Visual C++ランタイムが必要です。
+
MAAディレクトリ内の `DependencySetup_依赖库安装.bat` を実行するか、以下のコマンドを端末で実行するか、
```sh
-winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
+winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
```
-以下の**2つ**のランタイムライブラリを手動でダウンロードしてインストールして問題を解決してください。
+以下のランタイムライブラリを手動でダウンロードしてインストールして問題を解決してください。
- [Visual C++ 再頒布可能パッケージ](https://aka.ms/vc14/vc_redist.x64.exe)
-- [.NET デスクトップランタイム 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
:::
@@ -51,7 +52,7 @@ Windows N/KN（ヨーロッパ/韓国）の場合、[メディア機能パック
#### Windows 7 / 8 / 8.1 関連
-.NET 10 は Windows 7 / 8 / 8.1 システムをサポートしていないため[ソース](https://github.com/dotnet/core/issues/7556)、MAA も同様にサポートしていません。
+MAA が依存するランタイムライブラリとシステムコンポーネントは Windows 10 以上が必要なため、MAA は Windows 7 / 8 / 8.1 システムをサポートしていません。
#### 公式統合パック（確信）
diff --git a/docs/ja-jp/manual/newbie.md b/docs/ja-jp/manual/newbie.md
index f755943d23..f301234a7a 100644
--- a/docs/ja-jp/manual/newbie.md
+++ b/docs/ja-jp/manual/newbie.md
@@ -23,7 +23,7 @@ icon: ri:guide-fill
4. ランタイムライブラリをインストールする
- MAAはVCRedist x64と.NET 10が必要です。MAAディレクトリ内の `DependencySetup_依赖库安装.bat` を実行してインストールしてください。
+ MAAは.NETランタイムを内蔵しています（自己完結型デプロイ）が、VCRedist x64が必要です。MAAディレクトリ内の `DependencySetup_依赖库安装.bat` を実行してインストールしてください。
5. エミュレータのサポートを確認
diff --git a/docs/ko-kr/manual/device/linux.md b/docs/ko-kr/manual/device/linux.md
index d7d686cd16..485830d1d5 100644
--- a/docs/ko-kr/manual/device/linux.md
+++ b/docs/ko-kr/manual/device/linux.md
@@ -15,11 +15,21 @@ icon: teenyicons:linux-alt-solid
### Wine 사용
-MAA WPF GUI는 현재 Wine을 통해 실행할 수 있습니다.
+MAA WPF GUI는 현재 Wine을 통해 실행할 수 있습니다. MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포).
#### 설치 단계
-1. [.NET 릴리스 페이지](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)에서 Windows용 .NET **데스크톱** 런타임을 다운로드하고 설치합니다.
+1. Visual C++ Redistributable 설치:
+
+ [Visual C++ 재배포 가능 패키지](https://aka.ms/vc14/vc_redist.x64.exe)를 다운로드하고 설치합니다:
+
+ ```shell
+ wine vc_redist.x64.exe
+ ```
+
+ ::: tip
+ `DependencySetup_依赖库安装.bat`는 winget 및 Windows 권한 상승 메커니즘에 의존하므로 Wine에서 정상적으로 작동하지 않습니다. 따라서 런타임 라이브러리를 수동으로 설치해야 합니다.
+ :::
2. Windows용 MAA를 다운로드하고 압축을 푼 후 `wine MAA.exe`를 실행합니다.
diff --git a/docs/ko-kr/manual/faq.md b/docs/ko-kr/manual/faq.md
index dae2021058..2bec323239 100644
--- a/docs/ko-kr/manual/faq.md
+++ b/docs/ko-kr/manual/faq.md
@@ -12,16 +12,17 @@ MAA를 처음 사용하는 경우 [초보자 가이드](./newbie.md)를 읽어
MAA가 업데이트 후 실행되지 않거나 MAA의 오류 창을 통해 여기에 도달했다면, 이는 대부분 실행 라이브러리가 업데이트되지 않은 문제 때문입니다.
가장 자주 발생하는 문제는 실행 라이브러리 문제이며, 많은 사람들이 문서를 읽지 않고 질문만 하기 때문에 공지 내용을 이걸로 교체했습니다.
+MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포). 하지만 Visual C++ 런타임이 필요합니다.
+
MAA 디렉토리에서 `DependencySetup_依赖库安装.bat`를 실행하거나, 터미널에서 아래 명령을 실행하거나,
```sh
-winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
+winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
```
-아래**두 개**의 실행 라이브러리를 수동으로 다운로드하여 설치하여 문제를 해결하세요.
+아래 실행 라이브러리를 수동으로 다운로드하여 설치하여 문제를 해결하세요.
- [Visual C++ 재배포 가능 패키지](https://aka.ms/vc14/vc_redist.x64.exe)
-- [.NET 데스크톱 런타임 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
:::
@@ -51,7 +52,7 @@ Windows 8/8.1/10/11 N/KN(유럽/한국) 버전을 사용하는 경우, [미디
#### Windows 7 / 8 / 8.1 관련
-.NET 10은 Windows 7 / 8 / 8.1 시스템을 지원하지 않으므로[출처](https://github.com/dotnet/core/issues/7556), MAA도 더 이상 지원하지 않습니다.
+MAA가 의존하는 런타임 라이브러리와 시스템 구성 요소가 Windows 10 이상을 필요로 하기 때문에, MAA는 Windows 7 / 8 / 8.1 시스템을 더 이상 지원하지 않습니다.
## 연결 오류
diff --git a/docs/ko-kr/manual/newbie.md b/docs/ko-kr/manual/newbie.md
index 651afcc53f..4477e0f398 100644
--- a/docs/ko-kr/manual/newbie.md
+++ b/docs/ko-kr/manual/newbie.md
@@ -27,7 +27,7 @@ icon: ri:guide-fill
4. 런타임 설치
- MAA는 VCRedist x64 및 .NET 10이 필요합니다. MAA 디렉토리의 `DependencySetup_依赖库安装.bat`를 실행하여 설치하세요.
+ MAA는 .NET 런타임을 내장하고 있습니다(자체 포함 배포). 하지만 VCRedist x64가 필요합니다. MAA 디렉토리의 `DependencySetup_依赖库安装.bat`를 실행하여 설치하세요.
자세한 정보는 [FAQ](./faq.md#런타임-문제)를 참조하세요.
diff --git a/docs/zh-cn/manual/device/linux.md b/docs/zh-cn/manual/device/linux.md
index 0674aba1a7..528416991c 100644
--- a/docs/zh-cn/manual/device/linux.md
+++ b/docs/zh-cn/manual/device/linux.md
@@ -15,11 +15,21 @@ icon: teenyicons:linux-alt-solid
### 使用 Wine
-MAA WPF GUI 当前可以通过 Wine 运行。
+MAA WPF GUI 当前可以通过 Wine 运行。MAA 已采用自包含部署方式，内置了 .NET 运行时。
#### 安装步骤
-1. 前往 [.NET 发布页](https://dotnet.microsoft.com/en-us/download/dotnet/10.0)下载并安装 Windows 版 .NET **桌面**运行时。
+1. 安装 Visual C++ Redistributable：
+
+ 下载并安装 [Visual C++ 可再发行程序包](https://aka.ms/vc14/vc_redist.x64.exe)：
+
+ ```shell
+ wine vc_redist.x64.exe
+ ```
+
+ ::: tip
+ `DependencySetup_依赖库安装.bat` 基于 winget 和 Windows 提权机制，通常无法在 Wine 中正常工作，因此需要手动安装运行库。
+ :::
2. 下载 Windows 版 MAA，解压后运行 `wine MAA.exe`。
diff --git a/docs/zh-cn/manual/faq.md b/docs/zh-cn/manual/faq.md
index 63a7e26588..51015b2d78 100644
--- a/docs/zh-cn/manual/faq.md
+++ b/docs/zh-cn/manual/faq.md
@@ -12,16 +12,17 @@ icon: ph:question-fill
若 MAA 在某次更新后无法运行，或者单纯是从 MAA 的报错窗口来到这的，那八成是由于运行库未更新导致的问题。
出现次数最多的问题都是运行库问题，而总是有人看不到文档到处问，所以我们把置顶换成了这个。很气。
+MAA 已采用自包含部署方式，内置了 .NET 运行时，但仍需要 Visual C++ 运行库。
+
请运行 MAA 目录下的 `DependencySetup_依赖库安装.bat`，或在终端中运行以下命令，
```sh
-winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
+winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
```
-或手动下载并安装以下**两个**运行库来解决问题。
+或手动下载并安装以下运行库来解决问题。
- [Visual C++ 可再发行程序包](https://aka.ms/vc14/vc_redist.x64.exe)
-- [.NET 桌面运行时 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
:::
@@ -51,7 +52,7 @@ winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /nore
#### Windows 7 / 8 / 8.1
-.NET 10 不支持 Windows 7 / 8 / 8.1 系统[源](https://github.com/dotnet/core/issues/7556)，所以 MAA 也同样不再支持。
+由于 MAA 依赖的运行库和系统组件要求 Windows 10 及以上版本，MAA 不再支持 Windows 7 / 8 / 8.1 系统。
## 连接错误
diff --git a/docs/zh-cn/manual/install.md b/docs/zh-cn/manual/install.md
index ff2ee22648..57ef98b024 100644
--- a/docs/zh-cn/manual/install.md
+++ b/docs/zh-cn/manual/install.md
@@ -70,7 +70,7 @@ MAA GUI **暂未支持** Linux 和其他操作系统。你可以使用 **maa-cli
1.请不要将 MAA 解压到如 `C:\`、`C:\Program Files\` 等需要 UAC 权限的路径。
-2.MAA 需要 Visual C++ Redistributable x64（VCRedist x64）和 .NET 10 。请在解压后的 MAA 目录中以管理员身份运行 `DependencySetup_依赖库安装.bat` 来安装这些依赖。安装完成后再运行 `maa.exe`。
+2.MAA 已内置 .NET 运行时（自包含部署），但仍需要 Visual C++ Redistributable x64（VCRedist x64）。请在解压后的 MAA 目录中以管理员身份运行 `DependencySetup_依赖库安装.bat` 来安装该依赖。安装完成后再运行 `MAA.exe`。
更多信息请参考[常见问题](./faq.md)置顶。
diff --git a/docs/zh-tw/manual/device/linux.md b/docs/zh-tw/manual/device/linux.md
index 98225407a9..4df1049271 100644
--- a/docs/zh-tw/manual/device/linux.md
+++ b/docs/zh-tw/manual/device/linux.md
@@ -15,11 +15,21 @@ icon: teenyicons:linux-alt-solid
### 使用 Wine
-MAA WPF GUI 當前可以透過 Wine 執行。
+MAA WPF GUI 當前可以透過 Wine 執行。MAA 已採用自包含部署方式，內建了 .NET 執行環境。
#### 安裝步驟
-1. 前往 [.NET 發佈頁](https://dotnet.microsoft.com/en-us/download/dotnet/10.0) 下載並安裝 Windows 版 .NET **桌面**執行環境 (Runtime)。
+1. 安裝 Visual C++ Redistributable：
+
+ 下載並安裝 [Visual C++ 可再發行套件](https://aka.ms/vc14/vc_redist.x64.exe)：
+
+ ```shell
+ wine vc_redist.x64.exe
+ ```
+
+ ::: tip
+ `DependencySetup_依赖库安装.bat` 基於 winget 和 Windows 提權機制，通常無法在 Wine 中正常工作，因此需要手動安裝執行庫。
+ :::
2. 下載 Windows 版 MAA，解壓縮後執行 `wine MAA.exe`。
diff --git a/docs/zh-tw/manual/faq.md b/docs/zh-tw/manual/faq.md
index 2bcf9bf9f6..8f6cf662f1 100644
--- a/docs/zh-tw/manual/faq.md
+++ b/docs/zh-tw/manual/faq.md
@@ -12,16 +12,17 @@ icon: ph:question-fill
若 MAA 在某次更新後無法執行，或是因為報錯視窗而導引至此，通常是因為執行庫未更新所致。
執行庫問題是最常見的錯誤原因，且經常被忽略，因此我們將此說明置頂。
+MAA 已採用自包含部署方式，內建了 .NET 執行環境，但仍需要 Visual C++ 執行庫。
+
請執行 MAA 目錄下的 `DependencySetup_依赖库安装.bat`，或在終端機中執行以下指令：
```sh
-winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements && winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
+winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --force --uninstall-previous --accept-package-agreements
```
-也可以手動下載並安裝以下**兩個**執行庫來解決問題：
+也可以手動下載並安裝以下執行庫來解決問題：
- [Visual C++ 可再發行套件](https://aka.ms/vc14/vc_redist.x64.exe)
-- [.NET 桌面執行階段 10](https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe)
:::
@@ -52,7 +53,7 @@ winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /nore
#### Windows 7 / 8 / 8.1
-.NET 10 不支援 Windows 7 / 8 / 8.1 系統[來源](https://github.com/dotnet/core/issues/7556)，所以 MAA 也同樣不再支援。
+由於 MAA 依賴的執行庫和系統元件要求 Windows 10 及以上版本，MAA 不再支援 Windows 7 / 8 / 8.1 系統。
## 連線錯誤
diff --git a/docs/zh-tw/manual/newbie.md b/docs/zh-tw/manual/newbie.md
index 16f32798e8..2bab7c3d60 100644
--- a/docs/zh-tw/manual/newbie.md
+++ b/docs/zh-tw/manual/newbie.md
@@ -28,7 +28,7 @@ icon: ri:guide-fill
4. 安裝執行庫
- MAA 需要 VCRedist x64 和 .NET 10，請執行 MAA 目錄下的 `DependencySetup_依赖库安装.bat` 進行安裝。
+ MAA 已內建 .NET 執行環境（自包含部署），但仍需要 VCRedist x64，請執行 MAA 目錄下的 `DependencySetup_依赖库安装.bat` 進行安裝。
更多資訊請參閱 [常見問題](./faq.md) 置頂內容。
diff --git a/src/MaaWpfGui/MaaWpfGui.csproj b/src/MaaWpfGui/MaaWpfGui.csproj
index a6ffeab21a..f436158072 100644
--- a/src/MaaWpfGui/MaaWpfGui.csproj
+++ b/src/MaaWpfGui/MaaWpfGui.csproj
@@ -1,4 +1,4 @@
-
+
@@ -22,8 +22,9 @@
false
false
false
- false
+ true
./externals
+ true
false
false
diff --git a/src/MaaWpfGui/Main/Bootstrapper.cs b/src/MaaWpfGui/Main/Bootstrapper.cs
index 628cb4bcbf..304fe9bbc5 100644
--- a/src/MaaWpfGui/Main/Bootstrapper.cs
+++ b/src/MaaWpfGui/Main/Bootstrapper.cs
@@ -82,6 +82,8 @@ public class Bootstrapper : Bootstrapper
// 因为经常有人把 MAA 和别的东西解压到一起然后发生 DLL 劫持然后报错，遂检测
var maaDlls = new HashSet(StringComparer.OrdinalIgnoreCase)
{
+ "hostfxr.dll",
+ "hostpolicy.dll",
"libloader.dll",
"DirectML.dll",
"fastdeploy_ppocr.dll",
diff --git a/src/MaaWpfGui/Res/Localizations/en-us.xaml b/src/MaaWpfGui/Res/Localizations/en-us.xaml
index 9ea4b428f5..9aa0433354 100644
--- a/src/MaaWpfGui/Res/Localizations/en-us.xaml
+++ b/src/MaaWpfGui/Res/Localizations/en-us.xaml
@@ -1439,8 +1439,13 @@ With save file: farm points through crafting (advanced).
Unknown DLL files have been detected in the MAA runtime directory, which may cause DLL hijacking and unexpected consequences.
Please extract MAA into a separate new folder, or remove any DLL files that do not belong to MAA.
- Detected that Microsoft Visual C++ V14 Redistributable (x64) is NOT installed or the version is too low.
-Click "{key=Confirm}" to execute the installation script and exit MAA. Click "{key=Cancel}" to exit MAA directly.
+ Failed to load MaaCore.dll. Possible reasons include:
+• Archive not fully extracted, missing necessary DLL files
+• Microsoft Visual C++ V14 Redistributable (x64) not installed or version too low
+• Other system dependencies missing
+
+Please verify that the archive has been fully extracted.
+Click "{key=Confirm}" to attempt installing/updating VC++ runtime and exit MAA (ineffective for other causes). Click "{key=Cancel}" to exit directly.
Only one instance can be launched under the same path!
If you want to run multiple MAA at the same time, please copy the whole MAA and start under different path with the same adb and different connect address.
diff --git a/src/MaaWpfGui/Res/Localizations/ja-jp.xaml b/src/MaaWpfGui/Res/Localizations/ja-jp.xaml
index a40634de67..3882eec99d 100644
--- a/src/MaaWpfGui/Res/Localizations/ja-jp.xaml
+++ b/src/MaaWpfGui/Res/Localizations/ja-jp.xaml
@@ -1440,8 +1440,13 @@ DEBUGディレクトリに保存される画像には数量制限があり、超
MAA の実行ディレクトリに不明な DLL ファイルが検出されました。DLL ハイジャックが発生し、予期しない結果を招く可能性があります。
MAA を新しい独立したフォルダーに解凍するか、MAA に属さない DLL ファイルを削除してください。
- Microsoft Visual C++ V14 Redistributable (x64) がインストールされていないか、バージョンが低すぎることが検出されました。
-「{key=Confirm}」をクリックするとインストールスクリプトが実行され、MAA が終了します。「{key=Cancel}」をクリックすると MAA が直接終了します。
+ MaaCore.dll の読み込みに失敗しました。考えられる原因：
+• アーカイブが完全に解凍されておらず、必要な DLL ファイルが不足している
+• Microsoft Visual C++ V14 Redistributable (x64) がインストールされていないか、バージョンが低すぎる
+• その他のシステム依存関係が不足している
+
+まず、アーカイブが完全に解凍されているかご確認ください。
+「{key=Confirm}」をクリックすると VC++ ランタイムのインストール/更新を試みて MAA を終了します（他の原因の場合は無効）。「{key=Cancel}」をクリックすると直接終了します。
同じパスの下で起動できるのは1つのインスタンスのみ！
MAA を複数開くには、新しい MAA を他のフォルダにコピーし、異なる MAA、同じ adb、異なるシミュレータアドレスを使用して複数の操作を行うように設定します。
diff --git a/src/MaaWpfGui/Res/Localizations/ko-kr.xaml b/src/MaaWpfGui/Res/Localizations/ko-kr.xaml
index ed70e91d1a..98ab58aeb3 100644
--- a/src/MaaWpfGui/Res/Localizations/ko-kr.xaml
+++ b/src/MaaWpfGui/Res/Localizations/ko-kr.xaml
@@ -1441,8 +1441,13 @@ DEBUG 디렉토리에 저장된 이미지는 수량 제한이 있으며 초과
MAA 실행 폴더에서 알 수 없는 DLL 파일이 감지되었습니다. 이는 DLL 하이재킹을 일으켜 예상치 못한 결과를 초래할 수 있습니다.
MAA를 독립된 새 폴더에 압축 해제하거나, MAA에 속하지 않는 DLL 파일을 제거해 주세요.
- Microsoft Visual C++ Redistributable 2015-2022(x64)가 설치되지 않았거나 버전이 너무 낮은 것으로 감지되었습니다..
-"{key=Confirm}"을 클릭하여 설치 스크립트를 실행하고 MAA를 종료하세요. "{key=Cancel}"를 클릭하여 MAA를 바로 종료하세요.
+ MaaCore.dll 로드 실패. 가능한 원인:
+• 압축 파일이 완전히 압축 해제되지 않아 필요한 DLL 파일 누락
+• Microsoft Visual C++ V14 Redistributable (x64)가 설치되지 않았거나 버전이 너무 낮음
+• 기타 시스템 종속성 누락
+
+먼저 압축 파일이 완전히 압축 해제되었는지 확인하세요.
+"{key=Confirm}"을 클릭하면 VC++ 런타임 설치/업데이트를 시도하고 MAA를 종료합니다(다른 원인인 경우 무효). "{key=Cancel}"을 클릭하면 바로 종료합니다.
동일한 경로에서는 하나의 인스턴스만 실행할 수 있습니다!
여러 개의 MAA를 동시에 실행하려면 MAA 전체 폴더를 복사한 뒤, 같은 adb를 사용하되 연결 주소는 다르게 설정하여 서로 다른 경로에서 실행하세요.
diff --git a/src/MaaWpfGui/Res/Localizations/zh-cn.xaml b/src/MaaWpfGui/Res/Localizations/zh-cn.xaml
index 1d164bcfbb..185dd0a23d 100644
--- a/src/MaaWpfGui/Res/Localizations/zh-cn.xaml
+++ b/src/MaaWpfGui/Res/Localizations/zh-cn.xaml
@@ -1440,8 +1440,13 @@ DEBUG 目录下保存的图片有数量限制，超出后会自动清理旧图
检测到 MAA 运行目录下存在未知 DLL 文件，可能导致 DLL 劫持并产生意外后果。
请将 MAA 解压到一个独立的新文件夹中，或移除不属于 MAA 的 DLL 文件。
- 检测到 Microsoft Visual C++ V14 Redistributable (x64) 未安装或版本过低,
-点击 "{key=Confirm}" 执行安装脚本并退出 MAA, 点击 "{key=Cancel}" 将直接退出.
+ MaaCore.dll 加载失败，可能的原因包括：
+• 压缩包未完整解压，缺少必要的 DLL 文件
+• 未安装 Microsoft Visual C++ V14 Redistributable (x64) 或版本过低
+• 其他系统依赖缺失
+
+请先确认是否已将压缩包完整解压。
+点击 "{key=Confirm}" 将尝试安装/更新 VC++ 运行库并退出 MAA（若为其他原因则无效），点击 "{key=Cancel}" 将直接退出。
同一路径下只能启动一个实例！
如需多开 MAA，请复制一份新的 MAA 到其他文件夹下，并设置使用不同的 MAA，相同的 adb 和不同的模拟器地址进行多开操作。
diff --git a/src/MaaWpfGui/Res/Localizations/zh-tw.xaml b/src/MaaWpfGui/Res/Localizations/zh-tw.xaml
index 2c9d186e08..26d77296d3 100644
--- a/src/MaaWpfGui/Res/Localizations/zh-tw.xaml
+++ b/src/MaaWpfGui/Res/Localizations/zh-tw.xaml
@@ -1440,8 +1440,13 @@ DEBUG 目錄下儲存的圖片有數量限制，超出後會自動清理舊圖
偵測到 MAA 執行目錄下存在未知的 DLL 檔案，可能導致 DLL 劫持並產生意外後果。
請將 MAA 解壓縮到一個獨立的新資料夾中，或移除不屬於 MAA 的 DLL 檔案。
- 偵測到 Microsoft Visual C++ V14 Redistributable (x64) 未安裝或版本過低。
-點擊 ｢{key=Confirm}｣ 將執行安裝腳本並結束 MAA；點擊 ｢{key=Cancel}｣ 將直接結束 MAA。
+ MaaCore.dll 載入失敗，可能的原因包括：
+• 壓縮檔未完整解壓縮，缺少必要的 DLL 檔案
+• 未安裝 Microsoft Visual C++ V14 Redistributable (x64) 或版本過低
+• 其他系統依賴缺失
+
+請先確認是否已將壓縮檔完整解壓縮。
+點擊 ｢{key=Confirm}｣ 將嘗試安裝/更新 VC++ 執行庫並結束 MAA（若為其他原因則無效），點擊 ｢{key=Cancel}｣ 將直接結束 MAA。
同一路徑下只能啟動一個執行個體！
如需多開 MAA，請複製一份新的 MAA 到其他資料夾，並設定使用不同的 MAA，搭配相同的 ADB 與不同的模擬器位址進行多開操作。
diff --git a/tools/DependencySetup_依赖库安装.bat b/tools/DependencySetup_依赖库安装.bat
index 5faa123696..eb6eb44db1 100644
--- a/tools/DependencySetup_依赖库安装.bat
+++ b/tools/DependencySetup_依赖库安装.bat
@@ -41,18 +41,6 @@ if %errorlevel% neq 0 (
)
echo %BLUE%====================================================================================================%RESET%
-echo.
-echo %BLUE%====================================================================================================%RESET%
-echo %BOLD%%CYAN%正在安装 .NET Desktop Runtime 10.0%RESET%
-echo %BOLD%%CYAN%Installing .NET Desktop Runtime 10.0%RESET%
-echo.
-
-winget install "Microsoft.DotNet.DesktopRuntime.10" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force
-if %errorlevel% neq 0 (
- set "ErrorOccurred=1"
-)
-echo %BLUE%====================================================================================================%RESET%
-
echo.
if %ErrorOccurred% equ 0 (
echo %BOLD%%GREEN%运行库修复完成，请重启电脑后再次尝试运行 MAA。%RESET%
@@ -65,15 +53,12 @@ if %ErrorOccurred% equ 0 (
echo %YELLOW%如果提示%RESET% %WHITE%'winget' is not...%RESET% %YELLOW%说明您的电脑版本太老了，没有自带 winget%RESET%
echo %YELLOW%If the prompt shows%RESET% %WHITE%'winget' is not...%RESET% %YELLOW%it means your system is too old and don't include winget by default.%RESET%
echo.
- echo %YELLOW%您可以手动将以下两个链接复制到浏览器中打开，下载并安装所需组件。如果安装成功，无需再次运行本依赖库安装脚本。%RESET%
- echo %YELLOW%You can manually copy the following two links into your browser to download and install the required components.%RESET%
+ echo %YELLOW%您可以手动将以下链接复制到浏览器中打开，下载并安装所需组件。如果安装成功，无需再次运行本依赖库安装脚本。%RESET%
+ echo %YELLOW%You can manually copy the following link into your browser to download and install the required components.%RESET%
echo %YELLOW%If the installation is successful, you don't need to run this dependency installation script again.%RESET%
echo.
echo %WHITE%Microsoft Visual C++ Redistributable:%RESET%
echo %CYAN%https://aka.ms/vc14/vc_redist.x64.exe%RESET%
- echo.
- echo %WHITE%.NET Desktop Runtime 10.0:%RESET%
- echo %CYAN%https://aka.ms/dotnet/10.0/windowsdesktop-runtime-win-x64.exe%RESET%
echo %RED%====================================================================================================%RESET%
)