原生数据面协议层：桌面 engine 进度节流 / pion 日志 + iOS 数据面路由

- 桌面 engine（pion 数据面，承 ab57afd 之后的精修）：
  - 新增 logging.go——把 pion 内部日志路由到宿主 OnLog（真机无 stderr，连接失败无从查）；仅 ice/mdns 作用域放 Debug、余 Info+、Trace 丢弃，按 session 聚合
  - wire.go / session.go / engine.go：进度回调 ~10Hz 节流（progressEmitThrottleMs，高吞吐下每片一回调打满宿主主线程；终态由 emitProgressNow 强发最终值），与 web store push 同量级；engine_test.go 跟进
- web 数据面路由：p2p.ts 翻 IOS_NATIVE=true（iOS 走原生 libwebrtc 引擎）+ 新增 p2pIos.ts（iOS p2p 后端）+ p2pNative.ts / net/ios.ts 跟进
- 数据面设计文档 NATIVE-TRANSFER.md：U1（gomobile+pion）真机证伪 → 翻案 U2（libwebrtc）的依据与实测证据（§7/§8）
- 线协议三端一致（cdrop-file ordered / meta+chunk(64KB)+done+ack / 16MB-4MB 水位 / ack 追平完成），桌面 pion ↔ iOS libwebrtc ↔ web JS 互通

desktop/engine/session.go

@@ -35,9 +35,10 @@ type session struct {
 	fileSize int64
 
 	// 计数器（跨 goroutine：发送循环 / pion 回调）。
-	bytesSent atomic.Int64 // 已塞进本地 SCTP 缓冲的字节
-	received  atomic.Int64 // 接收端已写盘字节
-	acked     atomic.Int64 // 接收端经 ack 回传的已收字节（发送端进度/完成依据）
+	bytesSent  atomic.Int64 // 已塞进本地 SCTP 缓冲的字节
+	received   atomic.Int64 // 接收端已写盘字节
+	acked      atomic.Int64 // 接收端经 ack 回传的已收字节（发送端进度/完成依据）
+	lastEmitNs atomic.Int64 // emitProgress 节流时间戳（纳秒）：限频进度回调，护宿主主线程
 
 	// 接收端落盘
 	out     *os.File
@@ -67,8 +68,15 @@ func newSession(e *Engine, id, peer, role string, pc *webrtc.PeerConnection) *se
 // 接收窗顶到 4MB（远高于 WebKit 写死的 256KB），是吞吐专项的核心——使本端作接收端时
 // `吞吐 ≈ rwnd/RTT` 的天花板抬高一个量级。pion 默认用真实 IP 的 host 候选（不做 mDNS
 // 混淆），故同内网天然落到 host↔host 直连，避开 mac WKWebView 的 srflx 退化。
-func newPeerConnection(iceServersJSON string) (*webrtc.PeerConnection, error) {
+func newPeerConnection(sessionID, iceServersJSON string, log func(string)) (*webrtc.PeerConnection, error) {
 	se := webrtc.SettingEngine{}
+	// 把 pion 内部日志接到宿主 OnLog（真机诊断「为何 ICE 连不上」：候选对检查 / sendto 权限错误等），
+	// 带上 sessionID 使宿主可按 session 聚合 / 整体复制。
+	se.LoggerFactory = emitLoggerFactory{emit: log, sessionID: sessionID}
+	// 候选收集用默认（全接口、双栈 IPv4+IPv6、不排除链路本地）：桌面 pion 与 iOS WebKit 的原始互通
+	// 实测可同内网 host↔host 直连（双 WiFi 网常经 IPv6）。早先为治 pion-on-iOS 加的接口 / 链路本地 /
+	// IPv4-only 过滤纯属 iOS 定向，iOS 已退回 JS、不再用本引擎，那些过滤反令桌面侧 IPv6 host 对被裁掉、
+	// 退中继（重大回归），故移除。
 	se.SetSCTPMaxReceiveBufferSize(sctpReceiveBuffer)
 	// 解析对端的 mDNS（.local）候选。iOS / Safari 出于隐私只播 mDNS host 候选；pion 默认不
 	// 解析，便无法与之成 host↔host、退而走 srflx/relay 慢路径（实测 mac→iOS 落到 relay↔srflx、
@@ -187,6 +195,7 @@ func (s *session) streamFile() {
 	_ = s.dc.SendText(string(doneB))
 	s.waitDrained()
 	s.waitAck(s.fileSize)
+	s.emitProgressNow()
 	s.setState("completed")
 }
 
@@ -288,6 +297,7 @@ func (s *session) finalize() {
 		s.out = nil
 		s.eng.ev.OnSaved(s.id, final)
 	}
+	s.emitProgressNow()
 	s.setState("completed")
 }
 
@@ -352,21 +362,42 @@ func (s *session) emitSignal(toPeer string, sdp *webrtc.SessionDescription, cand
 
 // --- 进度 / 状态 / 收尾 ---
 
-func (s *session) emitProgress() {
-	var b int64
+// progressBytes 计算当前应上报的已传字节：发送端优先用接收端 ack 追平值（无 ack 时回退本地
+// 已交付估计），接收端用已写盘字节。
+func (s *session) progressBytes() int64 {
 	if s.role == roleSender {
 		if a := s.acked.Load(); a > 0 {
-			b = min(s.fileSize, a)
-		} else {
-			b = s.bytesSent.Load() - int64(s.dc.BufferedAmount())
-			if b < 0 {
-				b = 0
-			}
+			return min(s.fileSize, a)
 		}
-	} else {
-		b = s.received.Load()
+		b := s.bytesSent.Load() - int64(s.dc.BufferedAmount())
+		if b < 0 {
+			return 0
+		}
+		return b
 	}
-	s.eng.ev.OnProgress(s.id, b)
+	return s.received.Load()
+}
+
+// emitProgress 节流上报：按 progressEmitThrottleMs 限频（~10Hz），避免高吞吐下每片一回调把宿主
+// 主线程打满（iOS 上经桥 evaluateJavaScript 数百次/秒 → UI 无响应）。CompareAndSwap 保证多 goroutine
+// （发送循环 / 接收 OnMessage / ack）并发下单发。终态的最终值由 emitProgressNow 强发，不被节流吞掉。
+func (s *session) emitProgress() {
+	now := time.Now().UnixNano()
+	last := s.lastEmitNs.Load()
+	if now-last < int64(progressEmitThrottleMs)*int64(time.Millisecond) {
+		return
+	}
+	if !s.lastEmitNs.CompareAndSwap(last, now) {
+		return
+	}
+	s.eng.ev.OnProgress(s.id, s.progressBytes())
+}
+
+// emitProgressNow 无视节流强发一次：收尾时确保最终字节数到达宿主（否则末次进度可能被节流吞掉，
+// 进度文案停在 99%）。
+func (s *session) emitProgressNow() {
+	s.lastEmitNs.Store(time.Now().UnixNano())
+	s.eng.ev.OnProgress(s.id, s.progressBytes())
 }
 
 // waitBufferLow 等本地 SCTP 缓冲落到 threshold 以下：靠 OnBufferedAmountLow 事件唤醒，