Nexus/docs/changelog/2026-06-10-rdp-display-scale-input-fix.md

2026-06-10 — RDP 黑屏：缩放 + 键鼠

摘要

修复「已连接但黑屏」：Guacamole 画布默认 1024×768 未缩放，大区域为深色背景；补 display.scale() 适配容器、键鼠转发与 onsync 后重算缩放。

动机

E2E 显示已连接且 canvas 存在，但用户看到全黑；WS 已有 img/sync 帧，属前端渲染/布局问题。

涉及文件

• frontend/src/composables/rdp/useRdpSession.ts — scale、Mouse/Keyboard、onsync
• frontend/src/pages/RdpPage.vue — canvas 容器 flex 居中
• frontend/src/types/guacamole.d.ts
• frontend/e2e/pages/rdp-connect.spec.mjs — 采样非黑像素

验证

NEXUS_E2E_ACCESS_TOKEN=... npx playwright test e2e/pages/rdp-connect.spec.mjs

生产入口 bundle：index-DTfFTLS8.js；强刷后 3389 页应可见桌面且可键鼠操作。