集成 ba-click-fx v1.2.25 特效渲染器

[CialloKing]

概要

• 集成固定版本的 ba-click-fx 渲染器，并保留 WPF/WebView2 全局输入、多显示器、环境过滤、截图兼容和设置同步能力。
• 本次将内嵌产物更新至已发布的 v1.2.25，接入相对 OKLCH 主题颜色与输入采样率公开 API。
• 原渲染器保留为 Legacy 回退；新版渲染器初始化超时、运行错误或进程故障时可恢复或回退。

颜色与输入采样

• BASpark 颜色选择器显式使用推荐的 themeColorMode: relative-oklch，主题色会在 HDR/Bloom 前保留相对色相、色度和感知明度关系。
• 输入采样率由 setInputSamplingRate() 统一处理，设置范围对齐为 0..1000 Hz，其中 0 表示不限频。
• 保留 BASpark 的 40 Hz 产品默认值，并兼容读取旧 TrailRefreshRate 注册表值。
• 主渲染器不再与 C# 重复限频；Legacy 回退路径仍保留等价的宿主限频。

渲染与透明窗口合同

• 通过 manual input 适配层映射点击、拖尾、颜色、缩放、透明度、时间倍率、采样率和暂停状态。
• 固定使用 effectBackend: webgl2 与 bloomBackend: webgl2；WebGPU HDR 不会在 BASpark 中自动启用。
• 透明桌面继续使用 browser-overlay + source-over + transparent-window，采用 visual-max、bright-core 与 0.85 Alpha 上限，并保持未知透明背景参考和非隔离合成。
• vendor、适配器和模板按固定顺序以内联资源注入，避免双重渲染。

本次验证

• 上游 npm.cmd run check：通过。
• node --test tests/Web/fx-adapter.test.mjs tests/Web/vendor-contract.test.mjs：15/15 通过。
• dotnet test BASpark.sln -c Release -p:UseSharedCompilation=false：35/35 通过。
• dotnet build src/BASpark.csproj -c Release -p:UseSharedCompilation=false --no-restore：0 警告、0 错误。
• git diff --check：通过。

上游依赖

• ba-click-fx：v1.2.25
• Commit：cbefdb849a96dae8d418547cf8cc90ab230029e3
• Vendor SHA-256：F198EEF9B29AE84D7B11B275DC0877D6BDD6C4D79035DDD200943CA8D5C3B764

[CialloKing]

已修复 Windows Runner 自动将 vendor 文件转换为 CRLF、导致 SHA-256 不一致的问题：

• 在 .gitattributes 中将 src/Web/vendor/ba-click-fx.iife.js 标记为 -text，保持审核产物的 LF 原始字节。
• 本地验证：Web 测试 11/11、xUnit 29/29 通过。
• Fork 的 GitHub Actions 已完整通过，包括 Web 测试、.NET 测试、单文件构建和产物上传：
  https://github.com/CialloKing/BASpark/actions/runs/30166581871

上游对应运行目前为 action_required，需要仓库维护者批准后才能执行：
https://github.com/DoomVoss/BASpark/actions/runs/30166522637

[CialloKing]

已同步 ba-click-fx v1.2.11，当前 PR 头提交为 49c1aaf53fb91e9498883b43856fbe550795de6e。

fork 上的同配置 PR Build Check 已通过：

• Web tests：通过
• .NET tests：通过
• win-x64 自包含单文件构建：通过
• 构建产物上传：通过

CI：https://github.com/CialloKing/BASpark/actions/runs/30280627435

上游工作流当前为 action_required：https://github.com/DoomVoss/BASpark/actions/runs/30280414219
烦请维护者批准并运行上游 PR Build Check。

[CialloKing]

已将 PR 更新到 ba-click-fx v1.2.20，当前头提交为 d1cfb15a8659c8c6e9cbe7140cf02c4a7d74328c。

fork 上的同配置 PR Build Check 已完整通过：Web 测试、.NET 测试、win-x64 自包含单文件构建和产物上传均成功：
https://github.com/CialloKing/BASpark/actions/runs/30737167534

原仓库对应运行当前为 action_required，需维护者批准：
https://github.com/DoomVoss/BASpark/actions/runs/30737114409

[CialloKing]

已将 PR 更新到 ba-click-fx v1.2.21，当前头提交为 446c82399ec4dac8446478b5beaeb8ec561279a2。

fork 上的同配置 PR Build Check 已完整通过：Web 测试、.NET 测试、win-x64 自包含单文件构建和产物上传均成功：
https://github.com/CialloKing/BASpark/actions/runs/30750623126

原仓库对应运行当前为 action_required，需维护者批准：
https://github.com/DoomVoss/BASpark/actions/runs/30750585809