This update includes optimizations for automatic battle experiences, feature adaptations for different game servers, and various text description improvements to enhance user understanding.
## Summary by Sourcery
基于 macOS ScreenCaptureKit 新增截图支持，并优化资源加载、配置变更追踪和 Web API 缓存行为。
新功能：
- 引入基于 macOS ScreenCaptureKit 的 MacSCK 截图方法及专用辅助工具，用于捕获模拟器窗口。
- 新增构建时选项，在 Apple 平台上启用 MacSCK 并链接所需的 macOS 框架。
- 在 Maa API 服务中暴露 API 响应是否来自缓存的信息，并调整调用方以区分处理缓存数据与新鲜数据。
缺陷修复：
- 确保仅在远程任务数据为新下载（而非完全来自缓存）时才合并并重新加载关卡资源。
- 在变更通知和日志中传播新旧配置值，以实现更精确的配置变更追踪。
- 修正干员 Pallas 的特殊处理与排序逻辑，包括通过公共标志使其稀有度颜色资源可配置，并在同稀有度干员中将其排序靠前。
- 改进 Maa API 错误与缓存回退处理，避免在响应无效或缺失时静默返回不带缓存状态信息的 null。
增强：
- 当仍在使用已弃用的单一 `tasks.json` 资源文件时，记录额外提示日志，并引导用户迁移到新的 tasks 目录格式。
- 优化 MuMu 截图增强模式文档，在所有支持的语言中明确不同版本的要求。
构建：
- 在启用 ScreenCaptureKit 支持时，在 MaaCore 构建中有条件地包含 MacSCK
辅助源文件，定义编译期标志，并链接所需的 macOS 框架。
文档：
- 更新多语言连接手册，明确截图增强模式所需支持的 MuMu 最低版本。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Add macOS ScreenCaptureKit-based screenshot support and refine resource
loading, configuration change tracking, and web API caching behavior.
New Features:
- Introduce a MacSCK screenshot method with a dedicated helper to
capture emulator windows via macOS ScreenCaptureKit.
- Add a build-time option to enable MacSCK on Apple platforms and link
the necessary macOS frameworks.
- Expose whether API responses come from cache in the Maa API service
and adjust callers to handle cached vs fresh data.
Bug Fixes:
- Ensure stage resources are only merged and reloaded when remote task
data is freshly downloaded rather than served entirely from cache.
- Propagate old and new configuration values through change
notifications and logs for more accurate configuration tracking.
- Correct the special handling and sorting of the operator Pallas,
including making its rarity color resource configurable via a public
flag and sorting it ahead of others with the same rarity.
- Improve Maa API error and cache fallback handling so invalid or
missing responses do not silently return null without cache status
information.
Enhancements:
- Log additional guidance when the deprecated single tasks.json resource
file is used and point users to the new tasks directory format.
- Refine MuMu screenshot enhanced mode documentation with clearer
version requirements across all supported languages.
Build:
- Include the MacSCK helper source conditionally in MaaCore builds,
define a compile-time flag, and link required macOS frameworks when
ScreenCaptureKit support is enabled.
Documentation:
- Update connection manuals in multiple languages to clarify the minimum
supported MuMu versions for screenshot enhanced mode.
</details>
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
基于 macOS ScreenCaptureKit 新增截图支持，并优化资源加载、配置变更追踪和 Web API 缓存行为。
新功能：
- 引入基于 macOS ScreenCaptureKit 的 MacSCK 截图方法及专用辅助工具，用于捕获模拟器窗口。
- 新增构建时选项，在 Apple 平台上启用 MacSCK 并链接所需的 macOS 框架。
- 在 Maa API 服务中暴露 API 响应是否来自缓存的信息，并调整调用方以区分处理缓存数据与新鲜数据。
缺陷修复：
- 确保仅在远程任务数据为新下载（而非完全来自缓存）时才合并并重新加载关卡资源。
- 在变更通知和日志中传播新旧配置值，以实现更精确的配置变更追踪。
- 修正干员 Pallas 的特殊处理与排序逻辑，包括通过公共标志使其稀有度颜色资源可配置，并在同稀有度干员中将其排序靠前。
- 改进 Maa API 错误与缓存回退处理，避免在响应无效或缺失时静默返回不带缓存状态信息的 null。
增强：
- 当仍在使用已弃用的单一 `tasks.json` 资源文件时，记录额外提示日志，并引导用户迁移到新的 tasks 目录格式。
- 优化 MuMu 截图增强模式文档，在所有支持的语言中明确不同版本的要求。
构建：
- 在启用 ScreenCaptureKit 支持时，在 MaaCore 构建中有条件地包含 MacSCK
辅助源文件，定义编译期标志，并链接所需的 macOS 框架。
文档：
- 更新多语言连接手册，明确截图增强模式所需支持的 MuMu 最低版本。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Add macOS ScreenCaptureKit-based screenshot support and refine resource
loading, configuration change tracking, and web API caching behavior.
New Features:
- Introduce a MacSCK screenshot method with a dedicated helper to
capture emulator windows via macOS ScreenCaptureKit.
- Add a build-time option to enable MacSCK on Apple platforms and link
the necessary macOS frameworks.
- Expose whether API responses come from cache in the Maa API service
and adjust callers to handle cached vs fresh data.
Bug Fixes:
- Ensure stage resources are only merged and reloaded when remote task
data is freshly downloaded rather than served entirely from cache.
- Propagate old and new configuration values through change
notifications and logs for more accurate configuration tracking.
- Correct the special handling and sorting of the operator Pallas,
including making its rarity color resource configurable via a public
flag and sorting it ahead of others with the same rarity.
- Improve Maa API error and cache fallback handling so invalid or
missing responses do not silently return null without cache status
information.
Enhancements:
- Log additional guidance when the deprecated single tasks.json resource
file is used and point users to the new tasks directory format.
- Refine MuMu screenshot enhanced mode documentation with clearer
version requirements across all supported languages.
Build:
- Include the MacSCK helper source conditionally in MaaCore builds,
define a compile-time flag, and link required macOS frameworks when
ScreenCaptureKit support is enabled.
Documentation:
- Update connection manuals in multiple languages to clarify the minimum
supported MuMu versions for screenshot enhanced mode.
</details>
</details>
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
基于 macOS ScreenCaptureKit 新增截图支持，并优化资源加载、配置变更追踪和 Web API 缓存行为。
新功能：
- 引入基于 macOS ScreenCaptureKit 的 MacSCK 截图方法及专用辅助工具，用于捕获模拟器窗口。
- 新增构建时选项，在 Apple 平台上启用 MacSCK 并链接所需的 macOS 框架。
- 在 Maa API 服务中暴露 API 响应是否来自缓存的信息，并调整调用方以区分处理缓存数据与新鲜数据。
缺陷修复：
- 确保仅在远程任务数据为新下载（而非完全来自缓存）时才合并并重新加载关卡资源。
- 在变更通知和日志中传播新旧配置值，以实现更精确的配置变更追踪。
- 修正干员 Pallas 的特殊处理与排序逻辑，包括通过公共标志使其稀有度颜色资源可配置，并在同稀有度干员中将其排序靠前。
- 改进 Maa API 错误与缓存回退处理，避免在响应无效或缺失时静默返回不带缓存状态信息的 null。
增强：
- 当仍在使用已弃用的单一 `tasks.json` 资源文件时，记录额外提示日志，并引导用户迁移到新的 tasks 目录格式。
- 优化 MuMu 截图增强模式文档，在所有支持的语言中明确不同版本的要求。
构建：
- 在启用 ScreenCaptureKit 支持时，在 MaaCore 构建中有条件地包含 MacSCK
辅助源文件，定义编译期标志，并链接所需的 macOS 框架。
文档：
- 更新多语言连接手册，明确截图增强模式所需支持的 MuMu 最低版本。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Add macOS ScreenCaptureKit-based screenshot support and refine resource
loading, configuration change tracking, and web API caching behavior.
New Features:
- Introduce a MacSCK screenshot method with a dedicated helper to
capture emulator windows via macOS ScreenCaptureKit.
- Add a build-time option to enable MacSCK on Apple platforms and link
the necessary macOS frameworks.
- Expose whether API responses come from cache in the Maa API service
and adjust callers to handle cached vs fresh data.
Bug Fixes:
- Ensure stage resources are only merged and reloaded when remote task
data is freshly downloaded rather than served entirely from cache.
- Propagate old and new configuration values through change
notifications and logs for more accurate configuration tracking.
- Correct the special handling and sorting of the operator Pallas,
including making its rarity color resource configurable via a public
flag and sorting it ahead of others with the same rarity.
- Improve Maa API error and cache fallback handling so invalid or
missing responses do not silently return null without cache status
information.
Enhancements:
- Log additional guidance when the deprecated single tasks.json resource
file is used and point users to the new tasks directory format.
- Refine MuMu screenshot enhanced mode documentation with clearer
version requirements across all supported languages.
Build:
- Include the MacSCK helper source conditionally in MaaCore builds,
define a compile-time flag, and link required macOS frameworks when
ScreenCaptureKit support is enabled.
Documentation:
- Update connection manuals in multiple languages to clarify the minimum
supported MuMu versions for screenshot enhanced mode.
</details>
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
基于 macOS ScreenCaptureKit 新增截图支持，并优化资源加载、配置变更追踪和 Web API 缓存行为。
新功能：
- 引入基于 macOS ScreenCaptureKit 的 MacSCK 截图方法及专用辅助工具，用于捕获模拟器窗口。
- 新增构建时选项，在 Apple 平台上启用 MacSCK 并链接所需的 macOS 框架。
- 在 Maa API 服务中暴露 API 响应是否来自缓存的信息，并调整调用方以区分处理缓存数据与新鲜数据。
缺陷修复：
- 确保仅在远程任务数据为新下载（而非完全来自缓存）时才合并并重新加载关卡资源。
- 在变更通知和日志中传播新旧配置值，以实现更精确的配置变更追踪。
- 修正干员 Pallas 的特殊处理与排序逻辑，包括通过公共标志使其稀有度颜色资源可配置，并在同稀有度干员中将其排序靠前。
- 改进 Maa API 错误与缓存回退处理，避免在响应无效或缺失时静默返回不带缓存状态信息的 null。
增强：
- 当仍在使用已弃用的单一 `tasks.json` 资源文件时，记录额外提示日志，并引导用户迁移到新的 tasks 目录格式。
- 优化 MuMu 截图增强模式文档，在所有支持的语言中明确不同版本的要求。
构建：
- 在启用 ScreenCaptureKit 支持时，在 MaaCore 构建中有条件地包含 MacSCK
辅助源文件，定义编译期标志，并链接所需的 macOS 框架。
文档：
- 更新多语言连接手册，明确截图增强模式所需支持的 MuMu 最低版本。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Add macOS ScreenCaptureKit-based screenshot support and refine resource
loading, configuration change tracking, and web API caching behavior.
New Features:
- Introduce a MacSCK screenshot method with a dedicated helper to
capture emulator windows via macOS ScreenCaptureKit.
- Add a build-time option to enable MacSCK on Apple platforms and link
the necessary macOS frameworks.
- Expose whether API responses come from cache in the Maa API service
and adjust callers to handle cached vs fresh data.
Bug Fixes:
- Ensure stage resources are only merged and reloaded when remote task
data is freshly downloaded rather than served entirely from cache.
- Propagate old and new configuration values through change
notifications and logs for more accurate configuration tracking.
- Correct the special handling and sorting of the operator Pallas,
including making its rarity color resource configurable via a public
flag and sorting it ahead of others with the same rarity.
- Improve Maa API error and cache fallback handling so invalid or
missing responses do not silently return null without cache status
information.
Enhancements:
- Log additional guidance when the deprecated single tasks.json resource
file is used and point users to the new tasks directory format.
- Refine MuMu screenshot enhanced mode documentation with clearer
version requirements across all supported languages.
Build:
- Include the MacSCK helper source conditionally in MaaCore builds,
define a compile-time flag, and link required macOS frameworks when
ScreenCaptureKit support is enabled.
Documentation:
- Update connection manuals in multiple languages to clarify the minimum
supported MuMu versions for screenshot enhanced mode.
</details>
</details>
</details>
## Sourcery 总结
在为 v6.4.0 版本更新工具链、资源和 CI 的同时，持久化并优化各类客户端、战斗、协作助手和 GUI 行为。
新功能：
- 在设置界面中记住各分区的展开状态，并在主窗口标题中体现管理员状态。
- 为 Mac PlayTools 客户端提供 BGR 截图模式支持，并为 Attach Window 连接新增以管理员权限重启的流程。
- 在 Attach Window 模式下允许分别配置鼠标与键盘的输入方式，并为组合框添加“边输入边搜索”的交互优化。
- 引入一个带作用域的日志辅助工具，并在文档站点中支持可选的折叠导航分区。
缺陷修复：
- 稳定 Attach Window 的默认值和校验逻辑，包括配置迁移及全局的客户端类型处理。
- 修复战斗中的速度与对话处理逻辑，确保在跳过剧情和头像对话后仍能保持 2x 速度。
- 纠正协作助手和用户附加技能的索引默认值与校验逻辑，并阻止在任务重命名中使用非法字符。
- 清理仅用于调试的代码路径和 JustReturn 校验日志，并防范对过时配置转换逻辑的错误假设。
增强优化：
- 通过集中式辅助工具和改进的 StageManager 逻辑优化关卡选择和歼灭关卡处理，包括更新关卡元数据和格子坐标资源。
- 通过在 WPF 辅助工具、设置及日期时间处理逻辑中使用枚举统一客户端类型，以获得更稳健的映射和时区行为。
- 优化 PlayTools 截图缓冲、任务队列变更追踪以及设置页滚动联动，以提升性能和可观测性。
- 改进 macOS 构建流程，将 xcframework 生成委托给专用 makefile，并为 MaaDeps 下载器扩展缓存支持。
构建：
- 将 macOS xcframework 构建切换为基于 makefile 的流程，并为 MaaDeps 下载脚本增加缓存资源支持。
CI：
- 将 GitHub Actions 工作流更新为较新的 upload/download-artifact 动作，并相应调整 macOS
打包步骤。
文档：
- 在所有本地化文档中澄清协作助手技能索引的 schema 默认值，并在导航元数据中扩展索引/折叠行为控制。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Persist and refine various client, battle, copilot, and GUI behaviors
while updating tooling, resources, and CI for the v6.4.0 release.
New Features:
- Remember per-section expansion state in the settings UI and reflect
administrator status in the main window title.
- Support a BGR screenshot mode for Mac PlayTools clients and add
admin-elevation restart flow for Attach Window connections.
- Allow separate configuration of mouse and keyboard input methods in
Attach Window mode and add search-as-you-type improvements for combo
boxes.
- Introduce a scoped logging helper and support optional collapsed
navigation sections in the documentation site.
Bug Fixes:
- Stabilize Attach Window defaults and validation, including
configuration migration and client-type handling across the app.
- Fix in-battle speed and dialog handling logic to keep 2x speed active
after skipping plots and avatar dialogs.
- Correct copilot and user-additional skill indexing defaults and
validation, and prevent invalid characters in task renames.
- Clean up debug-only code paths and JustReturn validation logging, and
guard against outdated configuration conversion assumptions.
Enhancements:
- Refine stage selection and annihilation handling via centralized
helpers and improved StageManager logic, including updated stage
metadata and tile-position resources.
- Unify client type usage through enums in WPF helpers, settings, and
date-time handling for more robust mapping and time zone behavior.
- Optimize PlayTools screenshot buffering, task-queue change tracking,
and settings scroll linkage for better performance and observability.
- Improve macOS build by delegating xcframework generation to a
dedicated makefile and extending MaaDeps downloader with caching
support.
Build:
- Switch macOS xcframework build to a makefile-based workflow and add
cached-asset support to the MaaDeps download script.
CI:
- Update GitHub Actions workflows to newer upload/download-artifact
actions and adjust macOS packaging steps accordingly.
Documentation:
- Clarify copilot schema defaults for skill index across all localized
docs and extend navigation metadata with index/collapsed behavior
controls.
</details>
<details>
<summary>Original summary in English</summary>
## Sourcery 总结
在为 v6.4.0 版本更新工具链、资源和 CI 的同时，持久化并优化各类客户端、战斗、协作助手和 GUI 行为。
新功能：
- 在设置界面中记住各分区的展开状态，并在主窗口标题中体现管理员状态。
- 为 Mac PlayTools 客户端提供 BGR 截图模式支持，并为 Attach Window 连接新增以管理员权限重启的流程。
- 在 Attach Window 模式下允许分别配置鼠标与键盘的输入方式，并为组合框添加“边输入边搜索”的交互优化。
- 引入一个带作用域的日志辅助工具，并在文档站点中支持可选的折叠导航分区。
缺陷修复：
- 稳定 Attach Window 的默认值和校验逻辑，包括配置迁移及全局的客户端类型处理。
- 修复战斗中的速度与对话处理逻辑，确保在跳过剧情和头像对话后仍能保持 2x 速度。
- 纠正协作助手和用户附加技能的索引默认值与校验逻辑，并阻止在任务重命名中使用非法字符。
- 清理仅用于调试的代码路径和 JustReturn 校验日志，并防范对过时配置转换逻辑的错误假设。
增强优化：
- 通过集中式辅助工具和改进的 StageManager 逻辑优化关卡选择和歼灭关卡处理，包括更新关卡元数据和格子坐标资源。
- 通过在 WPF 辅助工具、设置及日期时间处理逻辑中使用枚举统一客户端类型，以获得更稳健的映射和时区行为。
- 优化 PlayTools 截图缓冲、任务队列变更追踪以及设置页滚动联动，以提升性能和可观测性。
- 改进 macOS 构建流程，将 xcframework 生成委托给专用 makefile，并为 MaaDeps 下载器扩展缓存支持。
构建：
- 将 macOS xcframework 构建切换为基于 makefile 的流程，并为 MaaDeps 下载脚本增加缓存资源支持。
CI：
- 将 GitHub Actions 工作流更新为较新的 upload/download-artifact 动作，并相应调整 macOS
打包步骤。
文档：
- 在所有本地化文档中澄清协作助手技能索引的 schema 默认值，并在导航元数据中扩展索引/折叠行为控制。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Persist and refine various client, battle, copilot, and GUI behaviors
while updating tooling, resources, and CI for the v6.4.0 release.
New Features:
- Remember per-section expansion state in the settings UI and reflect
administrator status in the main window title.
- Support a BGR screenshot mode for Mac PlayTools clients and add
admin-elevation restart flow for Attach Window connections.
- Allow separate configuration of mouse and keyboard input methods in
Attach Window mode and add search-as-you-type improvements for combo
boxes.
- Introduce a scoped logging helper and support optional collapsed
navigation sections in the documentation site.
Bug Fixes:
- Stabilize Attach Window defaults and validation, including
configuration migration and client-type handling across the app.
- Fix in-battle speed and dialog handling logic to keep 2x speed active
after skipping plots and avatar dialogs.
- Correct copilot and user-additional skill indexing defaults and
validation, and prevent invalid characters in task renames.
- Clean up debug-only code paths and JustReturn validation logging, and
guard against outdated configuration conversion assumptions.
Enhancements:
- Refine stage selection and annihilation handling via centralized
helpers and improved StageManager logic, including updated stage
metadata and tile-position resources.
- Unify client type usage through enums in WPF helpers, settings, and
date-time handling for more robust mapping and time zone behavior.
- Optimize PlayTools screenshot buffering, task-queue change tracking,
and settings scroll linkage for better performance and observability.
- Improve macOS build by delegating xcframework generation to a
dedicated makefile and extending MaaDeps downloader with caching
support.
Build:
- Switch macOS xcframework build to a makefile-based workflow and add
cached-asset support to the MaaDeps download script.
CI:
- Update GitHub Actions workflows to newer upload/download-artifact
actions and adjust macOS packaging steps accordingly.
Documentation:
- Clarify copilot schema defaults for skill index across all localized
docs and extend navigation metadata with index/collapsed behavior
controls.
</details>
</details>
