文档:同步云管功能进度与现场验收记录

This commit is contained in:
songyiming committed 2026-11-10 17:53:20 +08:00
1 parent 6134d49c16
commit 5ac692724d
179 files changed
+8311 -9

No files matched your search

+17
View File
@@ -9,6 +9,12 @@
产品入口由 LightDM 管理 `vdi-kiosk` 独占会话,再运行 `vdi-kiosk-start → vdi-kiosk-monitor → kiosk-shell`。开机直接进入“选择云桌面”,不再通过普通 MATE 桌面或旧登录页中转。Moonlight 只在选择桌面后启动,不能与 kiosk 分别设置开机自启。
11-10 补充:真实平台接入后的启动认证原先只尝试一次,任一失败都会跳回旧的用户名/密码页,并且不再认证。已改为先绘制选择页,再异步进行设备认证;失败留在该页显示自动重试提示,按 2/4/8/16/30 秒退避(请求完成后再计时),恢复后自动加载授权桌面。认证完成前不读取本地桌面作为授权、不发连接票据,不并发重复认证。设备撤销、配置错误同样不会回到旧登录页,但仍需管理员处理实际授权/配置问题。
用户首次启动失败的具体网络/TLS/HTTP 原因没有足够旧日志,不能仅凭第二次开机正常确定是哪一项。新增诊断只记录认证请求 HTTP 状态和网络错误码、重试间隔,不记录身份凭据或请求正文。回归结果见 [boot-auth-20261110](evidence/boot-auth-20261110/)。
部署/验证:11-10 盒子 ARM64 构建 CTest 4/4 通过;新增真实 HTTPS 隔离测试覆盖首次离线后恢复、403 后恢复、慢认证不重叠、同步配置错误、本地模式五个场景。只原子替换 kiosk-shell,由原看门狗重启子进程;当前进程认证 ready、平台授权列表 200/三桌面、独占会话与选择页截图核对通过,boot ID 未变,未再次断电验证。kiosk-shell SHA256 为 `9dba9c66092aa9ccf67477b305aaefe09f52eabb8c6b30dbbcbb1ce43dc7a6a6`;备份在 `~/vdi-terminal/backups/boot-device-auth-20261110/`。Moonlight 与光标校验配置未变。
主要配置/实现入口:
- [LightDM 配置](../terminal/kiosk-shell/etc/92-vdi-kiosk.conf)、[会话定义](../terminal/kiosk-shell/vdi-kiosk-session.desktop)、[启动脚本](../terminal/kiosk-shell/scripts/vdi-kiosk-start)。
@@ -75,3 +81,14 @@ QT_QPA_PLATFORM=offscreen ctest --test-dir build --output-on-failure
旧二进制和 Linux 光标配置备份在盒子 `~/vdi-terminal/backups/return-surface-20261109/`。回退必须同时匹配 Moonlight 二进制与两台 Linux 原生光标 profile 中的客户端 SHA,不能只换二进制。显示守护旧文件备份为 `~/vdi-terminal/backups/display-guard-20261103-095920/`,恢复旧布局也会恢复原先的显示回退风险。
当日 CTest 3/3、原生光标边界测试 4/4 通过;完整实验过程及较早版本校验值见[归档](archive/README.md)。
## 运维策略(2026-11-10)
客户端 `qt-platform/0.4.0`(从 0.3.0 起)支持平台配置的心跳、命令检查和桌面列表刷新间隔。每 15 秒检查新版本,安全写入 `~/.config/vdi-terminal/policy.json`(0600)后更新运行定时器并回执;身份仍保存在原 `platform.json`,不要混用。新下发失败时保留原运行配置,原因在控制台「终端策略 → 设备结果」查看。
当前 kiosk-shell SHA256 `690a74ee5b077ff96e385f2ba45ca756f1879223f7433e63ec1833eb0f3a628b`,更新前备份 `~/vdi-terminal/backups/policy-20261110/kiosk-shell`;CTest 已增至 5 项并全部通过。真实盒子完成改变管理间隔及恢复默认的设备回执验证,保留之前启动认证重试与全屏交接修复。该次未测试断电、长时间离线或活动串流中下发。见[策略说明](cloud-terminal-policies-20261110.md)。
## 平台系统指标
`qt-platform/0.4.0` 在心跳中上报真实 CPU 使用率、内存使用率、SoC 温度和运行时长,沿用心跳策略(现场 30 秒)。控制台入口为「终端管理 → 详情 → 查看运行指标」,可查最近 1 小时/24 小时/7 天,历史保留 30 天。CPU 第一次采样为空;缺失传感器和离线过期数据不填零。不会更改串流参数,实际 FPS/RTT 仍未采集。定义与验收见[终端系统指标](cloud-terminal-metrics-20261110.md)。