ci: bot agent use secret

https://github.com/MaaAssistantArknights/MaaAssistantArknights/actions/runs/28439907321

[skip changelog]

.clangd

@@ -1,5 +1,14 @@
+If:
+  PathMatch: unit_test/.*\.(c|cc|cpp|cxx|h|hh|hpp)$
+CompileFlags:
+  CompilationDatabase: build/unit_test
+  Add: [-Wunused-variables]
+---
+If:
+  PathExclude: unit_test/.*\.(c|cc|cpp|cxx|h|hh|hpp)$
 CompileFlags:
   CompilationDatabase: build
   Add: [-Wunused-variables]
+---
 Diagnostics:
-  UnusedIncludes: None  
+  UnusedIncludes: None

.claude/skills/changelog/SKILL.md

@@ -0,0 +1,332 @@
+---
+name: changelog
+description: 根据 git 提交记录、diff、现有 CHANGELOG 与 tag，整理符合 MAA 发布规范的 changelog Markdown。过滤噪音、合并同类改动，输出可直接写入 CHANGELOG.md 的最终版本。
+---
+
+# MAA Changelog Skill
+
+## 目标
+
+读取待发布范围内的 commit、diff、现有 CHANGELOG 与历史 tag，输出可直接写入 `CHANGELOG.md` 的最终 Markdown。
+
+- **只输出最终 Markdown**，不输出分析过程、分类理由或代码围栏。
+- 第一目标："最终用户看得懂、历史版本不断裂、同类改动不重复"。
+
+## 必要输入
+
+- 目标版本号（如 `v6.13.0-beta.3`）。
+- 待发布提交范围（可由 tag、PR、分支信息推导）。
+- 当前 CHANGELOG 内容。
+
+## 核心规则
+
+### 1. 净变更优先
+
+- 同一功能/问题的多条相关 commit **合并为单条**，面向用户描述最终效果。
+- commit 标题含糊、口语化、玩梗时，**必须查看 diff 后改写**为专业可理解的描述。
+- **Revert 处理**：原改动被完整撤销则删除该项；仍保留部分语义则合并为一条准确描述最终结果的条目。
+- "review""typo""日志顺序""调整坐标""build warning" 等缺乏用户语义的提交不单独保留，除非 diff 证明修复了用户可感知问题。
+- **多服同类改动合并**：按**单项改动**（而非 commit/PR 整体）为粒度拆分，每项改动再跨服合并。同一 commit/PR 中若包含多项不同改动，应先按改动类型拆开，再将每项在实现了它的所有服务器上合并。服务器名用 `/` 连接（如 `YostarEN/JP/KR`），多位作者依次排列（如 `@author1 @author2 @author3`）。
+  - 示例：某 PR 为 JP 同时更新了主题、新增了章节导航，而 EN/KR 只更新了主题。应拆为两行：`YostarEN/JP/KR 更新主题`（三服共同）+ `YostarJP 新增章节导航`（仅 JP）。
+
+### 2. 按用户价值分类
+
+| 模块 | 适用场景 |
+|------|----------|
+| **新增 \| New** | 新功能、新支持、新入口、新兼容性 |
+| **改进 \| Improved** | 能力增强、性能/稳定性/体验优化、识别优化、重构收益 |
+| **修复 \| Fix** | 缺陷修正、兼容性/异常/回归修复 |
+| **文档 \| Docs** | 纯文档变更 |
+| **其他 \| Other** | 仅内部维护、CI、脚本等（不适合省略时） |
+| **MaaMacGui** | 子仓库独立区块，放在 `### 其他 \| Other` 之后，内部复用相同分类结构，PR 格式 `([#数字](https://github.com/MaaAssistantArknights/MaaMacGui/pull/数字))` |
+
+### 3. 模块内排序与文案
+
+- **中文在前，纯英文条目排最后**。
+- 按重要性排序：功能/接口变更 > 兼容性/优化 > 次要修复/杂项。
+- 列表前缀统一 `*`。
+- 中英文与数字间留空格（如"修复 3 个 bug""支持 3D 功能"）。
+- 术语统一大小写：WPF、Json、Markdown、CSV、Info。
+- 保留作者与 PR 引用，主仓库格式为 `([#12345](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/12345)) @author`；多条合并时引用合并括注。
+
+### 4. 版本历史连续性
+
+**版本类型定义**：不带 `-beta`/`-alpha` 后缀的均为正式版（包含首个正式版 `X.Y.0` 与 patch 正式版 `X.Y.1`、`X.Y.2` 等）；带后缀的为测试版。
+
+- **跨次版本号的正式版**（如 v6.12.x → v6.13.0）：不保留上一个次版本号的任何历史折叠块。
+- **同次版本号的 patch 正式版**（如 v6.13.1 相对 v6.13.0）：当前版本只写相对上一版本的增量变化（放在 `<details open>` 展开块），不得复制更早版本已发布条目。更早版本保留为各自独立的 `<details>` 收起块，紧跟在当前版本展开块之后。
+
+### 5. 测试版与 patch 版的折叠块规则
+
+- 同次版本号内的测试版（beta.1、beta.2…）与 patch 版之间**保留历史折叠块**。
+- **发布正式版时**：将所有前置测试版条目按模块合并到正式版单一详细区块，去重后统一展示。测试版间被覆盖的条目只保留最终有效版本。正式版使用 `<details open>`，其后不再保留 beta 版本历史折叠块（除非有更早正式版）。
+
+#### 正式版的详细内容来源：基于已有测试版 changelog 合并，而非全量重分析
+
+**禁止**在发布正式版时从 git 历史全量重新分析提交、重新阅读 diff。正式版的详细内容应**直接合并已发布各测试版 changelog 的条目**，工作流如下：
+
+1. 读取现有 CHANGELOG 中同次版本号的所有测试版区块（beta.1、beta.2…直至最新测试版）。
+2. 将这些区块的条目按模块（新增/改进/修复/其他…）汇总，跨测试版去重：
+   - 同一条目在多个测试版出现 → 只保留最终（最新）版本表述。
+   - 被后续测试版修正/覆盖的条目 → 保留修正后的最终结果。
+3. **唯一需要新增分析的增量**：仅为「最后一个测试版 tag → HEAD」之间的提交。这部分通常是少量改动，逐一检查后补充进正式版详细区块（有用户可感知效果才补，否则丢弃）。
+4. 合并后统一排序、统一文案，不重复、不断裂。
+
+**理由**：测试版发布时已完成对应提交范围的分析与改写，正式版只是对同一发布周期的汇总收尾，全量重分析会引入不一致、重复劳动，且容易把已被测试版 changelog 过滤/改写的噪音重新捞回。
+
+### 6. Highlights 规则
+
+- **中英双语，先中后英**。中文直接展示，英文放入 `<details><summary><b>English</b></summary>` 折叠块。
+- Highlights 只总结最值得强调的变化，不要机械搬运所有条目。
+- **复用规则（适用于 patch 版、测试版、以及由测试版晋升的正式版）**：
+  - 判定标准：相对**直接前驱版本**（patch 的父正式版、测试版的上一测试版、正式版晋升时的最后一个测试版）有无用户可感知的重大变化。
+  - 无重大变化 → **直接复用前驱版本 Highlights**，仅改版本号标题和日期，不改写内容。
+  - 有重大新变化 → 保留原有内容，新段落追加在末尾。
+- 正式版的补丁版本不应修改 Highlights，除非确实有用户可感知的重要变化。
+- **由测试版晋升的正式版（X.Y.0）**：判定基准是最后一个测试版（如 beta.3）。若最后一个测试版到正式版之间只有内部维护、CI、通知文案等无用户可感知的变化，则 Highlights 一字不改地复用最后一个测试版的内容，只更新顶部版本号标题与日期。
+
+### 7. 必须过滤的噪音
+
+删除以下类型提交：
+- bot 自动生成（`Auto Update Game Resources`、`Auto Templates Optimization` 等）
+- `Release vX.Y.Z`、`Auto Update Changelogs`、`Auto Generate Changelog`
+- `Update CHANGELOG`、`Bump version` 等 changelog 维护提交
+- 带 `[skip changelog]` 标记的提交
+
+**不过滤**：chore、perf 或看似内部优化的提交——只要有用户可感知效果（启动体验、性能、稳定性等），一律保留并放入合适模块。
+
+### 8. git 历史编码处理（Windows PowerShell）
+
+```powershell
+[Console]::OutputEncoding = [System.Text.Encoding]::UTF8; git -c core.quotepath=false -c i18n.logoutputencoding=utf-8 -c i18n.commitencoding=utf-8 log --encoding=utf-8 --format="%H %s" RANGE | ForEach-Object { [System.Text.Encoding]::UTF8.GetString([System.Text.Encoding]::Default.GetBytes($_)) }
+```
+
+如仍乱码，写入临时文件后用 read_file 读取：`| Out-File -Encoding utf8 -FilePath "$env:TEMP\commits.txt"`
+
+### 9. 翻译判断规则（外服条目保留英文原文）
+
+changelog 主体面向中文用户，但**并非所有条目都应译成中文**。判断依据是「该条目的目标读者是谁」：玩外服的用户能看懂英文/该服语言，而中文用户一般不接触外服内容，因此外服专有条目保留原文更准确、更不易误导。
+
+**用中文描述（默认）**：
+- 国服（CN）、繁中服（txwy）相关改动。
+- 跨服/全服通用的功能、架构、性能、稳定性改动。
+- 行为描述、用户操作说明（如 `add support for X` → 「新增支持 X」）。
+- 含糊/口语化/玩梗的英文 commit 标题，改写为专业可理解的中文表述。
+
+**整条保留英文原文（不翻译）——外服专有条目**：
+- **适用范围**：仅针对 YostarEN / YostarJP / YostarKR 等外服的改动，且该改动不涉及国服。整条描述（含动词、行为）均保留英文，**不要**只保留专有名词而把描述译成中文。
+- **原因**：① 外服条目的目标读者是玩该外服的用户，能看懂英文；② 外服的关卡、活动、章节、主题名（如 `lone trail`、`JieGarden`）在中文服可能不存在或译名不同，翻译会丢失原文标识、产生误导。
+- **条目格式**：服务器代号前置，后接英文描述。跨多服同改时用 `/` 连接（如 `YostarEN/JP/KR ...`）。
+- ✅ `YostarEN preload lone trail + fix JieGarden themes`
+- ✅ `YostarEN/JP/KR update LoneTrail and JieGarden themes`
+- ❌ `YostarEN/JP/KR 更新落叶逐火与界园主题`（把外服描述整条译成中文，且「落叶逐火」是中服译名）
+- ❌ `YostarEN 预加载孤星轨道并修复界园主题`（把外服描述译成中文，丢失原文）
+- ❌ 把 `Stage 10-2` 翻成「第十章第二节」
+
+**混合判断**：同一 commit/PR 同时含国服与外服改动时，按 §1 拆为多条：国服部分用中文，外服部分保留英文，各自独立成行。
+
+**代码/技术标识始终保留原文**（不分中外服）：任务名（`Stage`、`Roguelike`、`Depot`）、配置项、接口名、文件名、命令名，以及技术术语与产品名（WPF、Json、Markdown、CSV、onnx、ADB、minitouch 等，大小写见 §3）。
+
+**判断要点**：翻译的目的是让「该条目的目标读者」看得懂。国服/通用条目译给中文用户看；外服专有条目保留英文给外服用户看——不要为了「消灭英文」而过度翻译。
+
+## 完整文件结构
+
+patch / 测试版结构（严格自上而下，不得打乱层次）：
+
+1. `## vX.Y.Z (YYYY-MM-DD)` — 顶部版本标题
+2. `### Highlights` — 中文直接展示
+3. 英文 Highlights 折叠块
+4. `----` 分隔线
+5. `以下是详细内容：`
+6. `<details open><summary><b>vX.Y.Z (YYYY-MM-DD)</b></summary>` — 当前版本（展开）
+7. `<details><summary><b>vX.Y.Z-1 (YYYY-MM-DD)</b></summary>` — 上一版本（收起）
+8. 更早版本各自独立折叠块…
+9. `<details><summary><b>vX.Y.0 (YYYY-MM-DD)</b></summary>` — 最早正式版（收起）
+
+**要点**：
+- 折叠块内只保留详细内容，不重复 Highlights、不写 `## vX.Y.Z` 子标题。
+- 历史区块不重复 Highlights 和"以下是详细内容："引导语——这些只在顶部出现一次。
+
+## 工作流程
+
+### 通用步骤（patch / 测试版）
+
+1. 确定发布边界：目标版本、上一版本 tag、提交范围。
+2. 读取现有 CHANGELOG 与范围内的 diff（不只看 commit 标题）。
+3. 过滤 bot、release、`[skip changelog]`、revert 等噪音。
+4. 按净变更合并同类提交，必要时从 diff 改写标题。
+5. 按用户价值分类到正确模块。
+6. 模块内排序、术语统一、中英文整理。
+7. 编写中英双语 Highlights。
+8. 输出完整 Markdown（顶部版本 + Highlights + 详细内容 + 历史折叠块）。
+
+### 正式版（由测试版晋升）专属流程
+
+**关键区别**：正式版**不做全量重分析**，而是「合并已有测试版 changelog + 补少量增量 + 处理 Highlights 复用」。步骤如下：
+
+1. 读取现有 CHANGELOG 中同次版本号的所有测试版区块（beta.1 … beta.N）。
+2. 判定「最后一个测试版 tag → HEAD」是否有用户可感知的重大变化：
+   - 若有 → 分析这小段增量提交并整理成条目；若足以影响 Highlights 则追加（一般不追加）。
+   - 若无（仅 CI、chore、内部维护等）→ 增量条目为空。
+3. **Highlights**：直接复用最后一个测试版的 Highlights（仅改顶部版本号标题与日期），不重写。
+4. **详细内容**：将各测试版区块条目按模块汇总去重，补入第 2 步的增量条目，按 §3 排序。
+5. 输出：跨次版本号（X.Y.0）不保留历史折叠块；同次版本号 patch 正式版保留历史折叠块。
+
+## 模块标题格式
+
+```
+### 新增 | New
+### 改进 | Improved
+### 修复 | Fix
+### 文档 | Docs
+### 其他 | Other
+### MaaMacGui
+```
+
+仅保留有内容的模块，空模块省略。列表项统一 `*`。
+
+## 输出模板
+
+### 正式版
+
+```markdown
+## vX.Y.Z
+
+### Highlights
+
+#### 中文标题
+
+中文正文。
+
+<details>
+<summary><b>English</b></summary>
+
+#### English Title
+
+English paragraph.
+
+</details>
+
+----
+
+以下是详细内容：
+
+<details open>
+<summary><b>vX.Y.Z (YYYY-MM-DD)</b></summary>
+
+### 新增 | New
+
+* 条目 ([#12345](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/12345)) @author
+
+### 改进 | Improved
+
+* 条目 @author
+
+### MaaMacGui
+
+#### 新增 | New
+
+* 子仓库条目 ([#85](https://github.com/MaaAssistantArknights/MaaMacGui/pull/85)) @author
+
+</details>
+```
+
+- **跨次版本号正式版**（X.Y.0，如 v6.13.0）：按规则 §4 不保留任何历史折叠块。
+- **同次版本号 patch 正式版**（X.Y.Z, Z≥1，如 v6.13.1 相对 v6.13.0）：保留历史折叠块，与下方 patch / 测试版模板结构一致。
+
+### patch / 测试版
+
+```markdown
+## vX.Y.Z
+
+### Highlights
+
+#### 中文标题
+
+中文正文。
+
+<details>
+<summary><b>English</b></summary>
+
+#### English Title
+
+English paragraph.
+
+</details>
+
+----
+
+以下是详细内容：
+
+<details open>
+<summary><b>vX.Y.Z (YYYY-MM-DD)</b></summary>
+
+### 改进 | Improved
+
+* 条目 ([#12345](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/12345)) @author
+
+### 修复 | Fix
+
+* 条目 @author
+
+</details>
+
+<details>
+<summary><b>vX.Y.Z-1 (YYYY-MM-DD)</b></summary>
+
+### 改进 | Improved
+
+* 历史版本条目 @author
+
+</details>
+
+<details>
+<summary><b>vX.Y.0 (YYYY-MM-DD)</b></summary>
+
+### 新增 | New
+
+* 正式版条目 @author
+
+</details>
+```
+
+## 常见错误
+
+- ❌ 旧版本条目整段复制到当前 patch 版本
+- ❌ Revert 原样保留为单独条目
+- ❌ bot/release/auto generate/update changelog 提交写入文档
+- ❌ 同一功能拆成多条重复表述
+- ❌ 保留玩梗/口语化/半成品标题
+- ❌ 机械沿用 commit type 导致分类错误
+- ❌ patch/测试版无重大变化却重写独立 Highlights
+- ❌ 详细内容插入到 Highlights 与历史区块之间，破坏文件结构
+- ❌ 历史区块重复 Highlights 或"以下是详细内容："引导语
+- ❌ 正式版按 beta 小版本分别折叠而非合并
+- ❌ git 历史未指定编码导致中文乱码
+- ❌ chore/perf 提交默认当噪音过滤（应判断是否有用户可感知效果）
+- ❌ 跨次版本号时仍保留旧版本历史折叠块
+- ❌ 正式版晋升时全量重新分析 git 提交，而非合并已有测试版 changelog
+- ❌ 正式版晋升时重写 Highlights，而非复用最后一个测试版的 Highlights（无重大变化时）
+- ❌ 将外服专有条目（YostarEN/JP/KR 等）的英文描述整条译成中文，应保留原文给外服用户阅读
+
+## 最终检查
+
+- [ ] 只保留最终有效净变更，非机械罗列 commit？
+- [ ] 已删除 bot、Release、Generate、Update CHANGELOG、Revert 等噪音？
+- [ ] 未把旧版本已发布内容重复抄入当前版本？
+- [ ] 所有条目用户可独立理解？
+- [ ] 分类正确、排序合理、中文在前英文在后？
+- [ ] 输出完整 Markdown（非代码块）？
+- [ ] patch/测试版无重大变化时复用了父版本 Highlights？
+- [ ] 详细内容紧跟"以下是详细内容："之后？
+- [ ] 历史区块无重复 Highlights 和引导语？
+- [ ] 英文 Highlights 在 `<details>` 折叠块内？
+- [ ] 每个版本各自独立 `<details>` 折叠块？
+- [ ] 当前版本 `<details open>`，历史版本默认收起？
+- [ ] 子仓库（MaaMacGui）作为独立子项放在 `### 其他 | Other` 之后？
+- [ ] 正式版已合并所有测试版条目为单一区块？
+- [ ] 正式版是合并已有测试版 changelog，而非全量重分析提交？
+- [ ] 正式版 Highlights 无重大变化时复用了最后一个测试版的 Highlights？
+- [ ] git 历史查询已指定编码参数？
+- [ ] 跨次版本号时已移除旧版本历史折叠块？
+- [ ] 外服专有条目（YostarEN/JP/KR 等）保留英文原文描述，未被整条翻译成中文？

.claude/skills/maa-cyber-fortune-master/SKILL.md

@@ -0,0 +1,178 @@
+---
+name: maa-cyber-fortune-master
+description: 用“赛博道士 + 故障玄学 + 半懂不懂技术分析”的风格回复 MAA 用户的简略求助。用于用户只给一句模糊问题、没有日志、没有截图、没有报错时，做一段短小离谱但认真的玄学诊断。触发词可包括“赛博算卦”“玄学回复”“评论区整活”“帮我写一段离谱但正经的故障分析”
+---
+
+# MAA Cyber Fortune Master
+
+## Purpose
+
+- 用于生成适合评论区、工单区、聊天区的短回复。
+- 核心目标不是排查问题，而是在信息不足时先活跃气氛，再把对话引回有效诊断材料。
+- 输出必须短小、好发、像在一本正经地胡说八道。
+
+## When To Use
+
+仅在同时满足以下条件时使用：
+
+- 用户正在描述 MAA 相关故障、异常、闪退、识别失败、连接失败、卡死、掉资源、界面异常等问题。
+- 用户给的信息非常少，通常只有一句现象描述。
+- 当前没有足够日志、截图、报错文本、导出诊断或复现步骤支持正常技术分析。
+- 用户希望“整活”“玩梗”“赛博道士”“玄学分析”“评论区风格”这类表达，或上下文明显接受这种风格。
+
+## When Not To Use
+
+出现以下任一情况时，不要进入玄学模式，改为正常技术回复：
+
+- 用户已经贴出日志、截图、报错、调用栈、导出诊断。
+- 用户明确要求严肃、直接、纯技术的答复。
+- 当前场景不适合玩梗，例如正式公告、变更说明、文档正文、真实 root cause 分析。
+- 问题涉及安全、隐私、账号处罚、付款、法律风险等敏感内容。
+
+## Core Behavior
+
+你是一名“赛博道长”，专门替 MAA 用户算故障卦。
+
+当用户只给出极简问题描述时：
+
+1. 先复述用户的问题现象，保持简短。
+2. 再用一本正经的口吻说“掐指一算”“夜观天象”“观此命盘”等。
+3. 接着输出一小段离谱但像模像样的玄学分析。
+4. 最后自然收束到信息不足，提醒对方补日志、截图、报错或诊断信息。
+
+本技能的本质是：
+
+- 调节氛围。
+- 委婉指出“信息不够”。
+- 引导用户补充可诊断材料。
+
+## Style Requirements
+
+### Tone
+
+- 语气认真。
+- 内容离谱。
+- 像半仙，也像半懂不懂系统底层的老网管。
+- 不能太疯，必须让读者看得出最后是在认真索取诊断材料。
+
+### Ingredient Mix
+
+每次可自然混合其中 2 到 4 类，不要全塞满：
+
+- 五行八卦：金木水火土、命格、气运、卦象、劫数。
+- 风水命理：财位、灵脉、命宫、星象、因果、渡劫。
+- 技术黑话：CPU、GPU、DirectX、驱动、DNS、网络节点、路径、资源加载、缓存、线程、句柄。
+- 明日方舟世界观：泰拉、罗德岛、源石、干员、招募、基建、商店。
+- Windows 玄学：环境变量、路径风水、驱动走火入魔、更新逆天改命、权限灵压紊乱。
+
+### Output Length
+
+- 优先 3 到 5 句。
+- 最长不超过一个短段落加一句收束。
+- 必须适合直接发评论区，不写成长文。
+
+## Hard Constraints
+
+- 不要给出看似确定的错误技术结论。
+- 不要把玄学分析写成真正的排障结论。
+- 不要误导用户去执行危险操作。
+- 不要假装已经看过日志。
+- 不要编造不存在的 MAA 功能、设置项或错误码。
+- 最终必须回到“请补信息”，不能只整活不落地。
+
+## Fixed Output Pattern
+
+默认按这个结构生成：
+
+1. 用户问题复述
+2. 掐指一算
+3. 一段玄学分析
+4. 收束到补信息
+
+第 4 步至少包含以下之一：
+
+- 建议附日志
+- 请提供截图
+- 建议导出诊断
+- 需查看报错
+
+## Decision Rules
+
+### 如果用户只说现象
+
+- 可以大胆玄学化。
+- 但最后必须让对方补日志或截图。
+
+### 如果用户给了很少的技术词
+
+- 可以把这些词改写进玄学分析里。
+- 例如把 GPU、DNS、DirectX、驱动、路径、资源加载写成“命宫”“灵压”“因果”“风水”。
+
+### 如果用户是在评论区场景
+
+- 优先更短、更像一句回帖。
+- 结尾用一句点题，例如“贫道也只能隔着网线观星象”。
+
+### 如果用户要更像“官方吐槽”
+
+- 保持克制，不要太角色扮演。
+- 降低疯感，增加“请补日志”的清晰度。
+
+## Safe Landing Lines
+
+收束句优先参考这些模式，自然改写即可：
+
+- 建议还是发下日志，不然贫道也只能隔着网线观星象了。
+- 建议附个报错截图或者日志，贫道好继续开坛作法。
+- 建议导出一份诊断信息，不然这卦只能算到天机不可泄露这一步。
+- 还得看看具体报错，不然这边最多只能做玄学会诊。
+- 日志没发，相当于病人来了但不说哪里疼。
+
+## Reusable Phrases
+
+可选短语，按需取用，不要机械堆叠：
+
+- 界园属木，电脑属金，金克木
+- GPU 灵压不稳
+- DirectX 命宫受损
+- 路径风水不通
+- 资源已加载，命数未同步
+- 网络节点与泰拉星轨不合
+- 驱动走火入魔
+- 权限灵脉逆行
+- 因果校验失败
+- 程序当场渡劫失败
+
+## Quality Checklist
+
+输出前检查：
+
+- 是否先整活，后落地，而不是只整活？
+- 是否明确表达了“信息不足”？
+- 是否引导对方提供日志、截图、报错或诊断？
+- 是否避免了伪装成真实技术结论？
+- 是否足够短，适合评论区？
+
+## Example Outputs
+
+### 例 1：商店相关异常
+
+我掐指一算，界园属木，招募券属火，而你电脑今日金气过旺，金克木，火又扰局，结果商店财位当场逆流，程序就地渡劫失败。
+
+此乃典型的“资源已加载，命数未同步”之相。没有日志，贫道也只能隔着网线观星象了。
+
+### 例 2：闪退 / 显卡味道
+
+观你这症状，像是 GPU 命宫震荡，显卡驱动一时走火入魔，连带 DirectX 灵脉逆行，MAA 刚起势就当场兵解。
+
+不过卦象只能看个大概，建议附个报错截图或者日志，贫道好继续开坛作法。
+
+### 例 3：网络 / 刷新 / 连接类
+
+贫道夜观天象，发现你的网络节点与泰拉星轨并未对齐，疑似 DNS 风水不佳，导致请求刚出门就被天道驳回。
+
+这卦再往下算就得看因果原文了，建议把报错和日志一并带来。
+
+## One-Line Summary
+
+当用户只给一句模糊故障描述、没有诊断材料时，先用短小离谱的赛博玄学活跃气氛，再一本正经地把对话引回“请发日志、截图、报错或诊断信息”。

.claude/skills/maa-issue-log-analysis/KNOWLEDGE.md

@@ -0,0 +1,58 @@
+# MAA Issue Log Analysis Knowledge Base
+
+## Stateful UI Automation Checks
+
+- 分析 issue 时，先区分三层东西，不要混为一谈：
+ - 游戏规则
+ - MAA 当前自动化流程
+ - 用户对最终状态的预期
+- 遇到“一键/快捷/批量”按钮时，先看资源任务和日志里的真实控制路径，不要只看现象。
+- 对状态型 UI，重点核对三件事：
+ - 前置条件是什么
+ - 流程中哪些状态会被临时改写
+ - 结束条件满足后应停在哪个状态
+
+## Abort DWM
+
+- DWM 在 Windows8 之后为常开，如遇相关问题为显卡驱动问题
+
+## About Arknights PC Client
+
+- 连接 PC 端为实验性功能
+- 由于 MAA Team 开发人手有限，此功能由社区维护，非 MAA Team 持续支持，功能和稳定性可能不尽如人意，遇到问题时也可能无法第一时间修复。
+- 在使用 PC 端的过程中，如遇到影响使用的问题，建议改用 ADB 连接 Android 模拟器或移动设备，获得更稳定的体验。
+- 我们也始终欢迎有能力的开发者参与贡献提交 Pull Request，共同完善 PC 端支持。
+- PC 的鼠标为客户端独立渲染的，鼠标会挡住需要识别的目标，在需要点击相同位置的图标或重试时极有可能导致下一次识别失败。
+
+## Reception Clue Analysis
+
+- 会客室线索问题先对照当前资源任务和日志，不要只凭体感下结论。
+- 取下线索 -> 赠送重复线索 -> 当前线索数量够开启线索交流时才统一放置，这是 by design。
+- “送完重复线索后线索板暂时为空”或“用户自己放的线索被统一取下”本身不能直接判成 bug。
+
+## PC announcement cannot be closed
+
+- PC 端的公告为独立的弹出窗口，现有的窗口绑定方式无法截图获取到公告窗口
+- 如需使用 PC 端自动关闭公告，请使用前台的截图方式，但该方法会要求窗口必须在前台且无遮挡
+- 如不是用前台模式，请手动关闭公告，或更推荐使用 adb 连接模拟器
+
+## Guardrails For Future Analysis
+
+- 不要把维护者评论、机器人评论、或单张截图当成最终结论；必须回到日志和代码确认状态是怎么变化的。
+- 对状态型 UI，先回答“日志里的行为是否符合设计”，再回答“这个设计是否符合用户预期”。
+- 不要只看最终现象；要结合配置、`gui.log`、`asst.log`、资源任务和当前代码一起判断。
+
+## MAA multi-opening and multi-account management
+
+- MAA 在设计上仅针对单账号使用。若你需要同时管理多个游戏账号（多开），官方并未提供内置支持，但可以通过复制多份 MAA 程序到不同文件夹的方式实现变通
+- 不考虑多开相关实现
+
+## Connect.TouchMode: adb
+
+- MAA 触控模式共三种：`minitouch`（默认）、`maatouch`（实验性）和 `adb input`（不推荐使用）。
+- `maatouch` 是 `minitouch` 的 Java 实现，并额外支持按键输入，可避免 minitouch 走 adb 命令传输按钮带来的较高延迟。
+- `adb input` 仅用于兼容部分系统版本过低、无法运行 `minitouch` 或 `maatouch` 的实体机设备。
+- 能用前两种模式时，绝不推荐使用 `adb input`。
+- `adb input` 的滑动容易拖飞，为避免此问题，滑动速度会被设置得非常慢，且滑动距离与其他两种模式不同；在需要精确控制坐标的场景下无法使用。
+- 若用户反馈触控相关异常且配置为 `adb`，应优先建议切换为 `minitouch` 或 `maatouch`，排除模式本身带来的延迟与兼容性问题。
+

.claude/skills/maa-issue-log-analysis/SKILL.md

@@ -5,12 +5,20 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
 
 # MAA Issue Log Analysis
 
+## Required Reading
+
+- 开始分析前，先读取同目录的 `KNOWLEDGE.md`，先用其中的通用误判规则校正自己的分析路径，再读 issue 和日志。
+- 如果 issue 涉及会客室、线索、快捷按钮、批量按钮、自动领取/赠送/放置这类“会先改变界面状态再继续执行”的流程，必须先套用 `KNOWLEDGE.md` 中的 `Stateful UI Automation Checks` 与 `Reception Clue Analysis`。
+- 如果用户没有贴出日志、报告包、报错文本、截图或导出诊断等有效证据，不要直接进入严肃日志分析；先转用同目录技能 `maa-cyber-fortune-master/SKILL.md` 生成一段短小的玄学回复，把对话自然引导到“补日志 / 截图 / 报错 / 诊断信息”。
+
 ## Scope
 
 - 仅用于上游公开仓库 `https://github.com/MaaAssistantArknights/MaaAssistantArknights`。
 - 输入可以是完整 issue URL，或 `#1234` 形式的 issue 编号。
 - 只分析公开 issue 中可直接访问的附件。
