mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-19 02:23:01 +08:00
a233635d80
## 由 Sourcery 生成的摘要 更新关卡活动处理逻辑以消费新的 StageActivityV2 格式，将丰富的小游戏元数据暴露给工具箱 UI，并在助战选择、线索发送、GPU 检测、原生互操作以及 DLL 劫持防护方面增强可靠性和安全性。 新功能： - 从新的 `StageActivityV2.json` 格式中解析丰富的小游戏条目，并将其绑定到 WPF 工具箱，以实现小游戏的动态配置。 缺陷修复： - 修正快速编队助战干员完成逻辑，用于跟踪已填充的干员分组，避免将未勾选的干员误标记为缺失。 - 提高基础设施线索发送时的重试次数，以提升可靠性。 - 确保变更日志窗口在已打开时被激活，而不是新建一个窗口。 - 修复 Windows 配置管理器 GPU 查询逻辑，使其正确使用 span 和缓冲池，避免缓冲区误用和泄漏。 - 扩展启动 DLL 白名单，以降低 WPF GUI 中的 DLL 劫持风险。 增强改进： - 调整活动关卡解析，以支持分组的支线故事，以及为关卡和小游戏提供活动时间元数据。 - 重构助战列表处理，改为使用以 `InstHelper` 为基础的辅助类，提供更清晰的日志记录，并将实际选中的助战干员名称返回给编队逻辑。 - 改进战斗编队中对缺失干员和注入助战单位的处理，通过跟踪是哪个分组被填充，避免对未选择的干员错误标记为缺失。 - 现代化 MaaService 中 MaaCore 的原生互操作绑定，改用源生成的 `LibraryImport` 和显式封送属性。 - 为 `LocalizationHelper` 添加查找辅助方法，以安全检查键是否存在，并在获取字符串失败时不抛出异常。 - 以更安全的顺序初始化依赖的单例对象，确保 `StageManager` 在依赖它的视图模型之前可用。 - 将助战列表内容仅记录到日志中，而不再通过额外的回调负载对外发送。 - 在夜间 OTA 工作流的 WPF 发布步骤中加入与架构相关的平台选择。 - 将小游戏列表刷新与本地日期/关卡更新联动，使 UI 能反映当前的活动配置。 构建： - 提升用于 macOS 签名与配置以及 GitHub Releases 的 GitHub Actions 版本，并更新 CMake 生成器/工具脚本和文档，以引用更新后的 Visual Studio 工具集。 持续集成（CI）： - 更新 CI 发布流程，在夜间 OTA 工作流中为 WPF GUI 构建传递平台相关的配置。 文档： - 刷新多语言开发文档，以引用更新后的 Visual Studio 版本和新的 CMake 生成器参数。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Update stage activity handling to consume the new StageActivityV2 format, expose rich mini-game metadata to the toolbox UI, and tighten reliability and security around support selection, clue sending, GPU detection, native interop, and DLL hijack prevention. New Features: - Parse rich mini-game entries from the new StageActivityV2.json format and bind them to the WPF toolbox for dynamic mini-game configuration. Bug Fixes: - Correct quick formation support-operator completion logic to track filled operator groups and avoid mislabeling unchecked operators as missing. - Increase retry count when sending infrastructure clues to improve reliability. - Ensure the changelog window is activated when already open instead of creating a new window. - Fix Windows configuration manager GPU queries to use spans and pooled buffers correctly, avoiding buffer misuse and leaks. - Extend startup DLL whitelist to reduce DLL hijack risk in the WPF GUI. Enhancements: - Adjust activity-stage parsing to support grouped side stories and activity time metadata for stages and mini-games. - Refactor support list handling to use an InstHelper-backed helper with clearer logging and to return actual chosen support operator names to formation logic. - Improve battle formation handling of missing operators and injected support units by tracking which group was filled and avoiding incorrect missing flags for unselected operators. - Modernize MaaCore native interop bindings in MaaService to use source-generated LibraryImport and explicit marshalling attributes. - Add lookup helpers to LocalizationHelper for safe key existence checks and non-throwing string retrieval. - Initialize dependent singletons in a safer order so StageManager is available before view models that depend on it. - Log support list contents only to the logger instead of emitting extra callback payloads. - Include architecture-specific platform selection in WPF publish steps of the nightly OTA workflow. - Wire mini-game list refresh into local date/stage updates so UI reflects current activity configuration. Build: - Bump GitHub Actions versions for macOS signing and provisioning and for GitHub Releases, and update CMake generator/tooling scripts and docs to reference the newer Visual Studio toolset. CI: - Update CI publishing to pass platform-specific configuration for WPF GUI builds in nightly OTA workflow. Documentation: - Refresh multi-language development docs to reference the newer Visual Studio version and updated CMake generator arguments. </details> 新功能： - 暴露从新的 `StageActivityV2.json` 格式中解析出的丰富小游戏条目，并将其绑定到 WPF 工具箱中，以支持动态配置小游戏。 漏洞修复： - 修复快速编队补充助战干员时的逻辑，确保正确追踪已填充的干员分组，并防止未勾选的干员被错误标记为“缺失”。 - 通过增加重试次数，提高基建线索接收与发送的可靠性。 - 当变更日志窗口已打开时，确保正确激活该窗口，而不是新开一个窗口。 - 在通过 Windows 配置管理器 API 查询 GPU 相关设备属性时，避免缓冲区误用和内存泄漏。 - 通过扩展启动时检查的 DLL 列表，防止 DLL 劫持问题。 <details> <summary>Original summary in English</summary> ## 由 Sourcery 生成的摘要 更新关卡活动处理逻辑以消费新的 StageActivityV2 格式，将丰富的小游戏元数据暴露给工具箱 UI，并在助战选择、线索发送、GPU 检测、原生互操作以及 DLL 劫持防护方面增强可靠性和安全性。 新功能： - 从新的 `StageActivityV2.json` 格式中解析丰富的小游戏条目，并将其绑定到 WPF 工具箱，以实现小游戏的动态配置。 缺陷修复： - 修正快速编队助战干员完成逻辑，用于跟踪已填充的干员分组，避免将未勾选的干员误标记为缺失。 - 提高基础设施线索发送时的重试次数，以提升可靠性。 - 确保变更日志窗口在已打开时被激活，而不是新建一个窗口。 - 修复 Windows 配置管理器 GPU 查询逻辑，使其正确使用 span 和缓冲池，避免缓冲区误用和泄漏。 - 扩展启动 DLL 白名单，以降低 WPF GUI 中的 DLL 劫持风险。 增强改进： - 调整活动关卡解析，以支持分组的支线故事，以及为关卡和小游戏提供活动时间元数据。 - 重构助战列表处理，改为使用以 `InstHelper` 为基础的辅助类，提供更清晰的日志记录，并将实际选中的助战干员名称返回给编队逻辑。 - 改进战斗编队中对缺失干员和注入助战单位的处理，通过跟踪是哪个分组被填充，避免对未选择的干员错误标记为缺失。 - 现代化 MaaService 中 MaaCore 的原生互操作绑定，改用源生成的 `LibraryImport` 和显式封送属性。 - 为 `LocalizationHelper` 添加查找辅助方法，以安全检查键是否存在，并在获取字符串失败时不抛出异常。 - 以更安全的顺序初始化依赖的单例对象，确保 `StageManager` 在依赖它的视图模型之前可用。 - 将助战列表内容仅记录到日志中，而不再通过额外的回调负载对外发送。 - 在夜间 OTA 工作流的 WPF 发布步骤中加入与架构相关的平台选择。 - 将小游戏列表刷新与本地日期/关卡更新联动，使 UI 能反映当前的活动配置。 构建： - 提升用于 macOS 签名与配置以及 GitHub Releases 的 GitHub Actions 版本，并更新 CMake 生成器/工具脚本和文档，以引用更新后的 Visual Studio 工具集。 持续集成（CI）： - 更新 CI 发布流程，在夜间 OTA 工作流中为 WPF GUI 构建传递平台相关的配置。 文档： - 刷新多语言开发文档，以引用更新后的 Visual Studio 版本和新的 CMake 生成器参数。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Update stage activity handling to consume the new StageActivityV2 format, expose rich mini-game metadata to the toolbox UI, and tighten reliability and security around support selection, clue sending, GPU detection, native interop, and DLL hijack prevention. New Features: - Parse rich mini-game entries from the new StageActivityV2.json format and bind them to the WPF toolbox for dynamic mini-game configuration. Bug Fixes: - Correct quick formation support-operator completion logic to track filled operator groups and avoid mislabeling unchecked operators as missing. - Increase retry count when sending infrastructure clues to improve reliability. - Ensure the changelog window is activated when already open instead of creating a new window. - Fix Windows configuration manager GPU queries to use spans and pooled buffers correctly, avoiding buffer misuse and leaks. - Extend startup DLL whitelist to reduce DLL hijack risk in the WPF GUI. Enhancements: - Adjust activity-stage parsing to support grouped side stories and activity time metadata for stages and mini-games. - Refactor support list handling to use an InstHelper-backed helper with clearer logging and to return actual chosen support operator names to formation logic. - Improve battle formation handling of missing operators and injected support units by tracking which group was filled and avoiding incorrect missing flags for unselected operators. - Modernize MaaCore native interop bindings in MaaService to use source-generated LibraryImport and explicit marshalling attributes. - Add lookup helpers to LocalizationHelper for safe key existence checks and non-throwing string retrieval. - Initialize dependent singletons in a safer order so StageManager is available before view models that depend on it. - Log support list contents only to the logger instead of emitting extra callback payloads. - Include architecture-specific platform selection in WPF publish steps of the nightly OTA workflow. - Wire mini-game list refresh into local date/stage updates so UI reflects current activity configuration. Build: - Bump GitHub Actions versions for macOS signing and provisioning and for GitHub Releases, and update CMake generator/tooling scripts and docs to reference the newer Visual Studio toolset. CI: - Update CI publishing to pass platform-specific configuration for WPF GUI builds in nightly OTA workflow. Documentation: - Refresh multi-language development docs to reference the newer Visual Studio version and updated CMake generator arguments. </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 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！