资源门户与门户设置
一、资源门户是什么
资源门户（Resource Portal） 是一个面向全校师生的公开页面：访客不需要云桌面管理员账号，直接用浏览器打开门户地址就能查看，页面上用到的接口本身也不要求登录。它的用途是把「机房里有哪些桌面、装了什么软件、机器是什么配置、这周的课怎么排」这类师生常问的信息集中挂出来，减少管理员被反复问同一个问题。
管理员这边有两个入口，都在 控制台 -> 资源中心（Resource Center） 下：
| 入口 | 用途 |
|---|---|
| 资源门户（Resource Portal） | 打开门户页面本身，管理员可以先看一眼师生看到的是什么样子 |
| 门户设置（Portal Settings） | 配置门户上展示的范围与内容 |
「资源门户」在资源中心菜单下排在第一位。
TIP
门户既然是公开的，就意味着页面上的内容对任何能访问到该地址的人都可见。要控制对外展示范围，靠的是「门户设置」里的可见分组与可见桌面（见第三节），而不是权限。
二、门户的八个页签
门户共 8 个页签。所有页签都做成了定高表格：表头固定、内容只在表格内部滚动，内容再多也不会把页面本身撑长，页签栏始终在一屏之内。页面右上角有 刷新（Refresh） 按钮，可强制重新取一次最新数据。
| 页签 | 内容 |
|---|---|
| 首页 | 信息区，含公告、投票、问卷、今日课表等；页头显示门户标题、一行说明与当前学期 |
| 软件分布（Software Distribution） | 按镜像 / 桌面查看已安装软件清单与更新历史 |
| 桌面分布（Desktop Distribution） | 各分组（机房）分别在用哪些桌面 |
| 终端硬件分布（Terminal Hardware Distribution） | 各分组的机器配置（用一台代表机表示） |
| 课表查询（Schedule Query） | 按学期 / 教室 / 校区 / 教师 / 课程查课 |
| 资源链接（Resource Links） | 管理员挂出的外部链接清单 |
| 安装包下载（Package Download） | 管理员上传的安装包，师生自取 |
| 帮助文档（Help Documents） | 管理员维护的帮助说明 |
三、门户设置
进入 控制台 -> 资源中心 -> 门户设置，可配置以下内容：
| 配置项 | 默认值 | 说明 |
|---|---|---|
| 门户标题与说明 | 产品默认文案 | 显示在门户页头 |
| 可见分组 | 不勾选（＝不限制） | 挑选门户上展示哪些分组（机房） |
| 可见桌面 / 镜像 | 不勾选（＝不限制） | 挑选门户上展示哪些桌面，作用于「软件分布」与「桌面分布」 |
| 公告 / 投票 / 问卷 | 空 | 显示在门户首页信息区 |
| 资源链接 | 空 | 对应「资源链接」页签 |
| 安装包上传 | 空 | 对应「安装包下载」页签 |
| 帮助文档 | 空 | 对应「帮助文档」页签 |
1，「可见分组」与「可见桌面 / 镜像」两项，一个都不勾选就是「不限制、全部显示」，不是「什么都不显示」。这两处界面上都写有这句说明，配置前请先看清楚。
2，勾选之后，门户只显示挑中的这些分组与桌面；想恢复全量，把勾选全部清空即可。
3，保存设置后门户不会出现空白窗口：页面继续显示上一版内容，后台重算完自动换新，最坏情况是看到几十秒的旧数据。
WARNING
上表按功能归类列出，各项在管理台里的具体摆放位置（同一页内的分区，或资源中心下的并列菜单）以实机菜单为准。
四、软件分布页签怎么看
这一页分上下两块：
1，上方是挑选表，逐行列出「桌面名称、软件数、历史版本数、最近一次更新说明」，整行可点、选中行高亮。镜像多的现场比下拉框好挑。
2，下方是该镜像的已安装软件清单，五列：程序名称、发行商、版本、大小、安装时间。表头固定，分页条在表格下方。
3，右侧还有该桌面的更新历史时间线，其中「当前版本」只显示本镜像自己的版本号。
关于这一页几个容易被误会的地方：
| 现象 | 说明 |
|---|---|
| 软件数量比以前明显变小 | 口径更正，不是数据丢失。 现在按「软件名 + 厂商 + 版本 + 大小」去重，与点进去的详情清单口径一致；以前把同一软件在不同快照里的重复条目各算了一条 |
「当前版本」以前是 1 | 4 | 6 | 7 这样一串数字 | 旧版本把一台终端上所有镜像的版本号拼在了一起。现已按镜像各记各的，但存量历史数据仍保留旧标签、不做追溯改写；每台终端更新后第一次上报起，新记录即为干净的单版本号 |
镜像名 / 软件名显示成 - 或一串镜像标识 | 早期终端上报时编码损坏的历史数据，原文无法还原，现在会把损坏痕迹清掉而不是把方块摆到界面上；接收侧已修好，终端下次上报即会覆盖为正确内容 |
| 更新日志一片空白 | 当版本标签对应不上时，「当前版本」这一行会退回显示最新一条更新日志；历史版本行仍保持留空，避免把最新说明错挂到旧版本上 |
五、桌面分布与终端硬件分布
这两张表都是按分组（机房）一行，教室 / 分组列固定在左侧，横向滚动时不会看丢行。
- 桌面分布：只列真正被分组使用的桌面——取的是「分组内第一台终端实际挂着的启动菜单」，没有任何分组在用的桌面模板不会占一列。所以这张表的列数通常比桌面模板总数少，属正常。
- 终端硬件分布：用分组内一台代表机的配置代表整个分组，显示代表机名称、主板、CPU、内存、磁盘、显卡与网卡。取代表机时会按顺序往后找，用第一台确实有硬件记录的终端，而不是固定取第一台。
全机房关机时也能看到配置
硬件信息是按终端网卡地址长期保存的，与终端是否开机无关。夜间或假期整个机房关机时，这两张表依然能显示各分组的机器配置。只有从未上报过硬件信息的分组（新装机、长期没开过机）才会显示「-」，这属正常。
六、课表查询页签
查询条件包含学期、教室、校区、教师、课程；条件下方常驻一行说明，写明当前是第几教学周。
1，页面上有一个 「只看本周有课」 开关，默认开启。开启时只列本教学周真正有课的记录，周次列会给本周的课打上「本周」标记。
2，开关开着却一条都没有时，会自动退回显示本学期全部记录，并在提示行里写明原因，例如「本周（第 N 周）没有课，下面是本学期全部 M 条课表」。不会出现空白页。
3，想看整学期，把开关关掉即可。
「可见分组」会连带收窄课表
门户设置里的可见分组同时作用于课表查询：教室下拉与查询范围都会按挑中的分组收窄。
因此——如果挑中的分组没有在「桌面与课表对应」里绑定过教室，课表查询就会查不到任何内容。这是设置本身造成的结果，不是故障。分组与教室的绑定关系见 课表功能说明 中的「桌面与课表对应」。
七、数据什么时候更新（缓存口径）
门户是公开页面，一天可能被打开很多次，所以后台对「重」查询做了快照缓存，并有定时预热（默认每分钟一轮）。管理员判断「是不是没生效」时请按下表对照：
| 数据 | 默认缓存时长 | 说明 |
|---|---|---|
| 门户整页（链接、安装包、公告、投票、问卷、帮助等） | 约 1 分钟 | 便宜的数据，随首页一起返回 |
| 桌面分布、终端硬件分布、桌面明细、课表查询 | 约 5 分钟 | 需要逐个分组向后台询问，最贵的部分 |
1，在管理台里改了门户内容（设置、公告、投票、问卷、帮助文档、资源链接、安装包等）会立刻让缓存失效，不用等到期。
2，课表这类来自其它模块的数据，最长会滞后一个缓存周期；不想等就点门户右上角的「刷新」强制取最新。
3，同一次浏览会话内来回切换页签、重新进入门户，前端会直接用已取到的数据，也需要靠「刷新」拿新的。
八、常见问题处理
| 现象 | 处理 |
|---|---|
| 三个分布页签（软件 / 桌面 / 终端硬件）一片空白 | ①管理服务刚启动后的第一分钟内可能为空，后台第一轮预热完成后自动补齐，等一轮即可；②检查门户设置里的可见分组 / 可见桌面是不是把内容全部排除了。页面在没有数据时会写明这两条原因 |
| 课表查询查不到任何内容 | 先看「只看本周有课」开关，再看可见分组是否绑过教室（见第六节） |
| 打开门户弹「Token 无效 / TOKEN 错误」提示 | 门户页已改为静默处理这类提示。仍出现说明管理台前端未更新，请把管理服务与管理台前端一并更新到本版 |
| 桌面分布的列数比预期少 | 只统计真正在用的桌面，属预期行为（见第五节） |
升级口径
资源门户的历次改动集中在管理服务与管理台前端，终端侧、引导服务、驱动均无需跟随更新。但管理服务与管理台前端建议一并更新：只更新其中一侧时，个别页签的显示行为可能与本文描述不一致。