V0.3.0版本优化传输速度和提示

This commit is contained in:
zhy
2026-08-10 15:45:04 +08:00
commit d885259e2b
58 changed files with 10284 additions and 0 deletions
+86
View File
@@ -0,0 +1,86 @@
# QFT protocol overview · v0.3.0-rc3
## QFT1 — Windows → Android optical stream
Wire text:
`QFT1:<base64url(binary frame)>`
Binary frame fields:
- magic `QFT1`
- protocol version
- frame kind: MANIFEST / DATA / END
- session id
- sequence index
- total chunks
- payload length
- payload
- CRC32
MANIFEST contains file name, file size, chunk size, total chunks, SHA-256 and Windows sender-device name. DATA frames are replayed cyclically; Android de-duplicates chunks and waits for missing chunks in later rounds. No Android→Windows feedback channel is used in optical mode.
v0.3 defaults: 900-byte DATA payload, 4 QR/page, target up to 60 pages/s.
## QFTPAIR2 — Android → Windows pairing
Text:
`QFTPAIR2:<base64url(compact JSON)>`
Compact JSON keys:
- `v`: 2
- `s`: one-time session token
- `n`: Windows device name
- `p`: receiver TCP port
- `e`: local HTTP endpoint hints; Direct AP normally carries one short hint
- `w`: optional `[ssid, passphrase]` for QFT Direct
QFTPAIR1 remains parser-compatible for older QR payloads.
Android treats pairing QR as untrusted. HTTP endpoint hints must be literal private/local IPv4 addresses on the advertised port. Every `/qft/*` request must carry the one-time `X-QFT-Token` session value.
## Receiver discovery
UDP request to port 39392:
`QFTDISC2:<session>`
Windows response:
`QFTHERE2:<session>:<tcp_port>`
Android combines UDP result with QR hint, the actual connected Wi-Fi gateway, common Windows local addresses and a bounded current-subnet fallback scan.
## Parallel v2 upload
### Ping
`GET /qft/ping`
Headers include `X-QFT-Token` and encoded Android device name.
### Init
`POST /qft/upload/init`
Headers include file name, file size and desired chunk size. Android requests 4/8/16 MiB depending on file size; Windows clamps accepted chunks to 1~16 MiB.
Response includes `upload_id`, accepted `chunk_size`, and `total_chunks`.
### Chunk
`POST /qft/upload/chunk/<upload_id>/<index>`
Body is exactly that file range. Up to eight Android workers send distinct chunks concurrently. Windows writes each accepted chunk to the preallocated `.qftpart` file at its deterministic offset.
### Finish
`POST /qft/upload/finish/<upload_id>`
Windows rejects finish while chunks are missing. Once complete it computes SHA-256, renames the temporary file to its final unique name, and returns success.
### Compatibility
`POST /qft/upload` remains the single-stream fallback for old clients or content providers that cannot sustain seekable parallel reads.
+58
View File
@@ -0,0 +1,58 @@
# Roadmap
## V0.1 — 单 QR 无网络链路(当前)
- Windows 选择文件
- 单 QR 动画
- Android CameraX 连续识别
- CRC32
- SHA-256
- 重复帧去重
- 多轮补洞
- 保存 Downloads/QFT
目标不是速度,而是证明:**飞行模式下可稳定完整恢复真实文件**。
## V0.2 — 扫码稳定性
- 自动曝光/对焦锁定
- 只分析中央 ROI
- 720p/1080p 自适应
- 帧序号抖动统计
- 自动 FPS 调节
- QR 版本/纠错级别动态选择
- Android 前台常亮、屏幕方向锁定
## V0.3 — 多 QR
- Windows 2x2 -> 3x3 网格
- Android 一帧多码检测
- 每个位置独立 lane
- lane interleave,避免同一丢帧损失连续数据
## V0.4 — Fountain / RaptorQ
- source block / symbol
- 无需等待指定 seq
- 达到恢复阈值即可完成
- 发送端持续产生 repair symbols
- 删除“整文件循环重播”的尾部等待
## V0.5 — QFT Visual Code
- 固定四角定位
- 自定义二值网格
- BCH/LDPC 内层纠错
- SIMD 二值化与采样
- 60/120 FPS
- 标定显示器刷新率与相机 rolling shutter
## V0.6 — Android -> Windows
这个方向因 PC 可能无摄像头,使用 App P2P:
- 同 LAN
- 临时热点
- Wi-Fi Direct(可用平台)
- QUIC
- 不经过外网/云端