mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-15 17:30:27 +08:00
f3e4313e3a
## Summary by Sourcery 更新 copilot、paradox 和任务处理逻辑，以跟踪每个 copilot 的独立 ID、改进阶段导航和 OCR 的稳健性，并通过强类型事件将子任务消息接入 WPF UI，同时为更多任务添加截图插件并改进工具和文档。 New Features: - 在核心任务和 WPF 模型中支持按 copilot 区分的 ID，以更好地跟踪和操作特定的 copilot 条目。 - 在 WPF 层将子任务消息暴露为强类型事件，并在相关的设置视图模型中进行消费。 - 为 copilot 条目新增独立的视频 URL 字段和存在标记，而不是复用 copilot URL 字段。 Bug Fixes: - 修复在缺少提交作者或使用 web-flow 时的变更日志生成问题，通过在 PR 或提交中解析作者登录名来解决。 - 通过使用双精度累积来提高掩码模板匹配的数值稳定性，以避免灾难性消除。 - 修正模拟器自动启动逻辑，并在测试模拟器路径时增加校验。 Enhancements: - 重构 copilot 阶段导航，使用图像分析和 OCR 更可靠地定位和确认阶段，包括重试和对图表的处理。 - 在子任务的额外信息消息中包含 copilot ID，使 UI 能将结果与选中的条目进行关联。 - 为奖励、商店、仓库、战斗启动、基建开始和干员仓库进入等任务添加截图采集插件，以获得更好的诊断能力。 - 通过用事件机制替换静态分发器来简化任务子消息的传播。 - 对文档中的 copilot 协议命名进行轻微措辞调整，并更新若干资源和本地化内容。 Documentation: - 在主 README 和中文 README 中将 copilot 协议描述由「自动抄作业协议」重命名为「自动战斗协议」。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Update copilot, paradox, and task handling to track per-copilot IDs, improve stage navigation and OCR robustness, and wire subtask messages into the WPF UI via strongly typed events, while adding screenshot plugins to more tasks and refining tooling and docs. New Features: - Support per-copilot IDs through core tasks and WPF models to better track and act on specific copilot entries. - Expose subtask messages as strongly typed events in the WPF layer and consume them from relevant settings view models. - Add a dedicated video URL field and presence flag for copilot entries instead of overloading the copilot URL. Bug Fixes: - Fix changelog generation when commit authors are missing or web-flow by resolving author logins via PRs or commits. - Improve masked template matching numerical stability by using double precision accumulation to avoid catastrophic cancellation. - Correct emulator auto-start logic and add validation around testing the emulator path. Enhancements: - Rework copilot stage navigation to use image analysis and OCR to locate and confirm stages more reliably, including retries and plot handling. - Include copilot IDs in subtask extra info messages so the UI can correlate results with selected items. - Add screenshot capture plugins to award, mall, depot, fight startup, infrastructure begin, and operator box enter tasks for better diagnostics. - Simplify task submessage propagation by replacing the static dispatcher with an event-based mechanism. - Minor wording updates in documentation for the copilot protocol naming and various resource and localization updates. Documentation: - Rename the copilot protocol description from "自动抄作业协议" to "自动战斗协议" in the main and Chinese READMEs. </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 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！