Files
QFT/IMPLEMENTATION_STATUS.md
zhy200308 eae24000e9 优化IOS
2026-08-19 09:31:21 +08:00

130 lines
6.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# QFT v0.4.16 implementation status
## Windows → Android optical
- [x] QFT2 manifest/data/end frame format
- [x] QFT2 Base45 text layer; Android Result.text decode
- [x] QFT1 legacy receive compatibility
- [x] CRC32 per frame + SHA-256 whole file
- [x] **single large QR only**; 2×2 / 4-channel removed
- [x] default 450-byte DATA payload
- [x] QR-L + complete 4-module quiet zone
- [x] Windows target display 5~60 FPS
- [x] draggable control/QR split pane
- [x] focus-QR mode and QR zoom
- [x] Rayon background pre-encoding
- [x] reused egui GPU TextureHandle / NEAREST sampling
- [x] positioned source reads; no whole-file mmap
- [x] bounded pre-render cache; 1100 MiB process design budget
- [x] Android centered acquisition + finder-point ROI lock
- [x] smoothed moving ROI + progressive miss expansion/reacquire
- [x] dynamic overlay: search/green lock/yellow miss/outside dim
- [x] lock-centered periodic AF/AE
- [x] Android 640×480 ImageAnalysis + KEEP_ONLY_LATEST
- [x] Camera2Interop advertised AE FPS range request up to 60
- [x] automatic fallback when an OEM rejects explicit FPS/stream combination
- [x] reusable Y-plane `GrayFrameBuffer`
- [x] GlobalHistogram hot path + sparse Hybrid fallback
- [x] duplicate decoded optical frames suppressed before assembler
- [x] runtime camera FPS / decoded/s / distinct-new-frame/s / decode-ms UI
- [x] synthetic QFT2 v15 full-frame + ROI visual decode test
- [ ] physical 30/45/60Hz display × Android camera throughput matrix
## Android → Windows
- [x] QFTPAIR2 compact pairing QR
- [x] persistent per-PC Direct AP identity + per-session token
- [x] Windows Wi-Fi Direct Legacy AP implementation
- [x] Android 10+ WifiNetworkSpecifier path
- [x] Android 7~9 legacy Wi-Fi path
- [x] wait for actual IPv4/link route before discovery
- [x] UDP QFTDISC2 receiver discovery
- [x] QR endpoint + gateway + directed broadcast + subnet fallback
- [x] dedicated Wi-Fi immediate parallel gateway + actual-subnet probe
- [x] HTTP bound to selected Android Network
- [x] local cleartext network security config
- [x] local/private IPv4 + session-token validation
- [x] Parallel v2 init/chunk/finish
- [x] adaptive 64 KiB–16 MiB chunks, targeting eight flows per file
- [x] up to 8 Android workers per file
- [x] Windows positioned concurrent writes
- [x] temporary `.qftpart`, final SHA-256 and rename
- [x] accepted sockets return to timeout-bound blocking I/O before file transfer
- [x] inline Android file selection + removable, pre-transfer sortable queue
- [x] crash-safe drag commit without detaching the active touched view
- [x] loopback UDP + HTTP + out-of-order parallel integration test
- [ ] physical Windows Wi-Fi Direct adapter / driver / firewall matrix
## Windows → Android local direct
- [x] direction-specific pairing QR starts automatic local download after scan
- [x] HTTP `Range` responses return the exact requested range (`206` + `Content-Range`)
- [x] Android parallel Range downloader targets eight workers per file
- [x] adaptive 64 KiB–16 MiB chunks
- [x] `.qftpart` completion ledger resumes only verified completed ranges
- [x] five retries per range, final SHA-256, then save to `Downloads/QFT`
- [x] regression test for delayed large download after nonblocking accept
## Android compatibility
- [x] minSdk 24 (Android 7.0)
- [x] WRITE_EXTERNAL_STORAGE <= Android 9
- [x] MediaStore Downloads >= Android 10
- [x] ACCESS_FINE_LOCATION compatibility <= Android 12
- [x] NEARBY_WIFI_DEVICES >= Android 13
- [x] no `java.util.Base64` dependency in app source
- [x] host Kotlin QFT2/Base45 + LockRect runtime smoke
- [x] host Kotlin QrAnalyzer type-check with CameraX/ZXing-shaped stubs
- [ ] real Android Gradle APK build in this container (SDK unavailable here)
- [ ] install/runtime matrix on physical Android 7→latest devices
## iOS (v0.5.0)
Optical receive (PC screen → iPhone camera)
- [x] Swift QFT2 + Base45 + CRC32 frame decode, QFT1 legacy read
- [x] session assembler: dedupe, positioned writes, whole-file SHA-256, discard on mismatch
- [x] AVCaptureVideoDataOutput + Vision `VNDetectBarcodesRequest`
- [x] format picked for highest resolution among ≥60 FPS formats; fixed frame rate, HDR/stabilisation off
- [x] `alwaysDiscardsLateVideoFrames` (no stale camera frames)
- [x] centered search → ROI lock → progressive expansion → reacquire
- [x] periodic AF/AE at ROI center after lock
- [x] separate decoded/s and distinct-new-frame/s counters
- [ ] physical throughput matrix (30/45/60 FPS × device)
iPhone ↔ Windows dedicated network
- [x] accept Wi-Fi-only QFTPAIR2/QFTSEND2 (no endpoints, by design)
- [x] `NEHotspotConfiguration` join with `joinOnce`
- [x] honest fallback to guided manual join when the entitlement is unavailable
- [x] default gateway from `sysctl` route table; gateway-first host candidates
- [x] join verified by authenticated `/qft/ping`, not by the system callback
- [ ] physical Windows Wi-Fi Direct AP join (both entitlement paths)
iPhone ↔ Mac / Linux LAN
- [x] `QFTBROWSE3` node browse client
- [x] desktop connect code (Crockford Base32 + CRC-8), cross-verified against Rust vectors
- [x] `POST /qft/pair` code → token, no retry on failure
- [x] eight-way parallel Range download, 64 KiB–16 MiB adaptive chunks
- [x] `.qftpart` + completion ledger resume (parallel chunks land out of order)
- [x] explicit failure + single-stream fallback when the peer ignores Range
- [x] parallel upload (init/chunk/finish), fixed 4 MiB chunks × 6 workers
iPhone ↔ iPhone (AirDrop-style)
- [x] AWDL `includePeerToPeer` + TLS-PSK, key carried by the QR
- [x] multi-file queue (QFTP2P2); manifest digest in the QR, manifest itself on the wire
- [x] per-file SHA-256, partial files removed on any failure
- [ ] physical AWDL run with the router switched off
Compatibility
- [x] deployment target iOS 15.0 (iPhone 6s and later)
- [x] iOS 16/17 APIs behind `App/Compatibility.swift` forks
- [x] no `loadUnaligned` (Swift 5.7 runtime) in the core layer
- [x] 180 core-layer checks green via `swiftc` on macOS, no Xcode required
- [ ] Xcode build of the App layer (no Xcode on the authoring machine)
See `TEST_REPORT.md` and `TEST_RESULTS.txt` for executed evidence and limitations.