vdi-cloud/docs/README.md

项目文档索引

整理日期：2026-11-09。日常阅读以下 5 份正文；历史过程放入归档，避免把早期失败或临时配置误当成当前状态。

文档	查什么
真实云管接入	正式环境启动、现场 PVE/盒子、凭据与回退
云管功能核对	对照原需求的已实现/剩余项、模板与桌面池使用及验收条件
当前状态	当前架构、三种桌面配置、已完成与未验收事项
终端说明	开机直达选择页、进入/退出交接、快捷键、显示恢复、构建入口
云桌面说明	Windows/Linux 编码与画质、原生光标、电源按钮、U 盘
运维说明	vdi-monitor 分工、日志位置、排障顺序、备份回退
未来计划	后续产品化、性能路线，以及暂不实施的 VPN、白名单、品牌画面

另保留正在讨论的云端服务与 Web 控制台功能设计，用于产品/UI/后端任务拆分；它是讨论稿，不属于本次清理的历史实施记录。

云管开发说明记录第一阶段代码、启动方式、接口与当前限制；本机控制台使用 Go API 和 PostgreSQL；已另行完成真实 PVE 与盒子接入，正式入口为 5182。

控制台 UI 接入记录记录按 ui/ 设计稿接入的深浅主题、页面范围、验证方式与实际数据边界。

监控项目与本仓库的分工

D:\DAIMA\vdi-monitor 负责日常监控页面、指标采集与日志解读，具体维护方法见该项目的 README 和 运维说明与已知限制。

监控当前约每 30 秒采集一次盒子数据，保存最新原始快照和状态，并保留约 7 天指标历史。这不等于完整历史日志备份，也不覆盖开发决策、测试场景、失败实验和回退配置。vdi-cloud 保留这些资料；11-10 另在云管控制台新增 PVE 节点曲线和平台告警，见范围说明，不替代独立监控的诊断采集。

历史记录与原始资料

• 归档索引：35 份原专题记录，以及整理前的根目录 README、MEMORY、PROJECT_CONTEXT，共 38 份文件，逐字节保存在 ZIP 中；索引包含原文件到新文档的对应关系和校验方式。
• 测试证据目录：截图、JSON、原始日志、配置快照和失败实验保留原路径，仍可供脚本输出和复查。
• 原始需求保留为本目录的 产品方案、软件开发方案、云管端完整方案。它们是原始需求来源，早期协议和环境描述需结合后续已确认的实现理解。
• 虚拟显示器配置 与 历史驱动安装辅助脚本 保留作参考，不能直接当作当前环境的一键部署方案。

本次清理删除的是归档后散落的 35 份 Markdown 副本，没有删除唯一测试证据，也没有因为监控项目存在而停用盒子服务。完整性结果见归档索引。

后续维护方式

日常变更更新对应主题文档，注明日期、实际部署状态、证据位置和限制；计划统一写入 roadmap.md。测试原始输出放在 evidence/<专题-日期>/，一般不再新增一份顶层日报文档。发生配置冲突时，以较新的部署证据核对现场，不把历史测试成功直接视为当前状态。

• 终端生命周期与用户维护：设备改名/分组、停用/重新激活、用户资料/启停与批量桌面授权。

• 终端运维策略：配置模板、下发和应用回执

• CSV 导入、会话历史与监控告警：使用入口、格式、数据留存、迁移与验收边界。

• PVE 接入配置、桌面规格与登录限流：真实配置保存、规格任务保护、可信代理及现场验收边界。

• 关机快照与手动还原：列表、创建/删除/还原任务、未知结果保护及现场权限与磁盘范围限制。

• 桌面批量电源操作：跨页选择、逐台预检、批次任务、跳过原因与未确认结果核对；已部署，现场仅做只读预检和取消提交验收。

• GPU 清单与配置引用：真实 PCI 清单、IOMMU 分组、当前/待应用直通引用及不完整检查提示；仅资源查看，绑定与健康采集尚未接入。

• 终端系统指标与历史：真实 CPU、内存、SoC 温度、运行时长和 30 天历史；串流 FPS/RTT 仍未采集。