Technical Specifications & Architecture
LightDrop (光传) — 纯离线动态光栅喷泉码文件与数据传输系统
物理隔离 · 零联网 · 免安装 · 端到端双加密 · 永久免费授权
LightDrop (光传) 是一款基于屏幕动态光学显示与摄像头图像识别的高速单向光通信文件与文本传输系统。传输过程无需处于同一局域网、无需蓝牙或 Wi-Fi、免安装任何 App、零中心化服务器与中转节点，仅凭屏幕与摄像头即可在任意物理隔离设备间实现安全、极速（实测可达 418.5 KB/s sustained 持续吞吐）、防窥探的数据投送。
实机演示：手机后置摄像头捕获屏幕动态光流，高速还原文件
🌟 核心特性 (Key Features)
- 🚀 顶级纠错码极速光传 (Top-Tier Fountain Code Engine)：采用 Luby Transform (LT) 无速率喷泉码与多二维码矩阵并发流式渲染，在非对称高丢包信道下具备极致鲁棒性与纠错自愈能力；
- 🛡️ 物理隔离与涉密机房合规 (Air-Gap Security)：100% 纯本地离线单向光通信传输，杜绝网络攻击面与侧信道渗透，完全契合涉密机房、金融内网等严格物理隔离合规规范；
- 🔒 国际 AES-256 + 国密 SM4 双硬件级强加密 (E2EE)：支持国际标准 AES-256-GCM 与中国国家商用密码 SM4-GCM 端到端强加密（结合 100,000 次 PBKDF2-SHA256 密钥派生），即便传输全程被第三方录屏，破解概率绝对为 0；
- 📦 纯单文件绿色便携客户端 (Pure Standalone Single-File)：全自包含单 HTML 文件（
LightDrop.html），内置全部 WASM 图像解码引擎与国密/国际密码库，无需安装、断网双击即开； - 🔑 纯离线数字签名授权体系 (Offline Lifetime License)：支持本地离线非对称 HMAC 验签与
license.key拖拽导入，现已全面开放免费获取，永久免费、无任何订阅套路； - 📱 全平台全终端适配：Windows、macOS、Linux、iPhone/iPad、Android 手机及各类工业扫码终端/高拍仪即开即用，更适配智能手表 200px~320px 超小表盘。
📊 真实传输速度实测 (Measured Speed Benchmarks)
One record run per device pair. Sustained is whole-transfer goodput; peak is the best ≥1 s window inside that same run. Every row links to the full diagnostics run report that produced it (how these are measured).
| pair | sustained | peak | transfer | codes | devices | when | receipt |
|---|---|---|---|---|---|---|---|
| desktop → phone | 418.5 KB/s | 601.5 KB/s | 1.0 MB in 2.5 s | 4 | Odyssey G9 49″ → iPhone 17 Pro Max | 2026-08-09 (v0.4.0) | run |
| phone → phone | 199.2 KB/s | 340.8 KB/s | 1.0 MB in 5.1 s | 2 | iPhone 17 Pro Max → iPhone 17 Pro Max | 2026-08-09 (v0.4.0) | run |
💡 速度测试遵循可复现准则，基准数据由自动化测试套件与真实硬件设备对录生成，详情见 docs/technical/diagnostics.md。
⚙️ 工作原理与传输架构 (How It Works)
sequenceDiagram
autonumber
participant S as 发送端 (电脑/手机屏幕)
participant Channel as 光学信道 (屏幕动态光流)
participant R as 接收端 (手机/终端摄像头)
Note over S: 1. 选择文件/粘贴文本 (可选 AES/SM4 加密)
Note over S: 2. 切片为 LT 喷泉码无速率符号
Note over S: 3. 动态二维码流高速循环播放
S->>Channel: 发射高帧率动态光学矩阵 (30~60 FPS)
Channel->>R: 摄像头光学感光捕获 (无需配对/零网络)
Note over R: 4. WASM 多核引擎并发图像识别与纠错
Note over R: 5. 高斯消元数学解算还原原始数据包
Note over R: 6. SHA-256 完整性强校验
Note over R: 7. 纯本地解密并即时保存还原文件
- 单向物理信道：仅有光线从发送端屏幕射向接收端摄像头，物理上切断反向数据流，天然阻绝任何逆向注入攻击；
- 喷泉码无序解码：接收端无需按顺序接收每一帧，捕获任意足够数量的有效编码包即可通过数学消元完整解出原文件，中途漏帧、反光、抖动不影响最终解码；
- 零云端中转：数据完全保留在两台设备的本地内存中，网络抓包记录与云端审计痕迹皆为零。
💳 版本规格与免费授权说明 (License Tiers)
LightDrop 采用纯离线非对称密码学授权，全功能版现已开放免费获取，永久免费无订阅费用：
| 版本规格 | 授权费用 | 单文件大小上限 | 文本片段上限 | 核心特性与特权体系 | 适用场景与推荐用户 |
|---|---|---|---|---|---|
| 免费体验版 | 免费 | 2 MB | 256 KB | 基础单二维码光传、开箱即用免激活 | 临时应急传输、轻量文本与小图体验 |
| 全功能版 | 扫码免费获取 | 无上限 | 64 MB | 解锁全部功能： • 🔒 国际 AES-256-GCM + 🛡️ 国密 SM4-GCM 双强加密 • ⚡ 多二维码并发加速矩阵 (2×2 / 2×3 并发) • 🚀 顶级无速率喷泉码极速传输引擎 • 📦 纯单文件断网秒开，永久有效无订阅 |
个人日常、敏感文件隐私加密与办公跨端传输 |
| 企业与定制版 | 按需定制 | 无上限 | 64 MB+ | 专属内网独立私有化部署、高拍仪/扫码枪套件软硬件集成、定制专有协议、企业专属白标与架构师一对一技术支持 | 军工内网物理隔离、金融审计机房、涉密数据归档 |
🎁 全功能版授权免费获取与激活方式
- 免费获取授权码：
- 扫描首页或弹窗中的开发者企业微信二维码，添加好友并备注
LightDrop授权码； - 开发者将免费发放专属卡密（如
LDPRO-...）或license.key授权文件；
- 扫描首页或弹窗中的开发者企业微信二维码，添加好友并备注
- 离线激活方式：
- 点击页面右上角或底部的 【立即激活】（或打开离线客户端中的激活弹窗）；
- 粘贴授权卡密，或直接拖拽
license.key文件放入激活区； - 系统将通过内置非对称 HMAC 密码学算法进行 100% 纯本地离线验签，瞬间激活全功能版并持久保存在本地。
📦 客户端下载与使用指南 (Downloads & User Guide)
用户可通过官方站点直接下载免安装绿色离线包，或在项目根目录构建生成：
- 官方离线便携包：LightDrop-Portable.zip
- 压缩包严格包含两个文件：
LightDrop.html（双端合一的自包含单文件，内置全量 WASM 解码器与密码库）；README-使用帮助与授权激活指南.txt（离线使用指南与激活指引）；
- 压缩包严格包含两个文件：
- 独立单文件版：LightDrop.html（亦提供独立的发送端
lightdrop-sender.html与接收端lightdrop-receiver.html）。
各平台推荐使用方式
- 💻 Windows / macOS / Linux / 鸿蒙电脑：
- 解压
LightDrop-Portable.zip，直接双击LightDrop.html，系统默认浏览器将在完全断网环境下瞬间启动；
- 解压
- 📱 iPhone / iPad (iOS & iPadOS)：
- 由于 iOS 系统安全沙箱限制本地
file://协议调用摄像头，推荐使用 Safari 浏览器打开 Web 版站点后，点击底部工具栏【分享 ➔ 添加到主屏幕 (PWA)】； - 安装完成后，在飞行模式下即可从手机桌面离线秒开，支持全权限调用后置摄像头；
- 由于 iOS 系统安全沙箱限制本地
- 🤖 安卓手机 (Android - 华为 / 小米 / OPPO / VIVO 等)：
- 支持浏览器直接双击打开
LightDrop.html运行，或通过浏览器菜单选择【添加到主屏幕 / 安装应用 (PWA)】；
- 支持浏览器直接双击打开
- ⌚ 智能手表 (WatchOS / HarmonyOS / WearOS)：
- 单文件内核专门优化了 200px~320px 超小表盘流式排版，抬腕即可感光或扫码传输。
🚀 极速传输三步法
- 发送端：打开 LightDrop 选择 Send (发送) ➔ 拖入文件或粘贴文本 ➔ 调高屏幕亮度并开始播放动态光流；
- 接收端：打开 LightDrop 选择 Receive (接收) ➔ 点击 启动摄像头 (Start camera) ➔ 对准发送端屏幕动态二维码；
- 完成保存：进度达到 100% 时自动完成 SHA-256 校验，一键预览或下载恢复的文件。
💡 大文件传输提速秘籍： 传输几十 MB 以上的大文件时，建议将接收端设备使用手机支架或靠在桌面上固定机位对准屏幕，避免手持晃动引起镜头反复变焦拉焦，可大幅提升解码吞吐速度与稳定性。
🛠️ 本地开发与构建 (Development & Build)
本项目基于 Vite 6、TypeScript 与现代 Web API 构建，不依赖任何重型前端框架，追求极致轻量与加载性能：
# 1. 克隆代码仓库
git clone https://github.com/misterye/lightdrop.git
cd lightdrop
# 2. 安装依赖 (Node.js >= 24)
npm install
# 3. 启动本地 HTTPS 开发服务器 (支持 HMR 与摄像头调用)
npm run dev
# 4. 运行全量自动化测试套件 (129 项单元与端到端测试)
npm test
# 5. 编译 Web PWA 生产包
npm run build
# 6. 编译纯离线自包含单文件客户端 (dist-standalone/)
npm run build:standalone
# 7. 一键生成全平台便携客户端 ZIP 离线包 (public/clients/ 与 dist-clients/)
npm run package:all
# 8. 同步更新性能实测基准数据至 README
npm run benchmark:readme
📚 项目详细文档索引 (Documentation)
项目内置了详尽的用户指南与底层技术规格白皮书：
- 用户指南 (User Guides)：
- 快速入门 (Quick Start) — 60 秒双设备端到端传输
- 发送端使用指南 (Sending) — 文件切片、文本投送与光栅设置
- 接收端使用指南 (Receiving) — 相机捕获、对焦优化与文件落盘
- 常见问题与故障排查 (Troubleshooting) — 疑难场景与排查手册
- PWA 安装与离线单文件 (Install & Offline) / 完整使用说明 (USAGE.md)
- 隐私与安全白皮书 (Privacy & Security)
- 技术规范 (Technical Specifications)：
- 系统整体架构 (Architecture) — 页面划分、核心模块与构建插件
- 喷泉码传输协议 (Protocol) — LT 喷泉码无速率分布、数据帧结构与消元算法
- 协议版本控制规范 (Versioning) — 魔数、版本协商与前向兼容性
- 标准一致性向量 (Golden Vectors) — 跨平台独立实现的测试向量
- 各移动平台踩坑实录 (Platform Quirks) — iOS/Safari/Android 摄像头行为差异适配
- 基准测试与诊断报告 (Diagnostics) — 传输遥测与吞吐量度量
⚖️ 免责声明、版权与联系方式 (Legal & Contact)
- 软件提供：本软件按“现状 (AS-IS)”提供，不包含任何明示或暗示的保证；
- 传输内容免责：本软件为纯物理隔离工具，传输数据绝不经过任何云端服务器，用户对其传输的全部内容承担独立且唯一的法律责任；
- 密码学密钥自保管：端到端加密（AES-256-GCM / SM4-GCM）完全由本地离线密码学生成，密钥由用户自行保管，丢失无法找回；
- 开源许可证：AGPL-3.0-or-later 开源授权。部分解码器组件集成自 zxing-cpp (Apache-2.0)，详见 NOTICE；
- 商务合作与企业定制：
service@satelc.com； - 版权所有：Copyright © 2026 LightDrop (光传) / Satelc. All Rights Reserved.