mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-18 18:20:39 +08:00
62c407c81d
## Summary by Sourcery 优化自定义基建排程、肉鸽源石锭处理以及若干游戏内任务行为，并更新相关工具链、本地化以及 CI / pre-commit 配置。 New Features: - 引入强类型的 `CustomInfrastConfig` 模型和新的选择机制，以支持基于时间和基于索引的自定义基建方案，并支持序列化到辅助任务中。 - 新增 YoStarJP SecretFront 任务配置，并在叠加层中支持 SSS Copilot 任务链日志记录。 Bug Fixes: - 修复自定义基建方案解析与选择逻辑，包括更安全的配置默认值、更好地处理缺失的时段，以及在文件无效或方案不完整时提供更健壮的日志。 - 确保 Secret Front 关卡名称 OCR 使用可配置的 ROI，并通过重试机制让战斗编队中的支援干员入场更加稳健。 - 改进当游戏窗口移动时叠加层窗口的行为，并限制叠加层最大宽度以获得更好的布局效果。 - 将被跳过的肉鸽源石锭拾取/兑换流程视为非致命问题并细化日志记录，避免不必要的任务失败。 - 防止在更新检查运行过程中退出应用，并调整基建附加检查逻辑以适配新的自定义方案列表模型。 Enhancements: - 现代化基建设置中的配置访问方式，并将自定义方案刷新逻辑简化为单一的解析/刷新流程。 - 优化基于时间的自定义方案显示刷新，以及自动在运行后切换方案与相关日志记录。 - 收紧 `TaskData` 的 loading-justreturn 检查，以覆盖更多加载类任务类型。 - 对各类实用脚本和测试应用多处 Python 及工具链格式清理。 - 调整 GitHub Actions 工作流，使用 Prek 来执行定时的 pre-commit 运行，并改进针对 PR 与直接推送的 PNG 优化逻辑，同时更新 devcontainer 中的 Python 工具链以使用 Ruff 替代 Black/Isort。 Build: - 将 pre-commit 钩子更新到较新版本，用 Ruff 替换 Black/Isort 进行 Python 格式化，并微调优化模板工具的输出格式。 CI: - 用 Prek GitHub Action 替代自定义的基于 Python 的定时 pre-commit 任务，并优化 optimize-templates 工作流逻辑，以更好地区分直接推送与 PR 合并。 Documentation: - 修复日文入门手册中轻微的表格格式与对齐问题。 Tests: - 整理 AutoLocalization XAML 解析器测试，不改变其现有行为。 Chores: - 添加或调整多处任务/资源 JSON 与 XAML 本地化文件，并更新 CLI 与视图 XAML，使其与新的行为和资源保持一致。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Refine custom infrastructure scheduling, roguelike copper handling, and several gameplay task behaviors while updating tooling, localization, and CI/pre-commit setup. New Features: - Introduce a strongly typed CustomInfrastConfig model and new selection mechanism to support time-based and index-based custom infrastructure plans, including serialization to assistant tasks. - Add a YoStarJP SecretFront task configuration and support SSS Copilot task chain logging in the overlay. Bug Fixes: - Fix custom infrastructure plan parsing and selection, including safer configuration defaults, better handling of missing periods, and more robust logging when files are invalid or plans are incomplete. - Ensure Secret Front stage name OCR uses a configurable ROI and make battle formation support-unit entry more resilient with retries. - Improve overlay window behavior when the game window moves and clamp overlay width to a maximum for better layout. - Treat skipped roguelike copper pickup/exchange flows as non-fatal and refine logging, preventing unnecessary task failures. - Prevent exiting the app while an update check is running and adjust infrast append checks to reflect the new custom plan list model. Enhancements: - Modernize config access patterns in infrastructure settings and simplify custom plan refresh logic into a single parsing/refresh flow. - Refine time-based custom plan display refresh and automatic post-run plan switching and logging. - Tighten TaskData loading-justreturn checks for additional loading task types. - Apply assorted Python and tooling formatting cleanups across utility scripts and tests. - Adjust GitHub Actions workflows to use Prek for scheduled pre-commit runs and improve PNG optimization logic for PR vs direct pushes, while updating devcontainer Python tooling to use Ruff instead of Black/Isort. Build: - Update pre-commit hooks to newer versions, replace Black/Isort with Ruff for Python formatting, and tweak optimization template tooling output formatting. CI: - Replace the custom Python-based pre-commit scheduled job with the Prek GitHub Action and refine the optimize-templates workflow logic for detecting direct pushes vs PR merges. Documentation: - Fix minor table formatting and alignment issues in the Japanese introduction manual. Tests: - Tidy AutoLocalization XAML parser tests without changing behavior. Chores: - Add or adjust various task/resource JSON and XAML localization files, plus CLI and view XAML tweaks, to align with the new behaviors and resources. </details> <details> <summary>Original summary in English</summary> ## Summary by Sourcery 优化自定义基建排程、肉鸽源石锭处理以及若干游戏内任务行为，并更新相关工具链、本地化以及 CI / pre-commit 配置。 New Features: - 引入强类型的 `CustomInfrastConfig` 模型和新的选择机制，以支持基于时间和基于索引的自定义基建方案，并支持序列化到辅助任务中。 - 新增 YoStarJP SecretFront 任务配置，并在叠加层中支持 SSS Copilot 任务链日志记录。 Bug Fixes: - 修复自定义基建方案解析与选择逻辑，包括更安全的配置默认值、更好地处理缺失的时段，以及在文件无效或方案不完整时提供更健壮的日志。 - 确保 Secret Front 关卡名称 OCR 使用可配置的 ROI，并通过重试机制让战斗编队中的支援干员入场更加稳健。 - 改进当游戏窗口移动时叠加层窗口的行为，并限制叠加层最大宽度以获得更好的布局效果。 - 将被跳过的肉鸽源石锭拾取/兑换流程视为非致命问题并细化日志记录，避免不必要的任务失败。 - 防止在更新检查运行过程中退出应用，并调整基建附加检查逻辑以适配新的自定义方案列表模型。 Enhancements: - 现代化基建设置中的配置访问方式，并将自定义方案刷新逻辑简化为单一的解析/刷新流程。 - 优化基于时间的自定义方案显示刷新，以及自动在运行后切换方案与相关日志记录。 - 收紧 `TaskData` 的 loading-justreturn 检查，以覆盖更多加载类任务类型。 - 对各类实用脚本和测试应用多处 Python 及工具链格式清理。 - 调整 GitHub Actions 工作流，使用 Prek 来执行定时的 pre-commit 运行，并改进针对 PR 与直接推送的 PNG 优化逻辑，同时更新 devcontainer 中的 Python 工具链以使用 Ruff 替代 Black/Isort。 Build: - 将 pre-commit 钩子更新到较新版本，用 Ruff 替换 Black/Isort 进行 Python 格式化，并微调优化模板工具的输出格式。 CI: - 用 Prek GitHub Action 替代自定义的基于 Python 的定时 pre-commit 任务，并优化 optimize-templates 工作流逻辑，以更好地区分直接推送与 PR 合并。 Documentation: - 修复日文入门手册中轻微的表格格式与对齐问题。 Tests: - 整理 AutoLocalization XAML 解析器测试，不改变其现有行为。 Chores: - 添加或调整多处任务/资源 JSON 与 XAML 本地化文件，并更新 CLI 与视图 XAML，使其与新的行为和资源保持一致。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Refine custom infrastructure scheduling, roguelike copper handling, and several gameplay task behaviors while updating tooling, localization, and CI/pre-commit setup. New Features: - Introduce a strongly typed CustomInfrastConfig model and new selection mechanism to support time-based and index-based custom infrastructure plans, including serialization to assistant tasks. - Add a YoStarJP SecretFront task configuration and support SSS Copilot task chain logging in the overlay. Bug Fixes: - Fix custom infrastructure plan parsing and selection, including safer configuration defaults, better handling of missing periods, and more robust logging when files are invalid or plans are incomplete. - Ensure Secret Front stage name OCR uses a configurable ROI and make battle formation support-unit entry more resilient with retries. - Improve overlay window behavior when the game window moves and clamp overlay width to a maximum for better layout. - Treat skipped roguelike copper pickup/exchange flows as non-fatal and refine logging, preventing unnecessary task failures. - Prevent exiting the app while an update check is running and adjust infrast append checks to reflect the new custom plan list model. Enhancements: - Modernize config access patterns in infrastructure settings and simplify custom plan refresh logic into a single parsing/refresh flow. - Refine time-based custom plan display refresh and automatic post-run plan switching and logging. - Tighten TaskData loading-justreturn checks for additional loading task types. - Apply assorted Python and tooling formatting cleanups across utility scripts and tests. - Adjust GitHub Actions workflows to use Prek for scheduled pre-commit runs and improve PNG optimization logic for PR vs direct pushes, while updating devcontainer Python tooling to use Ruff instead of Black/Isort. Build: - Update pre-commit hooks to newer versions, replace Black/Isort with Ruff for Python formatting, and tweak optimization template tooling output formatting. CI: - Replace the custom Python-based pre-commit scheduled job with the Prek GitHub Action and refine the optimize-templates workflow logic for detecting direct pushes vs PR merges. Documentation: - Fix minor table formatting and alignment issues in the Japanese introduction manual. Tests: - Tidy AutoLocalization XAML parser tests without changing behavior. Chores: - Add or adjust various task/resource JSON and XAML localization files, plus CLI and view XAML tweaks, to align with the new behaviors and resources. </details> </details> <details> <summary>Original summary in English</summary> ## Summary by Sourcery 优化自定义基建排程、肉鸽源石锭处理以及若干游戏内任务行为，并更新相关工具链、本地化以及 CI / pre-commit 配置。 New Features: - 引入强类型的 `CustomInfrastConfig` 模型和新的选择机制，以支持基于时间和基于索引的自定义基建方案，并支持序列化到辅助任务中。 - 新增 YoStarJP SecretFront 任务配置，并在叠加层中支持 SSS Copilot 任务链日志记录。 Bug Fixes: - 修复自定义基建方案解析与选择逻辑，包括更安全的配置默认值、更好地处理缺失的时段，以及在文件无效或方案不完整时提供更健壮的日志。 - 确保 Secret Front 关卡名称 OCR 使用可配置的 ROI，并通过重试机制让战斗编队中的支援干员入场更加稳健。 - 改进当游戏窗口移动时叠加层窗口的行为，并限制叠加层最大宽度以获得更好的布局效果。 - 将被跳过的肉鸽源石锭拾取/兑换流程视为非致命问题并细化日志记录，避免不必要的任务失败。 - 防止在更新检查运行过程中退出应用，并调整基建附加检查逻辑以适配新的自定义方案列表模型。 Enhancements: - 现代化基建设置中的配置访问方式，并将自定义方案刷新逻辑简化为单一的解析/刷新流程。 - 优化基于时间的自定义方案显示刷新，以及自动在运行后切换方案与相关日志记录。 - 收紧 `TaskData` 的 loading-justreturn 检查，以覆盖更多加载类任务类型。 - 对各类实用脚本和测试应用多处 Python 及工具链格式清理。 - 调整 GitHub Actions 工作流，使用 Prek 来执行定时的 pre-commit 运行，并改进针对 PR 与直接推送的 PNG 优化逻辑，同时更新 devcontainer 中的 Python 工具链以使用 Ruff 替代 Black/Isort。 Build: - 将 pre-commit 钩子更新到较新版本，用 Ruff 替换 Black/Isort 进行 Python 格式化，并微调优化模板工具的输出格式。 CI: - 用 Prek GitHub Action 替代自定义的基于 Python 的定时 pre-commit 任务，并优化 optimize-templates 工作流逻辑，以更好地区分直接推送与 PR 合并。 Documentation: - 修复日文入门手册中轻微的表格格式与对齐问题。 Tests: - 整理 AutoLocalization XAML 解析器测试，不改变其现有行为。 Chores: - 添加或调整多处任务/资源 JSON 与 XAML 本地化文件，并更新 CLI 与视图 XAML，使其与新的行为和资源保持一致。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Refine custom infrastructure scheduling, roguelike copper handling, and several gameplay task behaviors while updating tooling, localization, and CI/pre-commit setup. New Features: - Introduce a strongly typed CustomInfrastConfig model and new selection mechanism to support time-based and index-based custom infrastructure plans, including serialization to assistant tasks. - Add a YoStarJP SecretFront task configuration and support SSS Copilot task chain logging in the overlay. Bug Fixes: - Fix custom infrastructure plan parsing and selection, including safer configuration defaults, better handling of missing periods, and more robust logging when files are invalid or plans are incomplete. - Ensure Secret Front stage name OCR uses a configurable ROI and make battle formation support-unit entry more resilient with retries. - Improve overlay window behavior when the game window moves and clamp overlay width to a maximum for better layout. - Treat skipped roguelike copper pickup/exchange flows as non-fatal and refine logging, preventing unnecessary task failures. - Prevent exiting the app while an update check is running and adjust infrast append checks to reflect the new custom plan list model. Enhancements: - Modernize config access patterns in infrastructure settings and simplify custom plan refresh logic into a single parsing/refresh flow. - Refine time-based custom plan display refresh and automatic post-run plan switching and logging. - Tighten TaskData loading-justreturn checks for additional loading task types. - Apply assorted Python and tooling formatting cleanups across utility scripts and tests. - Adjust GitHub Actions workflows to use Prek for scheduled pre-commit runs and improve PNG optimization logic for PR vs direct pushes, while updating devcontainer Python tooling to use Ruff instead of Black/Isort. Build: - Update pre-commit hooks to newer versions, replace Black/Isort with Ruff for Python formatting, and tweak optimization template tooling output formatting. CI: - Replace the custom Python-based pre-commit scheduled job with the Prek GitHub Action and refine the optimize-templates workflow logic for detecting direct pushes vs PR merges. Documentation: - Fix minor table formatting and alignment issues in the Japanese introduction manual. Tests: - Tidy AutoLocalization XAML parser tests without changing behavior. Chores: - Add or adjust various task/resource JSON and XAML localization files, plus CLI and view XAML tweaks, to align with the new behaviors and resources. </details> <details> <summary>Original summary in English</summary> ## Summary by Sourcery 优化自定义基建排程、肉鸽源石锭处理以及若干游戏内任务行为，并更新相关工具链、本地化以及 CI / pre-commit 配置。 New Features: - 引入强类型的 `CustomInfrastConfig` 模型和新的选择机制，以支持基于时间和基于索引的自定义基建方案，并支持序列化到辅助任务中。 - 新增 YoStarJP SecretFront 任务配置，并在叠加层中支持 SSS Copilot 任务链日志记录。 Bug Fixes: - 修复自定义基建方案解析与选择逻辑，包括更安全的配置默认值、更好地处理缺失的时段，以及在文件无效或方案不完整时提供更健壮的日志。 - 确保 Secret Front 关卡名称 OCR 使用可配置的 ROI，并通过重试机制让战斗编队中的支援干员入场更加稳健。 - 改进当游戏窗口移动时叠加层窗口的行为，并限制叠加层最大宽度以获得更好的布局效果。 - 将被跳过的肉鸽源石锭拾取/兑换流程视为非致命问题并细化日志记录，避免不必要的任务失败。 - 防止在更新检查运行过程中退出应用，并调整基建附加检查逻辑以适配新的自定义方案列表模型。 Enhancements: - 现代化基建设置中的配置访问方式，并将自定义方案刷新逻辑简化为单一的解析/刷新流程。 - 优化基于时间的自定义方案显示刷新，以及自动在运行后切换方案与相关日志记录。 - 收紧 `TaskData` 的 loading-justreturn 检查，以覆盖更多加载类任务类型。 - 对各类实用脚本和测试应用多处 Python 及工具链格式清理。 - 调整 GitHub Actions 工作流，使用 Prek 来执行定时的 pre-commit 运行，并改进针对 PR 与直接推送的 PNG 优化逻辑，同时更新 devcontainer 中的 Python 工具链以使用 Ruff 替代 Black/Isort。 Build: - 将 pre-commit 钩子更新到较新版本，用 Ruff 替换 Black/Isort 进行 Python 格式化，并微调优化模板工具的输出格式。 CI: - 用 Prek GitHub Action 替代自定义的基于 Python 的定时 pre-commit 任务，并优化 optimize-templates 工作流逻辑，以更好地区分直接推送与 PR 合并。 Documentation: - 修复日文入门手册中轻微的表格格式与对齐问题。 Tests: - 整理 AutoLocalization XAML 解析器测试，不改变其现有行为。 Chores: - 添加或调整多处任务/资源 JSON 与 XAML 本地化文件，并更新 CLI 与视图 XAML，使其与新的行为和资源保持一致。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Refine custom infrastructure scheduling, roguelike copper handling, and several gameplay task behaviors while updating tooling, localization, and CI/pre-commit setup. New Features: - Introduce a strongly typed CustomInfrastConfig model and new selection mechanism to support time-based and index-based custom infrastructure plans, including serialization to assistant tasks. - Add a YoStarJP SecretFront task configuration and support SSS Copilot task chain logging in the overlay. Bug Fixes: - Fix custom infrastructure plan parsing and selection, including safer configuration defaults, better handling of missing periods, and more robust logging when files are invalid or plans are incomplete. - Ensure Secret Front stage name OCR uses a configurable ROI and make battle formation support-unit entry more resilient with retries. - Improve overlay window behavior when the game window moves and clamp overlay width to a maximum for better layout. - Treat skipped roguelike copper pickup/exchange flows as non-fatal and refine logging, preventing unnecessary task failures. - Prevent exiting the app while an update check is running and adjust infrast append checks to reflect the new custom plan list model. Enhancements: - Modernize config access patterns in infrastructure settings and simplify custom plan refresh logic into a single parsing/refresh flow. - Refine time-based custom plan display refresh and automatic post-run plan switching and logging. - Tighten TaskData loading-justreturn checks for additional loading task types. - Apply assorted Python and tooling formatting cleanups across utility scripts and tests. - Adjust GitHub Actions workflows to use Prek for scheduled pre-commit runs and improve PNG optimization logic for PR vs direct pushes, while updating devcontainer Python tooling to use Ruff instead of Black/Isort. Build: - Update pre-commit hooks to newer versions, replace Black/Isort with Ruff for Python formatting, and tweak optimization template tooling output formatting. CI: - Replace the custom Python-based pre-commit scheduled job with the Prek GitHub Action and refine the optimize-templates workflow logic for detecting direct pushes vs PR merges. Documentation: - Fix minor table formatting and alignment issues in the Japanese introduction manual. Tests: - Tidy AutoLocalization XAML parser tests without changing behavior. Chores: - Add or adjust various task/resource JSON and XAML localization files, plus CLI and view XAML tweaks, to align with the new behaviors and resources. </details> </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 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！