功能：完善通用云管工作台、审计与诊断能力

terminal/native-cursor/README.md

@@ -41,6 +41,20 @@ gcc -shared -nostdlib -fPIC -O2 -Wall -Wextra -Werror -Wl,-z,defs \
 
 每台主机单独的ed25519私钥和known_hosts留在盒子配置目录（目录700、私钥600），不进仓库。known_hosts是在工作站用用户提供的SSH凭据成功认证后取得的真实主机公钥，没有在运行时自动接受新主机密钥。JSON和密钥应在已验证0005的客户端部署后才启用。上例SHA为2026-11-05现场构建；重新构建后须先停用profile、完成对应验证，再更新SHA并启用，不能把旧值机械替换为任意新文件的SHA。
 
+## NVIDIA 硬件采集（2026-11-11）
+
+当前两台 Linux 的现场部署已切换为 GTX 965M 渲染、NvFBC/CUDA 采集与 NVENC H.264 编码；不再沿用上文历史 X11 软件编码基线。使用兼容 Maxwell 的 Sunshine v2025.924.154138；不得仅更新主二进制而不复测 CUDA 架构支持和 pinned manifest。
+
+Ubuntu 的 NVIDIA→modesetting PRIME 路径会把服务端软件光标提前画进画面，仅设 NvFBC `bWithCursor=false` 仍会出现本地光标拖着视频光标。该主机在 `host.py` 同目录启用空标记文件 `hide-server-cursor`：捕获 guard 用独立 X11 连接持有 `XFixesHideCursor`，原生光标形状仍由另一个连接通过 `XFixesGetCursorImage` 读取。结束或异常退出时先停 Sunshine，再显式恢复并关闭隐藏连接；X server 也会在连接断开时释放该客户端的隐藏状态。标记仅在 Ubuntu 现场启用，麒麟保持原路径。撤销须先退出串流、停 guard，再移除标记后重连，不在同一串流中途切换。
+
+适配器编译增加 `-DVDI_NVFBC -Ivendor`。麒麟缺少 libc 开发启动对象时另加 `-ffreestanding -nostdlib`，并显式链接系统版本化 libc/libdl。`vendor/NvFBC.h` 保留上游 MIT 许可。拦截 NvFBC 函数表时检查 SDK 参数版本，仅在租约内关闭视频内光标，不修改调用方参数；`nvfbc-ready-v1` 是加载就绪凭据，`nvfbc-v1` 才表示实际捕获会话创建成功。
+
+麒麟的 Optimus 卡没有可用物理输出，旧内核 PRIME 显存导入也失败，因此显式启用 `VDI_NVFBC_HEADLESS=1`。适配器只在驱动报告支持采集、没有 RandR 输出且真实 X screen 为 2560×1440 时枚举整屏，标记 RandR 不可用，使 Sunshine 使用 `NVFBC_TRACKING_SCREEN`。它不生成真实显示输出，也不把不可采集屏幕报告为可用。UKUI 已目视验证桌面正常；Ubuntu GNOME 在相同无输出条件下黑屏，已恢复 NVIDIA + modesetting PRIME 输出，不能直接照搬麒麟配置。
+
+麒麟使用 `/opt/vdi-sunshine-maxwell/runtime/` 的私有动态加载器和依赖库运行该 Sunshine，不替换系统 glibc；可执行文件、适配器和新增脚本按文件进行 KYSEC verified 认证。GPU 路径及测量边界见 [本轮实施证据](../../docs/evidence/linux-gpu-20261111/README.md)。
+
+重启显示管理器可能使临时 guard 单元消失而遗留旧 ready/receipt；新租约在获得独占锁并确认旧 guard 停止后清理这两个标记，再等待新会话凭据。`test_native_cursor_host.py` 在实际 Ubuntu Linux 上覆盖该恢复情形及不完整 manifest 拒绝；`run_nvfbc_adapter.py` 配合 `nvfbc_adapter_stub.c` 在麒麟实际 glibc 上覆盖函数表 ABI、光标与整屏枚举边界。
+
 ## 停用与回退
 
 退出当前Linux串流，等guard inactive且原vdi-sunshine active。将对应 `<IP>.json` 改名为 `.disabled`，下次从同一正常列表连接即使用原视频光标。临时诊断也可设置 `VDI_NATIVE_CURSOR=0`，但必须在当前租约结束、原服务恢复之后重连。