not-bpp(macOS windowed): 输入法快捷栏覆盖游戏窗口

[pengx17]

现象

在 macOS 窗口模式下，搜狗输入法的黑色快捷栏会显示在 The Bazaar 游戏窗口之上，遮挡游戏内容。最初的玩家报告把它与开启 BPP 的「BazaarDB 数据共建」关联起来，但该因果关系尚未确认。

已获得静态截图，可确认被遮挡的是输入法自身的浮动快捷栏；截图本身不能证明它是否由某个游戏输入框的焦点持续唤起。自动窗口捕获看不到该系统浮层，因此后续判定必须依靠人工观察和版本/代码对照。

已纠正的观察

• 只在窗口模式出现；先前记录成“只在非窗口模式出现”是写反了。
• 维护者在当前本机安装的 4.6.0.t20260731.234746.dev 上进入游戏即可看到，不需要等待结算上传。
• 目前仍需严格区分“刚进入主界面、从未打开 BPP 面板”与“本次进程中曾经点过文本输入框”。

已验证的代码事实

• 当前 BPP 自己创建的文本输入只有两组：
  • History Panel 的 BazaarDB 绑定码：10 个 UI Toolkit TextField；
  • Collection Panel 的搜索框：1 个 UI Toolkit TextField。
• 这两套 UI 都是首次打开对应面板时才构造。冷启动后若从未打开 History/Collection Panel，它们尚不存在。
• 开启数据共建的设置入口只写配置、强制开启结算截图并发布上传 arm 事件；不创建文本输入，也不改窗口或焦点。
• 基础游戏的 Managers.Login.LoginFlowHotkeys.OnEnable() 会在下一帧对第一个 TMP_InputField 调用 ActivateInputField()。因此基础游戏登录流程也是必须保留的基线候选，不能只查 BPP。
• 隐藏 UI 后是否正确释放 macOS IME client 仍未通过运行时对照确认，不能仅凭代码中没有显式 Blur() 判定有无泄漏。

Input 相关 bisect 切点

按语义切点测试，比在全部提交中盲目二分更快：

1. 4.3.0 (cd0a34bb)：BPP 源码中没有任何自建 TextField，作为基线；
2. 52d571ba：首次加入 History Panel 的单个 BazaarDB 绑定码 TextField；
3. 244db552：把单输入框改为 10 个分段 TextField，并让卡片受 BazaarDB 数据共建开关控制；
4. 61c65731：首次加入 Collection 搜索 TextField 和 IME composition 监听；
5. 当前 4.6.0 dev：已观察为 bad。

每个节点都需要完全退出游戏后重启，在同一搜狗版本、同一窗口模式下，先不打开任何 BPP 面板观察主界面。若 4.3.0 仍为 bad，BPP 自建输入框可以排除，下一步转向基础游戏登录输入与 Unity/macOS IME 桥接；若 4.3.0 为 good，再按上述三个引入点缩小。

面板内对照

若冷启动主界面为 good，再分别测试：

1. 打开 History Panel，但不展开 BazaarDB 绑定区；
2. 展开绑定区但不点击输入格；
3. 点击输入格后点击非文本区域，再关闭面板；
4. 打开 Collection Panel，不展开搜索；
5. 展开搜索、点击搜索框，再关闭面板。

记录快捷栏首次出现和消失的准确一步，才能决定修 History、Collection，还是基础游戏登录输入生命周期。

期望行为

当游戏没有活动文本输入时，输入法快捷栏不应持续覆盖游戏窗口；关闭 BPP 文本输入所在面板后，应明确释放其焦点和 IME 状态。

[pengx17]

诊断模型补充

按 macOS 输入法的正常逻辑，应拆成两个独立条件：

1. 前台游戏存在活跃的可编辑输入 / IME client，负责唤起输入法快捷栏；
2. 游戏处于全屏或其他非窗口模式，负责让该系统级浮层显示在游戏之上。

因此，非窗口模式更可能是可见性/窗口层级条件，而不是最初触发；真正的触发信号仍是文本输入焦点。如果视频能确认绑定区或整个 History Panel 已关闭后快捷栏仍存在，就应优先调查 Unity 侧是否仍保留了输入焦点或 IME 状态。

最有判别力的复现顺序：

1. 非窗口模式打开 History Panel，但不点绑定码输入格；
2. 点击输入格，观察快捷栏是否出现；
3. 点击同一面板内的非文本按钮/空白区，观察是否消失；
4. 分别通过关闭按钮、Escape、热键关闭面板；
5. 不进行其他点击，切换窗口/非窗口模式并观察。

若之后需要主路径临时诊断，应在关闭当帧和下一次布局更新后记录：当前 focusedElement 类型、IsTextInputFocused() 与 GUIUtility.imeCompositionMode。若焦点为空且 IME 为 Auto 但浮层仍存在，更偏向 Unity/macOS 原生桥接问题；若仍是 TextElement/IME On，才指向 BPP/UITK 焦点清理路径。

[pengx17]

更正前面的诊断模型：显示模式信息此前写反，实际是只在窗口模式出现，不是只在全屏/非窗口模式出现。因此“全屏窗口层级导致覆盖”的推断作废。

当前改走 input 语义 bisect。最关键的第一刀是 4.3.0：该版本 BPP 还没有任何自建 TextField。如果冷启动 4.3.0 也出现，就应直接查基础游戏 LoginFlowHotkeys 在启动时调用 TMP_InputField.ActivateInputField() 的生命周期；如果不出现，再依次测试 52d571ba（History 单输入）、244db552（10 格 BazaarDB 输入）和 61c65731（Collection 搜索）。

[pengx17]

关闭结论：受控对照已排除 BazaarPlusPlus 与 BepInEx。

人工观察结果在相同 macOS 窗口模式与输入法环境下均为“仍可看到快捷栏”：

1. 当前 4.6.0 dev：出现；
2. 4.3.0（尚无后续加入的 BazaarDB/Collection TextField）：出现；
3. 从插件目录移除全部 BazaarPlusPlus*.dll：出现；
4. 进一步移除 macOS BepInEx trampoline、恢复并从 Steam 启动原版 Unity 可执行文件：仍出现。

第 4 步是决定性基线：现象在无 BPP、无 BepInEx 的原版启动路径中存在，因此不属于本仓库可修复的问题。停止继续排查，标记 wontfix。

测试后本机环境已完整恢复到原 4.6.0.t20260731.234746.dev，原 schema 18 数据库完整性为 ok，BepInEx trampoline 与 app 签名均已恢复并验证。