remote/Cargo.toml

[workspace]
resolver = "2"
# agent-core：平台无关会话层 + 软件编码视频管线（当前仅 linux-agent 使用）
# linux-agent：Linux 被控端（X11 + XTest）
members = ["common", "agent-core", "agent", "linux-agent", "viewer"]
# 默认成员保持 Windows 三件套，`cargo build --release` 行为与改动前完全一致；
# Linux 被控端显式构建：`cargo build --release -p linux-agent`
default-members = ["common", "agent", "viewer"]

[workspace.dependencies]
anyhow = "1"
serde = { version = "1", features = ["derive"] }
bincode = "1.3"
tokio = { version = "1", features = ["full"] }
quinn = "0.11"
rustls = { version = "0.23", default-features = false, features = ["ring", "std", "logging"] }
rcgen = { version = "0.13", default-features = false, features = ["ring", "pem"] }
lz4_flex = "0.11"
windows = "0.62"
minifb = "0.27"
-												init: MVP remote desktop (agent/viewer/common) with H.264 pipeline

											
										
										
											2026-10-22 21:17:55 -04:00
+								[workspace]
 								resolver = "2"
-												feat(agent): 新增 agent-core 与 Linux 被控端（X11 + XTest，纯新增不动 agent/）

本期只在新增文件里做，**未改动 Windows agent/ 一个字节**（与 NVENC 线并行，避免争抢）。

- 新增 agent-core：平台无关会话层 —— QUIC/TLS 握手、传输调优（沿用 512KB 发送窗口
  结论）、验证码认证、会话/select 循环、latest-wins 单槽、输入分发，以及软件编码
  视频管线（openh264）。同步跟进协议新增的 Pong{lost,sent} 下行丢包统计字段
- 新增 linux-agent：X11 GetImage 采集 + 整帧变更检测；XTest 注入 + 扫描码→X11
  keycode 映射（主键区 = scancode+8，E0 扩展键必须查表，含单元测试）
- 协议零改动：复用 Set-1 扫描码与虚拟桌面归一化坐标，viewer 无需任何修改
- 新增端到端冒烟测试 tests/smoke.rs 与 scripts/linux-smoke.sh（自建 Xvfb，无需
  图形桌面）：采集→编码→QUIC 解帧、认证（含错误码拒绝）、Ping/Pong（含丢包字段）、
  静止桌面关键帧恢复、输入注入实证（注入后从另一条 X11 连接读回指针真实坐标）
- 该关键帧用例做过变异测试：把修复退回会失败、恢复后通过，确认断言有效
- .gitattributes：shell 脚本强制 LF（Windows checkout 成 CRLF 会导致容器内无法执行）
- 手册：修正已失效的工具链路径；补充 cargo 镜像；新增第 8 节（Linux）与 6.1 节
  （三条待修问题，含两条 Windows 侧仍存在的关键帧缺陷）

验证：
- Linux(容器, USTC 源 + Xvfb): cargo test -p linux-agent 通过，2 passed
- Windows: 本期未改 agent/，default-members 未变，`cargo build --release` 行为不变

											
										
										
											2026-10-23 01:31:07 -04:00
+								# agent-core：平台无关会话层 + 软件编码视频管线（当前仅 linux-agent 使用）
 								# linux-agent：Linux 被控端（X11 + XTest）
 								members = ["common", "agent-core", "agent", "linux-agent", "viewer"]
 								# 默认成员保持 Windows 三件套，`cargo build --release` 行为与改动前完全一致；
 								# Linux 被控端显式构建：`cargo build --release -p linux-agent`
 								default-members = ["common", "agent", "viewer"]
-												init: MVP remote desktop (agent/viewer/common) with H.264 pipeline

											
										
										
											2026-10-22 21:17:55 -04:00
 								[workspace.dependencies]
 								anyhow = "1"
 								serde = { version = "1", features = ["derive"] }
 								bincode = "1.3"
 								tokio = { version = "1", features = ["full"] }
 								quinn = "0.11"
 								rustls = { version = "0.23", default-features = false, features = ["ring", "std", "logging"] }
 								rcgen = { version = "0.13", default-features = false, features = ["ring", "pem"] }
 								lz4_flex = "0.11"
-												feat(agent): NVENC 硬编接入（GPU 零拷贝 ARGB 直通，软编自动兜底）

- 编码器自动选择：NVENC（H264 High/CBR 5Mbps/UltraLowLatency/无B帧/按需IDR）→ openh264 兜底
- Duplication 增加 GPU 中间纹理（B8G8R8A8 DEFAULT），NVENC register_resource_dx11 直读，颜色转换完全省略
- KeyFrameReq → encode_picture(picture_type=IDR)，静止 500ms 重编码 P 帧
- windows 0.58→0.62（nvenc crate 依赖 0.62，运行时 dlopen nvEncodeAPI64.dll 零 SDK 依赖）
- 实测（GTX 1650 Ti 回环）：encode 41ms→4ms/帧（10x），convert 0ms，viewer 解码正常

											
										
										
											2026-10-22 22:18:29 -04:00
+								windows = "0.62"
-												init: MVP remote desktop (agent/viewer/common) with H.264 pipeline

											
										
										
											2026-10-22 21:17:55 -04:00
+								minifb = "0.27"