mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-15 17:30:27 +08:00
0ea5e1ec9f
- ~~等 #15773 ，以及顺带修一下掉落识别~~ ## Summary by Sourcery 准备 6.3.3 版本发布，包含对视觉识别、干员招募、基建规划、启动流程以及窗口附加行为的多项稳定性修复，并加入新的输入模式以及更新后的游戏/任务资源和 UI 文本。 新功能： - 暴露新的 Win32 输入方式，可使用窗口相对位置发送或投递消息，并在附加窗口的鼠标方式设置中提供这些选项。 错误修复： - 加强矩形校正逻辑以应对完全在屏幕外的区域，避免在基于视觉的识别中产生无效 ROI。 - 确保招募计算使用视图模型中配置的选择时间，而不是任务队列中的数值。 - 将基建自定义方案选择默认为未设置状态，并相应迁移现有配置。 - 当使用附加窗口连接时自动禁用 StartGame 选项，以防止产生冲突的启动行为。 - 阻止启动任务重复尝试主开始按钮的动作，以减少不必要的重试。 增强内容： - 调整游戏/任务资源定义（包括肉鸽玩法以及特定关卡/任务配置），以适配更新后的游戏流程和掉落识别行为。 - 刷新本地化内容和版本更新对话框文案，以适配 6.3.3 版本发布。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Prepare 6.3.3 release with multiple stability fixes to vision, recruitment, infrastructure planning, startup, and attach-window behavior, plus new input modes and updated game/task resources and UI text. New Features: - Expose new Win32 input methods that send or post messages using window-relative positions and surface them in the attach-window mouse method settings. Bug Fixes: - Harden rectangle correction against completely off-screen regions to avoid invalid ROIs during vision-based recognition. - Ensure recruitment calculation uses the view model’s configured selection times instead of the task queue’s values. - Default infrastructure custom plan selection to an unset state and migrate existing configs accordingly. - Disable the StartGame option automatically when using attach-window connection to prevent conflicting launch behavior. - Prevent startup tasks from retrying the primary start button action to reduce erroneous retries. Enhancements: - Adjust game/task resource definitions (including Roguelike and specific stage/task configs) for updated gameplay flows and drop recognition behavior. - Refresh localizations and version update dialog content for the 6.3.3 release. </details> ## Summary by Sourcery 重构任务队列视图模型以共享通用序列化接口，提升基于视觉的识别与任务执行流程的稳定性，并为 6.3.3 版本更新输入选项、配置默认值和游戏资源。 新特性： - 新增 Win32 输入方式，可发送或投递相对窗口的消息，并将其作为可选的鼠标输入选项用于“附加窗口”连接。 错误修复： - 防止无效或完全位于屏幕外的矩形在视觉处理过程中产生错误的感兴趣区域（ROI）。 - 确保干员招募概率计算使用视图模型中配置的选人时间，而不是任务模型中的值。 - 通过将主开始按钮在启动任务中的重试上限设为 0，避免对主开始按钮进行重复重试。 - 将基础设施自定义方案选择默认为未设置状态，并迁移现有配置以避免意外选择方案。 - 在使用“附加窗口”模式时自动禁用 StartGame 行为，以防止启动流程冲突。 增强改进： - 引入任务队列视图模型的共享序列化接口，并迁移多个任务设置模型以使用该接口，实现统一的任务编码。 - 收紧肉鸽、战斗、贸易站（商城）、基建、启动、奖励、回收与自定义任务的序列化逻辑，同时不改变用户可见行为。 - 调整关卡掉落 OCR，当关卡编号已确定为无效时跳过特殊的二次识别，减少不必要的工作量。 - 更新商城信用战验证和黑名单处理逻辑，更好地遵守每周日程并兼容不同客户端的黑名单映射。 - 统一配置序列化选项及默认值，并在各服务器区域刷新肉鸽与关卡任务的资源定义。 - 为 6.3.3 版本刷新本地化内容以及版本更新对话框文案。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Refactor task queue view models to share a common serialization interface, improve stability of vision-based recognition and task execution flows, and update input options, configuration defaults, and game resources for the 6.3.3 release. New Features: - Add new Win32 input methods that send or post window-relative messages and expose them as selectable mouse input options for attach-window connections. Bug Fixes: - Prevent invalid or fully off-screen rectangles from producing incorrect regions of interest during vision processing. - Ensure recruit probability calculations use the view model’s configured selection times instead of the task model values. - Avoid retrying the primary start button in startup tasks by capping its retry limit at zero. - Default infrastructure custom plan selection to an unset value and migrate existing configuration accordingly, avoiding unintended plan selection. - Disable the StartGame behavior automatically when using attach-window mode to prevent conflicting launch flows. Enhancements: - Introduce a shared serialization interface for task queue view models and migrate multiple task setting models to use it for consistent task encoding. - Tighten Roguelike, fight, mall, infrastructure, startup, award, reclamation, and custom task serialization logic without changing user-facing behavior. - Adjust stage drop OCR to skip special-case re-recognition when the stage code is known invalid, reducing unnecessary work. - Update mall credit-fight validation and blacklist handling to better respect weekly schedules and client-specific blacklist mappings. - Normalize configuration serialization options and defaults and refresh Roguelike and stage task resource definitions across regions. - Refresh localizations and the version update dialog copy for the 6.3.3 release. </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 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！