文件，
从屏幕到手机。

在显示二维码的电脑或 SSH 远端服务器上安装。先确认已安装 Node.js 20 或更新版本（推荐当前 LTS），以及 curl、tar。

curl -fsSL https://datawifi.clinative.com/install.sh | bash

无需 sudo，无需 Git、npm 或编译。安装器下载预构建命令并验证 SHA-256，安装到当前用户目录；不会修改 shell 配置。查看安装脚本

如果出现 command not found，为当前终端加入命令路径：

export PATH="$HOME/.local/bin:$PATH"
data-wifi-send --help

将 export 这一行加入 ~/.zshrc 或 ~/.bashrc，新终端也能使用。重复运行安装命令即可更新。Windows 请在 WSL 中运行；原生 PowerShell 暂不支持此安装脚本。

git clone https://github.com/gaoxiaos/data_wifi.git
cd data_wifi
npm ci
npm run build
node dist/sender.js README.md

使用规格：1、3、7、30、90、365 天；首次兑换开始计时，只能兑换一次并绑定当前浏览器。请避免无痕模式或清除网站数据，更换浏览器需新码。

data-wifi-send README.md
# 路径包含空格时使用引号
data-wifi-send "my files/config.json"

接收过程中查看手机进度；手机显示完成后，电脑按 Ctrl+C 停止发送。发送端没有网络回执，不会自动知道手机是否接收完成。iPhone 若未自动保存，请点击下载链接，并在 Safari 下载列表 / “文件”App 中查找。

1. 在手机接收页展开“QRF3/QRF4 接收密钥”，点击“生成 QRF4 双身份”，下载双公钥 .qrfpub 和私钥 A、B。生成与解密均在浏览器本地运行。
2. 离线妥善保存私钥。把公钥包交给发送端，并核对页面显示的公钥包指纹。QRF3 使用双公钥包的第一身份，需要私钥 A 解密。
3. 发送时加入 --recipient。手机接收完成后点击“选择私钥并解密”，选择对应的私钥 A，验证成功后保存原文件。

data-wifi-send secret.txt --recipient iphone-receiver.qrfpub

也可以先在手机保存 .qrf3 密文包，之后在接收页点击“打开已有密文包”，或使用本地命令解密：

data-wifi-decrypt received.qrf3 --identity iphone-key-a.qrfkey
# 如需指定输出路径
data-wifi-decrypt received.qrf3 --identity iphone-key-a.qrfkey --output restored.txt

data-wifi-keygen my-phone
# 得到 my-phone.qrfpub（公钥）和 my-phone.qrfkey（私钥）
data-wifi-send secret.txt --recipient my-phone.qrfpub

可压缩内容先自适应 gzip，再使用 P-256 ECDH、HKDF-SHA-256、AES-256-GCM 加密。文件名与 SHA-256 位于密文中；错误私钥或被篡改的数据会被拒绝。私钥不会上传，也不会保存到浏览器存储。

适用于原始文件在可信环境中准备、展示二维码的电脑可能被监听的场景。先在可信电脑生成包含真实诱饵的容器，再让展示电脑只读取不透明的 .qrf4 文件。

1. 生成双身份并离线保存私钥

可以使用手机接收页生成，或在可信电脑运行：

data-wifi-keygen iphone --qrf4
# iphone.qrfpub / iphone-a.qrfkey / iphone-b.qrfkey

2. 在可信电脑打包

data-wifi-pack \
  --recipient iphone.qrfpub \
  --decoy vacation.jpg \
  --secret private.conf \
  --output transfer.qrf4

诱饵应当是内容合理、能正常打开的真实文件。省略 --secret 即生成只含诱饵的普通包，另一个槽填充为随机数据。

3. 展示电脑只运行渲染器

只把容器交给展示电脑；该电脑无需公钥或私钥，也不应接触原始隐藏文件和打包过程。

data-wifi-render transfer.qrf4
# 省略路径时读取当前目录的 transfer.qrf4
data-wifi-render

4. 手机接收后选择相应私钥

data-wifi-decrypt transfer.qrf4 --identity iphone-b.qrfkey

容器固定包含两个等长、随机排序的匿名槽，传输量约为较大文件压缩后所处填充桶的两倍。它不掩盖在展示电脑上发生的原始文件访问，也不能保证任何现实场景下的可否认性。请把打包和隐藏私钥始终留在可信环境。

一般直接运行发送命令即可。发送端根据待传容器大小选择块大小和刷新率，再按终端空间回退。

# 镜头识别不稳定时，降低刷新率 / 二维码密度
data-wifi-send config.json --fps 4 --chunk 400 --ecc L
# 加密也能使用这些参数
data-wifi-send secret.txt --recipient iphone.qrfpub --fps 4

--fps 控制刷新率；--chunk 控制每帧数据量，手动指定且终端放不下时会报错；--ecc 支持 L/M/Q/H，默认 L。增大 QR 纠错等级也会增大二维码，通常先调整刷新率、窗口与镜头位置。

放大终端窗口、适当减小字号、避免反光和抖动。二维码四周留白要完整入镜，画面不应过曝。适合小文本、配置、证书与密钥；照片、视频等已压缩的大文件会明显更慢，优先用其他传输方式。