273 lines
36 KiB
Markdown
273 lines
36 KiB
Markdown
# 继续开发前必读
|
||
|
||
## 2026-11-05 Ubuntu 深度响应调优（最新）
|
||
- Ubuntu VM102 已在正常会话中启用 KMS 捕获 + 原生独立光标：virtio_gpu atomic 唯一 primary plane，2K geometry，cursor hotspot plane 不暴露；盒子客户端 SHA 未变。KMS 守护按 `CRTC_W/H=2560x1440` 校验，不能依赖 virtio atomic 客户端的 legacy `crtc_id/fb_id=0`。
|
||
- KMS 45FPS 与 X11 45FPS 长按框选回显 P50/P95=195.9/246.6ms vs 250.1/311.5ms；更新约16.0/s vs10.6/s。28次原生光标点击、7种形状/热点/隐显通过，像素差0；正常退出、空闲重连、guard强杀恢复、再次重连通过。证据 `docs/evidence/ubuntu-deep-latency-20261105/`，报告 `docs/ubuntu-deep-latency-20261105.md`。
|
||
- 真实GTK按钮/ masked entry 定量仅为当前应用内回显，不能代表真实后端认证；KMS按钮约304/378ms、字符约165/182ms。硬编和 `min_threads=4` 均失败/无收益并已撤回；Ubuntu仍软件x264，未达到Windows约90ms或零延迟。
|
||
- 盒子 Ubuntu 卡片暂保持45FPS请求用于当前联调，2K/30Mbps；若收尾要回30FPS，先正常退出并改仅 Ubuntu 对象。当前现场应保持 `vdi-sunshine.service capture=kms` 与 guard active；检查时不要用 `fb_id/crtc_id` 作为活动判据。
|
||
|
||
完整对话总结在：`D:\DAIMA\vdi-cloud\PROJECT_CONTEXT.md`
|
||
|
||
## 2026-11-05 Ubuntu框选/渲染后续（优先于旧VM102硬件描述）
|
||
- 后续用户要求清理锁屏Sunshine卡片：已确认是Stream Started/Paused通知，非多份安装。Ubuntu sunshine.conf新增system_tray=disabled（同时移除托盘图标），正常退出/入口重连后新进程日志确认生效；仅当前4条通知均为Sunshine时，通过GNOME通知面板清除并确认0剩余。原配置备份~/vdi-terminal/backups/sunshine-notifications-20261105/sunshine.conf；不改全局通知或锁屏策略，串流/guard active，退回普通桌面。下方“Sunshine配置与原配置一致”仅指渲染调优结束时，现多此一项。
|
||
- 用户要求先只处理Ubuntu，已明确允许正常关闭启动、A/B及必要回退。本轮VM102正常关闭启动3次，最终4核/6144MB、cpu=host、vga=virtio-gl；宿主Intel i915共享渲染，Windows/麒麟/独占NVIDIA配置未动。宿主仅补GL/EGL/Mesa依赖，0升级10新增0移除。
|
||
- Xorg确认virgl Intel HD4600/glamor生效，x264确认AVX2/FMA3/BMI2。仍X11捕获/libx264软件编码，renderD128不代表硬件编码。最终2K30/30Mbps/limited、默认线程；45FPS及min_threads=4试验无明显延迟收益，已撤回。盒子desktops JSON结构与本轮备份完全相同，客户端SHA仍5d4330…。
|
||
- 受控60Hz长按框选：基线回显P50/P95=398.3/634.6ms，最终224.4/308.3ms；独立编号更新2.0→12.4/s，不等于总视频FPS。有效轮次最终编号300及释放均见；中位改善约44%，短样本未随机重复，非USB/光子延迟，尚未达到Windows/原生目标。
|
||
- 回归16编号点击+2快速点击，源18按/18放，最大坐标误差1.375px；2K及12灰阶核对通过。临时测试服务已停，最后留Ubuntu普通桌面，Sunshine/guard active。不要自动进一步改麒麟。
|
||
- 备份PVE /root/vdi-ubuntu-render-20261105/102.conf.before，Ubuntu/盒子各自~/vdi-terminal/backups/ubuntu-render-20261105/。回退只还原cpu/删除vga字段，需正常关闭启动；别整份覆盖VM配置。
|
||
- 报告docs/ubuntu-drag-render-20261105.md，原始证据docs/evidence/ubuntu-drag-20261105/。剩余瓶颈为捕获/GPU读回/软件编码；未部署硬编方案或更换协议。
|
||
|
||
## 2026-11-05 Linux原生独立光标（优先于下方旧样式/原型状态）
|
||
- 用户要求保留原生样式并直接实施低延迟方案；Ubuntu恢复Adwaita/24、default加速，关闭动画保留。两Linux真实2560×1440/30FPS请求/30Mbps/limited/软件编码保留。
|
||
- 已部署0005 + terminal/native-cursor：受限独立SSH密钥/固定主机公钥同步XFixes真实形状、热点、显隐，本地X11指针移动不等待视频。单座席X11/2K/绝对鼠标，最多128×128；状态2秒过期或源几何改变则结束串流恢复原服务，不做运行中帧交接。
|
||
- 私有原版Sunshine精确SHA + 进程级adapter只清除捕获副本像素。Ubuntu原/usr/bin/sunshine的capabilities保留，租约内用同SHA无cap副本；麒麟仅host.py/私有sunshine/.so认证KYSEC。guard按需启动，ExecStopPost恢复；原服务永久文件不改。
|
||
- 盒子最终客户端SHA 5d4330f703d7f8e053bc3795ca42bdaf231c9e9dd8ebb00a612013adbcccee03，.71/.72 profile固定该值；helper在远端租约前核验，旧备份实测拒绝且原服务PID不变。修改二进制须停用profile并重新验证。备份~/vdi-terminal/backups/native-cursor-20261105/；回退先退出等恢复，再停用两JSON。
|
||
- 最终版两系统七种光标形状/热点一致、静态像素最大差0、视频无混入指针；各28编号点击与源事件完全匹配，Ubuntu误差最大1.055px、麒麟0.829px。较早各16次40ms短按和双击补测通过；最终版暂停Moonlight指针仍移动，较早服务器主动warp(400,600)两台读回正确。
|
||
- 最终页面视频回显Ubuntu P50/P95 188.38/522.42ms，麒麟134.37/165.56ms；不是本地指针或物理USB延迟，未定量证明Windows等效。Ubuntu两次强制暂停恢复后首击未回显，根因未定；完整SDL失焦未验收，不可称全部场景无丢输入。
|
||
- agent/guard SIGKILL恢复、Ubuntu bridge冻结退出、麒麟真实分辨率变化退出及恢复2K重连均已测。4项单测和清洁patch应用通过。构建器会规范CRLF但严格上下文；现场本轮未重建部署其他任务0004，不能据构建器宣称现场包含0004。
|
||
- 普通Ubuntu初次收尾约4分42秒触发stale/mismatched退出，发现校验时间在读取前取得的原子替换竞态，改为读后取时间。该轮未区分未来/实际过期，不能认定唯一根因。仅修时序版先6分钟通过，之后9分32秒真实heartbeat超时；最终状态等待上限改2秒、主机TTL4秒，增加X11读耗时诊断。已测暂停Ubuntu代理1.1秒时指针继续移动且会话存活。旧1da552…形状/点击证据保留；最终版持续运行另记。
|
||
- Ubuntu原Sunshine在11:12:07恢复测试阶段停止超过10秒、看门狗SIGTRAP，11:12:14恢复；未修复上游停止看门狗问题，原crash报告保留且未外发。
|
||
- 最终2秒策略Ubuntu6分钟/65960次状态读取存活，含1.1秒暂停；读前时间出现1次合法未来值、读后0次，证实竞态检查顺序需要修正。随后同会话七形状/28点击通过；bridge冻结2.6秒后2.904秒检查客户端退出，原服务恢复。详见ubuntu-final-soak/release-probe/final-stale-state等最终证据。
|
||
- 最终新SHA的Windows2K45/RKMPP/EGL无独立光标env回归；麒麟2K30七形状/28点击及普通桌面重连后退出，原服务active且无临时drop-in。Ubuntu保留2K30/原生指针PID299860/父235482，guard按设计active，临时GTK源/盒子探针均已停。报告docs/linux-native-cursor-20261105.md，证据docs/evidence/native-cursor-20261105/。
|
||
|
||
## 2026-11-05 Ubuntu画质与鼠标样式调优
|
||
- Ubuntu .72/test2 已由1080p升级真实2560×1440，盒子只改Ubuntu对象为2K30，自动请求30Mbps。原VM虚拟VGA在当前内核可直接切2K，未改PVE硬件或重启VM/GDM。
|
||
- 用户服务启动前newmode/addmode/output创建2K；删模式后服务启动重建通过。GNOME monitors.xml保存单屏2K/100%缩放，最终锁屏/解锁仍2K；整机重启恢复未验收。DisplayConfig持久调用曾待确认后回退，已重新保存显示配置并重新核验最终尺寸。
|
||
- DMZ-White/24px、flat鼠标加速、关闭GNOME动画；不是复制Windows整套主题，也没有叠加本地假箭头。无GPU render节点，仍X11/libx264 ultrafast/zerolatency默认线程。
|
||
- .72 host-color-range=0，正常kiosk最终PID240476/父235482，2K30/30Mbps、RKMPP/EGL、服务端MPEG和真实源2K核对；最终保留Ubuntu普通桌面连接，临时GTK服务已停止。
|
||
- 正常入口2K短测：45请求full21.49FPS/F9 P50 373.2ms；limited22.83/376.7ms；单线程+无动画17.98/402.9ms（单线程已撤回）；最终30请求limited/默认线程/无动画21.40/320.9ms。F9每轮24翻转无超时，但一轮客体有额外F9事件且无序号，不能证明逐键延迟。四轮启动快速点击只记录24/24/23/21且单线程有坐标重复，不能说全部通过；补做稳定正常会话24次慢速交替点击24/24、误差<1px、F8收到，见final-input-check.json。源GTK本身约15–20绘制/秒，视频含重复帧；不能声称独立运动21–23帧、稳定30/45或物理延迟降低/Windows等效。
|
||
- limited灰阶保持黑白层次，未显著截断；单像素/彩字仍受4:2:0限制。两端备份~/vdi-terminal/backups/ubuntu-quality-20261105/，Ubuntu monitors.xml原不存在；.72 range原不存在。原Sunshine配置/服务、gsettings原值均保留。测试仅补装python3-gi-cairo，无整体升级。
|
||
- 文档docs/ubuntu-quality-20261105.md、证据docs/evidence/ubuntu-quality-20261105/。Windows/麒麟卡片结构比较未变，未改客户端二进制、全局渲染或USB任务修改。
|
||
|
||
## 2026-11-05 Windows固定PCI设备不再可弹出
|
||
- 用户要求日常体验像普通电脑、托盘只留真实U盘，授权“你自己保存然后重启”。交互会话仅设置/系统窗口，无打开文档；未强制关闭应用。
|
||
- 09:28正常shutdown.exe /s /t 0后冷启动VM100。原args保留GPU子厂商设置，追加三个global：ICH9-LPC.acpi-pci-hotplug-with-bridge-support=off、pci-bridge.shpc=off、pcie-root-port.hotplug=off。PCI增删须关机，USB设备级热插拔保留；没改总线/设备地址/驱动，没有重启USB隧道。
|
||
- 原托盘四项（GTX965M/VirtIO网卡/串口/附加AHCI）Capabilities从6变0，InstanceId相同，Status OK；GPU错误0，系统盘Online/Healthy，IP .70、Sunshine及Guest Agent正常。
|
||
- PVE备份/工具/root/vdi-fixed-pci-20261105/（backup/plan.json、vm.conf.before），set-fixed-pci.py支持prepare/apply/restore且拒绝在线变更。4项单测和无磁盘/网络后端/直通GPU的隔离QEMU测试通过（PCI关闭、usb-redir添加/删除）。
|
||
- 盒子无物理U盘，仅键鼠，USB服务active；Moonlight随关机退出，用户须重连Windows。托盘UIA未暴露传统图标子项，外观与真实U盘插拔待用户验收，不冒充目视完成。文档docs/fixed-pci-tray-20261105.md及evidence/fixed-pci-20261105。
|
||
|
||
## 2026-11-04 云桌面图形关机/重启按钮限制
|
||
- 用户明确要求Windows/Ubuntu/麒麟桌面内图形关机、重启按钮也禁用，前面的快捷键补丁不足。本轮已通过PVE Guest Agent实际部署，不依赖未构建的Moonlight 0004。
|
||
- Windows VM100/test HKU Explorer NoClose=1，交互用户任务广播Policy并SHRestricted(2)=1；无Explorer重启/注销/VM重启，任务已删除。首次原值备份C:\ProgramData\VDI\power-policy\original.clixml。
|
||
- 麒麟VM101/test1使用polkit .pkla，Ubuntu VM102/test2使用.rules。两台均额外部署/etc/dbus-1/system.d/zz-vdi-desktop-power.conf，按客户UID拒绝login1电源方法和Can*查询，只ReloadConfig。root CanPowerOff仍yes。
|
||
- 两台实际图形进程pkcheck基础reboot仍授权（内部原因未确定），所以不能只靠polkit宣称已屏蔽。D-Bus错误签名安全探测八项全部Access denied，七项Can*拒绝；并未发送有效关机请求。麒麟定位时仅重启过polkit一次，Sunshine保持active。
|
||
- 三台running，Windows LastBoot及Linux boot ID与部署前一致；未逐项目视验收菜单外观、未重启验收。限制当前客户账户图形电源入口，不防管理员命令/改策略，不涉及注销/锁屏，不实现盒子开关联动VM生命周期。新用户需重新针对账户应用。
|
||
- 工具tools/deploy-guest-power-policy.py apply/query/restore --vm 100或--vm 101 --user test1或--vm 102 --user test2；Linux首次备份/var/lib/vdi/power-policy。详见docs/guest-power-policy-20261104.md及evidence/guest-power-policy-20261104。
|
||
|
||
## 2026-11-04 盒子过夜重启观察（最新）
|
||
- 用户要求今晚开机观察并记录重启/原因。19:35启用vdi-overnight-observer.service，active/enabled，每60秒fsync心跳、boot ID/uptime计数、温度/负载/内存/网络/进程/桌面几何；跨午夜分日志。当前计数0是启用后范围，不代表历史没重启。
|
||
- 中文汇总~/vdi-terminal/logs/overnight-summary.txt；JSON行overnight-health-YYYYMMDD.log；持久状态~/vdi-terminal/state/overnight-state.json。同boot的服务重启不计为整机重启；11项状态/证据/跨日测试通过，实际分钟样本和服务重启状态保持已验证，未实际重启盒子。
|
||
- /var/log是zram，journal链接到eMMC /var/log.hdd/journal。新增70-vdi-observer-journal.conf配置persistent/64MB/7day/30s，flush/sync确认磁盘journal；只重启journald和本观察服务，不动Moonlight/显示/网络/GPU。
|
||
- root拥有/usr/local/libexec/vdi-observer-pstore只读采集pstore到/var/lib/vdi-observer/pstore.json（root:systemd-journal 640），观察服务低权限读取。旧归档41字节reboot行仅基线；仅内容变化作为新线索。无法确认的断电/硬复位明确标原因未确认，不能伪造重启因果。
|
||
- 最后Windows串流PID137139、2K45和显示守护保留，boot ID afb6a02f-ba7c-478a-8704-c78a993d23c6。文档docs/overnight-box-observation-20261104.md及evidence/overnight-observer-20261104；备份~/vdi-terminal/backups/overnight-observer-20261104-*。明早读取两天日志和汇总，无明早自动通知任务。
|
||
|
||
## 2026-11-04 麒麟鼠标掉帧继续排查（最新）
|
||
- 保留原版Sunshine SHA256 1c3099bf924db3aee759b3d7c05e012569ef8650c400d1479144398795decc71、单线程、暂停合成器、真实2K30/30Mbps。未改PVE或其他桌面。
|
||
- wrapper支持~/.config/vdi-terminal/host-color-range/<host>的0/1协商；仅.71设0，消除软件full-range额外转换。同场景2K45请求：原full21.42FPS，limited28.81FPS；不代表真实45或物理延迟与Windows一致。
|
||
- 两线程25.67、BGRA27.17、full-chroma25.61、bilinear30.79均未保留。精确SHA校验后仅创建过独立实验副本，现已删除三副本及服务drop-in、恢复原程序，无额外capability。
|
||
- wrapper已部署，语法/三主机隔离/显式环境覆盖/非法配置拒绝检查通过。用户明确允许退出Windows切回麒麟后，已完成正常kiosk重连：PID135145/父kiosk92843，真实2K30/30Mbps，env颜色0，RKMPP/EGL和服务端MPEG日志确认；最终保留麒麟正常桌面连接。
|
||
- 完整同参数2K30对照各24次合成F9回显，无超时：full23.35FPS、P50 150.99/P95 186.38ms；limited27.25FPS、P50 143.57/P95 173.03ms。分布重叠且网络有差异，不能称显著低延迟或Windows等效；排除物理USB及面板扫描。临时GTK和测试串流均已停。
|
||
- 文档docs/kylin-mouse-20261104.md，证据docs/evidence/kylin-mouse-20261104/，两端备份~/vdi-terminal/backups/kylin-mouse-20261104/。
|
||
|
||
## 2026-11-04 麒麟真实2K已落地（最新）
|
||
- 用户明确授权关闭并启动VM101；已正常关机、只改vga=std,memory=64并启动，PCI BAR确认64MB；配置diff仅vga，未动其他VM或宿主。
|
||
- 麒麟Virtual-1和视频真实2560x1440；自定义241.50MHz/59.95Hz模式，Sunshine用户服务启动前自动创建/添加/切换。删模式后启动服务验证通过，未第二次整机重启验收新配置。
|
||
- 盒子只改麒麟对象为2560x1440/30FPS，沿用2K自动30Mbps；Windows、Ubuntu对象不变，源码/客户端二进制未改。
|
||
- 最终X11/libx264 ultrafast/zerolatency原单线程；Sunshine服务启动暂停UKUI合成、停止恢复。有效2K局部运动：开合成18.89FPS、两线程18.85、暂停合成22.97（采用），队列0.12ms。未测物理鼠标到屏幕延迟，不能称稳定30/45FPS。
|
||
- 有效测试48/48跨屏点击误差<=1px，F8收到；正常kiosk连接/退出/重连2K验证，最终保持麒麟桌面。临时GTK/测试串流已停，未关闭长期锁屏。
|
||
- 早期2K样本有锁屏污染，相关ultrafast/damage非valid文件排除性能结论。KMS探测失败恢复X11，最终入口及实体二进制getcap为空。
|
||
- 备份两端~/vdi-terminal/backups/kylin-quality-20261104/；详情docs/kylin-quality-20261104.md，证据docs/evidence/kylin-quality-20261104/。此前接入文档的麒麟1080p为历史状态。
|
||
|
||
## 2026-11-04 Ubuntu / 麒麟已接入（最新）
|
||
- 盒子192.168.1.188正常列表已可连接Ubuntu .72/test2、麒麟 .71/test1，两台安装并配置Sunshine，原Moonlight客户端保留。
|
||
- Ubuntu24.04.4使用Sunshine2026.914.233613；麒麟V10 SP1/glibc2.31使用官方v0.21.0 Ubuntu20.04构建，/opt解包部署并单文件KYSEC认证，未关闭全局策略。
|
||
- 用户明确授权Ubuntu test2自动登录+Xorg；GDM/AccountsService原配置备份/var/backups/vdi-linux-20261104-100722/；重启GDM后已生效，未整机重启验收。麒麟沿用已有图形会话，锁屏仅临时解锁。
|
||
- 用户服务vdi-sunshine active/enabled，XDG自启导入会话环境；X11/libx264、Virtual-1 1920x1080、30FPS配置；固定虚拟音频vdi_audio，audio_sink填sink名而非.monitor，音质未验收。
|
||
- 真实盒子RKMPP/EGL入口两台画面、F8及鼠标左键已验证；最后Ubuntu/麒麟/Windows依次连接回归通过并退回列表。Linux短测约29FPS，未验收2K/长期性能/重启恢复。
|
||
- Windows原对象2560x1440/45FPS保留，未改源码默认地址。盒子配置备份~/vdi-terminal/backups/linux-desktops-20261104-101507/desktops.json。
|
||
- 两台管理随机凭据只在各自~/.config/sunshine/vdi-admin.json（600），不要复制进仓库。临时输入/Xvfb测试已停。详见docs/linux-desktop-onboarding-20261104.md及evidence/linux-desktops-20261104。
|
||
|
||
## 2026-11-03 U 盘真实设备透传 POC
|
||
- 用户明确要求 Windows 枚举真实 USB。已开发 Rust terminal/usb-monitor（标准库），usbredir+受限SSH隧道+PVE QMP usb-redir；盒子不调用PVE API。
|
||
- Kingston 0951:1666 / USB序列号408D5C1653D4E44179789251，物理3-1（USB2/480M）；Windows正常枚举USB Mass Storage / Kingston USBSTOR，KINGSTON F:、FAT32、Removable、Healthy。
|
||
- 独立VDI_USB_TEST_20261103-173342目录新增1MiB文件并复制回VM，三份SHA一致；用户安全弹出后真实拔插，17:34:43断开、17:34:53重连，F:恢复且文件SHA一致。原文件未改，测试目录保留。
|
||
- 仅固定VID/PID/serial纯存储，拒绝键鼠/复合设备/本地挂载/holder/swap；udev只禁止这只盘本地自动挂载。最初口报-71，换口后成功，不是软件修好了原口。
|
||
- 盒子vdi-usb-monitor.service、PVE vdi-usb-tunnel-100.service active/enabled；QMP端点vdi_usb_box_100/vdi_usb_redir_100仅运行时，VM/PVE重启需管理员重新attach。未验收开机恢复/多用户生产能力。
|
||
- 盒子备份~/vdi-terminal/backups/usb-device-20261103-172709；PVE密钥/etc/vdi-usb-poc/vm100，回环40001经SSH。未装Windows驱动、开测试签名、重启或改GPU/串流；Moonlight PID46934保留，GTX965M错误0。
|
||
- 详见docs/usb-device-poc-20261103.md及evidence/usb-device-20261103；工具deploy-usb-device-poc.py、usb-device-qmp.py、test-usb-device-poc.ps1。
|
||
|
||
## 2026-11-03 Windows保留单个2K主屏（最新）
|
||
- 用户明确授权：不影响2K才能改，否则不动。现场VDD已变DISPLAY4，原主屏2560×1440@60；Basic DISPLAY1另扩展2K64，NV DISPLAY2原本无活动输出。
|
||
- 已只停用Basic桌面输出，VDD成为唯一活动主屏，保持2K60；未禁用/卸载任何显卡、未重启。原Moonlight PID46934/2K45继续，截图正常；GPU错误0，Sunshine重建h264_nvenc，编码10%。
|
||
- 新工具set-single-vdi-display.ps1、run-single-vdi-display.py支持Query/Apply/Restore，有2K60主屏前置条件、XML布局备份、读回失败恢复、设备身份校验；临时任务已删除。备份C:\ProgramData\VDI\single-display-20261103\before.xml。
|
||
- 布局已按当前用户保存，但未重启/重登验收；设备管理器仍有适配器，不能说卸载设备或保证设置界面不列未连接输出。详见docs/single-display-20261103.md及对应evidence。
|
||
|
||
## 2026-11-03 独立光标受控原型
|
||
- 已实测Windows真实箭头/文字/左右缩放/忙碌静态形状导出和盒子X11本地显示，热点正确，隐藏全透明；短暂停Moonlight小于0.5秒，本地指针仍移动，已恢复SIGCONT。
|
||
- 最后完整轮32/32跨区点击正确，归一化坐标最大差1px；10项边界测试通过，0.8秒辅助状态租约到期退出/SDL资源归还通过。未测物理输入到屏幕延迟。
|
||
- 这是脚本形状回放和受控Sunshine全局N快捷键交接，不是自动形状同步，不是生产独立光标；没有替换正常Moonlight/Sunshine二进制。正式须改双方控制通道、帧边界ACK/租约与SDL生命周期，并适配Weston。
|
||
- 首两轮辅助连接退出后XFixes图像不可用，修正为XFixes临时隐藏下成对切Moonlight本地C快捷键，让SDL重新设置其拥有的隐藏指针；第三轮完整通过。静止画面N切换旧箭头留旧帧也已实测，不能靠快捷键直接上线。
|
||
- 已停删VDICursorPOC，正常PID31694/2K45/原SHA保留，VDD2K60、GPU错误0/NVENC编码11%、显示守护active；最后本地透明1×1，正常Windows单个白色远程箭头。未重启/改ROM/VFIO/主题。
|
||
- 详见docs/independent-cursor-feasibility-20261103.md及对应evidence。新增cursor-poc工具仅实验，不自动启动；verify-cursor-poc-box.py点击仅可用于临时Windows测试窗口。
|
||
|
||
## 2026-11-03 GPU修复后联调与45帧落地
|
||
- 用户确认运维修复结束，授权的鼠标优化任务已恢复。现场复核GTX965M错误码0、vBIOS84.04.2b.00.13、
|
||
Sunshine实际h264_nvenc、NVENC会话1；正常重连后编码占用18%。本轮未改ROM/VFIO、未重启任何机器。
|
||
- 修正的测试源实测约59.4～59.8FPS；2K30实渲染29.83FPS；2K60接收58.82但只渲染46.11，
|
||
客户端等待队列7.54ms，GPU89～95%/800MHz。原长队列渲染仍46且排队36ms；nearest实验42；VSync24，均未采用。
|
||
- 已落地Windows VDD2560x1440@60、正常kiosk票据45FPS；短测实渲染44.22/队列1.30ms，
|
||
约两分半持续动态会话43.14/队列1.55ms/网络实际丢帧0。不能称稳定2K60或零延迟。
|
||
- Windows活动VDD变为DISPLAY3，动态查找；登录脚本tools/set-2k-display.ps1默认60、支持RefreshRate30。
|
||
已备份/部署并手动运行原VDISet2KDisplay任务，独立Query确认60Hz；未通过重启验收登录触发。
|
||
Windows原脚本/任务XML：C:\ProgramData\VDI\backups\display-refresh-20261103-142920。
|
||
- tools/set-terminal-fps.py支持30/45/60、原子写入和备份；当前30票据备份
|
||
~/vdi-terminal/backups/fps-20261103-143333-297521/desktops.json。正常流程重新连接PID31694实际fps45。
|
||
- 正常二进制仍35de7b...afa00f，RKMPP/DRM PRIME/EGL、最新帧队列、无VSync/无pacing，第三补丁不开。
|
||
nearest实验保留terminal/moonlight/experiments/0004-vdi-egl-exact-size-sampling.patch，已撤回正常源码且不进构建器。
|
||
- Windows临时基准任务已停止并删除，256次交替点击记录全部位置正确；用户原应用保留，恢复正常Windows串流。
|
||
显示守护active，2560x1440输出正常。独立光标尚未实现；稳定2K60需继续验证更低开销呈现路径。
|
||
- 详细对照、限制与回退见docs/2k60-validation-20261103.md，证据docs/evidence/2k60-20261103/。
|
||
|
||
## 2026-11-03 午后鼠标进一步优化（历史，已恢复联调）
|
||
- 用户要求制定计划并执行；随后明确运维正在修复GPU Code43。Windows多次被外部qmshutdown/qmstart，
|
||
本轮已停止Windows配置/串流测试，不能与运维并发改VM；没有发出VM/宿主/显卡重启指令。
|
||
- 新增0003-vdi-input-priority.patch：帧前连续输入最多32条/2ms，保留焦点/窗口/退出等边界；
|
||
VDI_INPUT_PRIORITY=1才启用；VDI_INPUT_TIMING=1才记录SDL派发年龄及主线程render调用统计。
|
||
已在盒子编译，普通/ASAN测试通过。实际EGL使用独立PacerRender线程，主线程render样本0，未证明新调度收益。
|
||
- 默认客户端已恢复本轮前哈希35de7b1a4ade583823b23b5f2e012307f6d0a3848c8eb97bd6d4de9660afa00f；
|
||
候选另存moonlight.input-priority-20261103，哈希ef0707ed2053f15ad6f62a33a79ac360237b27f307777c79b379b105fabfe3a2。
|
||
正常wrapper未改用候选，新调度未默认启用；没有添加本地/透明光标。
|
||
- VDD30Hz已查明，临时2K60应用/读回成功；但旧WinForms基准源本身约32FPS，2K30/60初测不能证明性能提升。
|
||
本地基准脚本已修正定时器量化，待运维结束再部署；VDD模式未持久化，原登录2K30脚本没改。
|
||
- 新增set-vdi-display-mode.ps1、run-mouse-display-probe.py、bench-mouse-stream.sh和移动注入工具。
|
||
现场测试串流已清理；Windows基准窗口随关机退出，VDIInputLatencyBench登记无自动触发器，
|
||
运维结束后先用run-input-latency-bench.py stop清理，再Query VDD/必要时Restore，再做新版源配对测试。
|
||
- 独立光标完成源码核实与交接设计，尚未实现；Sunshine全局toggle不足以可靠回退，需要双方协议/帧边界交接。
|
||
计划/实际结果见docs/mouse-optimization-plan-20261103.md、docs/mouse-optimization-execution-20261103.md；
|
||
后续设计见docs/independent-cursor-design-20261103.md。不能宣传本轮达到2K60或鼠标到屏幕1ms。
|
||
|
||
## 2026-11-03 显示器关开修复（优先于下文旧状态）
|
||
- 关屏再开后画面变矮：盒子回退1920x1440@75（4:3），Moonlight 16:9视频上下黑边；
|
||
MATE monitors.xml仍存旧4:3布局，原启动脚本只设置一次2K。
|
||
- 已部署vdi-display-guard用户服务（active/enabled）和幂等启动恢复，保留297MHz定制2K时序；
|
||
2秒检查、异常稳定2秒后恢复；断开不强设、失败退避、命令超时、单实例锁，正常不反复切换。
|
||
修正当前GWR/0x2708显示器旧保存布局。仅部署tools/deploy_display_guard.sh，不重启串流。
|
||
- 9个场景测试通过，CTest 3/3；两次主动回退均约14秒恢复，Moonlight PID66385和boot ID不变。
|
||
用户真实关屏再开确认自动全屏；10:03:19断开、10:03:31正确2K模式，10:04现场2560x1440。
|
||
- 备份~/vdi-terminal/backups/display-guard-20261103-095920/；详情/回退见
|
||
docs/display-resume-fix-20261103.md。此修复仅限当前Xorg单HDMI 2K POC，未做隔夜老化。
|
||
|
||
## 2026-11-03 鼠标/点击跳转优化（优先于下文旧状态）
|
||
- Moonlight私有客户端新增两个补丁：鼠标合并不跨点击/键盘/窗口边界，绝对鼠标按钮封住前一位置批次；
|
||
低延迟非pacing队列可丢弃等待帧保留最新帧，wrapper默认VDI_LATEST_FRAME=1。保持单白色Windows光标。
|
||
- 现场32次交替点击：旧客户端30/32正确（第1、13错位），补丁32/32正确；native输入测试1000轮和ASAN通过。
|
||
配对串流补丁队列2.14ms/呈现6.12ms，原3.39ms/6.84ms；帧率约28.4/28.1，受网络/软件编码波动，不能称零延迟。
|
||
- Windows保留DragFullWindows=1、MouseTrails=0；已在test交互会话将MinAnimate从1改0、菜单400改100ms，读回通过，
|
||
原值备份在test的LocalAppData/VDI；临时执行/测试任务已清理。
|
||
- 用户确认蓝框在盒子登录/选择页：QFrame:hover错误匹配QLabel。移除蓝色悬停框和登录焦点蓝框，限定卡片对象样式，
|
||
局部编译CTest3/3，部署新版kiosk；悬停截图亮蓝像素8302→0。UI/wrapper备份input-rendering-20261103-114542。
|
||
详情见docs/input-rendering-optimization-20261103.md和terminal/moonlight/README.md。
|
||
|
||
## 2026-11-02 最新实测（优先于下文旧状态）
|
||
- 2026-11-02晚：已在用户目录完成MPP+FFmpeg-Rockchip+Moonlight6.2.0私有构建，
|
||
实际2K串流选中h264_rkmpp/drm_prime与EGL/GLES呈现，非仅FFmpeg样本测试。
|
||
2K20 smooth会话平均呈现18.97FPS、解码10.53ms、呈现2.54ms；2K30 low-latency
|
||
呈现23.46FPS、解码9.11ms、队列2.39ms、呈现5.41ms。服务端仍Code43/libx264。
|
||
2K30 smooth队列31.95ms，VSync开/帧步调关也有28.93ms，故该盒子选低延迟档。
|
||
原始日志和限制见 `docs/rendering-execution-20261102.md`。
|
||
通过 `~/.config/vdi-terminal/render.conf` 显式选择私有wrapper+hardware，系统客户端不覆盖；
|
||
Windows桌面票据改30FPS，原20FPS文件备份为desktops.before-rkmpp-20261102.json。
|
||
构建脚本 `tools/build-rkmpp-client.sh` 修Qt5 optional、EGL探测缓存与旧对象不重编；
|
||
kiosk就绪判断兼容RKMPP独立测试解码器日志，CTest 2/2通过。
|
||
鼠标MouseTrails=0、DragFullWindows=1；现场仍有VDIApplyTransparentCursor刷新参数任务，
|
||
先前“任务已删除”的记录不准确，本轮未改变光标配置；截图单白光标正常。
|
||
不能把23FPS、硬解接通解释为GPU已恢复、2K60或端到端零延迟。
|
||
- 已部署真实2K：盒子HDMI 2560x1440约60Hz、Windows VDD 2560x1440@30、Moonlight 2560x1440@20/30Mbps。
|
||
- RK3528旧PHY拒绝EDID的241.70MHz，实测用297MHz固定时钟和扩展消隐成功：
|
||
`297.00 2560 2608 2640 2720 1440 1443 1448 1820 +HSync -VSync`；盒子重启已验证，link Good。
|
||
- Windows VDD版本11.30.4.434，生效XML在 `C:\VirtualDisplayDriver\vdd_settings.xml`。
|
||
登录任务VDISet2KDisplay动态定位Virtual Display Driver（不能写死DISPLAY编号），脚本在
|
||
`C:\ProgramData\VDI\set-2k-display.ps1`，仓库副本 `tools/set-2k-display.ps1`；VM重启后执行成功。
|
||
- 鼠标保留白色Windows远程光标，已删除本地黑色光标自动开启和透明光标任务；GLES2、关闭MATE合成器保留。
|
||
- **GPU并非稳定完成**：运维曾打通582.78/NVENC，连续动画可发送59FPS；但本次VM重启后Code43复发，
|
||
nvidia-smi失败、Sunshine当前实际为libx264软件编码。客户机重启设备/隔离VDD/VM停启均无效；
|
||
无效VDIRecoverNvidia任务已删除。未改宿主VFIO模块、未重启宿主。ROM为gtx965m-pci.rom。
|
||
- NVENC正常时2K20实测19.67FPS、网络丢帧0%、抖动丢帧0.94%；这些数据不能作为当前软编性能保证。
|
||
- 详细最新状态见 `docs/moonlight-kiosk-20261028.md` 的“当前现场（2026-11-02 15:45）”。
|
||
|
||
## 当前状态
|
||
- 项目目录：`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 节点 `starhe`。VM 100 win10-test `192.168.1.70`（Sunshine/Moonlight 云桌面）；
|
||
VM 101 kylin-test `192.168.1.71`（test1）、VM 102 ubuntu-test `192.168.1.72`（test2），
|
||
SSH 可登，**均已安装 Sunshine 并验证盒子正常串流**（2026-11-04，见顶部最新记录）；登录凭据由管理员保管
|
||
- `kiosk-shell`（Qt/C++）：**开机直进桌面列表**（2026-10-30 起，设备 SN 即用户自动登录，
|
||
登录页代码保留待平台正式认证接入）→ 选择桌面 → Moonlight 会话；**RDP 代码已于 2026-10-29
|
||
全部删除**（git 历史可查），Moonlight 是唯一会话通道，无 freerdp 构建依赖
|
||
- 新增退出三层与会话过场层：`Ctrl+Alt+Shift+Q` 退串流回列表；列表页"退出登录"；
|
||
登录页无退出按钮（退出终端只在管理菜单）；点连接有全屏过场层，首帧后淡出。
|
||
详见 `docs/moonlight-kiosk-20261028.md` 2026-10-29 下午节
|
||
- 代码位置：`terminal/kiosk-shell`
|
||
- 远程安装路径：`~/vdi-terminal/bin/`（`kiosk-shell`、`vdi-kiosk-monitor`、`vdi-moonlight`）
|
||
|
||
## GPU 直通进行中（2026-10-30 下午，见 moonlight-kiosk 文档当日追加节）
|
||
- 宿主侧已就绪：nouveau 已黑名单、GPU 在 vfio-pci、IOMMU 组 2（root port+GPU）
|
||
- 关键坑：vfio 清零 Subsystem ID（必须 `x-pci-sub-vendor-id/device-id` 注入 1558:6557）；
|
||
移动卡 vBIOS 需 sysfs 抽取（/usr/share/kvm/gtx965m.rom）；NVIDIA 安装器在 SYSTEM 会话
|
||
挂起（用 7zr 解包 + pnputil）；582.78 绑定后 D3D 全灭已换 566.36（D3D 待验证）
|
||
- **当前 VM 100 未挂 GPU**：另一并行会话在改配置（hv_vendor_id 方案），本会话已停手避撞，
|
||
两个会话不要同时改 VM 100 配置！
|
||
- Sunshine 配对 2026.914 改为"Web UI 批准式"：`moonlight pair --pin NNNN` +
|
||
`GET /api/csrf-token` + `POST /api/pin {pairing_id,pin}`；Web 凭据由环境管理员保管；
|
||
删 sunshine_state.json = 全部失配；盒子 Moonlight 配置目录缓存旧 uniqueid 会卡死配对
|
||
|
||
## 必须遵守
|
||
- 所有实现严格参考用户提供的两个正式 Word 和会议纪要；文档未确定的技术只能标记待调研，不得擅自定版。
|
||
- 终端先做，后接自研管理平台 API；终端不直接调用 Proxmox API。
|
||
- 正式状态机：`BOOT -> CONFIG -> CONNECTING -> SESSION -> RECONNECT -> ERROR`
|
||
- 正式 Kiosk 选型：Weston + Wayland + Qt；会话通道统一 Moonlight（RDP 已删，勿在代码里复活协议分支）。
|
||
- `/cert:ignore`、空密码仅限局域网 POC。
|
||
- 项目经理新增待调研：RDP 是否适合 GPU/CAD/3D；研究 Moonlight/Sunshine，但不要在调研前删除 RDP、确定 Moonlight 参数或定版双协议。
|
||
|
||
## 已知关键结论
|
||
- WiFi：约 -47 dBm，协商约 200 Mbps，零丢包/重传；卷帘问题不能简单归因于 WiFi。
|
||
- 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`。
|
||
- **21.6 FPS 上限根因（2026-10-29 修正）**：不是 x264 编码算力——ultrafast 前后帧率分毫不差，
|
||
串流中 VM CPU 仅 0.5%、sunshine 累计 14 秒 CPU/3 分钟会话，鼠标运动也不变；
|
||
真正瓶颈在虚拟显示/捕获节奏（MttVDD 呈现 + Desktop Duplication 脏帧 + QEMU 显示栈，
|
||
VM CPU 型号 `QEMU Virtual CPU version 2.5+` 未透传宿主 AVX2）。
|
||
根治 = GPU 直通（NVENC + 真实显示栈）；备选 = VirtIO-GPU / cpu=host 排除 QEMU 显示栈因素。
|
||
客户端解码 10~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`。
|
||
|
||
## 尚未完成
|
||
- 服务端 GPU 直通：GPU 为 CLEVO 准系统上的 GM204M/965M（10de:13d9，宿主被 nouveau 占用需解绑）；
|
||
**IOMMU 已启用**（组 2 = root port 00:01.0 + GPU 01:00.0，整组直通）；VM 内需装 R580 legacy 驱动。
|
||
操作单与 GPU 看板见 `docs/gpu-passthrough-20261030.md`，看板 `http://192.168.1.51:8090/`（systemd 自启）
|
||
- RK3528 VPU 硬解（h264_v4l2m2m 等缺可用设备，需 MPP FFmpeg 补丁或 V4L2 request 驱动）
|
||
- 2K 分辨率链路验证（虚拟显示器 + 盒子显示模式需同步调整）
|
||
- Weston/DRM/mppvideodec
|
||
- 后端 API 注册、配置、MQTT 心跳（Moonlight 路径目前是本地静态配置）
|
||
- 终端音频出音现场确认
|
||
- 协议最终选型定版（RDP / Moonlight / 双协议，需实测数据 + 产品方案共同确认）
|
||
- 监控与运维脚本、OTA、USB 重定向等终端其余能力
|
||
|
||
先读 `PROJECT_CONTEXT.md`，再查看 `git status`，不要丢弃未提交改动。
|