# 继续开发前必读

完整对话总结在：`D:\DAIMA\vdi-cloud\PROJECT_CONTEXT.md`

## 当前状态
- 项目目录：`D:\DAIMA\vdi-cloud`
- 终端盒子：RK3528 PRO DDR4，Armbian Ubuntu Noble，aarch64，IP `192.168.1.188`
- 当前图形：LightDM + Xorg；正式文档要求 Weston + Wayland + Qt，当前只是 POC
- Proxmox：9.2.2，Windows 10 22H2 VM `192.168.1.70:3389`，用户 `test1`
- FreeRDP 3.32.1 已安装，命令 `xfreerdp3`
- `kiosk-shell` 已按 Qt/C++ + libfreerdp3 内嵌实现，已真实显示 Windows 10 远程桌面
- 代码位置：`terminal/kiosk-shell`
- 远程安装路径：`~/vdi-terminal/bin/kiosk-shell`

## 必须遵守
- 所有实现严格参考用户提供的两个正式 Word 和会议纪要；文档未确定的技术只能标记待调研，不得擅自定版。
- 终端先做，后接自研管理平台 API；终端不直接调用 Proxmox API。
- 正式状态机：`BOOT -> CONFIG -> CONNECTING -> SESSION -> RECONNECT -> ERROR`
- 正式 Kiosk 选型：Weston + Wayland + Qt；FreeRDP 以 libfreerdp3 API 内嵌，不拉外部进程。
- `/cert:ignore`、空密码仅限局域网 POC。
- 项目经理新增待调研：RDP 是否适合 GPU/CAD/3D；研究 Moonlight/Sunshine，但不要在调研前删除 RDP、确定 Moonlight 参数或定版双协议。

## 已知关键结论
- WiFi：约 -47 dBm，协商约 200 Mbps，零丢包/重传；卷帘问题不能简单归因于 WiFi。
- HDMI 当前原生：`1920x1440@75Hz`，不要请求不存在的 2560x1440 模式。
- `/dev/mpp_service`、`/dev/rga` 存在，但 `mppvideodec` GStreamer 插件未确认；Weston/DRM 零拷贝待验证。
- FreeRDP 3：`gdi_init` 必须在 PostConnect；NLA 空密码传 `strdup("")`；BGRX32 需转换为 Qt RGB；`/gfx` 是能力组合语义。

## 尚未完成
- Monitor 编译/崩溃/假死重启测试
- 开机自启
- 网络状态显示修复确认
- Weston/DRM/mppvideodec
- 后端 API 注册、配置、MQTT 心跳
- P100 GPU 直通及 CUDA/CAD/3D
- Moonlight/Sunshine 调研

先读 `PROJECT_CONTEXT.md`，再查看 `git status`，不要丢弃未提交改动。