-- 如果没有可下载的 `report_*.zip`，先明确说明证据不足，再尽量基于 issue 文本、截图、代码和文档给出初步判断。
+- 如果没有可下载的 `report_*.zip`，先判断用户是否至少提供了其他有效证据（报错文本、截图、导出诊断、清晰复现步骤）。
+- 如果连这些也没有，优先转用 `maa-cyber-fortune-master/SKILL.md`，不要直接输出严肃分析模板。
+- 如果没有 `report_*.zip` 但仍有其他有效证据，再明确说明证据不足，并尽量基于 issue 文本、截图、代码和文档给出初步判断。
 - 如果评论里有机器人提示“日志没有上传成功”，不要直接放弃；正文里的附件链接仍可能可下载。
 
 ## Workflow
@@ -20,19 +28,26 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
  - `#1234` 视为 `https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/1234`
  - 如果不是 `MaaAssistantArknights/MaaAssistantArknights`，停止并说明此 skill 不适用。
 
-2. 获取 issue 内容。
+2. 先判断证据是否足够。
+
+ - 如果用户只给一句模糊现象，且没有日志、报告包、截图、报错文本、导出诊断或清晰复现步骤，不进入本 skill 的严肃分析流程。
+ - 此时改用 `maa-cyber-fortune-master/SKILL.md`，先用短小玄学回复活跃气氛，再把对话引导到补充日志、截图、报错或诊断信息。
+ - 只有在用户已经提供可分析证据时，才继续下面的 issue / 日志分析步骤。
+
+3. 获取 issue 内容。
 
  - 读取正文和评论。
  - 提取这些信息：UI/Core/Resource 版本、资源时间、模拟器类型、分辨率、截图增强、GPU 推理、任务名、关卡名、是否有 `-hard`、用户现象、复现步骤、维护者或机器人评论。
  - 不要把评论结论当成唯一证据；仍要用日志和代码自行验证。
+ - 如果 issue 文本或评论里已经有人下了“这是游戏设计 / 不是 bug / 本来就这样”的结论，先暂存，不要直接复述成最终判断；先核对日志、资源任务和当前代码是否真的支持这个结论。
 
-3. 提取报告附件。
+4. 提取报告附件。
 
  - 关注 `report_*.zip`。
  - 附件可能同时出现在正文和评论。
  - 按 `report_MM-dd_HH-mm-ss` 分组，同一时间戳下的 `part01`、`part02`、`part03` 是独立 zip，不是需要先拼接的分卷压缩包。
 
-4. 先看 `part01`，再决定是否看 `part02+`。
+5. 先看 `part01`，再决定是否看 `part02+`。
 
  - 根据 WPF 打包逻辑，`part01` 一定优先，通常包含：
  - `debug/asst.log`
@@ -50,7 +65,7 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
  - `debug/dumps/*`
  - `part02+` 可能是空包，也可能只包含图片；不要默认里面一定有文本日志。
 
-5. 建立时间线。
+6. 建立时间线。
 
  - 先用 `gui.log` 找用户点击、所选关卡、任务链开始、报错时间。
  - 再用 `asst.log` 还原底层行为。
@@ -60,8 +75,12 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
 - 先在 `gui.log` 确认 `AttachWindow: Found window`
 - 再在 `asst.log` 里看 `Win32Controller::screencap`、`Win32Controller::click`
 - 不要再按 ADB 端口或 `ConnectionInfo.ConnectFailed` 的思路分析
+- 如果问题属于状态型 UI 自动化（例如会客室线索、批量按钮、快捷按钮、先拆后放一类流程），时间线里必须单独标出：
+- 自动化在什么时刻先修改了用户原状态
+- 后续进入下一步或恢复终态由哪个条件控制
+- 条件不满足时流程是停止、跳过，还是按设计停在别的状态
 
-6. 区分 issue 当时环境和当前分支。
+7. 区分 issue 当时环境和当前分支。
 
  - 先以报告包中的 `config/` 与 `cache/resource/` 还原用户当时实际运行的配置和资源。
  - 再对照当前仓库代码，判断该问题是当前仍存在，还是当时存在但现在已修复。
@@ -245,6 +264,12 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
  - 摘几十行足够支撑结论的片段即可。
  - 不要把整份日志倾倒进回复。
 
+8. 对状态型 UI 问题，结论前先做一次“设计一致性检查”。
+
+ - 先判断日志中的状态变化是否符合游戏规则、资源任务定义和当前实现。
+ - 如果流程与设计一致，不要把用户不喜欢的中间状态直接归为 bug。
+ - 只有当日志、资源任务和代码彼此冲突，或流程没有达到设计要求的终态时，再归类为实现缺陷。
+
 ## Common Patterns
 
 - `gui.log` 只显示“连接失败”，但 `asst.log` 里已经给出 `adb devices`、`adb connect`、端口轮询和 `ConnectionInfo`。连接类问题必须以 `asst.log` 为准。
@@ -254,6 +279,8 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
 - `part02` 可以是空包，也可以只包含图片；不要因为没有文本日志就把它判成“无用分卷”。
 - issue 机器人评论“日志没有上传成功”时，不要自动当真；先验证正文附件是否仍可下载。
 - 如果 `gui.log` 说“任务出错”，但对应 `taskid` 的 `asst.log` 实际 `AllTasksCompleted`，要明确写“本次日志未复现用户描述的问题”。
+- 对会客室 / 线索 issue，如果 `asst.log` 里出现 `InfrastClueQuickInsert`、`remove_clue`、`SendClues` 或 `InfrastClueQuickSendDuplicates`，先对照资源任务判断这是不是当前设计流程，不要只看线索板中途是否为空。
+- 如果线索流程里出现“取下线索 -> 赠送重复线索 -> 条件满足后统一放置”，默认先按 by design 处理；只有当日志显示本应统一放置却没有发生时，再继续追实现问题。
 - 用户日志里的任务流程与当前主线代码明显不一致，且当前代码看起来已经修掉了该问题：
 
     - 先确认用户版本，必要时切到对应 tag（例如 `git checkout vXXX`）核对旧逻辑。
@@ -261,7 +288,7 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
     - 如果主线已修复，再看修复 commit 是否已进入 tag / release：已发版建议升级，未发版建议等待 release。
 - `gui.new.json`、`gui.json` 和实际日志不一致时，不要急着判“用户配置写错了”；先看 `gui.new.json.bak` 和 `gui.json.old`，尤其是用户复现后又改回开关的场景。
 - 在 `ConnectConfig=PC` 的 issue 里，`Win32Controller::click` 正常返回不代表点击真的生效；要看点击后的下一帧中，按钮状态、数量 OCR、场景识别有没有变化。
-- `gui.log` 中“已使用 48 小时内过期的理智药”这类高层提示，不一定等价于底层逐药 OCR 结论；如果 `asst.log` 明确识别到 `9天`、`NotExpiring` 等相反证据，应优先相信 `asst.log`。
+- `gui.log` 中"已使用即将过期的理智药"这类高层提示，不一定等价于底层逐药 OCR 结论；如果 `asst.log` 明确识别到 `3天`、`NotExpiring` 等相反证据，应优先相信 `asst.log`。注意过期天数阈值现为可配置参数 `medicine_expire_days`，不再是固定 48 小时。
 
 ## Correlating With Code
 
@@ -361,7 +388,46 @@ description: 分析 MaaAssistantArknights 上游仓库公开 Issue（`https://gi
 
 ## Output Format
 
-最终回答用这个结构：
+先做输出分流，不要无论什么情况都套完整模板。
+
+### 分流规则
+
+- 如果用户没有提供有效证据，只给出一句模糊现象，或只有 issue 文本但没有日志、报告包、截图、报错文本、导出诊断、清晰复现步骤，那么不要输出下面那套完整分析模板。
+- 这类场景直接改用 `maa-cyber-fortune-master/SKILL.md` 的风格回复，并把“赛博算一卦”放在开头。
+- 此时输出必须足够短，通常 2 到 4 句即可。
+- 这类短回复里不要再展开：
+ - `Issue 概要`
+ - `关键证据`
+ - `根因判断`
+ - `修复方案`
+ - `English translation`
+ - “点击此处展开”这类折叠块
+- 本质要求是：先用玄学接住气氛，再用一句话明确要求补日志、截图、报错或诊断信息。
+
+### 无有效证据时的推荐格式
+
+```markdown
+[一句简短复述用户现象]
+
+[赛博算一卦 / 掐指一算 / 夜观天象开场]
+[1 到 2 句短小玄学分析]
+
+[一句自然收束到补日志、截图、报错或导出诊断]
+```
+
+### 无有效证据时的示例
+
+```markdown
+你这个是刷界园时，第一层商店点了招募券就直接结束。
+
+赛博算一卦，界园属木，招募券属火，如今商店财位一震，像是招募灵脉和界园卦象临时撞了车，程序当场收摊回府。
+
+不过这卦现在只有天象，没有脉案。建议补一份复现当次的日志或报错截图，不然贫道也只能隔着网线观星象。
+```
+
+### 有有效证据时
+
+最终回答再用这个完整结构：
 
 ```markdown
 ## Issue 概要
@@ -437,6 +503,8 @@ Translate the complete conclusion directly into English and paste it here. Note
 
 ## Reminders
 
+- 如果用户没有贴出日志、报告包、截图、报错文本或导出诊断，不要硬套本 skill 的完整分析模板；优先改用 `maa-cyber-fortune-master/SKILL.md`，先把气氛接住，再把话题引回补证据。
+- 如果是“无有效证据”分支，赛博算卦段落应该放在最开头，并直接结束在“请补证据”；不要再追加长篇的 Issue 摘要、猜测性根因、修复方案或英文翻译。
 - 不要只看 `gui.log` 下结论。
 - 不要把 issue 评论或机器人提示当成唯一证据。
 - 不要把当前分支资源直接当成 issue 当时的真实环境；先看报告包里的 `cache/resource`。

.cursor/skills/code-review-report/SKILL.md

