桌面云平台检测工具（体检 · 修复 · 报告）
判断「这套桌面云平台现在到底健不健康」，过去只能一页页翻控制台：服务器在不在线、终端有没有连上、空间够不够、镜像有没有断链……分散在十几个页面里，也拿不出一份可以留档、可以交给用户签字的结论。桌面云平台检测工具把这件事收成一次操作：填一次管理员账号，一键跑完整轮体检，给出 0–100 的分数、逐项结论与处理建议，可对有限范围内的残留数据一键修复，并生成可打印归档的检测报告。
三条基本事实
- 检测逻辑全部在管理服务端执行，工具只与管理服务器的接口通信：不直连数据库、不访问镜像文件、也不向终端下发任何命令。
- 体检全程只读，单次通常数秒完成，可以在业务时间放心跑。
- 只有一键修复会写库，且必须由管理员显式点击并二次确认后才执行，范围写死在产品里（见第五节）。
一、三种形态，同一套口径
| 形态 | 说明 |
|---|---|
| 原生桌面客户端 | 双击即用的独立程序，界面自绘、不依赖浏览器，适合现场交付与演示 |
| 网页形态 | 本机小程序 + 浏览器界面，运行后自动打开本机界面 |
| 命令行巡检版 | 一条命令完成「登录 → 检测 → 存报告 → 退出」，用于无人值守例行巡检 |
三者用的是同一套服务端能力与同一份报告口径，检测项、判定规则、分数算法、修复范围完全一致，不存在「桌面版能测、命令行版测不到」的情况。
界面语言
检测工具客户端界面目前只有中文（未做多语言），因此本页的界面名词不附英文对照；实际按钮文字以您手上这一版工具为准。
二、取得与运行
工具不在管理台菜单里，是一个独立交付的可执行程序，获取方式请咨询您的服务提供方。
1，把工具整个目录拷到管理员自己的电脑上——免安装、免配置，拷贝即用；运行库（含 VC++ 运行时）随目录一起打包，目标电脑无需预装。
2，双击运行，进入身份验证窗口。
只拷可执行文件会报缺少运行库
交付包里除可执行文件外还有一批运行库，必须整目录拷贝。只挑出 exe 单独拷走，在别的电脑上双击会直接提示缺库。
三、登录管理服务器
1，填写管理服务器地址与端口。
2，填写管理员账号与密码。
3，点击进入。工具会一次性校验三件事：账号密码是否正确、该账号是不是管理员、这台管理服务的版本带不带检测功能。任一不满足，都会把具体原因显示在窗口里，不会含糊报错。
| 常见提示 | 原因与处理 |
|---|---|
| 账号被拒绝 | 检测与修复接口一律要求管理员身份，普通管理账号不能使用 |
| 提示服务端不支持检测 | 该管理服务版本较旧。此时能登录，但点「开始检测」会明确提示，需要把管理服务更新到带检测功能的版本 |
| 连接不上 | 先确认地址与端口填对、管理服务在运行、这台电脑到服务器网络可达 |
密码不会被保存
工具只记住服务器地址与账号，密码不落地保存，每次运行需重新输入。
四、一键体检：11 项与评分口径
点「开始检测」后，界面按服务端真实的逐项进度推进，并显示当前正在检测哪一项，不是一个干等的转圈。整轮覆盖 11 项，其中可公开说明的十项如下：
| 检测项 | 大致看什么 |
|---|---|
| 服务器连接状态 | 引导服务、IO 服务等平台服务的在线情况（如「引导服务 1/1 在线」） |
| 终端连接状态 | 已登记终端数与在线数，以及终端记录本身是否完整（例如缺 MAC 地址会导致网络启动认不到设备） |
| 集群网络状态 | 平台各服务所需端口的监听与连通情况 |
| 数据库状态 | 数据库连通性与响应情况 |
| 文件系统状态 | 镜像存储目录是否已配置、磁盘可用空间是否充足（如「磁盘 42% 可用」） |
| 脏数据状态 | 指向已不存在对象的残留记录、超期的过程日志与平台临时文件 |
| 主控 HA 状态 | 主控高可用相关状态 |
| Guesttools 状态 | 客户机工具的登记与就绪情况 |
| 模板状态 | 模板镜像的完整性与关联情况 |
| 桌面状态 | 桌面配置与「默认桌面」指向是否有效 |
每一项都会给出：状态、一句话概述、关键指标明细、发现的问题，以及一条「去哪儿、做什么」的处理建议。
四种状态与计分：
| 状态 | 含义 | 是否计入分数 |
|---|---|---|
| 正常 | 该项无问题 | 是 |
| 警告 | 有隐患，暂不影响使用 | 是 |
| 异常 | 需要处理 | 是 |
| 未检出 | 检测条件不具备（并说明原因） | 否 |
各项按权重加权得出 0–100 分与健康度评级（优秀 / 良好 / 一般 / 较差）。「未检出」不计入分数——工具不会把「没测到」算成「有问题」，也不会拿一个虚高的分数糊弄人。
单项出错不会中断整轮
检测项之间彼此隔离，任一项出错只影响它自己（记为「未检出」并显示原因），整轮体检照常跑完。老版本平台库缺表时，对应项自动降级而不是报错。
检测项名称与明细指标以实机为准
上表按可公开范围整理，具体项名、指标条目与文案会随版本调整，请以您实机跑出的结果为准。
五、一键修复：能修什么、绝不动什么
「一键修复」按钮始终可点。 点开后弹窗会逐条列出「这次要修什么」，并把修复边界直接写在窗口里，确认后才执行；过程逐条回显（做了什么、影响多少条），完成后自动复检确认效果。没有可修项时点开是一句明确说明，不会让人分不清是「没问题」还是「功能坏了」。
修复范围（写死在产品里）：
1，清理指向已不存在对象的残留记录。
2，清理超期的过程日志与平台临时文件。
3，修正失效的「默认桌面」指向：该终端只有一个桌面时直接指向它（恢复开机直接进系统），有多个桌面时改为「无默认」。
修复不会碰业务数据
一键修复绝不删除或修改镜像、终端、分组、菜单等业务数据。另有一道保护：某类残留占到整张表的绝大部分时自动跳过并提示人工核对——这种形态通常意味着判断规则本身有问题，而不是数据真的全坏了。
六、把「本现场就该这样」的项标记为不用处理
有些结论在本现场当下本来就该是这个样子：演示或备用平台还没接终端、这台服务器本就不带镜像存储。为此，任何警告 / 异常项都可以「标记为不用处理」。
1，打开「一键修复」窗口。窗口分三段：自动修复 / 标记为不用处理 / 撤销标记。
2，在「标记为不用处理」里勾选对应项，确认。
3，如需还原，在同一窗口的「撤销标记」里取消即可。
四条边界（务必先看清）：
| 边界 | 说明 |
|---|---|
| 不动服务器数据 | 服务器下一轮仍然检出同一件事，只是工具把它按正常计分 |
| 分数立即重算 | 重算口径与服务端完全一致（按项权重加权），分数、计数、结论一起更新，不必等下一轮体检 |
| 报告保留原判 | 明细与报告里保留服务器报的原文，并注明原判是什么、谁标的、什么时候标的 |
| 90 天自动失效 | 到期后该项恢复按原判上报；标记按「服务器 + 检测项」记账，存在运行工具的这台电脑上，换台电脑看仍是服务器原判 |
服务端也有一份等价能力
管理服务更新到较新版本后，「一台终端都没有」与「未配置镜像存储目录」两项也可在服务器侧确认，确认记录随报告走、对所有客户端一致；同样是不动数据、保留原文、90 天到期恢复。这属可选升级，不装也不影响上面的本机标记。
七、生成与保存检测报告
一次检测可生成三种格式：网页版（自带排版，可直接打印成 PDF 归档）、纯文本版（便于粘进工单）、数据版。
| 形态 | 报告落在哪里 |
|---|---|
| 网页形态 | 点一次即存到工具所在目录的报告文件夹并触发浏览器下载；界面直接显示落地路径，可一键打开该目录 |
| 原生桌面客户端 | 弹另存对话框，默认落在桌面；保存后可一键打开报告或打开所在目录 |
同名报告不覆盖，自动追加序号。
有标记项时报告由本机生成
本次结果里若有「标记为不用处理」的项，报告改由工具在本机生成（内容与界面一致，逐条注明哪些是标记项、谁标的）。这是因为服务器并不知道本机的标记——照旧取服务器报告的话，报告上的分数会和屏幕上的对不上。没有标记项时，报告仍取管理服务器渲染的那一份。
八、多服务器（集群）总览
机房里有多台管理服务器时，不必反复切换登录。
1，工具默认进入集群总览：顶部汇总条给出服务器台数、平均分、异常项合计、终端在线/总数；下面是服务器卡片网格，一台一张卡。
2，每张卡含分数环、状态徽标、正常/警告/异常计数，以及四项关键指标：引导服务在线数、IO 服务在线数、终端在线/总数、最低可用空间与数据库响应时间。卡片按状态染色。
3，点某一台或双击卡片，进入该台的 11 项明细页；顶栏切换成该服务器名称，并提供「返回集群总览」。
4，点「全部检测」对清单里所有服务器并发体检，卡片逐台从「检测中」变成结果。
5，可一键导出集群汇总报告：集群整体指标 + 全部服务器一览表（分数 / 健康度 / 计数 / 体检时间）+ 逐台的异常与警告明细及首条处理建议，可直接打印归档。单台的完整报告仍在明细页单独导出。
服务器清单可添加 / 移除，并支持自定义显示名（如「机房A主控」）。首次登录的管理员账号作为统一账号，加新服务器时默认复用；个别机器需要单独账号也可单独填。
单台失败不打断其它台
某台连不上不会影响其它服务器的体检，失败原因显示在它自己的卡片上（卡片只留第一句，完整原因鼠标悬停可见）。
清单存本机，密码不落盘
服务器清单保存在运行工具的这台电脑上（不含密码），密码只留在内存，重开工具用统一账号登录一次即可全部可用。移除服务器只影响本工具的清单，不动服务器本身。
九、命令行巡检（无人值守）
命令行版一条命令完成「登录 → 检测 → 存报告 → 退出」，适合挂到定时任务里做例行巡检：
1，用参数带上服务器地址、端口与管理员账号密码。
2，加
-report <文件>直接把报告写到指定文件并退出，不弹另存对话框；格式按扩展名判断，.html/.txt/.json三选一。3，存在异常项时以特定退出码返回，外部脚本可据此告警。
桌面客户端也支持命令行快捷启动：用参数带上服务器与管理员账号可跳过登录窗口、进界面即开始体检（自动登录失败会退回登录窗口并显示原因，不会静默退出）；另有一个「体检完成后把结果界面存成图片并退出」的开关，用于验收 / 投标截图与远程取证，对集群总览页与单机明细页都可用，能一次出两张图。
十、限制与常见问题
| 现象 / 场景 | 说明与处理 |
|---|---|
| 终端 / 模板 / 桌面项只做了有限检测 | 引导服务与管理服务的数据库分属不同数据库实例时会如此，工具会明确说明原因 |
| 集群卡片上几项关键指标显示「-」 | 该服务器的管理服务版本较旧、不提供结构化关键指标字段；其余内容照常显示，可升级该台管理服务解决 |
| 界面显示偏大或略糊 | 界面按 1080p 及以上分辨率设计，超高分屏依系统缩放显示；集群页为固定两列布局，超宽屏不会自动排三列 |
| 卡片停在「检测中」看不到进度 | 集群总览的卡片不显示逐项进度，逐项进度只在单机明细页显示 |
| 新装 / 演示平台分数偏低 | 「一台终端都没有」「未配置镜像存储目录」在这类平台上属正常形态，可用第六节的「标记为不用处理」，或把管理服务升级到已修正该判据的版本 |
| 大规模多主控、多 IO 服务现场 | 该场景下的表现仍在持续验证中，若结论与实际不符请保留报告并反馈 |
排障时的分工
本工具回答的是「平台整体健不健康」。若要进一步定位到某台服务器的端口占用、磁盘速度或某份日志，请配合控制台「其他」下的诊断入口与服务端日志；需要跨多份日志一次性检索时，可交给 AI 助手。