mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-20 02:55:38 +08:00
9e43b9c603
 ## Summary by Sourcery 发布 v6.2.0，带来重新设计的日志侧边栏、扩展的自动战斗与基建管理选项、新成就系统，以及多项稳定性与用户体验改进。 新功能： - 新增成就 DLC 系统，覆盖更多游戏玩法场景。 - 增强打手（copilot）任务选择功能，支持多级路径、相对目录以及本地任务折叠。 - 在基建管理中新增情报交换与情报发送的独立开关。 - 为冬灵寒脊主题新增基建配置，并调整相关干员选择逻辑。 - 新增 Gotify 通知渠道，并为 Bark 通知设置默认分类。 - 重新设计主页日志侧边栏，提供可切换的视觉样式、缩略图以及改进后的布局。 - 在今日开放关卡提示中显示仓库剩余数量，并将库存更新提示移至工具提示中。 - 限制基于 CPU 的推理线程使用，以优先保障模拟器性能。 - 当从临时路径运行时阻止应用启动，并保护非空的企鹅物流 ID 不被覆盖。 - 新增 Roguelike 主题推荐提示，支持多语言，并为新侧故事加入导航。 - 在 macOS 上禁用基于 CoreML 的检测与识别。 问题修复： - 修复由于 2026-01-09 游戏更新及 Roguelike 暂停按钮位置调整导致的打手（copilot）运行失败问题。 - 解决打手任务清理异常，以及通过输入框特殊代码启动关卡时的相关问题。 - 修正情报数量识别，以及在情报已在展示板上时的一键放置逻辑。 - 提升对“隐秘战线”（Hidden Crimes）事件与结局的识别，包括对多余字符的处理。 - 防止在同时启用剿灭与备选关卡选项时企鹅物流报表 ID 被修改。 - 解决基建效率计算中的 out_of_range 错误以及远程控制截图残留问题。 - 修复文档站搜索、不同语言环境下掉落数量识别错误，以及多处命名和措辞问题。 - 修复调试图像路径、过长文件名以及 waydroid 截图行为相关问题。 - 更新若干素材与样式警告，包括 DormMini.png 以及 SA1518/SA1633 分析器警告。 优化增强： - 优化打手（copilot）标签结构，包括将悖论模拟关卡单独分组。 - 当指定的刷理智次数与理智加成倍数设置冲突时给出警告。 - 改进情报交换、好友情报领取以及一键赠送情报的逻辑，减少误操作。 - 打磨 UI 布局、换行、工具提示以及缩略图行为与展示时机。 - 重构并简化属性依赖辅助工具为静态工具类，并使文件命名与目录结构保持一致。 - 将开发容器从 conda 迁移到基于 mise/uv 的环境，并在适当位置将 DPS 更名为 OPS。 文档： - 为 `maa-cli` 添加一键脚本安装说明，并更新韩文文档与 VS Code 扩展使用指南。 - 统一中文整合文档的格式，并刷新源码链接以对应最新行号。 - 在战斗协议文档中补充摄像头移动相关说明。 日常维护： - 调整文件夹检测逻辑、注释、默认日志缩略图数量限制以及公告按钮的位置。 - 移除冗余关卡，迁移 API 变更，并补充调试阶段的 GPU 使用说明。 - 更新多地区的 OCR 配置与应用内英文提示文案。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Release v6.2.0 with a redesigned log sidebar, expanded automation and base management options, new achievements, and multiple stability and UX improvements. New Features: - Add an achievement DLC system covering additional gameplay scenarios. - Enhance copilot task selection with multi-level paths, relative directories, and local task collapsing. - Introduce independent toggles for clue exchange and sending clues in Base management. - Add new Base configurations for the Winterwisp set and adjust related operator selection logic. - Add Gotify as a new notification channel and set a default category for Bark notifications. - Redesign the home log sidebar with switchable visual styles, thumbnails, and improved layout. - Display depot quantities in today’s open stages hints and move inventory update prompts to tooltips. - Limit CPU-based inference thread usage to prioritize emulator performance. - Block application startup when running from a temporary path and protect non-empty Penguin Logistics IDs from being overwritten. - Add new roguelike theme recommendation tips with multi-language support and navigation for the new side story. - Disable CoreML-based detection and recognition on macOS. Bug Fixes: - Fix copilot failures caused by the 2026-01-09 game update and updated roguelike pause button position. - Resolve issues with copilot job clearing and starting runs via special codes from the input box. - Correct clue count recognition and one-click clue placement when clues are already on the board. - Improve recognition for Hidden Crimes events and endings, including handling of extra characters. - Prevent changes to Penguin Logistics report IDs when Annihilation and backup stage options are both enabled. - Address out_of_range errors in Base efficiency calculations and stale screenshots in remote control capture. - Fix documentation site search, locale-specific drop count misreads, and various naming and wording issues. - Resolve issues with debug image paths, overly long filenames, and waydroid screencap behavior. - Update assorted assets and style warnings, including DormMini.png and SA1518/SA1633 analyzer warnings. Enhancements: - Refine copilot tab structure, including separating paradox simulation stages. - Warn when specified sanity-farming run counts conflict with sanity multiplier settings. - Improve logic for clue exchange, friend clue retrieval, and one-click clue sending to reduce mis-operations. - Polish UI layouts, wrapping, tooltips, and thumbnail behavior and timing. - Refactor and simplify property dependency helpers into a static utility and align file naming with structure. - Migrate the development container from conda to a mise/uv-based setup and rename DPS to OPS where appropriate. Documentation: - Document one-click maa-cli installation via scripts and update KR docs and VS Code extension guides. - Align Chinese integrated documentation formatting and refresh source links to current line numbers. - Expand battle protocol docs with camera movement instructions. Chores: - Tweak folder detection logic, comments, default log thumbnail limits, and announcement button placement. - Remove redundant stages, port API changes, and add debug-time GPU usage notes. - Update multiple region-specific OCR configurations and English strings for in-app messages. </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 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！