AutoCimBar

AutoCimBar 是一个利用远程桌面（或串流画面）的屏幕信道，进行单向文件传输的工具。encoder 把文件编码成屏幕上的高密度彩色符号帧（参考 cimbar），decoder 从指定屏幕区域截图并恢复文件。采用喷泉码、ECC 等技术，实现高效的数据传输，目前实测已经突破了梦寐以求的 1MB/s 大关。

English README

实验结果

以下为当前 RDP 远程实测结果：

• -c 4t4s8c （-Q 130 时，-packets 8）
• 有效解码 fps 只有最高 30 fps（远程桌面限制）

-Q	speed
14	33 KB/s
20	61 KB/s
26	114 KB/s
130	1310.4 KB/s

moonlight 由于传输的是视频流和 RDP 本地渲染画面有较大差别，从画面中提取数据更加困难，目前 60fps 下可以实现 243 KB/s 的速度。

功能概览

• 默认 zstd 压缩源文件，decoder 流式解压并校验文件 MD5
• 每个 packet 内置 CRC，能尽早丢弃无 ECC 或低 ECC 下的错误 packet
• 单帧 Reed-Solomon ECC，支持交织，适合 GPU 编码/串流压缩造成的局部错误
• 线性喷泉码，支持丢帧、重复帧和冗余帧
• Windows encoder 使用原生无边框置顶窗口，不需要浏览器
• 常用 tile 符号集已编译进程序，单 exe 分发即可运行
• 新增 -backend qr，可用标准 QR code backend 和 symbols backend 做速度对比
• 支持从 ~/.autocimbar 读取 INI 配置，命令行参数会覆盖配置文件

编译

Linux/macOS:

export PATH=/usr/local/go/bin:$PATH
go test ./...
go build -o bin/encoder ./cmd/encoder
go build -o bin/decoder ./cmd/decoder
go build -o bin/tilegen ./cmd/tilegen

Linux/macOS 交叉编译 Windows:

GOOS=windows GOARCH=amd64 go build -o bin/encoder.exe ./cmd/encoder
GOOS=windows GOARCH=amd64 go build -o bin/decoder.exe ./cmd/decoder

GUI 程序（Windows）:

cd cmd/gui/frontend
npm install
npm run build
cd ../../..
GOOS=windows GOARCH=amd64 go build -ldflags="-H windowsgui" -o bin/gui.exe ./cmd/gui

快速使用

屏幕传输命令：

./bin/encoder -i input.bin -RQ 120 -r 0
./bin/decoder -RQ 120 -r 1

PNG 离线验证：

./bin/encoder -png -i input.bin -o frames -RQ 80
./bin/decoder -png -i frames -RQ 80

encoder 会把原始文件名作为一次性源数据元信息发送。decoder 默认输出到当前目录，并使用发送端文件名保存；如果 -o 指向一个目录，也会在该目录下使用发送端文件名。只有当 -o 指向具体文件路径时，才会强制使用该路径。

Windows GUI:

./bin/gui.exe
./bin/guilite.exe

GUI 提供 Sender 和 Receiver 两个独立面板，可以同时发送和接收；二维码/符号显示仍沿用原生 Windows 高性能置顶窗口。主界面暴露 RQ、屏幕选择和截图后端；Advanced 面板把必须两端一致的“帧格式”参数用高亮分组展示。GUI 会读取 ~/.autocimbar 的 [default] 和 [gui] 配置；未写 RQ 时会兼容旧的 Q 值。点击窗口 X 会退出程序；点击 To Tray 会最小化到系统托盘，托盘菜单可显示或退出程序。

guilite.exe 是简化版 GUI，仍包含 Sender 和 Receiver，只保留 RQ、屏幕、位置和 B。其它参数固定为 capture=gdi、cell=8t4s2c、ecc=3、packets=1、启用 zstd、fps=30，RQ 最大为 40，默认 26。

关键参数

帧格式参数，encoder 和 decoder 必须一致：

-backend        symbols 或 qr，默认 symbols
-c, -cell       紧凑 cell 规格，默认 8t4s2c
-ecc            单帧 Reed-Solomon ECC 百分比，默认 3
-p, -packets    每帧独立 packet 数
-no-zstd        encoder 关闭默认 zstd 压缩；decoder 从源数据头自动识别

运行参数：

