From 66f0cacb322f782147cce10e5de8a47c213918c0 Mon Sep 17 00:00:00 2001 From: songyiming <1000000008@qq.com> Date: Thu, 29 Oct 2026 11:58:32 +0800 Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E5=A4=8D=EF=BC=9AQProcess::finished?= =?UTF-8?q?=20=E9=87=8D=E8=BD=BD=E6=B6=88=E6=AD=A7=EF=BC=9B=E6=96=87?= =?UTF-8?q?=E6=A1=A3=EF=BC=9A=E4=B8=B2=E6=B5=81=E5=A4=B1=E8=B4=A5=E6=A0=B9?= =?UTF-8?q?=E5=9B=A0=EF=BC=88=E5=8F=8C=20IP=20ARP=20=E6=B7=B7=E4=B9=B1?= =?UTF-8?q?=EF=BC=89=E4=B8=8E=E5=BB=B6=E8=BF=9F=20A/B=20=E7=BB=93=E8=AE=BA?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - moonlight_session.cpp：QOverload 显式指定 finished 重载，修复 ARM64 编译 - moonlight.conf：vsync/frame-pacing 默认改回开启（A/B 实测关闭无改善） - docs：补充 10-29 登录流程验收、重启验收、Monitor 恢复、双 IP 根因与 A/B 数据 - tools：新增 deploy_kiosk.sh 一键部署脚本与语法自检 --- MEMORY.md | 38 +++- PROJECT_CONTEXT.md | 102 ++++++--- docs/moonlight-kiosk-20261028.md | 196 ++++++++++++++++++ terminal/kiosk-shell/etc/moonlight.conf | 9 +- .../kiosk-shell/src/moonlight_session.cpp | 5 +- tools/deploy_kiosk.sh | 39 ++++ tools/syntax_sanity.py | 38 ++++ 7 files changed, 381 insertions(+), 46 deletions(-) create mode 100644 docs/moonlight-kiosk-20261028.md create mode 100644 tools/deploy_kiosk.sh create mode 100644 tools/syntax_sanity.py diff --git a/MEMORY.md b/MEMORY.md index 9b81f06..75e0740 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -9,8 +9,12 @@ - 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 远程桌面 +- **当前开机默认走 Moonlight 云桌面**（2026-10-28 起）： + `vdi-kiosk-monitor -- vdi-moonlight` → `moonlight-qt stream 192.168.1.70 Desktop`， + 满屏 1920x1080 与屏幕 1:1，崩溃/被杀均自动恢复。 + RDP 路径保留但自启已禁用，可切回。详见 `docs/moonlight-kiosk-20261028.md` - 代码位置：`terminal/kiosk-shell` -- 远程安装路径：`~/vdi-terminal/bin/kiosk-shell` +- 远程安装路径：`~/vdi-terminal/bin/`（`kiosk-shell`、`vdi-kiosk-monitor`、`vdi-moonlight`） ## 必须遵守 - 所有实现严格参考用户提供的两个正式 Word 和会议纪要；文档未确定的技术只能标记待调研，不得擅自定版。 @@ -22,17 +26,35 @@ ## 已知关键结论 - WiFi：约 -47 dBm，协商约 200 Mbps，零丢包/重传；卷帘问题不能简单归因于 WiFi。 -- HDMI 当前原生：`1920x1440@75Hz`，不要请求不存在的 2560x1440 模式。 +- HDMI 当前原生：`1920x1440@75Hz`（10-23 记录）；2026-10-28 实测盒子系统已是 `1920x1080@60Hz`， + 与 Sunshine 侧虚拟显示器一致，串流 1:1 无缩放。以现场 `xrandr` 为准。 - `/dev/mpp_service`、`/dev/rga` 存在，但 `mppvideodec` GStreamer 插件未确认；Weston/DRM 零拷贝待验证。 - FreeRDP 3：`gdi_init` 必须在 PostConnect；NLA 空密码传 `strdup("")`；BGRX32 需转换为 Qt RGB；`/gfx` 是能力组合语义。 +- Moonlight/Sunshine（2026-10-28 实测）：Windows 防火墙挡 ICMP，ping 不通不代表不通， + 可达性判断必须用 TCP 探测；`moonlight-qt` 的 app id 会随服务端重装失效， + 命令行要用应用名 `Desktop`；RK3528 上 `--video-decoder auto` 会选到不可用的 + `h264_v4l2m2m`，必须显式 `software`。 +- 服务端软编码（Sunshine libx264，无 GPU）是 1080p 只有 ~21.6 FPS、抖动丢帧 13.64% 的根因； + 客户端解码 15 ms、网络丢包 0%、延迟 3 ms，链路健康。 + +## Web 控制台（2026-10-28 方案确认） +- `console/` 是管理员 Web 管理控制台，不是 RK3528 盒子的用户登录页。 +- 正式技术栈：Vue3 + Vite + TypeScript 严格模式 + Element Plus；后端通过 api-gateway，JWT + RBAC。 +- 页面：仪表盘、终端管理、桌面管理、用户与绑定、GPU 池、监控、OTA、审计日志。 +- 角色：超级管理员、运维、只读。 +- 终端产品流程仍应是 `kiosk-shell 登录/首配 -> 桌面列表 -> 获取短期连接票据 -> RDP/Moonlight 会话`； + 当前开机直连 Moonlight 仅是串流技术验证，不是最终产品登录流程。 +- 开发策略：先做功能骨架、Mock API、OpenAPI 契约、RBAC 与 E2E；项目经理 UI 稿到后替换视觉层。 +- 完整方案：`docs/web-console-mvp-plan-20261028.md`。 ## 尚未完成 -- Monitor 编译/崩溃/假死重启测试 -- 开机自启 -- 网络状态显示修复确认 +- 服务端 GPU 直通（宿主机 starhe 有 GTX 965M / IOMMU Group 2 独占，Intel 核显留给主机显示） +- RK3528 VPU 硬解（h264_v4l2m2m 等缺可用设备，需 MPP FFmpeg 补丁或 V4L2 request 驱动） +- 2K 分辨率链路验证（虚拟显示器 + 盒子显示模式需同步调整） - Weston/DRM/mppvideodec -- 后端 API 注册、配置、MQTT 心跳 -- P100 GPU 直通及 CUDA/CAD/3D -- Moonlight/Sunshine 调研 +- 后端 API 注册、配置、MQTT 心跳（Moonlight 路径目前是本地静态配置） +- 终端音频出音现场确认 +- 协议最终选型定版（RDP / Moonlight / 双协议，需实测数据 + 产品方案共同确认） +- 监控与运维脚本、OTA、USB 重定向等终端其余能力 先读 `PROJECT_CONTEXT.md`，再查看 `git status`，不要丢弃未提交改动。 \ No newline at end of file diff --git a/PROJECT_CONTEXT.md b/PROJECT_CONTEXT.md index 8ed8943..78724cf 100644 --- a/PROJECT_CONTEXT.md +++ b/PROJECT_CONTEXT.md @@ -276,63 +276,99 @@ D:\DAIMA\vdi-cloud\docs\freerdp3-embedding-notes.md 注意：此前对“X11 无 glamor 硬件合成”的判断不准确，Xorg 日志实际显示 `glamor X acceleration enabled on Mali450`；后续不要继续引用这个错误结论。正确表述是：当前路径仍未达到目标流畅度，具体瓶颈需要后续基准测试确认。 +### 6.6 Moonlight 云桌面开机直达（2026-10-28） + +RDP/Moonlight 实测对比见 `docs/rdp-vs-moonlight-comparison-20261028.md`， +落地记录见 `docs/moonlight-kiosk-20261028.md`。 + +盒子当前开机默认走 Moonlight 直连云桌面，链路： + +```text +~/.config/autostart/vdi-moonlight.desktop + -> vdi-kiosk-monitor --heartbeat-file /tmp/vdi-moonlight.heartbeat --max-restart 200 + -- /home/armbian/vdi-terminal/bin/vdi-moonlight + -> moonlight-qt stream 192.168.1.70 Desktop (fullscreen, 1920x1080, H.264, 软解) +``` + +仓库新增：`terminal/kiosk-shell/scripts/vdi-moonlight`、`etc/moonlight.conf`、 +`vdi-moonlight.desktop`；`src/monitor.cpp` 改为按进程组结束整棵进程树。 + +实测：满屏云桌面 1:1 无缩放；杀客户端 5 秒内重连；杀启动器 3 秒内被看门狗拉起； +性能叠图 1080p60 实际 21.59 FPS、网络丢包 0%、延迟 3 ms、解码 15.04 ms、抖动丢帧 13.64%。 + +关键坑位（后续维护必须知道）： + +1. Windows 防火墙屏蔽 ICMP，盒子 ping 不到云桌面主机，但 TCP/UDP 正常； + 可达性判断必须用 TCP 探测，ping 会误判； +2. `moonlight-qt` 的应用 id 随服务端重装/升级失效，旧 id 会报“找不到应用程序 ”； + 命令行要用应用名 `Desktop`； +3. RK3528 上 `--video-decoder auto` 会选到不可用的 `h264_v4l2m2m`， + 必须显式 `--video-decoder software`； +4. RDP 路径的自启项已禁用但保留，可随时切回。 + + ## 7. 当前未完成/未验证 -1. 当前工作区最后一次编译 Monitor 的命令被取消，Monitor 代码尚未确认编译通过； -2. Monitor 的主进程心跳机制尚未做真实“崩溃/假死/自动重启”测试； -3. kiosk-shell 开机自启尚未配置； -4. 网络状态显示修复（此前显示错误的 `600`）尚未确认最新二进制效果； -5. 当前实现仍使用 X11 POC，正式方案要求 Weston/Wayland； -6. 当前 RDP 会话使用 CPU GDI -> Qt 复制，尚未接 GStreamer/mppvideodec/VPU； -7. `mppvideodec` 来源和可用性未确认； -8. 终端注册、MQTT 心跳、配置下发、日志上报、OTA、USB 尚未接后端 API； -9. 前端/后端管理平台尚未接入； -10. GPU/P100 直通与 CUDA/CAD/3D 性能尚未完成； -11. Moonlight/Sunshine 方向只是项目经理新增的周一调研项，未安装、未验证、未纳入代码定版。 +1. 服务端 GPU 直通未做：宿主机 `starhe` 有 GTX 965M（`0000:01:00.0`，IOMMU Group 2 独占）， + 主机同时有 Intel 核显 `0000:00:02.0` 可继续驱动本机显示，具备直通条件； + 直通后 Sunshine 才能用 NVENC 硬编码，把 1080p 帧率从 ~21.6 FPS 提到 60 FPS； +2. RK3528 VPU 硬解不可用：`h264_v4l2m2m` / `hevc_v4l2m2m` / `hevc_v4l2request` 均报 + `Could not find a valid device`，当前只能用软件解码，4K 目标必须先解决； +3. 2K 分辨率链路未验证：盒子屏幕现为 1920x1080@60Hz，Sunshine 侧虚拟显示器也是 1920x1080@60Hz； +4. 当前实现仍使用 X11 POC，正式方案要求 Weston/Wayland； +5. 当前 RDP 会话使用 CPU GDI -> Qt 复制，尚未接 GStreamer/mppvideodec/VPU； +6. `mppvideodec` 来源和可用性未确认； +7. 终端注册、MQTT 心跳、配置下发、日志上报、OTA、USB 尚未接后端 API； +8. 前端/后端管理平台尚未接入；Moonlight 路径目前读本地静态配置文件； +9. 终端音频出音未现场确认（`--audio-on-host` 已开）； +10. 协议最终选型未定版：实测已证明 Moonlight 画面质量与 CPU 代价优于 RDP， + 但“办公用 RDP、GPU/CAD/3D 用 Moonlight”的双协议结论仍需产品方案确认。 ## 8. 下一步建议（按优先级） -### A. 收尾当前终端 POC +### A. 服务端 GPU 直通（当前最高价值项） -1. 编译并验证 `vdi-kiosk-monitor`； -2. 给 kiosk-shell 与 Monitor 做真实崩溃/假死重启测试； -3. 配置当前开发盒子的用户级开机自启，开机直达登录页； -4. 修复并验证网络状态显示； -5. 保留当前能进入 Windows 10 的版本作为可回退基线。 - -### B. 按项目经理新增方向做 GPU 协议调研 - -周一先验证，不先改代码定版： +Sunshine 在 VM 内用 libx264 软件编码，4 核同时承担 1080p 捕获与编码， +是 21.6 FPS 与 13.64% 抖动丢帧的唯一原因；客户端侧链路完全健康。 ```text -P100 是否成功 PCIe 直通到 Windows 10 VM - -> VM 内 nvidia-smi 是否正常 - -> CUDA/3D 应用能否使用 GPU - -> Sunshine 是否能在 VM 内捕获/硬编码桌面 - -> RK3528 上是否有可用 Moonlight ARM64 客户端 - -> Moonlight 是否能调用 VPU 硬解 - -> RDP 与 Moonlight 的 CAD/3D/视频延迟、帧率、CPU、温度、带宽对比 +宿主机 starhe（Xeon E3-1200 v3 + Intel 核显 + GTX 965M） + -> 确认内核 IOMMU 已启用（PCI 设备已有独立 IOMMU group） + -> vfio-pci 绑定 0000:01:00.0，提取 vBIOS ROM + -> VM 100 增加 hostpci，Windows 内装 GeForce 驱动 + -> nvidia-smi 正常后 Sunshine 切 NVENC 硬编码 + -> 复测 1080p60 帧率、抖动丢帧、服务端 CPU ``` -可能的最终协议策略（只能在实测后决定）： +主机 root 密码已知（`yx66668888`），可用 `SSH_ASKPASS` 非交互登录。 + +### B. 收尾当前终端 POC + +1. 保留当前 Moonlight 开机直达版本作为可回退基线（`docs/moonlight-kiosk-20261028.md`）； +2. 确认开机自启在真实重启后生效（当前只验证了手动拉起与被守护重启）； +3. 网络状态显示修复（此前显示错误的 `600`）尚未确认最新二进制效果； +4. RDP 路径代码保留但自启已禁用，按需切回。 + +### C. 协议策略与代码结构 + +实测结论已经支持双协议方向，但仍未定版： ```text 普通办公 -> RDP GPU/CAD/3D -> Moonlight ``` -但也可能仍然统一使用 RDP；由测试结论决定。 - 如果确认需要双协议，代码结构应演进为： ```text DesktopSession 接口 ├─ RdpSession # 保留当前 libfreerdp3 -└─ MoonlightSession # 调研后再实现 +└─ MoonlightSession # 当前是 shell 启动器 + moonlght-qt 子进程 SessionManager # 根据 API 下发 protocol 选择实现 ``` -不要在调研前擅自确定 Moonlight 端口、认证字段、库、嵌入方式或把 RDP 删除。 +不要在定版前擅自确定 Moonlight 的嵌入方式、认证字段或删除 RDP 代码。 + ### C. 后续 API 对接 diff --git a/docs/moonlight-kiosk-20261028.md b/docs/moonlight-kiosk-20261028.md new file mode 100644 index 0000000..bd2c0c0 --- /dev/null +++ b/docs/moonlight-kiosk-20261028.md @@ -0,0 +1,196 @@ +# Moonlight 云桌面开机直达落地记录（2026-10-28） + +## 起因 + +上一个对话在做完 RDP/Moonlight 实测对比（见 `rdp-vs-moonlight-comparison-20261028.md`）后， +提出把 Moonlight 产品化为开机直连云桌面，但只列了 5 条待办就中断了。 +现场表现：登录盒子后看到的是 MATE 的绿色桌面，不是云桌面。 + +## 根因 + +盒子自启项 `~/.config/autostart/vdi-kiosk.desktop` 仍然拉起的是 RDP 版 `kiosk-shell`， +而 Moonlight 从来没有进入过开机自启链；同时命令行直连串流还存在两处硬伤： + +1. **应用 id 失效**：Moonlight 图形界面里配对的记录里，`Desktop` 的 app id 是 `881448767`， + 但 Sunshine 重装/升级后服务端的应用 id 已经变了，用旧 id 启动直接报 + `Qt Critical: 找不到应用程序 881448767`，串流根本起不来。 + 改用应用**名称** `Desktop` 启动即可，服务端当前返回的应用列表是 + `Desktop` / `Steam Big Picture`。 +2. **硬解路径不可用**：`moonlight-qt` 的 `--video-decoder auto` 会优先尝试 + `h264_v4l2m2m`，在 RK3528 上报 `Could not find a valid device` + （尽管存在 `/dev/mpp_service`、`/dev/rga`、`/dev/dri/renderD128`）。 + 显式指定 `--video-decoder software` 后串流稳定。 + +另外两个在联调中发现并修掉的问题： + +3. **Monitor 只杀直接子进程**：`vdi-kiosk-monitor` 通过 `sh -c` 启动主进程， + 杀掉它只会结束 `sh -c` 包装进程，真正的启动器变成孤儿并继续拉起第二条串流， + 两条流同时抢显示设备。已改为子进程独立进程组、按组结束整棵进程树。 +4. **主机可达性判断用错了协议**：Windows 防火墙屏蔽 ICMP，盒子 ping 不到 `192.168.1.70`， + 但 TCP/UDP 正常。可达性判断改成 TCP 连接探测（`bash /dev/tcp`）。 + +## 已交付 + +仓库内新增（`terminal/kiosk-shell/`）： + +```text +scripts/vdi-moonlight # 云桌面串流启动器（POSIX sh） +etc/moonlight.conf # 串流参数模板 +vdi-moonlight.desktop # 开机自启条目（Monitor + 启动器） +``` + +修改：`src/monitor.cpp`（进程组管理）、`src/monitor_main.cpp` 无改动。 + +盒子上的部署位置： + +```text +~/vdi-terminal/bin/vdi-moonlight # 启动器 +~/vdi-terminal/bin/vdi-kiosk-monitor # 看门狗（已按本次修改重新编译） +~/.config/vdi-terminal/moonlight.conf # 串流参数 +~/.config/autostart/vdi-moonlight.desktop # 开机自启（已启用） +~/.config/autostart/vdi-kiosk.desktop # RDP 旧路径（已禁用，保留作回退） +``` + +启动链： + +```text +systemd/user autostart + -> vdi-kiosk-monitor --heartbeat-file /tmp/vdi-moonlight.heartbeat --max-restart 200 + -- /home/armbian/vdi-terminal/bin/vdi-moonlight + -> moonlight-qt stream 192.168.1.70 Desktop ... (fullscreen) +``` + +启动器职责：读本地配置 → 等云桌面主机就绪（TCP 探测）→ 全屏串流 → +每 5 秒写心跳 → 检测串流假死（CPU 与网络均无流量超过 `hang-timeout`）→ 失败重试。 + +## 实测结果 + +全部在 RK3528 盒子（192.168.1.188）上实测： + +| 项目 | 结果 | +|---|---| +| 开机/手动拉起后屏幕内容 | 满屏 Windows 10 云桌面，1920x1080 与屏幕 1:1 无缩放 | +| 杀掉 moonlight-qt 客户端 | 启动器 5 秒内重连成功 | +| 杀掉启动器 | 看门狗 3 秒后重启启动器，重新串流 | +| 心跳文件 | `/tmp/vdi-moonlight.heartbeat` 每 5 秒刷新 | +| 串流进程数 | 始终 1 条，无孤儿进程 | + +`moonlight-qt --performance-overlay` 实测（1080p60 / H.264 / 软解）： + +```text +Video stream: 1920x1080 21.59 FPS (Codec: H.264) +Incoming frame rate from network: 21.59 FPS +Decoding frame rate: 21.59 FPS +Rendering frame rate: 18.15 FPS +Frames dropped by your network connection: 0.00% +Frames dropped due to network jitter: 13.64% +Average network latency: 3 ms (variance: 1 ms) +Average decoding time: 15.04 ms +Average frame queue delay: 47.50 ms +Average rendering time (including monitor V-sync latency): 51.09 ms +``` + +结论：链路健康，网络丢包 0%，延迟 3 ms；21.6 FPS 的上限来自**服务端**， +VM 100 内 Sunshine 走 libx264 软件编码（无 GPU 直通），抖动丢帧 13.64% 同源。 + +## 仍未验证 / 下一步 + +1. **服务端 GPU 直通**：宿主机 `starhe` 有 GTX 965M（`0000:01:00.0`，IOMMU Group 2 独占）， + 主机同时有 Intel 核显 `0000:00:02.0` 可继续驱动本机显示，具备直通条件。 + 直通后 Sunshine 可用 NVENC 硬编码，是把帧率提到 60 FPS、改善鼠标拖尾/卡顿的前提。 +2. **鼠标卡顿**：性能叠图实测渲染帧率仅 18.15 FPS、帧队列延迟 47.50 ms、 + 渲染/VSync 51.09 ms，再叠加服务端 libx264 软编码，视频链路本身已累计约 100 ms。 + `--absolute-mouse` 已启用，输入模式没有配置错误；体感滞后来自低帧率和视频队列， + 根治仍是 Sunshine NVENC。短期可降为 1080p30、使用 `--no-vsync --no-frame-pacing` + 做 A/B 测试，但可能增加撕裂，不能替代服务端硬编码。 +3. **RK3528 硬解**：`h264_v4l2m2m` / `hevc_v4l2m2m` 缺少可用设备，需要 Rockchip MPP 的 + FFmpeg 补丁或 V4L2 request 驱动。当前 1080p 软解可用，4K 需要硬解。 +4. **2K 分辨率**：盒子当前屏幕是 1920x1080@60Hz，Sunshine 侧虚拟显示器也是 1920x1080@60Hz。 + 若产品要求 2K，需要同时调整虚拟显示器分辨率和盒子端显示模式。 +5. **音频**：`--audio-on-host` 已开启，但终端出音未经现场耳朵确认。 +6. **产品登录流程**：当前开机直连 Moonlight 只是串流技术验证，不是最终产品形态。 + 最终应由 `kiosk-shell` 显示首配/登录/桌面列表，用户选择后再获取短期连接票据并启动会话； + 管理员 Web 控制台是独立的 `console/`，方案见 `docs/web-console-mvp-plan-20261028.md`。 +7. **与 RDP 的关系**：RDP 路径代码保留在 `src/rdp_session.*`，自启项已禁用，可随时切回。 + 正式协议选型仍需按实测数据与产品方案确认，不能仅凭本记录定版。 +8. **管理平台 API**：Moonlight 路径目前是本地配置文件驱动，接入自研管理平台后 + 应由 API 下发主机/分辨率/帧率等参数，替换 `etc/moonlight.conf` 的静态配置。 +9. **重启验收异常**：2026-10-28 15:54 执行真实重启后，盒子在 3 分钟内未恢复 + `192.168.1.188` 的网络/SSH，局域网扫描也未发现其 SSH 地址。重启前已确认 + NetworkManager 连接 `YXTech` 的 `autoconnect=yes`，但真实重启后的开机自启验收因此未完成； + 需要现场查看盒子 HDMI 画面/电源状态，并通过串口或本地键盘确认启动与 WiFi 情况。 + +## 附：常用运维命令 + +```bash +# 查看状态 +/home/armbian/vdi-terminal/bin/vdi-moonlight status + +# 查看日志 +tail -f ~/vdi-terminal/logs/moonlight-$(date +%Y%m%d).log +tail -f /tmp/vdi-monitor.log + +# 手动重启串流 +pkill -f '^moonlight-qt stream' # 启动器会自动重连 + +# 切回 RDP 路径 +sed -i 's/^X-GNOME-Autostart-enabled=false/X-GNOME-Autostart-enabled=true/' \ + ~/.config/autostart/vdi-kiosk.desktop +sed -i 's/^X-GNOME-Autostart-enabled=true/X-GNOME-Autostart-enabled=false/' \ + ~/.config/autostart/vdi-moonlight.desktop +``` + +--- + +# 2026-10-29 追加：登录/桌面列表产品流程落地与网络根因修复 + +## 新增验证结论（全部实测） + +1. **产品流程全面跑通**：开机 → 登录页（本地演示认证）→ 桌面列表 + （Windows 可连接 / Ubuntu、麒麟待分配）→ 点击连接 → Moonlight 全屏串流 + Windows 10 桌面 → 串流结束自动回桌面列表。 +2. **重启验收通过**：真实重启后固定 IP `192.168.1.188` 自动恢复， + 唯一自启链 `vdi-kiosk-monitor -> kiosk-shell` 生效，开机只进登录页， + 不再出现"先 RDP 后 Moonlight"双链竞争。 +3. **Monitor 崩溃恢复**：kill -9 kiosk-shell 后 4 秒内自动重启，心跳正常。 + +## 昨晚两次串流失败的根因（重要） + +用户给盒子配静态 IP `192.168.1.188` 时，是在 DHCP 连接上"添加地址"， +导致 wlan0 同时持有 `.185`（DHCP）和 `.188`（静态）两个地址。 +双地址引发 ARP 混乱，实测： + +```text +盒子 -> 网关 ping 丢包 66%~85%（间歇） +PC -> 盒子 ping 丢包 33% +UDP 双向近乎全丢（Moonlight 的视频/控制都是 UDP） +TCP/SSH 基本正常 +``` + +Moonlight 两次失败（38 秒断流、第二次连不上）均为该丢包所致， +与 Moonlight 参数、Sunshine 无关。WiFi 信号本身满格（-38dBm）。 + +修复：`nmcli` 将 YXTech 连接改为 `ipv4.method=manual` 纯静态， +只保留 `.188` 一个地址。修复后网关 ping 0% 丢包（60/60）， +串流稳定运行 7 分钟以上直至手动结束。 + +**教训：给无线终端配静态 IP 必须用 `ipv4.method=manual` 整体替换， +不能在 DHCP 连接上叠加第二个地址。** + +## 鼠标延迟 A/B 实测（1080p60，服务端 libx264） + +| 指标 | 基线 vsync+frame-pacing | no-vsync + no-frame-pacing | +|---|---|---| +| 串流帧率 | 21.64 FPS | 21.60 FPS | +| 渲染帧率 | 18.20 FPS | 18.16 FPS | +| 网络丢帧 | 0.00% | 0.00% | +| 抖动丢帧 | 15.91% | 13.64% | +| 帧队列延迟 | 44.13 ms | 47.21 ms | +| 渲染/VSync | 48.79 ms | 49.49 ms | + +结论：关闭 vsync/frame-pacing **无改善**（队列延迟反而略升）。 +~45ms 队列延迟 ≈ 一个帧间隔（21.6FPS → 46ms/帧）， +瓶颈是服务端软编码帧率，不是客户端参数。 +决定：保持 vsync + frame-pacing 开启（C++ 默认）， +`etc/moonlight.conf` 默认值已同步改回 `1`。 +鼠标卡顿的根治手段仍是服务端 GPU 直通 + NVENC。 diff --git a/terminal/kiosk-shell/etc/moonlight.conf b/terminal/kiosk-shell/etc/moonlight.conf index bbb9990..baf0cb3 100644 --- a/terminal/kiosk-shell/etc/moonlight.conf +++ b/terminal/kiosk-shell/etc/moonlight.conf @@ -13,9 +13,10 @@ # RK3528 当前没有可用的 V4L2 request/m2m 设备，auto 会选到 # h264_v4l2m2m 并报 "Could not find a valid device"，故用 software。 # vsync 1=开启垂直同步（--vsync），0=关闭（--no-vsync） -# 关闭可降低约 50ms 的呈现/VSync 延迟，可能引入撕裂 +# 2026-10-29 A/B 实测：关闭 vsync/frame-pacing 对队列与渲染延迟 +# 无改善（队列 47.2ms vs 基线 44.1ms），延迟瓶颈是服务端软编码 +# 帧率（~21.6FPS，每帧约46ms），保持开启以获得更平滑的画面。 # frame-pacing 1=开启帧率匀速（--frame-pacing），0=关闭（--no-frame-pacing） -# 关闭可降低帧队列延迟，可能造成节奏不均 # performance-overlay 1=显示性能叠图（调试用） # hang-timeout 串流假死判定时间（秒），0 表示关闭该检测 host=192.168.1.70 @@ -30,8 +31,8 @@ decoder=software display-mode=fullscreen audio=1 absolute-mouse=1 -vsync=0 -frame-pacing=0 +vsync=1 +frame-pacing=1 performance-overlay=0 retry=3 retry-delay=5 diff --git a/terminal/kiosk-shell/src/moonlight_session.cpp b/terminal/kiosk-shell/src/moonlight_session.cpp index 62fd103..a9fd323 100644 --- a/terminal/kiosk-shell/src/moonlight_session.cpp +++ b/terminal/kiosk-shell/src/moonlight_session.cpp @@ -73,7 +73,10 @@ bool MoonlightSession::start(const ConnectionTicket& ticket, StateCallback callb const QString logPath = logDir + QStringLiteral("/moonlight-%1.log") .arg(QDate::currentDate().toString(QStringLiteral("yyyyMMdd"))); - connect(process_, &QProcess::finished, this, &MoonlightSession::onProcessFinished); + // QProcess::finished 在 Qt5 里有两个重载（(int) 已废弃），必须用 QOverload 消歧 + connect(process_, + QOverload::of(&QProcess::finished), this, + &MoonlightSession::onProcessFinished); connect(process_, &QProcess::errorOccurred, this, &MoonlightSession::onProcessError); connect(process_, &QProcess::readyReadStandardOutput, this, [this, logPath]() { QFile log(logPath); diff --git a/tools/deploy_kiosk.sh b/tools/deploy_kiosk.sh new file mode 100644 index 0000000..7168b4c --- /dev/null +++ b/tools/deploy_kiosk.sh @@ -0,0 +1,39 @@ +#!/bin/bash +# 一键同步/编译/部署/验证 kiosk-shell 到 RK3528 盒子 +# +# 用法（在 Windows 开发机的 Git Bash 里执行）： +# bash tools/deploy_kiosk.sh +# +# 前置：盒子已恢复网络（ssh armbian@192.168.1.188 可达）。 +set -e + +BOX="${VDI_BOX:-armbian@192.168.1.188}" +REPO="$(cd "$(dirname "$0")/.." && pwd)" +SRC="$REPO/terminal/kiosk-shell" + +echo "==> 检查盒子连通性" +ssh -o ConnectTimeout=8 -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$BOX" 'echo "box ok: $(hostname)"' + +echo "==> 同步源码到盒子" +ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$BOX" 'rm -rf ~/vdi-build/repo/kiosk-shell/src && mkdir -p ~/vdi-build/repo/kiosk-shell/src' +scp -q -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$SRC/CMakeLists.txt" "$BOX":~/vdi-build/repo/kiosk-shell/ +scp -q -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$SRC"/src/*.cpp "$SRC"/src/*.h "$BOX":~/vdi-build/repo/kiosk-shell/src/ +scp -q -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$SRC/scripts/vdi-moonlight" "$BOX":~/vdi-terminal/bin/vdi-moonlight +scp -q -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$SRC/etc/moonlight.conf" "$BOX":~/.config/vdi-terminal/moonlight.conf +scp -q -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$SRC/vdi-kiosk.desktop" "$BOX":~/.config/autostart/vdi-kiosk.desktop +scp -q -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$SRC/vdi-moonlight.desktop" "$BOX":~/.config/autostart/vdi-moonlight.desktop + +echo "==> 在盒子上编译" +ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$BOX" 'sed -i "s/\r$//" ~/vdi-build/repo/kiosk-shell/src/*.cpp ~/vdi-build/repo/kiosk-shell/src/*.h ~/vdi-terminal/bin/vdi-moonlight; chmod +x ~/vdi-terminal/bin/vdi-moonlight; cd ~/vdi-build/repo/kiosk-shell && (cmake -G Ninja -B build -DCMAKE_BUILD_TYPE=Release > /tmp/cmake.log 2>&1 || (tail -30 /tmp/cmake.log; exit 1)) && cmake --build build 2>&1 | tail -8' + +echo "==> 安装二进制" +ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$BOX" 'pkill -f "/vdi-kiosk-monitor " 2>/dev/null || true; pkill -f "/bin/sh /home/armbian/vdi-terminal/bin/vdi-moonlight" 2>/dev/null || true; pkill -f "^moonlight-qt stream" 2>/dev/null || true; sleep 2; cp ~/vdi-build/repo/kiosk-shell/build/kiosk-shell ~/vdi-terminal/bin/kiosk-shell && cp ~/vdi-build/repo/kiosk-shell/build/vdi-kiosk-monitor ~/vdi-terminal/bin/vdi-kiosk-monitor && chmod +x ~/vdi-terminal/bin/kiosk-shell ~/vdi-terminal/bin/vdi-kiosk-monitor && ls -la ~/vdi-terminal/bin/' + +echo "==> 收敛自启项（只保留 kiosk-shell 一条链）" +ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$BOX" 'mkdir -p ~/.config/autostart; rm -f ~/.config/autostart/vdi-kiosk.desktop.bak; sed -i "s/^Hidden=.*/Hidden=true/;s/^X-GNOME-Autostart-enabled=.*/X-GNOME-Autostart-enabled=false/" ~/.config/autostart/vdi-moonlight.desktop 2>/dev/null || true; grep -H . ~/.config/autostart/*.desktop' + +echo "==> 启动受管栈并验证" +ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$BOX" 'rm -f /tmp/vdi-kiosk.heartbeat; nohup /home/armbian/vdi-terminal/bin/vdi-kiosk-monitor -- /home/armbian/vdi-terminal/bin/kiosk-shell > /tmp/vdi-monitor.log 2>&1 & sleep 8; echo "--- 进程 ---"; pgrep -af "vdi-kiosk-monitor|kiosk-shell|moonlight-qt" | grep -v pgrep; echo "--- 看门狗日志 ---"; tail -5 /tmp/vdi-monitor.log; echo "--- 心跳 ---"; cat /tmp/vdi-kiosk.heartbeat 2>/dev/null; echo' + +echo "==> 抓屏确认当前界面（应为登录页）" +ssh -o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null "$BOX" 'DISPLAY=:0 xwd -root -silent' 2>/dev/null | python "$REPO/tools/xwd2png.py" /tmp/kiosk-login.png && echo "captured /tmp/kiosk-login.png" diff --git a/tools/syntax_sanity.py b/tools/syntax_sanity.py new file mode 100644 index 0000000..cf12fc6 --- /dev/null +++ b/tools/syntax_sanity.py @@ -0,0 +1,38 @@ +#!/usr/bin/env python3 +"""Rough brace/paren balance sanity check for edited C++ files.""" +import os +import re +import sys + +os.chdir(os.path.join(os.path.dirname(os.path.abspath(__file__)), + "..", "terminal", "kiosk-shell")) + +FILES = [ + "src/main_window.cpp", + "src/main_window.h", + "src/desktop_list_page.cpp", + "src/desktop_list_page.h", + "src/desktop_service.cpp", + "src/desktop_service.h", + "src/desktop_session.h", + "src/moonlight_session.cpp", + "src/moonlight_session.h", + "src/login_page.cpp", + "src/login_page.h", + "src/state_machine.cpp", + "src/state_machine.h", +] + +fail = False +for f in FILES: + src = open(f, encoding="utf-8").read() + src2 = re.sub(r"//[^\n]*", "", src) + src2 = re.sub(r'"(?:\\.|[^"\\])*"', '""', src2) + src2 = re.sub(r"'(?:\\.|[^'\\])*'", "''", src2) + counts = {c: src2.count(c) for c in "{}()"} + ok = counts["{"] == counts["}"] and counts["("] == counts[")"] + print(f, counts, "OK" if ok else "MISMATCH") + if not ok: + fail = True + +sys.exit(1 if fail else 0)