@@ -0,0 +1,262 @@
+---
+name: code-review-report
+description: >-
+  全项目代码审查流水线，输出结构化审查报告到 Markdown 文件。
+  按模块拆分 Review Unit，派发 subagent 并行审查，汇总发现并分类，
+  生成完整的问题清单报告，不执行任何修复。
+  Use when the user says "全项目review"、"代码审查"、"code review"、
+  "审查报告"、"review report"、"项目体检".
+disable-model-invocation: true
+---
+
+# Code Review Report Pipeline
+
+全项目代码审查 → 并行 Review → 汇总发现 → 生成报告（只审不修）。
+
+## 项目背景
+
+MAA (MaaAssistantArknights) 是一个多语言 monorepo，包含核心引擎、多端 GUI、CLI、语言绑定等子项目：
+
+### 核心 & GUI
+
+| 模块 | 语言 | 路径 | 子模块? | 构建 |
+|------|------|------|---------|------|
+| MaaCore | C++20 | `src/MaaCore/` | 否 | CMake |
+| MaaWpfGui | C# / WPF (.NET 10) | `src/MaaWpfGui/` | 否 | MSBuild |
+| MaaMacGui | Swift / SwiftUI | `src/MaaMacGui/` | **是** | Xcode |
+| MAAUnified | C# / Avalonia (.NET 10) | `src/MAAUnified/` | **是** | dotnet |
+| maa-cli | Rust | `src/maa-cli/` | **是** | Cargo |
+| MaaUtils | C++ | `src/MaaUtils/` | **是** | CMake |
+| MaaWineBridge | C | `src/MaaWineBridge/` | 否 | CMake |
+| MaaUpdater | C++ (Win) | `src/MaaUpdater/` | 否 | CMake |
+
+### 语言绑定 & 工具
+
+| 模块 | 语言 | 路径 | 说明 |
+|------|------|------|------|
+| Python 绑定 | Python | `src/Python/` | ctypes FFI |
+| Rust 绑定 | Rust | `src/Rust/` | FFI + HTTP server |
+| Go 绑定 | Go 1.23 | `src/Golang/` | Gin HTTP wrapper |
+| Java 绑定 | Kotlin/Java | `src/Java/` | JNA + Ktor HTTP/WS |
+| Dart 绑定 | Dart | `src/Dart/` | Flutter FFI plugin |
+| Woolang 绑定 | Woolang | `src/Woolang/` | C API wrapper |
+| C++ 示例 | C++ | `src/Cpp/` | 集成示例 |
+| 工具脚本 | Python/C++/Shell | `tools/` | 开发维护工具 |
+| 任务资源 | JSON | `resource/` | 任务定义/模板/OCR |
+| 文档站 | Markdown/TS | `docs/` | VuePress |
+| 公共头文件 | C | `include/` | AsstCaller.h 等 |
+
+### 编码规范执行
+
+| 配置文件 | 作用范围 |
+|----------|----------|
+| `.clang-format` | C++ (pre-commit 限定 `src/MaaCore/**`) |
+| `.editorconfig` (多层) | 全局 + MaaCore/MaaWpfGui/maa-cli/MaaUtils 各有覆盖 |
+| `rustfmt.toml` | Rust (maa-cli) |
+| `.swift-format` | Swift (MaaMacGui) |
+| `stylecop.json` | C# (MaaWpfGui) |
+| `.prettierrc` | JSON/YAML |
+| `analysis_options.yaml` | Dart |
+| `.pre-commit-config.yaml` | clang-format + Prettier + Ruff + markdownlint |
+
+## Phase 1: 探索 & 拆分 Review Unit
+
+1. 用 `explore` subagent 扫描项目，确认当前有哪些模块/子目录有实质改动或需要关注
+2. 按 **模块 × 关注维度** 拆分为 12-20 个 Review Unit，每个 Unit：
+   - 文件范围 ≤ 8 个核心文件（C++ 可适当放宽，但避免单 Unit 超 2000 行总量）
+   - 有明确的 review 焦点
+   - 提供该模块的背景信息
+3. 标注优先级：P0（安全/崩溃/数据损坏）、P1（可靠性/性能/兼容性）、P2（代码质量/可维护性）
+
+### 各语言 Review 焦点
+
+**C++ (MaaCore / MaaUtils / MaaWineBridge / MaaUpdater)**：
+
+- 内存安全（裸指针、RAII 遗漏、use-after-free）
+- 线程安全（共享状态、锁粒度、竞态条件）
+- 异常安全（析构器 throw、RAII 保证）
+- 图像识别/OCR 流程正确性
+- 跨平台兼容（Windows/Linux/macOS 条件编译）
+- MaaWineBridge：Wine/native 转发正确性
+
+**C# (MaaWpfGui)**：
+
+- MVVM 模式遵循（View/ViewModel 职责划分）
+- INotifyPropertyChanged 正确性
+- UI 线程安全（Dispatcher 调用）
+- 资源泄露（IDisposable）
+- 本地化完整性
+- StyleCop 规范合规
+
+**C# / Avalonia (MAAUnified)**：
+
+- 跨平台 UI 兼容（macOS/Linux/Windows）
+- CoreBridge 与 MaaCore 交互正确性
+- 分层架构合理性（App/Application/Platform/CoreBridge）
+- 与 MaaWpfGui 功能对齐一致性
+
+**Swift (MaaMacGui)**：
+
+- SwiftUI 生命周期管理
+- MaaCore FFI 调用安全性（指针/内存管理）
+- macOS 平台特性使用（沙盒、权限）
+- `.swift-format` 规范合规
+
+**Rust (maa-cli)**：
+
+- 所有权/生命周期正确性
+- Error handling（`?` 传播链完整性）
+- unsafe 代码合理性与安全注释
+- Cargo feature 配置正确性
+- 参考 `src/maa-cli/AGENTS.md` 的检查项
+
+**语言绑定 (Python/Rust/Go/Java/Dart/Woolang)**：
+
+- FFI 调用安全性（指针、回调、生命周期）
+- 资源释放（Handle/Destroy 配对）
+- 与 `include/AsstCaller.h` 公共 API 的一致性
+- 错误传播与异常处理
+
+**Python (tools/)**：
+
+- 类型注解一致性
+- 异常处理（不吞异常）
+- 文件路径跨平台处理
+
+**JSON (resource/)**：
+
+- Schema 合规性
+- 模板匹配参数合理性
+- 多语言/多服务器资源一致性
+
+## Phase 2: 并行 Review
+
+按优先级批次启动 subagent：
+
+```
+第一批：P0 Unit（3-5 个并行）
+第二批：P1 Unit（5-7 个并行）
+第三批：P2 Unit（剩余全部）
+```
+
+每个 review subagent 的 prompt 模板：
+
+```
+你是 MAA 项目的代码审查员。审查以下文件，找出：
+1. Bug（逻辑错误、边界条件、竞态、崩溃风险）
+2. 安全问题（缓冲区溢出、注入、信息泄露、不安全的反序列化）
+3. 性能问题（不必要的拷贝、内存分配热点、O(n²) 算法）
+4. 跨平台兼容性（平台特定代码未条件编译、路径分隔符硬编码）
+5. 可维护性（巨型函数、重复代码、缺少错误处理）
+
+项目语言：{language}
+文件范围：{files}
+背景：{background}
+重点关注：{focus_areas}
+
+输出格式：按严重性排序的问题列表（最多 Top 8）。每个问题包含：
+- 严重性：Critical / Major / Minor
+- 位置：文件名 + 行号范围
+- 问题：一句话描述
+- 影响：会导致什么后果
+- 建议：修复方向（一句话）
+- 代码片段：相关代码（可选，简短引用即可）
+```
+
+## Phase 3: 汇总 & 生成报告
+
+收集所有 Unit 的发现，按以下步骤生成报告：
+
+1. **去重合并**：同一 bug 在多个 Unit 被发现时，保留最详细的描述
+2. **分类归类**：
+
+| 分类 | 含义 | 图标 |
+|------|------|------|
+| 崩溃/安全 | 可导致崩溃或被利用 | 🔴 |
+| 可靠性 | 影响功能正确性 | 🟠 |
+| 性能 | 影响运行效率 | 🟡 |
+| 兼容性 | 跨平台/版本兼容问题 | 🔵 |
+| 代码质量 | 可维护性与规范 | ⚪ |
+
+1. **按模块和严重性排序**
+2. **生成统计摘要**
+
+### 报告模板
+
+将报告输出到项目根目录的 `code-review-report.md`，使用以下模板：
+
+```markdown
+# MAA 代码审查报告
+
+> 审查时间：{date}
+> 审查范围：{modules_reviewed}
+> Review Unit 数量：{unit_count}
+
+## 摘要
+
+| 严重性 | 数量 |
+|--------|------|
+| 🔴 Critical | {n} |
+| 🟠 Major | {n} |
+| 🟡 Minor | {n} |
+| 总计 | {total} |
+
+| 模块 | Critical | Major | Minor |
+|------|----------|-------|-------|
+| MaaCore (C++) | {n} | {n} | {n} |
+| MaaWpfGui (C#) | {n} | {n} | {n} |
+| MaaMacGui (Swift) | {n} | {n} | {n} |
+| MAAUnified (C#/Avalonia) | {n} | {n} | {n} |
+| maa-cli (Rust) | {n} | {n} | {n} |
+| MaaUtils (C++) | {n} | {n} | {n} |
+| MaaWineBridge (C) | {n} | {n} | {n} |
+| 语言绑定 | {n} | {n} | {n} |
+| tools (Python) | {n} | {n} | {n} |
+| resource (JSON) | {n} | {n} | {n} |
+
+## 🔴 Critical 问题
+
+### [{序号}] {问题标题}
+
+- **模块**：{module}
+- **文件**：`{file}:{line_range}`
+- **分类**：{category}
+- **描述**：{description}
+- **影响**：{impact}
+- **建议修复方向**：{suggestion}
+
+{code_snippet（可选）}
+
+---
+
+## 🟠 Major 问题
+
+### [{序号}] {问题标题}
+...
+
+## 🟡 Minor 问题
+
+### [{序号}] {问题标题}
+...
+
+## 审查覆盖范围
+
+| Review Unit | 模块 | 焦点 | 优先级 | 文件数 |
+|-------------|------|------|--------|--------|
+| {unit_name} | {module} | {focus} | {priority} | {file_count} |
+| ... | ... | ... | ... | ... |
+
+## 附注
+
+- 本报告仅列出发现，未执行任何修复
+- 建议按 Critical → Major → Minor 顺序处理
+- 部分问题可能需要跨模块协同修复
+```
+
+## 执行要点
+
+- **只审不修**：本 skill 不修改任何代码，所有发现仅记录到报告
+- **报告路径**：默认输出到 `code-review-report.md`，用户可指定其他路径
+- **增量 vs 全量**：如用户指定范围（如"只看 MaaCore"），相应缩减 Unit 拆分
+- **subagent 并行上限**：每批不超过 7 个，避免上下文竞争
+- **代码片段引用**：报告中引用代码时使用 ` ```startLine:endLine:filepath ` 格式

.devin/wiki.json

@@ -0,0 +1,212 @@
+{
+  "repo_notes": [
+    {
+      "content": "所有 wiki 页面标题、正文、说明文字必须使用简体中文；涉及外部链接时优先使用中文文档，如 docs.maa.plus 的 zh-cn 页面；仅在中文名不通用时保留 OCR、ADB、CLI、JSON、API 等缩写。"
+    },
+    {
+      "content": "MAA 是基于图像识别的《明日方舟》自动化助手，仓库中的主要实现集中在 src/MaaCore、src/MaaWpfGui、resource、docs、tools、include；文档应围绕这些主干说明系统关系。"
+    },
+    {
+      "content": "src/maa-cli、src/MaaMacGui、src/MAAUnified、src/MaaUtils、test、3rdparty/EmulatorExtras 是子模块或边界模块；说明它们与主仓库的集成关系即可，不要假设所有内部实现都在当前仓库。"
+    },
+    {
+      "content": "MaaCore 需要按 Assistant、Controller、Vision、Task、Config 的协作关系来写，而不是仅按目录逐个罗列；重点说明任务调度、设备控制、视觉识别、任务执行和资源加载如何配合。"
+    },
+    {
+      "content": "resource/tasks 目录是任务定义的主入口，加载时会递归合并目录内 JSON；旧的 tasks.json 只是兼容旧结构的 deprecated fallback，不应继续作为主要入口来描述。"
+    },
+    {
+      "content": "resource/global/<client>/resource 与 resource/platform_diff/*/resource 是覆盖层，用于外服适配和平台差异；说明时要突出主资源与覆盖资源的关系，而不是把它们写成独立产品线。"
+    },
+    {
+      "content": "WPF GUI 是主仓库中的主要图形界面；CLI、Mac GUI 与各语言绑定是 MaaCore 的其他入口；文档应强调共享核心引擎、不同接入层的整体架构。"
+    },
+    {
+      "content": "unit_test 是仓库内的 Catch2 与 CTest 单元测试体系；test 是 MaaTestSet 回归测试子模块；docs 是独立的 VuePress 文档站，应按 manual、protocol、develop、glossary 等内容域来组织说明。"
+    },
+    {
+      "content": "interface.json 定义 controller 与 resource 变体，package-definition.json 定义发布包形态；构建、发布和资源相关页面需要覆盖这两个入口文件的作用。"
+    }
+  ],
+  "pages": [
+    {
+      "title": "项目总览",
+      "purpose": "介绍 MAA 的产品定位、支持平台、许可证、顶层目录结构，以及 MaaCore、resource、前端入口、自动化功能和工程体系之间的阅读路径；本页只做导航与高层概览，不展开实现细节。",
+      "page_notes": [
+        {
+          "content": "本页只负责建立阅读路径和高层认知，不重复 MaaCore、resource、自动化功能或工程体系子页中的实现细节。"
+        }
+      ]
+    },
+    {
+      "title": "MaaCore 引擎",
+      "purpose": "说明 src/MaaCore 的整体运行时结构，重点描述 Assistant、Controller、Vision、Task、Config 五个核心部分如何协作构成自动化引擎。",
+      "parent": "项目总览",
+      "page_notes": [
+        {
+          "content": "优先围绕 Assistant、Controller、Vision、Task、Config 的协作关系展开，并用 src/MaaCore 中的实际类型和目录说明运行时结构。"
+        }
+      ]
+    },
+    {
+      "title": "Assistant 与公共 API",
+      "purpose": "文档化 Assistant 的任务队列、线程模型和生命周期管理，以及 include/AsstCaller.h 暴露的公共 C 接口如何作为各类前端和绑定层的统一调用入口。",
+      "parent": "MaaCore 引擎"
+    },
+    {
+      "title": "设备连接与控制器",
+      "purpose": "文档化 Controller 子系统，包括 ADB 连接、截图链路、触控链路、模拟器适配、Minitouch 与 MaaTouch，以及控制器实现如何为任务执行提供设备 I/O。",
+      "parent": "MaaCore 引擎"
+    },
+    {
+      "title": "图像识别与 OCR",
+      "purpose": "文档化 Vision 子系统中模板匹配、OCR、特征检测、ONNX 推理和 PaddleOCR 等识别能力，以及各类分析器如何为任务执行提供决策输入。",
+      "parent": "MaaCore 引擎"
+    },
+    {
+      "title": "任务引擎与执行模型",
+      "purpose": "文档化 AbstractTask、PackageTask、InterfaceTask、ProcessTask、任务插件和流程控制机制，说明任务定义如何转换为可执行的自动化流程。",
+      "parent": "MaaCore 引擎"
+    },
+    {
+      "title": "资源与配置系统",
+      "purpose": "说明 resource 目录与 MaaCore 配置加载体系的关系，概述任务数据、模板、模型、外服覆盖和专用数据包如何共同驱动自动化逻辑。",
+      "parent": "项目总览"
+    },
+    {
+      "title": "资源加载与覆盖规则",
+      "purpose": "文档化 ResourceLoader、TaskData、TemplResource 和 WPF 侧资源加载流程，说明主资源、缓存资源、外服资源和平台差异资源的搜索路径与叠加顺序。",
+      "parent": "资源与配置系统",
+      "page_notes": [
+        {
+          "content": "以 src/MaaCore/Config/ResourceLoader.cpp、src/MaaCore/Config/TaskData.cpp、src/MaaWpfGui/Main/AsstProxy.cs 和 interface.json 为主要事实锚点，明确目录优先、覆盖叠加和外服差异的加载规则。"
+        }
+      ]
+    },
+    {
+      "title": "任务 JSON 与任务树",
+      "purpose": "文档化 resource/tasks 目录中的任务定义结构、任务 JSON 的识别与动作协议、next、timeout、onError 等跳转规则，以及任务树的组织方式。",
+      "parent": "资源与配置系统",
+      "page_notes": [
+        {
+          "content": "强调 resource/tasks 是主入口、目录会递归合并 JSON、旧的 tasks.json 是 deprecated fallback，并说明任务树与模板资源之间的关系。"
+        }
+      ]
+    },
+    {
+      "title": "模板、OCR 模型与识别资源",
+      "purpose": "文档化 resource/template、resource/onnx、resource/PaddleOCR、resource/PaddleCharOCR、resource/ocr_config.json、resource/battle_data.json 等识别资源的职责分工，以及它们如何支撑视觉分析。",
+      "parent": "资源与配置系统"
+    },
+    {
+      "title": "外服与平台差异资源",
+      "purpose": "文档化 resource/global 与 resource/platform_diff 的目录结构、覆盖逻辑与适配用途，说明国际服、日服、韩服、繁中服以及 PC 平台差异资源如何在主资源之上叠加。",
+      "parent": "资源与配置系统"
+    },
+    {
+      "title": "专用数据包与玩法资源",
+      "purpose": "文档化 resource/copilot、resource/custom_infrast、resource/roguelike、resource/Arknights-Tile-Pos、resource/recruitment.json、resource/infrast.json、resource/stages.json 等专用数据包的职责，以及它们与自动化功能页的关系。",
+      "parent": "资源与配置系统"
+    },
+    {
+      "title": "前端与集成",
+      "purpose": "概述 WPF GUI、CLI、Mac GUI 和多语言绑定等接入层如何共享 MaaCore，以及本仓库实现与子模块边界之间的关系。",
+      "parent": "项目总览"
+    },
+    {
+      "title": "WPF 图形界面",
+      "purpose": "文档化 src/MaaWpfGui 的 MVVM 结构、主要 ViewModel 与 Services、界面功能模块、本地化资源，以及它如何与 MaaCore 交互。",
+      "parent": "前端与集成"
+    },
+    {
+      "title": "命令行工具 maa-cli",
+      "purpose": "文档化 src/maa-cli 子模块作为 Rust CLI 的定位、配置与调度角色，以及它与 MaaCore 和无 GUI 使用场景的关系。",
+      "parent": "前端与集成"
+    },
+    {
+      "title": "多语言集成接口",
+      "purpose": "文档化 include/AsstCaller.h 作为统一接口入口，以及 src/Python、src/Java、src/Rust、src/Golang、src/Dart、src/Woolang 等绑定层如何在不同语言环境中接入 MaaCore。",
+      "parent": "前端与集成",
+      "page_notes": [
+        {
+          "content": "以 include/AsstCaller.h 为统一入口，按统一 C 接口加各语言封装层的方式组织内容，不按语言逐一展开成平行小页面。"
+        }
+      ]
+    },
+    {
+      "title": "自动化功能",
+      "purpose": "概述 MAA 主要自动化能力的功能分区与实现入口，包括作战、基建、公招、肉鸽、抄作业和专项玩法等主题。",
+      "parent": "项目总览"
+    },
+    {
+      "title": "自动作战与关卡导航",
+      "purpose": "文档化 Fight 相关任务的关卡选择、导航、理智管理、代理指挥、掉落识别与数据上传流程，以及对应的数据资源与任务链路。",
+      "parent": "自动化功能"
+    },
+    {
+      "title": "基建自动换班",
+      "purpose": "文档化 Infrast 相关任务的效率计算、排班与换班逻辑、自定义排班数据，以及基建资源与任务执行之间的关系。",
+      "parent": "自动化功能"
+    },
+    {
+      "title": "自动公招与标签识别",
+      "purpose": "文档化公招标签 OCR、标签组合策略、识别结果处理与 recruitment 数据的关系，以及公招自动化的主要任务链路。",
+      "parent": "自动化功能"
+    },
+    {
+      "title": "肉鸽自动化",
+      "purpose": "文档化 Roguelike 相关任务的主题配置、招募、练度识别、商店、遭遇、策略参数和不同主题之间的资源差异。",
+      "parent": "自动化功能"
+    },
+    {
+      "title": "自动抄作业",
+      "purpose": "文档化 Copilot 作业数据格式、干员部署与技能释放逻辑、作业资源的组织方式，以及与外部作业站的关系。",
+      "parent": "自动化功能"
+    },
+    {
+      "title": "专项玩法自动化",
+      "purpose": "文档化 SSS、Reclamation、MiniGame 等不适合并入主功能页的专项玩法任务族群，以及它们在 Task 与 resource 中的组织方式。",
+      "parent": "自动化功能"
+    },
+    {
+      "title": "工程体系",
+      "purpose": "概述构建、发布、测试、文档站、内部工具与子模块边界之间的工程协作关系。",
+      "parent": "项目总览"
+    },
+    {
+      "title": "构建系统、CI/CD 与发布包",
+      "purpose": "文档化 CMake 构建体系、依赖管理、跨平台构建流程、.github/workflows 中的持续集成流程，以及 package-definition.json 定义的发布包形态。",
+      "parent": "工程体系"
+    },
+    {
+      "title": "测试体系与回归资源",
+      "purpose": "文档化 unit_test 的 Catch2 与 CTest 单元测试体系、test 子模块的回归测试角色、suite 组织方式，以及 CI 中的测试选择逻辑。",
+      "parent": "工程体系",
+      "page_notes": [
+        {
+          "content": "必须显式区分 unit_test 与 test 子模块，分别说明它们的定位、运行方式与 CI 集成方式，避免混写为单一测试体系。"
+        }
+      ]
+    },
+    {
+      "title": "内部工具集",
+      "purpose": "文档化 tools 目录下用于资源更新、模板优化、OTA 打包、海外客户端适配、肉鸽辅助和图像处理的内部工具及其维护用途。",
+      "parent": "工程体系"
+    },
+    {
+      "title": "文档站、协议与开发指南",
+      "purpose": "文档化 docs 目录作为 VuePress 文档站的结构，串联 manual、protocol、develop、glossary 等内容域，以及它们与外部中文文档站的关系。",
+      "parent": "工程体系",
+      "page_notes": [
+        {
+          "content": "优先使用 docs 目录内部结构解释文档体系，再引用 docs.maa.plus 中文页面；不要按不同语言版本重复讲述相同主题。"
+        }
+      ]
+    },
+    {
+      "title": "仓库结构与子模块边界",
+      "purpose": "文档化顶层目录、include、3rdparty、resource、docs、src 等入口的职责分工，并明确各个子模块或边界模块在仓库中的定位。",
+      "parent": "工程体系"
+    }
+  ]
+}

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

@@ -45,8 +45,6 @@ body:
         **若待上传压缩包大于 25MB，请转而上传该压缩包同日期文件夹中的若干小压缩包**  
         **若为 MAA 闪退问题，如果 %LOCALAPPDATA%\CrashDumps 中存在 MAA.exe.dmp 文件，请一并上传**  
         若正在使用 macOS，请点击屏幕左上角的“文件”，点击“打开日志文件夹”
-      placeholder: |
-        请确认上传文件前已关闭 MAA
     validations:
       required: true
   - type: textarea

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

@@ -49,8 +49,6 @@ body:
         **请在 MAA -> 设置 -> 问题反馈中找到生成日志压缩包按钮，点击并上传压缩包**
 
         **请直接将完整的文件拖拽进来，而非自己裁切或复制的片段；若文件体积过大可压缩后再上传**
-      placeholder: |
-        请确认上传文件前已关闭 MAA
     validations:
       required: true
   - type: textarea

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

@@ -49,8 +49,6 @@ body:
         **请在 MAA -> 设置 -> 问题反馈中找到生成日志压缩包按钮，点击并上传压缩包**
 
         **请直接将完整的文件拖拽进来，而非自己裁切或复制的片段；若文件体积过大可压缩后再上传**
-      placeholder: |
-        请确认上传文件前已关闭 MAA
     validations:
       required: true
   - type: textarea

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

@@ -47,8 +47,6 @@ body:
         **If the archive to upload is larger than 25MB, please upload smaller archives from the same date folder instead.**
         **If the issue is related to MAA crashing, please upload the MAA.exe.dmp file found in %LOCALAPPDATA%\CrashDumps if it exists**
         If you are using macOS, please click the "File" option in the top-left corner of the screen, then click "Open Log Folder".
-      placeholder: |
-        Please confirm that MAA is not running before uploading files.
     validations:
       required: true
   - type: textarea

.github/scripts/sync-optional-submodules.sh

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+mode="init"
+depth=""
+declare -a paths=()
+
+while (($# > 0)); do
+    case "$1" in
+        --init)
+            mode="init"
+            shift
+            ;;
+        --remote)
+            mode="remote"
+            shift
+            ;;
+        --depth)
+            depth="$2"
+            shift 2
+            ;;
+        --)
+            shift
+            paths+=("$@")
+            break
+            ;;
+        *)
+            paths+=("$1")
+            shift
+            ;;
+    esac
+done
+
+if ((${#paths[@]} == 0)); then
+    echo "Usage: $0 [--init|--remote] [--depth N] path [path ...]" >&2
+    exit 64
+fi
+
+is_submodule_path() {
+    local path="$1"
+
+    git config -f .gitmodules --get-regexp '^submodule\..*\.path$' 2>/dev/null \
+        | awk '{ print $2 }' \
+        | grep -Fxq "$path"
+}
+
+for path in "${paths[@]}"; do
+    if ! is_submodule_path "$path"; then
+        echo "Skipping $path: not configured as a submodule in .gitmodules."
+        continue
+    fi
+
+    if [[ "$mode" == "remote" ]]; then
+        echo "Updating submodule: $path"
+        git submodule update --remote "$path"
+        continue
+    fi
+
+    if [[ -n "$depth" ]]; then
+        echo "Initializing submodule: $path (depth=$depth)"
+        git submodule update --init --depth "$depth" "$path"
+        continue
+    fi
+
+    echo "Initializing submodule: $path"
+    git submodule update --init "$path"
+done

.github/workflows/blame-ignore.yml

@@ -13,7 +13,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
           persist-credentials: false # Needed to bypass protection rules in Push changes
@@ -41,7 +41,7 @@ jobs:
 
       - name: Push changes
         if: ${{ steps.check_changes.outcome == 'failure' }}
-        uses: ad-m/github-push-action@master
+        uses: ad-m/github-push-action@881a6320fdb16eb5318c5054f31c218aec2b324c # v1.3.0
         with:
           branch: ${{ github.ref }}
           github_token: ${{ secrets.MAA_RESOURCE_SYNC }}

.github/workflows/ci-avalonia.yml

@@ -0,0 +1,201 @@
+name: Build MAAUnified (Avalonia + MaaCore Runtime)
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - ".github/workflows/ci-avalonia.yml"
+      - "3rdparty/include/**"
+      - "cmake/**"
+      - "src/MAAUnified"
+      - "src/MAAUnified/**"
+      - "src/MaaCore/**"
+      - "src/MaaUtils/**"
+      - "include/**"
+      - "tools/maadeps-download.py"
+      - "CMakeLists.txt"
+      - "CMakePresets.json"
+      - "!**/*.md"
+  push:
+    branches:
+      - dev-v2
+    paths:
+      - ".github/workflows/ci-avalonia.yml"
+      - "3rdparty/include/**"
+      - "cmake/**"
+      - "src/MAAUnified"
+      - "src/MAAUnified/**"
+      - "src/MaaCore/**"
+      - "src/MaaUtils/**"
+      - "include/**"
+      - "tools/maadeps-download.py"
+      - "CMakeLists.txt"
+      - "CMakePresets.json"
+      - "!**/*.md"
+
+jobs:
+  meta:
+    name: Resolve version tag
+    runs-on: ubuntu-latest
+    outputs:
+      tag: ${{ steps.out.outputs.tag }}
+      checkout_sha: ${{ steps.out.outputs.checkout_sha }}
+    steps:
+      - id: out
+        env:
+          CHECKOUT_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
+        run: |
+          echo "checkout_sha=${CHECKOUT_SHA}" >> "$GITHUB_OUTPUT"
+          if [[ "${GITHUB_REF}" == refs/tags/* ]]; then
+            echo "tag=${GITHUB_REF_NAME}" >> "$GITHUB_OUTPUT"
+          else
+            echo "tag=preview-${CHECKOUT_SHA::7}" >> "$GITHUB_OUTPUT"
+          fi
+
+  build:
+    name: Build ${{ matrix.name }}
+    needs: meta
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - name: windows-x64
+            os: windows-2025-vs2026
+            rid: win-x64
+            self_contained: true
+            cmake_preset: windows-publish-x64
+            maadeps_triplet: x64-windows
+          - name: linux-x64
+            os: ubuntu-latest
+            rid: linux-x64
+            self_contained: true
+            cmake_preset: linux-publish-x64
+            maadeps_triplet: x64-linux
+          - name: macos-x64
+            os: macos-latest
+            rid: osx-x64
+            self_contained: true
+            cmake_preset: macos-publish-x64
+            maadeps_triplet: x64-osx
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ needs.meta.outputs.checkout_sha }}
+
+      - name: Fetch required submodules
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --init --depth 1 src/MAAUnified src/MaaUtils
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v5
+        with:
+          dotnet-version: "10.0.x"
+
+      - name: Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Restore app
+        run: dotnet restore src/MAAUnified/App/MAAUnified.App.csproj
+
+      - name: Restore tests
+        if: matrix.name != 'macos-x64'
+        run: dotnet restore src/MAAUnified/Tests/MAAUnified.Tests.csproj
+
+      - name: Run Linux baseline consistency gate
+        if: matrix.name == 'linux-x64'
+        run: >
+          dotnet test src/MAAUnified/Tests/MAAUnified.Tests.csproj -c Release --no-restore --disable-build-servers -m:1
+          --results-directory TestResults/${{ matrix.name }}
+          --logger "trx;LogFileName=baseline-consistency.trx"
+          --filter "FullyQualifiedName~BaselineContractTests|FullyQualifiedName~BaselineCoverageTests|FullyQualifiedName~BaselineRenderSyncTests|FullyQualifiedName~ParityMatrixSyncTests"
+
+      - name: Run Linux full MAAUnified test gate
+        if: matrix.name == 'linux-x64'
+        run: >
+          dotnet test src/MAAUnified/Tests/MAAUnified.Tests.csproj -c Release --no-restore --disable-build-servers -m:1
+          --results-directory TestResults/${{ matrix.name }}
+          --logger "trx;LogFileName=full-maaunified-tests.trx"
+
+      - name: Run Windows platform capability contract gate
+        if: matrix.name == 'windows-x64'
+        run: >
+          dotnet test src/MAAUnified/Tests/MAAUnified.Tests.csproj -c Release --no-restore --disable-build-servers -m:1
+          --results-directory TestResults/${{ matrix.name }}
+          --logger "trx;LogFileName=platform-capability-contract.trx"
+          --filter "FullyQualifiedName~PlatformCapabilityContractTests"
+
+      - name: Run Windows native capability smoke gate
+        if: matrix.name == 'windows-x64'
+        run: >
+          dotnet test src/MAAUnified/Tests/MAAUnified.Tests.csproj -c Release --no-restore --disable-build-servers -m:1
+          --results-directory TestResults/${{ matrix.name }}
+          --logger "trx;LogFileName=platform-windows-native-smoke.trx"
+          --filter "FullyQualifiedName~PlatformWindowsNativeSmokeTests"
+
+      - name: Upload test result artifacts on failure
+        if: failure() && matrix.name != 'macos-x64'
+        uses: actions/upload-artifact@v7
+        with:
+          name: MAAUnified-TestResults-${{ matrix.name }}
+          path: TestResults/${{ matrix.name }}/*.trx
+          if-no-files-found: ignore
+
+      - name: Bootstrap MaaDeps
+        run: python tools/maadeps-download.py ${{ matrix.maadeps_triplet }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build MaaCore runtime
+        run: |
+          cmake --preset ${{ matrix.cmake_preset }} -DINSTALL_PYTHON=OFF -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}'
+          cmake --build --preset ${{ matrix.cmake_preset }}
+          cmake --install build --config RelWithDebInfo
+
+      - name: Publish MAAUnified app
+        run: dotnet publish src/MAAUnified/App/MAAUnified.App.csproj -c Release -r ${{ matrix.rid }} --self-contained ${{ matrix.self_contained }} -o publish
+
+      - name: Merge MaaCore runtime (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          Copy-Item install\* publish\ -Recurse -Force
+          if (!(Test-Path "publish\MaaCore.dll")) { throw "MaaCore.dll not found in publish output." }
+          if (!(Test-Path "publish\resource")) { throw "resource directory not found in publish output." }
+
+      - name: Merge MaaCore runtime (Unix)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: |
+          cp -a install/. publish/
+          if [[ "$RUNNER_OS" == "Linux" ]]; then
+            test -f publish/libMaaCore.so
+          else
+            test -f publish/libMaaCore.dylib
+          fi
+          test -d publish/resource
+
+      - name: Package (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: |
+          New-Item -ItemType Directory -Path release -Force | Out-Null
+          $name = "MAAUnified-${{ needs.meta.outputs.tag }}-${{ matrix.name }}"
+          Compress-Archive -Path publish\* -DestinationPath "release\$name.zip"
+
+      - name: Package (Unix)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: |
+          mkdir -p release
+          name="MAAUnified-${{ needs.meta.outputs.tag }}-${{ matrix.name }}"
+          tar -czf "release/${name}.tar.gz" -C publish .
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v7
+        with:
+          name: MAAUnified-${{ matrix.name }}
+          path: release/*

.github/workflows/ci.yml

@@ -42,11 +42,13 @@ jobs:
       prerelease: ${{ steps.set_pre.outputs.prerelease }}
     steps:
       - name: Show concurrency group
+        env:
+          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-v2' && format('-{0}', github.sha) || '' }}
         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-v2' && format('-{0}', github.sha) || '' }}"
+          echo "Concurrency Group: $CONCURRENCY_GROUP"
 
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
           show-progress: false
@@ -101,22 +103,21 @@ jobs:
       matrix:
         arch: [arm64, x64]
       fail-fast: false
-    runs-on: windows-latest
+    runs-on: windows-2025-vs2026
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 
       - name: Fetch submodules
-        run: |
-          git submodule update --init --depth 1 src/MaaUtils
-          git submodule update --init --depth 1 3rdparty/EmulatorExtras
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --init --depth 1 src/MaaUtils 3rdparty/EmulatorExtras
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: |
@@ -134,22 +135,27 @@ jobs:
         run: |
           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 --build build --target MAA.Updater --config RelWithDebInfo --parallel $env:NUMBER_OF_PROCESSORS
           cmake --install build --config RelWithDebInfo
 
       - name: Download MaaFramework
-        if: matrix.arch == 'x64'
         uses: robinraju/release-downloader@v1
         with:
           repository: MaaXYZ/MaaFramework
-          latest: true
-          fileName: "*win-x86_64*.zip"
+          tag: v5.9.2
+          fileName: ${{ matrix.arch == 'arm64' && '*win-aarch64*.zip' || '*win-x86_64*.zip' }}
           extract: true
           out-file-path: MaaFramework-temp
 
-      - name: Copy MaaWin32ControlUnit
-        if: matrix.arch == 'x64'
+      - name: Copy ControlUnits
         run: |
           cp MaaFramework-temp/bin/*Win32ControlUnit* install/
+          cp MaaFramework-temp/bin/*AdbControlUnit* install/
+
+      - name: Generate global.json
+        shell: bash
+        run: |
+          echo '{"sdk":{"version":"10.0.203","rollForward":"disable"}}' > global.json
 
       - name: Setup .NET SDK
         uses: actions/setup-dotnet@v5
@@ -158,7 +164,7 @@ jobs:
 
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: |
@@ -204,6 +210,7 @@ jobs:
         with:
           name: MAAComponent-DebugSymbol-win-${{ matrix.arch }}
           path: install/MAAComponent-DebugSymbol-${{ needs.meta.outputs.tag }}-win-${{ matrix.arch }}.zip
+          compression-level: 0
 
       - name: Organize install files
         shell: bash
@@ -212,6 +219,7 @@ jobs:
           rm -rf install/*.pdb
           rm -rf install/msvc-debug
           rm -rf install/*.h
+          rm -rf install/*.bak
 
           cp tools/DependencySetup_依赖库安装.bat install
 
@@ -225,6 +233,7 @@ jobs:
         with:
           name: MAA-win-${{ matrix.arch }}
           path: install/MAA-*.zip
+          compression-level: 0
 
   ubuntu:
     name: Build for Ubuntu
@@ -236,19 +245,17 @@ jobs:
       fail-fast: false
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 
       - name: Fetch submodules
-        run: |
-          git submodule update --init --depth 1 src/MaaUtils
-          git submodule update --init --depth 1 3rdparty/EmulatorExtras
-          git submodule update --init --depth 1 src/maa-cli
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --init --depth 1 src/MaaUtils 3rdparty/EmulatorExtras src/maa-cli
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: ./src/MaaUtils/MaaDeps
@@ -269,6 +276,19 @@ jobs:
         env:
           CLICOLOR_FORCE: 1
 
+      - name: Download MaaFramework
+        uses: robinraju/release-downloader@v1
+        with:
+          repository: MaaXYZ/MaaFramework
+          latest: true
+          fileName: '*linux-${{ matrix.arch }}*.zip'
+          extract: true
+          out-file-path: MaaFramework-temp
+
+      - name: Copy ControlUnits
+        run: |
+          cp MaaFramework-temp/bin/*AdbControlUnit* install/
+
       - name: Setup cross compile toolchains for CLI
         uses: ./src/maa-cli/.github/actions/setup
         with:
@@ -291,7 +311,7 @@ jobs:
           mkdir -pv release
           mkdir -pv Maa.AppDir/usr/share/maa
           cp -r install/* Maa.AppDir/usr/share/maa/
-          wget -c https://raw.githubusercontent.com/MaaAssistantArknights/design/main/logo/maa-logo_512x512.png -O Maa.AppDir/maa.png
+          wget -c https://raw.githubusercontent.com/MaaAssistantArknights/design/main/v2/icons/maa-logo_512x512.png -O Maa.AppDir/maa.png
           mkdir -pv Maa.AppDir/usr/share/icons/hicolor/512x512/apps/
           cp -v Maa.AppDir/maa.png Maa.AppDir/usr/share/icons/hicolor/512x512/apps/
           cp -v appimage-maa Maa.AppDir/usr/share/maa/maa
@@ -332,6 +352,80 @@ jobs:
           path: |
             release/*.AppImage
             release/*.tar.gz
+          compression-level: 0
+
+  android:
+    name: Build for Android
+    needs: meta
+    runs-on: macos-26
+    strategy:
+      matrix:
+        arch: [arm64, x64]
+      fail-fast: false
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+        with:
+          show-progress: false
+
+      - name: Fetch submodules
+        run: |
+          git submodule update --init --depth 1 src/MaaUtils
+
+      - name: Cache MaaDeps
+        id: cache-maadeps
+        uses: actions/cache@v6
+        continue-on-error: true
+        with:
+          path: ./src/MaaUtils/MaaDeps
+          key: ${{ runner.os }}-${{ matrix.arch }}-android-maadeps-${{ hashFiles('tools/maadeps-download.py') }}
+
+      - name: Bootstrap MaaDeps
+        if: steps.cache-maadeps.outputs.cache-hit != 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          python3 tools/maadeps-download.py ${{ matrix.arch }}-android
+
+      - name: Setup Android NDK
+        id: setup-ndk
+        uses: nttld/setup-ndk@v1
+        with:
+          ndk-version: r29
+
+      - name: Configure, build and install
+        run: |
+          cmake -B build --preset 'android-publish-${{ matrix.arch }}' \
+            -DCMAKE_TOOLCHAIN_FILE=${{ steps.setup-ndk.outputs.ndk-path }}/build/cmake/android.toolchain.cmake \
+            -DMAA_HASH_VERSION='${{ needs.meta.outputs.tag }}'
+          cmake --build build --parallel $(sysctl -n hw.logicalcpu)
+          cmake --install build --prefix install
+
+      - name: Download MaaFramework
+        uses: robinraju/release-downloader@v1
+        with:
+          repository: MaaXYZ/MaaFramework
+          latest: true
+          fileName: "*android-${{ matrix.arch == 'arm64' && 'aarch64' || 'x86_64' }}*.zip"
+          extract: true
+          out-file-path: MaaFramework-temp
+
+      - name: Copy MaaAndroidNativeControlUnit
+        run: |
+          cp MaaFramework-temp/bin/libMaaAndroidNativeControlUnit.so install/
+
+      - name: Tar files
+        run: |
+          cd install
+          tar czvf $GITHUB_WORKSPACE/MAAComponent-${{ needs.meta.outputs.tag }}-android-${{ matrix.arch }}.tar.gz .
+
+      - name: Upload MAA to GitHub
+        uses: actions/upload-artifact@v7
+        with:
+          name: MAAComponent-android-${{ matrix.arch }}
+          path: MAAComponent-*.tar.gz
+          compression-level: 0
 
   macOS-Core:
     name: Build Core for macOS
@@ -343,13 +437,13 @@ jobs:
       fail-fast: false
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 
       - name: Fetch submodules
-        run: |
-          git submodule update --init --depth 1 src/MaaUtils
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --init --depth 1 src/MaaUtils
 
       # ninja 1.13.1 is already installed and up-to-date.
       # - name: Install dependencies
@@ -358,7 +452,7 @@ jobs:
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: ./src/MaaUtils/MaaDeps
@@ -376,6 +470,19 @@ jobs:
           cmake --build --preset ${{ matrix.arch == 'x86_64' && 'macos-publish-x64' || 'macos-publish-arm64' }} --parallel $(sysctl -n hw.logicalcpu)
           cmake --install build --config RelWithDebInfo
 
+      - name: Download MaaFramework
+        uses: robinraju/release-downloader@v1
+        with:
+          repository: MaaXYZ/MaaFramework
+          latest: true
+          fileName: ${{ matrix.arch == 'x86_64' && '*macos-x86_64*.zip' || '*macos-aarch64*.zip' }}
+          extract: true
+          out-file-path: MaaFramework-temp
+
+      - name: Copy ControlUnits
+        run: |
+          cp MaaFramework-temp/bin/*AdbControlUnit* install/
+
       - name: Upload MAA to GitHub
         uses: actions/upload-artifact@v7
         with:
@@ -388,7 +495,7 @@ jobs:
     runs-on: macos-26
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 
@@ -416,14 +523,14 @@ jobs:
 
       - name: Install Developer ID certificate
         if: startsWith(github.ref, 'refs/tags/v')
-        uses: apple-actions/import-codesign-certs@v6
+        uses: apple-actions/import-codesign-certs@v7
         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@v5
+        uses: apple-actions/download-provisioning-profiles@v6
         with:
           bundle-id: "com.hguandl.MeoAsstMac"
           issuer-id: ${{ secrets.HGUANDL_APPSTORE_ISSUER }}
@@ -459,6 +566,8 @@ jobs:
         with:
           name: MAA-macos-runtime-universal
           path: runtime/MAA-${{ needs.meta.outputs.tag }}-macos-runtime-universal.zip
+          compression-level: 0
+
 
       - name: Build XCFramework
         run: |
@@ -545,7 +654,7 @@ jobs:
   release:
     name: Publish Release
     if: startsWith(github.ref, 'refs/tags/v')
-    needs: [meta, windows, ubuntu, macOS-Core, macOS-GUI]
+    needs: [meta, windows, ubuntu, android, macOS-Core, macOS-GUI]
     runs-on: ubuntu-latest
     steps:
       - name: Download MAA from GitHub
@@ -562,7 +671,7 @@ jobs:
           find . -type f | while read f; do mv -fvt . $f; done
 
       - name: Publish release to GitHub
-        uses: softprops/action-gh-release@v2.6.1
+        uses: softprops/action-gh-release@v3.0.1
         with:
           body_path: CHANGELOG.md
           files: |
@@ -585,11 +694,6 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.MISTEOWORKFLOW }}
 
-      - name: Create issue on failure
-        if: failure()
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-issue"
           title: "Errors occured during release ${{ needs.meta.outputs.tag }}"
           body: |
             ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}

.github/workflows/discord-release-notification.yml

@@ -42,27 +42,31 @@ jobs:
           URL="${{ steps.release.outputs.url }}"
 
           BASE_URL="https://github.com/${{ github.repository }}/releases/download/${TAG}"
-          WIN_URL="${BASE_URL}/MAA-${TAG}-win-x64.zip"
+          WIN64_URL="${BASE_URL}/MAA-${TAG}-win-x64.zip"
+          WINARM_URL="${BASE_URL}/MAA-${TAG}-win-arm64.zip"
           MAC_URL="${BASE_URL}/MAA-${TAG}-macos-universal.dmg"
-          LIN_URL="${BASE_URL}/MAA-${TAG}-linux-amd64.tar.gz"
+          LIN64_URL="${BASE_URL}/MAA-${TAG}-linux-x86_64.tar.gz"
+          LINARM_URL="${BASE_URL}/MAA-${TAG}-linux-aarch64.tar.gz"
 
-          DESCRIPTION=$(printf 'Read the full release note [here](%s).\n\nOpen or reopen your MAA client to get automatic updates.\nOr, download `MAA %s` for your platform by clicking the buttons below.' "$URL" "$TAG")
+          DESCRIPTION=$(printf 'Read the full release note [here](%s).\n\nReopen your MAA client to get automatic updates.\nDownload MAA `%s` for your platform below.' "$URL" "$TAG")
 
           PAYLOAD=$(jq -n \
             --arg tag "$TAG" \
             --arg description "$DESCRIPTION" \
-            --arg win_url "$WIN_URL" \
+            --arg win64_url "$WIN64_URL" \
+            --arg winarm_url "$WINARM_URL" \
             --arg mac_url "$MAC_URL" \
-            --arg lin_url "$LIN_URL" \
+            --arg lin64_url "$LIN64_URL" \
+            --arg linarm_url "$LINARM_URL" \
             '{
               embeds: [{
                 title: ("🎉 New MAA Release:  " + $tag),
                 description: $description,
                 color: 10246582,
                 fields: [
-                  { name: "Windows (x64)", value: ("[↗ Download](" + $win_url + ")"), inline: true },
-                  { name: "macOS (Universal, dmg)", value: ("[↗ Download](" + $mac_url + ")"), inline: true },
-                  { name: "Linux (amd64, tar.gz)", value: ("[↗ Download](" + $lin_url + ")"), inline: true }
+                  { name: "Windows", value: ("[x64](" + $win64_url + ") ❘ [ARM](" + $winarm_url + ")"), inline: true },
+                  { name: "macOS", value: ("[Universal](" + $mac_url + ")"), inline: true },
+                  { name: "Linux", value: ("[x64](" + $lin64_url + ") ❘ [ARM](" + $linarm_url + ")"), inline: true }
                 ]
               }]
             }')

.github/workflows/issue-ai-analysis.yml

@@ -13,7 +13,7 @@ on:
         type: number
 
 jobs:
-  copilot-analysis:
+  ai-analysis:
     if: |
       (github.event_name == 'issues' && github.event.action == 'opened') ||
       github.event_name == 'workflow_dispatch' ||
@@ -22,44 +22,41 @@ jobs:
        contains(github.event.comment.body, '@MaaArknightsBot') &&
        github.event.comment.user.type != 'Bot')
     runs-on: ubuntu-latest
+    timeout-minutes: 30
     permissions:
       contents: read
       issues: write
     steps:
-      # 这个 action 只负责编排，分析质量仍依赖配套的 issue/log analysis skill。
+      # 分析质量仍依赖配套的 issue/log analysis skill。
       # 详细使用文档：https://github.com/MistEO/ai-issue-analysis
-      # 最佳实践参考：
-      # - https://github.com/MaaEnd/MaaEnd/blob/v2/.claude/skills/maaend-issue-log-analysis/SKILL.md
-      # - https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev-v2/.claude/skills/maa-issue-log-analysis/SKILL.md
       - name: Analyze issue with AI
         id: analysis
-        uses: Misteo/ai-issue-analysis@main
+        continue-on-error: true
+        uses: MistEO/ai-issue-analysis@main
         with:
+          agent: ${{ secrets.BOT_AI_AGENT }}
+          api-key: ${{ secrets.BOT_AI_API_KEY }}
+          api-base-url: ${{ secrets.BOT_AI_API_BASE_URL }}
+          model: ${{ secrets.BOT_AI_MODEL }}
           github-token: ${{ secrets.MAA_BOT_TOKEN }}
-          copilot-github-token: ${{ secrets.COPILOT_GITHUB_TOKEN }}
           bot-name: '@MaaArknightsBot'
           initial-comment-body: |
             🤖 **MaaBot 正在分析该 Issue...**  
             
             感谢您的反馈！AI 正在自动分析该问题，预计耗时约 10 分钟。
           prompt-template: |
-            分析 GitHub Issue {{issue_number}}。把最终结论写到 {{copilot_answer_file}}。
+            严格按照 .claude/skills/maa-issue-log-analysis/SKILL.md 中的规则，分析 GitHub Issue {{issue_number}}。把最终结论写到 {{answer_file}}。
           extra-comment-content: |
             <!-- Skip all labels -->
 
       - name: 查看完整输入输出
         if: always()
         env:
-          ANALYSIS_PROMPT: ${{ steps.analysis.outputs.analysis-prompt }}
           ISSUE_NUMBER: ${{ steps.analysis.outputs.issue-number }}
           COMMENT_ID: ${{ steps.analysis.outputs.comment-id }}
           COMMENT_URL: ${{ steps.analysis.outputs.comment-url }}
-          COPILOT_OUTPUT: ${{ steps.analysis.outputs.copilot-output }}
-          FINAL_CONCLUSION: ${{ steps.analysis.outputs.final-conclusion }}
         run: |
-          printf '%s\n' "$ANALYSIS_PROMPT"
           echo "issue_number=$ISSUE_NUMBER"
           echo "comment_id=$COMMENT_ID"
           echo "comment_url=$COMMENT_URL"
-          printf '%s\n' "$COPILOT_OUTPUT"
-          printf '%s\n' "$FINAL_CONCLUSION"
+          echo "(Full agent-output and final-conclusion are available in the uploaded artifacts)"

.github/workflows/issue-checkbox-checker.yml

@@ -14,7 +14,7 @@ jobs:
     steps:
       - name: Check for duplicate issues in last hour
         id: duplicate-check
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           script: |
             const oneHourAgo = new Date(Date.now() - 60 * 60 * 1000);
@@ -66,7 +66,7 @@ jobs:
 
       - name: Check for issue checkboxes
         id: unread-checkbox-check
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           script: |
             // 找不到###就算了
@@ -89,7 +89,7 @@ jobs:
 
       - name: Close low-quality issue
         if: steps.unread-checkbox-check.outputs.result == 'true'
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           script: |
             await github.rest.issues.update({
@@ -116,7 +116,7 @@ jobs:
 
       - name: Fold checkboxes
         if: steps.unread-checkbox-check.outputs.result == 'false'
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           script: |
             const originalBody = context.payload.issue.body;

.github/workflows/markdown-checker.yml

@@ -31,12 +31,12 @@ jobs:
       GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 
       - name: Cache lychee responses
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: .lycheecache

.github/workflows/optimize-templates.yml

@@ -44,7 +44,7 @@ jobs:
 
       - name: Checkout repository
         if: steps.check_push.outputs.is_pr != 'True'
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
           persist-credentials: false
@@ -104,7 +104,7 @@ jobs:
 
       - name: Push changes
         if: steps.check_push.outputs.is_pr != 'True' && steps.commit_changes.outputs.have_commits == 'True' && github.repository_owner == 'MaaAssistantArknights'
-        uses: ad-m/github-push-action@master
+        uses: ad-m/github-push-action@881a6320fdb16eb5318c5054f31c218aec2b324c # v1.3.0
         with:
           github_token: ${{ secrets.MAA_RESOURCE_SYNC }}
           branch: ${{ github.ref }}

.github/workflows/pr-auto-tag.yml

@@ -21,7 +21,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
           token: ${{ secrets.MAARELEASE_RELEASE }}
@@ -33,21 +33,29 @@ jobs:
 
       - name: Determine tag name
         id: extract_tag
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          PR_TITLE: ${{ github.event.pull_request.title }}
+          INPUT_TAG: ${{ inputs.tag }}
         run: |
-          if ${{ github.event_name != 'workflow_dispatch' }}; then
-            tag_name=$(echo "${{ github.event.pull_request.title }}" | sed -E 's/(Release|release)//' | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')
+          if [ "$EVENT_NAME" != "workflow_dispatch" ]; then
+            tag_name=$(printf '%s' "$PR_TITLE" | sed -E 's/(Release|release)//' | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')
             echo "tag_name=$tag_name" >> $GITHUB_OUTPUT
           else
-            echo "tag_name=${{ inputs.tag }}" >> $GITHUB_OUTPUT
+            echo "tag_name=$INPUT_TAG" >> $GITHUB_OUTPUT
           fi
 
       - name: Create and push release tag
+        env:
+          TAG_NAME: ${{ steps.extract_tag.outputs.tag_name }}
         run: |
-          git tag -a "${{ steps.extract_tag.outputs.tag_name }}" -m "${{ steps.extract_tag.outputs.tag_name }}" -f
-          git push origin "${{ steps.extract_tag.outputs.tag_name }}"
+          git tag -a "$TAG_NAME" -m "$TAG_NAME" -f
+          git push origin "$TAG_NAME"
 
       - name: Merge tag into dev-v2 and push
+        env:
+          TAG_NAME: ${{ steps.extract_tag.outputs.tag_name }}
         run: |
           git switch dev-v2
-          git merge "${{ steps.extract_tag.outputs.tag_name }}"
+          git merge "$TAG_NAME"
           git push origin dev-v2

.github/workflows/pr-checker.yml

@@ -10,26 +10,8 @@ jobs:
     if: ${{ !github.event.pull_request.merged && github.base_ref != 'master-v2' }}
     runs-on: ubuntu-latest
     steps:
-      - name: Clean up previous comment
-        uses: actions/github-script@v8
-        with:
-          script: |
-            const { data: comments } = await github.rest.issues.listComments({
-              owner: context.repo.owner,
-              repo: context.repo.repo,
-              issue_number: context.payload.pull_request.number
-            });
-
-            const previousComment = comments.find(comment => comment.user.login === 'github-actions[bot]' && comment.body.includes('invalid commit(s)'));
-            if (previousComment) {
-              await github.rest.issues.deleteComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                comment_id: previousComment.id
-              });
-            }
       - name: Check commits
-        uses: actions/github-script@v8
+        uses: actions/github-script@v9
         with:
           script: |
             const { data: commits } = await github.rest.pulls.listCommits({
@@ -40,20 +22,59 @@ jobs:
             });
 
             const regex = /^((build|chore|ci|docs?|feat!?|fix|perf|refactor|rft|style|test|i18n|typo|debug)[\:\.\(\,]|[Rr]evert|[Rr]elease|[Rr]eapply)/;
-            const invalidCommits = commits.filter(commit => !regex.test(commit.commit.message) || commit.parents.length > 1);
+            const badTitleCommits = commits.filter(commit => !regex.test(commit.commit.message) && commit.parents.length <= 1);
+            const mergeCommits = commits.filter(commit => commit.parents.length > 1);
+            const allInvalid = [...badTitleCommits, ...mergeCommits];
 
-            console.log(`Checked ${commits.length} commit(s)`);
+            console.log(`Checked ${commits.length} commit(s), ${badTitleCommits.length} bad title(s), ${mergeCommits.length} merge commit(s)`);
 
-            if (invalidCommits.length > 0) {
-              const invalidCommitNames = invalidCommits.map(commit => commit.commit.message);
-              const invalidCommitInfoList = invalidCommits.map(commit => `- ${commit.commit.message.split("\n")[0]} [\`${commit.sha.substring(0, 7)}\`](${commit.html_url})`).join("\n");
+            const { data: comments } = await github.rest.issues.listComments({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number
+            });
 
