merge: iOS M3 PoC — PacketTunnelProvider + entitlement [tsk_nsobbj_rJdy0]

app/kernel/build-ios.sh

@@ -55,6 +55,29 @@ BUILD_TAGS="with_quic,with_utls,with_clash_api,with_gvisor"
 # BUILD_TAGS="${BUILD_TAGS},with_ech"
 # BUILD_TAGS="${BUILD_TAGS},with_wireguard"
 
+# ── M3 内存裁剪决策记录（tsk_nsobbj_rJdy0）────────────────────────────────────
+# NE 进程内存上限实测（MemoryMonitor 打点）：
+#   初始 build tags（with_quic,with_utls,with_clash_api,with_gvisor）：
+#     预估 RSS：~20-25 MB（含 Go runtime ~8MB + gVisor ~4MB + QUIC ~5MB + uTLS ~2MB + 基础~6MB）
+#     旧设备（≤ A9）15MB 上限下会触顶；新设备（≥ A12）50MB 上限下可运行
+#
+#   若真机测试出现 "NEProvider memory limit exceeded" / jetsam 杀进程，按以下顺序裁减：
+#     Step 1: 去掉 with_gvisor → 改用系统 TUN 网络栈；减约 2-4 MB
+#             取消注释下一行：
+# BUILD_TAGS="with_quic,with_utls,with_clash_api"
+#     Step 2: 去掉 with_grpc  → 若不需要 gRPC 入站；减约 4 MB
+#             取消注释下一行：
+# BUILD_TAGS="with_quic,with_utls,with_clash_api"   # 已无 gvisor，此行等效
+#     Step 3: 去掉 with_quic  → 仅在放弃 Hysteria2/QUIC 协议时考虑；减约 3 MB
+#             取消注释下一行：
+# BUILD_TAGS="with_utls,with_clash_api"
+#
+#   裁减后执行: ./build-ios.sh --force 重出 XCFramework，然后在 Xcode 中
+#   重新拖入 dist/ios/Libbox.xcframework（或更新 SPM/Pods 引用）。
+#   在此注释中记录最终选定的 build tags 及峰值 RSS（由 MemoryMonitor 汇报）。
+#
+#   当前状态：等待真机 10min 压测结果（MemoryMonitor 每 10s 打点）。
+
 # ── 幂等检查 ─────────────────────────────────────────────────────────────────
 if [[ "${FORCE}" == false && -d "${OUT_XCFW}" ]]; then
     printf '✓ %s 已存在，跳过构建（传 --force 强制重建）\n' "${OUT_XCFW}"