-i              输入文件；decoder PNG 模式下为帧目录
-o              输出路径；encoder PNG 模式下为帧目录；decoder 默认当前目录，目录输出时使用发送端文件名
-RQ             以 8x8 tile 为基准的参考 Q，tile 变小时自动增大实际 Q
-Q              原始 grid/cell 数；设置 RQ 时优先使用 RQ
-B              cell 缩放倍数
-f, -fps        播放或截图帧率，默认 120
-r, -R          屏幕区域，格式 SCREEN、X:Y 或 SCREEN:X:Y
-png            使用 PNG 帧模式；默认是屏幕模式
-list-displays  查看屏幕编号和范围

decoder 截图后端参数：

-capture-backend auto|dxgi|gdi，默认 auto。DXGI 速度最高，但 HDR/系统颜色管理可能破坏高 color-bit 模式；遇到颜色识别失败时请使用 SDR 屏幕或切到 gdi。
-debug-capture   指定目录，保存前 60 张截图为 <cell>_NNN.png；目录不存在会自动创建
-symbols        外部 symbol PNG 目录；为空时使用内置符号

区域参数：

• -r 0：屏幕 0，默认右下角
• -r 1：屏幕 1，默认右下角
• -r 1:c:c：屏幕 1 居中
• -r c:c：屏幕 0 居中
• -r 1:100:200：屏幕 1 的 (100, 200)

查看屏幕编号：

./bin/encoder -list-displays
./bin/decoder -list-displays

Cell 和 Tile

默认 -c 8t4s2c 等价于：

-tile 8x8 -shape-bits 4 -color-bits 2

-cell 语法：

• 8t 表示 -tile 8x8
• 4s 表示 -shape-bits 4
• 2c 表示 -color-bits 2

高吞吐实验仍可手动指定 -c 4t4s8c。

生成新符号：

./bin/tilegen -tile 8x8 -shape-bits 6 -o generated-tiles/8x8_6bit_custom -seed 123 -attempts 20000

使用外部符号目录时，encoder 和 decoder 必须指定相同 -symbols、-tile 和 -shape-bits。

配置文件

程序启动时会读取 ~/.autocimbar。配置文件是 INI 格式，支持无 section、[default]、[encoder] 和 [decoder]。同名参数在命令行中显式指定时，会覆盖配置文件。

示例：

[default]
RQ = 120
B = 1
ecc = 3
cell = 8t4s2c
fps = 120

[encoder]
r = 0

[decoder]
r = 1
capture-backend = auto

配置 key 使用命令行参数名即可，例如 RQ、cell、packets、capture-backend；下划线会按短横线处理。

QR backend 的 -Q 含义

symbols backend 下，-Q 表示每边 cell 个数；默认 cell 是 8x8 tile 时，图像宽度约为 Q * 8 * B 像素。

QR backend 下，-Q 会映射到最接近的 QR version。QR 的真实模块数必须满足标准公式 17 + 4 * version，并且图像周围还有 quiet zone，所以它和 symbols backend 不是完全相同的 cell 个数。当前实现会按 8x8 参考 tile 缩放 QR 模块，让相同 -Q 下的显示面积更接近，但 QR 仍会因为 version 取整和 quiet zone 有尺寸差异。

decode 输出

decoder 每秒追加一行日志，方便保存后分析：

fields: cap=capture fps, dec=cell decode fps, pkt v/r/u=valid/repeat/useful packet fps, bad=invalid packet fps, spd=current KB/s, ema=smoothed KB/s

含义：

• cap：截图 FPS
• dec：完成 cell decode 的 FPS
• pkt v/r/u：有效 packet / 重复 packet / 实际提升喷泉码 rank 的 useful packet
• bad：CRC、ECC、参数或解析失败的 packet
• spd：当前窗口速度
• ema：近期滑动速度

完成后 decoder 会输出 summary，总时间从首个有效帧开始计算，不包含等待 encoder 启动的时间。

自动测试

go test ./...

测试覆盖 PNG 端到端、QR backend PNG 往返、ECC、packet CRC、喷泉码、zstd/MD5、动态 tile 符号集和 screen frame source。

当前限制

• 当前喷泉码是线性 XOR 方案，decoder 需要通过每帧中的 transfer size 推导 blockCount。
• Q/RQ、B、-ecc、-c、-packets、-backend 等参数是运行时约定，不写入每帧数据。
• -backend qr 用于对比，不是当前最高吞吐路径；最高吞吐路径仍是 symbols backend。
• 非 Windows 平台 encoder screen 模式使用 HTTP/浏览器 fallback。

Credits

• https://github.com/sz3/libcimbar

License

MIT