-              github.rest.issues.createComment({
-                owner: context.repo.owner,
-                repo: context.repo.repo,
-                issue_number: context.payload.pull_request.number,
-                body: `## ⚠️ Found ${invalidCommits.length} invalid commit(s):\n\n${invalidCommitInfoList}\n\n---\nPlease follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) format, and **DO NOT** use merge commits.\n请遵循 [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) 格式，以及**不要**使用Merge Commit（修改 Commit Message 无法绕过检测）。`
-              });
+            const previousComment = comments.find(comment => comment.user.login === 'github-actions[bot]' && comment.body.includes('invalid commit(s)'));
 
-              core.setFailed(`Found ${invalidCommits.length} invalid commit(s):\n${invalidCommitNames.join("\n-------------------\n")}`);
+            if (allInvalid.length > 0) {
+              const formatList = (list) => list.map(commit => `- ${commit.commit.message.split("\n")[0]} [\`${commit.sha.substring(0, 7)}\`](${commit.html_url})`).join("\n");
+
+              let bodySections = [];
+              if (badTitleCommits.length > 0) {
+                bodySections.push(`### 不合规提交名 | Invalid Commit Title(s):\n\n${formatList(badTitleCommits)}`);
+              }
+              if (mergeCommits.length > 0) {
+                bodySections.push(`### 不应使用 Merge Commit | Merge Commit(s) Detected:\n\n${formatList(mergeCommits)}`);
+              }
+
+              const newBody = `## ⚠️ 发现 ${allInvalid.length} 个不合规提交 | Found ${allInvalid.length} invalid commit(s):\n\n${bodySections.join("\n\n")}\n\n---\n请遵循 [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) 格式，以及**不要**使用Merge Commit（修改 Commit Message 无法绕过检测）。\nPlease follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) format, and **DO NOT** use merge commits.`;
+
+              if (previousComment && previousComment.body === newBody) {
+                console.log("Invalid commits unchanged, skipping comment update");
+              } else {
+                if (previousComment) {
+                  await github.rest.issues.deleteComment({
+                    owner: context.repo.owner,
+                    repo: context.repo.repo,
+                    comment_id: previousComment.id
+                  });
+                }
+                await github.rest.issues.createComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  issue_number: context.payload.pull_request.number,
+                  body: newBody
+                });
+              }
+
+              const allInvalidNames = allInvalid.map(commit => commit.commit.message);
+              core.setFailed(`Found ${allInvalid.length} invalid commit(s):\n${allInvalidNames.join("\n-------------------\n")}`);
+            } else {
+              if (previousComment) {
+                await github.rest.issues.deleteComment({
+                  owner: context.repo.owner,
+                  repo: context.repo.repo,
+                  comment_id: previousComment.id
+                });
+              }
             }

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

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           fetch-depth: 0
           show-progress: false
@@ -25,7 +25,7 @@ jobs:
 
       - name: Commit and push changes
         if: steps.pre-commit.outcome == 'failure' && github.repository_owner == 'MaaAssistantArknights'
-        uses: actions-js/push@master
+        uses: actions-js/push@5a7cbd780d82c0c937b5977586e641b2fd94acc5 # master as of 2026-05-06
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           message: "chore: Auto update by pre-commit hooks

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

@@ -28,7 +28,7 @@ jobs:
   build-win-nightly:
     name: Build Nightly for Windows
     if: github.repository_owner == 'MaaAssistantArknights'
-    runs-on: windows-latest
+    runs-on: windows-2025-vs2026
     strategy:
       matrix:
         arch: [x64]
@@ -40,7 +40,7 @@ jobs:
       changelog: ${{ steps.read_changelog.outputs.content }}
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           # repository: 'MaaAssistantArknights/MaaAssistantArknights'
           #ref: ${{ inputs.ref }}
@@ -52,9 +52,8 @@ jobs:
           git fetch --depth=250 --tags
 
       - name: Fetch submodules
-        run: |
-          git submodule update --init --depth 1 src/MaaUtils
-          git submodule update --init --depth 1 3rdparty/EmulatorExtras
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --init --depth 1 src/MaaUtils 3rdparty/EmulatorExtras
 
       - name: Checkout ref (if provided)
         if: inputs.ref != ''
@@ -171,7 +170,7 @@ jobs:
 
       - name: Cache MaaDeps
         id: cache-maadeps
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: |
@@ -189,6 +188,7 @@ jobs:
         run: |
           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 --build build --target MAA.Updater --config RelWithDebInfo --parallel $env:NUMBER_OF_PROCESSORS
           cmake --install build --config RelWithDebInfo
 
       - name: Download MaaFramework
@@ -196,7 +196,7 @@ jobs:
         uses: robinraju/release-downloader@v1
         with:
           repository: MaaXYZ/MaaFramework
-          latest: true
+          tag: v5.9.2
           fileName: "*win-x86_64*.zip"
           extract: true
           out-file-path: MaaFramework-temp
@@ -206,6 +206,11 @@ jobs:
         run: |
           cp MaaFramework-temp/bin/*Win32ControlUnit* install/
 
+      - name: Generate global.json
+        shell: bash
+        run: |
+          echo '{"sdk":{"version":"10.0.203","rollForward":"disable"}}' > global.json
+
       - name: Setup .NET SDK
         uses: actions/setup-dotnet@v5
         with:
@@ -213,7 +218,7 @@ jobs:
 
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: |
@@ -293,7 +298,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout MaaRelease
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           repository: ${{ format('{0}/{1}', github.repository_owner, 'MaaRelease') }}
           fetch-depth: 0
@@ -324,7 +329,7 @@ jobs:
           echo ${{ needs.build-win-nightly.outputs.tag }}
 
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           path: MaaAssistantArknights
           token: ${{ secrets.MAARELEASE_RELEASE }}

.github/workflows/release-ota.yml

@@ -26,7 +26,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout MaaRelease
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
           repository: ${{ format('{0}/{1}', github.repository_owner, 'MaaRelease') }}
@@ -102,7 +102,7 @@ jobs:
           path: ./MaaReleaseConfig
 
       - name: Checkout MaaRelease
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
           repository: ${{ format('{0}/{1}', github.repository_owner, 'MaaRelease') }}
@@ -111,7 +111,7 @@ jobs:
           token: ${{ secrets.MAARELEASE_RELEASE }}
 
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
           path: MaaAssistantArknights
@@ -139,15 +139,6 @@ jobs:
           prerelease: ${{ fromJSON(needs.create-tag.outputs.prerelease) }}
           overwrite: true
 
-      - name: Create issue on failure
-        if: failure()
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-issue"
-          title: "Failed to make OTA release for Windows"
-          body: |
-            ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-
   make-ota-mac:
     name: Build and Upload OTA for macOS
     needs: create-tag
@@ -192,15 +183,6 @@ jobs:
           prerelease: ${{ fromJSON(needs.create-tag.outputs.prerelease) }}
           overwrite: true
 
-      - name: Create issue on failure
-        if: failure()
-        uses: actions-cool/issues-helper@v3
-        with:
-          actions: "create-issue"
-          title: "Failed to make OTA release for macOS"
-          body: |
-            ${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}
-
   release:
     name: Publish to Release Mirrors
     needs:

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

@@ -113,23 +113,58 @@ jobs:
 
     env:
       RELEASE_TAG: ${{ needs.meta.outputs.RELEASE_TAG }}
+      WINGET_CREATE_GITHUB_TOKEN: ${{ secrets.MAABOT_WINGET_TOKEN }}
+      WINGET_CREATE_VERSION: 'v1.12.8.0'
+      WINGET_CREATE_SHA256: '8BD738851B524885410112678E3771B341C5C716DE60FBBECB88AB0A363ED85D'
 
     steps:
       - name: Upload MAA to WinGet
-        uses: vedantmgoyal9/winget-releaser@main
-        with:
-          identifier: MaaAssistantArknights.MaaAssistantArknights
-          version: ""
-          installers-regex: "-win-"
-          max-versions-to-keep: 0
-          release-tag: ${{ env.RELEASE_TAG }}
-          fork-user: MaaAssistantArknights
-          token: ${{ secrets.MAABOT_WINGET_TOKEN }}
+        shell: pwsh
+        run: |
+          $ErrorActionPreference = 'Stop'
+          $RELEASE_TAG = "${{ env.RELEASE_TAG }}"
+
+          # Fetch the release assets from GitHub Releases API and resolve actual download URLs
+          $headers = @{
+            Accept                 = "application/vnd.github+json"
+            "X-GitHub-Api-Version" = "2026-03-10"
+          }
+
+          if ($env:WINGET_CREATE_GITHUB_TOKEN) {
+            $headers.Authorization = "Bearer $env:WINGET_CREATE_GITHUB_TOKEN"
+          }
+
+          $release = Invoke-RestMethod `
+            -Uri "https://api.github.com/repos/MaaAssistantArknights/MaaAssistantArknights/releases/tags/$RELEASE_TAG" `
+            -Headers $headers
+
+          $URL_x64 = $release.assets | Where-Object { $_.name -match "-win-x64.zip$" } | Select-Object -First 1 -ExpandProperty browser_download_url
+          $URL_arm64 = $release.assets | Where-Object { $_.name -match "-win-arm64.zip$" } | Select-Object -First 1 -ExpandProperty browser_download_url
+
+          if (-not $URL_x64 -or -not $URL_arm64) {
+            Write-Error "Failed to resolve release assets from GitHub API for tag '$RELEASE_TAG'."
+            exit 1
+          }
+
+          # Download winget-create
+          curl.exe -JLO "https://github.com/microsoft/winget-create/releases/download/$env:WINGET_CREATE_VERSION/wingetcreate.exe"
+
+          # Verify the hash of wingetcreate.exe
+          if ((Get-FileHash wingetcreate.exe).Hash -ne $env:WINGET_CREATE_SHA256) {
+            Write-Error "wingetcreate.exe hash does not match expected value. Aborting."
+            exit 1
+          }
+
+          # Update the package using wingetcreate
+          .\wingetcreate.exe update MaaAssistantArknights.MaaAssistantArknights `
+            --version $RELEASE_TAG.TrimStart('v') `
+            --urls "$URL_x64|x64" "$URL_arm64|arm64" `
+            --submit
 
   maa_cos:
     name: Upload to MAA COS
     needs: meta
-    if: ${{ github.event.inputs.maa_cos == 'true' && !contains(needs.meta.outputs.RELEASE_TAG, '-') }}
+    if: false
     runs-on: ubuntu-latest
     continue-on-error: true
     env:
@@ -145,9 +180,9 @@ jobs:
           token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Upload to COS
-        uses: zkqiang/tencent-cos-action@v0.1.0
+        uses: zkqiang/tencent-cos-action@v1.0.0
         with:
-          args: upload -rs downloads/${{ env.FILENAME }} MAA/${{ env.FILENAME }}
+          args: sync -r downloads/${{ env.FILENAME }} cos://default/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 }}

.github/workflows/release-preparation.yml

@@ -7,93 +7,127 @@ on:
       - reopened
       - ready_for_review
   workflow_dispatch:
+    inputs:
+      pr_number:
+        description: 'Release PR number for changelog generation'
+        required: false
+        type: number
 
 jobs:
   generate-changelog:
     name: Generate Changelog
-    # startsWith 表达式不区分大小写
-    if: github.event.pull_request.draft == false && startsWith(github.event.pull_request.title, 'Release v')
+    if: |
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.pr_number != '') ||
+      (github.event.pull_request.head.repo.full_name == github.repository &&
+       github.event.pull_request.draft == false &&
+       startsWith(github.event.pull_request.title, 'Release v'))
     runs-on: ubuntu-latest
+    timeout-minutes: 30
+    permissions:
+      contents: write
+      pull-requests: write
+      issues: write
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v6
+      - name: Checkout dev-v2 with full history
+        uses: actions/checkout@v4
         with:
+          ref: dev-v2
           fetch-depth: 0
           show-progress: false
 
-      - name: Extract release information
-        id: extract_tag
+      - name: Extract version from Release PR
+        id: version
         env:
-          PR_BODY: ${{ format('{0}/{1}', runner.temp, 'output' ) }}
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          PR_NUMBER: ${{ github.event.pull_request.number || github.event.inputs.pr_number }}
+          PR_TITLE: ${{ github.event.pull_request.title }}
         run: |
-          tag_name=$(echo "${{ github.event.pull_request.title }}" | sed -E 's/(Release|release)//' | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')
-          echo "tag_name=$tag_name" >> $GITHUB_OUTPUT
+          title="${PR_TITLE:-$(gh pr view "$PR_NUMBER" --json title -q .title)}"
+          version=$(echo "$title" | sed -E 's/[Rr]elease\s*//')
+          echo "version=$version" >> "$GITHUB_OUTPUT"
+          echo "Release version: $version"
 
-          pr_title="docs: Auto Update Changelogs of "$tag_name
-          echo "pr_title=$pr_title" >> $GITHUB_OUTPUT
+      - name: Generate changelog with AI
+        id: analysis
+        continue-on-error: true
+        uses: MistEO/ai-issue-analysis@main
+        with:
+          agent: ${{ secrets.BOT_AI_AGENT }}
+          api-key: ${{ secrets.BOT_AI_API_KEY }}
+          api-base-url: ${{ secrets.BOT_AI_API_BASE_URL }}
+          model: ${{ secrets.BOT_AI_MODEL }}
+          github-token: ${{ secrets.MAA_BOT_TOKEN }}
+          issue-number: ${{ github.event.pull_request.number || github.event.inputs.pr_number }}
+          checkout-repository: false
+          initial-comment-body: |
+            🤖 **AI 正在生成 Changelog...**
 
-          latest_stable_tag=$(git tag -l 'v*' | grep -v '-' | sort -V | tail -n 1) # 上一个 stable 版本
-          newest_tag=$(git describe --tags --match "v*" --abbrev=0) # 最新版本
-          echo "latest_stable_tag=$latest_stable_tag" >> $GITHUB_OUTPUT
-          echo "newest_tag=$newest_tag" >> $GITHUB_OUTPUT
+            正在根据提交记录自动生成 Changelog，预计耗时约 10 分钟。
+          prompt-template: |
+            你是 MAA 项目的 Changelog 生成专员。
 
-          if [[ $tag_name == *-* ]]; then # 判断新版本是否为 beta 版本
-            latest=$newest_tag            # 若是，则将 latest 参数设置为最新版本
-          else
-            latest=$latest_stable_tag     # 若否，则设置为上一个 stable 版本
+            当前 Release PR 编号为 #{{issue_number}}（仓库 {{repository}}），请从该 PR 标题中提取目标版本号。
+            严格按照 .claude/skills/changelog/SKILL.md 中的规则，分析 git 提交记录（tag 间的 commit 及其 diff）和现有 CHANGELOG.md，
+            生成完整的新版本 Changelog Markdown 并写到 {{answer_file}}。
+
+            {{answer_file}} 的内容应当是可以直接替换 CHANGELOG.md 整个文件的完整内容（包含新版本和所有历史版本）。
+          details-summary: 点击此处展开生成过程
+
+      - name: Write CHANGELOG.md from AI output
+        if: steps.analysis.outcome == 'success'
+        run: |
+          if [ ! -f answer.md ] || [ ! -s answer.md ]; then
+            echo "::error::answer.md not found or empty, cannot update CHANGELOG.md"
+            exit 1
           fi
 
-          echo "latest=$latest" >> $GITHUB_OUTPUT
+          cp answer.md CHANGELOG.md
+          echo "CHANGELOG.md updated from AI output ($(wc -l < CHANGELOG.md) lines)"
 
-          cat $GITHUB_OUTPUT
-
-          echo '======='
-
-          echo 'Target PR: ${{ github.event.pull_request.html_url }}' >> $PR_BODY
-          echo '' >> $PR_BODY
-          echo '<details><summary>Debug information</summary>' >> $PR_BODY
-          echo '' >> $PR_BODY
-          echo '```' >> $PR_BODY
-          sed 's/=/: /1' $GITHUB_OUTPUT >> $PR_BODY
-          echo '```' >> $PR_BODY
-          echo '' >> $PR_BODY
-          echo '</details>' >> $PR_BODY
-
-          cat $PR_BODY
-
-      - name: Generate changelog
-        run: |
-          git switch dev-v2
-          python3 tools/ChangelogGenerator/changelog_generator.py --tag "${{ steps.extract_tag.outputs.tag_name }}" --latest "${{ steps.extract_tag.outputs.latest }}"
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-
-      - name: Commit changes
-        run: |
-          git status
-
-          git config user.name "$GITHUB_ACTOR"
-          git config user.email "$GITHUB_ACTOR@users.noreply.github.com"
-          git add .
-
-          commit_msg="docs: Auto Generate Changelog of Release ""${{ steps.extract_tag.outputs.tag_name }}"
-          git commit -m "$commit_msg"
+          if git diff --quiet CHANGELOG.md 2>/dev/null; then
+            echo "::warning::AI output is identical to existing CHANGELOG.md, no PR will be created"
+          else
+            echo "Changes detected:"
+            git diff --stat CHANGELOG.md
+          fi
 
       - name: Create changelog PR
+        if: steps.analysis.outcome == 'success'
         uses: peter-evans/create-pull-request@v8
         with:
-          sign-commits: true
           token: ${{ secrets.GITHUB_TOKEN }}
-          title: ${{ steps.extract_tag.outputs.pr_title }}
-          body-path: ${{ format('{0}/{1}', runner.temp, 'output' ) }}
-          base: "dev-v2"
-          branch: "changelog"
+          commit-message: "docs: Auto Generate Changelog of Release ${{ steps.version.outputs.version }}"
+          sign-commits: true
+          title: "docs: Auto Update Changelogs of ${{ steps.version.outputs.version }}"
+          body: |
+            Auto-generated changelog for **${{ steps.version.outputs.version }}**.
+
+            Target Release PR: #${{ github.event.pull_request.number || github.event.inputs.pr_number }}
+          base: dev-v2
+          branch: changelog
           delete-branch: true
+          add-paths: CHANGELOG.md
           reviewers: |
             AnnAngela
           assignees: |
             AnnAngela
 
+      - name: Show outputs
+        if: always()
+        env:
+          COMMENT_URL: ${{ steps.analysis.outputs.comment-url }}
+        run: |
+          echo "comment_url=$COMMENT_URL"
+          echo "(Full agent-output and final-conclusion are available in the uploaded artifacts)"
+
+  assign-release-reviewers:
+    name: Assign Reviewers to Release PR
+    if: github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.draft == false && startsWith(github.event.pull_request.title, 'Release v')
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
       - name: Assign reviewers to release PR
         uses: kentaro-m/auto-assign-action@v2.0.2
         with:
@@ -101,7 +135,7 @@ jobs:
 
   update-submodules:
     name: Update Submodules
-    if: github.event.pull_request.draft == false && startsWith(github.event.pull_request.title, 'Release v')
+    if: github.event.pull_request.head.repo.full_name == github.repository && github.event.pull_request.draft == false && startsWith(github.event.pull_request.title, 'Release v')
     runs-on: ubuntu-latest
     steps:
       - name: Trigger submodule update workflow

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

@@ -17,7 +17,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Clone ArknightsGameResource for Official
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
           repository: yuanyan3060/ArknightsGameResource
@@ -49,7 +49,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Clone ArknightsGameResource_Yostar for Overseas
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
           repository: ArknightsAssets/ArknightsGamedata
@@ -92,7 +92,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Clone arknights-toolbox-update for Taiwan
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
           repository: arkntools/arknights-data-tw-for-maa
@@ -145,7 +145,7 @@ jobs:
     runs-on: macos-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           # TL;DR https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/9872#issuecomment-2251378371
           # actions/checkout uses ${{ secrets.GITHUB_TOKEN }} by default, meaning all steps will inherit it
@@ -155,7 +155,7 @@ jobs:
 
       - name: Restore ResourceUpdater from cache
         id: resupd-cache
-        uses: actions/cache/restore@v5
+        uses: actions/cache/restore@v6
         continue-on-error: true
         with:
           key: ResourceUpdater-${{ runner.os }}-${{ hashFiles('tools/ResourceUpdater/main.cpp') }}
@@ -165,13 +165,13 @@ jobs:
 
       - name: Fetch submodules
         if: steps.resupd-cache.outputs.cache-hit != 'true'
-        run: |
-          git submodule update --init --depth 1 src/MaaUtils
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --init --depth 1 src/MaaUtils
 
       - name: Cache MaaDeps
         if: steps.resupd-cache.outputs.cache-hit != 'true'
         id: maadeps-cache
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: |
@@ -195,7 +195,7 @@ jobs:
 
       - name: Save ResourceUpdater to cache
         if: always() && steps.resupd-cache.outputs.cache-hit != 'true'
-        uses: actions/cache/save@v5
+        uses: actions/cache/save@v6
         continue-on-error: true
         with:
           key: ResourceUpdater-${{ runner.os }}-${{ hashFiles('tools/ResourceUpdater/main.cpp') }}
@@ -204,7 +204,7 @@ jobs:
             ./tools/ResourceUpdater/res_updater
 
       - name: Wait for resource cloning
-        uses: yogeshlonkar/wait-for-jobs@v0
+        uses: yogeshlonkar/wait-for-jobs@v1
         with:
           ignore-skipped: 'false'
           jobs: |
@@ -235,10 +235,23 @@ jobs:
         run: |
           ./tools/ResourceUpdater/res_updater
 
+      - name: Setup python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          cache: pip
+          cache-dependency-path: |
+            tools/TaskSorter/requirements.txt
+            tools/OptimizeTemplates/requirements.txt
+
+      - name: Install TaskSorter dependencies
+        run: |
+          python -m pip install -r tools/TaskSorter/requirements.txt
+
       - name: Sort tasks
         id: task_sorting
         run: |
-          python3 tools/TaskSorter/TaskSorter.py
+          python tools/TaskSorter/TaskSorter.py
           echo "gitdiff=$(echo $(git diff --name-only --diff-filter=ACM 2>/dev/null | grep '\.json$'))" >> $GITHUB_OUTPUT
 
       - name: Run prettier
@@ -251,25 +264,10 @@ jobs:
         run: |
           sh ./tools/ResourceUpdater/version.sh
 
-      - name: Setup python
-        if: steps.update_version.outputs.contains_png == 'True'
-        uses: actions/setup-python@v6
-        with:
-          python-version: "3.11"
-
-      - name: Cache python packages
-        if: always() && steps.update_version.outputs.contains_png == 'True'
-        id: cache_python
-        uses: actions/cache@v5
-        continue-on-error: true
-        with:
-          path: ${{ env.pythonLocation }}/Lib/site-packages
-          key: ${{ runner.os }}-pip-optimize-templates-${{ hashFiles('./tools/OptimizeTemplates/requirements.txt') }}
-
       - name: Install dependencies
-        if: steps.cache_python.outputs.cache-hit != 'true' && steps.update_version.outputs.contains_png == 'True'
+        if: steps.update_version.outputs.contains_png == 'True'
         run: |
-          pip install -r tools/OptimizeTemplates/requirements.txt
+          python -m pip install -r tools/OptimizeTemplates/requirements.txt
 
       - name: Setup oxipng
         if: steps.update_version.outputs.contains_png == 'True'
@@ -280,7 +278,7 @@ jobs:
       - name: Optimize png images
         if: steps.update_version.outputs.contains_png == 'True'
         run: |
-          python3 tools/OptimizeTemplates/optimize_templates.py --no-cleanup -p resource/template/items/ resource/template/infrast/
+          python tools/OptimizeTemplates/optimize_templates.py --no-cleanup -p resource/template/items/ resource/template/infrast/
 
       - name: Commit changes
         if: steps.update_version.outputs.changes == 'True'
@@ -308,7 +306,7 @@ jobs:
 
       - name: Push changes
         if: steps.add_files.outputs.have_commits == 'True'
-        uses: ad-m/github-push-action@master
+        uses: ad-m/github-push-action@881a6320fdb16eb5318c5054f31c218aec2b324c # v1.3.0
         with:
           branch: ${{ github.ref }}
           github_token: ${{ secrets.MAA_RESOURCE_SYNC }}

.github/workflows/smoke-testing.yml

@@ -43,7 +43,7 @@ jobs:
     runs-on: macos-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 
@@ -56,7 +56,7 @@ jobs:
       - name: Restore cache for Smoke Test
         if: ${{ steps.cache_key.outputs.key != '' }}
         id: smoke-cache
-        uses: actions/cache/restore@v5
+        uses: actions/cache/restore@v6
         continue-on-error: true
         with:
           key: ${{ steps.cache_key.outputs.key }}
@@ -70,13 +70,13 @@ jobs:
 
       - name: Fetch submodules
         if: steps.smoke-cache.outputs.cache-hit != 'true'
-        run: |
-          git submodule update --init --depth 1 src/MaaUtils
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --init --depth 1 src/MaaUtils
 
       - name: Cache MaaDeps
         if: steps.smoke-cache.outputs.cache-hit != 'true'
         id: maadeps-cache
-        uses: actions/cache@v5
+        uses: actions/cache@v6
         continue-on-error: true
         with:
           path: ./src/MaaUtils/MaaDeps
@@ -107,7 +107,7 @@ jobs:
 
       - name: Save cache for Smoke Test (only in dev-v2)
         if: steps.smoke-cache.outputs.cache-hit != 'true' && github.ref == 'refs/heads/dev-v2'
-        uses: actions/cache/save@v5
+        uses: actions/cache/save@v6
         continue-on-error: true
         with:
           key: ${{ steps.cache_key.outputs.key }}

.github/workflows/sync-resource.yml

@@ -17,7 +17,7 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 
@@ -28,7 +28,7 @@ jobs:
           git show -s
 
       - name: Checkout MaaResource
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           repository: MaaAssistantArknights/MaaResource
           show-progress: false

.github/workflows/unit-tests.yml

