Release v6.11.0-beta.2 (#16919)

## Summary by Sourcery

通过将串口配置与命令执行分离，并对共享客户端实例的访问强制使用互斥锁保护，改进 ADB-lite 客户端管理。

改进内容：
- 添加锁定辅助工具，在执行 connect、shell、exec、push 和交互式 shell 命令之前，验证并保护对共享 ADB-lite
客户端的访问。
- 在 PlatformIO/AdbLiteIO 上引入可配置的 ADB
串口，并在客户端（重新）初始化时提供安全机制，同时在客户端创建失败时记录错误日志。
- 调整 ADB 释放逻辑，仅在存在 ADB-lite 客户端时才发出释放命令，从而减少不必要的操作。
- 连接 AdbController，将设备地址向下传递到平台 I/O 层，以在各类命令中实现 ADB-lite 客户端的一致使用。

<details>
<summary>Original summary in English</summary>

## Summary by Sourcery

Improve ADB-lite client management by separating serial configuration
from command execution and enforcing mutex-guarded access to the shared
client instance.

Enhancements:
- Add a locking helper to validate and guard access to the shared
ADB-lite client before executing connect, shell, exec, push, and
interactive shell commands.
- Introduce a configurable ADB serial on PlatformIO/AdbLiteIO with safe
client (re)initialization and error logging when client creation fails.
- Adjust ADB release logic to only issue release commands when an
ADB-lite client is present, reducing unnecessary operations.
- Wire AdbController to propagate the device address into the platform
I/O layer for consistent ADB-lite client usage across commands.

</details>

.claude/skills/changelog/SKILL.md

@@ -0,0 +1,238 @@
+---
+name: changelog
+description: 根据提交记录、PR、diff、现有 CHANGELOG 与历史 tag 内容，整理符合 MAA 发布规范的 changelog Markdown。用于修正工具自动生成的 changelog、合并同类改动、清理 bot 或 release 噪音，并产出可直接提交的最终版本。
+---
+
+# MAA Changelog Skill
+
+## Goal
+
+- 读取待发布范围内的 commit、PR、diff、现有 CHANGELOG 与对应 tag 内容，输出可直接写入 CHANGELOG.md 的最终 Markdown 片段。
+- 只输出最终 Markdown，不输出分析过程、分类理由、筛选记录、额外说明或 Markdown 代码围栏。
+- 以“最终用户看得懂、历史版本不断裂、同类改动不重复”为第一目标，不以保留原始 commit 标题为目标。
+
+## Scope
+
+- 适用于正式版、测试版、补丁版的 changelog 整理与重写。
+- 正式版的补丁版本不应该修改 Highlights 中的内容，除非确实有用户可感知的重要变化。
+- 当工具已经生成初稿时，初稿只可作为原始素材，不能直接信任其分类、版本归属、标题质量、去重结果与排序结果。
+- 如果 commit 标题含糊、口语化、玩梗、只写 review、typo、warning、日志顺序、调整坐标等，必须查看 diff 后改写为专业、完整、可独立理解的用户向描述。
+
+## Required Inputs
+
+- 目标版本号。
+- 待发布的提交范围，或可推导该范围的 PR、tag、分支信息。
+- 当前 CHANGELOG 内容。
+- 如果目标版本与已有正式版属于同一非 patch 版号，必须先读取对应正式版 tag 下的 changelog 内容，再决定如何合并与追加。
+
+## Non-Negotiable Rules
+
+### 1. 先看净变更，再写条目
+
+- 对同一功能、同一问题或逻辑相关的多条 commit，应合并为单条 changelog 项。
+- 合并后的描述必须简洁、专业、面向最终用户，避免堆实现细节。
+- 若 commit 标题不足以表达改动价值，必须结合 diff 重写标题。
+- Revert 不是 changelog 项。遇到 Revert 时，必须结合最终 diff 判断净效果：
+- 若原改动被完整撤销，则 Revert 与原始项都删除。
+- 若最终仍保留部分语义，则把原始项与 Revert 合并为一条准确描述最终结果的 changelog 项。
+- 不要把“review”“日志顺序”“调整坐标”“typo”“build warning”这类缺乏用户语义的提交原样保留为条目，除非 diff 证明它确实修复了用户可感知问题。
+
+### 2. 分类按用户价值，不按 commit 前缀
+
+- 改动必须放入正确模块：Highlights、新增 | New、改进 | Improved、修复 | Fix、文档 | Docs、其他 | Other。
+- 新功能、新支持、新入口、新导出能力、新兼容性，放“新增 | New”。
+- 现有能力增强、性能提升、稳定性提升、体验优化、识别优化、重构后带来的用户收益，放“改进 | Improved”。
+- 缺陷修正、兼容性修复、异常处理、回归修复，放“修复 | Fix”。
+- 纯文档变更放“文档 | Docs”。
+- 仅内部维护、CI、脚本、杂项且不适合省略时，才放“其他 | Other”。
+- 如果自动生成结果分类错误，必须移动到更合适的模块并同步调整描述。
+
+### 3. 模块内排序与文案规范
+
+- 中文条目放在前面，纯英文条目排在该模块最后。
+- 同一模块内按逻辑相关性或重要性排序：功能与接口变更优先，其次是兼容性或实现优化，最后是次要修复或杂项。
+- 列表统一使用 * 作为项目前缀。
+- 中英文数字混排时，在英文词与数字之间保留空格，例如：修复 3 个 bug、支持 3D 功能。
+- 统一常见术语大小写与写法，例如 WPF、Json、Markdown、CSV、Info。
+- 保留作者、PR、commit reference，例如 (#12345) @author；若多条相关提交被合并，可把相近引用合并到同一项后括注。
+
+### 4. 正式版与 patch 版的历史连续性
+
+- 正式版严禁只留下单独的 patch 版本内容。
+- 如果目标正式版与已有正式版属于同一非 patch 版号，必须对比对应 tag 下的 changelog，并把当前新增改动追加到原有内容之后，保持版本历史连续。
+- patch 版详细区块只能写“自上一发布版本之后新增的变化”，不能把更早正式版已经出现过的条目整段复制到当前 patch 版本下面。
+- 例如生成 v6.10.4 时，v6.10.4 区块只能写 v6.10.3 之后的新变化；v6.10.0、v6.10.1、v6.10.2、v6.10.3 的既有内容应保留在历史区块，而不是重新抄进 v6.10.4。
+- 若非 patch 版本不同，则直接根据现有内容组织该版本及其历史区块。
+
+### 5. patch / 测试版的 Highlights 复用规则
+
+- patch 版本（例如 v6.10.4 相对于 v6.10.3）和测试版（例如 v6.11.0-beta.2 相对于 v6.11.0-beta.1）如果没有用户可感知的重要新功能或重大变化，必须直接复用其父版本的 Highlights 内容，不得自行重写或另起一套。
+- 复用 Highlights 时，只改顶部版本号标题和发版日期（例如 `## v6.11.0-beta.1 (2026-05-27)` → `## v6.11.0-beta.2 (2026-05-29)`），Highlights 正文原样保留。
+- 当 patch 版本或测试版确实包含用户可感知的重要新变化时（例如新增了重大功能、改变了核心交互），可以为 Highlights 追加新段落，但必须保留原有 Highlights 内容，新段落追加在末尾。
+
+### 6. patch / 测试版编辑的完整结构
+
+- 输出文件的结构必须严格遵循以下层次，不得把 patch 版本或测试版的详细内容插入到父版本的 Highlights 与详细内容之间：
+  1. 顶部：`## vX.Y.Z (YYYY-MM-DD)`（patch / 测试版标题，含发版日期）
+  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>`（上一 patch 版本，默认收起）
+  8. 更早版本各自独立折叠块...
+  9. `<details><summary><b>vX.Y.0 (YYYY-MM-DD)</b></summary>`（正式版，默认收起）
+- 每个版本的详细内容各自放入独立的 `<details>` 折叠块，`<summary>` 内格式为 `<b>vX.Y.Z (YYYY-MM-DD)</b>`（版本号 + 发版日期），当前目标版本使用 `<details open>` 默认展开，其余默认收起。
+- 折叠块内只保留详细内容（改进、修复等），不重复 Highlights，不写 `## vX.Y.Z` 子标题（`<summary>` 已提供版本标识）。
+
+### 7. Highlights 必须中英双语且先中后英
+
+- 输出顶部必须包含当前目标版本和发版日期，例如 `## vX.Y.Z (2026-05-29)`。
+- 必须包含 ### Highlights。
+- 中文 Highlights 直接展示，不折叠。
+- 英文 Highlights 放入折叠块：`<details><summary><b>English</b></summary>` ... `</details>`。
+- 中文与英文都应按主题分段，标题简洁明确，正文面向最终用户，不是 commit 列表翻译。
+- Highlights 只总结本次版本中最值得强调的变化，不要把所有条目机械搬进去。
+
+### 8. 必须过滤的噪音项
+
+- 删除或忽略纯 bot 自动生成的 changelog、update、release 条目。
+- 删除显式的 Release 发布记录，例如 Release vX.Y.Z。
+- 删除或忽略 Generate、Auto Update、Auto Generate、Update CHANGELOG、Bump version 之类自动维护条目。
+- 删除“只是在更新 changelog”而没有真实产品变更的提交记录。
+- 删除已被历史版本覆盖或重复搬运的旧条目。
+
+## Workflow
+
+1. 先确定本次发布边界：目标版本、上一版本、对应 tag、待发布 commit 范围。
+2. 读取现有 CHANGELOG 与目标范围内的 diff，不要只根据 commit 标题下结论。
+3. 先过滤 bot、release、generate、update changelog、revert、重复历史条目等噪音。
+4. 按“净变更”合并同类提交，必要时从 diff 改写标题。
+5. 按用户价值重新分类到正确模块，而不是沿用自动生成结果。
+6. 在每个模块内完成排序、术语统一与中英文条目整理。
+7. 编写中英双语 Highlights，先中文，后英文，中间用 ---- 分隔。
+8. 输出完整 Markdown 片段，包含顶部版本、Highlights、以下是详细内容：、当前版本区块与历史版本区块。
+
+## Common Failure Patterns To Correct
+
+- 把旧版本已有条目整段复制到当前 patch 版本。
+- 把 Revert 原样保留成单独 changelog 项。
+- 把 Release vX.Y.Z、Auto Update Changelogs、Update CHANGELOG、Bump version 之类自动提交写进文档或其他模块。
+- 把同一功能拆成多条重复表述，例如同一个生息演算功能拆成多个相近新增或改进条目。
+- 保留玩梗、口语化、半成品标题，例如不会现在还有人选沙中遗火吧、特意删的 PNS 怎么又给加回来了。
+- 机械沿用 commit type 导致分类错误，例如把用户能感知的修复放进其他，把兼容性提升放进新增。
+- patch 版本或测试版没有用户可感知的重要新变化，却自行重写了独立的 Highlights，而非复用父版本内容。
+- 把 patch 版本的详细内容插入到父版本的 Highlights 与详细内容之间，破坏了文件结构。
+- patch / 测试版的历史区块中重复保留了 Highlights 和"以下是详细内容："引导语，这些应只在顶部出现一次。
+
+## Output Requirements
+
+- 输出完整 Markdown 文件片段。
+- 顶部必须包含当前版本标题，例如 ## vX.Y.Z。
+- 顶部必须包含 ### Highlights，并满足先中文、后英文、用 ---- 分隔的格式。
+- 英文 Highlights 折叠块结束后，接“----”分隔线，然后接“以下是详细内容：”引导语。
+- 每个版本的详细内容各自放入独立的折叠块：`<details><summary><b>vX.Y.Z</b></summary>` ... `</details>`。
+- 当前目标版本的折叠块使用 `<details open>` 默认展开，历史版本使用 `<details>` 默认收起。
+- 详细内容中的模块标题统一使用以下格式：
+- ### 新增 | New
+- ### 改进 | Improved
+- ### 修复 | Fix
+- ### 文档 | Docs
+- ### 其他 | Other
+- 列表项统一使用 *。
+- 仅保留有内容的模块；空模块省略。
+
+## Output Template
+
+```
+## vX.Y.Z
+
+### Highlights
+
+#### 中文小结标题 A
+
+中文小结正文。
+
+#### 中文小结标题 B
+
+中文小结正文。
+
+<details>
+<summary><b>English</b></summary>
+
+#### English Summary Title A
+
+English summary paragraph.
+
+#### English Summary Title B
+
+English summary paragraph.
+
+</details>
+
+----
+
+以下是详细内容：
+
+<details open>
+<summary><b>vX.Y.Z (YYYY-MM-DD)</b></summary>
+
+### 改进 | Improved
+
+* 条目 A (#12345) @author
+
+### 修复 | Fix
+
+* 条目 B @author
+
+### 文档 | Docs
+
+* 条目 C @author
+
+</details>
+
+<details>
+<summary><b>vX.Y.1 (YYYY-MM-DD)</b></summary>
+
+### 改进 | Improved
+
+* 历史版本条目 @author
+
+### 修复 | Fix
+
+* 历史版本条目 @author
+
+</details>
+
+<details>
+<summary><b>vX.Y.0 (YYYY-MM-DD)</b></summary>
+
+### 新增 | New
+
+* 正式版条目 @author
+
+### 改进 | Improved
+
+* 正式版条目 @author
+
+### 修复 | Fix
+
+* 正式版条目 @author
+
+</details>
+```
+
+## Final Checklist
+
+- 是否只保留最终有效的净变更，而不是机械罗列 commit？
+- 是否已经删除 bot、Release、Generate、Update CHANGELOG、Revert 等噪音项？
+- 是否避免把旧版本已发布内容重复抄进当前 patch 版本？
+- 是否所有条目都能被最终用户独立理解？
+- 是否已经按模块正确分类、排序，并保持中文在前、英文在后？
+- 是否已经输出完整 Markdown，而不是说明文字或代码块？
+- 如果是 patch 版本且没有用户可感知的重要新变化，是否复用了父版本的 Highlights 而非自行重写？
+- patch / 测试版的详细内容是否紧跟在"以下是详细内容："之后，而非插入到父版本的 Highlights 下方？
+- 历史版本区块中是否只保留详细内容，没有重复 Highlights 和引导语？
+- 英文 Highlights 是否放入 `<details>` 折叠块（中文不折叠）？
+- 每个版本的详细内容是否各自放入独立的 `<details>` 折叠块？
+- 当前版本是否使用 `<details open>` 默认展开，历史版本是否默认收起？

.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

@@ -1,117 +1,212 @@
 {
   "repo_notes": [
     {
-      "content": "【语言要求】所有 wiki 页面的标题、正文、说明文字必须使用简体中文撰写。涉及到的外部链接如有中文版本，优先使用中文链接（如 https://docs.maa.plus/zh-cn/ 而非英文版）。仅在中文名不通用时保留英文术语（如 OCR、ADB、CLI、JSON 等缩写），其余一律使用中文。",
-      "author": "maintainer"
+      "content": "所有 wiki 页面标题、正文、说明文字必须使用简体中文；涉及外部链接时优先使用中文文档，如 docs.maa.plus 的 zh-cn 页面；仅在中文名不通用时保留 OCR、ADB、CLI、JSON、API 等缩写。"
     },
     {
-      "content": "MAA（MAA Assistant Arknights）是一款基于图像识别的《明日方舟》自动化助手，支持 Windows / Linux / macOS 三平台。核心部分 MaaCore 使用 C++20 编写，位于 src/MaaCore/；Windows 图形界面 MaaWpfGui 位于 src/MaaWpfGui/（C# + WPF）；命令行工具 maa-cli 位于 src/maa-cli/（Rust，子模块）；macOS 界面 MaaMacGui 位于 src/MaaMacGui/（子模块）。项目使用 CMake 构建，第三方依赖在 3rdparty/，对外 C 头文件在 include/。项目许可证为 AGPL-3.0-only。",
-      "author": "maintainer"
+      "content": "MAA 是基于图像识别的《明日方舟》自动化助手，仓库中的主要实现集中在 src/MaaCore、src/MaaWpfGui、resource、docs、tools、include；文档应围绕这些主干说明系统关系。"
     },
     {
-      "content": "resource/ 目录包含游戏相关的识别资源与任务数据，体量很大，含大量 JSON 任务定义文件和模板图片。这是 MAA 功能实现的关键数据层——所有任务流程（作战、公招、基建等）的识别模板、任务流程 JSON 均在此目录下。需要重点说明 resource 的目录结构和任务 JSON 的编写规则。",
-      "author": "maintainer"
+      "content": "src/maa-cli、src/MaaMacGui、src/MAAUnified、src/MaaUtils、test、3rdparty/EmulatorExtras 是子模块或边界模块；说明它们与主仓库的集成关系即可，不要假设所有内部实现都在当前仓库。"
     },
     {
-      "content": "MAA 提供多语言集成接口：C（include/AsstCaller.h）、Python（src/Python/）、Java（src/Java/）、Rust（src/Rust/）、Golang（src/Golang/）、Dart（src/Dart/）、Woolang（src/Woolang/）等。协议文档详见 https://docs.maa.plus/zh-cn/protocol/integration.html 。tools/ 目录包含丰富的内部工具脚本，用于资源更新（ResourceUpdater）、OTA 打包（OTAPacker）、模板优化（OptimizeTemplates）、海外客户端适配（OverseasClients）、肉鸽相关工具等。",
-      "author": "maintainer"
+      "content": "MaaCore 需要按 Assistant、Controller、Vision、Task、Config 的协作关系来写，而不是仅按目录逐个罗列；重点说明任务调度、设备控制、视觉识别、任务执行和资源加载如何配合。"
     },
     {
-      "content": "docs/ 目录是基于 VuePress 的多语言文档站点（https://docs.maa.plus），包含用户手册、开发指南、协议文档等。.github/ 目录包含 CI/CD 工作流（ci.yml、release-*.yml 等）、Issue 模板、自动化机器人配置。test/ 为 Git 子模块 MaaTestSet，用于回归测试。",
-      "author": "maintainer"
+      "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 项目的整体定位、核心功能（自动作战、基建换班、公招识别、肉鸽自动化等）、支持平台、许可证，以及仓库的高层目录结构概览。引用链接使用中文文档 https://docs.maa.plus/zh-cn/"
+      "purpose": "介绍 MAA 的产品定位、支持平台、许可证、顶层目录结构，以及 MaaCore、resource、前端入口、自动化功能和工程体系之间的阅读路径；本页只做导航与高层概览，不展开实现细节。",
+      "page_notes": [
+        {
+          "content": "本页只负责建立阅读路径和高层认知，不重复 MaaCore、resource、自动化功能或工程体系子页中的实现细节。"
+        }
+      ]
     },
     {
-      "title": "系统架构",
-      "purpose": "描述 MAA 的整体系统架构：MaaCore（C++ 核心库）作为后端引擎，通过 C 接口对外暴露功能；上层由 WPF GUI / macOS GUI / CLI 等前端调用。说明 Controller（连接控制）、Vision（图像识别）、Task（任务流水线）三大子系统的关系，以及 resource 数据层如何驱动任务执行",
-      "parent": "项目总览"
+      "title": "MaaCore 引擎",
+      "purpose": "说明 src/MaaCore 的整体运行时结构，重点描述 Assistant、Controller、Vision、Task、Config 五个核心部分如何协作构成自动化引擎。",
+      "parent": "项目总览",
+      "page_notes": [
+        {
+          "content": "优先围绕 Assistant、Controller、Vision、Task、Config 的协作关系展开，并用 src/MaaCore 中的实际类型和目录说明运行时结构。"
+        }
+      ]
     },
     {
-      "title": "MaaCore 核心库",
-      "purpose": "详细文档化 src/MaaCore/ 的内部结构，包括：Assistant 主类与任务调度、Controller 子系统（ADB 连接、Minitouch/MaaTouch 触控）、Vision 子系统（模板匹配、OCR 识别、特征检测）、Task 子系统（任务流水线、AbstractTask 基类和各具体任务实现）。重点说明任务是如何由 JSON 定义驱动的",
-      "parent": "系统架构"
-    },
-    {
-      "title": "任务流水线与任务 JSON",
-      "purpose": "文档化 MAA 的任务流程协议：resource/ 中的 tasks.json 文件如何定义识别-动作流程，包括模板匹配（TemplateMatch）、OCR 识别（OcrDetect）、各种 action 类型、next/timeout/onError 跳转逻辑等。参考协议文档 https://docs.maa.plus/zh-cn/protocol/task-schema.html",
-      "parent": "MaaCore 核心库"
-    },
-    {
-      "title": "图像识别与 OCR",
-      "purpose": "文档化 src/MaaCore/ 中 Vision 子系统的实现：OpenCV 模板匹配、PaddleOCR 文字识别、ONNX Runtime 推理加速、DirectML GPU 加速、特征点检测等。说明识别流程如何与任务流水线配合",
-      "parent": "MaaCore 核心库"
+      "title": "Assistant 与公共 API",
+      "purpose": "文档化 Assistant 的任务队列、线程模型和生命周期管理，以及 include/AsstCaller.h 暴露的公共 C 接口如何作为各类前端和绑定层的统一调用入口。",
+      "parent": "MaaCore 引擎"
     },
     {
       "title": "设备连接与控制器",
-      "purpose": "文档化 Controller 子系统：ADB 连接管理、截图方式（screencap）、触控方式（Minitouch、MaaTouch、ADB input）、模拟器适配。涵盖 src/MaaCore/ 中 Controller 相关代码和 3rdparty/EmulatorExtras 子模块",
-      "parent": "MaaCore 核心库"
+      "purpose": "文档化 Controller 子系统，包括 ADB 连接、截图链路、触控链路、模拟器适配、Minitouch 与 MaaTouch，以及控制器实现如何为任务执行提供设备 I/O。",
+      "parent": "MaaCore 引擎"
     },
     {
-      "title": "资源目录结构",
-      "purpose": "文档化 resource/ 目录的完整结构：各客户端（国服、国际服、日服、韩服、繁中服）的资源组织方式、模板图片目录、tasks.json 的分层结构、基建数据、公招数据、关卡导航数据、肉鸽相关资源等",
-      "parent": "系统架构"
+      "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 架构（基于 Stylet 框架）、主要 ViewModel（TaskQueueViewModel、SettingsViewModel 等）、界面功能模块（任务队列、设置页面、公招识别、远程控制等）、本地化与多语言支持",
-      "parent": "系统架构"
+      "purpose": "文档化 src/MaaWpfGui 的 MVVM 结构、主要 ViewModel 与 Services、界面功能模块、本地化资源，以及它如何与 MaaCore 交互。",
+      "parent": "前端与集成"
     },
     {
       "title": "命令行工具 maa-cli",
-      "purpose": "文档化 src/maa-cli/ 子模块：Rust 实现的命令行工具，支持 Linux/macOS/Windows，用于无 GUI 环境下运行 MAA 任务。说明其配置文件格式、任务调度方式、与 MaaCore 的集成方式。参考 https://docs.maa.plus/zh-cn/manual/cli/",
-      "parent": "系统架构"
+      "purpose": "文档化 src/maa-cli 子模块作为 Rust CLI 的定位、配置与调度角色，以及它与 MaaCore 和无 GUI 使用场景的关系。",
+      "parent": "前端与集成"
     },
     {
       "title": "多语言集成接口",
-      "purpose": "文档化 MAA 对外提供的多语言 API 接口：C 接口（include/AsstCaller.h）、Python（src/Python/）、Java（src/Java/）、Rust（src/Rust/）、Golang（src/Golang/）、Dart（src/Dart/）等。说明回调消息协议和集成方法。参考 https://docs.maa.plus/zh-cn/protocol/integration.html",
-      "parent": "系统架构"
+      "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 的核心自动化能力，包括：自动作战（关卡导航与掉落识别）、智能基建（干员效率计算与排班）、自动公招（标签识别与策略选择）、肉鸽自动化（Roguelike 策略与干员选择）、自动抄作业（Copilot JSON）等"
+      "title": "自动化功能",
+      "purpose": "概述 MAA 主要自动化能力的功能分区与实现入口，包括作战、基建、公招、肉鸽、抄作业和专项玩法等主题。",
+      "parent": "项目总览"
     },
     {
       "title": "自动作战与关卡导航",
-      "purpose": "文档化自动作战功能的实现：关卡选择与导航、理智管理、代理指挥、掉落物识别与数据上传（企鹅物流、一图流）。涵盖 MaaCore 中 FightTask 及相关代码",
-      "parent": "核心功能详解"
+      "purpose": "文档化 Fight 相关任务的关卡选择、导航、理智管理、代理指挥、掉落识别与数据上传流程，以及对应的数据资源与任务链路。",
+      "parent": "自动化功能"
     },
     {
       "title": "基建自动换班",
-      "purpose": "文档化基建功能的实现：干员效率计算、单设施最优解换班、自定义排班 JSON 支持。参考 https://docs.maa.plus/zh-cn/protocol/base-scheduling-schema.html",
-      "parent": "核心功能详解"
+      "purpose": "文档化 Infrast 相关任务的效率计算、排班与换班逻辑、自定义排班数据，以及基建资源与任务执行之间的关系。",
+      "parent": "自动化功能"
+    },
+    {
+      "title": "自动公招与标签识别",
+      "purpose": "文档化公招标签 OCR、标签组合策略、识别结果处理与 recruitment 数据的关系，以及公招自动化的主要任务链路。",
+      "parent": "自动化功能"
     },
     {
       "title": "肉鸽自动化",
-      "purpose": "文档化肉鸽（Roguelike）自动化功能：自动刷源石锭和等级、烧水和凹直升策略、干员识别与练度评估、分队选择与招募逻辑。涵盖 MaaCore 中 Roguelike 相关代码和 resource 中的肉鸽资源数据",
-      "parent": "核心功能详解"
+      "purpose": "文档化 Roguelike 相关任务的主题配置、招募、练度识别、商店、遭遇、策略参数和不同主题之间的资源差异。",
+      "parent": "自动化功能"
     },
     {
       "title": "自动抄作业",
-      "purpose": "文档化 Copilot（自动抄作业）功能：作业 JSON 格式、干员部署与技能释放逻辑、与 prts.plus 作业站的配合。参考 https://docs.maa.plus/zh-cn/protocol/copilot-schema.html",
-      "parent": "核心功能详解"
+      "purpose": "文档化 Copilot 作业数据格式、干员部署与技能释放逻辑、作业资源的组织方式，以及与外部作业站的关系。",
+      "parent": "自动化功能"
     },
     {
-      "title": "构建系统与 CI/CD",
-      "purpose": "文档化项目的构建配置：CMake 构建系统、maadeps 依赖管理、各平台编译流程（Windows/Linux/macOS）、.github/workflows/ 中的 CI 工作流（ci.yml、smoke-testing.yml、release-*.yml 等）、自动化发布流程"
+      "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/ 目录下的开发与维护工具：ResourceUpdater（资源更新）、OTAPacker（OTA 打包）、OptimizeTemplates（模板优化）、OverseasClients（海外客户端适配）、RoguelikeRecruitmentTool（肉鸽招募工具）、ImageCropper（图片裁剪）等",
-      "parent": "构建系统与 CI/CD"
+      "purpose": "文档化 tools 目录下用于资源更新、模板优化、OTA 打包、海外客户端适配、肉鸽辅助和图像处理的内部工具及其维护用途。",
+      "parent": "工程体系"
     },
     {
-      "title": "外服适配",
-      "purpose": "文档化如何为国际服、日服、韩服、繁中服适配 MAA 功能：资源替换流程、截图与 JSON 修改方法、多客户端资源目录结构。参考 https://docs.maa.plus/zh-cn/develop/overseas-client-adaptation.html",
-      "parent": "核心功能详解"
+      "title": "文档站、协议与开发指南",
+      "purpose": "文档化 docs 目录作为 VuePress 文档站的结构，串联 manual、protocol、develop、glossary 等内容域，以及它们与外部中文文档站的关系。",
+      "parent": "工程体系",
+      "page_notes": [
+        {
+          "content": "优先使用 docs 目录内部结构解释文档体系，再引用 docs.maa.plus 中文页面；不要按不同语言版本重复讲述相同主题。"
+        }
+      ]
     },
     {
-      "title": "开发指南",
-      "purpose": "面向贡献者的开发入门文档：环境搭建、编译步骤、代码规范、Git 工作流（dev-v2 分支）、Issue Bot 使用、PR 流程。参考 https://docs.maa.plus/zh-cn/develop/development.html"
+      "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/workflows/blame-ignore.yml

@@ -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@d30dc2d070765d7e509df00c34c5fa2dd636ff74 # master as of 2026-05-06
         with:
           branch: ${{ github.ref }}
           github_token: ${{ secrets.MAA_RESOURCE_SYNC }}

.github/workflows/ci.yml

@@ -150,10 +150,15 @@ jobs:
           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
         with:
-          dotnet-version: '10.0.202'
+          global-json-file: global.json
 
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget
@@ -203,6 +208,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
@@ -225,6 +231,7 @@ jobs:
         with:
           name: MAA-win-${{ matrix.arch }}
           path: install/MAA-*.zip
+          compression-level: 0
 
   ubuntu:
     name: Build for Ubuntu
@@ -302,7 +309,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
@@ -343,6 +350,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@v6
+        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@v5
+        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
@@ -440,14 +521,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 }}
@@ -483,6 +564,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: |
@@ -569,7 +652,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
@@ -609,11 +692,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/issue-ai-analysis.yml

@@ -33,7 +33,7 @@ jobs:
       # - 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
+        uses: Misteo/ai-issue-analysis@c0b258aa9660a1efd7316c9ed6d9ef81f1ac734a # main as of 2026-05-06
         with:
           github-token: ${{ secrets.MAA_BOT_TOKEN }}
           copilot-github-token: ${{ secrets.COPILOT_GITHUB_TOKEN }}

.github/workflows/optimize-templates.yml

@@ -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@d30dc2d070765d7e509df00c34c5fa2dd636ff74 # master as of 2026-05-06
         with:
           github_token: ${{ secrets.MAA_RESOURCE_SYNC }}
           branch: ${{ github.ref }}

.github/workflows/pr-checker.yml

@@ -10,24 +10,6 @@ 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@v9
-        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@v9
         with:
@@ -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

@@ -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

@@ -206,10 +206,15 @@ 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:
-          dotnet-version: '10.0.202'
+          global-json-file: global.json
 
       - name: Cache .nuke/temp, ~/.nuget/packages
         id: cache-nuget

.github/workflows/release-ota.yml

@@ -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,18 +113,53 @@ 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

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

@@ -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@d30dc2d070765d7e509df00c34c5fa2dd636ff74 # master as of 2026-05-06
         with:
           branch: ${{ github.ref }}
           github_token: ${{ secrets.MAA_RESOURCE_SYNC }}

.github/workflows/update-submodules.yml

@@ -21,7 +21,7 @@ jobs:
         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 MAAUnified, MaaMacGui, maa-cli

.gitignore

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

CHANGELOG.md

@@ -1,121 +1,93 @@
-## v6.8.0
-
-### 牛牛初体验 DeepSleep，被吓到眩晕瘫坐，那一刻就像看到原子弹爆炸 | Highlights
-
-本次版本更新我们依旧专注于提升用户体验。我们将始终秉持长期主义的原则理念，在尝试与思考中踏实前行。
-
-#### 独立更新器与本地拖入更新
-
-我们优化了 MAA 的更新流程，将更新部分拆分成独立的 exe 文件，以增强更新过程的可靠性。
-
-***\[仅 Windows\]*** 另外，我们为无法直接下载 OTA 更新包，但可以从群文件等其他渠道获取完整包或增量包的用户，提供了直接拖入更新的功能。你只需要将对应的压缩包直接拖入 MAA 主窗口，牛牛就会自动识别并执行更新。
-
-请确保压缩包名称符合完整包命名规则（`MAA-v{新版本}-win-{架构}.zip`）或 OTA 包命名规则（`MAAComponent-OTA-v{旧版本}_v{新版本}-win-{架构}.zip`），且架构（`x64` 或 `arm64`）与版本链（`{旧版本}`）和当前安装的 MAA 完全匹配，否则更新将被拒绝。
-
-##### 建议内测版用户执行一次完整包清理替换
-
-在独立更新器的编写过程中，我们修复了一个自内测版发布之初就存在的问题：
-
-内测版在与正式版或公测版切换更新时，旧版本残留文件可能无法被正确清理，从而影响更新结果。
-
-建议所有内测版用户下载一次完整包，并拖入 MAA 主窗口执行清理替换。
-
-通过完整包更新时，MAA 会保留 debug、cache、data、config 文件夹，其余文件会移入回收站；若你有自行添加或修改过文件，建议提前备份。
-
-#### 一键长草优化
-
-我们优化了一键长草功能的理智作战部分，现在可以指定在活动结束前 48 小时吃当期过期的理智药，确保能将更多的理智药投入到当期活动中。
-
-我们为自动肉鸽部分新增了界园肉鸽月度小队与深入调查的支持，你现在可以在自动肉鸽的策略选项选择对应的策略了。
-
-#### 海外服专属优化
-
-我们在这个版本新增了海外服的基建线索快速放置功能，以及 SideStory「雪山降临1101」小游戏“喀兰贸易技术研发部”资源、OCR 与本地化内容。
-
-----
+## v6.11.0-beta.2
 
 ### Highlights
 
-This update continues our focus on improving user experience. We will always adhere to the principle of long-termism, steadily moving forward through experimentation and reflection.
+#### 任务队列交互全面升级
 
-#### Standalone Updater and Local Drag-and-Drop Update
+一键长草列表新增悬停操作按钮（复制、重命名、删除），支持一键复制任务配置；游戏内新增任务间快速导航，部分跨页面任务可通过小房子导航栏直接跳转，减少页面切换耗时。
 
-We have optimized the MAA update process, splitting the update portion into independent exe files to enhance the reliability of the update process.
+#### 公招与理智作战功能增强
 
-***[Windows Only]*** Additionally, for users who cannot directly download OTA packages but can obtain full or incremental packages from other sources, we have provided a drag-and-drop update function. You only need to drag the corresponding archive directly into the MAA main window, and MAA will automatically recognize and execute the update.
+公招新增"保留指定词条"功能，识别到指定 Tag 时自动跳过当前槽位；理智作战新增目标材料最大库存模式，可参考仓库数据自动计算需刷取数量。
 
-Please ensure that the archive name matches either the full-package convention (`MAA-v{new version}-win-{architecture}.zip`) or the OTA-package convention (`MAAComponent-OTA-v{old version}_v{new version}-win-{architecture}.zip`), and that the architecture (`x64` or `arm64`) and version chain (`{old version}`) fully match the currently installed MAA; otherwise, the update will be rejected.
+#### 设置页面搜索支持
 
-##### We recommend that beta users perform a full package cleanup and replacement.
+设置页面新增搜索功能，支持关键词高亮与自动筛选，快速定位目标配置项。
 
-During the development of the standalone updater, we fixed an issue that existed since the initial beta release:
+<details>
+<summary><b>English</b></summary>
 
-When switching between beta builds and stable or public-preview builds, leftover files from the previous version may not be cleaned up correctly, which can affect the update result.
+#### Task Queue Interaction Overhaul
 
-We recommend that all beta users download the full package once and drag it into the MAA main window to perform a cleanup and replacement.
+The farming list now shows hover action buttons (copy, rename, delete) for quick task management. In-game QuickSwitch navigation lets certain cross-screen tasks jump directly via the dock bar, reducing page-switching overhead.
 
-When updating with the full package, MAA will retain the debug, cache, data, and config folders; other files will be moved to the recycle bin. If you have added or modified any files, we recommend backing them up beforehand.
+#### Recruitment & Sanity Combat Enhancements
 
-#### *Farming* Optimization
+Recruitment now supports "preserve tags" — automatically skipping a slot when specified tags are detected. Sanity combat adds a target material inventory mode that calculates required runs based on depot data.
 
-We've optimized the *Combat* of the *Farming*. You can now specify that using sanity potions that expire this week within 48 hours before the activity ends, ensuring more sanity potions are used in the current event.
+#### Settings Page Search
 
-We've added support for the *Monthly Squad* and *Deep Investigation* for *Sui's Garden of Grotesqueries* in the *Auto I.S.*. You can now select the corresponding strategy in the *Auto I.S.* options.
+The settings page now features a search bar with keyword highlighting and section filtering for quick configuration lookup.
 
-#### Overseas Server Exclusive Optimizations
-
-In this version, we've added a quick Clue placement function for *Base* for overseas servers, as well as resources, OCR, and localized content for the minigame *Karlan Trade R&D* of the SideStory *Retracing Our Steps*.
+</details>
 
 ----
 
 以下是详细内容：
 
-## v6.8.0
-
-### 新增 | New
-
-* 新增跨平台前端界面 MAAUnified V0.2，为后续多平台统一体验提供基础 (#16048) @Halo5082 @MistEO
-* 新增可按指定过期天数使用理智药 (#13849) @soundofautumn @status102
-* 新增界园肉鸽月度小队与深入调查支持 (#16271) @SherkeyXD
-* 新增海外服线索快速放置，并在线索交流前自动清空已放置线索 (#14966) (#16054) @Constrat @travellerse
-
-### 改进 | Improved
-
-* 重构更新流程：支持拖入指定名称的压缩包执行更新，涉及 DLL 的更新改由独立更新器处理，并在启动时校验版本一致性 (#16308) (#16326) @ABA2396
-* 更新器日志新增大小上限及文件移除、移动明细，提升更新问题排查体验 @ABA2396
-* 干员数据重构，支持跨职业重名干员 (#16084) @status102
-* 配置存储支持按条件写入，减少无效配置项并提升配置兼容性 (#15850) @status102
-* 自动编队在预编队后会额外校验选中状态，降低误编队概率 @status102
-* 作业版本号要求允许省略 patch 版本号 @status102
-* 优化提示元素展示效果，并减少通知实现中的冗余 UI 线程切换 (#16196) @ABA2396 @EzraRT
-* 优化算法性能与鲁棒性 (#16235) @lhhxxxxx
-* 分辨率不支持时会输出当前分辨率，便于排查兼容问题 @ABA2396
-* PC 端窗口绑定模式下禁用“完成后退出模拟器”，避免无效设置 @ABA2396
+<details open>
+<summary><b>v6.11.0-beta.2 (2026-05-29)</b></summary>
 
 ### 修复 | Fix
 
-* 修复更新器的 UTF-8 解析与 removelist 误判问题，并在更新时额外保留 cache 文件夹，减少误删风险 @ABA2396
-* 修复截图延迟极低时，更换产物或订单可能随机失败的问题 (#16330) @Roland125
-* 修复定时任务触发时 UpdateStageList 的等待逻辑，以及 LinkStart 期间进入 SetFightParams 的死锁问题 @status102
-* 非法 Enum 值现在会回退到属性默认值，避免异常配置继续传播 (#16138) @status102
-* 修复旧主题变更导致的招募识别问题 @ABA2396
-* 修复自动战斗鼠标长按分页时可能反复触发切换的问题 @status102
-* 修复部分越界场景下的返回值与索引异常 @status102
-* 修复基建开启设施无法保存的问题 @ABA2396
-* 修复干员库存识别返回错误 ID 的问题 @status102
-* 修复 macOS PlayTools/SCK 的若干兼容性问题 (#16276) @FireflySentinel
-* 修复韩服 OSChapterToOS OCR 与 EN 服 IS 6 DLC 1 文本匹配问题 @Daydreamer114 @Constrat
+* 修复 adb-lite 在连接阶段未正确绑定当前设备，减少切换设备或并发执行命令时的连接异常 (#16853) @wangl-cc
+* 修复快捷切换在开启基建退出提醒时无法退出基建的问题 @ABA2396
+* 修复快捷切换在遇到 LoadingText 时无法跳出循环的问题 @ABA2396
+
+</details>
+
+<details>
+<summary><b>v6.11.0-beta.1 (2026-05-29)</b></summary>
+
+### 新增 | New
+
+* 新增 MarkdownDataHelper 统一公告数据读写 @ABA2396
+* 一键长草列表新增任务复制、悬停操作按钮，替代原有右键菜单 (#16733) @H2O-MERO @status102 @ABA2396
+* 公招支持保留指定词条，识别到指定 Tag 时自动跳过 (#16586) @ABA2396 @status102
+* 理智作战支持设定目标材料最大库存，参考仓库数据自动计算刷取数量 (#16487) @ABA2396 @status102
+* 游戏内新增任务间快速导航，部分跨页面任务可通过小房子导航栏直接跳转以减少切换耗时 (#16869) @ABA2396
+* 触控模式下拉框新增 ToolTip 视频演示 (#16812) @ABA2396
+
+### 改进 | Improved
+
+* 设置页面新增搜索支持，支持关键词高亮与自动筛选 (#16833) @H2O-MERO @ABA2396
+* 优化配置转换器嵌套逻辑 @ABA2396
+* 启动时检测 WinRT Toast 通知可用性，不可用时在日志中显示具体原因 (#16877) @status102 @momomochi987
+* 统一使用强类型 GetValue 重载替换 Convert.To 调用 (#16866) @ABA2396
+* 优化任务队列选中状态的视觉表现，突出当前选中项 @status102
+* 任务队列 CheckBox 与添加任务按钮对齐 @status102
+
+### 修复 | Fix
+
+* 修复通过小房子导航后无法切换基建设施的问题 @ABA2396
+* 修复繁中服界园肉鸽无法放弃探索的问题 (#16887) @momomochi987
+* 修复界园肉鸽"见钱问柳"事件选择逻辑 @Saratoga-Official
+* 修复界园司岁台分队招募券连续 NEXT 弹窗无法关闭的问题 (#16806) @ZiyinLin @status102
+* 修复 ROI 高度越界及多次坐标校正后返回全图区域的问题 @status102
+* 修复 Release 构建下日志宏输出多余作用域信息的问题 @status102
+* 修复调试图清理时异常导致 Core SIGABRT 的问题 (#16233) @FireflySentinel
+* 修复 POSIX 平台 fork 后子进程 exec 失败时缺少 _exit 的问题 @FireflySentinel
+* 更新检查失败时优先尝试备用 API 而非直接使用过期缓存 (#16873) @glimmertouch
+* 降低 macOS 平台 RA4、RA15 二倍速识别阈值 (#16860) @ColdSpellhere
 
 ### 文档 | Docs
 
-* 完善安装文档的多语言翻译 (#16214) @JasonHuang79 @HX3N @Manicsteiner @momomochi987 @Constrat
-* 补充 Windows Defender 误报 FAQ 指引 (#16145) @Leo91314
-* 补充 AVD 截图增强与手动更新相关文档说明 (#16031) @satgo1546 @Rbqwow @MistEO @ABA2396
+* 补全理智药过期天数可配置参数的相关文档 @ABA2396
+* 公招保留词条参数术语从 skip_tags 更新为 preserve_tags @ABA2396
 
 ### 其他 | Other
 
-* 添加单元测试框架，并为角色分配算法补充测试用例 (#16245) @lhhxxxxx
-* 更新保全派驻作业 @Saratoga-Official
-* 补充怒潮凛冬相关肉鸽招募逻辑与基建技能数值 (#16217) (#16260) @Reverse0xCC @drway
-* 补充 EN/JP/KR 服 OS 关卡、小游戏与 OCR 资源，并更新韩服过期理智药相关本地化 (#16267) (#16268) (#16283) @Manicsteiner @HX3N @Constrat
-* 更新繁中服「次生方案」活动、宿舍截图及部分 OCR 资源 (#16216) (#16298) @momomochi987
+* 繁中服「天想」主题 UI 模板 (#16893) @momomochi987
+* CI GitHub Action 固定到 commit SHA 以加固安全性 (#16502) @FireflySentinel
+
+</details>

CMakeLists.txt

@@ -49,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": [
@@ -239,6 +272,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": [
@@ -400,6 +449,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",

context7.json

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

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/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

@@ -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).
 

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
 

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,6 +31,8 @@ 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)

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/',

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/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

@@ -118,7 +118,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 +134,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 +200,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 +262,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 +310,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 +921,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.  
 :::  
 ::::
 
@@ -1160,4 +1182,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/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/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/connection.md

@@ -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)を参照してください。
 

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) 欄を変更します
+::::
 
 ## エミュレータのサポート
 

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,6 +35,8 @@ icon: basil:apple-solid
 
 7. ステップ 3-5 は一度だけ行う必要があり、その後はアークナイツをアクティブにするだけで済みます。アークナイツのクライアントを更新するたびに、手順2を再度実行する必要があります。
 
+:::
+
 ### ✅ [MuMu エミューレータ Pro](https://mumu.163.com/mac/)
 
 サポートされています、ただしテストは少なく、 `MacPlayTools` 以外のタッチモードが必要です。 関連する問題 [#8098](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/8098)

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

@@ -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/',

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` 。

docs/ja-jp/manual/introduction/reclamation-algorithm.md

@@ -10,15 +10,53 @@ This page is outdated and maybe still in Simplified Chinese. Translation is need
 :::
 現在、生息演算のサポートはまだ初期段階にあり、自動攻略は推奨されず、現段階では安定性を保証できません。
 
-## デフォルトモード
+## 熱砂秘聞（Tales）
+
+### デフォルトモード
 
 1. 生息演算のメイン画面でタスクを開始する必要があります（ナビゲーションはまだ未実装）
 2. すでにセーブデータがある状況では使用できません（既存のセーブデータを削除してください）
 3. 生息演算の編成にオペレーターがいる状況では使用できません（生息演算の現在の編成をクリアしてください、特にウェーブを完了した後）
 
-## 製造でポイント稼ぎ
+### 製造でポイント稼ぎ
 
 1. 生息演算内で駐屯地が見えるページから開始する必要があります
 2. アイテム名が未記入の場合、デフォルトでグローライトを製造します
 3. 前提条件：現在が決算後の初日で、その後3日間敵襲による駐屯地への侵入がないこと
 4. 製造可能数量がちょうど99の倍数の場合、フリーズします。セーブ前に少し使用することができます。これは後で修正予定です
+
+## リローンチアンカー（RelaunchAnchor）
+
+### RA-1
+
+- 収益目安：1周あたり約159トークン + 統籌ポイント、1周約2分10秒
+- オペレーター要件：なし
+- 前提条件：ストーリーでRA-1をクリア済みであること
+- ワールドマップでRA-1を開き、右下に「建設開始」が表示されたらタスクを開始すると自動ループします
+- 注意：開始時に追加アイテムを持ち込むテクノロジーを解放している場合、該当施設（食品供給ステーション、飲料供給ステーション、大型獣檻など）を撤去してください
+- タスクフロー：精耕細作→建設→資源納品→決算を自動ループ
+
+### RA-4
+
+- 収益目安：1周あたり約417トークン + 統括ポイント、1周約1分40秒
+- オペレーター要件：ヴィシャデル（サポート可）
+- 前提条件：
+  1. メインストーリーを進めてRA-4をクリア済みの状態にする
+  2. 「計画経営」をアンロックする
+  3. 自分でヴィシャデルを持っている場合、手動でステージを開いて一度編成を行う。ヴィシャデルよりもコストが低い任意の5人のオペレーター＋ヴィシャデルとし、ヴィシャデルを6番目（最後に選択する枠）に配置する。その後、勧誘を確定し、今回の建設を中止して「建設開始」から開始する。
+  4. サポートのヴィシャデルを使用する場合、ヴィシャデルがスナイパーサポートのトップページに表示されていることを確認する（フレンドを考慮）。手動でステージを開き、ヴィシャデルよりもコストが低い任意の5人のオペレーターを編成し、6番目にサポートのヴィシャデルを選択して勧誘を確定する。その後、今回の建設を中止して「建設開始」から開始する（先頭5枠にオペレーターがおり、6番目が空いていることを確認する）。
+- ワールドマップでRA-4を開き、右下に「建設開始」が表示されたらタスクを開始すると自動ループします
+- 注意：開始時に追加アイテムを持ち込むテクノロジーを解放している場合、該当施設（食品供給ステーション、飲料供給ステーション、大型獣檻など）を撤去してください
+- タスクフロー：「計画経営」で得た赤金を使ってエリアを解放し、ヴィシャデルでボス討伐を完了する
+
+### RA-15
+
+- 収益目安：1周あたり約500トークン + 統籌ポイント、1周約3分
+- オペレーター要件：シヴィライト・エテルナ（サポート可）
+- 前提条件：
+  1. ストーリーでRA-15をクリア済みであること
+  2. シヴィライト・エテルナを所持している場合、手動でステージを開き編成を設定：バンガード5体（育成不要）+ エテルナを6番目に配置、保存して退出
+  3. サポートのシヴィライト・エテルナを使用する場合、術士サポートの最初のページに表示されるよう調整
+- ワールドマップでRA-15を開き、右下に「建設開始」が表示されたらタスクを開始すると自動ループします
+- 注意：開始時に追加アイテムを持ち込むテクノロジーを解放している場合、該当施設を撤去してください
+- タスクフロー：シヴィライト・エテルナで60撃破ミッションを達成

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

@@ -11,10 +11,14 @@ icon: fluent:people-24-filled
 
 `緊急招集票` の自動使用に対応し、1回のタスクあたりの最大募集回数を設定できます。`緊急招集票を自動的に使用` と併用すれば、一度に募集券を使い切ることができます。
 
-1・5・6★のタグを検出した場合は通知を表示します。
+保留対象のタグ、5★タグ、6★タグを検出した場合は通知を表示します。
 
 公開求人の更新時には、公開求人のタグデータを [ペンギン急便データ統計処理部門](https://penguin-stats.io/) と [ワンシート攻略](https://ark.yituliu.cn/) に自動アップロードします（**ご注意：「ワンシート攻略」は実質的に簡体字中国語のみのため、翻訳ツールと併用してください**）。
 
 ## 高度な設定
 
 `自動的に確認する` は MAA が自動でタグを選択して募集を実行することを意味し、`手動的に確認する` は自動選択および自動募集を行わないことを意味します。
+
+`3★タグ優先` を有効にすると、優先したい 3★タグを選択できます。`指定タグを保留` を有効にすると、保持したいタグを選択できます。
+
+保留対象のタグを1つでも認識した場合、MAA はその公開求人枠を保持したまま今回の募集をスキップし、確認操作は行いません。

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

@@ -15,12 +15,23 @@ icon: octicon:tools-16
 
 所持／未所持のオペレーター一覧を認識し、潜在能力データを認識・保存して公開求人認識で表示に利用します。
 
+現在、以下のエクスポート形式に対応しています：
+
+- クリップボード
+- JSON
+- Markdown テーブル
+- CSV テーブル
+
 ## 倉庫アイテム認識
 
 ホーム画面から自動で倉庫へ移動できます。自動遷移に失敗した場合は、手動で倉庫の `素材` 画面へ切り替え、**いちばん左端までスワイプ** してから開始してください。
 
-現在、MAAから以下のサイトへエクスポートに対応しています：
-[ペンギン急便周回計画作成ツール](https://penguin-stats.io/planner)、[アークナイツツールボックス](https://arkntools.app/#/material)、[アークナイツ | 周回計画表](https://ark-nights.com/settings)。
+現在、以下のエクスポート形式に対応しています：
+
+- [ペンギン急便周回計画作成ツール](https://penguin-stats.io/planner)（ArkPlanner）
+- [アークナイツツールボックス](https://arkntools.app/#/material)（Lolicon）
+- Markdown テーブル
+- CSV テーブル
 
 データサイトを運営されている方は、貴サイトの素材JSON形式へのエクスポート対応についてもぜひご連絡ください。実装を検討いたします。
 
@@ -48,3 +59,15 @@ MAAの目を通して世界を見てみたいですか？今、それが来ま
 MAA が目標フレームレートに合わせてエミュレータのスクリーンショットを取得し、ウィンドウ中央にリアルタイム表示します。
 
 スクショ取得速度が目標フレームレートに対して明らかに遅い場合、スクショ速度に合わせて目標フレームレートを自動で下げます。~~負荷テストにもどうぞ~~
+
+## ミニゲーム
+
+イベント内のミニゲームを自動的に周回します。名前の選択に対応し、設定で常設と当期限定イベントを切り替えられます。
+
+内蔵機能：
+
+- イベントショップ交換
+- 緑チケットショップ交換
+- 黄チケットショップ交換
+- 生息演算ショップ交換
+- シークレットフロント（エンディングとイベント分岐の選択に対応）

docs/ja-jp/protocol/base-scheduling-schema.md

@@ -147,6 +147,6 @@ JSONファイルはコメントをサポートしていません。テキスト
 
 ## サンプル
 
-[243 有効率が最も高い 一日三回](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
+[243 有効率が最も高い 一日三回](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master-v2/resource/custom_infrast/243_layout_3_times_a_day.json)
 
-[153 有効率が最も高い 一日三回](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
+[153 有効率が最も高い 一日三回](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master-v2/resource/custom_infrast/153_layout_3_times_a_day.json)

docs/ja-jp/protocol/callback-schema.md

@@ -227,7 +227,7 @@ Todo
 - `MedicineConfirm`  
    理性回復剤使用確認
 - `ExpiringMedicineConfirm`  
-   48時間以内に期限が切れる理性回復剤使用確認
+   期限切れ間近の理性回復剤使用確認
 - `StoneConfirm`  
    純正源石使用確認
 - `RecruitRefreshConfirm`  
@@ -361,6 +361,16 @@ Todo
   }
   ```
 
+- `RecruitPreservedTag`  
+   保留対象の公開求人タグの検出
+
+  ```json
+  // 対応する詳細フィールドの例
+  {
+     "tag": "ロボット"
+  }
+  ```
+
 - `RecruitResult`  
    公開求人結果
 

docs/ja-jp/protocol/integrated-strategy-schema.md

@@ -775,14 +775,6 @@ OCRで思わぬ遭遇イベントを認識しますが、選択肢は固定さ
 
 MAAは界園テーマで通宝の拾取と交換を自動処理します：
 
-::: tip 有効条件
-通宝交換機能は以下のモードでのみ有効：
-
-- 投資モード：「投資モードで購買、募集、2層進出を有効化」オプションを有効にする必要があります
-- その他のモード：デフォルトで有効
-
-:::
-
 1. **ドロップ通宝の拾取**：戦闘終了後、通宝ドロップ選択画面が表示された場合、MAAは `pickup_priority` に基づいて最も優先度の高い通宝を選択
 
 2. **銭匣通宝の交換**：新しく拾った通宝を銭匣内の通宝と交換する必要がある場合：

docs/ja-jp/protocol/integration.md

@@ -118,7 +118,7 @@ Bilibili：`张三`、入力可能：`张三`、`张`、`三`
 ステージ名。デフォルトは空で、現在/最後のステージを認識します。実行中の設定はサポートされていません。  
 ナビゲーション対象のステージは以下の通りです：
 
-- すべてのメイン ストーリー ステージ。ステージの最後に `-NORMAL` または `-HARD` を追加して、標準または困難なステージを切り替えることができます。
+- すべてのメイン ストーリー ステージ。ステージ末尾に `-NORMAL` または `-HARD` を付けて難易度を切り替えできます（10〜14章は標準/厄難、15章以降は通常/険地）。
 - 龍門幣、作戦記録の 5/6 関。ただし `CE-6` / `LS-6` と入力する必要があります。MAA は 6 関が代理できない場合は自動的に 5 関に切り替わります。
 - スキル本、購買資格証、碳素材の第 5 関。`CA-5` / `AP-5` / `SK-5` と入力する必要があります。
 - すべてのチップ本。完全なステージ番号を入力する必要があります（例：`PR-A-1`）。
@@ -134,8 +134,11 @@ Bilibili：`张三`、入力可能：`张三`、`张`、`三`
   ::: field name="medicine" type="number" optional default="0"  
   理性回復剤の最大使用数。  
   :::  
-  ::: field name="expiring_medicine" type="number" optional default="0"  
-  48 時間以内に期限切れになる理性回復剤の最大使用数。  
+  ::: field name="medicine_expire_days" type="number" optional default="0"  
+  指定日数以内に期限切れになる理性回復剤を使用します。`0` は期限切れの理性回復剤を使用しないことを意味します。  
+  :::  
+  ::: field name="expiring_medicine" type="number" optional default="0" deprecated  
+  v6.8.0 で非推奨になりました。代わりに `medicine_expire_days` を使用してください。  
   :::  
   ::: field name="stone" type="number" optional default="0"  
   純正源石の最大使用数。  
@@ -197,7 +200,7 @@ Bilibili：`张三`、入力可能：`张三`、`张`、`三`
    "enable": true,
    "stage": "1-7",
    "medicine": 1,
-   "expiring_medicine": 0,
+   "medicine_expire_days": 2,
    "stone": 0,
    "times": 10,
    "series": 0,
@@ -259,7 +262,14 @@ Bilibili：`张三`、入力可能：`张三`、`张`、`三`
 緊急招集の回数。`expedite` が true の場合のみ有効です。デフォルトは制限なし（`times` の上限まで）です。  
 :::  
 ::: field name="skip_robot" type="boolean" optional default="true"  
-ロボット タグが認識されたときにスキップするかどうか。  
+非推奨です。旧パラメータ互換のためにのみ残されています。  
+<br>
+`preserve_tags` が指定されておらず、この値が `true` の場合は `支援机械` を認識したときのみスキップします。`元素` は旧来の 1★ タグとしては扱われません。  
+:::
+::: field name="preserve_tags" type="array<string>" optional  
+現在の公開求人枠を保持したまま今回の募集をスキップしたい Tag 名の一覧です。デフォルトは空です。  
+<br>
+指定した Tag のいずれかを認識した場合、MAA はその枠を保持して今回の募集をスキップします。  
 :::  
 ::: field name="recruitment_time" type="object" optional  
 タグレベル（3 以上）と対応する希望採用時間（分単位）。デフォルト値は 540（つまり 09:00:00）です。
@@ -300,7 +310,7 @@ Bilibili：`张三`、入力可能：`张三`、`张`、`三`
    "set_time": true,
    "expedite": false,
    "expedite_times": 0,
-   "skip_robot": true,
+   "preserve_tags": ["支援机械"],
    "recruitment_time": {
       "3": 540,
       "4": 540
@@ -910,32 +920,44 @@ Sarkaz テーマ、Investment モード、「破棘成金分隊」または「
 ::: field name="enable" type="boolean" optional default="true"  
 このタスクを有効にするかどうか。  
 :::  
-::: field name="theme" type="string" optional default="Fire"  
+::: field name="theme" type="string" optional default="Tales"  
 テーマ。
 <br>
-`Fire` - _砂中の火_
+`Fire` - _砂中の火_（終了）
 <br>
-`Tales` - _熱砂秘聞_  
+`Tales` - _熱砂秘聞_
+<br>
+`RelaunchAnchor` - _リローンチアンカー_  
 :::  
 ::: field name="mode" type="number" optional default="0"  
-モード。
+モード。テーマごとにサポートするモードが異なります：
 <br>
-`0` - ポイント稼ぎと建造ポイント、戦闘に入って直接退出。
+**Tales（熱砂秘聞）：**
 <br>
-`1` - 沙中之火：赤金稼ぎ、連絡員から水購入後基地で鍛造；沙洲遗闻：支援アイテムを組み立てて生息ポイントを稼ぐ。  
+`0` - セーブなし、ステージ出入りで生息ポイントを稼ぐ。
+<br>
+`1` - セーブあり、支援アイテムを組み立てて生息ポイントを稼ぐ。
+<br>
+**RelaunchAnchor（リローンチアンカー）：**
+<br>
+`16` (`RA1`) - RA-1、精耕細作→建設→資源納品→決算を自動ループ。
+<br>
+`32` (`RA15`) - RA-15、シヴィライト・エテルナで60撃破ミッションを達成。
+<br>
+`48` (`RA4`) - RA-4、「計画経営」で得た赤金を使ってエリアを解放し、ヴィシャデルでボス討伐を完了する。
 :::  
 ::: field name="tools_to_craft" type="array<string>" optional default="[&quot;荧光棒&quot;]"  
-自動製造品。サブストリング入力推奨。  
+自動製造品。サブストリング入力推奨。Tales テーマのみ有効。  
 :::  
 ::: field name="increment_mode" type="number" optional default="0"  
-クリック型。
+クリック型。Tales テーマのみ有効。
 <br>
 `0` - 連続クリック
 <br>
 `1` - 長押し  
 :::  
 ::: field name="num_craft_batches" type="number" optional default="16"  
-単次最大製造バッチ数。  
+単次最大製造バッチ数。Tales テーマのみ有効。  
 :::  
 ::::
 
@@ -1159,4 +1181,7 @@ AdbLite を使用するかどうか。可能な値："0" または "1"。列挙
 ::: field name="KillAdbOnExit" type="boolean" optional  
 終了時に Adb プロセスをキルするかどうか。可能な値："0" または "1"。列挙値：5。  
 :::  
+::: field name="ClientType" type="string" optional  
+クライアント種別（ゲームチャネル）。ほとんどの接続設定では不要です。`AsstConnect` / `AsstAsyncConnect` に渡す `config` が、接続時に実行するコマンド内で `[PackageName]` を使用する場合にのみ、接続前に `AsstSetInstanceOption(..., ClientType, ...)` を設定してください。現在の組み込み設定では、`Androws` と `WSA` の `displayId` 取得のみがこの値に依存します。このオプションは StartUp / CloseDown などのタスクパラメータ `client_type` を置き換えるものではありません。列挙値：6。  
+:::  
 ::::

docs/ko-kr/develop/documentation-guidelines.md

@@ -21,6 +21,8 @@ icon: jam:write-f
 
 이 테마는 팁, 주석, 정보, 주의, 경고 및 세부 정보를 사용자 정의하는 컨테이너를 지원합니다. 이 기능을 사용하여 내용을 강조할 수 있습니다.
 
+컨테이너 안에 컨테이너가 중첩된 경우, 부모 컨테이너는 자식 컨테이너보다 콜론 `:` 을 하나 더 작성해야 합니다. 예: [단계(Steps) 컨테이너](#단계-steps)
+
 컨테이너 사용 방법:
 
 ```markdown
@@ -44,7 +46,7 @@ icon: jam:write-f
 - `warning` 주의
 - `danger` 경고
 - `details` 세부 사항
-- `demo-wrapper` ==특수 컨테이너==
+- `window` ==특수 컨테이너==
 
 ### 컨테이너 예시
 
@@ -72,7 +74,7 @@ icon: jam:write-f
 이것은 세부 사항 컨테이너입니다
 :::
 
-::: demo-wrapper
+::: window
 이것은 매우 특별한 컨테이너입니다
 :::
 
@@ -113,7 +115,7 @@ MaaAssistantArknights는 ==많은 돼지들== 에 의해 개발되었습니다
 
 다음과 같은 설정을 사용할 수 있습니다:
 
-::: demo-wrapper
+::: window
 입력:
 
 ```markdown
@@ -136,8 +138,6 @@ MaaAssistantArknights는 ==많은 돼지들== 에 의해 개발되었습니다
 
 단계별 튜토리얼을 작성할 때, 순서가 있는 목록은 중첩으로 인해 계층 구조가 불분명해질 수 있습니다. 이럴 때 `steps` 컨테이너가 최고의 선택입니다.
 
-이 컨테이너는 일반적인 컨테이너와 달리 시작과 끝을 표시하기 위해 4개의 콜론을 사용합니다.
-
 입력:
 
 ````markdown
@@ -192,7 +192,7 @@ MaaAssistantArknights는 ==많은 돼지들== 에 의해 개발되었습니다
 
 마크다운 본문에서 `<ImageGrid>` 컴포넌트를 사용하여 이 메서드를 호출할 수 있으며, 구체적인 구문과 효과는 다음과 같습니다.
 
-::: demo-wrapper
+::: window
 
 구문:
 
@@ -292,7 +292,7 @@ icon: jam:write-f
 - `color` css 스타일 색상 값을 받습니다. 예: `#fff`, `red` 등 (이 옵션은 svg 아이콘에만 유효함)
 - `size` css 스타일 크기 값을 받습니다. 예: `1rem`, `2em`, `100px` 등
 
-::: demo-wrapper 예시
+::: window 예시
 
 입력:
 

docs/ko-kr/manual/cli/config.md

@@ -196,7 +196,7 @@ strategy = "merge" # 또는 "first" (기본값)
 
 # 일요일 저녁에는 모든 만료 임박한 약물을 사용
 [[tasks.variants]]
-params = { expiring_medicine = 1000 }
+params = { medicine_expire_days = 2 }
 
 [tasks.variants.condition]
 type = "And"

docs/ko-kr/manual/connection.md

@@ -16,6 +16,7 @@ MAA v5.22.3까지 지원하는 감지 가능한 에뮬레이터 및 연결 주
 - LDPlayer 9: `emulator-5554/5556/5558/5560`, `127.0.0.1:5555/5557/5559/5561`
 - 逍遥(Xiaoyao): `127.0.0.1:62001/59865`
 - 夜神(Yeshen): `127.0.0.1:21503`
+- 텐센트 앱스토어 (5.10.56.xx 이후): `127.0.0.1:5555`
 
 감지에 실패하면 UAC 관리자 권한으로 MAA를 시작하여 다시 감지해보세요. 여전히 실패한다면 아래 수동 설정을 참고하고, 에뮬레이터와 연결 주소가 위 목록에 포함되어 있는지 확인하세요.
 
@@ -59,6 +60,7 @@ MAA 폴더에 직접 압축을 푸는 것을 권장합니다. 그러면 ADB 경
 - [LDPlayer 9](https://help.ldmnq.com/docs/LD9adbserver#edc3863750608062bcb3feea256413dc) `emulator-5554`
 - [逍遥(Xiaoyao)](https://bbs.xyaz.cn/forum.php?mod=viewthread&tid=365537) `21503`
 - [夜神(Yeshen)](https://support.yeshen.com/zh-CN/qt/ml) `62001`
+- [텐센트 앱스토어](https://sj.qq.com/faq/3878): ADB 포트는 `127.0.0.1:5555` 고정. ADB 경로 예시: `C:\Program Files\Tencent\Androws\Application\버전번호\adb.exe`.
 
 기타 에뮬레이터는 [赵青青의 블로그](https://www.cnblogs.com/zhaoqingqing/p/15238464.html)를 참고하세요.
 

docs/ko-kr/manual/device/android.md

@@ -26,6 +26,8 @@ icon: mingcute:android-fill
 
 ## adb 디버깅 도구 다운로드 및 장치 연결
 
+::: steps
+
 1. [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)를 다운로드하고 압축을 해제합니다.
 2. 압축 해제한 폴더를 열고 주소 표시줄을 지우고 `cmd`를 입력한 후 Enter 키를 누릅니다.
 3. 나타나는 명령 프롬프트 창에 `adb`를 입력하고 많은 영어 도움말 텍스트가 표시되면 실행이 성공한 것입니다.
@@ -36,6 +38,8 @@ icon: mingcute:android-fill
    adb devices
    ```
 
+:::
+
 - 성공적으로 실행되면 연결된 `USB 디버깅` 장치 정보가 표시됩니다.
   - 예시:
 
@@ -115,16 +119,18 @@ icon: mingcute:android-fill
 
 ## 해상도 자동 변경
 
+::: steps
+
 1. MAA 폴더 아래에 두 개의 텍스트 파일을 생성하고 다음 내용을 입력합니다.
 
-   ```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
    :: 화면 밝기 높이기 (선택 사항)
@@ -140,6 +146,8 @@ icon: mingcute:android-fill
 
 3. MAA의 `설정` - `연결 설정` - `시작 전 스크립트` 및 `종료 후 스크립트`에 각각 `startup.bat`과 `finish.bat`을 입력합니다.
 
+:::
+
 ## MAA에 연결하기
 
 ### 유선 연결
@@ -158,6 +166,8 @@ icon: mingcute:android-fill
 
 #### `adb tcpip`를 사용하여 무선 포트를 엽니다
 
+::: steps
+
 1. 방금 열린 명령 프롬프트 창에 다음 명령을 입력하여 무선 디버깅을 활성화합니다.
 
    ```bash
@@ -172,12 +182,16 @@ icon: mingcute:android-fill
 3. MAA `설정` - `연결 설정` - `연결 주소에` `<IP>:5555`와 같이 현재 장치의 IP 주소를 입력합니다. (예: `192.168.1.2:5555`)
 4. Link Start!
 
+:::
+
 #### `adb pair`를 사용하여 무선 포트를 엽니다
 
 ::: tip
 `adb pair`는 안드로이드 11 이상에서 개발자 옵션의 `무선 디버깅`을 사용하여 페어링한 후 연결하는 것으로, 유선 연결을 안할 수 있습니다.
 :::
 
+::: steps
+
 1. 휴대폰의 개발자 옵션으로 이동하여 `무선 디버깅`을 클릭하여 활성화하고 확인을 클릭한 후 `페어링 코드로 디바이스 페어링`을 클릭하고 페어링이 완료될 때까지 나타나는 팝업을 닫지 마세요.
 
 2. 페어링을 시작합니다.
@@ -188,11 +202,17 @@ icon: mingcute:android-fill
 3. 현재 장치 화면에 나타나는 `<IP 주소 및 포트>`를 MAA `설정` - `연결 설정` - `연결 주소`에 입력합니다. (예: `192.168.1.2:11451`), **이전에 입력한 것과 반드시 다르게 입력하세요.**
 4. Link Start!
 
+:::
+
 #### 루트 권한을 사용하여 무선 포트를 엽니다
 
 ~~root를 했으면 이 문서를 더이상 보지 않아도 됩니다~~
 
+::: 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/ko-kr/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)로 설정해야 합니다.

docs/ko-kr/manual/device/macos.md

@@ -13,9 +13,11 @@ icon: basil:apple-solid
 
 참고: macOS 자체적인 문제로 인해 게임 창을 최소화하거나 배경으로 이동한 후 다른 창으로 전환하거나 창을 다른 데스크톱/화면으로 이동하는 경우 스크린샷이 문제가 발생하여 제대로 작동하지 않을 수 있습니다. 관련된 이슈 [#4371](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/4371#issuecomment-1527977512)
 
+::: steps
+
 0. 요구 사항: MAA 버전 v4.13.0-rc.1 이상
 
-1. [fork버전의 PlayCover](https://github.com/hguandl/PlayCover/releases)를 다운로드하고 설치하세요.
+1. [fork 버전의 PlayCover](https://github.com/hguandl/PlayCover/releases)를 다운로드하고 설치하세요.
 
 2. [복호화된 명일방주 설치 파일](https://decrypt.day/app/id1454663939)을 다운로드하고 PlayCover에 설치하세요.
 
@@ -29,6 +31,8 @@ icon: basil:apple-solid
 
 7. 3-5 단계는 한 번만 수행하면 됩니다. 이후 명일방주를 다시 업데이트한 후에는 2단계를 다시 수행해야 합니다.
 
+:::
+
 ### ✅ [MuMu 에뮬레이터 Pro](https://mumu.163.com/mac/)
 
 지원됩니다. 그러나 테스트는 적고 `MacPlayTools` 이외의 터치 모드를 사용해야 합니다. 관련된 이슈 [#8098](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/8098)

docs/ko-kr/manual/device/windows.md

@@ -40,6 +40,11 @@ const fullySupport = [
         note: '완전히 호환됩니다. 에뮬레이터의 `설정` - `고급 설정`에서 `ADB 기능`을 켜야 합니다. Hyper-V와 호환되는 것으로 알려져 있습니다.\n\n- 느리고 번들로 제공되는 설치를 피하기 위해 [오프라인 설치 프로그램](https://support.bluestacks.com/hc/en-us/articles/4402611273485-BlueStacks-5-offline-installer)을 다운로드하는 것이 좋습니다; [Android 11](https://support.bluestacks.com/hc/en-us/articles/4402611273485-BlueStacks-5-offline-installer#:~:text=To%20install%20BlueStacks%205%20Android%2011) 버전 설치를 권장합니다; 제거하려면 공식 [제거 도구](https://support.bluestacks.com/hc/en-us/articles/360057724751-How-to-uninstall-BlueStacks-5-BlueStacks-X-and-BlueStacks-Services-completely-from-your-PC)를 사용하여 잔여물을 제거하세요.\n- adb 포트 번호가 계속 불규칙하게 변경되고 시작할 때마다 다르다면 컴퓨터에 [Hyper-V](https://support.bluestacks.com/hc/en-us/articles/4415238471053-System-requirements-for-BlueStacks-5-on-Hyper-V-enabled-Windows-10-and-11)가 활성화되어 있기 때문일 수 있습니다. MAA는 이제 BlueStacks 에뮬레이터 구성 파일 내에서 포트 번호를 자동으로 읽으려고 시도할 것입니다. 이 방법이 작동하지 않거나 다중 실행/둘 이상의 에뮬레이터 커널이 설치된 경우 [연결 설정](../connection.md#bluestacks-에뮬레이터-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://kr.bignox.com/',

docs/ko-kr/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`를 입력해야 합니다. MAA는 6스테이지가 대리 지휘가 불가능할 경우 자동으로 5스테이지로 전환합니다.
   - 스킬 북, 구매 증명서, 카본 부품 5스테이지는 `CA-5`/`AP-5`/`SK-5`를 입력해야 합니다.
   - 모든 칩 스테이지. 완전한 스테이지 코드를 입력해야 합니다. 예: `PR-A-1`.

docs/ko-kr/manual/introduction/reclamation-algorithm.md

@@ -7,15 +7,53 @@ icon: solar:streets-map-point-linear
 
 현재 생존 연산 기능은 초기 단계이며, 현재 단계에서는 안정성을 보장할 수 없습니다.
 
-## 기본 모드
+## 사막 이야기（Tales）
+
+### 기본 모드
 
 1. 생존 연산 메인화면에서 시작해야합니다
 2. 기존 데이터(진행사항)가 있으면 사용할 수 없습니다.
 3. 생존 연산의 편성창에 오퍼레이터가 있으면 안됩니다.
 
-## 도구 제조 모드
+### 도구 제조 모드
 
 1. 생존 연산 주둔지가 보이는 화면에서 시작해야합니다.
 2. 제작할 도구 이름 미작성시, 기본적으로 형광봉을 만듭니다.
 3. 결산 후 첫 번째 날이어야 하며, 이 후 3일 이내에 적의 침입이 없어야 합니다.
 4. 제조 가능한 수량이 99의 배수일 경우 멈출 수 있습니다. 저장하기 전에 재료를 약간 사용한 후에 다시 시도하세요.
+
+## 리런치 앵커（RelaunchAnchor）
+
+### RA-1
+
+- 수익 참고: 약 159 토큰 + 통합 포인트, 1회 약 2분 10초
+- 오퍼레이터 요구사항: 없음
+- 전제 조건: 메인 스토리에서 RA-1 클리어 상태
+- 월드맵에서 RA-1을 열고, 우하단에 "건설 시작"이 나타나면 작업을 시작하면 자동 루프됩니다
+- 주의: 시작 시 추가 아이템을 가져가는 기술을 해금한 경우, 해당 시설(식품 공급소, 음료 공급소, 대형 우리 등)을 제거해 주세요
+- 작업 흐름: 정경세작→건설→자원 납품→결산 자동 루프
+
+### RA-4
+
+- 수익 참고: 약 417 토큰 + 통합 포인트, 1회 약 1분 40초
+- 오퍼레이터 요구사항: 비샤델 (서포트 사용 가능)
+- 사전 조건:
+  1. 메인 스토리를 진행하여 RA-4를 클리어한 상태로 만듭니다.
+  2. "전략 계획 경영"을 해금합니다.
+  3. 자신이 비샤델을 보유한 경우, 수동으로 스테이지를 열고 한 번 편성합니다. 비샤델보다 코스트가 낮은 임의의 5명의 오퍼레이터 + 비샤델로 하고, 비샤델을 6번째 슬롯(마지막으로 선택하는 자리)에 배치합니다. 그 후 모집을 확정하고, 이번 건설을 포기한 후 "건설 시작"에서 시작합니다.
+  4. 서포트 비샤델을 사용하는 경우, 비샤델이 스나이퍼 서포트 첫 페이지에 있는지 확인합니다(친구 고려). 수동으로 스테이지를 열어 비샤델보다 코스트가 낮은 임의의 5명의 오퍼레이터를 편성하고, 6번째 슬롯에 서포트 비샤델을 선택한 후 모집을 확정합니다. 그 후 이번 건설을 포기하고 "건설 시작"에서 시작합니다 (앞의 5개 슬롯에 오퍼레이터가 있고 6번째는 비어 있는지 확인).
+- 월드맵에서 RA-4를 열고, 우하단에 "건설 시작"이 나타나면 작업을 시작하면 자동 루프됩니다
+- 주의: 시작 시 추가 아이템을 가져가는 기술을 해금한 경우, 해당 시설(식품 공급소, 음료 공급소, 대형 우리 등)을 제거해 주세요
+- 작업 흐름: "경영 계획"으로 얻은 적금을 사용하여 지역을 해금하고, 비샤델로 보스 처치 임무를 완료합니다。
+
+### RA-15
+
+- 수익 참고: 약 500 토큰 + 통합 포인트, 1회 약 3분
+- 오퍼레이터 요구사항: 시빌라이트 에테르나 (서포트 사용 가능)
+- 전제 조건:
+  1. 메인 스토리에서 RA-15 클리어 상태
+  2. 시빌라이트 에테르나를 보유한 경우, 수동으로 스테이지를 열고 편성 설정: 뱅가드 5기(육성 불필요) + 에테르나를 6번째에 배치, 저장 후 퇴장
+  3. 서포트 시빌라이트 에테르나 사용 시, 술사 서포트 첫 페이지에 표시되도록 조정
+- 월드맵에서 RA-15를 열고, 우하단에 "건설 시작"이 나타나면 작업을 시작하면 자동 루프됩니다
+- 주의: 시작 시 추가 아이템을 가져가는 기술을 해금한 경우, 해당 시설을 제거해 주세요
+- 작업 흐름: 시빌라이트 에테르나로 60킬 미션 달성

docs/ko-kr/manual/introduction/recruit.md

@@ -11,10 +11,14 @@ icon: fluent:people-24-filled
 
 `즉시 완료 허가증` 자동 사용을 지원하며, 1회 실행 시 `최대 모집 횟수`를 설정할 수 있습니다. `즉시 완료 허가증 자동 사용`과 연계하여 모집권을 한 번에 모두 소모할 수도 있습니다.
 
-1★, 5★, 6★이 나오면 알림이 표시됩니다.
+보류 대상으로 지정한 태그, 5★ 태그, 6★ 태그가 나오면 알림이 표시됩니다.
 
 공개모집이 될 때마다 공채 태그 데이터가 자동으로 [펭귄 물류](https://penguin-stats.cn/) 및 [Yituliu](https://ark.yituliu.cn/)에 업로드 됩니다.
 
 ## 고급 설정
 
 `자동 모집`은 MAA가 태그를 자동으로 선택하고 모집을 진행합니다. `수동 모집`은 자동 선택 및 모집을 하지 않습니다.
+
+`3★ 태그 우선`을 켜면 선호하는 3★ 태그를 추가로 고를 수 있습니다. `선택한 태그 보류`를 켜면 유지하고 싶은 태그를 고를 수 있습니다.
+
+보류 대상으로 지정한 태그 중 하나라도 인식되면 MAA는 현재 공개모집 슬롯을 유지한 채 이번 모집을 건너뛰며, 확인을 진행하지 않습니다.

docs/ko-kr/manual/introduction/tools.md

@@ -11,26 +11,32 @@ icon: octicon:tools-16
 
 이전에 오퍼레이터 인식을 실행한 경우 인식이 완료된 오퍼레이터의 잠재력 데이터가 표시됩니다.
 
-## 오퍼레이터 인식 (Beta)
+## 오퍼레이터 인식
 
 보유한 및 보유하지 않은 오퍼레이터 목록을 인식하고 공개모집 인식에 표시될 잠재력 데이터를 인식하여 저장할 수 있습니다.
 
-## 창고 인식 (Beta)
+현재 다음과 같은 내보내기 형식을 지원합니다:
+
+- 클립보드
+- JSON
+- Markdown 표
+- CSV 표
+
+## 창고 인식
 
 메인 페이지에서 자동으로 창고 화면으로 이동하는 기능을 지원합니다. 자동으로 이동하는데 실패하면 수동으로 `육성 재료` 화면으로 전환하고 왼쪽 끝까지 슬라이드하여 기능을 시작하세요.
 
-현재 [펭귄 물류](https://penguin-stats.cn/planner), [Arknights Toolbox](https://arkntools.app/#/material), [Arknights | Planner](https://ark-nights.com/settings)로 내보내기 기능을 지원합니다.
+현재 다음과 같은 내보내기 형식을 지원합니다:
+
+- [펭귄 물류](https://penguin-stats.io/planner) (ArkPlanner)
+- [Arknights Toolbox](https://arkntools.app/#/material) (Lolicon)
+- Markdown 표
+- CSV 표
 
 JSON 프로토콜과 통합을 희망하는 경우 언제든지 문의해주세요.
 
 앞으로 더 유용한 기능이 추가될 **가능성**이 있습니다.
 
-## 영상 인식 (Alpha)
-
-전술 비디오를 인식하고 자동으로 자동지휘 파일을 생성할 수 있습니다. 비디오 파일을 자동지휘 탭 페이지로 끌어다 놓으면 시작됩니다.
-
-가로세로 비율이 16:9 이고 720p 이상의 해상도를 갖는 비디오만 지원됩니다. 비디오 내용에는 검은 테두리, 왜곡 보정, 에뮬레이터 테두리 또는 기타 요소가 없어야 합니다.
-
 ## 헤드헌팅 (가챠)
 
 ::: center
@@ -48,3 +54,15 @@ MAA의 눈을 통해 세상을 보고 싶나요? 이제 그것이 왔습니다!
 MAA는 목표 프레임 레이트로 에뮬레이터에서 스크린샷을 시도하고, 실시간으로 창에 스크린샷을 표시합니다.
 
 스크린샷 속도가 목표 프레임 레이트에 비해 현저히 느릴 때, MAA는 스크린샷 속도에 맞추기 위해 목표 프레임 레이트를 자동으로 낮춥니다. ~~스트레스 테스트로 사용할 수 있습니다~~
+
+## 미니게임
+
+이벤트의 미니게임을 자동으로 반복합니다. 이름 선택을 지원하며, 설정에서 상설과 현재 한정 이벤트를 전환할 수 있습니다.
+
+내장 기능:
+
+- 이벤트 상점 교환
+- 초록 티켓 상점 교환
+- 노란 티켓 상점 교환
+- 생식연산 상점 교환
+- 시크릿 프론트 (엔딩과 이벤트 분기 선택 지원)

docs/ko-kr/protocol/base-scheduling-schema.md

@@ -137,6 +137,6 @@ JSON 파일은 주석을 지원하지 않으므로, 텍스트 내의 주석은
 
 ## 예시
 
-[243 극한 효율, 하루 3회 교대](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
+[243 극한 효율, 하루 3회 교대](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master-v2/resource/custom_infrast/243_layout_3_times_a_day.json)
 
-[153 극한 효율, 하루 3회 교대](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
+[153 극한 효율, 하루 3회 교대](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master-v2/resource/custom_infrast/153_layout_3_times_a_day.json)

docs/ko-kr/protocol/callback-schema.md

@@ -265,7 +265,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
 - `MedicineConfirm`  
   이성 회복제 사용 확인
 - `ExpiringMedicineConfirm`  
-  48시간 내 만료되는 이성 회복제 사용 확인
+  만료 임박한 이성 회복제 사용 확인
 - `StoneConfirm`  
   오리지늄 사용 확인
 - `RecruitRefreshConfirm`  
@@ -364,6 +364,15 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
   :::
   ::::
 
+- `RecruitPreservedTag`  
+  공개모집에서 보류 대상으로 설정된 태그를 식별했습니다. `details` 필드 내용은 다음과 같습니다:
+
+  :::: field-group
+  ::: field name="tag" type="string" required
+  보류를 트리거한 태그 명칭, 예: `지원 기계`
+  :::
+  ::::
+
 - `RecruitResult`  
   공개모집 식별 결과. `details` 필드 구조는 다음과 같습니다:
   - `tags` (array, required): 식별된 모든 태그, 현재 5개로 고정

docs/ko-kr/protocol/integrated-strategy-schema.md

@@ -793,12 +793,6 @@ OCR로 이벤트 이름을 인식하지만, 선택지는 **고정된 위치**를
 
 MAA는 쉐이 통합 전략에서 자동으로 주화를 줍고 교환합니다.
 
-::: tip 활성화 조건
-
-- 투자 모드: "투자 모드에서 쇼핑/모집/2층진입 켜기" 옵션 필요
-- 기타 모드: 기본 활성화
-  :::
-
 1. **주화 줍기**: 전투 종료 후 주화 드랍 창에서 `pickup_priority`가 가장 높은 것을 선택.
 2. **주화 교환**: 주머니가 꽉 찼을 때 새 주화를 주우면:
    - 주머니 속 주화들의 유형/이름/투척상태 식별

docs/ko-kr/protocol/integration.md

@@ -119,7 +119,7 @@ Bilibili 서버: `张三`인 경우 `张三`, `张`, `三` 입력 가능
 <br>
 `"1-7"`, `"S3-2"` 등 모든 메인 스토리 스테이지 지원
 <br>
-스테이지명 끝에 `Normal`/`Hard`를 입력하여 일반/하드 난이도 전환 가능
+스테이지명 끝에 `-NORMAL`/`-HARD`를 추가해 난이도 전환 가능 (10-14장은 표준/재앙, 15장 이후는 일반/험지)
 <br>
 섬멸 작전의 경우 반드시 `"Annihilation"` 입력
 <br>
@@ -128,8 +128,11 @@ Bilibili 서버: `张三`인 경우 `张三`, `张`, `三` 입력 가능
 ::: field name="medicine" type="number" optional default="0"  
 이성 회복제 최대 사용 개수  
 :::  
-::: field name="expiring_medicine" type="number" optional default="0"  
-48시간 내 만료되는 이성 회복제 최대 사용 개수  
+::: field name="medicine_expire_days" type="number" optional default="0"  
+지정된 일수 이내에 만료되는 이성 회복제를 사용합니다. `0`은 만료 임박 이성 회복제를 사용하지 않음을 의미합니다.  
+:::  
+::: field name="expiring_medicine" type="number" optional default="0" deprecated  
+v6.8.0부터 폐기됨. 대신 `medicine_expire_days`를 사용하세요.  
 :::  
 ::: field name="stone" type="number" optional default="0"  
 오리지늄 최대 사용 개수  
@@ -184,7 +187,7 @@ Bilibili 서버: `张三`인 경우 `张三`, `张`, `三` 입력 가능
    "enable": true,
    "stage": "1-7",
    "medicine": 1,
-   "expiring_medicine": 0,
+   "medicine_expire_days": 2,
    "stone": 0,
    "times": 10,
    "series": 0,
@@ -248,7 +251,14 @@ Bilibili 서버: `张三`인 경우 `张三`, `张`, `三` 입력 가능
 즉시 완료 사용 횟수, `expedite`가 true일 때만 유효. 기본값은 무제한(즉 `times` 상한까지)  
 :::  
 ::: field name="skip_robot" type="boolean" optional default="true"  
-로봇 태그 인식 시 건너뛸지 여부  
+폐기 예정이며 구형 파라미터 호환용으로만 유지됩니다.  
+<br>
+`preserve_tags`가 없고 이 값이 `true`이면 `支援机械` 인식 시에만 건너뜁니다. `元素`는 더 이상 구형 1★ 태그로 취급하지 않습니다.  
+:::
+::: field name="preserve_tags" type="array<string>" optional  
+현재 공개모집 슬롯을 유지한 채 이번 모집을 건너뛸 Tag 이름 목록입니다. 기본값은 빈 배열입니다.  
+<br>
+지정한 Tag 중 하나라도 인식되면 MAA는 해당 슬롯을 유지하고 이번 모집을 건너뜁니다.  
 :::  
 ::: field name="recruitment_time" type="object" optional  
 태그 등급(3 이상)과 대응하는 희망 모집 시간(분 단위), 기본값은 모두 540(즉 09:00:00)
@@ -289,7 +299,7 @@ Yituliu 전송 ID, 기본값 비어 있음. `report_to_yituliu`가 true일 때
    "set_time": true,
    "expedite": false,
    "expedite_times": 0,
-   "skip_robot": true,
+   "preserve_tags": ["支援机械"],
    "recruitment_time": {
       "3": 540,
       "4": 540
@@ -899,32 +909,44 @@ Sarkaz 테마, Investment 모드, "연금술 분대" 또는 "지원 분대"일
 ::: field name="enable" type="boolean" optional default="true"  
 본 작업 활성화 여부  
 :::  
-::: field name="theme" type="string" optional default="Fire"  
+::: field name="theme" type="string" optional default="Tales"  
 테마
 <br>
-`Fire` - _모래 속의 불_
+`Fire` - _모래 속의 불_（종료）
 <br>
-`Tales` - _사막 이야기_  
+`Tales` - _사막 이야기_
+<br>
+`RelaunchAnchor` - _리런치 앵커_  
 :::  
 ::: field name="mode" type="number" optional default="0"  
-모드
+모드. 테마마다 지원하는 모드가 다릅니다:
 <br>
-`0` - 점수 및 건설 포인트 파밍, 전투 진입 후 바로 포기
+**Tales（사막 이야기）：**
 <br>
-`1` - 모래 속의 불: 적금 파밍, 연락원에게 물 구매 후 기지에서 주조; 사막 이야기: 자동 아이템 제작 및 로드 반복으로 화폐 파밍  
+`0` - 세이브 없음, 스테이지 반복으로 번영의 선물 획득。
+<br>
+`1` - 세이브 있음, 도구 제작으로 번영의 선물 획득。
+<br>
+**RelaunchAnchor（리런치 앵커）：**
+<br>
+`16` (`RA1`) - RA-1, 정경세작→건설→자원 납품→결산 자동 루프。
+<br>
+`32` (`RA15`) - RA-15, 시빌라이트 에테르나로 60킬 미션 달성。
+<br>
+`48` (`RA4`) - RA-4, "경영 계획"으로 얻은 적금을 사용하여 지역을 해금하고, 비샤델로 보스 처치 임무를 완료합니다。
 :::  
 ::: field name="tools_to_craft" type="array<string>" optional default="[&quot;荧光棒&quot;]"  
-자동 제작 아이템, 부분 문자열 입력 권장  
+자동 제작 아이템, 부분 문자열 입력 권장. Tales 테마에서만 유효  
 :::  
 ::: field name="increment_mode" type="number" optional default="0"  
-클릭 유형
+클릭 유형. Tales 테마에서만 유효
 <br>
 `0` - 연타
 <br>
 `1` - 꾹 누르기
 :::  
 ::: field name="num_craft_batches" type="number" optional default="16"  
-1회 최대 제작 배치 수  
+1회 최대 제작 배치 수. Tales 테마에서만 유효  
 :::  
 ::::
 
@@ -1148,4 +1170,7 @@ AdbLite 사용 여부. 옵션: "0" 끄기, "1" 켜기. 열거값: 4
 ::: field name="KillAdbOnExit" type="boolean" optional  
 종료 시 ADB 프로세스 종료 여부. 옵션: "0" 끄기, "1" 켜기. 열거값: 5  
 :::  
+::: field name="ClientType" type="string" optional  
+클라이언트 종류(게임 채널). 대부분의 연결 설정에서는 필요하지 않습니다. `AsstConnect` / `AsstAsyncConnect` 에 전달하는 `config` 가 연결 단계에서 실행되는 명령에 `[PackageName]` 을 사용할 때만, 연결 전에 `AsstSetInstanceOption(..., ClientType, ...)` 를 호출해 설정해야 합니다. 현재 내장 설정 중에서는 `Androws` 와 `WSA` 의 `displayId` 조회만 이 값에 의존합니다. 이 옵션은 StartUp / CloseDown 등의 작업 파라미터 `client_type` 를 대체하지 않습니다. 열거값: 6  
+:::  
 ::::

docs/zh-cn/develop/documentation-guidelines.md

@@ -21,6 +21,8 @@ icon: jam:write-f
 
 该主题提供了关于提示、注释、信息、注意、警告和详情自定义容器的支持，我们可以利用这一特性来强调部分内容
 
+需要注意的是，如果容器中嵌套了容器，则父级容器应比子集容器多写一个冒号 `:` 以进行区分，例如[步骤容器](#步骤)
+
 容器的使用方法：
 
 ```markdown
@@ -44,7 +46,7 @@ icon: jam:write-f
 - `warning` 注意
 - `danger` 警告
 - `details` 详情
-- `demo-warpper` ==特殊容器==
+- `window` ==特殊容器==
 
 ### 容器示例
 
@@ -72,7 +74,7 @@ icon: jam:write-f
 这是详情容器
 :::
 
-::: demo-wrapper
+::: window
 这是一个很特殊的容器
 :::
 
@@ -113,7 +115,7 @@ MaaAssistantArknights 是由 ==很多猪== 开发的
 
 有以下配置可以使用
 
-::: demo-wrapper
+::: window
 输入：
 
 ```markdown
@@ -136,8 +138,6 @@ MaaAssistantArknights 是由 ==很多猪== 开发的
 
 当你正在写一个步骤化的教程时，有序列表可能会因为嵌套失去层次感，这种时候 `steps` 容器就是最好的选择
 
-注意该容器用四个冒号来标记开始和结束，与常规的容器不同
-
 输入：
 
 ````markdown
@@ -188,11 +188,11 @@ MaaAssistantArknights 是由 ==很多猪== 开发的
 
 ## 智能图片容器
 
-我们基于主题提供的功能包装了一个图片容器。该容器能够在亮暗主题下自动显示对应主题的，同时支持自动布局
+我们基于主题提供的功能包装了一个图片容器。该容器能够在亮暗主题下自动显示对应主题的图片，同时支持自动布局
 
 你可以在 markdown 正文中使用 `<ImageGrid>` 组件来调用该方法，具体的语法和效果如下
 
-::: demo-wrapper
+::: window
 
 这是语法：
 
@@ -292,7 +292,7 @@ icon: jam:write-f
 - `color` 接受 css 风格的颜色值，如 `#fff`，`red` 等（该选项仅对 svg 图标有效）
 - `size` 接受 css 风格的大小，如 `1rem`，`2em`，`100px` 等
 
-::: demo-wrapper 案例
+::: window 案例
 
 输入：
 

docs/zh-cn/manual/cli/config.md

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