Files
QFT/ios/CoreTests/MockPCServer.py
T
zhy200308 4d77ba6c91 feat: 新增 iPhone 客户端,含隔空投送式点对点互传
三条链路:
- 电脑 → 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 中实际打开过。
2026-08-11 09:08:37 +08:00

242 lines
8.7 KiB
Python

#!/usr/bin/env python3
"""按 windows/src/{sender,receiver}.rs 的线上语义实现的假电脑端。
存在的意义:Swift 客户端的线格式必须和 Rust 端逐字节一致,
而 Rust 端在这台机器上编译不了。这个 mock 把两端的契约固定下来,
任何一边改了 header 名、路径或 JSON 字段,集成测试都会红。
用法:
python3 MockPCServer.py --token <session> --serve <文件> --save-dir <目录> --port 0
启动后在 stdout 打印一行 `READY <port>`,供测试脚本读取。
"""
import argparse
import base64
import hashlib
import json
import os
import socket
import sys
import threading
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
STATE = {}
def b64url_decode(text):
padding = "=" * (-len(text) % 4)
return base64.urlsafe_b64decode(text + padding)
def b64url_encode(data):
return base64.urlsafe_b64encode(data).decode("ascii").rstrip("=")
class Handler(BaseHTTPRequestHandler):
protocol_version = "HTTP/1.1"
def log_message(self, *_args):
pass
# -------------------------------------------------- 工具
def _json(self, code, payload):
body = json.dumps(payload).encode("utf-8")
self.send_response(code)
self.send_header("Content-Type", "application/json")
self.send_header("Content-Length", str(len(body)))
self.send_header("Connection", "close")
self.end_headers()
self.wfile.write(body)
def _authorized(self):
if self.headers.get("X-QFT-Token") != STATE["token"]:
self.send_response(403)
self.send_header("Content-Length", "0")
self.send_header("Connection", "close")
self.end_headers()
return False
# 设备名必须是 base64url,解不出来说明客户端编码错了
device = self.headers.get("X-QFT-Device")
if device is not None:
b64url_decode(device).decode("utf-8")
return True
# -------------------------------------------------- GET
def do_GET(self):
if not self._authorized():
return
if self.path == "/qft/ping":
return self._json(200, {"ok": True, "protocol": 2, "parallel": True})
if self.path == "/qft/download":
return self._download()
return self._json(404, {"ok": False})
def _download(self):
path = STATE["serve"]
size = os.path.getsize(path)
offset = 0
header = self.headers.get("Range")
if header:
assert header.startswith("bytes="), "只支持 bytes= 形式的 Range"
assert header.endswith("-"), "sender.rs 只支持单段开区间 Range"
offset = int(header[len("bytes="):-1])
assert 0 <= offset < size, "Range 越界"
remaining = size - offset
self.send_response(206 if offset else 200)
self.send_header("Content-Type", "application/octet-stream")
self.send_header("Content-Length", str(remaining))
self.send_header("Accept-Ranges", "bytes")
if offset:
self.send_header("Content-Range", "bytes %d-%d/%d" % (offset, size - 1, size))
self.send_header("X-QFT-Filename", b64url_encode(os.path.basename(path).encode("utf-8")))
self.send_header("Connection", "close")
self.end_headers()
with open(path, "rb") as fh:
fh.seek(offset)
while True:
block = fh.read(256 * 1024)
if not block:
break
self.wfile.write(block)
# -------------------------------------------------- POST
def do_POST(self):
if not self._authorized():
return
if self.path == "/qft/upload/init":
return self._upload_init()
if self.path.startswith("/qft/upload/chunk/"):
return self._upload_chunk()
if self.path.startswith("/qft/upload/finish/"):
return self._upload_finish()
return self._json(404, {"ok": False})
def _upload_init(self):
name = b64url_decode(self.headers["X-QFT-Filename"]).decode("utf-8")
size = int(self.headers["X-QFT-Size"])
chunk_size = int(self.headers.get("X-QFT-Chunk-Size", 8 * 1024 * 1024))
chunk_size = max(1024 * 1024, min(16 * 1024 * 1024, chunk_size))
total = 0 if size == 0 else (size + chunk_size - 1) // chunk_size
upload_id = base64.urlsafe_b64encode(os.urandom(9)).decode("ascii").rstrip("=")
part = os.path.join(STATE["save_dir"], "%s.%s.qftpart" % (name, upload_id))
with open(part, "wb") as fh:
fh.truncate(size)
STATE["uploads"][upload_id] = {
"name": name, "size": size, "chunk_size": chunk_size,
"total": total, "part": part, "received": [False] * total,
"lock": threading.Lock(),
}
return self._json(200, {"ok": True, "upload_id": upload_id,
"chunk_size": chunk_size, "total_chunks": total})
def _upload_chunk(self):
suffix = self.path[len("/qft/upload/chunk/"):]
upload_id, _, index_text = suffix.partition("/")
index = int(index_text)
session = STATE["uploads"].get(upload_id)
if session is None:
return self._json(500, {"ok": False, "error": "unknown upload"})
length = int(self.headers["Content-Length"])
offset = index * session["chunk_size"]
expected = min(session["chunk_size"], session["size"] - offset)
assert length == expected, "chunk 长度不匹配:%d != %d" % (length, expected)
body = b""
while len(body) < length:
block = self.rfile.read(length - len(body))
if not block:
break
body += block
assert len(body) == length, "chunk 体不完整"
with session["lock"]:
if session["received"][index]:
return self._json(200, {"ok": True, "duplicate": True})
with open(session["part"], "r+b") as fh:
fh.seek(offset)
fh.write(body)
session["received"][index] = True
return self._json(200, {"ok": True})
def _upload_finish(self):
upload_id = self.path[len("/qft/upload/finish/"):]
session = STATE["uploads"].get(upload_id)
if session is None:
return self._json(500, {"ok": False, "error": "unknown upload"})
missing = session["received"].count(False)
if missing:
return self._json(409, {"ok": False, "missing": missing})
digest = hashlib.sha256()
with open(session["part"], "rb") as fh:
while True:
block = fh.read(1024 * 1024)
if not block:
break
digest.update(block)
final = os.path.join(STATE["save_dir"], session["name"])
os.replace(session["part"], final)
del STATE["uploads"][upload_id]
return self._json(200, {"ok": True, "sha256": digest.hexdigest(), "size": session["size"]})
def udp_responder(token, http_port, stop):
"""QFTDISC2:<token> → QFTHERE2:<token>:<port>,对应 sender.rs 的发现线程。"""
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
try:
sock.bind(("0.0.0.0", 39392))
except OSError:
return
sock.settimeout(0.25)
expected = ("QFTDISC2:%s" % token).encode("ascii")
reply = ("QFTHERE2:%s:%d" % (token, http_port)).encode("ascii")
while not stop.is_set():
try:
data, peer = sock.recvfrom(512)
except socket.timeout:
continue
except OSError:
break
if data == expected:
sock.sendto(reply, peer)
sock.close()
def main():
parser = argparse.ArgumentParser()
parser.add_argument("--token", required=True)
parser.add_argument("--serve", required=True, help="供 /qft/download 下发的文件")
parser.add_argument("--save-dir", required=True, help="接收上传的目录")
parser.add_argument("--port", type=int, default=0)
parser.add_argument("--udp", action="store_true", help="同时启动 UDP 发现应答")
args = parser.parse_args()
STATE.update(token=args.token, serve=args.serve, save_dir=args.save_dir, uploads={})
os.makedirs(args.save_dir, exist_ok=True)
server = ThreadingHTTPServer(("127.0.0.1", args.port), Handler)
port = server.server_address[1]
stop = threading.Event()
if args.udp:
threading.Thread(target=udp_responder, args=(args.token, port, stop), daemon=True).start()
print("READY %d" % port, flush=True)
try:
server.serve_forever()
except KeyboardInterrupt:
pass
finally:
stop.set()
if __name__ == "__main__":
main()