iOS 计划完成：流式发送 / 后台续传 / APNs / Share Extension / 控制中心控件 + 真机分发预备

- 发送端流式（R-iOS-4）：新增 FileSource 抽象（web/src/features/transfer/source.ts），iOS 经 HTTP Range 惰性拉取（原生 WKURLSchemeHandler 认 Range 头 seek 回 206），整文件不进 WebView 内存；web/桌面经 fileSource 包装字节不变。p2p/relay/transfer 改吃 FileSource
- 后台续传：iOS 26 BGContinuedProcessingTask（BackgroundTaskManager + AppDelegate 注册 + BGTaskSchedulerPermittedIdentifiers），引擎传输进度驱动系统进度 UI
- APNs：后端 internal/apns（ES256 .p8 JWT + HTTP/2，仿 internal/push）+ push_subscriptions.platform 列 + POST /api/push/apns/register + transfer/message 未投递分支分流；原生 PushRegistry 授权 + 设备令牌经引擎桥 registerPush 上报；aps-environment + remote-notification 后台模式
- Share Extension：CDropShare appex 抓文件 → App Group 收件箱 → cdrop://share 深链唤主程序选设备发送（只交接、不跑引擎）
- 控制中心剪贴板两控件：CDropWidgets widgetkit appex（ControlWidget + AppIntent + 纯原生 ClipboardClient REST）；用专用 broker 设备会话（主程序经引擎 provisionWidgetSession 代铸独立 device_id 会话存 App Group，控件自刷不与引擎抢 refresh 轮换）
- 真机分发预备：committed 签名改 ad-hoc 使模拟器 entitlement 生效；真机手动签名 scaffold（Signing.xcconfig 仅 device SDK 套 Manual + gitignore 的 Local.xcconfig 填 Team/profile）+ just ios-device / ios-devices 全 CLI 装机；包名改 net.commilitia.Commilitia-Drop（含 .share/.widgets，BG task 前缀同改）；REALDEVICE.md 重写为门户 + CLI 装机手册
- I18n.swift 移 Shared/ 供三 target 共用；i18n 加 ios.bg/share/control.* 键
- ultracode 多 agent 审查修复（0 HIGH，2 MED + 7 LOW）：分享 send 后留收件箱致重发→move 私有暂存；WidgetSession 锁屏文件保护→UntilFirstUserAuthentication；outgoing/安全作用域登出释放；控件 device_id 登出清理；并发控件 refresh CAS-before-clear；APNs 读 reason + prune bad token + bust 过期 JWT；APNSEnv 大小写归一；Share-ext completeRequest 挪进 open 回调

ios/CDrop/project.yml

@@ -7,19 +7,37 @@ options:
 settings:
   base:
     SWIFT_VERSION: "5.0"
-    CODE_SIGNING_ALLOWED: "NO"
+    # 模拟器用 ad-hoc 签名（身份 "-"，无需 Apple 账号），使 App Group / Push 等 entitlement 在
+    # 模拟器实际生效（否则共享容器不创建、远程通知注册失败）。真机签名须付费 ADP 配
+    # team / provisioning profile（账号门控，见 REALDEVICE.md）。
+    CODE_SIGN_IDENTITY: "-"
     CODE_SIGNING_REQUIRED: "NO"
+    CODE_SIGNING_ALLOWED: "YES"
 targets:
   CDrop:
     type: application
     platform: iOS
     deploymentTarget: "26.0"
+    configFiles:
+      Debug: Signing.xcconfig
+      Release: Signing.xcconfig
     sources:
       - path: Sources
+      - path: Shared
+    dependencies:
+      - target: CDropShare
+        embed: true
+      - target: CDropWidgets
+        embed: true
     info:
       path: Sources/Info.plist
       properties:
         CFBundleDisplayName: Commilitia Drop
+        # cdrop:// URL scheme：Share Extension 交接后经 cdrop://share 深链唤起主 app 选设备发送。
+        CFBundleURLTypes:
+          - CFBundleURLName: net.commilitia.Commilitia-Drop
+            CFBundleURLSchemes:
+              - cdrop
         # 声明支持的语言，使系统控件（EditButton 的「编辑」、滑动删除的「删除」等系统字符
         # 串）跟随设备语言本地化，而非永远英文。开发区域设简体。
         CFBundleDevelopmentRegion: zh-Hans
@@ -28,6 +46,13 @@ targets:
           - zh-Hant
           - en
         UILaunchScreen: {}
