ba-click-fx-desktop 0.3.2

本版本新增自定义程序规则：指定程序运行时自动停用桌面和 OBS 特效，并停止背景采集；所有匹配实例退出后，按用户当前设置恢复。

• 在控制中心 系统 → 程序规则… 开启功能，从正在运行的程序选择或浏览 EXE 添加规则。支持完整路径或文件名匹配，以及逐条启用、停用和删除；默认关闭、名单为空。
• 检测以进程存活为准：最小化、切换前台或驻留托盘仍保持停用；关闭控制中心不影响检测。
• 自动停用独立于手动暂停和特效开关。清空粒子、拖尾和按压状态，丢弃停用期间的特效输入；OBS 保持连接并输出透明画面，恢复后从新输入开始。
• 检测失败保留上次有效判断，连续两次成功扫描无匹配才恢复；按路径匹配时不会因路径查询失败而自动扩大为文件名匹配。
• 配置升级为 schema 21，旧配置自动迁移为空名单。规则属于本机设置，切换特效预设或重置特效不会清除规则。

升级前请退出 Host 和控制中心。正式资产为 Full Portable ZIP、Setup EXE 及各自的 SHA-256 校验文件；需要安装版身份能力时使用 Setup，Portable 不提供 Package Identity。Slim 保留源码构建支持，不上传预编译资产。

This release adds Program rules under System → Program rules…. Choose a running program or browse for an EXE, match its full path or file name, and enable, disable or delete individual rules. The feature defaults to off with an empty list.

While any matching process remains alive, desktop / OBS effects and background capture stop. Minimized or tray-resident programs still count, and detection continues without Control Center. OBS stays connected with transparent output. Once every matching instance exits, the latest user settings are restored; manual pause stays independent and old effects are discarded. Detection failures retain the last valid decision, and resumption requires two successful clear scans. Schema 21 stores rules locally, independently of effect presets and effect resets.

Exit Host and Control Center before upgrading. Download the Full Portable ZIP or Setup EXE with its SHA-256 file; use Setup when package identity is needed. Slim remains available as a source build.

已验证本机 Windows 10、单屏 SDR 下的程序规则、WGC 停止 / 恢复和 Spout2 透明共享输出。多显示器、HDR、Windows 11 无边框授权 / 设备拔插、OBS 应用内最终合成 / 录制和人工桌面最终像素验收仍待实机验证；自动化和 Spout 接收器回读不替代这些检查。安装相关的真实 AppX / 证书及故障现场升级 / 卸载矩阵仍沿用现有验证边界。

Local checks cover program rules, WGC stop / resume and transparent Spout2 output on Windows 10 with one SDR display. Multi-display / HDR hardware, Windows 11 borderless permission / hotplug, final OBS composition / recording and final desktop pixel inspection remain unverified. Existing real-installation AppX / certificate and failure-recovery validation limits also remain.

发布验证：Full / Slim 完整重建通过，本地 CTest 分别为 47/47 和 46/46，没有跳过或禁用测试。此前的本地快捷键注入超时未在本轮重现，测试断言保持不变。安装包版本与依赖、便携包版本与内容及启动、四个文件的 SHA-256 均已核对。

Release validation: clean Full / Slim builds passed, with 47/47 and 46/46 local tests and no skipped or disabled checks. The earlier local hotkey timeout did not recur; assertions remain unchanged. Package version, dependencies, contents, startup and SHA-256 checks passed.

发布提交 CI 40107101299：42/42 自动化测试、文档检查及 SDK 19041 / 22621 / 26100 构建全部通过。

Release commit CI passed 42/42 automated tests, documentation checks and all three Windows SDK builds. Published source: fed45dc298ec50608acb842e22c3cc8671fcc3ea.

ba-click-fx-desktop 0.3.1

此版本修复卸载前检查和失败回滚处理。

