VDI 云桌面项目

面向 RK3528 云终端的“云—管—端”VDI 项目。当前已接通 Windows、Ubuntu、麒麟的 Moonlight/Sunshine 会话，仍处于终端 POC 与产品流程验证阶段。

文档入口

文档	内容
文档索引	全部维护文档、历史归档与原始需求
当前状态	三系统配置、最新实施结果与验证边界
终端说明	开机直达选择页、进出交接、快捷键、显示与构建
云桌面说明	编码、光标、客体电源按钮、USB
运维说明	日志、监控分工、排障和回退
云管开发说明	Go API、Vue 控制台、本机启动、接口与联调边界
未来计划	产品化与明确暂缓的 VPN、软件白名单、品牌画面

当前流程与边界

盒子开机 → LightDM 独占 kiosk → 选择云桌面 → Moonlight 串流 → 返回选择页

盒子使用私有 RKMPP 硬解/EGL，Windows 使用 NVENC，Linux 仍以软件编码为主。当前是 Xorg POC，Weston/Wayland 是后续方向；现场盒子已接入平台设备认证、授权列表和一次性连接票据，详见真实接入说明。正式边界为终端 → 自研平台 API → Proxmox，终端不直接管理 VM。

11-09 已修复退出露出绿色桌面和进入左上角小窗；三系统 X11 采样通过，尚无外置逐帧采集。详细版本与证据见当前状态，不将历史性能测试当作实时健康报告。

仓库结构

目录	职责
terminal/kiosk-shell/	Qt 全屏入口、会话、看门狗和显示守护
terminal/moonlight/、terminal/native-cursor/	私有硬解客户端补丁、Linux 原生光标
terminal/usb-monitor/	USB 存储设备透传 POC
terminal/meta-vdi/、terminal/vdt-agent/、terminal/ota-updater/	系统层、Agent 与 OTA 后续工作
platform/、console/、deploy/	Go API、Vue 管理台；演示部署与独立真实现场环境
tools/	管理员构建、部署、诊断与测试工具
docs/	主题说明、需求原件、历史归档与测试证据

运行监控由独立 vdi-monitor 项目 维护；本仓库保存实现、验证与回退资料。监控最新快照和 7 天指标不能替代全部历史证据。

构建与配置

在具备 Qt5 开发依赖的 ARM64 环境：

cd terminal/kiosk-shell
cmake -G Ninja -B build -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTING=ON
cmake --build build
QT_QPA_PLATFORM=offscreen ctest --test-dir build --output-on-failure

产物为 kiosk-shell、vdi-kiosk-monitor。产品连接配置在盒子 ~/.config/vdi-terminal/desktops.json，基础配置为 client.conf；moonlight.conf 仅供旧独立调试入口使用。完整部署和客户端构建入口见终端说明。

开发约定

保留用户已有改动；事实、计划和待验收结论分开记录。正式需求来源保留于 docs/ 的三份 Word，后续明确确认的实现与当前用户要求优先于旧历史描述。账号、密码、私钥和连接票据通过安全配置提供，不新增到文档或提交。

日常直接更新对应主题，计划统一维护在 docs/roadmap.md；测试输出放入 docs/evidence/<专题-日期>/。2026-11-09 以前的零散记录及本次整理前的三份根说明完整保留在历史归档。