## Summary by Sourcery
使版本报告与 MAA 核心配置保持一致，加固任务解析与符号处理，改进战斗/地图交互与图像工具，并为新版本优化 CI 缓存清理和资源数据。
New Features:
- 在生成和裁剪基于 ROI 的任务时，新增对分组 UI 主题变体和嵌套图像布局的支持。
- 引入新的 TXWY 关卡任务定义，并更新多种肉鸽和 UI 主题任务资源。
Bug Fixes:
- 通过引入来自地块位置信息的地图视图偏移，修复地块位置以及技能/撤退按钮的计算。
- 在撤退后通过取消选中作为保护措施，防止干员被误操作。
- 在执行清理前检查地图目录，避免删除不存在的地图图像。
- 通过处理缺失的 PR 和与陈旧分支相关的缓存，提高缓存清理脚本的健壮性。
- 通过统一使用拥有所有权的 `std::string` 作为键和容器，替代基于 `std::string_view`
的映射，提高任务与符号解析的稳定性。
Enhancements:
- 将版本日志、API 上报和上传数据统一切换为使用统一的 `MAA_VERSION` 配置和一致的 `DEBUG_VERSION` 标记。
- 通过委托给更高层级的流程任务，简化基建设施线索的快速插入处理逻辑。
- 整理版本更新 UI 逻辑与注释，以反映新的调试版本命名约定。
- 调整图像裁剪器的输出，以提供更清晰的 ROI 诊断信息和控制台消息。
- 优化 JSON 工具中关于默认值检查的注释，而不改变运行时行为。
CI:
- 扩展 GitHub 缓存清理脚本，覆盖与 Linux X64 prek 构建相关的更多缓存键模式，并更智能地清理 PR 和分支缓存。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Align version reporting with MAA core config, harden task parsing and
symbol handling, improve battle/map interactions and image tooling, and
refine CI cache cleanup and resource data for the new release.
New Features:
- Add support for grouped UI theme variants and nested image layouts
when generating and cutting ROI-based tasks.
- Introduce a new TXWY stage task definition and update various
Roguelike and UI theme task resources.
Bug Fixes:
- Fix tile position and skill/retreat button calculations by
incorporating map view offsets from tile position data.
- Prevent unintended operator interactions after retreat by cancelling
selection as a safeguard.
- Avoid deleting non-existent map images by checking the map directory
before cleanup.
- Increase robustness of cache cleanup scripts by handling missing PRs
and stale branch-related caches.
- Improve stability of task and symbol parsing by standardizing on
owning std::string keys and containers instead of
std::string_view-backed maps.
Enhancements:
- Switch version logging, API reporting, and upload payloads to use the
unified MAA_VERSION config and consistent DEBUG_VERSION marker.
- Simplify infrastructure clue quick-insert handling by delegating to a
higher-level process task.
- Tidy version update UI logic and comments to reflect the new debug
version naming convention.
- Adjust image cropper output for clearer ROI diagnostics and console
messaging.
- Refine JSON utility comments around default-value checks without
changing runtime behavior.
CI:
- Extend GitHub cache cleanup scripts to cover additional cache key
patterns related to Linux X64 prek builds and to clean both PR and
branch caches more intelligently.
</details>
## Summary by Sourcery
发布 v6.1.0，新增玩法自动化支持、增强日志与更新体验、大幅优化识别与模板，并带来多项稳定性与开发工具改进。
New Features:
- 在全服务器上新增 Hidden Front 玩法的全流程自动化支持。
- 为 Yostar JP/KR/EN 服务器新增类肉鸽玩法（JieGarden）的自动化支持。
- 引入悬浮日志窗口与托盘开关，用于实时查看自动战斗日志。
- 支持点击主窗口中的更新提示，直接触发更新流程。
- 新增对极寒保全（Extreme Cold Security，保全）委托与相关战斗的自动化支持。
- 在线索栏已满时支持一键放置线索。
- 在 WPF 日志系统中支持按日志级别输出到文件。
Bug Fixes:
- 修复多处更新流程问题，包括缓存文件夹拷贝、过期 OTA 包处理，以及在无可用 OTA 补丁时的错误提示信息。
- 修复 macOS 上 asst.log 被意外清空的问题，以及路径字符串含首尾空白或控制字符时导致的报错。
- 在更新进行中时正确禁用“检查更新”按钮。
- 解决日志、UI 变化与加载指示器之间的时序不匹配问题，避免因此造成的误识别。
- 修复 ROI 越界错误以及更新工具异常。
- 修复自动战斗流程问题，包括借助战后卡在好友添加界面、因布阵过快/模拟器卡顿导致的误触，以及在网络波动下确认编队失败等。
- 修复财富道具（通宝/铜钱）识别与死锁问题，并提升跨多服务器与多语言环境下的 OCR/正则与模板精度。
Enhancements:
- 打磨悬浮窗口布局与交互体验。
- 重构并优化模板资源与索引，以提升加载与识别性能。
- 缓存 ProcessTask 结果并优化 StableHash，减少重复计算并提升一致性。
- 在工具链中统一从源分辨率到目标分辨率的截图缩放逻辑。
- 通过切换到 boost::regex 改进基础设施规划刷新 API 与正则性能。
- 在拖动悬浮窗口时保持可见，避免与部分应用搭配时出现闪烁。
- 更新 macOS CMake 配置、C# EditorConfig 与开发工具，移除过时的 lint/格式化配置。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Release v6.1.0 with new gameplay automation support, enhanced logging
and update experience, broad recognition/template optimizations, and
multiple stability and tooling improvements.
New Features:
- Add full Hidden Front gameplay automation support across servers.
- Add roguelike (JieGarden) automation support for Yostar JP/KR/EN
servers.
- Introduce a floating log window and tray toggle for real-time
auto-battle log viewing.
- Allow clicking the main window update notification to directly trigger
the update process.
- Add automation support for new Extreme Cold Security (保全) assignments
and related battles.
- Enable one-click clue placement when clue slots are full.
- Support level-based log file output in the WPF logging system.
Bug Fixes:
- Fix multiple update flow issues including cache folder copying, stale
OTA packages, and incorrect messaging when no OTA patch is available.
- Fix asst.log being unexpectedly cleared on macOS and path strings with
surrounding whitespace or control characters causing errors.
- Disable the update check button correctly while an update is in
progress.
- Resolve timing-related mismatches between logs, UI changes, and
loading indicators that caused misrecognition.
- Fix ROI out-of-range errors and update tool exceptions.
- Fix auto-battle flow issues including being stuck on friend add after
borrowing support, misclicks due to fast formations/emulator lag, and
failures confirming lineups under network fluctuations.
- Fix treasury item (通宝/铜钱) recognition and deadlock issues, and improve
OCR/regex and template accuracy across multiple servers and languages.
Enhancements:
- Refine floating window layout and interaction experience.
- Refactor and optimize template resources and indexing to improve
loading and recognition performance.
- Cache ProcessTask results and optimize StableHash to reduce repeated
computation and improve consistency.
- Standardize screenshot scaling from source to target resolution in
tooling.
- Improve infrastructure plan refresh API and regex performance by
switching to boost::regex.
- Keep the floating window visible while moving to avoid flicker with
certain applications.
- Update macOS CMake config, C# EditorConfig, and developer tooling,
removing outdated lint/format configs.
</details>