• 在任何挂起安装回滚或清理之前，只读检查本安装目录中的 Host 和控制中心；仍在运行时提示退出后重试，不自动结束进程。
• 回滚脚本缺失、无法启动、返回错误或仍残留恢复日志时，真正中止卸载，保留卸载入口、暂存文件和恢复状态，避免误报成功。
• 完整卸载先检查进程，再写卸载日志；已核实的其他目录实例不会阻止卸载，无法核实的进程路径或查询失败会阻止清理。
• 同步中英文提示与卸载说明，并独立运行进程检查回归测试。

升级前请退出 Host 和控制中心。已安装的旧版本请运行本版本 Setup 升级或修复，以更新卸载器和辅助脚本；仅替换应用 EXE 不会更新旧卸载入口。程序仍运行时无法卸载是本版本的预期行为，退出后重新运行即可。

正式资产为 Full Portable ZIP、Setup EXE 及各自的 SHA-256 校验文件。Portable 不提供 Package Identity；需要安装版身份能力时使用 Setup。

This release checks installed processes before recovery or cleanup and aborts failed recovery while retaining the uninstaller and recovery files. Exit Host and Control Center before uninstalling. Upgrade an existing installation using this version's Setup to update its uninstaller; replacing application EXEs alone does not update the old uninstall entry.

自动化构建、隔离进程与 Inno 测试不替代真实安装实例的 AppX / 证书卸载验收，以及 Windows 11 无边框授权、最终画面和故障现场安装 / 升级 / 卸载矩阵；这些仍待实机验证。
验证结果：Full / Slim 完整重建通过，版本资源为 0.3.1 / 0.3.1.0；远端 CI 42/42 自动化测试及 SDK 19041、22621、26100 构建通过。本地 Full 为 46/47、Slim 为 45/46：两者唯一未通过项均为原生快捷键输入检查，在第 234 行等待合成输入触发暂停状态超时；单项复查仍失败。此项在远端 CI 通过，相关 C++ 与测试源码相对 v0.3.0 未变化，本地失败日志完整保留，未放宽断言。不能据此确认本机快捷键环境正常或认定根因。

发布提交 CI：42 项自动化测试、文档检查和三档 SDK 构建通过。

ba-click-fx-desktop 0.3.0

0.3.0 修复安装回滚目录权限与旧卸载日志残留，提升升级、恢复和卸载流程的可靠性。

本次更新

• 修复回滚目录权限继承，恢复管理员和 SYSTEM 对子目录及文件的访问，并保留普通用户只读规则。
• 挂起升级的恢复使用当前安装器携带的脚本，避免再次执行存在旧权限缺陷的脚本。
• 成功升级后归档尚未开始资源清理的旧卸载日志，保留原始内容；已进入清理的状态仍需完成恢复，损坏材料不会被覆盖。
• 源码附带 repair-installer.cmd 和 repair-uninstall.cmd，用于已失败的 0.2.20 升级和经过完整校验的旧卸载日志恢复。
• 完善真实 NTFS 权限与身份恢复回归，隔离 CI 管理员账户和普通用户权限测试，覆盖显式/继承权限、清理中断重试和篡改拒绝。

下载

• 普通安装使用 setup-windows-x64.exe；目标机无需 Windows SDK，无需单独下载证书或 MSIX。
• 无管理员权限时使用 Portable-windows-x64.zip；便携版没有 Package Identity。
• 公开提供 Full 的安装器、便携包及各自 SHA-256 校验文件，共四项资产。
• 安装器使用目标机自签名身份机制，未使用公共代码签名；SmartScreen 可能显示“Unknown Publisher”。安装器不携带证书或私钥。

验证

• Windows SDK 28000 的 Full/Slim 完整重建通过；CTest 分别 46/46、45/45 通过，两套原生热键测试均通过。
• 发布提交 CI 的三档 SDK 19041 / 22621 / 26100 产品构建、自动测试 41/41 及 8 个文档检查通过。
• 安装器与便携包的版本、依赖、文件清单、启动边界与 SHA-256 校验通过。
• 详细验证记录。

Windows 11 包身份、无边框授权与实际画面，以及隔离环境中真实过期证书和故障现场安装/升级/卸载矩阵仍待验收；自动化结果不替代这些证据。本版本聚焦安装恢复与卸载可靠性。

ba-click-fx-desktop 0.2.20

自签名修复与恢复

• 修复相同证书名称因 UTF8String / PrintableString 编码不同而被误判的问题，仍严格核对完整 Publisher、证书指纹和 SHA-256。
• 无边框信任日志增加检查阶段和失败原因，区分签名、名称、有效期、代码签名用途和证书存储错误，并保留原始 HRESULT。
• 旧公钥缺失或证书过期时，可在核对受保护安装状态、Host、包哈希和历史签名后重新签名修复；卸载允许公钥已不存在，仍只清理属于本安装实例的材料。
• 修复或升级在替换旧包前，用独立新证书准备旧版本回滚包。新包注册失败时恢复原程序和数据，并用新签名恢复旧版本注册。准备失败保留旧注册，恢复与清理中断可重试。
• 保留两年期本机自签名、离线安装及签名后删除私钥的机制。修复需要完整旧状态、文件和匹配的未签名模板；材料不足时停止并保留证据。

日志与反馈

• 成功安装后，退出安装器会将安装日志归档至安装目录的 data，控制中心“系统 → 打开日志目录”可同时查看安装日志和运行日志。
• 问题反馈表单提示可提交安装日志、运行日志和截图。安装/卸载失败请使用错误框给出的日志完整路径。

下载与验证

• 普通用户使用 setup-windows-x64.exe；无需安装 Windows SDK，也无需单独下载证书或 MSIX。安装器没有公有代码签名，SmartScreen 可能显示“Unknown Publisher”。
• 无管理员权限时使用 Portable-windows-x64.zip；便携版没有 Package Identity。
• Full / Slim 构建、自签名恢复回归、打包检查及三档 SDK CI 已通过，公开提供 Full 的安装器、便携包和各自 SHA-256 校验文件。配置与现有用户数据保持兼容。
• 发布提交的 CI 自动测试 41/41 通过，包含原生热键测试。本地输入注入复测仍有未确认原因的偶发超时；详情见验证记录。
• 真实过期证书下的隔离安装/激活恢复矩阵，以及 Windows 11 包身份、无边框授权和实际画面仍待验收；自动测试与 WARP 不替代这些结果。本版本不将 Issue #5 的视觉现象判定为已确认解决。

ba-click-fx-desktop 0.2.19

ba-click-fx-desktop 0.2.19

补齐故障排查日志，便于用户反馈安装、捕获、颜色变化及桌面拖尾问题，同时改善控制中心刷新。

更新内容

• 输入与拖尾诊断：区分鼠标消息到达、读取成功、路由转交及模拟处理；保留失败阶段、错误码、取消来源、采样限频和拖尾起止信息。
• 窗口与呈现诊断：关联前台切换、覆盖窗口的可见/置顶/cloak 状态、上方相交候选、暂停/电源/调度原因及各显示会话的 Present 计数。会话重建使用独立编号，避免句柄复用造成错误增量。
• 有界日志：诊断默认启用，无需打开调试模式。输入活动最多每秒汇总，窗口最多每 250 ms 观察，稳定空闲时保留 10 秒心跳；正常退出刷新最后一个窗口。沿用原有轮转与单条记录预算，不记录窗口标题或截图。
• 控制中心：完整状态读取移至后台，丢弃过期结果；仅更新变化的控件，保留编辑草稿和诊断详情阅读位置。
• 维护：复用安装/卸载状态处理，拆分主显示器输出协商和有限恢复逻辑，统一特效配置字段读取。

主配置保持 schema 20，支持日志保持 schema 2，现有配置与特效预设无需迁移。
本次增强排查能力，不表示 Issue #1、#2 已修复。窗口状态和成功 Present 均不能证明 DWM 最终可见结果；
本次不新增 AMD、HDR、多屏或 26H2/OBS 实机兼容性声明。

如何反馈问题

