MaaAssistantArknights/MaaAssistantArknights v6.17.4

on GitHub

BlackFlow Roguelike

Added support for the BlackFlow (黑流树海) roguelike theme, with the level-farming, Originium Ingot investment, and cultivation strategies.

UI Transition Animations and Interaction Polish

Main tabs and task-chain switching now animate with directional transitions, and settings-page navigation scrolls smoothly; custom dropdown interactions are unified (click outside to close, repeated clicks keep open).

Reconnect Removed in Favor of Scheduled Startup

The reconnect-after-disconnect logic has been removed due to the complexity and maintenance cost of restoring the chain state; for overnight sessions, please switch to scheduled startup and forced scheduled startup instead.

Infrast Efficiency Algorithm Rewrite

The infrast efficiency algorithm has been rewritten; the default mode now supports cross-facility combinations, with new settings for cross-facility combinations and Fiammetta recovery targets, along with a batch of infrast operator selection and recognition fixes. Dormitory shifting now performs only Fiammetta pairing in the first round, with a new recovery toggle.

Switch Theme Task with Random Selection

A new "Switch Theme" task switches in-game themes by name; multiple candidate themes can be configured, with one randomly picked on each run.

修复 | Fix

• 沃日弱智 AI 把更换主题入口隐藏了 @ABA2396
• 修复如果第一次点击“探索冰原”没有生效只识别下一层和密文板界面，无法再次点击仍然显示的入口的问题 @Koileo

MaaMacGui

改进 | Improved

• MacSCK 线程同步优化 @hguandl

新增 | New

• 任务链新增 ｢更换主题｣ 任务，按游戏内主题名称自动切换主题，可填写多个主题每次运行随机选择一个，主题未解锁或未找到时给出对应提示 (#18099) @ABA2396 @HX3N @momomochi987 @Constrat
• 库存保持新增 ｢仅执行第一个库存不足的计划｣ 选项，第一个计划补满后下次运行自动继续后续计划 @ABA2396

改进 | Improved

• Swipe 的 specialParams[1] 额外滑动参数从 0/1 开关拓展为方向选择（0 不启用，1/2/3/4 分别为上/下/左/右）(#18099) @ABA2396
• Swipe 的 specialParams[2]/[3] 缓入、缓出斜率参数改为乘 10 输入（默认 10），正常缓入缓出建议 37/1，内置任务参数已同步迁移 (#18112) @status102
• 改进设置指引，连接设置步骤复用实际连接设置界面，修复选择 PC 端时界面残留 ADB 选项且缺少提示，任务设置步骤改为可交互任务演示 (#18047 #18130) @satgo1546 @ABA2396
• 设置指引最后一步停留 5 秒后才能点击完成，期间按钮下方显示倒计时 @ABA2396
• 优化黑流树海肉鸽，降低事件选项确认阈值，增加重开等待 (#18066 #18126) @ZiyinLin
• 调整基建默认设施顺序，宿舍移至换人设施之后，切换自定义基建后未调整顺序时不再先换宿舍，避免换下的干员送不进宿舍 @ABA2396
• 自动战斗干员缺失提示补充练度未达标情形，不再仅提示未拥有 (#18046) @status102
• 优化界面日志显示，库存保持与更新用户数据的任务链日志按计划序号或识别类型区分，日志分隔线标题过长时换行显示 @ABA2396
• KR shorten resource-repair dialog strings to fit the UI @HX3N

修复 | Fix

• 修复 MuMu 触控增强状态与实际触控模式不同步、残留旧值的问题，增强勾选框改为触控模式的投影，启动时归一截图增强关闭后残留的触控模式，连接成功时重置状态 @ABA2396
• 修复 MuMu 未使用触控增强时漏检模拟器应用保活的问题 (#18134) @Radekyspec
• 修复基建笑脸被多个模板同时命中导致同一干员被识别两次，宿舍选人时被点选两下而未被选中进驻的问题 (#18132) @Alan-Charred
• 修复繁中服自动编队不切换技能页 (#18118) @vonnoq
• 修复切换界面语言后定时设置的任务标签停留在旧语言的问题 @ABA2396
• 完善干员名识别替换 ｢埃癸斯｣ 的正则，覆盖更多形近误识并收紧为整词匹配，避免误替换其他干员名 @ABA2396
• YostarEN fix Sami (IS4) roguelike strategy selection and recognition (temperature OCR, roi, ocrReplace) (#18088) @Constrat
• YostarKR adjust ocrReplace for 掌灯与引烛 @HX3N

MaaMacGui

修复 | Fix

• 触控模式等实例选项在已有实例上重新应用，无需重启生效 (#110) @VinciJL

新增 | New

• 检测到资源文件损坏时，新增尝试下载完整包进行修复 @ABA2396

修复 | Fix

• 修复月行水上设定次数代理连战时，刚好在最后一轮结算后弹出的塔罗牌弹窗无人关闭、阻挡后续任务的问题；弹窗改为经 PreStartCheck 等待界面稳定后关闭 (#18071) @ABA2396
• 修复窗口初始化时点击最大化按钮闪退 (#12034) @ABA2396
• 恢复 YostarEN/JP/KR 与繁中服的仓库页签模板任务，修复仓库识别失败 @HX3N
• 修复繁中服仓库辨识，更新材料页签模板 (#18081) @vonnoq
• 修正干员名识别替换 埃类斯 -> 埃癸斯 @ABA2396

文档 | Docs

• 自动战斗与自动肉鸽的触控模式文档补充 MuMu 触控增强说明 (#18052) @youzibigg

新增 | New

• 新增 SideStory「月行水上」活动关卡导航，支持 SR-6~8 与搓玉关 SR-5 @Daydreamer114 @ABA2396

修复 | Fix

• 修复游戏新增 ｢特别纪念｣ 页签后仓库识别报错，更新仓库页签模板 @ABA2396
• 修复月行水上活动代理连战中，结算退出后概率弹出的塔罗牌弹窗遮挡界面导致任务停止的问题 @ABA2396
• 修复 PC 端（Win32）连接下滑动操作被判定为点击的问题：滑动插值步间补充等待，Seize 等异步输入方式下不再瞬移 @ABA2396
• 修复自动战斗指定编队选择第二、三队时有低概率触发编队改名 @ABA2396
• 修复自动战斗部分早期别传（SS）活动关卡代码匹配失败 @status102
• 修复黑流树海的一批识别问题：补充楼层识别正则、调整点击 ｢出发前往｣ 的识别范围 (#18023 #18037) @ZiyinLin
• 修复 MuMu/雷电连接与系统通知的提示文案中转义符显示异常 @ABA2396
• 修复界面文案中含 . 或 @ 的 {key=} 引用未被替换的问题 @ABA2396

改进 | Improved

• 补齐一批设置项与界面的提示说明，修正歧义命名（｢烧水使用分队｣ 改为 ｢刷开局使用分队｣ 等） @ABA2396
• 统一界面提示宽度，默认上限改为 500 @ABA2396

文档 | Docs

• 对照代码全面修正文档 (#18030) @ABA2396
• 各语言文档补充 RIIC.Autos 链接 (#18022) @BrKDDD

新增 | New

• 新增适配黑流树海肉鸽，支持 ｢刷等级，快速飞三层｣ ｢刷源石锭，投资完成后自动退出｣ ｢刷襁褓动物｣ 三个策略 (#17380) @DavidWang19 @ZiyinLin @sakevel @status102 @walkerljy @ABA2396
• PC 端连接截图前自动规避光标与窗口遮挡：主界面识别前把光标移到窗口中心并等待视差动画，其他界面识别前移到不影响识别的位置；window-pos 鼠标输入方式下非主界面识别会把窗口移出屏幕并在断开时自动恢复（连接设置新增 ｢窗口恢复｣ 按钮），该输入方式下截图方式限定为 PrintWindow (#17776) @H2O-MERO @status102
• 模拟器分辨率变化时中断当前任务并提示，避免在变更后的分辨率下继续识别；重新开始任务即可应用新分辨率 @ABA2396
• 新增启动文件缺失检查，发现安装文件缺失时提示，并支持从更新源重新下载完整包自动修复 (#17725) @ABA2396
• 页签切换过渡动画与设置页导航平滑滚动：主界面页签、任务链、常规/高级设置等内容切换加入方向性过渡动画，设置页导航平滑滚动并跟随过渡动画档位 (#17799) @ABA2396
• 像素画自动填色新增粘贴功能，支持从剪贴板粘贴图片与 4 字以内的文本 (#17662 #17689) @H2O-MERO @ABA2396
• 掉线提示接入外部通知，日志与通知等级提高到 Err，启用外部通知 ｢错误时发送｣ 后推送 @ABA2396
• 自动战斗支持指定职业以区分同名干员，并兼容职业大小写 (#17544) @status102
• 自动战斗使用技能支持超时参数 (#17734) @status102
• 库存保持任务支持因理智不足跳过后续任务 (#17741) @ABA2396
• 战斗开始等待时间支持通过 config.json 的 battleStartTimeoutSeconds 配置（10~300 秒，默认 60 秒）(#17329) @wzacolemak @status102
• 关卡小提示中显示同名活动进行中的小游戏入口提示 @ABA2396
• CustomWebhook 预置模板新增企业微信（WeCom）与 ntfy 选项 (#17695) @H2O-MERO
• 奇象巡展发现未收录奇象时发送通知，并简化通知文案 (#17744) @LengmoAngel @ABA2396
• MaaCore 新增扩展 C 接口 AsstCallerExtra (#17701) @hguandl
• MaaFramework 扩展配置（interface.json）新增 Win32 连接方式 @Constrat
• 繁中服新增「辭歲行」活动关卡导航，并适配 SSS 10 ｢極寒安保派駐｣ (#17766) @momomochi987 @ABA2396
• 繁中服启用界园肉鸽 DLC 分队并适配相关参数与 OCR 对照 (#17705) @momomochi987

改进 | Improved

• 重写基建效率算法，常规（默认）模式支持跨设施组合，新增基建跨设施组合设置 (#17835) @status102 @Lancarus @ABA2396
• 基建常规模式宿舍换班流程调整：新增菲亚梅塔恢复开关（默认关闭），第一轮宿舍仅执行菲亚梅塔配对，配对失败时不再清空宿舍；低心情干员改于第二轮宿舍补位时安置 (#17980) @ABA2396
• 移除掉线重连逻辑，恢复链状态复杂且维护成本高；通宵挂机请改用定时启动与强制定时启动 (#17742) @ABA2396
• 🎉🎉🎉 PC 端鼠标输入新增完全无法使用的 SendMsg/PostMsg 全后台模式 🎉🎉🎉 @ABA2396
• PC 端 SendMessageWithCursorPos/PostMessageWithCursorPos 鼠标输入方式截图前后自动挪开并还原鼠标位置（截图期间会短暂阻塞鼠标输入）；高频截图任务下会明显卡顿，建议使用 SendMessageWithWindowPos @ABA2396
• 调整 PC 端连接的鼠标输入与截图方式默认值，界面警告补充推荐使用方式与热键设置建议 (#17839) @H2O-MERO
• 基建制造/贸易/发电站入口改用纯色数色识别 (#17951) @ABA2396
• 统一自定义下拉控件的开合交互（点外部关闭、连击保持），｢背景设置｣ ｢神秘代码｣ 的文件选择下拉迁移到新 TreeComboBox 控件，并修复弹层滚动导致设置页跳顶 (#17813) @ABA2396
• 可搜索 ComboBox 启用 UI 虚拟化，减轻肉鸽开局干员等大列表搜索时的卡顿 @ABA2396
• 界面硬编码文本改为资源化，并统一 Core 与 GUI 日志语言为英文 (#17984) @ABA2396
• 多作业模式下导航名改由 Core 自动从地图数据读取，并新增 nav_name_override 参数支持手动覆盖导航识别名 (#17687) @status102 @hguandl
• 自动战斗自动编队按干员组最低练度跳过浏览低等级干员，缩短编队耗时 (#17751) @status102
• PC 端游戏窗口标题按客户端类型解析，连接与结束模拟器支持不同语言的 PC 端，并优化 PC 端相关描述文案 (#17679) @HX3N @ABA2396
• 重构连接设置的 Extras 连接配置结构，PC 端（Win32）连接配置独立拆分 @status102
• 重构黑流肉鸽节点路线（routes）读取，配置解析错误时正确报错 (#17820) @status102
• 干员数据增加子职业解析，找不到干员与多稀有度干员跳过重复检查，召唤物职业解析临时兼容 @status102
• 查找干员在职业未知时回退到按名称匹配，避免检索失败 (#17735) @yali-hzy
• 刷理智代理倍率识别改用 RGB 颜色匹配，提升识别稳定性 (#17719) @status102
• 保全作业浏览时不自动添加到作业列表 @status102
• 更新保全作业，新增日达诺夫园区与荒废灯塔保全作业 @Saratoga-Official
• 优化理智作战高级设置界面布局，调整自动战斗缺少干员时的提示与报错描述，明确 ｢特别关注｣ 影响识别时的处理方式 @ABA2396
• 任务因内存不足停止时给出专门提示，建议关闭部分程序或重启 MAA 后重试 @ABA2396
• 调整基建干员冲突提示，检测到干员已进驻其他设施时将自动确认调动，日志不再标红 @ABA2396
• 显卡兼容性提示在每次开始运行时输出，避免被任务日志刷掉后无法看到；调整 core 崩溃后和未知异常的错误提示 @ABA2396
• 为软件更新包下载添加重试 (#17675) @bkzzzz
• 截图耗时 100ms 以上且未启用截图增强时，补充截图优化建议，并优化截图增强报错与设置指引 @ABA2396
• 优化启动设置页提示 @ABA2396
• 打包时用原生启动器替换 MAA.exe 的 apphost，MAA.exe 被单独移动等文件不完整的情况能给出明确提示，不再误报未安装 .NET (#17727) @ABA2396
• 切换客户端后断开现有连接 @ABA2396
• 自动战斗自动编队切换职业时切换回全部职业分类，避免游戏未重置 UI 位置 @status102
• 繁中服调整文件与界面的在地化用词 (#17856) @momomochi987
• 繁中服调整部分干员与关卡名称 OCR 并增加容错 (#17703 #17828) @momomochi987
• 繁中服补全并调整界园肉鸽通宝权重，更新界园肉鸽干员管理入口模板 (#16306 #16634) @travellerse @abmcar
• YostarEN/JP/KR update MiniGame SPA S2 templates (#17808) @Constrat @Manicsteiner @HX3N
• YostarKR update localization with official terminology, normalize BlackFlow roguelike terminology, and polish task-log strings and clue terminology @HX3N

修复 | Fix

• 更新器等待主程序退出增加超时强制结束，主程序意外滞留时更新不再无限等待；主程序启动中止时改为立即退出进程；更新器获取父进程句柄权限不足时不再跳过等待 (#17930) @ABA2396
• 修复作业解析同名干员时可能取错条目的问题，改为取稀有度最高条目，阿米娅技能 3 判断不再受哈希顺序影响，并在技能 3 的支持条件中允许阿米娅 (#17893) @ABA2396 @yali-hzy
• 修复自动战斗与肉鸽作业 role 字段的职业解析，未指定或未知职业名不再被误判为无人机职业，并兼容职业大小写；修复以 Unknown 职业注册的技能用法无法正确查找的问题，工具人技能用法改为部署时写入 @status102 @ABA2396
• 修复自动战斗技能用法设置失效、待部署等待干员就绪检测阻塞、非自动编队下预分配失败后重复添加干员数据、编入干员分组算法无法比对等问题 @status102 @yali-hzy
• 修复自动战斗部署时未能正确移除目标地块的过往干员 @status102
• 修复自动战斗作业保存时输出多余超时参数、编队反复切换职业的问题 @status102
• 修复黑流树海肉鸽出发前往流程与不投资源石锭状态机，襁褓羽蛇与三头犬改为进入第三层后结算，规划器单拍间隔调整（白模鸟系列留给 boss），策略完成后无法正确停止并上报、未完成时无法重开下一局 (#17916 #17870 #17862 #17869 #17771) @ZiyinLin
• 修复黑流树海的一批识别问题：页面分类适配、加工品选择失败后重开、行动力预览正数识别、临时中介所识别、左下角放大镜判定方法与阈值、CloseCollectionContinue 判定 ROI 与阈值 (#17798 #17832 #17833 #18004 #17779) @ZiyinLin @status102 @ABA2396 @youzibigg
• 黑流肉鸽资源文件损坏时资源加载直接失败并提示，不再静默失效 @status102
• 修复基建控制中枢选人、制造站深海队选人、自定义基建选人确认、宿舍宿管排序与二轮补位、未建满基建设施布局适配等一组问题 (#17835) @status102 @Lancarus @ABA2396
• 修复基建布局识别的捏合缩放手势未经动作分割直接瞬移导致缩放无效的问题，识别失败时继续缩小视图重试 (#17896) @ABA2396 @youzibigg
• 去除基建布局识别对控制中枢数量的校验，缺少控制中枢的布局不再被判为无效 @Lancarus
• 修复基建设施顺序在普通模式下无法重置 @status102
• 补齐部分基建技能评分，中枢评分最优选择不足 5 人时补足到 5 人 @Lancarus
• 调整基建无人机及确认的模板目录 (#17952) @youzibigg
• 对截图、OCR、OpenCV 图像处理增加异常捕获避免直接崩溃，未处理异常额外输出异常信息并交由 WER 处理 (#17860) @moranfanhua @ABA2396
• 深海猎人候选干员数据缺失时跳过该候选，避免初始化崩溃 @ABA2396
• 修复 MuMu 触控增强在游戏开始渲染前因回退画面被误判不可用，检查推迟至游戏开始渲染时进行 (#17855) @ABA2396
• 修复启用 MuMu 触控模式时模拟器路径自动检测结果未生效 @status102
• 修复 MuMu 触控增强等支持划火柴的触控模式下，划火柴模式开关参数未正确传递生效的问题 (#17652) @Rbqwow
• 屏幕横竖屏（旋转）切换不再触发分辨率变化中断，旋转时自动重建 minitouch；RawWithGzip 截图测速支持竖屏 @ABA2396
• 扩大选中干员的颜色范围，处理阴影中的编队框 (#17819) @yali-hzy
• 修复从公招的选择招募时限界面开始自动公招功能，会触发循环操作的问题 @ABA2396
• 修复可搜索 ComboBox 的一批问题：语言切换等场景下选项绑定失效、指定材料被清空、初始化时将已绑定值覆盖为列表第一项（肉鸽开局干员重启后被重置）、下拉列表滚轮一次滚到底、换源统一由扩展接管并修复中间值写回产生的重复日志 (#17759) @status102 @ABA2396
• 修复切换界面语言后部分下拉列表与提示停留旧语言的问题（肉鸽刷通关时长目标、黑流培养目标、自动战斗单位支持用法、隐蔽战线事件、肉鸽开局干员提示）@ABA2396
• 修复从 PC 端切回模拟器需要重启后才能连接 @ABA2396
• 修复 NotifyIcon 双击间隔为 0 时的启动崩溃 (#17691) @bkzzzz
• 修复连接配置下拉框打开和滚动时整个页面位移的问题 @ABA2396
• 修复自定义 Webhook 无法通过 Headers 设置 Content-Type 导致通知发送失败的问题，消息体占位符补全 Json 转义 @ABA2396
• 修复 ｢开始任务：｣ 分隔栏在界面最小化时无法正确添加、Rectangle 无法显示的问题 @ABA2396
• 修复小游戏界面开始任务时连接模拟器失败无任何提示 (#17887) @ABA2396
• 修复无配置文件时首次启动更新源显示为空 @ABA2396
• 修复亮色模式下下拉框高亮文本颜色错误 @ABA2396
• 修复像素画英文界面按钮显示不全、切换语言时适配与抖动下拉框内容未实时切换 @ABA2396
• 修复成就 ｢不务正业｣ 达成条件文案未跟随术语显示 (#17834) @H2O-MERO
• 放宽 Miss.Christine 的 OCR 识别容错 @Lancarus
• 繁中服适配新版登录界面 (#17853)，调整「辭歲行」OCR 文字 (#17910) @momomochi987
• YostarKR correct CharsNameOcrReplace regex, update SilverAsh ocrReplace, and fix ocrReplace regex for 烛煌 (#17946) @HX3N
• YostarKR loosen SkipThePreBattlePlot match threshold for lighter plot overlays @HX3N
• YostarKR fix Roguelike recruitment giving up instead of recruiting @HX3N
• YostarKR handle startup notification during account switch @HX3N
• YostarKR update Roguelike@TraderRandomShoppingConfirm template @HX3N
• YostarEN fix Eyja alter OCR regex @Constrat
• YostarEN rework Sami IS floor detection to match region names instead of temperature numbers @Constrat

文档 | Docs

• 新增 MaaFramework 控制单元自动下载脚本及开发文档说明 (#17786) @Justin-Emils
• 同步更新五语言文档（连接与设备说明、集成协议、copilot 等任务 schema、开发教程与 FAQ）(#17879) @ABA2396
• 补充集成协议文档与 schema（nmsDistance 字段、copilot-schema、callback-schema），修正 MirrorChyan 拼写与 config.md 示例 @ABA2396
• 翻译 ja-jp 版 maa-cli 文档并标注机器翻译 @ABA2396
• 添加 Mac GUI 过渡公告 (#17965) @hguandl
• 更新仓库分支名 dev → dev-v2，修复文档站 ｢编辑此页｣ 链接 404 (#17920) @satgo1546
• 补充拖入更新文件的管理员权限说明 (#17842) @youzibigg
• CI 教程发布分支由 master 更新为 master-v2 (#17823) @youzibigg
• 更新手入门文档，简化下载安装步骤并说明日志包生成方式 @ABA2396
• 肉鸽文档补充黑流树海推荐开局 (#17753) @Rbqwow @ABA2396
• 修正多语言文档错别字，更新作业协议 nav_name_override 字段说明 (#17708) @apricity093 @hguandl
• 补充会客室取下线索的说明 @ABA2396

其他 | Other

• 修复 Unix 平台上构建 MaaWpfGui 报错 (#17958) @satgo1546

MaaMacGui

新增 | New

• 支持作业集 @hguandl
• 支持奇象巡展像素画 @hguandl

改进 | Improved

• 调整像素画选项文案 @hguandl