4d77ba6c91
三条链路: - 电脑 → iPhone:扫 QFTSEND2 码下载,流式落盘 + 增量 SHA-256, 支持 Range 断点续传 - iPhone → 电脑:扫 QFTPAIR2 码后 init/chunk/finish 并行分块上传 - iPhone ↔ iPhone:QFTP2P1 扫码握手,Network.framework 开启 includePeerToPeer(AirDrop 同款 BLE 发现 + AWDL 点对点 Wi-Fi), 两台设备不需要连同一个 Wi-Fi,也不需要路由器 P2P 用 TLS-PSK 握手:32 字节预共享密钥由发送端随机生成并写进二维码, 扫码这个动作本身完成带外密钥交换与双向认证,无需证书体系与配对弹窗。 未扫到码的第三方连上来过不了握手。 核心层刻意不 import UIKit,可直接以 macOS 为目标编译测试, 不需要 Xcode 也不需要模拟器,已接入主自检套件,72 项全部通过: - 端点白名单 11 种拒绝用例(域名、公网、172.32 边界、 非规范八位组、IPv6、带凭据/路径/query) - CoreTests/MockPCServer.py 严格复刻 receiver.rs / sender.rs 的线上语义 (路径、header 名、JSON 字段、Range 行为、chunk 长度校验), 构成 Swift 与 Rust 两端的线格式契约测试,任一端改协议即会失败 - 真实 TLS-PSK 握手下的 P2P 端到端传输,含错误密钥必须被拒 iOS 平台限制(已在 ios/README.md 说明): NEHotspotConfiguration 需要付费账号 entitlement,故不实现 Direct AP 流程,与电脑互传要求同一局域网;AWDL 是苹果私有链路,Windows 无法参与。 上传块固定 4 MiB 而非 Android 的 4/8/16 MiB,因为 iOS 上 worker 数 × 块大小即内存峰值。 未验证部分:本机只有 Command Line Tools,无 Xcode 与 iOS SDK, UI 层(SwiftUI/UIKit/AVFoundation)未经编译;.xcodeproj 已通过 plutil 解析与引用完整性校验(42 个对象无悬空引用), 但未在 Xcode 中实际打开过。
47 lines
1.7 KiB
Swift
47 lines
1.7 KiB
Swift
import Foundation
|
||
|
||
/// RFC 4648 §5 的 URL-safe Base64,无填充。
|
||
/// Windows 端用 `URL_SAFE_NO_PAD` 编码设备名、文件名与配对载荷,
|
||
/// Android 端对应 `Base64Url`,三端必须逐字节一致。
|
||
enum Base64URL {
|
||
|
||
static func encode(_ data: Data) -> String {
|
||
var text = data.base64EncodedString()
|
||
text = text.replacingOccurrences(of: "+", with: "-")
|
||
text = text.replacingOccurrences(of: "/", with: "_")
|
||
while text.hasSuffix("=") { text.removeLast() }
|
||
return text
|
||
}
|
||
|
||
static func encode(_ text: String) -> String {
|
||
encode(Data(text.utf8))
|
||
}
|
||
|
||
static func decode(_ text: String) -> Data? {
|
||
// 只接受合法字母表,避免把任意输入喂给 Data(base64Encoded:)
|
||
// 后得到一个「解出来了但不是原意」的结果。
|
||
guard !text.isEmpty else { return Data() }
|
||
for scalar in text.unicodeScalars {
|
||
switch scalar {
|
||
case "A"..."Z", "a"..."z", "0"..."9", "-", "_":
|
||
continue
|
||
default:
|
||
return nil
|
||
}
|
||
}
|
||
var padded = text.replacingOccurrences(of: "-", with: "+")
|
||
padded = padded.replacingOccurrences(of: "_", with: "/")
|
||
let remainder = padded.count % 4
|
||
if remainder == 1 { return nil } // 不可能出现的长度
|
||
if remainder != 0 {
|
||
padded.append(String(repeating: "=", count: 4 - remainder))
|
||
}
|
||
return Data(base64Encoded: padded)
|
||
}
|
||
|
||
static func decodeString(_ text: String) -> String? {
|
||
guard let data = decode(text) else { return nil }
|
||
return String(data: data, encoding: .utf8)
|
||
}
|
||
}
|