1. 使用 0.2.19 复现，记录操作步骤、故障时间，以及 Windows 版本和显卡/驱动信息。
2. 在控制中心“系统”页点击“打开日志目录”，提供 ba-click-fx-desktop-support.log、BAFX.ControlCenter.log、仍存在的 .log.1–.log.3 备份和 BAFX.config.json。复现后先保留日志，再清理或重装。
3. 安装或卸载失败时，另附错误框中“详细安装日志”指向的文件；Host 日志无法代替安装器日志。
4. 颜色、截图缺失或特效不可见问题，附切换前后画面，并标注各阶段时间。公开上传前检查日志中的本机路径等信息。

Issue #2 可按“普通窗口激活时正常 → 点击/框选桌面后继续移动 → 再次激活普通窗口”采集，每阶段约 20 秒。
详细字段与判读方法见 运行时日志排查。

English

Adds diagnostics for user-reported installation, capture, color and desktop-trail issues, and improves Control Center refresh behavior.

• Correlates raw input delivery and failures, routing, simulation sampling, foreground/surface state, scheduling, and per-display Present counts. Session IDs prevent incorrect deltas when Windows reuses a window handle.
• Diagnostics are enabled by default. Input activity is aggregated at most once per second; windows are sampled at most every 250 ms, with 10-second idle heartbeats and a final flush on normal exit. Existing rotation and record budgets remain in effect. Window titles and screenshots are not collected.
• Full Control Center state reads run in the background with stale-result checks. Refreshes preserve editing and diagnostic scroll position. Installer state handling, output negotiation/recovery and configuration parsing share existing implementations.

Configuration schema 20, log schema 2 and effects profiles remain compatible. Issues #1 and #2 are not declared fixed. Successful Present calls and window state do not prove final visible DWM pixels. This release adds no new AMD, HDR, multi-display or 26H2/OBS hardware acceptance claims.

To report a problem, reproduce on 0.2.19 and note the steps and time. Use System → Open log folder to collect both Host and Control Center logs, their remaining rotated backups, and BAFX.config.json. Installation/uninstallation failures require the separate detailed log referenced by the error dialog. For visual issues, include before/after images or a recording. Check local paths and other personal information before posting logs publicly.

验证 / Validation

• Windows SDK 10.0.28000.0：Full/Slim Release 干净构建通过，无编译器警告或错误；CTest Full 46/46、Slim 45/45 全部通过。
• 文档、便携包清单/版本/哈希/PE 依赖、Host 与控制中心启动检查通过；安装器版本、PE 依赖及未签名身份模板检查通过。
• 从实际便携 ZIP 解包运行演示，确认 0.2.19 版本、新增诊断事件、模拟计数、Present 及正常退出末次刷新。未发现重复字段、超限记录或诊断格式化失败。
• 安装器自动验证不等同于反馈者机器上的安装/升级/卸载验收；演示关闭 Raw Input，不构成 Issue #1/#2 或最终可见像素的实机验收。

Full/Slim clean Release builds passed on SDK 10.0.28000.0 without compiler warnings or errors; CTest passed 46/46 and 45/45. Documentation, Portable contents/version/hashes/dependencies/startup, and installer version/dependencies/unsigned identity-template checks passed. A demo run from the actual Portable ZIP verified the new diagnostics and final flush. Installer automation and the demo do not establish affected-machine installation/upgrade/uninstallation or Issue #1/#2 acceptance.

下载 / Downloads

Full 版安装器、便携 ZIP 及各自的 SHA-256 校验文件。Slim 完成构建与测试，不上传预编译资产。

Full installer and Portable ZIP, each with a SHA-256 sidecar. Slim is built and tested without prebuilt release assets.

ba-click-fx-desktop 0.2.18

ba-click-fx-desktop 0.2.18

改善显示状态刷新，并整理 Host、控制中心与配置模块，降低后续维护成本。

更新内容

• 显示页刷新：状态查询和 JSON 解析移到单个后台线程，合并重复请求并丢弃过期结果，减少界面线程等待。仅在已连接且页面可见、未最小化时查询；完整刷新保留 Host 版本与配置代次校验，配置写入等操作仍采用原有同步流程。
• 多显示器维护：拆出副显示器捕获、恢复和渲染逻辑，主副显示器复用视觉配置映射；显示快照与输出诊断各自独立，保留渲染线程状态所有权及发布顺序。
• 控件与配置：统一滑块绑定和页面控件描述，集中注册 41 个特效配置字段，复用允许字段、补丁分派和 JSON 输出，保留参数联动及历史迁移规则。
• 恢复状态：集中维护 WGC 重试身份和待处理状态，主副显示器共用有限输出重试预算并保留溢出保护。
• 开发与验证：应用和测试复用构建目标，拆出启动选项和性能样本转换；CI 增加自动测试与文档检查，补齐中英文开发指南，整理当前路线图并归档历史记录。

主配置保持 schema 20，IPC 命令与特效预设格式保持兼容，现有配置无需迁移。本次发布不新增多屏、HDR 或 26H2/OBS 录屏实机兼容性声明。

验证范围

• Windows SDK 10.0.28000.0：Full 与 Slim Release 干净构建通过，无编译警告或错误。
• Full CTest 46/46、Slim CTest 45/45 通过，包括后台请求合并、过期结果丢弃和 Host 恢复状态检查。
• 文档检查、便携包文件清单、版本、PE 依赖与 Host/控制中心启动验证通过；安装器版本、未签名身份模板和 PE 依赖检查通过。

English

Improves display-status refresh and separates Host, Control Center and configuration responsibilities to reduce maintenance costs.

• Display-state IPC and JSON parsing run on one background worker. Duplicate requests are coalesced and stale results discarded. Polling runs only while connected with the display page visible and not minimized. Full refreshes retain Host version and configuration-generation checks; writes and other actions remain synchronous.
• Secondary-display capture, recovery and rendering have dedicated modules. Displays share visual configuration mapping and finite retry budgets, while render-thread ownership and snapshot publication order remain unchanged.
• Slider bindings and page control descriptors are centralized. A registry of 41 effects fields drives allowed keys, patch dispatch and JSON output while preserving coupled parameters and historical migration rules.
• WGC retry identity, pending state and overflow handling are grouped. Applications and tests share build targets; startup options and performance sample conversion have separate modules.
• CI adds automated tests and documentation checks. Bilingual development guides and the current roadmap have been updated, with historical records archived.

Configuration schema 20, IPC commands and effects profiles remain compatible. This release adds no new hardware acceptance claims for multiple displays, HDR or 26H2/OBS recording.

Full and Slim clean Release builds passed with Windows SDK 10.0.28000.0, without compiler warnings or errors. CTest passed 46/46 for Full and 45/45 for Slim. Documentation, Portable ZIP contents/version/PE dependencies and Host/Control Center startup checks passed. Installer version, unsigned identity template and PE dependency checks also passed.

发布资产 / Downloads

Full 版安装器、便携 ZIP 及各自的 SHA-256 校验文件。Slim 完成构建与测试，不上传预编译资产。

Full installer and Portable ZIP, each with a SHA-256 sidecar. Slim is built and tested without prebuilt release assets.

ba-click-fx-desktop 0.2.17

ba-click-fx-desktop 0.2.17

完善日志入口、操作追踪和运行诊断，让连接失败、配置变更、卡顿与退出问题更容易定位。

更新内容

• 日志目录与清理：系统页可直接打开日志目录。清理操作汇总控制中心和 Host 的结果；Host 未连接时仍可清理控制中心日志。
• 日志可靠性：记录写入、轮转、锁等待和维护失败，恢复后补记状态；跨进程协调日志操作，限制文件和单条记录大小，降低备份维护频率。
• 操作追踪：控制中心记录连接变化、操作结果和 IPC 耗时，合并重复轮询错误。Host 记录 IPC/快捷键来源、配置前后值、代次及失败原因；超大内容不会挤掉结果与错误信息。
• 退出诊断：记录退出原因、退出码、运行时长和呈现帧数，区分退出请求、故障与最终退出。
• 性能与资源：十秒窗口记录最慢帧的同帧上下文、日志各阶段耗时，以及工作集、私有提交内存和进程句柄数。空闲窗口仍采样，不逐帧写盘。

