mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-20 10:57:45 +08:00
58e3d06b27
## 由 Sourcery 总结 改进运行时语言切换、跨实例属性依赖处理和 OCR 可靠性，同时优化任务队列 UI 行为以及多处彩蛋流程。 新功能： - 支持在多个 ViewModel 间进行跨实例和基于属性的依赖绑定，包括针对语言变化的全局刷新钩子。 - 引入可复用的 `LocalizedObservableList` 帮助类，用于集中管理本地化的选项列表，并在语言改变时自动刷新。 - 新增统一的非阻塞 `EasterEggDialog` 视图和辅助 API，用于在设置页和助理流程中展示脚本化对话框。 - 通过 `LocalizationHelper` 暴露运行时语言重载能力，提供 `LanguageChanged` 事件和 `CurrentCulture`，实现无需重启应用的热语言切换。 - 增强 `OcrPackNcnn` 中的 OCR 行为，以兼容 fastdeploy 的检测与识别流程以及空检测场景；在未检测到任何框时，将整张图片视作一行处理。 - 新增 GPU 选项视图模型封装（`GpuOptionItem`），以支持本地化的 GPU 选择并保持稳定的 `ComboBox` 绑定行为。 - 扩展成就系统，增加发布阶段元数据，包括本地化的工具提示和基于阶段的 UI 提示。 错误修复： - 通过将 `LanguageChanged` 接入设置、任务队列、工具箱、计时器、关卡和多个设置面板，修复多处与语言相关的陈旧文本问题。 - 在临时 ViewModel 被释放时跟踪并清理跨实例属性依赖，防止内存泄漏和“僵尸”通知。 - 将 DWM 组合被禁用和拖放过程中的 COM 异常视为非致命错误，避免不必要的应用退出，同时仍然弹出错误对话框。 - 调整预处理、候选过滤和多边形评分，使其与 fastdeploy 行为一致，修复小 ROI 场景下的 OCR 误检问题，包括丢弃过于细长的检测框。 - 确保本地化的条目名称和关卡工具提示在语言更改时能够正确回退与重新加载。 - 修正肉鸽难度选择校验逻辑，并在主题特定限制变化时正确更新当前显示的难度。 - 改进对永久关卡阻塞后续关卡的处理，在配置会导致静默跳过后续关卡时对用户进行警告。 - 通过将显示文本与底层 `GpuOption` 值解耦，修复语言切换时的 GPU 选择与 `ComboBox` 刷新问题。 增强优化： - 重构本地化处理逻辑，让更多设置与任务相关的 ViewModel 订阅集中式的 `LanguageChanged` 事件，并就地刷新缓存的显示字符串，而非依赖重启。 - 优化 Pallas 语言“醉酒/宿醉”彩蛋流程，避免强制重启，使用内部语言切换辅助工具，并在启动与退出时展示非阻塞对话框。 - 将多种对话框控件（文本输入、定时文本以及新的 `EasterEggDialog`）统一到重命名后的视图类下，并更新在任务队列和其他界面中的使用方式。 - 改进 `StageManager` 和 `StageInfo`，同时存储本地化键和值，使关卡名称、提示和小游戏入口在语言变更时可动态刷新。 - 使多个设置列表（连接配置、客户端类型、无人机使用模式、基础设施模式、更新通道、肉鸽主题、收容模式、战斗序列/重置模式等）现代化，统一使用 `LocalizedObservableList`，以实现更简洁、可热插拔的本地化方案。 - 收紧计时器、协作作战、工具箱、托盘图标、后置动作以及根视图在语言变化和启动流程中的行为，包括自动刷新标题与工具提示。 - 添加结构化的成就阶段发布日期映射，以支持更具信息量的成就 UI。 - 对日志作用域和若干 UI 绑定做小规模重构，包括语言切换后的非阻塞关卡/日期刷新以及废弃配置键的清理。 杂务： - 更新多份游戏资源 JSON 文件（关卡、任务、物品索引、地块位置、版本清单），以适配最新内容与关卡布局，包括新的危机合约 v2 地块位置信息。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Improve runtime language switching, cross-instance property dependency handling, and OCR robustness, while refining task queue UI behaviors and various Easter egg flows. New Features: - Support cross-instance and attribute-based property dependencies across ViewModels, including global refresh hooks for language changes. - Introduce a reusable LocalizedObservableList helper to centralize localized option lists that automatically refresh on language change. - Add a unified non-blocking EasterEggDialog view and helper APIs for showing scripted dialogs from settings and assistant flows. - Expose runtime language reload via LocalizationHelper with a LanguageChanged event and CurrentCulture, enabling hot language switching without app restart. - Enhance OCR behavior in OcrPackNcnn to handle fastdeploy-compatible detection, recognition, and empty-detection cases, including treating the whole image as a line when no boxes are found. - Add GPU option view-model wrapper (GpuOptionItem) to support localized GPU selection with stable ComboBox binding behavior. - Extend achievements with release phase metadata including localized tooltips and phase-based UI hints. Bug Fixes: - Fix multiple language-related stale-text issues by wiring LanguageChanged into Settings, task queues, toolbox, timers, stages, and various settings panels. - Prevent memory leaks and zombie notifications by tracking and cleaning cross-instance property dependencies when transient ViewModels are disposed. - Handle DWM composition disabled and drag-drop COM exceptions as non-fatal, avoiding unnecessary application exits while still surfacing error dialogs. - Address OCR mis-detections on small ROIs by aligning preprocessing, candidate filtering, and polygon scoring with fastdeploy behavior, including dropping overly thin boxes. - Ensure localized item names and stage tooltips fall back gracefully and reload correctly when the language is changed. - Correct roguelike difficulty selection validation and update of the displayed difficulty when theme-specific limits change. - Improve handling of permanent stages blocking later entries by warning the user when configuration would silently skip subsequent stages. - Fix GPU selection and ComboBox refresh issues when language changes by decoupling display text from the underlying GpuOption value. Enhancements: - Rework localization handling so many settings and task-related ViewModels subscribe to a central LanguageChanged event and refresh cached display strings in-place instead of requiring restarts. - Refine Pallas language "drunk/hangover" easter egg flow to avoid forced restarts, use internal language switching helpers, and show non-blocking dialogs on start and exit. - Unify various dialog controls (text input, timed text, and new EasterEggDialog) under renamed view classes and updated usages in TaskQueue and other screens. - Improve StageManager and StageInfo to store localization keys alongside values, enabling dynamic refresh of stage names, tips, and mini-game entries on language change. - Modernize several settings lists (connection configs, client types, drones usage, infrast modes, update channels, roguelike themes, reclamation modes, fight series/reset modes, etc.) to use LocalizedObservableList for cleaner, hot-swappable localization. - Tighten timer, copilot, toolbox, notify icon, post-action, and root view behaviors around language changes and startup flows, including automatic title and tooltip refreshes. - Add structured release date mapping for achievement phases to support more informative achievement UI. - Minor refactors to logging scopes and miscellaneous UI bindings, including non-blocking stage/date updates after language changes and cleanup of obsolete configuration keys. Chores: - Update multiple game resource JSON files (stages, tasks, item indexes, tile positions, version manifests) for the latest content and stage layouts, including new crisis v2 tile position data. </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 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！