QrTrans 是一个巧妙利用二维码作为数据载体的跨平台应用，专为在完全离线的环境中安全、快速地传输文本和小型文件而设计。在蓝牙不可用、Wi-Fi 隔离、USB 接口受限的场景下，它借助人人都有的屏幕和摄像头，打通了设备间的数据孤岛。

1. 离线场景下的真实痛点

在许多特定场景下，设备间的数据交换是一大难题，传统的网络传输方式完全失效：

• 物理隔离网络：在工业控制、金融、涉密等高安全环境中，设备通常不允许连接任何外部网络，甚至 USB 端口也会被禁用，但仍有交换配置、日志等小文件的需求。
• 临时环境无网络：在户外、地下室、新部署的服务器机房等场所，可能没有可用的 Wi-Fi 或蜂窝网络，设备之间无法建立连接。
• 向无接口设备传输：某些设备（如部分工控机、展示屏、自助终端）只配备了摄像头而没有易于使用的 USB 或网络接口，向其输入数据（如配置信息、URL）极为不便。
• 安全与便捷的矛盾：使用 U 盘等物理介质传输可能带来病毒风险，而手动输入长串的密码、密钥或配置文件既耗时又极易出错。

为解决这些问题，我们需要一种不依赖传统网络和物理接口，仅利用设备通用硬件（屏幕和摄像头）就能完成数据交换的方案。QrTrans 正是为此而生。

2. QrTrans 的核心架构与设计哲学

QrTrans 的核心思想是 “数据视频化” 与 “逐帧解码”。它将文件或文本数据进行切片，并将每一片数据编码成一个独立的二维码。发送端像播放视频一样，将这些二维码以一定的帧率在屏幕上循环播放；接收端则通过摄像头连续捕捉这些二维码图像，解码并重组出完整的数据。

动态化、可配置的数据传输

• 文件分片与编码：应用首先将待传输的文件或文本二进制数据分割成若干个大小可控的数据块（Chunk）。每个数据块附带序列号和校验信息，然后被编码成一张二维码图片。
• 动态二维码播放：发送端将生成的一系列二维码图片，以幻灯片的形式在屏幕上播放。用户可以自定义播放速度（帧率）、数据块大小、二维码纠错等级等参数，以适应不同尺寸的屏幕和不同性能的摄像头。
• 连续扫描与智能重组：接收端会持续通过摄像头扫描屏幕，实时解码捕获到的二维码。内置的重组逻辑会根据二维码中的序列号，将乱序或重复的数据块拼接成原始文件，直到所有数据块接收完毕。

跨平台与易用性

• 基于 Flutter 的跨平台能力：利用 Flutter 的特性，QrTrans 可以轻松构建适用于 Android、iOS、Windows、macOS 和 Linux 的客户端，实现全平台覆盖。
• 极简的操作流程：整个过程仅需三步：发送方选择文件生成二维码，接收方打开相机扫描，传输自动完成。无需配对、无需密码、无需复杂的网络设置。
• 可视化传输进度：在发送和接收界面，用户都能清晰地看到总数据块数量、当前进度以及预估剩余时间，对传输状态一目了然。

3. 典型使用场景

场景一：向离线服务器传递 SSH 密钥

系统管理员需要登录一台位于隔离机房的新服务器，但服务器没有连接网络。他可以在自己的手机上使用 QrTrans，将 authorized_keys 公钥文件的内容生成二维码。然后，在服务器的控制台前，用手机屏幕对准外接的摄像头，服务器上的接收端应用扫描后即可获得公钥，完成授权。

场景二：分享 Wi-Fi 密码或长文本

在一个没有网络信号的会议室，你想把一个复杂的 Wi-Fi 密码或一段会议纪要分享给同事。只需将文本粘贴到 QrTrans 中，对方用手机扫一下你的屏幕，即可快速获取，避免了口述或手动输入的麻烦和错误。

场景三：更新自助服务终端的配置文件

商场的一台自助查询终端需要更新一个几 KB 大小的配置文件。运维人员无需拆机插入 U 盘，只需在笔记本电脑上运行 QrTrans 生成配置文件的动态二维码，然后将电脑屏幕对准终端的摄像头，即可完成配置文件的“注入”。

4. 总结

QrTrans 并非要取代大文件传输工具，而是精准地切入了离线、安全、小数据交换这一细分场景。它以一种极具创意的方式，将二维码从一个静态的信息入口，变成了一种动态的数据流载体。凭借其跨平台、易用和高度可配置的特性，QrTrans 为解决“最后一公里”的数据传输问题提供了一个轻量而可靠的“数字隔空投送”方案。