主配置保持 schema 20，支持日志保持 schema 2，现有配置与特效预设无需迁移。诊断中的 API 经过时间不等同于 GPU 执行或物理上屏延迟；本次更新不新增渲染性能或外部录屏兼容性声明。

验证范围

• Windows SDK 10.0.28000.0：Full 与 Slim Release 干净构建通过，未出现编译警告或错误。
• Full CTest 46/46、Slim CTest 45/45 通过，包含日志跨进程协调和外壳导航契约检查。
• 文档检查及便携包文件清单、版本、PE 依赖、Host 与控制中心启动验证通过。

English

Improves log access and diagnostics for connection failures, configuration changes, slow frames, and shutdowns.

• Open the log folder from the System page. Log cleanup combines Control Center and Host results and remains available for Control Center while disconnected.
• Track log write, rotation, lock, and maintenance failures and recovery. Coordinate access across processes, bound file and record sizes, and reduce backup maintenance frequency.
• Record connection changes, operation outcomes, IPC duration, configuration sources, before/after values, generations, and errors. Repeated polling failures are combined; oversized details preserve outcome metadata.
• Record shutdown reasons, exit codes, uptime, and rendered frames, with separate events for shutdown intent, failure, and final exit.
• Retain a coherent slowest-frame snapshot per reporting window and sample process memory, handles, and diagnostic-stage durations every ten seconds, including idle windows.

Configuration schema 20 and log schema 2 remain unchanged. API elapsed times do not measure GPU execution or physical display latency. This release makes no new rendering-performance or external-recording compatibility claims.

Full and Slim clean Release builds passed with Windows SDK 10.0.28000.0, without compiler warnings or errors. CTest passed 46/46 for Full and 45/45 for Slim, including cross-process logging and shell-navigation contracts. Documentation and Portable ZIP checks passed for contents, versions, PE dependencies, and Host/Control Center startup.

发布资产 / Downloads

提供 Full 版安装器、便携 ZIP 及各自的 SHA-256 校验文件。Slim 完成构建与测试，不上传预编译资产。

Full installer and Portable ZIP, each with a SHA-256 sidecar. Slim is built and tested but has no prebuilt release assets.

ba-click-fx-desktop 0.2.16

修复录屏兼容构建、诊断日志及无边框包身份读取。

修复内容

• 按选中 Windows SDK 的实际 C++/WinRT 编译能力探测 WindowId 及其集合接口，SDK 28000 的 Full、Slim 构建均包含完整 Session-local 排除代码。
• 区分编译支持、运行时接口探测、配置读回和帧版本确认；失败日志保留具体阶段与 HRESULT，回退日志保留 Session-local 失败证据。
• 使用 PACKAGE_INFORMATION_FULL 读取发布者，并从 Kernel32、KernelBase 依次解析 GetCurrentPackagePath2，避免阻断有效安装身份的无边框授权。

验证

• Windows SDK 10.0.28000.0：Full CTest 45/45，Slim CTest 44/44。
• Full 安装器、便携包和 SHA-256 校验文件已通过包验证。
• 26H2/OBS 实机录制效果仍需目标系统验证；本地 Windows 10 19045 构建不能替代该验收。

English

Fixes recording-compatible builds, diagnostics, and packaged identity reads.

• Probes the selected Windows SDK's C++/WinRT WindowId and collection support, keeping the complete Session-local exclusion implementation in SDK 28000 Full and Slim builds.
• Separates compile support, runtime interface probing, configuration readback, and frame iteration confirmation, while preserving failed Session-local evidence during fallback.
• Reads publisher data with PACKAGE_INFORMATION_FULL and resolves GetCurrentPackagePath2 from Kernel32 and KernelBase so valid installed identities can reach borderless capture authorization.

Full and Slim were validated with Windows SDK 10.0.28000.0; the Full suite passed 45/45 and Slim 44/44. Real 26H2/OBS recording remains unverified on target hardware.

ba-click-fx-desktop 0.2.15

ba-click-fx-desktop 0.2.15