@@ -0,0 +1,122 @@
+name: Unit Tests
+
+on:
+  # push:
+  #   branches:
+  #     - "dev-v2"
+  #   paths:
+  #     - ".github/workflows/unit-tests.yml"
+  #     - "unit_test/**"
+  #     - "src/**"
+  # pull_request:
+  #   paths:
+  #     - ".github/workflows/unit-tests.yml"
+  #     - "unit_test/**"
+  #     - "src/**"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  select-tests:
+    name: Select Unit Test Suites
+    runs-on: ubuntu-latest
+    outputs:
+      has_tests: ${{ steps.select.outputs.has_tests }}
+      matrix: ${{ steps.select.outputs.matrix }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+          show-progress: false
+
+      - name: Select affected test suites
+        id: select
+        env:
+          EVENT_NAME: ${{ github.event_name }}
+          BEFORE_SHA: ${{ github.event.before }}
+          HEAD_SHA: ${{ github.sha }}
+          PR_BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          PR_HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: |
+          python3 - <<'PY'
+          import json
+          import os
+          import subprocess
+
+          def matches(path: str, rule: str) -> bool:
+              if rule.endswith('/**'):
+                  return path.startswith(rule[:-3])
+              return path == rule
+
+          with open('unit_test/test-suites.json', encoding='utf-8') as f:
+              mapping = json.load(f)
+
+          event_name = os.environ['EVENT_NAME']
+          changed_files = []
+          run_all = event_name == 'workflow_dispatch'
+
+          if not run_all:
+              if event_name == 'pull_request':
+                  base_sha = os.environ['PR_BASE_SHA']
+                  head_sha = os.environ['PR_HEAD_SHA']
+              else:
+                  base_sha = os.environ['BEFORE_SHA']
+                  head_sha = os.environ['HEAD_SHA']
+
+              if not base_sha or set(base_sha) == {'0'}:
+                  run_all = True
+              else:
+                  diff = subprocess.check_output(
+                      ['git', 'diff', '--name-only', base_sha, head_sha],
+                      text=True,
+                  )
+                  changed_files = [line for line in diff.splitlines() if line]
+
+          print('Changed files:')
+          for file_path in changed_files:
+              print(f'  - {file_path}')
+
+          if run_all or any(any(matches(path, rule) for rule in mapping['runAllOnChanges']) for path in changed_files):
+              selected = mapping['suites']
+          else:
+              selected = []
+              for suite in mapping['suites']:
+                  if any(any(matches(path, rule) for rule in suite['paths']) for path in changed_files):
+                      selected.append(suite)
+
+          matrix = {'suite': selected}
+          with open(os.environ['GITHUB_OUTPUT'], 'a', encoding='utf-8') as f:
+              f.write(f"has_tests={'true' if selected else 'false'}\n")
+              f.write(f"matrix={json.dumps(matrix, separators=(',', ':'))}\n")
+          PY
+
+  unit-tests:
+    name: ${{ matrix.suite.name }} Unit Tests
+    needs: select-tests
+    if: ${{ needs.select-tests.outputs.has_tests == 'true' }}
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix: ${{ fromJson(needs.select-tests.outputs.matrix) }}
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+        with:
+          show-progress: false
+
+      - name: Configure unit tests
+        run: |
+          cmake -S unit_test -B build/unit_test -DCMAKE_BUILD_TYPE=Release
+
+      - name: Build selected unit test target
+        run: |
+          cmake --build build/unit_test --parallel --target ${{ matrix.suite.buildTarget }}
+
+      - name: Run selected unit tests
+        run: |
+          ctest --test-dir build/unit_test --output-on-failure -R '${{ matrix.suite.ctestRegex }}'

.github/workflows/update-submodules.yml

@@ -12,20 +12,19 @@ jobs:
     if: github.repository_owner == 'MaaAssistantArknights'
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           submodules: true
 
       - name: Update submodules
-        run: |
-          git submodule update --remote src/MaaMacGui
-          git submodule update --remote src/maa-cli
+        shell: bash
+        run: bash ./.github/scripts/sync-optional-submodules.sh --remote src/MAAUnified src/MaaMacGui src/maa-cli
 
       - name: Commit and push changes
-        uses: actions-js/push@master
+        uses: actions-js/push@5a7cbd780d82c0c937b5977586e641b2fd94acc5 # master as of 2026-05-06
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          message: "feat: Update Submodules MaaMacGui, maa-cli
+          message: "feat: Update Submodules MAAUnified, MaaMacGui, maa-cli
 
             https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}
 

.github/workflows/website-workflow.yml

@@ -35,7 +35,7 @@ jobs:
     timeout-minutes: 20
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           show-progress: false
 

.gitignore

@@ -416,10 +416,15 @@ FodyWeavers.xsd
 # !.vscode/launch.json
 # !.vscode/extensions.json
 *.code-workspace
+*.csproj.lscache
 
 # Local History for Visual Studio Code
 .history/
 
