# Windows 虚拟机镜像功能说明

本镜像已预装 Agent 服务，开机即自动运行，为用户提供以下开箱即用的功能。

## 1. 应用管理

### 1.1 应用列表

虚拟机启动后，客户端自动获取 VM 内已安装应用的完整列表，显示应用名称、图标、版本和发布者信息。

应用来源：
- Windows 开始菜单快捷方式（.lnk）
- 系统注册表中已登记的安装程序

### 1.2 启动应用

用户在客户端点击任意应用图标，VM 内部自动启动该应用，无需在 VM 内手动操作。

应用启动参数可通过客户端传递，支持自定义工作目录。

## 2. 磁盘管理

### 2.1 磁盘扩容

用户可在客户端发起磁盘扩容请求，VM 内部自动执行磁盘分区扩展，无需进入 VM 操作 diskpart。

### 2.2 快照恢复

基于 qcow2 写时复制机制，系统支持快照创建与恢复，可将 VM 回滚至任意历史状态。

## 3. 系统控制

| 操作 | 说明 |
|------|------|
| 注销 | 注销当前用户会话 |
| 重启 | 重启虚拟机 |
| 关机 | 关闭虚拟机 |

## 4. 文件共享

VM 启动时自动挂载 host 端共享目录，映射为 VM 内三个盘符：

| VM 盘符 | 对应内容 |
|---------|---------|
| `R:` | host 上的主共享目录（Data） |
| `S:` | host 上的主目录（Home） |
| `T:` | host 上的媒体目录（Media） |

用户可在 VM 内直接访问 host 文件，也可在打开文件对话框中直接使用共享目录路径。

## 5. 剪贴板同步

VM 与 host 之间自动同步剪贴板内容：
- VM 内复制的内容可在 host 粘贴
- host 内复制的内容可在 VM 内粘贴

## 6. 时间同步

客户端与 VM 保持时间同步，若检测到时间偏差超过 60 秒，自动校正 VM 系统时间。

## 7. 接口索引

下表供维护人员参考，普通用户无需关注。

| 接口路径 | 功能 |
|---------|------|
| `/agent/getapps` | 获取应用列表 |
| `/agent/openapp` | 启动应用 |
| `/agent/control` | 系统控制（注销/重启/关机/扩容） |
| `/agent/setsysteminfo` | 配置文件共享 |
| `/agent/getsysteminfo` | 获取 VM 系统信息 |
| `/agent/heartbeat` | 心跳 + 时间同步 |
| `/agent/refreshapps` | 刷新应用列表 |