mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-15 17:30:27 +08:00
5b8a260deb
## Summary by Sourcery 更新支持列表处理逻辑以使用回调方式，并让 ROI 自适应窗口大小，同时为新版本刷新 VSCode 扩展文档和打包资源元数据。 New Features: - 文档中新增 VSCode 扩展的功能说明，例如快速跳转到任务定义、ROI 复制、识别工具以及跨多种语言查看日志等能力。 Enhancements: - 重构 SupportList，使其由回调函数、assistant 实例和任务链构造，而不是依赖 AbstractTask 父类。 - 调整支持列表分析的 ROI 宽度，以更好适配不同的窗口宽度。 Documentation: - 扩展多语言 VSCode 扩展教程，增加功能概览、使用技巧、OCR 故障排查、日志查看说明，以及对 MaaFramework 版本选择行为的更清晰解释。 Chores: - 为新版本刷新打包的战斗/资源元数据、区域任务数据以及模板优化配置。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Update support list handling to use callbacks and adapt ROI to window size, while refreshing VSCode extension documentation and bundled resource metadata for the new release. New Features: - Document new VSCode extension capabilities such as quick task definition jump, ROI copy, recognition tools, and log viewing across multiple languages. Enhancements: - Refactor SupportList to be constructed from callback, assistant instance, and task chain instead of an AbstractTask parent. - Adjust support list analysis ROI width to better accommodate varying window widths. Documentation: - Expand multi-language VSCode extension tutorials with feature overview, usage tips, OCR troubleshooting, logging instructions, and clarified MaaFramework version selection behavior. Chores: - Refresh packaged battle/resource metadata, regional task data, and template optimization settings for the new version. </details> 增强功能： - 通过在等待详情面板出现时允许更多重试，提高支持单元选择的健壮性。 - 调整支持列表分析的 ROI 宽度计算，以更好地适应不同的窗口大小。 文档： - 扩展多语言 VSCode 插件教程，加入功能概览、使用技巧、日志查看说明，以及关于 MaaFramework 版本选择的最新行为说明。 日常维护： - 为新版本刷新打包的资源元数据和任务数据，包括特定地区的资源和优化模板。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery 更新支持列表处理逻辑以使用回调方式，并让 ROI 自适应窗口大小，同时为新版本刷新 VSCode 扩展文档和打包资源元数据。 New Features: - 文档中新增 VSCode 扩展的功能说明，例如快速跳转到任务定义、ROI 复制、识别工具以及跨多种语言查看日志等能力。 Enhancements: - 重构 SupportList，使其由回调函数、assistant 实例和任务链构造，而不是依赖 AbstractTask 父类。 - 调整支持列表分析的 ROI 宽度，以更好适配不同的窗口宽度。 Documentation: - 扩展多语言 VSCode 扩展教程，增加功能概览、使用技巧、OCR 故障排查、日志查看说明，以及对 MaaFramework 版本选择行为的更清晰解释。 Chores: - 为新版本刷新打包的战斗/资源元数据、区域任务数据以及模板优化配置。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Update support list handling to use callbacks and adapt ROI to window size, while refreshing VSCode extension documentation and bundled resource metadata for the new release. New Features: - Document new VSCode extension capabilities such as quick task definition jump, ROI copy, recognition tools, and log viewing across multiple languages. Enhancements: - Refactor SupportList to be constructed from callback, assistant instance, and task chain instead of an AbstractTask parent. - Adjust support list analysis ROI width to better accommodate varying window widths. Documentation: - Expand multi-language VSCode extension tutorials with feature overview, usage tips, OCR troubleshooting, logging instructions, and clarified MaaFramework version selection behavior. Chores: - Refresh packaged battle/resource metadata, regional task data, and template optimization settings for the new version. </details> </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 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！