如何用小程序管云桌面
本页讲的是绑定完成之后的日常使用：在手机上看教室、下发开关机、查巡检事件、取终端密码。 绑定与开通流程请先看 如何绑定小程序来管理云桌面。
一、开始之前
小程序能正常进入并看到数据，需要下面几项都已具备：
| 前提 | 说明 |
|---|---|
| 管理员已完成「启用 + 分配权限」两步 | 在 控制台 → 小程序管理 → 用户管理 里，只点「启用」不分配权限，用户仍进不去，会停在开通提示页 |
| 分组挂在上级组织根节点下 | 分组的「根」是上级组织名（如 实验楼 / 浦东校区）。小程序按这个主分类过滤，没有根节点就看不到分组，详见 快速安装 |
| 从国内网络访问 | 小程序限制国外 IP 用户访问，详见 快速管理区域 |
| 手机系统 | iOS、安卓、鸿蒙均可使用 |
遇到问题先更新小程序
弱网（4G/5G）下曾有「第一次点没反应、再点一次才好」的现象，新版本已修复。使用中如果碰到，请先在微信里把小程序更新到最新版本再判断。
二、四个页签分别管什么
进入小程序后底部固定四个页签：
| 页签 | 用途 |
|---|---|
| 首页 | 总览指标、告警事件计数、巡检事件通知；加载失败时可在这里「重试 / 切换服务器」 |
| 融合云管 | 集中控制（Centralized Control）：按教室分组看在线台数与忙闲，进入分组后下发各类操作 |
| 巡检 | 巡检看板（Inspection Board）：教室状态、巡检事件和联动记录 |
| 我的 | 账号信息、切换服务器（Switch Server）、解绑等 |
三、接了多台服务器，先选对服务器
一个微信账号可以绑定多台 vDisk 服务器。看数据前先确认当前连的是哪一台，否则看到的是另一台的终端、事件与抓拍图。
1，点底部「我的」→「切换服务器」。
2，在列表里选择要管理的服务器。列表只列出当前在线的服务器；提示「暂无在线可切换服务器」说明目标服务器此刻不在线。
3，切换后回到首页，数据随之刷新。
提示「暂无可切换服务器，请重新扫码绑定」
说明本账号下没有可用的绑定关系。请让管理员在控制台重新生成小程序码与 6 位绑定码后重新绑定，不要反复重试。
四、融合云管：按教室看，按教室下发
「融合云管」页签打开的是集中控制页，以**分组（教室）**为单位列出：
- 每个分组显示在线台数 / 总台数与忙闲百分比；
- 该教室此刻正在上课时，会显示当前课程与授课教师（数据来自课表，详见 课表功能说明）；
- 顶部「筛选分组」可按上级组织收窄列表；
- 分组内如果纳管了门禁等物联设备，也可在这里直接操作，详见 物联网管理。
点进某个分组即进入该教室的云桌面列表。
五、云桌面列表与批量下发
1，在集中控制页点进目标教室，进入桌面管理列表。
2，列表每台终端可展开查看桌面、缓存、访问模式（Access Mode）、IP、MAC、网卡、运行时长、最后在线时间、下载状态等信息。
3，勾选要操作的终端（可用「全选」），再点右上角「操作」。
4，在操作面板里选择动作并确认下发。
操作面板按用途分区，常用的几类：
| 分区 | 可下发的操作 |
|---|---|
| 电源 | 唤醒（开机）、重启、关机 |
| 桌面与数据 | 下发缓存、访问模式、隐藏桌面、默认菜单、默认启动、删除桌面、清空写入、智能学习 |
| 下载与缓存 | 缓存校验、清空下载、更新菜单、网络探测 |
| 网络与维护 | 网络设置、网络管控（Network Control）、维护通道、修改 MAC、分辨率、外设管理 |
| 消息与命令 | 发送消息、发送命令 |
| 远程控制 | 远程桌面等远程维护入口 |
写入模式下不能用远程桌面
终端工作在写入（读写）模式时，小程序禁止发起远程桌面。需要远程看屏时请先把该终端切回还原 / 更新模式，改法见 如何修改访问模式。
按钮以实机为准
操作面板里出现哪些按钮，取决于当前管理服务与终端客户端的版本，以及管理员给这个小程序账号分配的权限——没有权限的入口不会显示。本表按常见版本列出，实际以手机上看到的为准。
六、巡检看板与抓拍图
底部「巡检」页签打开巡检看板，包含教室状态、巡检事件、联动记录三块，事件可按时间查看巡检结果。首页顶部另有「告警事件」计数与「巡检事件通知」列表，点列表底部的「查看全部巡检事件」可直接跳到巡检看板。
关于事件卡片上的现场抓拍图：
- 列表里显示的是缩略图，点开才去取原图；原图较大时首次加载会略慢，属正常现象。
- 图片由现场服务器在内网对本机自取，经云端中转按需回传给手机。现场既不需要被公网访问，也不需要能出公网。
- 巡检结果依赖教室内已纳管的摄像头。摄像头的纳管方式见 增加监控设备；纳管时的「所属分组」要选到与云桌面相同的子节点。
- 控制台侧对应的大屏见 自动运维大屏。
七、必做配置：小程序合法域名
抓拍图要显示出来，需要在小程序管理后台把业务域名同时加入两个名单：
| 名单 | 用途 |
|---|---|
| request 合法域名 | 各类接口调用 |
| downloadFile 合法域名 | 图片等文件下载 |
只配 request 的典型症状
「接口全通、页面数据都有，唯独图片一片白板」——这就是漏配 downloadFile 合法域名。补上即可。
八、终端密码与 AI 助手
- 终端密码：小程序 → 终端密码，可直接查看对应终端的密码，便于现场临时取用，详见 终端密码。该页取密码失败时只在页面内提示并提供「重试」，不会把人退回登录或绑定页。
- AI 助手：小程序里的 AI 助手与管理台是同一个大脑、同一套技能、同一份会话记录，可以在手机上接着管理台的会话往下问；技能库管理、记忆维护这类操作仍需在管理台完成。用法见 AI 助手。
九、常见问题
| 现象 | 原因与处理 |
|---|---|
| 绑定完停在「等待管理员开通」 | 管理员只做了「启用」、没有分配权限。到 控制台 → 小程序管理 → 用户管理 给该用户配好权限，再点页面上的「我已开通，尝试登录」 |
| 看不到任何分组 | 分组没有挂在上级组织根节点下，小程序按主分类过滤不到。在控制台把分组归到根节点下 |
| 首页反复提示服务器不可用 | 先确认「我的 → 切换服务器」里选中的是在线的那台；再确认现场服务器与云端通道正常 |
| 事件卡片图片全是白板 | 小程序管理后台漏配 downloadFile 合法域名，见第七节 |
| 点开原图很慢 | 原图按整字节经通道回传，首次加载略慢属正常；列表缩略图不受影响 |
| 远程桌面点不动 | 该终端当前在写入（读写）模式，小程序禁止远程桌面 |
| 某个操作按钮找不到 | 该账号没有对应权限（无权限入口自动隐藏），或客户端 / 管理服务版本较旧 |
| 在国外连不上 | 小程序限制国外 IP 访问，请从国内网络使用 |
手机与控制台的分工
小程序解决的是「人不在机房时的临时处置」：看状态、开关机、下发桌面、查巡检、取密码。镜像制作、模板更新、下载参数、权限配置这类重活仍在控制台完成。