+        # 后台续传：BGContinuedProcessingTask 的通配标识符须在此声明，系统才允许注册 / 提交
+        # （见 BackgroundTaskManager）。默认资源（CPU + 网络）无需额外 entitlement。
+        BGTaskSchedulerPermittedIdentifiers:
+          - "net.commilitia.Commilitia-Drop.transfer.*"
+        # 远程通知后台模式：APNs 推送送达 / 后台处理（如「收到文件」通知）。
+        UIBackgroundModes:
+          - remote-notification
         # 让接收文件落地的 Documents 目录在 Files app「我的 iPhone / Commilitia Drop」下
         # 可见、可就地打开（收到的文件有处可开、可被其他 app 取用）。
         UIFileSharingEnabled: true
@@ -40,9 +65,70 @@ targets:
         NSCameraUsageDescription: "Commilitia Drop 使用相机扫描二维码登录新设备。"
     settings:
       base:
-        PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.cdrop
+        PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop
         TARGETED_DEVICE_FAMILY: "1,2"
         ASSETCATALOG_COMPILER_APPICON_NAME: AppIcon
+        # APNs 推送的 aps-environment entitlement（见 CDrop.entitlements）。模拟器取令牌可用；
+        # 真机签名须付费 ADP 开 Push 能力（账号门控）。
+        CODE_SIGN_ENTITLEMENTS: CDrop.entitlements
+        # 真机：用门户 profile 手动签名（仅 device SDK；模拟器走 base ad-hoc）。profile 名取自
+        # gitignore 的 Local.xcconfig（见 Signing.xcconfig / REALDEVICE.md）。
+        "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]": "$(CDROP_PROFILE_APP)"
+  # Share Extension：抓分享文件 → App Group 收件箱 → 深链主 app 选设备发送（只交接、不跑引擎，
+  # 见 PLAN §I5）。只编 ShareViewController + 共享的 AppGroup，绝不拉主 app Sources（避超 120MB）。
+  CDropShare:
+    type: app-extension
+    platform: iOS
+    deploymentTarget: "26.0"
+    configFiles:
+      Debug: Signing.xcconfig
+      Release: Signing.xcconfig
+    sources:
+      - path: Share
+      - path: Shared
+    info:
+      path: Share/Info.plist
+      properties:
+        CFBundleDisplayName: Commilitia Drop
+        NSExtension:
+          NSExtensionPointIdentifier: com.apple.share-services
+          NSExtensionPrincipalClass: $(PRODUCT_MODULE_NAME).ShareViewController
+          NSExtensionAttributes:
+            NSExtensionActivationRule:
+              NSExtensionActivationSupportsFileWithMaxCount: 20
+              NSExtensionActivationSupportsImageWithMaxCount: 20
+              NSExtensionActivationSupportsMovieWithMaxCount: 20
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop.share
+        TARGETED_DEVICE_FAMILY: "1,2"
+        CODE_SIGN_ENTITLEMENTS: Share/CDropShare.entitlements
+        "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]": "$(CDROP_PROFILE_SHARE)"
+  # 控制中心剪贴板两控件（WidgetKit ControlWidget，iOS 18+，PLAN §I4）。纯原生 REST + 控件专用
+  # 设备会话（不跑引擎）。i18n JSON 一并打包使控件标签随设备语言（t() 经 no-subdir 回退读 bundle）。
+  CDropWidgets:
+    type: app-extension
+    platform: iOS
+    deploymentTarget: "26.0"
+    configFiles:
+      Debug: Signing.xcconfig
+      Release: Signing.xcconfig
+    sources:
+      - path: Widgets
+      - path: Shared
+      - path: Sources/Resources/i18n
+    info:
+      path: Widgets/Info.plist
+      properties:
+        CFBundleDisplayName: Commilitia Drop
+        NSExtension:
+          NSExtensionPointIdentifier: com.apple.widgetkit-extension
+    settings:
+      base:
+        PRODUCT_BUNDLE_IDENTIFIER: net.commilitia.Commilitia-Drop.widgets
+        TARGETED_DEVICE_FAMILY: "1,2"
+        CODE_SIGN_ENTITLEMENTS: Widgets/CDropWidgets.entitlements
+        "PROVISIONING_PROFILE_SPECIFIER[sdk=iphoneos*]": "$(CDROP_PROFILE_WIDGETS)"
 schemes:
   CDrop:
     build: