## Sourcery 总结
更新宿舍干员选择、信用商店购买、账号切换和通知行为，并为 v6.11.0 版本新增协议、UI 和资源支持。
新功能（New Features）：
- 在账号切换与启动配置中新增对 txwy（繁体中文）客户端的支持。
- 允许为外部 Webhook 通知配置自定义 HTTP 请求头。
- 支持使用基于文件的输入进行悖论模拟助手的批量识别。
- 为助手的“用户附加信息”弹出网格引入动态尺寸和对齐方式。
缺陷修复（Bug Fixes）：
- 修复宿舍自动填充逻辑，更好地协调基于心情的选择、信赖刷取以及“未进驻”筛选条件，并增强筛选开关的稳定性。
- 通过使用 OCR 等价处理、保留物品名称以及在点击前校验商品，改进信用商店物品识别与购买流程，避免买错物品。
- 确保任务完成后的检查仅在任务队列由 link-start 启动时才执行。
- 修正信用商店售罄检测与白名单排序逻辑，使其能基于结构化的 TextRect 结果而非裸矩形数据工作。
- 修复悖论模拟助手的识别逻辑，使其正确读取和引用悖论配置文件，而不是干员名称。
- 解决外部通知自定义 Webhook 配置相关问题，通过安全持久化请求头并在请求中正确应用。
- 明确并修正针对更多客户端类型和 OCR 设置的账号切换行为。
增强优化（Enhancements）：
- 将宿舍选择状态重构为更清晰的选择阶段，并为信赖阈值和设施标签抽取常量。
- 收紧基建任务中的筛选菜单交互，确保“未进驻”和“全部设施”筛选条件能稳定应用和取消。
- 优化信用商店购买逻辑，更好地遵守“仅折扣”和“信用预留”选项，并具有更清晰的停止条件。
- 打磨外部通知、战斗设置和启动设置的 ViewModel 与 XAML 绑定，实现更清晰的行为与格式。
- 更新变更日志生成器和依赖下载脚本，以改善格式并跟踪最新 MaaDeps 版本。
构建（Build）：
- 在下载辅助脚本中将 MaaDeps 依赖版本提升至 v2.11.0。
文档（Documentation）：
- 扩展多语言的集成与启动文档，加入对繁体中文（txwy）账号的使用指南以及账号名匹配示例。
杂项维护（Chores）：
- 刷新多项游戏数据与任务 JSON 资源，包括最新关卡与记忆关卡的地块坐标定义、物品与关卡索引以及本地化资源。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
准备 v6.11.0 版本发布，本次更新包括：改进宿舍自动填充逻辑、更安全且更精准的信用点商店购买、扩展悖论模拟器批量识别、增强外部
Webhook 通知、支持 txwy（繁体中文）账号、更新工具链，以及刷新游戏数据/资源。
New Features:
- 在账号切换与启动配置中，新增对 txwy（繁体中文）游戏客户端的支持。
- 允许为外部 Webhook 通知配置自定义 HTTP 请求头，并在发送请求时应用这些请求头。
- 支持使用基于文件的输入而非干员名称进行悖论模拟批量识别。
- 为 UI 中 copilot 的“User additional information”弹出网格添加动态尺寸和对齐能力。
- 让 ImageCropper 工具在 ADB 设备之外，额外支持通过 Win32/WGC 捕获 PC 窗口。
Bug Fixes:
- 通过更好地协调基于心情的选择、信赖刷取以及“未进驻”筛选状态，稳定宿舍自动填充行为。
- 改进信用点商店物品检测和购买逻辑，避免购买错误物品，包括更健壮的 OCR 等价处理以及在购买前对单件物品进行校验。
- 确保战斗结束后的任务完成检查仅在通过 link-start 启动任务队列时才会运行。
- 修复信用点商店中已售罄检测和白名单排序，使其基于结构化的 TextRect 结果而非原始矩形进行处理。
- 修正悖论模拟器识别逻辑，改为读取悖论配置文件，而不是直接使用干员名称。
- 修复自定义 Webhook 通知设置的持久化与应用问题，包括请求头的安全存储和正确使用。
- 在更多客户端类型和 OCR 设置（包括 txwy）下，澄清并修正账号切换逻辑。
Enhancements:
- 将宿舍选择流程细化为更清晰的阶段（低心情、信赖自动填充、填满剩余），并强化对“未进驻”筛选和信赖阈值的处理。
- 收紧基建筛选菜单交互，使“未进驻”和“全部设施”筛选能稳定生效与清除。
- 优化信用点商店购买逻辑，更好地遵守“仅折扣”和“保留信用点”选项，并具有更清晰的停止条件。
- 打磨外部通知、战斗设置、启动和 copilot 视图的 ViewModel 与 XAML 绑定，以获得更可预期的行为和布局。
- 改进更新日志生成和依赖下载脚本，包括格式调整以及对最新 MaaDeps 版本的跟踪。
Build:
- 在辅助下载脚本中将 MaaDeps 依赖版本提升至 v2.11.0。
- 将 ImageCropper 的 Python 依赖更新为 MaaFw 5.10 和 OpenCV 4.13。
Documentation:
- 扩展多语言集成与启动文档，增加关于使用 txwy（繁体中文）账号以及登录名匹配的说明与示例。
- 更新 ImageCropper 使用文档，涵盖通过 WGC/Win32 捕获 PC 窗口及相关配置选项。
Chores:
- 刷新多项游戏数据和任务 JSON 资源，包括新关卡、记忆关卡、地块坐标、物品索引、关卡索引、UI
主题任务、肉鸽任务，以及最新内容的本地化资源。
- 更新所有已支持语言的协议与启动文档，说明 txwy 账号格式及相关使用建议。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Prepare the v6.11.0 release with improved dormitory auto-fill logic,
safer and more accurate credit shop purchasing, expanded paradox
simulator batch recognition, enhanced external webhook notifications,
txwy (Traditional Chinese) account support, updated tooling, and
refreshed game data/resources.
New Features:
- Add support for the txwy (Traditional Chinese) game client in account
switching and startup configuration.
- Allow configuring custom HTTP headers for external webhook
notifications and apply them when sending requests.
- Support batch paradox simulation recognition using file-based inputs
instead of operator names.
- Add dynamic sizing and alignment for the copilot "User additional
information" popup grid in the UI.
- Enable the ImageCropper tool to capture PC windows via Win32/WGC in
addition to ADB devices.
Bug Fixes:
- Stabilize dormitory auto-fill behavior by better coordinating
mood-based selection, trust farming, and the "not stationed" filter
state.
- Improve credit shop item detection and purchasing to avoid buying
incorrect items, including more robust OCR equivalence handling and
per-item verification before purchase.
- Ensure post-battle task completion checks only run when the task queue
is started via link-start.
- Fix sold-out detection and whitelist sorting in the credit shop to
operate on structured TextRect results rather than raw rectangles.
- Correct paradox simulator recognition to read paradox configuration
files instead of using operator names directly.
- Fix persistence and application of custom webhook notification
settings, including secure storage and usage of request headers.
- Clarify and correct account switching logic across more client types
and OCR settings, including txwy.
Enhancements:
- Refine dormitory selection into clearer phases (low mood, trust
autofill, fill remaining) and tighten handling of "not stationed"
filtering and trust thresholds.
- Tighten infrastructure filter menu interactions so "not stationed" and
"all facilities" filters apply and clear reliably.
- Optimize credit shop buying logic to better respect discount-only and
credit-reserve options with clearer stopping conditions.
- Polish ViewModel and XAML bindings for external notifications, fight
settings, startup, and copilot views for more predictable behavior and
layout.
- Improve changelog generation and dependency download scripts,
including formatting tweaks and tracking the latest MaaDeps version.
Build:
- Bump MaaDeps dependency version to v2.11.0 in the helper download
script.
- Update ImageCropper Python dependencies to MaaFw 5.10 and OpenCV 4.13.
Documentation:
- Extend multi-language integration and startup documentation with
guidance and examples for using txwy (Traditional Chinese) accounts and
login-name matching.
- Update ImageCropper usage docs to cover PC window capture via
WGC/Win32 and related configuration options.
Chores:
- Refresh multiple game data and task JSON resources, including new
stages, memory stages, tile coordinates, item indices, stage indices, UI
theme tasks, roguelike tasks, and localization resources for the latest
content.
- Update protocol and startup documentation across all supported
languages to describe txwy account formats and recommendations.
</details>
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
准备 v6.11.0 版本发布，本次更新包括：改进宿舍自动填充逻辑、更安全且更精准的信用点商店购买、扩展悖论模拟器批量识别、增强外部
Webhook 通知、支持 txwy（繁体中文）账号、更新工具链，以及刷新游戏数据/资源。
New Features:
- 在账号切换与启动配置中，新增对 txwy（繁体中文）游戏客户端的支持。
- 允许为外部 Webhook 通知配置自定义 HTTP 请求头，并在发送请求时应用这些请求头。
- 支持使用基于文件的输入而非干员名称进行悖论模拟批量识别。
- 为 UI 中 copilot 的“User additional information”弹出网格添加动态尺寸和对齐能力。
- 让 ImageCropper 工具在 ADB 设备之外，额外支持通过 Win32/WGC 捕获 PC 窗口。
Bug Fixes:
- 通过更好地协调基于心情的选择、信赖刷取以及“未进驻”筛选状态，稳定宿舍自动填充行为。
- 改进信用点商店物品检测和购买逻辑，避免购买错误物品，包括更健壮的 OCR 等价处理以及在购买前对单件物品进行校验。
- 确保战斗结束后的任务完成检查仅在通过 link-start 启动任务队列时才会运行。
- 修复信用点商店中已售罄检测和白名单排序，使其基于结构化的 TextRect 结果而非原始矩形进行处理。
- 修正悖论模拟器识别逻辑，改为读取悖论配置文件，而不是直接使用干员名称。
- 修复自定义 Webhook 通知设置的持久化与应用问题，包括请求头的安全存储和正确使用。
- 在更多客户端类型和 OCR 设置（包括 txwy）下，澄清并修正账号切换逻辑。
Enhancements:
- 将宿舍选择流程细化为更清晰的阶段（低心情、信赖自动填充、填满剩余），并强化对“未进驻”筛选和信赖阈值的处理。
- 收紧基建筛选菜单交互，使“未进驻”和“全部设施”筛选能稳定生效与清除。
- 优化信用点商店购买逻辑，更好地遵守“仅折扣”和“保留信用点”选项，并具有更清晰的停止条件。
- 打磨外部通知、战斗设置、启动和 copilot 视图的 ViewModel 与 XAML 绑定，以获得更可预期的行为和布局。
- 改进更新日志生成和依赖下载脚本，包括格式调整以及对最新 MaaDeps 版本的跟踪。
Build:
- 在辅助下载脚本中将 MaaDeps 依赖版本提升至 v2.11.0。
- 将 ImageCropper 的 Python 依赖更新为 MaaFw 5.10 和 OpenCV 4.13。
Documentation:
- 扩展多语言集成与启动文档，增加关于使用 txwy（繁体中文）账号以及登录名匹配的说明与示例。
- 更新 ImageCropper 使用文档，涵盖通过 WGC/Win32 捕获 PC 窗口及相关配置选项。
Chores:
- 刷新多项游戏数据和任务 JSON 资源，包括新关卡、记忆关卡、地块坐标、物品索引、关卡索引、UI
主题任务、肉鸽任务，以及最新内容的本地化资源。
- 更新所有已支持语言的协议与启动文档，说明 txwy 账号格式及相关使用建议。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Prepare the v6.11.0 release with improved dormitory auto-fill logic,
safer and more accurate credit shop purchasing, expanded paradox
simulator batch recognition, enhanced external webhook notifications,
txwy (Traditional Chinese) account support, updated tooling, and
refreshed game data/resources.
New Features:
- Add support for the txwy (Traditional Chinese) game client in account
switching and startup configuration.
- Allow configuring custom HTTP headers for external webhook
notifications and apply them when sending requests.
- Support batch paradox simulation recognition using file-based inputs
instead of operator names.
- Add dynamic sizing and alignment for the copilot "User additional
information" popup grid in the UI.
- Enable the ImageCropper tool to capture PC windows via Win32/WGC in
addition to ADB devices.
Bug Fixes:
- Stabilize dormitory auto-fill behavior by better coordinating
mood-based selection, trust farming, and the "not stationed" filter
state.
- Improve credit shop item detection and purchasing to avoid buying
incorrect items, including more robust OCR equivalence handling and
per-item verification before purchase.
- Ensure post-battle task completion checks only run when the task queue
is started via link-start.
- Fix sold-out detection and whitelist sorting in the credit shop to
operate on structured TextRect results rather than raw rectangles.
- Correct paradox simulator recognition to read paradox configuration
files instead of using operator names directly.
- Fix persistence and application of custom webhook notification
settings, including secure storage and usage of request headers.
- Clarify and correct account switching logic across more client types
and OCR settings, including txwy.
Enhancements:
- Refine dormitory selection into clearer phases (low mood, trust
autofill, fill remaining) and tighten handling of "not stationed"
filtering and trust thresholds.
- Tighten infrastructure filter menu interactions so "not stationed" and
"all facilities" filters apply and clear reliably.
- Optimize credit shop buying logic to better respect discount-only and
credit-reserve options with clearer stopping conditions.
- Polish ViewModel and XAML bindings for external notifications, fight
settings, startup, and copilot views for more predictable behavior and
layout.
- Improve changelog generation and dependency download scripts,
including formatting tweaks and tracking the latest MaaDeps version.
Build:
- Bump MaaDeps dependency version to v2.11.0 in the helper download
script.
- Update ImageCropper Python dependencies to MaaFw 5.10 and OpenCV 4.13.
Documentation:
- Extend multi-language integration and startup documentation with
guidance and examples for using txwy (Traditional Chinese) accounts and
login-name matching.
- Update ImageCropper usage docs to cover PC window capture via
WGC/Win32 and related configuration options.
Chores:
- Refresh multiple game data and task JSON resources, including new
stages, memory stages, tile coordinates, item indices, stage indices, UI
theme tasks, roguelike tasks, and localization resources for the latest
content.
- Update protocol and startup documentation across all supported
languages to describe txwy account formats and recommendations.
</details>
</details>
</details>
## Summary by Sourcery
通过将串口配置与命令执行分离，并对共享客户端实例的访问强制使用互斥锁保护，改进 ADB-lite 客户端管理。
改进内容：
- 添加锁定辅助工具，在执行 connect、shell、exec、push 和交互式 shell 命令之前，验证并保护对共享 ADB-lite
客户端的访问。
- 在 PlatformIO/AdbLiteIO 上引入可配置的 ADB
串口，并在客户端（重新）初始化时提供安全机制，同时在客户端创建失败时记录错误日志。
- 调整 ADB 释放逻辑，仅在存在 ADB-lite 客户端时才发出释放命令，从而减少不必要的操作。
- 连接 AdbController，将设备地址向下传递到平台 I/O 层，以在各类命令中实现 ADB-lite 客户端的一致使用。
<details>
<summary>Original summary in English</summary>
## Summary by Sourcery
Improve ADB-lite client management by separating serial configuration
from command execution and enforcing mutex-guarded access to the shared
client instance.
Enhancements:
- Add a locking helper to validate and guard access to the shared
ADB-lite client before executing connect, shell, exec, push, and
interactive shell commands.
- Introduce a configurable ADB serial on PlatformIO/AdbLiteIO with safe
client (re)initialization and error logging when client creation fails.
- Adjust ADB release logic to only issue release commands when an
ADB-lite client is present, reducing unnecessary operations.
- Wire AdbController to propagate the device address into the platform
I/O layer for consistent ADB-lite client usage across commands.
</details>