使用更新后的 Windows SDK 重新构建的维护版本。

构建更新

• 发行包使用 Visual Studio 2026 与 Windows SDK 10.0.28000.0（补丁版 28000.2526）构建。
• Full 与 Slim 已通过新 SDK 下的 C++/WinRT 编译探测、Release 编译和链接验证。
• Full 的 45 项、Slim 的 44 项现有测试全部通过。

使用与兼容性

录屏兼容模式继续标为“测试，仅 Windows 11 26H2 及以后”，最低 OS build 为 26300。
程序仍会检查实际 WGC Session 能力、窗口排除列表与 configuration iteration，并在不可用时回退。
26H2／OBS 的实机录制组合仍待验收；更新构建 SDK 不代表该组合已验证通过。

本次更新不改变捕获或渲染逻辑，主配置 schema 20、IPC 和特效预设格式保持不变。
用户无需安装开发 SDK；请使用完整安装器或便携包，同时更新 Host 与控制中心。

English

A maintenance release rebuilt with Visual Studio 2026 and Windows SDK 10.0.28000.0 (servicing version 28000.2526).

• Full and Slim pass C++/WinRT compilation probes, Release builds and all existing tests: 45/45 for Full and 44/44 for Slim.
• Recording compatibility remains a test mode for Windows 11 26H2 and later (minimum OS build 26300), with runtime WGC capability checks and fallback behavior.
• The 26H2/OBS recording combination still requires validation on a target system. The SDK rebuild does not establish recording compatibility.
• Capture and rendering logic, configuration schema 20, IPC and effect profile format are unchanged. No development SDK is required on users' computers; update Host and Control Center together.

发布资产

提供 Full 版安装器、便携 ZIP 及各自的 SHA-256 校验文件。Slim 保留源码构建与本地验证，不上传预编译资产。

ba-click-fx-desktop 0.2.14

ba-click-fx-desktop 0.2.14

录屏兼容测试模式调整为 Windows 11 26H2 及以后，最低 OS build 从 28000 降为 26300。

主要更新

• 控制中心的中英文模式名称、版本不足提示和版本无法确认提示同步更新为 26H2。
• Host 与控制中心共用 build 26300 的最低门槛；原已允许的 build 28000 及更高版本继续可选。
• Host 拒绝信息直接使用统一的最低版本常量，诊断日志同步记录新门槛。
• 更新使用文档和验收说明，明确版本门槛与实际 WGC 能力探测的区别。

使用与兼容性

在控制中心“基础设置”的渲染模式中选择“录屏兼容（测试，仅 Windows 11 26H2 及以后）”。
版本低于 build 26300 或无法确认时不会应用该选择；旧系统启动时发现保存的测试模式仍回退到浅色背景优化。

允许选择后，程序继续探测实际 WGC Session 的窗口排除接口，并检查排除列表与 configuration iteration。
Session-local 排除失败时依次回退到全局窗口排除和 FX-only；全局排除路径可能使外部录屏看不到特效。
26H2／OBS 的实机录制组合尚未完成验收，模式继续标为测试，不代表所有录屏器均可正常录制。

默认背景感知模式、主配置 schema 20、IPC 和特效预设格式保持不变。更新时请使用完整安装器或便携包，保持 Host 与控制中心版本一致。

English

Recording compatibility testing now targets Windows 11 26H2 and later, lowering the minimum OS build from 28000 to 26300.

• Updated both Chinese and English mode labels, unsupported-version messages and diagnostics.
• Host and Control Center share the new build threshold. Previously eligible builds 28000 and above remain selectable.
• Actual WGC session capabilities are still checked at runtime. Session-local exclusion falls back to global window exclusion, then FX-only if needed.
• Global exclusion may hide effects from external recording. The 26H2/OBS combination still requires testing on a target system; this remains a test mode.
• The default background-aware mode, configuration schema 20, IPC and effect profile format are unchanged. Update Host and Control Center together.

发布资产

提供 Full 版安装器、便携 ZIP 及各自的 SHA-256 校验文件。Slim 保留源码构建与本地验证，不上传预编译资产。