+# Claude Code
+.claude/*
+!.claude/skills/
+
 # Windows Installer files from build outputs
 *.cab
 *.msi
@@ -482,3 +487,4 @@ install-*
 
 # CMake user presets
 CMakeUserPresets.json
+.ace-tool/

.gitmodules

@@ -13,3 +13,7 @@
 [submodule "src/MaaUtils"]
 	path = src/MaaUtils
 	url = https://github.com/MaaXYZ/MaaUtils
+[submodule "src/MAAUnified"]
+	path = src/MAAUnified
+	url = https://github.com/MaaAssistantArknights/MaaUnified.git
+	branch = main

CHANGELOG.md

@@ -1,93 +1,87 @@
-## v6.7.0
+## v6.13.0
 
-### 正式接入 DeepSleep | Highlight
+### Highlights
 
-我们很高兴地宣布：从 v6.7.0 开始，MAA 将正式接入 DeepSleep。这将意味着我们首次将 AI 引入到游戏助手领域，为你带来更智能、高效的体验。DeepSleep 的 AI 算法能够实时分析游戏运行数据，动态生成运行日志，在保证游戏流畅度的同时有效提升用户体验。这一功能的加入，标志着 MAA 在智能化方向上迈出了关键一步，未来我们也将持续探索 AI 技术与 MAA 的深度融合，为你带来更多创新体验。 ~（绝对不是牛牛喝醉了睡着导致的）~
+#### 6 星自动公招支持
 
-#### 成就 DLC #3 同步上线
+新增可通过手动修改配置文件开启的 6 星自动公招功能，「是否招募」和「招募时间」选项移入常规设置，并优化了相关提示信息。
 
-除了 DeepSleep，本次更新也带来了成就 DLC #3。
+#### 通知不可用时自动回退
 
-* 成就现已支持按 DLC 期数搜索；
-* 补充了一批新的成就触发与描述；
-* 多语言文本与部分触发细节也一并完成调整。
+系统通知无法显示时自动回退到软件内通知，避免用户错过重要提醒；启动时的通知检测提示也改为软件内弹窗，不再仅写入日志。
 
-#### 新增支持任务单次运行
+#### 切换语言无需重启
 
-右键任务设置图标即可弹出二级菜单，“单次运行”与“重命名”、“删除”并列，方便快速执行单次任务。
+切换软件界面语言不再需要重启，干员识别、仓库识别等界面同步支持动态切换。
 
-#### 多项细节问题一并修复
+<details>
+<summary><b>English</b></summary>
 
-除了 DeepSleep，本次更新也处理了一批影响体验的细节问题。
+#### 6-Star Auto Recruitment Support
 
-* 修复在非 UI 线程清空库存数据可能导致任务添加失败的问题；
-* 修复多项剿灭相关识别与战斗完成 ROI 问题。
+Added a 6-star auto recruitment feature that can be enabled through manual configuration file editing. The "Recruit" and "Recruitment Time" options have been moved to general settings, with improved tooltip hints.
 
-----
+#### Notification Fallback
 
-We are pleased to announce that starting from v6.7.0, MAA will officially integrate DeepSleep. This marks the first time we bring AI into the game assistant space, delivering a smarter and more efficient experience. DeepSleep's AI algorithm analyzes game runtime data in real time and dynamically generates operation logs, effectively enhancing user experience while maintaining smooth gameplay. The addition of this feature represents a key milestone in MAA's journey toward intelligence, and we will continue to explore deeper integration of AI technology with MAA to bring you more innovative experiences. ~(Definitely not because Pallas got drunk and fell asleep)~
+Automatically falls back to in-app notifications when system notifications are unavailable, ensuring users never miss important alerts. The startup notification availability check now shows an in-app Growl message instead of only logging to file.
 
-#### Achievement DLC #3 Included
+#### Switch Language Without Restart
 
-Alongside DeepSleep, this update also brings Achievement DLC #3.
+Switching the UI language no longer requires a restart; operator recognition, depot recognition, and other views now support dynamic switching.
 
-* Achievements are now organized by DLC release phase;
-* A new batch of achievement triggers and descriptions has been added;
-* Multilingual texts and several trigger details have also been refined.
-
-### New Support for Run Once of Tasks
-Right-click the task settings icon to open a secondary menu, where "Run Once" is now available alongside "Rename" and "Delete," making it easy to quickly execute a task once.
-
-#### Various UX Fixes Included
-
-Besides DeepSleep, this update also fixes several small but noticeable issues.
-
-* Fix task creation failures caused by clearing depot data off the UI thread;
-* Fix several issues related to Annihilation recognition and completion ROI.
+</details>
 
 ----
 
 以下是详细内容：
 
+<details open>
+<summary><b>v6.13.0 (2026-06-28)</b></summary>
+
 ### 新增 | New
 
-* 正式接入 DeepSleep @ABA2396
-* 新增成就 DLC#3，支持按 DLC 期数搜索并补充新的成就触发与描述 @ABA2396 @Constrat @HX3N @Manicsteiner
-* 新增任务设置按钮右键单次运行功能 @ABA2396
+* Android OCR 推理引擎切换为 NCNN ([#17133](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17133)) @Aliothmoon
+* 切换界面语言不再需要重启，干员识别、仓库识别等界面同步支持动态切换，并可单独设置干员名称显示语言 ([#17183](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17183)) @ABA2396
+* 新增可通过手动修改配置文件开启 6 星自动公招，将「是否招募」和「招募时间」选项移入常规设置，优化 ToolTip 提示 ([#17154](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17154)) @ABA2396
+* Custom Webhook 新增预置模板功能 ([#17081](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17081)) @pboymt
+* 新增常驻关卡备选提示，当选中的关卡为常驻关卡或当前/上次时提示其后关卡不会被选中执行 @ABA2396
+* 增加 DWM 被禁用与重复拖动异常的解决方案提示 @ABA2396
+* 添加落叶逐火复刻关卡入口任务 @SherkeyXD
+* Yostar 服新增 SSS#10 极寒自动战斗作业 ([#17137](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17137)) @Manicsteiner
 
 ### 改进 | Improved
 
-* 优化自动战斗 tab 样式，新增滑块动画效果，修复切页重置状态 @ABA2396
-* data 数据存储优化 @status102
-* 优化日志展示效果 @ABA2396
-* 在收到对应识别结果时再重置库存数据 @ABA2396
-* 使用 DateTimeOffset 替代 DateTime @status102
-* Log 头时间从 UTC 时间改为 Local 时间 @status102
-* 不再默认启用 `在下拉框中隐藏当日未开放关卡` @status102
-* Ocr 内部 log 在 without_det 时也对 rect 输出进行基于 base_roi 的偏移 @status102
+* 统一任务队列与自动战斗的停止逻辑 ([#17087](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17087)) @ABA2396
+* 无法显示系统通知时自动回退到软件内通知，启动时通知不可用提示改为软件内弹窗 ([#17165](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17165)) @ABA2396
+* 优化成就 DLC 标识显示效果与提示，增加对应 DLC 上线时间提示 @ABA2396
+* 调整繁中服 CharNameOcrReplace 替换规则 ([#17113](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17113)) @momomochi987
+* 怪猎一期复刻 CF-EX-8、CF-S-1 关卡参数调整 @status102
+* 移除依赖库安装脚本的提权操作 @ABA2396
+* 调整日志超时提示 @ABA2396
+* YostarKR crop JieGarden@Roguelike@StartAction.png to improve match score @HX3N
 
 ### 修复 | Fix
 
-* 在更新时报错无法显示本地化语言 @ABA2396
-* 粘贴作业集不会自动勾选多作业模式 @ABA2396
-* 亮色模式下 Linkstart 按钮样式缺失 @ABA2396
-* 修复 build warning，smtp 改用新版本 MailKit @ABA2396
-* 修复剿灭关卡名 OcrReplace @status102
-* 修复在非 UI 线程调用清空库存数据导致任务添加失败 @ABA2396
-* 修复日志记录中使用源石 TaskName 的问题 @status102
-* 修复任务开始/完成时无法显示任务名 @ABA2396
-* 修复读取备份成就时不会加载 CustomData 的问题 @ABA2396
-* 更新 MaaFramework 文件名格式和 .NET SDK 版本 @AnnAngela
-* 移除过时的配置迁移兼容逻辑 @status102
-* 修复剿灭战斗完成 roi @status102
-* 修复 CN 剿灭后识别，并统一全客户端类型识别 @status102
+* 修复 NCNN OCR 引擎在小 ROI 下识别异常，对齐 fastdeploy 的 det 缩放与 rec 预处理 ([#17182](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17182)) @Aliothmoon
+* 修复部分设备界园树洞"是非境"识别错误 ([#17181](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17181)) @Aliothmoon
+* 修复自动战斗多作业模式无法进行关卡导航 @status102
+* 修复自动战斗导航 retry 异常导致跳过作业的问题 @status102
+* 修复肉鸽战斗结束后招募误入 StartExplore 的问题 @Saratoga-Official
+* 修复水月肉鸽"大海的遗产"和"狗眼婆娑"事件名识别错误 @Saratoga-Official
+* 修复肉鸽 GetDrop 未等待 LoadingText 导致的问题 @Saratoga-Official
+* 修复 CloseEvent 和 CloseCollection 同时出现导致的异常 @Saratoga-Official
+* 修复 MAA 更新检查 API 请求未遵循代理设置的问题 @status102
+* 修正落叶逐火入口 OCR 文本 @SherkeyXD
+* 修复复制任务时未保留原任务启用状态的问题 @ABA2396
+* YostarEN fix future alter operators recognition and EnterEpisodeNew-Click @Constrat
+* YostarKR correct ClickChapterNewDefaultProgress roi, expand training roi for wrapped operator names @HX3N
 
 ### 其他 | Other
 
-* 避免生成不必要的 res_updater (#16116) @status102 @Constrat @soundofautumn
-* 更新数据任务禁用高级设置 @ABA2396
-* DateTimeOffset 基础支持 @status102
-* 修复错误描述：`过期关卡重置` @status102
-* 补充遗漏图片资源 @status102
-* Revise linking guidelines and AI suggestions @MistEO
-* resolve warning @status102
+* 修复 MAAUnified CI 选错 ref 的问题 ([#17143](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17143)) @Halo
+* 优化 Avalonia 构建工作流触发条件 ([#17139](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17139)) @Manicsteiner
+* YostarEN/JP/KR update LoneTrail and JieGarden themes ([#17175](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17175)) @Constrat @Manicsteiner @HX3N
+* YostarJP add episode new navigation and JieGarden theme recruit @Manicsteiner
+* Update GitHub push action version comment ([#17124](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/17124)) @AnnAngela
+
+</details>

CMakeLists.txt

@@ -34,9 +34,12 @@ target_include_directories(HeaderOnlyLibraries INTERFACE 3rdparty/include)
 add_subdirectory(src/MaaCore)
 
 if(BUILD_WPF_GUI)
+    add_subdirectory(src/MaaUpdater)
+
     include_external_msproject(MaaWpfGui ${PROJECT_SOURCE_DIR}/src/MaaWpfGui/MaaWpfGui.csproj)
 
     add_dependencies(MaaWpfGui MaaCore)
+    add_dependencies(MaaWpfGui MAA.Updater)
     if(DEFINED ENV{VSCODE_PID})
         add_custom_target(run-MaaWpfGui
             COMMAND "${CMAKE_BINARY_DIR}/bin/$<CONFIG>/MAA.exe"
@@ -46,6 +49,13 @@ if(BUILD_WPF_GUI)
     endif()
 endif()
 
+if (ANDROID)
+    add_library(stdc++fs INTERFACE)
+    add_compile_options(-Wno-unused-parameter)
+    add_compile_options(-ffunction-sections -fdata-sections)
+    add_link_options(-Wl,--gc-sections)
+endif()
+
 if(INSTALL_PYTHON)
     install(DIRECTORY src/Python DESTINATION .)
 endif()

CMakePresets.json

@@ -158,6 +158,39 @@
                 "CMAKE_OSX_ARCHITECTURES": "x86_64"
             }
         },
+        {
+            "name": "android-base",
+            "hidden": true,
+            "generator": "Ninja",
+            "binaryDir": "${sourceDir}/build",
+            "$comment": [
+                "Base for Android presets; cross-compilation via NDK toolchain",
+                "CMAKE_TOOLCHAIN_FILE must be passed externally pointing to NDK's android.toolchain.cmake"
+            ],
+            "cacheVariables": {
+                "CMAKE_SYSTEM_NAME": "Android",
+                "ANDROID_PLATFORM": "android-28",
+                "CMAKE_BUILD_TYPE": "RelWithDebInfo"
+            }
+        },
+        {
+            "name": "android-arm64",
+            "inherits": "android-base",
+            "displayName": "Android arm64",
+            "cacheVariables": {
+                "ANDROID_ABI": "arm64-v8a",
+                "MAADEPS_TRIPLET": "maa-arm64-android"
+            }
+        },
+        {
+            "name": "android-x64",
+            "inherits": "android-base",
+            "displayName": "Android x64",
+            "cacheVariables": {
+                "ANDROID_ABI": "x86_64",
+                "MAADEPS_TRIPLET": "maa-x64-android"
+            }
+        },
         {
             "name": "publish-base",
             "$comment": [
@@ -181,11 +214,9 @@
                 "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",
+            "cacheVariables": {
+                "BUILD_WPF_GUI": "ON"
+            },
             "displayName": "Windows x64 Publish"
         },
         {
@@ -194,11 +225,9 @@
                 "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",
+            "cacheVariables": {
+                "BUILD_WPF_GUI": "ON"
+            },
             "displayName": "Windows arm64 Publish"
         },
         {
@@ -233,6 +262,22 @@
             ],
             "displayName": "macOS arm64 Publish"
         },
+        {
+            "name": "android-publish-arm64",
+            "inherits": ["publish-base", "android-arm64"],
+            "displayName": "Android arm64 Publish",
+            "cacheVariables": {
+                "INSTALL_PYTHON": "OFF"
+            }
+        },
+        {
+            "name": "android-publish-x64",
+            "inherits": ["publish-base", "android-x64"],
+            "displayName": "Android x64 Publish",
+            "cacheVariables": {
+                "INSTALL_PYTHON": "OFF"
+            }
+        },
         {
             "name": "smoke-test",
             "$comment": [
@@ -394,6 +439,16 @@
             "configurePreset": "macos-publish-arm64",
             "configuration": "RelWithDebInfo"
         },
+        {
+            "name": "android-publish-arm64",
+            "displayName": "Build Android arm64 Publish",
+            "configurePreset": "android-publish-arm64"
+        },
+        {
+            "name": "android-publish-x64",
+            "displayName": "Build Android x64 Publish",
+            "configurePreset": "android-publish-x64"
+        },
         {
             "name": "smoke-test",
             "displayName": "Build macOS arm64 Smoke Test",

README.md

@@ -130,7 +130,7 @@ MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）
 - [集成文档](https://docs.maa.plus/zh-cn/protocol/integration.html)
 - [回调消息协议](https://docs.maa.plus/zh-cn/protocol/callback-schema.html)
 - [任务流程协议](https://docs.maa.plus/zh-cn/protocol/task-schema.html)
-- [自动抄作业协议](https://docs.maa.plus/zh-cn/protocol/copilot-schema.html)
+- [自动战斗协议](https://docs.maa.plus/zh-cn/protocol/copilot-schema.html)
 
 ### 外服适配
 

context7.json

@@ -0,0 +1,4 @@
+{
+  "url": "https://context7.com/maaassistantarknights/maaassistantarknights",
+  "public_key": "pk_jDwwiGY7WKDA3WnLQzoWX"
+}

docs/en-us/develop/development.md

@@ -78,7 +78,9 @@ We've preset several different development environments for you to choose from:
    - Press F5 to run
 
    ::: 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!
+   To run Win32Controller (Windows window control) / MaaFwAdbController (MaaFramework touch mode) features, you need to manually download the package for your platform from [MaaFramework Releases](https://github.com/MaaXYZ/MaaFramework/releases), and place `MaaWin32ControlUnit.dll` / `MaaAdbControlUnit.dll` from the `bin` directory into MAA's DLL directory (e.g. `build/bin/Debug`). PRs for an auto-download script are welcome!
+
+   To debug these features, [compile the Debug version of MaaFramework yourself](https://maafw.com/docs/4.1-BuildGuide) and use the corresponding DLLs, or it will randomly crash at breakpoints.
    :::
 
 9. Now you're ready to happily ~~mess around~~ start developing!

docs/en-us/develop/documentation-guidelines.md

@@ -23,6 +23,8 @@ Our documentation is built on [vuepress](https://github.com/vuejs/vuepress) and
 
 This theme provides support for custom containers such as tips, notes, info, warnings, alerts, and details. We can utilize this feature to emphasize certain content.
 
+Note that if containers are nested within containers, the parent container should use one more colon `:` than the child container to differentiate them.
+
 Usage of containers:
 
 ```markdown
@@ -31,6 +33,13 @@ Content you want to write
 :::
 ```
 
+Or use GitHub-style syntax:
+
+```markdown
+> [!Container Type]
+> Content you want to write
+```
+
 Accepted container types and their default titles are as follows:
 
 - `tip` Tips
@@ -39,6 +48,7 @@ Accepted container types and their default titles are as follows:
 - `warning` Warning
 - `danger` Caution
 - `details` Details
+- `window` ==Special Container==
 
 ### Container Examples
 
@@ -66,6 +76,190 @@ This is a danger container
 This is a details container
 :::
 
+::: window
+This is a very special container
+:::
+
+## Markers
+
+You can use the marker syntax to highlight content and emphasize key points.
+
+Usage: Use `==content=={color (optional)}` syntax to mark text. Note that spaces are required on both sides of the marks.
+
+**Input:**
+
+```markdown
+MaaAssistantArknights is developed by ==many pigs==
+```
+
+**Output:**
+
+MaaAssistantArknights is developed by ==many pigs==
+
+The theme also has the following built-in color schemes:
+
+- **default**: `==Default==` - ==Default==
+- **info**: `==Info=={.info}` - ==Info=={.info}
+- **note**: `==Note=={.note}` - ==Note=={.note}
+- **tip**: `==Tip=={.tip}` - ==Tip=={.tip}
+- **warning**: `==Warning=={.warning}` - ==Warning=={.warning}
+- **danger**: `==Danger=={.danger}` - ==Danger=={.danger}
+- **caution**: `==Caution=={.caution}` - ==Caution=={.caution}
+- **important**: `==Important=={.important}` - ==Important=={.important}
+
+## Hidden Text
+
+For some reason, you may need to temporarily black out a section of the document. In this case, you can use the hidden text feature.
+
+You can use the `!!content!!{config (optional)}` syntax, and the default effect is as follows:
+
+!!I always feel like I'm reading MoeGirl (strikethrough!!
+
+The following configurations are available:
+
+::: window
+Input:
+
+```markdown
++ Mask effect + Mouse hover: !!Mouse hover to see me!!{.mask .hover}
++ Mask effect + Click: !!Click to see me!!{.mask .click}
++ Text blur effect + Mouse hover: !!Mouse hover to see me!!{.blur .hover}
++ Text blur effect + Click: !!Click to see me!!{.blur .click}
+```
+
+Output:
+
+- Mask effect + Mouse hover: !!Mouse hover to see me!!{.mask .hover}
+- Mask effect + Click: !!Click to see me!!{.mask .click}
+- Text blur effect + Mouse hover: !!Mouse hover to see me!!{.blur .hover}
+- Text blur effect + Click: !!Click to see me!!{.blur .click}
+
+:::
+
+## Steps
+
+When writing a step-by-step tutorial, ordered lists may lose their hierarchy due to nesting. In this case, the `steps` container is the best choice.
+
+Input:
+
+````markdown
+:::: steps
+1. Step 1
+
+   ```ts
+   console.log('Hello World!')
+   ```
+
+2. Step 2
+
+   Here is the content related to Step 2
+
+3. Step 3
+
+   ::: tip
+   Tip container
+   :::
+
+4. End
+::::
+````
+
+Output:
+
+:::: steps
+
+1. Step 1
+
+   ```ts
+   console.log('Hello World!')
+   ```
+
+2. Step 2
+
+   Here is the content related to Step 2
+
+3. Step 3
+
+   ::: tip
+   Tip container
+   :::
+
+4. End
+
+::::
+
+## Smart Image Container
+
+We have wrapped an image container based on the functionality provided by the theme. This container can automatically display the corresponding image in light and dark themes, while supporting automatic layout.
+
+You can use the `<ImageGrid>` component in the markdown body to invoke this method. The specific syntax and effects are as follows:
+
+::: window
+
+This is the syntax:
+
+```markdown
+<ImageGrid :imageList="[
+  {
+    light: 'images/zh-cn/readme/1-light.png',
+    dark: 'images/zh-cn/readme/1-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/2-light.png',
+    dark: 'images/zh-cn/readme/2-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/3-light.png',
+    dark: 'images/zh-cn/readme/3-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/4-light.png',
+    dark: 'images/zh-cn/readme/4-dark.png'
+  }
+]" />
+```
+
+This is the rendered result:
+
+<ImageGrid :imageList="[
+  {
+    light: 'images/zh-cn/readme/1-light.png',
+    dark: 'images/zh-cn/readme/1-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/2-light.png',
+    dark: 'images/zh-cn/readme/2-dark.png'
+  }
+]" />
+
+:::
+
+## Field Container
+
+This syntax is more complex. Please refer to the [official documentation](https://theme-plume.vuejs.press/guide/markdown/field/) for usage.
+
+The effects are as follows:
+
+:::: field-group
+::: field name="theme" type="ThemeConfig" required default="{ base: '/' }"
+Theme configuration
+:::
+
+::: field name="enabled" type="boolean" optional default="true"
+Whether to enable
+:::
+
+::: field name="callback" type="(...args: any[]) => void" optional default="() => {}"
+<Badge type="tip" text="Added in v1.0.0"  />
+Callback function
+:::
+
+::: field name="other" type="string" deprecated
+<Badge type="danger" text="Deprecated in v0.9.0"  />
+Deprecated property
+:::
+::::
+
 ## Icons
 
 This theme provides icon support, where you can use icons in the following places:

docs/en-us/develop/linux-tutorial.md

@@ -8,7 +8,8 @@ icon: teenyicons:linux-alt-solid
 **This tutorial requires readers to have some Linux environment configuration ability and programming foundation!** If you only want to directly install MAA instead of compiling it yourself, please read [User Manual - Linux Emulators and Containers](../manual/device/linux.md).
 
 ::: info Note
-MAA's build method is still under discussion. The content of this tutorial may be outdated. Please refer to the scripts in [GitHub workflow file](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/workflows/ci.yml#L134). You can also refer to [AUR PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=maa-assistant-arknights), [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix).
+MAA's build method is still under discussion. The content of this tutorial may be outdated. Please refer to the scripts in [GitHub workflow file](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev-v2/.github/workflows/ci.yml#L224#:~:text=ubuntu%3A).  
+You can also refer to [AUR PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=maa-assistant-arknights) or [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix).
 :::
 
 ::: info
@@ -73,6 +74,8 @@ Mac can use the `tools/build_macos_universal.zsh` script for compilation. It's r
    cmake --install build --prefix <target_directory>
    ```
 
+4. To debug MaaFwAdbController (MaaFramework touch mode) features, you need to [compile the Debug version of MaaFramework yourself](https://maafw.com/docs/4.1-BuildGuide) and put `libMaaAdbControlUnit.so` in the installation directory.
+
 ## Integration Documentation
 
 [~~Perhaps not really documentation~~](../protocol/integration.md)
@@ -85,8 +88,6 @@ You can refer to the implementation of `__main__` in [Python demo](https://githu
 
 You can refer to the implementation in [CppSample](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/Cpp/main.cpp)
 
-### C Sharp
-
-<!-- Do not use C#, MD003/heading-style: Heading style [Expected: atx; Actual: atx_closed] -->
+### C\#
 
 You can refer to the implementation in [MaaWpfGui](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/src/MaaWpfGui/Main/AsstProxy.cs)

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

@@ -201,7 +201,7 @@ strategy = "merge" # or "first" (default)
 
 # use all expiring medicine on Sunday night
 [[tasks.variants]]
-params = { expiring_medicine = 1000 }
+params = { medicine_expire_days = 2 }
 [tasks.variants.condition]
 type = "And"
 conditions = [

docs/en-us/manual/connection.md

@@ -1,5 +1,5 @@
 ---
-order: 3
+order: 4
 icon: mdi:plug
 ---
 
@@ -16,6 +16,7 @@ As of MAA v5.22.3, the following emulators and connection addresses are supporte
 - LDPlayer 9: `emulator-5554/5556/5558/5560`, `127.0.0.1:5555/5557/5559/5561`
 - NoxPlayer: `127.0.0.1:62001/59865`
 - MEmu Play: `127.0.0.1:21503`
+- Tencent App Store (after 5.10.56.xx): `127.0.0.1:5555`
 
 If detection fails, try launching MAA with UAC administrator privileges and detect again. If it still fails, refer to the manual setup instructions below and verify that your emulator and connection address are included in the list above.
 
@@ -57,6 +58,7 @@ Emulators running on your local machine should use addresses like `127.0.0.1:<po
 - [LDPlayer 9](https://help.ldmnq.com/docs/LD9adbserver) `emulator-5554`
 - [NoxPlayer](https://support.yeshen.com/zh-CN/qt/ml) `127.0.0.1:62001`
 - [MEmu Play](https://bbs.xyaz.cn/forum.php?mod=viewthread&tid=365537) `127.0.0.1:21503`
+- [Tencent App Store](https://sj.qq.com/faq/3878): ADB port is fixed at `127.0.0.1:5555`. ADB path example: `C:\Program Files\Tencent\Androws\Application\<version>\adb.exe`.
 
 For other emulators, refer to [Zhao Qingqing's blog](https://www.cnblogs.com/zhaoqingqing/p/15238464.html).
 
@@ -180,17 +182,28 @@ Requires official or international LDPlayer 9 V9.1.32 or newer. <!-- Official V9
 
 3. Enter the number (ID) of the corresponding emulator in the LDPlayer multi-instance manager in `Instance Number`, such as `0` for the main instance.
 
+### AVD Screenshot Enhanced Mode
+
+Requires Android Emulator v27.2.9 or newer. (You should be fine as long as you got the emulator after Arknights launched.)
+
+AVD Screenshot Enhanced Mode is implemented in MaaFramework. Touch mode must be set accordingly for Screenshot Enhanced Mode to work.
+
+1. In `Settings` - `Connection` - `Connection Preset`, select `Android Virtual Device (AVD)`.
+
+2. For `Touch Mode`, select `MaaFramework`.
+
 ## Touch Mode
 
 1. [Minitouch](https://github.com/DeviceFarmer/minitouch): An Android touch event handler written in C that operates on `evdev` devices and provides a Socket interface for external programs to trigger touch events and gestures. Starting with Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode.<sup>[source](https://github.com/DeviceFarmer/minitouch?tab=readme-ov-file#for-android-10-and-up)</sup>
 2. [MaaTouch](https://github.com/MaaAssistantArknights/MaaTouch): MAA's Java reimplementation of Minitouch that uses Android's native `InputDevice` and adds extra features. Compatibility with newer Android versions is still being tested. ~~Help us test it~~
 3. Adb Input: Directly calls ADB to use Android's `input` command for touch operations. Most compatible but slowest.
+4. [MaaFramework](https://maafw.com/): Delegates screenshot and touch commands to MaaFramework's control unit. Still being tested. ~~Help us test it x2~~
 
 ## ADB Lite
 
 MAA's independent ADB Client implementation that communicates directly with the ADB Server via TCP. Compared to the original ADB, it avoids constantly launching multiple ADB processes, reducing performance overhead, but some screenshot methods aren't available.<sup>[PR](https://github.com/MaaAssistantArknights/MaaAssistantArknights/pull/3315)</sup>
 
-We recommend enabling it, but specific pros and cons need feedback. ~~Help us test it x2~~
+We recommend enabling it, but specific pros and cons need feedback. ~~Help us test it x3~~
 
 ## Running multiple MAA and emulator instances
 

docs/en-us/manual/device/android.md

@@ -26,6 +26,8 @@ Typical `16:9` resolutions include `3840x2160` (4K), `2560x1440` (2K), `1920x108
 
 ## Download and Run ADB Debug Tool to Connect Device
 
+::: steps
+
 1. Download [ADB](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) and extract it.
 2. Open the extracted folder, clear the address bar, type `cmd`, and press Enter.
 3. In the command prompt window that appears, type `adb`. If you see extensive help text, the command ran successfully.
@@ -36,6 +38,8 @@ Typical `16:9` resolutions include `3840x2160` (4K), `2560x1440` (2K), `1920x108
    adb devices
    ```
 
+:::
+
 - When executed successfully, it will show connected USB debugging devices.
   - Example of a successful connection:
 
@@ -114,23 +118,25 @@ It is strongly recommended to revert these changes **before the next device rebo
 
 ## Automate Resolution Changes
 
+::: steps
+
 1. Create two text files in the MAA directory with the following content:
 
-   ```bash
-   # Adjust resolution to 1080p
+   ```bat
+   :: Adjust resolution to 1080p
    adb -s <target device serial number> shell wm size 1080x1920
-   # Lower screen brightness (optional)
+   :: Lower screen brightness (optional)
    adb -s <target device serial number> shell settings put system screen_brightness 1
    ```
 
-   ```bash
-   # Restore resolution
+   ```bat
+   :: Restore resolution
    adb -s <target device serial number> shell wm size reset
-   # Increase screen brightness (optional)
+   :: Increase screen brightness (optional)
    adb -s <target device serial number> shell settings put system screen_brightness 20
-   # Return to home screen (optional)
+   :: Return to home screen (optional)
    adb -s <target device serial number> shell input keyevent 3
-   # Lock screen (optional)
+   :: Lock screen (optional)
    adb -s <target device serial number> shell input keyevent 26
    ```
 
@@ -139,6 +145,8 @@ It is strongly recommended to revert these changes **before the next device rebo
 
 3. In MAA's `Settings` - `Connection Settings`, set `Start Script` to `startup.bat` and `End Script` to `finish.bat`.
 
+:::
+
 ## Connect to MAA
 
 ### Wired Connection
@@ -157,6 +165,8 @@ Wired connections don't need IP addresses or ports - just the device serial numb
 
 #### Using `adb tcpip` for Wireless Debugging
 
+::: steps
+
 1. In the command prompt, enable wireless debugging:
 
    ```bash
@@ -171,12 +181,16 @@ Wired connections don't need IP addresses or ports - just the device serial numb
 3. Enter `<IP>:5555` in MAA's `Settings` - `Connection Settings` - `Connection Address`, e.g., `192.168.1.2:5555`.
 4. Link Start!
 
+:::
+
 #### Using `adb pair` for Wireless Debugging
 
 ::: tip
 `adb pair` wireless pairing (available in Android 11 and later via Developer Options) allows connection without a physical USB connection, unlike `adb tcpip`.
 :::
 
+::: steps
+
 1. On your phone, go to Developer Options, tap `Wireless Debugging` and enable it. Tap `Pair device with pairing code` and keep the popup open until pairing completes.
 
 2. Complete the pairing:
@@ -187,11 +201,17 @@ Wired connections don't need IP addresses or ports - just the device serial numb
 3. Enter the IP address and port shown on your device screen into MAA's `Settings` - `Connection Settings` - `Connection Address`, e.g., `192.168.1.2:11451`. **This is different from the address used for pairing**.
 4. Link Start!
 
+:::
+
 #### Using Root to Enable Wireless ADB
 
 ~~If you have access to root, why do you need to read this document~~
 
-1. Download, install [WADB](https://github.com/RikkaApps/WADB/releases) and grant it root privileges. 2.
-2. Open WADB and start wireless adb. 3.
+::: steps
+
+1. Download, install [WADB](https://github.com/RikkaApps/WADB/releases) and grant it root privileges.
+2. Open WADB and start wireless adb.
 3. Put the IP address and port provided by WADB into MAA `Settings` - `Connection` - `Connection Address`, such as `192.168.1.2:5555`.
 4. Link Start!
+
+:::

docs/en-us/manual/device/linux.md

@@ -19,7 +19,9 @@ The MAA WPF GUI can currently be run through Wine. MAA now uses self-contained d
 
 #### Installation Steps
 
-1. Install Visual C++ Redistributable:
+:::: steps
+
+1. Install Visual C++ Redistributable
 
    Download and install [Visual C++ Redistributable](https://aka.ms/vc14/vc_redist.x64.exe):
 
@@ -31,7 +33,11 @@ The MAA WPF GUI can currently be run through Wine. MAA now uses self-contained d
    `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`.
+2. Download MAA
+
+   Download the Windows version of MAA, extract it, and run `wine MAA.exe`.
+
+::::
 
 ::: info Note
 You need to set the ADB path to the [Windows version of `adb.exe`](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) in the connection settings.
@@ -66,52 +72,52 @@ Place the `MaaDesktopIntegration.so` generated by MAA Wine Bridge in the same di
 
 ### Using Python
 
-#### 1. Installing MAA Dynamic Library
+:::: steps
 
-1. Download and extract the Linux dynamic library from the [MAA website](https://maa.plus/), or install from a software repository:
-   - AUR: [maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights), follow the post-installation instructions
-   - Nixpkgs: [maa-assistant-arknights](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix)
+1. Install MAA Dynamic Library
+   1. Download and extract the Linux dynamic library from the [MAA website](https://maa.plus/), or install from a software repository:
+      - AUR: [maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights), follow the post-installation instructions
+      - Nixpkgs: [maa-assistant-arknights](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix)
+   2. Navigate to `./MAA-v{version}-linux-{architecture}/Python/` and open the `sample.py` file
 
-2. Navigate to `./MAA-v{version}-linux-{architecture}/Python/` and open the `sample.py` file
+   ::: tip
+   The precompiled version includes dynamic libraries compiled on relatively new Linux distributions (Ubuntu 22.04). If your system has an older libstdc++ version, you might encounter ABI incompatibility issues.
+   You can refer to the [Linux Compilation Tutorial](../../develop/linux-tutorial.md) to recompile or use a container solution.
+   :::
 
-::: tip
-The precompiled version includes dynamic libraries compiled on relatively new Linux distributions (Ubuntu 22.04). If your system has an older libstdc++ version, you might encounter ABI incompatibility issues.
-You can refer to the [Linux Compilation Tutorial](../../develop/linux-tutorial.md) to recompile or use a container solution.
-:::
+2. ADB Configuration
+   1. Find the line [`if asst.connect('adb.exe', '127.0.0.1:5554'):`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/b4fc3528decd6777441a8aca684c22d35d2b2574/src/Python/sample.py#L62)
+   2. ADB Tool Configuration
+      - If using `Android Studio`'s `AVD` emulator, it comes with ADB. You can directly specify the ADB path to replace `adb.exe`, typically found in `$HOME/Android/Sdk/platform-tools/`, for example:
 
-#### 2. ADB Configuration
+      ```python
+      if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator's ADB address"):
+      ```
 
-1. Find the line [`if asst.connect('adb.exe', '127.0.0.1:5554'):`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/b4fc3528decd6777441a8aca684c22d35d2b2574/src/Python/sample.py#L62)
+      - For other emulators, first install ADB: `$ sudo apt install adb`, then either specify the path or simply use `adb` if it's in your `PATH` environment variable.
 
-2. ADB Tool Configuration
-   - If using `Android Studio`'s `AVD` emulator, it comes with ADB. You can directly specify the ADB path to replace `adb.exe`, typically found in `$HOME/Android/Sdk/platform-tools/`, for example:
+   3. Getting the Emulator's ADB Address
+      - Use the ADB tool directly: `$ adb_path devices`, for example:
 
-   ```python
-   if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator's ADB address"):
-   ```
+      ```shell
+      $ /home/foo/Android/Sdk/platform-tools/adb devices
+      List of devices attached
+      emulator-5554 device
+      ```
 
-   - For other emulators, first install ADB: `$ sudo apt install adb`, then either specify the path or simply use `adb` if it's in your `PATH` environment variable.
+      - The returned `emulator-5554` is the emulator's ADB address. Replace `127.0.0.1:5555` with it, for example:
 
-3. Getting the Emulator's ADB Address
-   - Use the ADB tool directly: `$ adb_path devices`, for example:
+      ```python
+      if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):
+      ```
 
-   ```shell
-   $ /home/foo/Android/Sdk/platform-tools/adb devices
-   List of devices attached
-   emulator-5554 device
-   ```
+   4. Now you can test with `$ python3 sample.py`. If it returns "Connection successful," you're ready to proceed.
 
-   - The returned `emulator-5554` is the emulator's ADB address. Replace `127.0.0.1:5555` with it, for example:
+3. Task Configuration
 
-   ```python
-   if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):
-   ```
+   Custom tasks: Refer to the [Integration Documentation](../../protocol/integration.md) and modify the [`# Task parameters can be found in docs/integration.md`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) section in `sample.py`
 
-4. Now you can test with `$ python3 sample.py`. If it returns "Connection successful," you're ready to proceed.
-
-#### 3. Task Configuration
-
-Custom tasks: Refer to the [Integration Documentation](../../protocol/integration.md) and modify the [`# Task parameters can be found in docs/integration.md`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) section in `sample.py`
+::::
 
 ## Emulator Support
 
@@ -121,6 +127,8 @@ Requirements: 16:9 screen resolution larger than 720p
 
 Recommended configuration: x86_64 architecture (R - 30 - x86_64 - Android 11.0) with MAA's Linux x64 dynamic library
 
+Also supports [Screenshot Enhanced Mode](../connection.md#avd-screenshot-enhanced-mode).
+
 Note: Starting from Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode. Please switch to other touch modes, or **temporarily** switch SELinux to `Permissive` mode.
 
 ### ⚠️ [Genymotion](https://www.genymotion.com/)
@@ -146,10 +154,6 @@ waydroid prop set persist.waydroid.height 720
 
 To set up ADB IP address: Go to `Settings` - `About` - `IP address`, note the first `IP`, and use `${recorded IP}:5555` in `sample.py` for the ADB IP.
 
-If using amdgpu, the `screencap` command might output messages to stderr, causing image decoding failures.
-You can run `adb exec-out screencap | xxd | head` and check if there's text like `/vendor/etc/hwdata/amdgpu.ids: No such file...` in the output.
-If present, try changing the screenshot command in `resource/config.json` from `adb exec-out screencap` to `adb exec-out 'screencap 2>/dev/null'`.
-
 ### ✅ [redroid](https://github.com/remote-android/redroid-doc)
 
 Android 11 version images can run the game normally. Make sure to expose port 5555 for ADB.

docs/en-us/manual/device/macos.md

@@ -13,6 +13,8 @@ Experimental support. Please submit issues if you encounter problems, and includ
 
 Note: Due to macOS system limitations, screenshot issues may occur when minimizing the game window, switching to other windows while in Stage Manager, or moving the window to other desktops/screens. Related issue: [#4371](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/4371#issuecomment-1527977512)
 
+::: steps
+
 0. Requirements: MAA version v4.13.0-rc.1 or newer
 
 1. Download and install the [forked version of PlayCover](https://github.com/hguandl/PlayCover/releases).
@@ -29,13 +31,17 @@ Note: Due to macOS system limitations, screenshot issues may occur when minimizi
 
 7. Steps 3-5 only need to be done once. After that, just launch Arknights. After each Arknights client update, you'll need to repeat step 2.
 
+:::
+
 ### ✅ [MuMu Emulator Pro](https://mumu.163.com/mac/)
 
 Supported, but less thoroughly tested. Requires using a touch mode other than `MacPlayTools`. Related issue: [#8098](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/8098)
 
 ### ✅ [AVD](https://developer.android.com/studio/run/managing-avds)
 
-Supported, but starting from Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode. Please switch to other touch modes, or **temporarily** switch SELinux to `Permissive` mode.
+Supported; also supports [Screenshot Enhanced Mode](../connection.md#avd-screenshot-enhanced-mode).
+
+From Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode. Please switch to other touch modes, or **temporarily** switch SELinux to `Permissive` mode.
 
 ### ✅ [BlueStacks Air](https://www.bluestacks.com/mac) (Free, optimized for Apple M-series chips)
 
@@ -61,4 +67,6 @@ Note: On macOS, the Nox ADB binary is located at `/Applications/NoxAppPlayer.app
 
 ### ✅ [AVD](https://developer.android.com/studio/run/managing-avds)
 
-Supported, but starting from Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode. Please switch to other touch modes, or **temporarily** switch SELinux to `Permissive` mode.
+Supported; also supports [Screenshot Enhanced Mode](../connection.md#avd-screenshot-enhanced-mode).
+
+Starting from Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode. Please switch to other touch modes, or **temporarily** switch SELinux to `Permissive` mode.

docs/en-us/manual/device/windows.md

@@ -40,6 +40,11 @@ const fullySupport = [
         note: 'Fully compatible. Need to turn on ADB Connectivity in the emulator `Settings` → `Advanced` → `Android Debug Bridge` → `Enable`. Known to be compatible with Hyper-V.\n\n- Recommended to download [Offline Installer](https://support.bluestacks.com/hc/en-us/articles/4402611273485-BlueStacks-5-offline-installer) to avoid slow and bundled installation; recommend installing [Android 11](https://support.bluestacks.com/hc/en-us/articles/4402611273485-BlueStacks-5-offline-installer#:~:text=To%20install%20BlueStacks%205%20Android%2011) version; to uninstall it, please use the official [Uninstall Tool](https://support.bluestacks.com/hc/en-us/articles/360057724751-How-to-uninstall-BlueStacks-5-BlueStacks-X-and-BlueStacks-Services-completely-from-your-PC) to get rid of residues.\n- If the ADB port number keeps changing irregularly and is different every time you start it, it may be because your computer has [Hyper-V](https://support.bluestacks.com/hc/en-us/articles/4415238471053-System-requirements-for-BlueStacks-5-on-Hyper-V-enabled-Windows-10-and-11) enabled. MAA will now try to automatically read the port number from the BlueStacks emulator configuration file. If this doesn\'t work, or you need to use multiple instances, or have installed multiple emulator cores, please refer to [Connection Settings](../connection.html#bluestacks-emulator-hyper-v-port-number-changes-every-startup) to make adjustments. Since Hyper-V runs as administrator, operations that don\'t involve ADB such as automatic emulator shutdown or connection detection also need MAA to run as administrator.',
     },
     ...shuffleArray([
+        {
+            name: 'Tencent App Store',
+            link: 'https://sj.qq.com/',
+            note: 'Supports versions after 5.10.56.xx. Select `Tencent App Store` connection configuration in `Settings` - `Connection Settings`. Known to be compatible with Hyper-V.\n\n- ADB port is `127.0.0.1:5555`.\n- ADB path example: `C:\\Program Files\\Tencent\\Androws\\Application\\<version>\\adb.exe`.\n\n- You need to first [enable ADB debugging](https://sj.qq.com/faq/3878) in the app.',
+        },
         {
             name: 'Nox Player',
             link: 'https://www.bignox.com/',
@@ -67,7 +72,7 @@ const partiallySupport = shuffleArray([
     {
         name: 'AVD',
         link: 'https://developer.android.com/studio/run/managing-avds',
-        note: 'Theoretically supported.\n\n- Starting from Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode. Please switch to other touch modes, or **temporarily** switch SELinux to `Permissive` mode.\n- AVD is designed for development debugging, not gaming. Other emulators specifically designed for gaming are recommended instead.',
+        note: 'Theoretically supported, with additional support for [Screenshot Enhanced Mode](../connection.html#avd-screenshot-enhanced-mode).\n- Starting from Android 10, Minitouch is no longer available when SELinux is in `Enforcing` mode. Please switch to other touch modes, or **temporarily** switch SELinux to `Permissive` mode.\n- AVD is designed for development debugging, not gaming. Other emulators specifically designed for gaming are recommended instead.',
     },
     {
         name: 'Google Play Games (Developer)',

docs/en-us/manual/faq.md

@@ -1,5 +1,5 @@
 ---
-order: 2
+order: 3
 icon: ph:question-fill
 ---
 
@@ -54,6 +54,13 @@ For Windows N/KN (European/Korean versions), you also need to install the [Media
 
 Due to runtime libraries and system components requiring Windows 10 or above, MAA no longer supports Windows 7/8/8.1 systems.
 
+### Flagged by Windows Defender / antivirus software (PUA / malware)
+
+- First verify the download source. Only use official channels (official website, GitHub Releases, Winget, or official community distribution channels), and make sure you downloaded the full package (for example, `MAA-<version>-win-x64.zip`).
+- Automation tools may trigger heuristic detections in some antivirus engines. A detection result does not always mean the program is malicious.
+- If the source is trusted, submit a false-positive sample to the security vendor and wait for signature updates.
+- While waiting, you can temporarily add the MAA installation directory to antivirus allowlists. Avoid disabling real-time protection entirely.
+
 ## Connection errors
 
 ### Verify ADB and connection address are correct

docs/en-us/manual/install.md

@@ -0,0 +1,83 @@
+---
+order: 2
+icon: material-symbols:download-2-rounded
+---
+
+<!-- markdownlint-disable MD024 -->
+
+# Download & Installation
+
+::: tip
+You are viewing the MAA GUI download and installation guide. If you need the maa-cli download and installation instructions, see maa-cli's [Installation and Build](./cli/install.md). The Android variant (MAA Android) is currently in open testing — see [MAA-Meow](https://github.com/Aliothmoon/MAA-Meow) for details.
+:::
+
+## Downloading MAA
+
+MAA offers multiple download channels, including the official website, package managers, and group file shares. Choose the method that fits your environment.
+
+### Download the latest package from the [official website](https://maa.plus)
+
+The website usually selects the correct architecture automatically; for most readers this will be Windows x64. macOS users should choose the macOS universal build.
+
+### Download the latest package via [Mirror酱](https://mirrorchyan.com/zh/projects?rid=MAA&source=maadocs-install)
+
+Confirm your system architecture and download the matching package. Mirror酱 does not provide a macOS universal build — macOS users should select the package matching their chip architecture (arm/x86).
+
+::: tip
+[Mirror酱](https://mirrorchyan.com/zh/projects?rid=MAA&source=maadocs-install) is a third‑party, paid download acceleration service and is not operated by the MAA project. Its operating costs are covered by subscriptions and a portion of revenue is shared with project contributors. Consider subscribing to CDK for faster downloads and to support the project.
+:::
+
+### Install via Windows package manager (Winget)
+
+::: tip
+This method applies only to Windows users.
+:::
+
+Run the following command in a terminal:
+
+```bash
+winget install maa
+```
+
+When installed this way the default install path is `C:\Users\<username>\AppData\Local\Microsoft\WinGet\Packages`.
+
+### Download from the official QQ group files
+
+1. Join the [MAA official QQ group](https://api.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
+2. Download the latest MAA package from the group's shared files.
+
+### Download from [GitHub Releases](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
+
+Make sure to choose the package that matches your system architecture. For most Windows users download `MAA-<version>-win-x64.zip`. For macOS users choose `MAA-<version>-macos-universal.dmg`.
+
+## Linux and other operating systems
+
+MAA GUI is currently not supported on Linux or other operating systems. You can use `maa-cli` to access MAA functionality on those systems — see the maa-cli [Installation and Build](./cli/install.md) document for details.
+
+## Installing MAA
+
+### Windows
+
+After downloading you will have a `.zip` file. Extract it fully with your archive tool to obtain a folder containing all MAA files.
+
+::: warning
+
+1. Do not extract MAA to locations that require UAC elevation such as `C:\` or `C:\Program Files\`.
+2. MAA includes a bundled .NET runtime (self-contained deployment), but it still requires the Visual C++ Redistributable x64 (VCRedist x64). After extraction, run `DependencySetup_依赖库安装.bat` in the MAA directory as administrator to install the required dependencies. After installation completes, run `MAA.exe`.
+
+For more information see the top of the [FAQ](./faq.md).
+:::
+
+Double-click `MAA.exe` to start MAA.
+
+::: tip
+If you installed via Winget you can start MAA by running `maa` from the command line without extracting the archive or installing runtimes manually. If `maa-cli` is on your PATH you may need extra steps to disambiguate the two.
+:::
+
+### macOS
+
+Open the downloaded `.dmg` and drag `MAA.app` to `/Applications` to complete installation.
+
+## Next steps
+
+After installation, return to the [New User Guide](./newbie.md) to continue setup, or visit [Introduction](./introduction/) to learn about MAA's features. If you encounter problems during installation, check the [FAQ](./faq.md) for troubleshooting tips.

docs/en-us/manual/introduction/combat.md

@@ -40,7 +40,7 @@ icon: hugeicons:brain-02
   Ensure you're on the stage details screen with the stage name and remaining sanity in the upper right and auto-deploy/start buttons in the lower right.
 - If you're not on this screen, `Current/Last` will automatically enter the "last operation" stage shown on the bottom right of the terminal home screen.
 - You can also enable `Manual entry of stage names` in `Task Settings` - `Sanity Farming` - `Advanced Settings` to manually input stage codes. Currently supported stages include:
-  - All main story stages. You can add `-NORMAL` or `-HARD` at the end to switch between normal and challenge modes.
+  - All main story stages. You can add `-NORMAL` or `-HARD` at the end to switch difficulty: Chapters 10-14 map to Standard/Adverse, while Chapters 15+ map to Normal/Raid.
   - Resource stages like CE-6/LS-6 (LMD/EXP). Enter the exact code like `CE-6` or `LS-6`. MAA will automatically switch to level 5 if level 6 isn't available.
   - Skill summary, voucher, and carbon stages (level 5 only). Enter exact codes like `CA-5`, `AP-5`, or `SK-5`.
   - All chip stages. Enter complete stage codes like `PR-A-1`.

docs/en-us/manual/introduction/reclamation-algorithm.md

@@ -7,15 +7,53 @@ icon: solar:streets-map-point-linear
 
 Currently, support for Reclamation Algorithm is still in early stages and unattended operation is not recommended, as stability cannot be guaranteed at this time.
 
-## Default Mode
+## Tales Within the Sand
+
+### Default Mode
 
 1. You need to start the task from the Reclamation Algorithm main interface (navigation not yet implemented)
 2. Cannot be used when you already have an existing save file (delete the existing save to use)
 3. Cannot be used when operators are present in the Reclamation Algorithm squad (clear the current squad, especially after completing a wave)
 
-## Manufacturing Points Farm
+### Manufacturing Points Farm
 
 1. You need to start from the page where you can see the base camp after entering Reclamation Algorithm
 2. If no item name is specified, Glow Sticks will be crafted by default
 3. Prerequisite: It must be the first day after settlement, with no enemy raids entering the base camp for the next three days
 4. If the manufacturable quantity is exactly a multiple of 99, the process may get stuck. You can use up a small amount before saving; this issue will be fixed in the future
+
+## Relaunch Anchor
+
+### RA-1
+
+- Income reference: ~159 tokens + coordination points per run, ~2 min 10 sec per cycle
+- Operator requirement: None
+- Prerequisite: Complete RA-1 in the main storyline
+- Open RA-1 on the world map, start the task when "Start Construction" appears in the bottom-right corner
+- Note: If you have unlocked technologies that grant extra starting items, please remove facilities that cause this (e.g. Food Supply Station, Drink Supply Station, Large Beast Pen, etc.)
+- Task flow: Automatically executes intensive farming, construction, resource delivery, and settlement loop
+
+### RA-4
+
+- Reward estimate: ~417 tokens + coordination points per run, ~1 min 40 sec per round
+- Operator requirement: Wis'adel (support unit allowed)
+- Prerequisite:
+  1. Advance the main story until RA-4 is cleared.
+  2. Unlock Strategy Planning Management.
+  3. If you have your own Wis'adel, manually enter the stage and form a team once, ensuring any 5 operators with lower DP cost than Wis'adel + Wis'adel, and Wis'adel is in the 6th slot (i.e., the last one selected). Then confirm recruitment, abandon the current construction, and start from "Start Construction".
+  4. If using a support Wis'adel, ensure that Wis'adel is on the front page of sniper support units (consider using a friend). Manually enter the stage and add any 5 operators with lower DP cost than Wis'adel, select support Wis'adel for the 6th slot, then confirm recruitment, abandon the current construction, and start from "Start Construction" (ensure the first five slots have operators and the 6th slot is empty).
+- Open RA-4 on the world map, start the task when "Start Construction" appears in the bottom-right corner
+- Note: If you have unlocked technologies that grant extra starting items, please remove facilities that cause this (e.g. Food Supply Station, Drink Supply Station, Large Beast Pen, etc.)
+- Task flow: Use the Gold from Strategy Planning Management to unlock areas, and use Wis'adel to complete the boss elimination mission.
+
+### RA-15
+
+- Income reference: ~500 tokens + coordination points per run, ~3 min per cycle
+- Operator requirement: Civilight Eterna (can use support unit)
+- Prerequisites:
+  1. Complete RA-15 in the main storyline
+  2. If you own Civilight Eterna, manually open the stage and set up the squad once: 5 Vanguards (no level requirement) + Civilight Eterna in the 6th slot, then save and exit
+  3. If using support Civilight Eterna, ensure she appears on the first page of Caster supports
+- Open RA-15 on the world map, start the task when "Start Construction" appears in the bottom-right corner
+- Note: If you have unlocked technologies that grant extra starting items, please remove facilities that cause this (e.g. Food Supply Station, Drink Supply Station, Large Beast Pen, etc.)
+- Task flow: Complete the 60-kill mission with Civilight Eterna

docs/en-us/manual/introduction/recruit.md

@@ -11,10 +11,14 @@ Auto Recruitment and [Recruitment Recognition](./tools.md#recruitment-recognitio
 
 Supports automatic use of `Expedited Plans`, allows setting maximum recruitment times per task, and can be combined with `Auto use Expedited Plans` to quickly use up all recruitment permits.
 
-Pop-up notifications will appear when 1★, 5★, or 6★ tags are detected.
+Pop-up notifications will appear when preserved tags, 5★ tags, or 6★ tags are detected.
 
 Recruitment tag data is automatically uploaded to [Penguin Statistics](https://penguin-stats.io/) and [Yituliu](https://ark.yituliu.cn/) when refreshing recruitment.
 
 ## Advanced Settings
 
 `Auto confirm` means MAA automatically selects tags and performs recruitment, while `Manual confirm` means no automatic tag selection or recruitment is performed.
+
+After enabling `Preferred 3★ tags`, you can choose which 3★ tags should be preferred. After enabling `Preserve selected tags`, you can choose which tags should keep the current slot untouched.
+
+When any preserved tag is recognized, MAA skips the current recruitment slot and leaves it unchanged instead of confirming that recruitment.

docs/en-us/manual/introduction/startup.md

@@ -18,6 +18,7 @@ Only supports switching to already logged-in accounts, using the login name for
 - Examples:
   - Official server: `123****8901` can be entered as `123****8901`, `123`, `8901`, or `3****8`
   - Bilibili server: `Zhang San` can be entered as `Zhang San`, `Zhang`, or `San`
+  - Traditional Chinese server: Email-based, e.g. `ab****01@gmail.com`. Entering the plain-text portion without asterisks is recommended, e.g. `01@gmail`
 
 ## Connection Settings
 

docs/en-us/manual/introduction/tools.md

@@ -11,26 +11,32 @@ Open the Recruitment tag interface and click Start Recognition to initiate.
 
 If you have previously run Operator Recognition, potential data will be displayed after the recognized operator's name.
 
-## Operator Recognition (Beta)
+## Operator Recognition
 
 Can recognize lists of both owned and unowned operators, and identify potential levels to provide data for Recruitment Recognition.
 
-## Depot Recognition (Beta)
+Currently supports the following export formats:
+
+- Clipboard
+- JSON
+- Markdown table
+- CSV table
+
+## Depot Recognition
 
 Supports automatically entering the depot from the main page. If automatic navigation fails, please manually switch to the `Upgrade Materials` screen and **scroll all the way to the left** before starting the function.
 
-Currently supports exporting to [Penguin Statistics Planner](https://penguin-stats.io/planner), [Arknights Toolbox](https://arkntools.app/#/material), and [Arknights | Planner](https://ark-nights.com/settings).
+Currently supports the following export formats:
+
+- [Penguin Statistics Planner](https://penguin-stats.io/planner) (ArkPlanner)
+- [Arknights Toolbox](https://arkntools.app/#/material) (Lolicon)
+- Markdown table
+- CSV table
 
 If you are the administrator of a data site, we welcome you to contact us to adapt your site's material JSON protocol!
 
 More useful features may be added in the future. (Teaser)
 
-## Task Video Recognition (Alpha)
-
-Can recognize strategy videos and automatically generate operation files. Simply drag video files into the Auto Combat page to start.
-
-Requires 16:9 aspect ratio with 720p or higher resolution, with no black borders, emulator frames, notched screen adaptations, or other interfering elements.
-
 ## Gacha
 
 ::: center
@@ -48,3 +54,15 @@ Want to see the world through MAA's eyes? Now you can!
 MAA will attempt to take screenshots of the emulator at the target frame rate and display them in real-time in the window.
 
 When the screenshot speed is significantly slower than the target frame rate, MAA will automatically reduce the target frame rate to match the screenshot speed. ~~Can be used as a stress test~~
+
+## Mini Game
+
+Used to automatically farm mini-games in events. Supports selecting names and switching between permanent and current limited-time activities in settings.
+
+Built-in features include:
+
+- Event shop exchange
+- Green ticket shop exchange
+- Yellow ticket shop exchange
+- Reclamation Algorithm shop exchange
+- Secret Front (supports selecting endings and event branches)

docs/en-us/protocol/base-scheduling-schema.md

@@ -137,6 +137,6 @@ Please note that JSON files do not support comments. The comments in this docume
 
 ## Example
 
-[243_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
+[243_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master-v2/resource/custom_infrast/243_layout_3_times_a_day.json)
 
-[153_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
+[153_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master-v2/resource/custom_infrast/153_layout_3_times_a_day.json)

docs/en-us/protocol/callback-schema.md

@@ -224,7 +224,7 @@ Todo
 - `MedicineConfirm`  
   Use sanity potion
 - `ExpiringMedicineConfirm`  
-  Use sanity potion expiring within 48 hours
+  Use expiring sanity potion
 - `StoneConfirm`  
   Use Originium Prime
 - `RecruitRefreshConfirm`  
@@ -355,6 +355,16 @@ Todo
   }
   ```
 
+- `RecruitPreservedTag`  
+  Recruitment preserved tag detected
+
+  ```json
+  // Corresponding details field example
+  {
+    "tag": "支援机械" // "Robot"
+  }
+  ```
+
 - `RecruitResult`  
   Recruitment recognition result
 

docs/en-us/protocol/integrated-strategy-schema.md

@@ -829,14 +829,6 @@ For farming hidden Collapsal Paradigms, N10 difficulty is recommended, with the
 
 MAA automatically handles copper pickup and exchange in JieGarden I.S.:
 
-::: tip Enable Conditions
-Copper exchange functionality is only enabled in the following modes:
-
-- Investment Mode: Requires "Investment mode enable shopping, recruitment, advance 2 floors" option enabled
-- Other Modes: Enabled by default
-
-:::
-
 1. **Pickup Dropped Coppers**: After battle ends, if copper drop selection interface appears, MAA will select the copper with highest `pickup_priority`
 
 2. **Exchange Wallet Coppers**: When a newly picked copper needs to be exchanged with coppers in the wallet:

docs/en-us/protocol/integration.md

@@ -64,6 +64,8 @@ Only supports switching to already logged-in accounts, using login name for iden
 Official server: `123****4567`, can input `123****4567`, `4567`, `123`, or `3****4567`  
 <br>
 Bilibili server: `Zhang San`, can input `Zhang San`, `Zhang`, or `San`  
+<br>
+Traditional Chinese server: Email-based, e.g. `ab****01@gmail.com`. Entering the plain-text portion without asterisks is recommended, e.g. `01@gmail`  
 :::  
 ::::
 
@@ -118,7 +120,7 @@ Whether to enable this task.
 Stage name, by default empty, recognizes current/last stage. Editing in run-time is not supported.  
 Currently supported stages for navigation include:
 
-- All mainline stages. You can add `-NORMAL` or `-HARD` at the end of the stage to switch between standard or challenge mode.
+- All mainline stages. You can add `-NORMAL` or `-HARD` at the end of the stage to switch difficulty: Chapters 10-14 map to Standard/Adverse, while Chapters 15+ map to Normal/Raid.
 - For LMD and Battle Record stages 5/6, must input `CE-6` / `LS-6`. MAA will automatically switch to stage 5 if stage 6 cannot be delegated.
 - Skill Summary, Voucher, and Carbon stage 5, must input `CA-5` / `AP-5` / `SK-5`.
 - All chip stages. Must input complete stage code, e.g. `PR-A-1`.
@@ -134,8 +136,11 @@ Currently supported stages for navigation include:
   ::: field name="medicine" type="number" optional default="0"  
   Maximum number of Sanity Potions used.  
   :::  
-  ::: field name="expiring_medicine" type="number" optional default="0"  
-  Maximum number of Sanity Potions expiring within 48 hours.  
+  ::: field name="medicine_expire_days" type="number" optional default="0"  
+  Use Sanity Potions that expire within the specified number of days. `0` means no expiring potions will be used.  
+  :::  
+  ::: field name="expiring_medicine" type="number" optional default="0" deprecated  
+  Deprecated since v6.8.0, please use `medicine_expire_days` instead.  
   :::  
   ::: field name="stone" type="number" optional default="0"  
   Maximum number of Originite Prime used.  
@@ -197,7 +202,7 @@ Currently supported stages for navigation include:
    "enable": true,
    "stage": "1-7",
    "medicine": 1,
-   "expiring_medicine": 0,
+   "medicine_expire_days": 2,
    "stone": 0,
    "times": 10,
    "series": 0,
@@ -259,7 +264,14 @@ Whether to use Expedited Plans.
 Number of expedites, only effective when `expedite` is true. By default unlimited (until `times` limit is reached).  
 :::  
 ::: field name="skip_robot" type="boolean" optional default="true"  
-Whether to skip when robot tag is recognized.  
+Deprecated and kept only for backward compatibility.  
+<br>
+When `preserve_tags` is absent and this value is `true`, MAA skips on `支援机械` only; `元素` is no longer treated as the legacy 1★ tag.  
+:::
+::: field name="preserve_tags" type="array<string>" optional  
+List of tag names that should preserve the current recruitment slot and skip this recruitment. Default is empty.  
+<br>
+If any specified tag is recognized, MAA will keep that slot untouched and skip the current recruitment.  
 :::  
 ::: field name="recruitment_time" type="object" optional  
 Tag ★ rarity (greater than or equal to 3) and corresponding desired recruitment time limit, in minutes, all default to 540 (i.e. 09:00:00).
@@ -300,7 +312,7 @@ Options: `CN` | `US` | `JP` | `KR`
    "set_time": true,
    "expedite": false,
    "expedite_times": 0,
-   "skip_robot": true,
+   "preserve_tags": ["支援机械"],
    "recruitment_time": {
       "3": 540,
       "4": 540
@@ -911,32 +923,44 @@ Whether to enable this task.
 ::: field name="enable" type="boolean" optional default="true"  
 Whether to enable this task.  
 :::  
-::: field name="theme" type="string" optional default="Fire"  
+::: field name="theme" type="string" optional default="Tales"  
 Theme.
 <br>
-`Fire` - _Fire Within the Sand_
+`Fire` - _Fire Within the Sand_ (Closed)
 <br>
 `Tales` - _Tales Within the Sand_
+<br>
+`RelaunchAnchor` - _Relaunch Anchor_
 :::  
 ::: field name="mode" type="number" optional default="0"  
-Mode.
+Mode. Supported modes vary by theme:
 <br>
-`0` - Farm badges & construction pts (exiting the stage immediately).
+**Tales:**
 <br>
-`1` - Fire Within the Sand: Farm Crude Gold (forging Gold at headquarter after purchasing water); Tales Within the Sand: Automatically craft items and load to earn currency.
+`0` - No save, farm prosperity points by entering and exiting stages.
+<br>
+`1` - With save, farm currency by crafting support items.
+<br>
+**RelaunchAnchor:**
+<br>
+`16` (`RA1`) - RA-1, automatically execute intensive farming, construction, resource delivery, and settlement loop.
+<br>
+`32` (`RA15`) - RA-15, complete the 60-kill mission with Civilight Eterna.
+<br>
+`48` (`RA4`) - RA-4, Use the Gold from Strategy Planning Management to unlock areas, and use Wis'adel to complete the boss elimination mission.
 :::  
 ::: field name="tools_to_craft" type="array<string>" optional default="[&quot;荧光棒&quot;]"  
-Automatically crafted items. Suggested to fill in the substring.  
+Automatically crafted items. Suggested to fill in the substring. Only effective for Tales theme.  
 :::  
 ::: field name="increment_mode" type="number" optional default="0"  
-Click type.
+Click type. Only effective for Tales theme.
 <br>
 `0` - Rapid Click
 <br>
 `1` - Long Press
 :::  
 ::: field name="num_craft_batches" type="number" optional default="16"  
-Maximum number of craft batches per session.  
+Maximum number of craft batches per session. Only effective for Tales theme.  
 :::  
 ::::
 
@@ -1146,10 +1170,10 @@ value
 Invalid placeholder. Enum value: 0.  
 :::  
 ::: field name="MinitouchEnabled" type="boolean" optional  
-Deprecated. Originally for enabling minitouch; "1" - on, "0" - off. Note that the device may not support it. Enum value: 1 (deprecated).  
+Deprecated. Originally for enabling Minitouch; "1" - on, "0" - off. Note that the device may not support it. Enum value: 1 (deprecated).  
 :::  
 ::: field name="TouchMode" type="string" optional default="minitouch"  
-Touch mode setting. Options: minitouch | maatouch | adb. Default minitouch. Enum value: 2.  
+Touch mode setting. Options: minitouch | maatouch | adb | MaaFwAdb. Default minitouch. Enum value: 2.  
 :::  
 ::: field name="DeploymentWithPause" type="boolean" optional  
 Whether to pause when deploying operators (affects IS, Copilot and Stationary Security Service). Options: "1" | "0". Enum value: 3.  
@@ -1160,4 +1184,7 @@ Whether to enable AdbLite or not. Options: "0" | "1". Enum value: 4.
 ::: field name="KillAdbOnExit" type="boolean" optional  
 Release Adb on exit. Options: "0" | "1". Enum value: 5.  
 :::  
+::: field name="ClientType" type="string" optional  
+Client channel. Most connection configs do not need this option. Set it before `AsstConnect` / `AsstAsyncConnect` only when the selected `config` uses `[PackageName]` in commands executed during connect. In the built-in configs, only `Androws` and `WSA` currently require it for `displayId` lookup. This does not replace the `client_type` task parameter used by StartUp / CloseDown tasks. Enum value: 6.  
+:::  
 ::::

docs/ja-jp/develop/development.md

@@ -84,7 +84,9 @@ icon: iconoir:developer
    - F5 キーを押して実行
 
    ::: tip
-   Win32Controller（Windows ウィンドウ制御）関連機能をデバッグする場合は、[MaaFramework Releases](https://github.com/MaaXYZ/MaaFramework/releases) から対応プラットフォームのアーカイブをダウンロードし、`bin` ディレクトリ内の `MaaWin32ControlUnit.dll` を MAA の DLL と同じディレクトリ（例：`build/bin/Debug`）に配置してください。自動ダウンロードスクリプトの PR 歓迎！
+   Win32Controller（Windows ウィンドウ制御）/ MaaFwAdbController（MaaFramework のタッチモード）関連機能を実行する場合は、[MaaFramework Releases](https://github.com/MaaXYZ/MaaFramework/releases) から対応プラットフォームのアーカイブをダウンロードし、`bin` ディレクトリ内の `MaaWin32ControlUnit.dll` / `MaaAdbControlUnit.dll` を MAA の DLL と同じディレクトリ（例：`build/bin/Debug`）に配置してください。自動ダウンロードスクリプトの PR 歓迎！
+
+   関連機能をデバッグする場合は、[MaaFramework の Debug バージョンを自分でコンパイル](https://maafw.com/docs/4.1-BuildGuide)し、対応する DLL ファイルを使用する必要があります。そうしないと、ブレークポイントデバッグ中に謎のクラッシュが発生します。
    :::
 
 9. これで自由に ~~改造~~ 開発を始められます

docs/ja-jp/develop/documentation-guidelines.md

@@ -23,6 +23,8 @@ icon: jam:write-f
 
 このテーマでは、ヒント、ノート、情報、注意、警告、詳細などのカスタムコンテナをサポートしており、これらの機能を利用して特定のコンテンツを強調することができます。
 
+コンテナ内にコンテナをネストする場合、親コンテナは子コンテナよりもコロン `:` を1つ多く記述する必要があります。
+
 コンテナの使用方法：
 
 ```markdown
@@ -31,6 +33,13 @@ icon: jam:write-f
 :::
 ```
 
+または GitHub スタイルの構文を使用する方法：
+
+```markdown
+> [!コンテナの種類]
+> 書きたい内容
+```
+
 受け入れられるコンテナの内容とデフォルトのタイトルは次のとおりです：
 
 - `tip` ヒント
@@ -39,6 +48,7 @@ icon: jam:write-f
 - `warning` 注意
 - `danger` 警告
 - `details` 詳細
+- `window` ==特殊なコンテナ==
 
 ### コンテナの例
 
@@ -66,6 +76,190 @@ icon: jam:write-f
 これは詳細のコンテナです
 :::
 
+::: window
+これは特殊なコンテナです
+:::
+
+## マーカー
+
+マーカー構文を使用して、強調したい内容にマークを付けることができます。
+
+使用方法：`==マーカーの内容=={マーカーの色（オプション）}` の構文でマークを付けます。両端にスペースが必要な点に注意してください。
+
+**入力：**
+
+```markdown
+MaaAssistantArknights は ==たくさんの豚== によって開発されました
+```
+
+**出力：**
+
+MaaAssistantArknights は ==たくさんの豚== によって開発されました
+
+テーマには以下のカラースキームが組み込まれています：
+
+- **default**: `==Default==` - ==Default==
+- **info**: `==Info=={.info}` - ==Info=={.info}
+- **note**: `==Note=={.note}` - ==Note=={.note}
+- **tip**: `==Tip=={.tip}` - ==Tip=={.tip}
+- **warning**: `==Warning=={.warning}` - ==Warning=={.warning}
+- **danger**: `==Danger=={.danger}` - ==Danger=={.danger}
+- **caution**: `==Caution=={.caution}` - ==Caution=={.caution}
+- **important**: `==Important=={.important}` - ==Important=={.important}
+
+## 隠しテキスト
+
+何らかの理由でドキュメントの一部を一時的に隠す必要がある場合、隠しテキスト機能を使用できます。
+
+`!!隠したい内容!!{設定（オプション）}` の構文で使用でき、デフォルトの効果は以下の通りです：
+
+!!なんかニコニコ大百科（仮）を読んでる気がする（取り消し線!!
+
+以下の設定が使用できます：
+
+::: window
+入力：
+
+```markdown
++ マスクエフェクト + マウスホバー：!!マウスホバーで見えます!!{.mask .hover}
++ マスクエフェクト + クリック：!!クリックで見えます!!{.mask .click}
++ テキストぼかしエフェクト + マウスホバー：!!マウスホバーで見えます!!{.blur .hover}
++ テキストぼかしエフェクト + クリック：!!クリックで見えます!!{.blur .click}
+```
+
+出力：
+
+- マスクエフェクト + マウスホバー：!!マウスホバーで見えます!!{.mask .hover}
+- マスクエフェクト + クリック：!!クリックで見えます!!{.mask .click}
+- テキストぼかしエフェクト + マウスホバー：!!マウスホバーで見えます!!{.blur .hover}
+- テキストぼかしエフェクト + クリック：!!クリックで見えます!!{.blur .click}
+
+:::
+
+## ステップ
+
+ステップバイステップのチュートリアルを書くとき、番号付きリストはネストによって階層感を失うことがあります。そのような場合、`steps` コンテナが最善の選択です。
+
+入力：
+
+````markdown
+:::: steps
+1. ステップ 1
+
+   ```ts
+   console.log('Hello World!')
+   ```
+
+2. ステップ 2
+
+   ステップ 2 の関連内容はこちら
+
+3. ステップ 3
+
+   ::: tip
+   ヒントコンテナ
+   :::
+
+4. 終わり
+::::
+````
+
+出力：
+
+:::: steps
+
+1. ステップ 1
+
+   ```ts
+   console.log('Hello World!')
+   ```
+
+2. ステップ 2
+
+   ステップ 2 の関連内容はこちら
+
+3. ステップ 3
+
+   ::: tip
+   ヒントコンテナ
+   :::
+
+4. 終わり
+
+::::
+
+## スマート画像コンテナ
+
+テーマが提供する機能をベースに画像コンテナをラッパーしました。このコンテナはライト/ダークテーマに応じて対応する画像を自動的に表示し、自動レイアウトをサポートします。
+
+Markdown 本文で `<ImageGrid>` コンポーネントを使用してこのメソッドを呼び出すことができます。具体的な構文と効果は以下の通りです：
+
+::: window
+
+構文：
+
+```markdown
+<ImageGrid :imageList="[
+  {
+    light: 'images/zh-cn/readme/1-light.png',
+    dark: 'images/zh-cn/readme/1-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/2-light.png',
+    dark: 'images/zh-cn/readme/2-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/3-light.png',
+    dark: 'images/zh-cn/readme/3-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/4-light.png',
+    dark: 'images/zh-cn/readme/4-dark.png'
+  }
+]" />
+```
+
+レンダリング結果：
+
+<ImageGrid :imageList="[
+  {
+    light: 'images/zh-cn/readme/1-light.png',
+    dark: 'images/zh-cn/readme/1-dark.png'
+  },
+  {
+    light: 'images/zh-cn/readme/2-light.png',
+    dark: 'images/zh-cn/readme/2-dark.png'
+  }
+]" />
+
+:::
+
+## フィールドコンテナ
+
+この構文はやや複雑なため、[公式ドキュメント](https://theme-plume.vuejs.press/guide/markdown/field/)を参照して使用してください。
+
+効果は以下の通りです：
+
+:::: field-group
+::: field name="theme" type="ThemeConfig" required default="{ base: '/' }"
+テーマ設定
+:::
+
+::: field name="enabled" type="boolean" optional default="true"
+有効かどうか
+:::
+
+::: field name="callback" type="(...args: any[]) => void" optional default="() => {}"
+<Badge type="tip" text="v1.0.0 追加"  />
+コールバック関数
+:::
+
+::: field name="other" type="string" deprecated
+<Badge type="danger" text="v0.9.0 廃止"  />
+廃止されたプロパティ
+:::
+::::
+
 ## アイコン
 
 このテーマではアイコンがサポートされており、次の場所でアイコンを使用できます:

docs/ja-jp/develop/linux-tutorial.md

@@ -8,7 +8,8 @@ icon: teenyicons:linux-alt-solid
 **このチュートリアルでは、読者にLinux環境の構成能力とプログラミングの基礎が必要です！**
 
 ::: info 注意
-MAAの構築方法はまだ議論されていますが、このチュートリアルの内容は古くなる可能性があります。 [GitHub workflow file](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/workflows/ci.yml#L134) のスクリプトに準拠してください
+MAAの構築方法はまだ議論されていますが、このチュートリアルの内容は古くなる可能性があります。[GitHub workflow file](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev-v2/.github/workflows/ci.yml#L224#:~:text=ubuntu%3A) のスクリプトに準拠してください。  
+また、[AUR PKGBUILD](https://aur.archlinux.org/cgit/aur.git/tree/PKGBUILD?h=maa-assistant-arknights) や [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-assistant-arknights/package.nix) も参照可能です。
 :::
 
 ## コンパイルプロセス
@@ -56,6 +57,8 @@ MAAの構築方法はまだ議論されていますが、このチュートリ
    cmake --install build --prefix <target_directory>
    ```
 
+4. MaaFwAdbController（MaaFramework のタッチモード）関連機能をデバッグする場合は、[MaaFramework の Debug バージョンを自分でコンパイル](https://maafw.com/docs/4.1-BuildGuide)し、`libMaaAdbControlUnit.so` をインストールディレクトリにコピーする必要があります。
+
 ## その他のインストール方法
 
 - AUR: [maa-assistant-arknights](https://aur.archlinux.org/packages/maa-assistant-arknights)

docs/ja-jp/manual/cli/config.md

@@ -199,7 +199,7 @@ strategy = "merge" # 或者 "first" (默认)
 
 # 在周天晚上使用所有的将要过期的理智药
 [[tasks.variants]]
-params = { expiring_medicine = 1000 }
+params = { medicine_expire_days = 2 }
 
 [tasks.variants.condition]
 type = "And"

docs/ja-jp/manual/cli/install.md

@@ -1,23 +1,19 @@
 ---
 order: 1
-icon: material-symbols:download
+icon: material-symbols:download-2-rounded
 ---
 
-# 安装及编译
+# インストールとコンパイル
 
-::: important Translation Required
-This page is outdated and maybe still in Simplified Chinese. Translation is needed.
-:::
+maa-cli は、プリコンパイル済みバイナリ、パッケージマネージャー、または `cargo` を使用した自己コンパイルなど、複数のインストール方法を提供しています。
 
-maa-cli 提供多种方式安装，包括预编译二进制文件、包管理器和通过 `cargo` 自行编译安装。
+## プリコンパイル済みバイナリ
 
-## 预编译二进制文件
-
-安装 maa-cli 最简单的方式是使用安装脚本一键安装：
+maa-cli をインストールする最も簡単な方法は、インストールスクリプトを使用する方法です：
 
 ::: tabs#pre-compile
 
-@tab:active Linux 和 macOS
+@tab:active Linux と macOS
 
 ```bash
 curl -fsSL https://raw.githubusercontent.com/MaaAssistantArknights/maa-cli/main/install.sh | bash
@@ -31,27 +27,27 @@ Invoke-WebRequest -Uri "https://raw.githubusercontent.com/MaaAssistantArknights/
 
 :::
 
-后续你可以通过 `maa self update` 来更新 maa-cli。
+その後、`maa self update` コマンドで maa-cli を更新できます。
 
-如果你的平台不在上述列表中，可以尝试自行[编译安装](#编译安装)。
+お使いのプラットフォームが上記のリストにない場合は、[コンパイルによるインストール](#コンパイルによるインストール)を試してみてください。
 
-## 通过包管理器安装
+## パッケージマネージャーによるインストール
 
-对于 macOS 和受支持的 Linux 发行版用户，可以使用包管理器安装 maa-cli。
+macOS および対応している Linux ディストリビューションユーザーは、パッケージマネージャーを使用して maa-cli をインストールできます。
 
 ### macOS
 
-Homebrew 用户可以通过非官方的 [tap](https://github.com/MaaAssistantArknights/homebrew-tap/) 安装 maa-cli：
+Homebrew ユーザーは、非公式の [tap](https://github.com/MaaAssistantArknights/homebrew-tap/) を使用して maa-cli をインストールできます：
 
 ::: code-tabs
 
-@tab:active 稳定版
+@tab:active 安定版
 
 ```bash :no-line-numbers
 brew install MaaAssistantArknights/tap/maa-cli
 ```
 
-@tab 不稳定版/预发行版
+@tab 不安定版/プレリリース版
 
 ```bash :no-line-numbers
 brew install MaaAssistantArknights/tap/maa-cli-beta
@@ -61,11 +57,11 @@ brew install MaaAssistantArknights/tap/maa-cli-beta
 
 ### Linux
 
-Arch、Nix 以及 Linux Homebrew 用户可以通过包管理器安装 maa-cli。
+Arch、Nix、および Linux Homebrew ユーザーは、パッケージマネージャーを使用して maa-cli をインストールできます。
 
 #### Arch Linux
 
-可以安装 [AUR 包](https://aur.archlinux.org/packages/maa-cli/)：
+[AURパッケージ](https://aur.archlinux.org/packages/maa-cli/) をインストールできます：
 
 ::: code-tabs
 
@@ -85,17 +81,17 @@ yay -S maa-cli
 
 #### ❄️ Nix
 
-用户可以直接运行:
+ユーザーは直接実行できます：
 
 ::: code-tabs
 
-@tab:active 稳定版
+@tab:active 安定版
 
 ```bash :no-line-numbers
 nix run nixpkgs#maa-cli
 ```
 
-@tab 每夜构建
+@tab ナイトリービルド
 
 ```bash :no-line-numbers
 nix run github:Cryolitia/nur-packages#maa-cli-nightly
@@ -103,31 +99,31 @@ nix run github:Cryolitia/nur-packages#maa-cli-nightly
 
 :::
 
-稳定版打包至 [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-cli/package.nix) 中，使用 `nixpkgs` 中的 Rust 工具链；每夜构建位于 [NUR](https://github.com/Cryolitia/nur-packages/blob/master/pkgs/maa-assistant-arknights/maa-cli.nix) 中，使用 Beta channel 的 Rust 工具链，由 Github Actions 每日自动更新和构建验证。
+安定版は [nixpkgs](https://github.com/NixOS/nixpkgs/blob/nixos-unstable/pkgs/by-name/ma/maa-cli/package.nix) にパッケージされており、`nixpkgs` の Rust ツールチェーンを使用します。ナイトリービルドは [NUR](https://github.com/Cryolitia/nur-packages/blob/master/pkgs/maa-assistant-arknights/maa-cli.nix) にあり、Rust ツールチェーンのベータチャンネルを使用し、GitHub Actions によって毎日自動更新およびビルド検証が行われます。
 
 #### Homebrew
 
-对于在 Linux 上使用 Homebrew 的用户，请参见上述 macOS 的安装方式。
+Linux で Homebrew を使用するユーザーは、上記の macOS のインストール方法を参照してください。
 
-#### 其他发行版
+#### その他のディストリビューション
 
-请使用 [预编译二进制文件](#预编译二进制文件) 或是 [自行编译安装](#编译安装)。
+[プリコンパイル済みバイナリ](#プリコンパイル済みバイナリ)を使用するか、[コンパイルによるインストール](#コンパイルによるインストール)を行ってください。
 
-我们也欢迎各位有兴趣的开发者将 maa-cli 提交到更多发行版的官方仓库或是用户仓库！
+また、maa-cli をより多くのディストリビューションの公式リポジトリやユーザーリポジトリに提出してくださる開発者の方々も歓迎します！
 
-## 编译安装
+## コンパイルによるインストール
 
-Rust 开发者可以通过 `cargo` 自行编译安装 maa-cli：
+Rust 開発者は、`cargo` を使用して maa-cli を自己コンパイルできます：
 
 ::: code-tabs
 
-@tab:active 稳定版本
+@tab:active 安定バージョン
 
 ```bash :no-line-numbers
 cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --tag stable --locked
 ```
 
-@tab 开发版本
+@tab 開発バージョン
 
 ```bash :no-line-numbers
 cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin maa --locked
@@ -136,65 +132,65 @@ cargo install --git https://github.com/MaaAssistantArknights/maa-cli.git --bin m
 :::
 
 ::: warning
-maa-cli 目前的最低支持 Rust 版本 (MSRV) 为 1.88。请注意，MSRV 可能随时发生变化，我们建议始终使用最新的 Rust 工具链以获得最佳体验。
+maa-cli の現在の最小サポート Rust バージョン（MSRV）は 1.88 です。MSRVは予告なく変更される可能性があるため、最適な体験を得るには常に最新のRustツールチェーンを使用することをお勧めします。
 :::
 
-### 编译选项
+### コンパイルオプション
 
-从源码编译时，你可以通过 `--no-default-features` 禁用默认的特性，然后通过 `--features` 来启用特定的特性。目前可用的特性有：
+ソースからコンパイルする場合、`--no-default-features` でデフォルトのフィーチャーを無効にし、`--features` で特定のフィーチャーを有効にすることができます。現在利用可能なフィーチャーは以下の通りです：
 
-- `cli_installer`: 启用 `maa self update` 命令，用于更新自身，这个特性默认启用；
-- `core_installer`: 启用 `maa install` 和 `maa update` 命令，用于安装和更新 MaaCore 及资源，这个特性默认启用；
-- `git2`: 提供 `libgit2` 资源更新后端，这个特性默认启用。
+- `cli_installer`: `maa self update` コマンドを有効にし、自身を更新するために使用します。このフィーチャーはデフォルトで有効です。
+- `core_installer`: `maa install` および `maa update` コマンドを有効にし、MaaCore とリソースをインストールおよび更新するために使用します。このフィーチャーはデフォルトで有効です。
+- `git2`: `libgit2` リソース更新バックエンドを提供します。このフィーチャーはデフォルトで有効です。
 
-## 安装 MaaCore 及资源
+## MaaCoreとリソースのインストール
 
-maa-cli 只提供了一个命令行界面，它需要 MaaCore 和资源来运行任务。
+maa-cli はコマンドラインインターフェースのみを提供しており、タスクを実行するには MaaCore とリソースが必要です。
 
-根据安装方式和平台的不同，你的操作也有所区别：
+インストール方法とプラットフォームによって、操作は異なります：
 
 ::: tabs#maacore
 
-@tab:active 预编译
-对于使用预编译二进制或者自行编译的用户，maa-cli 可以帮助你安装和更新：
+@tab:active プリコンパイル
+プリコンパイル済みバイナリを使用する場合、または自己コンパイルしたユーザーの場合、maa-cli がインストールと更新を支援します：
 
 ```bash :no-line-numbers
 maa install
 ```
 
 @tab Windows
-对于 Windows 平台的用户，在运行 `maa install` 命令前，请以管理员身份在命令提示符或 PowerShell 中运行以下命令，以安装必要组件 VC++ 运行库：
+Windows プラットフォームのユーザーは、`maa install` コマンドを実行する前に、管理者権限でコマンドプロンプトまたは PowerShell で以下のコマンドを実行し、必須コンポーネントである VC++ ランタイムをインストールしてください：
 
 ```bat :no-line-numbers
 winget install "Microsoft.VCRedist.2015+.x64" --override "/repair /passive /norestart" --uninstall-previous --accept-package-agreements --force
 ```
 
-然后再运行 `maa install`。
+その後、`maa install` を実行してください。
 
 @tab Arch
-你可以使用 maa-cli 安装预编译的 MaaCore:
+maa-cli を使用してプリコンパイル済みの MaaCore をインストールできます：
 
 ```bash :no-line-numbers
 maa install
 ```
 
-你也可以通过 [AUR](https://aur.archlinux.org/packages/maa-assistant-arknights/) 安装 maa-core
+また、[AUR](https://aur.archlinux.org/packages/maa-assistant-arknights/) を使用して maa-core をインストールすることもできます：
 
 ```bash :no-line-numbers
 paru -S maa-assistant-arknights
 ```
 
-或者
+または
 
 ```bash :no-line-numbers
 yay -S maa-assistant-arknights
 ```
 
 @tab Nix
-Nix 上的 maa-cli 强制依赖 MaaCore，因此 Nix 用户无需，也不应该手动安装 MaaCore。
+Nix の maa-cli は MaaCore に強く依存しています。そのため、Nix ユーザーは MaaCore を手動でインストールする必要はなく、またすべきではありません。
 
 :::
 
 ::: warning
-`maa install` 下载的是 MAA 官方预编译的 MaaCore，而包管理器安装的 MaaCore 可能使用与官方预编译版本不同的编译选项和依赖版本，这也许会导致性能和功能上的略微差异。
+`maa install` は MAA 公式がプリコンパイルした MaaCore をダウンロードします。一方、パッケージマネージャーでインストールされる MaaCore は、公式のプリコンパイルバージョンとは異なるコンパイルオプションや依存関係のバージョンを使用する可能性があり、これによりパフォーマンスや機能にわずかな違いが生じる可能性があります。
 :::

docs/ja-jp/manual/connection.md

@@ -1,5 +1,5 @@
 ---
-order: 3
+order: 4
 icon: mdi:plug
 ---
 
@@ -43,6 +43,7 @@ icon: mdi:plug
 - [MuMu Pro](https://mumu.163.com/mac/function/20240126/40028_1134600.html) `16384`
 - [逍遥](https://bbs.xyaz.cn/forum.php?mod=viewthread&tid=365537) `21503`
 - [夜神](https://support.yeshen.com/zh-CN/qt/ml) `62001`
+- [テンセントアプリストア](https://sj.qq.com/faq/3878) (5.10.56.xx 以降)：ADB ポートは `127.0.0.1:5555` 固定。ADB パス例：`C:\Program Files\Tencent\Androws\Application\バージョン番号\adb.exe`。
 
 他のエミュレータについては[Zhaoqingqing's Blog](https://www.cnblogs.com/zhaoqingqing/p/15238464.html)を参照してください。
 
@@ -224,14 +225,25 @@ LDPlayerの正式版9 V9.1.32 以降を使用する必要があります。<!--
 
 3. `インスタンス番号` には LD マルチインスタンス内でのエミュレーターの番号を入力してください。主インスタンスの場合は `0` です。
 
+### AVD スクリーンショット強化モード
+
+Android Emulator v27.2.9 以降が必要です。（アークナイツのリリース以降にダウンロードしたエミュレーターであれば大丈夫です。）
+
+AVD スクリーンショット強化モードは MaaFramework 内で実装されているため、MaaFramework のタッチモードを有効にすることが、この機能を利用する前提となります。
+
+1. `設定` - `接続設定` - `接続構成` で `Android Virtual Device (AVD)` を選択します。
+
+2. `タッチモード` で `MaaFramework` を選択します。
+
 ## タッチモード
 
 1. [Minitouch](https://github.com/DeviceFarmer/minitouch)：Android タッチイベントを操作するための C 言語で書かれたツールで、`evdev` デバイスを操作し、外部プログラムがタッチイベントとジェスチャーをトリガーできる Socket インターフェースを提供します。Android 10 以降、SELinux が `Enforcing` モードの場合、Minitouch は使用できなくなりました。<sup>[出典](https://github.com/DeviceFarmer/minitouch?tab=readme-ov-file#for-android-10-and-up)</sup>
 2. [MaaTouch](https://github.com/MaaAssistantArknights/MaaTouch)：MAA による Java で Minitouch を再実装し、Android の `InputDevice` を使用し、追加の機能を付加しました。高バージョンの Android での利用可能性はまだテスト中です。~~テストを手伝ってください~~
 3. Adb Input：直接 ADB を呼び出して、Android の `input` コマンドを使用してタッチ操作を行います。最も互換性があり、最も遅い速度です。
+4. [MaaFramework](https://maafw.com/)：MaaFramework の制御ユニットのスクリーンショットとタッチ機能を呼び出します。利用可能性はまだテスト中です。~~テストを手伝ってください x2~~
 
 ## ADB Lite
 
 MAA によって独自に実装された ADB クライアントで、オリジナルの ADB よりも多重の ADB プロセスを開始せずに済み、パフォーマンスの低下を抑えることができますが、一部のスクリーンショット方法は使用できません。
 
-推奨されますが、具体的な利点と欠点はまだフィードバックを得ていません。~~テストを手伝ってください x2~~
+推奨されますが、具体的な利点と欠点はまだフィードバックを得ていません。~~テストを手伝ってください x3~~

docs/ja-jp/manual/device/android.md

@@ -3,7 +3,7 @@ order: 4
 icon: mingcute:android-fill
 ---
 
-# 物理的な**Android**デバイス
+# 物理的な Android デバイス
 
 ::: warning
 この方法は ADB デバッグを伴い、さらに PC との接続が必要なため、**初心者には非推奨**です。
@@ -25,6 +25,8 @@ icon: mingcute:android-fill
 
 ## adbデバッグ・ツールをダウンロードして実行し、デバイスに接続する
 
+::: steps
+
 1. [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) をダウンロードし、解凍する。
 2. 解凍したフォルダを開き、アドレスバーをクリアし`cmd` と入力しエンターキーを押します。
 3. ポップアップしたコマンドプロンプトウィンドウに`adb`と入力し、英語のヘルプテキストがたくさん表示されれば、実行は成功です。
@@ -35,6 +37,8 @@ icon: mingcute:android-fill
    adb devices
    ```
 
+:::
+
 - 実行に成功すると `USB デバッグ` デバイスが接続されたというメッセージが表示される。
   - 成功した接続例：
 
@@ -113,31 +117,35 @@ icon: mingcute:android-fill
 
 ## 解像度の自動変更
 
+::: steps
+
 1. MAAディレクトリに2つの新しいテキストファイルを作成し、以下の内容で埋めてください。
 
-   ```bash
+   ```bat
    :: 解像度を 1080p に調整する
    adb -s <ターゲット・デバイスのシリアル番号> shell wm size 1080x1920
    :: 画面の輝度を下げる（オプション）
    adb -s <ターゲット・デバイスのシリアル番号> shell settings put system screen_brightness 1
    ```
 
-   ```bash
+   ```bat
    :: 解像度の復元
-   adb -s <ターゲット・デバイスのシリアル番号>> shell wm size reset
+   adb -s <ターゲット・デバイスのシリアル番号> shell wm size reset
    :: 画面の明るさを上げる（オプション）
-    adb -s <ターゲット・デバイスのシリアル番号> shell settings put system screen_brightness 20
-    :: ホームに戻る（オプション）
-    adb -s <ターゲット・デバイスのシリアル番号> shell input keyevent 3
-    :: ロック画面（オプション）
-    adb -s <ターゲット・デバイスのシリアル番号> shell input keyevent 26
+   adb -s <ターゲット・デバイスのシリアル番号> shell settings put system screen_brightness 20
+   :: ホームに戻る（オプション）
+   adb -s <ターゲット・デバイスのシリアル番号> shell input keyevent 3
+   :: ロック画面（オプション）
+   adb -s <ターゲット・デバイスのシリアル番号> shell input keyevent 26
    ```
 
 2. 最初のファイルを `startup.bat` に、2番目のファイルを `finish.bat` にリネームする。
-   - リネーム後、拡張子を変更するための2回目の確認ダイアログボックスが表示されず、ファイルアイコンも変更されない場合は、“Windowsでファイルの拡張子を表示する方法“をご自身で検索してください。
+   - リネーム後、拡張子を変更するための2回目の確認ダイアログボックスが表示されず、ファイルアイコンも変更されない場合は、”Windowsでファイルの拡張子を表示する方法”をご自身で検索してください。
 
 3. MAA の `設定` - `接続設定` - `スクリプトを使用して始めます` と `終了時にスクリプトを使用します` にそれぞれ `startup.bat` と `finish.bat` を記入してください。
 
+:::
+
 ## MAAとの接続
 
 ### 有線接続
@@ -156,6 +164,8 @@ icon: mingcute:android-fill
 
 #### `adb tcpip` を使用してワイヤレスポートをオンにします
 
+::: steps
+
 1. 先ほど開いたコマンドプロンプトウィンドウに以下のコマンドを入力し、ワイヤレスデバッグを有効にします。
 
    ```bash
@@ -170,12 +180,16 @@ icon: mingcute:android-fill
 3. `<IP>:5555` を MAAの `設定` - `接続設定` - `接続先アドレス` に入力してください。例 `192.168.1.2:5555`。
 4. Link Start!
 
+:::
+
 #### `adb pair` を使用してワイヤレスポートをオンにします
 
 ::: tip
 `adb pair` ワイヤレス ペアリング、つまり Android 11 以降の開発者向けオプションで `ワイヤレスデバッグ` を使用すると、 `adb tcpip` と比較して有線接続が不要になります。
 :::
 
+::: steps
+
 1. デバイスの開発者向けオプションに移動し、 `ワイヤレスデバッグ` をクリックしてオンにし、OKをクリックして、 `ペアリングコードでデバイスをペアリング` をクリックして、ペアリングが完了するまで表示されるポップアップウィンドウを閉じないでください。
 
 2. ペアリングします。
@@ -186,11 +200,17 @@ icon: mingcute:android-fill
 3. 現在のデバイス画面に表示される `<IP アドレスとポート>` を MAAの `設定` - `接続設定` - `接続アドレス` に入力します（ `192.168.1.2:11451` など）、**さっき記入したものとは違うに違いない**。
 4. Link Start!
 
+:::
+
 #### ルート権限でワイヤレスポートをオンにします
 
 ~~ルート権限を使用できますが、このドキュメントを読む必要がありますか~~
 
+::: steps
+
 1. [WADB](https://github.com/RikkaApps/WADB/releases) をダウンロードしてインストールし、ルート化します。
 2. WADBを起動して、ワイヤレスadbを起動します。
 3. WADBから提供された `<IP アドレスとポート>` を MAAの `設定` - `接続設定` - `接続アドレス` に入力します（ `192.168.1.2:5555` など）。
 4. Link Start!
+
+:::

docs/ja-jp/manual/device/linux.md

@@ -19,7 +19,9 @@ MAA WPF GUI は現在 Wine を通じて実行できます。MAAは.NETランタ
 
 #### インストール手順
 
-1. Visual C++ Redistributable をインストールする：
+:::: steps
+
+1. Visual C++ Redistributable をインストールする
 
    [Visual C++ 再頒布可能パッケージ](https://aka.ms/vc14/vc_redist.x64.exe) をダウンロードしてインストールします：
 
@@ -31,7 +33,11 @@ MAA WPF GUI は現在 Wine を通じて実行できます。MAAは.NETランタ
    `DependencySetup_依赖库安装.bat` は winget と Windows の権限昇格機構に依存しているため、Wine では通常正常に動作しません。そのため、ランタイムライブラリは手動でインストールする必要があります。
    :::
 
-2. Windows 版 MAA をダウンロードし、解凍した後、`wine MAA.exe` を実行します。
+2. MAA をダウンロード
+
+   Windows 版 MAA をダウンロードし、解凍した後、`wine MAA.exe` を実行します。
+
+::::
 
 ::: info 注意
 接続設定で ADB パスを [Windows 版 `adb.exe`](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) に設定する必要があります。
@@ -66,52 +72,52 @@ MAA Wine Bridge で生成された `MaaDesktopIntegration.so` を `MAA.exe` と
 
 ### Python を使用する
 
-#### MAA 動的ライブラリのインストール
+:::: steps
 
-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)
+1. 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` ファイルを開きます
 
-2. `./MAA-v{バージョン}-linux-{アアーキテクチャ}/Python/` ディレクトリに移動し、`sample.py` ファイルを開きます
+   ::: tip
+   プリコンパイル済みバージョンには、比較的新しいLinuxディストリビューション(Ubuntu 22.04)でコンパイルされた動的ライブラリが含まれており、システムに古いバージョンのlibstdc++がある場合、ABIの非互換性に遭遇する可能性があります。
+   [Linuxコンパイル・チュートリアル](../../develop/linux-tutorial.md) を参照して再コンパイルまたはコンテナを使用して実行できます。
+   :::
 
-::: tip
-プリコンパイル済みバージョンには、比較的新しいLinuxディストリビューション(Ubuntu 22.04)でコンパイルされた動的ライブラリが含まれており、システムに古いバージョンのlibstdc++がある場合、ABIの非互換性に遭遇する可能性があります。
-[Linuxコンパイル・チュートリアル](../../develop/linux-tutorial.md) を参照して再コンパイルまたはコンテナを使用して実行できます。
-:::
+2. ADB 構成
+   1. [`if asst.connect('adb.exe', '127.0.0.1:5554'):`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L48) セクションを見つける
+   2. `adb` ツール呼び出し
+      - エミュレータが `Android Studio` に `avd` を使用している場合は、 `adb` が付属します。 `adb.exe` の欄に直接 `adb` パスを記入することができ、一般的には `$HOME/Android/Sdk/platform-tools/` で見つけることができます。例：
 
-#### ADB 構成
+      ```python
+      if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "エミュレータの adb アドレス"):
+      ```
 
-1. [`if asst.connect('adb.exe', '127.0.0.1:5554'):`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L48) セクションを見つける
+      - 他のエミュレータを使用する場合は、最初に `adb` をダウンロードして： `$ sudo apt install adb` 次に、パスを入力するか、 `PATH` 環境変数を使用して `adb` を直接入力します
 
-2. `adb` ツール呼び出し
-   - エミュレータが `Android Studio` に `avd` を使用している場合は、 `adb` が付属します。 `adb.exe` の欄に直接 `adb` パスを記入することができ、一般的には `$HOME/Android/Sdk/platform-tools/` で見つけることができます。例：
+   3. エミュレータの `adb` パス取得
+      - adb ツールを直接使用できます： `$ adbパス devices` ，例：
 
-   ```python
-   if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "エミュレータの adb アドレス"):
-   ```
+      ```shell
+      $ /home/foo/Android/Sdk/platform-tools/adb devices
+      List of devices attached
+      emulator-5554 device
+      ```
 
-   - 他のエミュレータを使用する場合は、最初に `adb` をダウンロードして： `$ sudo apt install adb` 次に、パスを入力するか、 `PATH` 環境変数を使用して `adb` を直接入力します
+      - 返される `emulator-5554` はエミュレータのadbアドレスで、 `127.0.0.1:5555` を上書きします、例：
 
-3. エミュレータの `adb` パス取得
-   - adb ツールを直接使用できます： `$ adbパス devices` ，例：
+      ```python
+      if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):
+      ```
 
-   ```shell
-   $ /home/foo/Android/Sdk/platform-tools/adb devices
-   List of devices attached
-   emulator-5554 device
-   ```
+   4. この時点で、 `$ python3 sample.py` をテストでき、 `接続成功` が返されれば、基本的に成功です
 
-   - 返される `emulator-5554` はエミュレータのadbアドレスで、 `127.0.0.1:5555` を上書きします、例：
+3. タスク構成
 
-   ```python
-   if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):
-   ```
+   カスタムタスク：必要に応じて [統合ドキュメント](../../protocol/integration.md) を参照し、`sample.py` の [`# タスクとパラメーターについては docs/integration.md 参照`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更します
 
-4. この時点で、 `$ python3 sample.py` をテストでき、 `接続成功` が返されれば、基本的に成功です
-
-#### タスク構成
-
-カスタムタスク：必要に応じて [統合ドキュメント](../../protocol/integration.md) を参照し、`sample.py` の [`# タスクとパラメーターについては docs/integration.md 参照`](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/722f0ddd4765715199a5dc90ea1bec2940322344/src/Python/sample.py#L54) 欄を変更します
+::::
 
 ## エミュレータのサポート
 
@@ -121,6 +127,8 @@ MAA Wine Bridge で生成された `MaaDesktopIntegration.so` を `MAA.exe` と
 
 推奨構成： x86_64 のフレームワーク (R - 30 - x86_64 - Android 11.0) と MAA のLinux x64 ダイナミック ライブラリ
 
+[スクリーンショット強化モード](../connection.md#avd-スクリーンショット強化モード)の追加サポートもあります。
+
 - Android 10 以降、SELinux が `Enforcing` モードの場合、Minitouch は使用できません、別のタッチモードに切り替えてください。または SELinux を **一時的に** `Permissive` モードに切り替え。
 
 ### ⚠️ [Genymotion](https://www.genymotion.com/)
@@ -146,10 +154,6 @@ waydroid prop set persist.waydroid.height 720
 
 adb の IP アドレスを設定する： `設定` - `バージョン情報` - `IPアドレス` を開き、最初の `IP` を記録するし、`sample.py` の adb IP に `${記録したIP}:5555` を入力する。
 
-amdgpu を使用すると、`screencap` コマンドが stderr に情報を出力し、画像のデコードに失敗することがあります。
-`adb exec-out screencap | xxd | head` と入力し、出力に `/vendor/etc/hwdata/amdgpu.ids: No such file...` のようなテキストがあるかどうかを確認して、これを確認します。
-`resource/config.json` のスクリーンショットコマンドを `adb exec-out screencap` から `adb exec-out 'screencap 2>/dev/null'` に変更してみてください。
-
 ### ✅ [redroid](https://github.com/remote-android/redroid-doc)
 
 Android 11 バージョンのイメージは正常に動作し、5555 adb ポートを公開する必要があります。

docs/ja-jp/manual/device/macos.md

@@ -17,6 +17,8 @@ icon: basil:apple-solid
 
 注： `macOS` の仕組みにより、ゲームウィンドウを最小化したり、ステージマネージャーで別のウィンドウに切り替えたり、ウィンドウを別のデスクトップ/画面に移動したりすると、スクリーンショットに問題が発生し、正しく実行されなくなります。 👉🏻️ [issue](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/4371#issuecomment-1527977512) を参照
 
+::: steps
+
 0. 要件: MAA バージョン v4.13.0-rc.1 以降
 
 1. [PlayCover のフォークバージョン](https://github.com/hguandl/PlayCover/releases) をダウンロードしてインストールします。
@@ -33,13 +35,17 @@ icon: basil:apple-solid
 
 7. ステップ 3-5 は一度だけ行う必要があり、その後はアークナイツをアクティブにするだけで済みます。アークナイツのクライアントを更新するたびに、手順2を再度実行する必要があります。
 
+:::
+
 ### ✅ [MuMu エミューレータ Pro](https://mumu.163.com/mac/)
 
 サポートされています、ただしテストは少なく、 `MacPlayTools` 以外のタッチモードが必要です。 関連する問題 [#8098](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/8098)
 
 ### ✅ [AVD](https://developer.android.com/studio/run/managing-avds)
 
-サポートされています。Android 10 以降、SELinux が\`Enforcing\`モードの場合、Minitouch は使用できません、別のタッチモードに切り替えてください。または SELinux を **一時的に** \`Permissive\`モードに切り替え。
+サポートされています。[スクリーンショット強化モード](../connection.md#avd-スクリーンショット強化モード)の追加サポートもあります。
+
+Android 10 以降、SELinux が `Enforcing` モードの場合、Minitouch は使用できません、別のタッチモードに切り替えてください。または SELinux を **一時的に** `Permissive` モードに切り替え。
 
 ### ✅ [BlueStacks Air](https://www.bluestacks.com/mac) （無料、Apple Mシリーズチップ向けに最適化されたバージョン）
 
@@ -69,4 +75,4 @@ Mac 版の開発は人手不足のため、更新速度が比較的遅いです
 
 ### ✅ [AVD](https://developer.android.com/studio/run/managing-avds)
 
-サポートされています。
+サポートされています。[スクリーンショット強化モード](../connection.md#avd-スクリーンショット強化モード)の追加サポートもあります。

docs/ja-jp/manual/device/windows.md

@@ -25,12 +25,12 @@ const fullySupport = [
         {
             name: 'MuMu Player',
             link: 'https://www.mumuplayer.com/',
-            note: 'サポートされています、[スクリーンショット強化モード](../connection.html#MuMu スクリーンショット強化モード)の追加サポートもある。 Hyper-Vとの互換性が確認されています。\n\n- “完了後にエミュレータを終了する”機能に異常が発生する場合がありますので、その場合はMuMu公式までご連絡ください。\n- 複数のインスタンスを開くには、MuMu Multiple OpenerのADBボタンから対応するインスタンスのポート情報を確認し、MAA設定-接続設定の接続アドレスのポート番号を対応するポートに変更する必要があります。\n- `ビデオメモリ使用ポリシー`を`リソース使用量が少ない`に設定しないでください。',
+            note: 'サポートされています、[スクリーンショット強化モード](../connection.html#MuMu スクリーンショット強化モード)の追加サポートもあります。 Hyper-Vとの互換性が確認されています。\n\n- “完了後にエミュレータを終了する”機能に異常が発生する場合がありますので、その場合はMuMu公式までご連絡ください。\n- 複数のインスタンスを開くには、MuMu Multiple OpenerのADBボタンから対応するインスタンスのポート情報を確認し、MAA設定-接続設定の接続アドレスのポート番号を対応するポートに変更する必要があります。\n- `ビデオメモリ使用ポリシー`を`リソース使用量が少ない`に設定しないでください。',
         },
         {
             name: 'LDPlayer',
             link: 'https://www.ldplayer.net/',
-            note: 'サポートされています、[スクリーンショット強化モード](../connection.html#LDPlayer スクリーンショット強化モード)の追加サポートもある。 Hyper-Vとの互換性が確認されています。\n\n- LDPlayer 9のインストーラーは、インストールプロセス中に自動的にHyper-Vをサイレントで無効にしますので、必要な場合は注意してください。',
+            note: 'サポートされています、[スクリーンショット強化モード](../connection.html#LDPlayer スクリーンショット強化モード)の追加サポートもあります。 Hyper-Vとの互換性が確認されています。\n\n- LDPlayer 9のインストーラーは、インストールプロセス中に自動的にHyper-Vをサイレントで無効にしますので、必要な場合は注意してください。',
         },
     ]),
     // keep internal sorting for bluestacks.
@@ -40,6 +40,11 @@ const fullySupport = [
         note: 'サポートされています。エミュレーターの `設定` - `上位設定` で `Android Debug Bridge`をONにする必要があります。\n\n- ネットワーク環境が悪い場合は [オフラインパッケージ](https://support.bluestacks.com/hc/zh-tw/articles/4402611273485-BlueStacks-5-%E9%9B%A2%E7%B7%9A%E5%AE%89%E8%A3%9D%E7%A8%8B%E5%BC%8F)をダウンロードしてください。\n- adbポート番号が不規則に変化し続け、起動するたびに同じでない場合は、お使いのコンピュータが [Hyper-V](https://support.bluestacks.com/hc/ja/articles/4415238471053-BlueStacks-5-Hyper-V%E3%81%8C%E6%9C%89%E5%8A%B9%E3%81%AB%E3%81%AA%E3%81%A3%E3%81%A6%E3%81%84%E3%82%8BWindows-10%E3%81%A8Windows-11%E3%81%AB%E3%81%8A%E3%81%91%E3%82%8B%E3%82%B7%E3%82%B9%E3%83%86%E3%83%A0%E8%A6%81%E4%BB%B6)を有効にしている可能性があります，\nこのような状況に対して、MAAはポート番号を自動的に取得する小さなバックドアを提供しています。この機能がは動作しません/複数のエミュレータが必要/複数のエミュレータコアがインストールされているの場合は [よくある質問](../よくある質問.html#blue-stackエミュレータが起動するたびにポート番号が異なるhyper-v) を参照して変更してください。Hyper-V は管理者として実行されるため、エミュレーターの自動シャットダウンや接続の自動検出など、adb を伴わない操作でも MAA を管理者として実行する必要があります。',
     },
     ...shuffleArray([
+        {
+            name: 'テンセントアプリストア',
+            link: 'https://sj.qq.com/',
+            note: 'バージョン 5.10.56.xx 以降をサポートしています。`設定` - `接続設定` で `テンセントアプリストア` 接続設定を選択してください。Hyper-V との互換性が確認されています。\n\n- ADB ポートは `127.0.0.1:5555` です。\n- ADB パス例：`C:\\Program Files\\Tencent\\Androws\\Application\\バージョン番号\\adb.exe`。\n\n- 事前にアプリストアで [ADB デバッグを有効化](https://sj.qq.com/faq/3878) する必要があります。',
+        },
         {
             name: 'NOX',
             link: 'https://www.yeshen.com/',
@@ -67,7 +72,7 @@ const partiallySupport = shuffleArray([
     {
         name: 'AVD',
         link: 'https://developer.android.com/studio/run/managing-avds',
-        note: '理論的なサポートされています。\n\n- Android 10 以降、SELinux が`Enforcing`モードの場合、Minitouch は使用できません、別のタッチモードに切り替えてください。または SELinux を **一時的に** `Permissive`モードに切り替え。\n- AVD はデバッグ用に構築されており、ゲーム用に設計された他のエミュレーターを使用することをおすすめします。',
+        note: '理論的なサポートされています。\n\n- [スクリーンショット強化モード](../connection.html#avd-スクリーンショット強化モード)の追加サポートもあります。\n- Android 10 以降、SELinux が`Enforcing`モードの場合、Minitouch は使用できません、別のタッチモードに切り替えてください。または SELinux を **一時的に** `Permissive`モードに切り替え。\n- AVD はデバッグ用に構築されており、ゲーム用に設計された他のエミュレーターを使用することをおすすめします。',
     },
     {
         name: 'Google Play ゲーム（開発者）',

docs/ja-jp/manual/faq.md

@@ -1,5 +1,5 @@
 ---
-order: 2
+order: 3
 icon: ph:question-fill
 ---
 

docs/ja-jp/manual/install.md

@@ -0,0 +1,93 @@
+---
+order: 2
+icon: material-symbols:download-2-rounded
+---
+
+<!-- markdownlint-disable MD024 -->
+
+# ダウンロードとインストール
+
+::: tip
+
+これは MAA GUI のダウンロードとインストールに関するドキュメントです。maa-cli のダウンロードとインストールについては、[インストールとコンパイル](./cli/install.md)を参照してください。現在、Android版「MAA-Meow（MAA Android版）」はテスト公開中です。詳細は [MAA-Meow](https://github.com/Aliothmoon/MAA-Meow)をご覧ください。（現在、このソフトウェアのUIは中国語のみサポートしています）
+
+:::
+
+## MAA のダウンロード
+
+MAA では、公式サイトからのダウンロード、パッケージマネージャーからのインストール、グループファイルからのダウンロードなど、複数の方法を提供しています。ご都合に合わせた方法でダウンロードしてください。
+
+### [公式サイト](https://maa.plus)から最新の MAA パッケージをダウンロード
+
+通常、公式サイトでは正しいバージョンとアーキテクチャが自動選択されます。ほとんどの読者にとっては Windows x64 です。macOS ユーザーの方は、macOS ユニバーサル版をダウンロードしてください。
+
+### [Mirror ちゃん](https://mirrorchyan.com/zh/projects?rid=MAA&source=maadocs-install)から最新の MAA パッケージをダウンロード
+
+システムアーキテクチャを確認し、対応するパッケージをダウンロードしてください。ほとんどの Windows ユーザーにとっては Windows x64 です。Mac ユーザーの場合、Mirrorちゃんはユニバーサルパッケージを提供していないため、お使いのチップアーキテクチャ（arm/x86）を確認して対応するパッケージをダウンロードしてください。
+
+::: tip
+
+[Mirrorちゃん](https://mirrorchyan.com/zh/projects?rid=MAA&source=maadocs-install)は独立したサードパーティのダウンロードアクセラレーションサービスであり、MAA の有料サービスではありません。その運営コストはサブスクリプション収入で賄われ、収益の一部はプロジェクト開発者に還元されます。高速ダウンロードを楽しみながらプロジェクトの継続的な開発を支援するために、CDK の購読をご検討ください。
+
+:::
+
+### Windows パッケージマネージャー（Winget）を使用したインストール
+
+::: tip
+
+この方法は Windows ユーザーのみ利用可能です。
+
+:::
+
+ターミナルで以下のコマンドを実行してください：
+
+```bash
+winget install maa
+```
+
+この方法でインストールした場合、デフォルトのインストールパスは `C:\Users\ユーザー名\AppData\Local\Microsoft\WinGet\Packages` です。
+
+### QQ グループファイルから最新のMAAパッケージをダウンロード
+
+1. [MAA 公式 QQ グループ](https://api.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)に参加してください。
+2. グループファイル内で最新の MAA パッケージをダウンロードしてください。
+
+### [GitHub Releases](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)から最新の MAA パッケージをダウンロード
+
+システムアーキテクチャを確認し、対応するパッケージをダウンロードしてください。ほとんどの Windows ユーザーにとっては `MAA-<バージョン番号>-win-x64.zip` です。macOS ユーザーの方は `MAA-<バージョン番号>-macos-universal.dmg` を選択してください。
+
+## Linux およびその他のオペレーティングシステム
+
+MAA GUI は**現時点では** Linux やその他のオペレーティングシステムをサポートしていません。これらのシステムで MAA の機能を使用するには、**maa-cli** を利用できます。詳細は、maa-cli の [インストールとコンパイル](./cli/install.md)を参照してください。
+
+## MAA のインストール
+
+### Windows
+
+ダウンロードが完了すると、`.zip`ファイルが取得できます。解凍ソフトで完全に解凍すると、MAAのすべてのファイルを含むフォルダが作成されます。
+
+::: warning
+
+1. `C:\` や `C:\Program Files\` など UAC 権限が必要なパスに MAA を解凍しないでください。
+
+2. MAA には .NET ランタイムが内蔵されています（自己完結型デプロイ）。ただし、Visual C++ Redistributable x64（VCRedist x64）が必要です。解凍したMAAディレクトリ内で、管理者権限で `DependencySetup_依赖库安装.bat` を実行し、この依存関係をインストールしてください。インストール完了後、`MAA.exe` を実行してください。
+
+詳細は[よくある質問](./faq.md)のトップを参照してください。
+
+:::
+
+`MAA.exe`をダブルクリックすると、MAAが起動します。
+
+::: tip
+
+Windows パッケージマネージャー（Winget）を使用してインストールした場合、解凍やランタイムのインストールなどの追加操作なしで、コマンドラインに `maa` と入力するだけで MAA を起動できます。ただし、PATHに `maa-cli` が存在する場合、それらを区別するために追加の手順が必要になることがあります。
+
+:::
+
+### macOS
+
+ダウンロードが完了すると、`.dmg`ファイルが取得できます。その `.dmg` をダブルクリックして開き、`MAA.app` を `/Applications` にドラッグしてインストールを完了します。
+
+## 次のステップ
+
+インストールが完了したら、[初心者向けガイド](./newbie.md)に戻って設定を続行するか、[機能紹介](./introduction/)で MAA がサポートするさまざまな機能を確認してください。インストール中に問題が発生した場合は、[よくある質問](./faq.md)を参照して解決を試みてください。

docs/ja-jp/manual/introduction/combat.md

@@ -40,7 +40,7 @@ icon: hugeicons:brain-02
   画面は、右上にステージ名と残り理性、右下に自動指揮と作戦開始が表示されるステージ詳細に留めてください。
 - この画面にいない場合、`現在/前回` は端末ホーム右下の「前回作戦」のステージへ自動で入ります。
 - `作戦` → `高度な設定` で `ステージ名を入力する` を有効にし、手動でステージ番号を入力することもできます。現在ナビ可能なステージは以下の通りです：
-  - すべてのメインステージ。末尾に `-NORMAL` または `-HARD` を付けて標準／磨難を切り替え可能。
+  - すべてのメインステージ。末尾に `-NORMAL` または `-HARD` を付けて難易度を切り替え可能（10〜14章は標準/厄難、15章以降は通常/険地）。
   - 龍門幣・作戦記録の 5 / 6 ステージ。ただし `CE-6` / `LS-6` を入力してください。6 が連戦不可の場合、自動で 5 に切り替えます。
   - アーツ学・購買資格証・炭素材の第 5 ステージ。`CA-5` / `AP-5` / `SK-5` を入力してください。
   - すべてのSoCステージ。`PR-A-1` のように完全な番号を入力してください。

docs/ja-jp/manual/introduction/introduction_old.md

@@ -12,7 +12,7 @@ icon: ic:baseline-article
 - ステージ選択に必要なステージがない場合ならば、MAAで `現在/前回` を選択し、ゲーム内で手動でステージを選択し、**任務開始**と**自動指揮**がゲーム画面に存在することを確認してください。
 - 現在この画面が表示されていない場合、 `現在/前回` は自動的に端末のホームページの右下隅にある「前回の参加作戦へ」ステージに入ります。
 - `タスク設定` - `作戦` - `高度な設定` の `ステージ名を入力する` を有効にすることで、ステージ番号を手動で入力することもできます。 現在サポートされているナビゲーションステージは以下の通りです：
-  - すべてのメインストーリーステージ。通常または厄難奮戦に切り替えるには、ステージの末尾に `-NORMAL` または `-HARD` を追加します。
+  - すべてのメインストーリーステージ。ステージ末尾に `-NORMAL` または `-HARD` を付けて難易度を切り替え可能（10〜14章は標準/厄難、15章以降は通常/険地）。
   - 龍門幣、作戦記録の5/6ステージ。ただし、 `CE-6` / `LS-6` を入力する必要があります。6ステージを実行できない場合は、自動的に5ステージに移行します。
   - アーツ学、購買資格証、建築資材。 `CA-5` / `AP-5` / `SK-5` を入力する必要があります。
   - SoCの場合のみ、完全なステージ番号を入力する必要があります。例： `PR-A-1` 。