mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-18 10:10:45 +08:00
b9a850a8c1
## Summary by Sourcery 引入专用的悖论协战任务，并优化协战、OCR、肉鸽和基建相关行为，同时移除旧版视频识别路径，并相应更新协议、资源和 UI。 New Features: - 新增专用的 `ParadoxCopilot` 核心任务和 WPF 模型，用于运行单次或多次的悖论模拟操作。 - 在 UI 中暴露一个肉鸽主题提示字符串，会随所选主题动态更新。 - 在关卡提示 UI 中，将背包物品数量与支线关卡掉落提示一并展示。 Bug Fixes: - 禁止在非空闲状态下启动协战任务，并在标签页、任务类型与协战列表之间实施更严格的校验，避免任务类型不匹配或空任务运行。 - 修复悖论任务校验逻辑：通过本地化名称检查干员，并在数据过期时触发资源重载和成就更新。 - 确保仓库识别完成后会更新日期输入提示，并在处理报告响应时避免覆盖已有的企鹅 ID。 - 处理物品列表查询中缺失的物品名称，改为返回 null，而不是回显物品 ID。 Enhancements: - 优化协战文件名处理、文件名显示更新、用户附加信息解析和多任务列表管理，同时移除基于视频的协战流程支持。 - 拓展悖论识别功能以支持读取协战文件，与战斗任务集成，并通过新增的界面任务支持批量悖论操作。 - 通过根据硬件并发度限制线程数并设置顺序执行模式来优化 OCR 和 ONNX 的 CPU 执行表现，并记录相关配置日志。 - 改进基建线索处理：使用 OCR 决定是否通过「快速填入」按钮进行批量插入，简化返回接待室的导航流程，并在设施检测失败时保存调试图片。 - 在协战物品集合发生变化时增加日志和索引维护，并确保自动编队和协战列表的使用遵循当前选中的标签页。 - 将自动资源重载功能置于新的用户开关之后，并在合适的构建版本中提供对应的 UI 选项。 - 收紧协战多任务序列化的错误信息，并在助手中清晰区分 SSS 和悖论列表的处理。 - 阻止从临时目录运行应用程序，并向用户显示错误提示，同时新增用于检测临时目录运行环境的工具方法。 - 在核心、代理和文档中统一「集成战略」回调事件名称和日志键（`Combat/Emergency`）。 - 通过使用现代集合初始化器和属性依赖工具，以及集中处理部分 UI 更新，简化多个 WPF 视图模型与服务实现。 Build: - 从代码库中移除 AutoLocalization 工具目录及相关 Python 项目文件。 Documentation: - 更新所有支持语言的集成协议文档，移除已废弃的协战列表字段 `is_paradox` 支持，并补充新的 `ParadoxCopilot` 任务结构说明。 - 修订回调结构文档，在所有语言中反映重命名后的集成战略战斗相关子任务标识符。 Chores: - 更新明日方舟资源数据文件（关卡、地块、战斗数据、基建、物品索引、肉鸽任务、UI 主题任务以及版本元数据），并为近期关卡新增地块位置文件。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Introduce a dedicated paradox copilot task and refine copilot, OCR, roguelike, and infrastructure behaviors while removing legacy video recognition paths and updating protocols, resources, and UI accordingly. New Features: - Add a dedicated ParadoxCopilot core task and WPF model to run single or multiple paradox simulation operations. - Expose a roguelike theme tip string in the UI that updates with the selected theme. - Surface inventory counts alongside side-story stage drop tips in the stage tips UI. Bug Fixes: - Prevent starting copilot tasks from non-idle state and enforce better validation between tabs, task types, and copilot lists to avoid mismatched or empty runs. - Fix paradox task validation by checking operators against localized names, triggering resource reloads and achievements on outdated data. - Ensure depot recognition completion updates the date prompt and avoid overwriting an existing Penguin ID when processing report responses. - Handle missing item names in item list lookups by returning null instead of echoing the ID. Enhancements: - Refine copilot filename handling, display filename updates, user additional parsing, and multi-task list management, while dropping support for video-based copilot flows. - Extend paradox recognition to consume copilot files, integrate with the battle task, and support batch paradox operations via a new interface task. - Optimize OCR and ONNX CPU execution by limiting thread counts based on hardware concurrency and setting sequential execution modes, and log relevant configuration. - Improve infrastructure clue handling by using OCR to decide bulk insertion via the quick-insert button, simplifying navigation back to reception, and saving debug images when facility detection fails. - Add logging and index maintenance when the copilot item collection changes and ensure auto-formation and copilot list usage respect the selected tab. - Gate auto resource reload behind a new user-toggle flag, and expose a UI option for it in appropriate builds. - Tighten copilot multi-task serialization error messages and cleanly separate SSS and paradox list handling in the assistant. - Block running the app from temporary directories with a user-facing error message, and add a utility to detect temp-directory execution environments. - Align Integrated Strategy callback event names and logging keys (Combat/Emergency) across core, proxy, and documentation. - Simplify various WPF view models and services by using modern collection initializers and property dependency utilities, and by centralizing certain UI updates. Build: - Remove the AutoLocalization tooling directory and associated Python project files from the repository. Documentation: - Update integration protocol docs in all supported languages to remove deprecated copilot list `is_paradox` support and document the new ParadoxCopilot task schema. - Revise callback schema docs to reflect renamed Integrated Strategy combat-related subtask identifiers across all languages. Chores: - Update Arknights resource data files (stages, tiles, battle data, infrastructure, item index, roguelike tasks, UI theme tasks, and version metadata) and add new tile position files for recent stages. </details>
MAA
简体中文 | 繁體中文 | English | 日本語 | 한국어
MAA 的意思是 MAA Assistant Arknights
一款明日方舟游戏小助手
基于图像识别技术，一键完成全部日常任务！
绝赞更新中 ✿✿ヽ(°▽°)ノ✿
下载与安装
请阅读 文档 后前往 官网 或 Releases 下载，并参考 新手上路 进行安装。
亮点功能
- 理智作战，掉落识别及上传 企鹅物流，一图流
- 智能基建换班，自动计算干员效率，单设施内最优解；同时也支持 自定义排班
- 自动公招，可选使用加急许可，一次全部刷完！公招数据自动上传 企鹅物流，一图流
- 支持手动识别公招界面，方便对高星公招做出选择
（你的这个高资回费出的是推王呢还是推王呢） - 支持识别干员列表，统计已有和未有干员及潜能，并在公招识别显示
- 支持识别养成材料，并导出至 企鹅物流刷图规划、明日方舟工具箱、ARK-NIGHTS 干员培养表
- 访问好友、收取信用及购物、领取日常奖励等，一键全日常自动长草
- 肉鸽全自动刷源石锭和等级，自动烧水和凹直升，智能识别干员及练度
- 选择作业 JSON 文件，自动抄作业， 视频演示
- 支持 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多种接口，方便集成调用，自定义你的 MAA！
话不多说，看图！
使用说明
功能介绍
请参阅 用户手册。
外服支持
目前国际服（美服）、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足，很多功能并没有进行全面的测试，所以请自行体验。
若您遇到了 Bug，或对某个功能有强需求，欢迎在 Issues 和 讨论区 催更；或加入我们一起建设 MAA！请参阅 外服适配教程
CLI 支持
MAA 支持命令行界面（CLI）操作，支持 Linux，macOS 和 Windows，可用于自动化脚本或在无图形界面的服务器上使用。请参阅 CLI 使用指南
加入我们
主要关联项目
- 全新框架：MaaFramework
- 作业站 前端：zoot-plus-frontend
- 作业站 后端：ZootPlusBackend
- 官网：前端
- 深度学习：MaaAI
多语言 (i18n)
MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）为准。
参与开发
请参阅 开发指南。
API
- C 接口：集成示例
- Python 接口：集成示例
- Golang 接口：集成示例
- Dart 接口
- Java 接口：集成示例
- Java HTTP 接口
- Rust 接口：HTTP 接口
- TypeScript 接口
- Woolang 接口：集成示例
- 集成文档
- 回调消息协议
- 任务流程协议
- 自动抄作业协议
外服适配
请参阅 外服适配教程，对于国服已支持的功能，绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
Issue bot
请参阅 Issue Bot 使用方法
致谢
开源库
- 图像识别库：opencv
文字识别库：chineseocr_lite- 文字识别库：PaddleOCR
- 深度学习部署库：FastDeploy
- 机器学习加速器：onnxruntime
关卡掉落识别：企鹅物流识别- 地图格子识别：Arknights-Tile-Pos
- C++ JSON 库：meojson
- C++ 运算符解析器：calculator
C++ base64 编解码：cpp-base64- C++ 解压压缩库：zlib
- C++ Gzip 封装：gzip-hpp
- 安卓触控事件器：Minitouch
- 安卓触控事件器：MaaTouch
- WPF MVVM 框架：Stylet
- WPF 控件库：HandyControl -> HandyControls
- C# 日志：Serilog
- C# JSON 库：Newtonsoft.Json & System.Text.Json
下载器：aria2
数据源
公开招募数据：明日方舟工具箱干员及基建数据：PRTS Wiki- 关卡数据：企鹅物流数据统计
- 游戏数据及资源：明日方舟客户端素材
- 游戏数据：《明日方舟》Yostar游戏数据
贡献/参与者
感谢所有参与到开发/测试中的朋友们，是大家的帮助让 MAA 越来越好！ (*´▽｀)ノノ
声明
- 本软件使用 GNU Affero General Public License v3.0 only 开源，并附带额外 用户协议。
- 本软件 logo 并非使用 AGPL 3.0 协议开源，耗毛、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo，不得在未经授权的情况下将本软件 logo 用于任何商业用途。
- 本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能是设备与时间等费用，产生的问题及后果与本软件无关。
DirectML 支持说明
本软件支持 GPU 加速功能，其在 Windows 平台上依赖于 Microsoft 提供的独立组件 DirectML。DirectML 并非本项目的开源部分，也不受 AGPL 3.0 的约束。为方便用户，我们随安装包附带了一个未经修改的 DirectML.dll 文件。如果您无需 GPU 加速功能，可安全删除该 DLL 文件，软件的核心功能仍可正常运行。
广告
用户交流 QQ 群：MAA 使用 & 粥游交流 QQ 群
Discord 服务器: 邀请链接
用户交流 TG 群：Telegram 群
自动战斗 JSON 作业分享：prts.plus
Bilibili 直播间：MrEO 直播间 直播敲代码 & MAA-Official 直播间 游戏/杂谈
技术群（舟无关、禁水）：内卷地狱！(QQ 群)
开发者群：QQ 群
如果觉得软件对你有帮助，帮忙点个 Star 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！