chore(flow): expand host-return whitelist and add a DEBUG host bundle probe

- Rebuild the return-to-host whitelist from the CN/US top charts plus Apple system apps; drop the canOpenURL pre-check (LSApplicationQueriesSchemes is capped at 50) and let open() report failure. - Never record an OSG bundle id as the host to return to. - DEBUG only: probe the host bundle id through the keyboard arbiter callback and surface the log on a Home test card. Release builds keep the previous behaviour (no host identification).
2026-10-20 20:06:36 +02:00
parent d540a58594
commit ad79c2ea13
16 changed files with 807 additions and 327 deletions
@@ -0,0 +1,68 @@
+// HostBundleProbe.swift
+// OSGKeyboard · Keyboard Extension
+//
+// 识别当前宿主 App 的 bundle ID，供冷启动跳转主 App 后自动跳回。
+// 目前依赖仅在 DEBUG 编译的私有 arbiter 探针（`OSGHostArbiterProbe`），
+// Release 构建里识别结果恒为 nil，行为与接入前一致。
+
+import Foundation
+import OSGKeyboardShared
+
+enum HostAppIdentity {
+    /// 最近一次识别到的宿主；识别不到、或宿主是 OSG 自己时为 nil。
+    static var currentBundleId: String? {
+        #if DEBUG
+        guard let bundleId = OSGHostArbiterProbe.lastCapturedBundleId,
+              !HostAppURLRegistry.isOwnBundleId(bundleId) else {
+            return nil
+        }
+        return bundleId
+        #else
+        return nil
+        #endif
+    }
+
+    /// 跳转主 App（`startflow`）前调用：把当前宿主写进 App Group，主 App 就绪后据此跳回。
+    /// 识别不到时写 nil，清掉上一次残留，避免跳回错误的 App。
+    static func publishReturnTarget() {
+        let bundleId = currentBundleId
+        FlowSessionBridge.setPendingHostBundleId(bundleId)
+        #if DEBUG
+        let returnable = HostAppURLRegistry.lookup(bundleId: bundleId) != nil
+        HostBundleProbeLog.append(
+            event: "startflow",
+            bundleId: bundleId,
+            detail: returnable ? "returnable" : "no-return-url"
+        )
+        #endif
+    }
+
+    /// 键盘收起时作废识别结果，下次弹出由新回调重新填充。
+    static func invalidate() {
+        #if DEBUG
+        OSGHostArbiterProbe.invalidateCapturedBundleId()
+        #endif
+    }
+}
+
+#if DEBUG
+/// 临时调试：把探针回调写进 App Group，主 App 首页的测试卡片读取展示。
+enum HostBundleProbe {
+    /// 只需安装一次；回调可能来自非主线程，闭包必须是 nonisolated。
+    static func installLogging() {
+        OSGHostArbiterProbe.setCaptureHandler { @Sendable bundleId, detail in
+            HostBundleProbeLog.append(event: "arbiter", bundleId: bundleId, detail: detail)
+        }
+    }
+
+    /// 键盘弹出时记一条标记，再主动触发回调，便于把记录和每次弹出对应起来。
+    static func recordPresentationAndPing() {
+        HostBundleProbeLog.append(
+            event: "appear",
+            bundleId: nil,
+            detail: OSGHostArbiterProbe.isInstalled ? "hook=installed" : "hook=missing"
+        )
+        OSGHostArbiterProbe.pingArbiter()
+    }
+}
+#endif