原生数据面 macOS 冒烟通过（P0 闸）+ 修 stasel WebRTC macOS 切片缺头

- P0 闸达成：新增 macOS 独立单测 target CommilitiaDropMacTests（把 LibWebRtcEngine.swift 直接编入测试 bundle，无宿主 app、同模块无需 @testable），跑与 iOS 同一份环回端到端测试——两个引擎同进程交叉连，20MB 伪随机源逐字节比对。macOS 上线协议（offer/answer/ICE + 分片 / 背压 / ack / finalize）在 libwebrtc 闭环，证实原生数据面在 Mac 可用（≈3s 通过）。是 Mac 复用 iOS 引擎的技术前提
- 修 stasel/WebRTC 149.0.0 原生 macOS 切片缺头：macos-x86_64_arm64 随包只带 umbrella WebRTC.h、缺全部 80+ 子头（ios / maccatalyst / simulator 三切片各 93 头齐全），umbrella #import 的子头找不到致 import WebRTC 在原生 macOS 编不过；切片二进制本身有效（arm64+x86_64 dylib）。scripts/patch-macos-webrtc-headers.sh 从同包 ios-arm64 切片补齐（子头为平台守卫 ObjC 声明、跨切片同构；排除 3 个 UIKit 绑定视图头 + 从 umbrella 去掉本包缺失的 RTCMTLNSVideoView.h）。幂等，须 SPM resolve 之后、build 之前跑
- LibWebRtcEngineTests.swift 导入条件化：仅 #if os(iOS) 时 @testable import CommilitiaDrop（macOS 侧引擎编在同模块、无需 import），iOS 与 macOS 共用同一份测试文件验证同构闭环
- Justfile：mac-prep（xcodegen + -resolvePackageDependencies + 补头脚本）→ mac-build / mac-test 均依赖之；build / test 加 -disableAutomaticPackageResolution 防 build 期再解析冲掉补丁
- 验证：just mac-test 从残缺态复现全绿——resolve + 补头（1→90）+ 编译 + 环回测试通过

Justfile

@@ -98,12 +98,24 @@ ios-sim-build:
     cd ios/CDrop && xcodegen generate
     cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDrop -sdk iphonesimulator -destination 'generic/platform=iOS Simulator' -derivedDataPath build/DD build
 
-# macOS 原生客户端本地编译验证（ad-hoc 签名，无需 Apple 账号）：xcodegen + xcodebuild -sdk macosx。
-# 当前为脚手架（MacApp/ 导航骨架 + 菜单栏占位）；引擎 / 复用视图 / 桌面功能随后续阶段并入。
-# 产物 build/DD-mac/Build/Products/Debug/CommilitiaDropMac.app（用于本地打开自测）。
-mac-build:
+# 内部：生成工程 + 解析 SPM 依赖 + 补齐 macOS WebRTC 头。stasel/WebRTC 149 的原生 macOS 切片随包
+# 只带 umbrella、缺全部子头（`import WebRTC` 编不过；二进制有效），须从 ios 切片补齐，见
+# scripts/patch-macos-webrtc-headers.sh。mac-build / mac-test 共用；须 resolve 之后 build 之前跑。
+mac-prep:
     cd ios/CDrop && xcodegen generate
-    cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDropMac -sdk macosx -destination 'platform=macOS' -derivedDataPath build/DD-mac build
+    cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDropMac -sdk macosx -derivedDataPath build/DD-mac -resolvePackageDependencies
+    bash ios/CDrop/scripts/patch-macos-webrtc-headers.sh ios/CDrop/build/DD-mac
+
+# macOS 原生客户端本地编译（ad-hoc 签名，无需 Apple 账号）。当前为脚手架（MacApp/ 导航骨架 +
+# 菜单栏占位）；引擎 / 复用视图 / 桌面功能随后续阶段并入。产物 build/DD-mac/Build/Products/Debug/
+# CommilitiaDropMac.app（本地打开自测）。
+mac-build: mac-prep
+    cd ios/CDrop && xcodebuild -project CommilitiaDrop.xcodeproj -scheme CommilitiaDropMac -sdk macosx -destination 'platform=macOS' -derivedDataPath build/DD-mac -disableAutomaticPackageResolution build
+
+# 原生数据面 macOS 冒烟（P0 闸）：跑 CommilitiaDropMacTests 环回端到端测试——两个 LibWebRtcEngine
+# 同进程交叉连，20MB 逐字节验证 libwebrtc macOS 切片上线协议闭环。证实原生数据面在 Mac 可用。
+mac-test: mac-prep
+    cd ios/CDrop && xcodebuild test -project CommilitiaDrop.xcodeproj -scheme CommilitiaDropMac -sdk macosx -destination 'platform=macOS' -derivedDataPath build/DD-mac -disableAutomaticPackageResolution
 
 # 真机构建 + 装机（自动 provisioning，经 ASC API Key）。前置：付费 ADP；App ID 的 App Groups /
 # Push 能力（门户建好或自动建）；根目录 gitignore 的 .env 配齐：CDROP_TEAM_ID / CDROP_ASC_KEY_PATH