WHUT 教务系统小助手

现代化教务浮窗助手，适用于武汉理工大学教务系统。支持学业监测、成绩分析、GPA 查询、官方证明下载与评教辅助。

基本信息

• 脚本名称：WHUT教务系统小助手
• 当前版本：3.6.10
• 适用网站：
  • https://jwxt.whut.edu.cn/jwapp/sys/*
  • https://jwxt.whut.edu.cn/jwmobile/index#/kwApp/cjcx/*
• 运行环境：Tampermonkey、Violentmonkey 等用户脚本管理器
• 数据来源：武汉理工大学教务系统已登录账号可访问的数据接口

功能亮点

学业监测

• 自动读取个人学业监测报告。
• 展示毕业资格状态、总学分进度、培养方案模块、课程明细和预警信息。
• 支持手动同步服务器端学业监测计算结果。
• 支持导出“学业综合表现”文件。
• 兼容不同学生培养方案参数形态，例如数字培养方案代码、新版培养方案代码、毕业年份 BYNF 与 * 等情况。

成绩分析

• 自动抓取成绩查询列表。
• 支持按课程名/课程代码搜索。
• 支持多学期筛选、课程性质筛选、绩点/学分排序。
• 支持课程详情展开，查看班级排名、最高分、平均分、最低分与成绩分布。
• 对“未评教”隐藏成绩，尝试从学业监测接口回填真实成绩。
• 自动统计当前筛选范围内的课程数、总学分、必修绩点与全科绩点。

GPA 查询

• 查询全学程综合 GPA、必修 GPA、班级排名和专业排名。
• 查询各学期 GPA 与排名明细。
• 支持手动维护学期列表，适配特殊学制或接口学期缺失的情况。
• 支持导出 GPA Excel 表格与生成图片报告。

官方证明

• 自动读取教务系统可下载的官方证明材料列表。
• 支持一键生成并下载 PDF 文件。

一键评教

• 自动读取当前学期评教任务。
• 按“进行中/可重评、未开始、已结束”分组展示。
• 支持批量选择课程。
• 支持配置主观题评语、请求间隔与评分策略，默认使用全满分模式。

请在确认符合学校、课程与个人真实评价要求的前提下使用评教辅助功能。

导出能力

• 当前成绩列表导出 Excel。
• 当前成绩列表生成长图。
• GPA 数据导出 Excel。
• GPA 面板生成图片。
• 学业综合表现文件导出。

安装方法

1. 安装用户脚本管理器，例如 Tampermonkey 或 Violentmonkey。
2. 新建脚本，将 教务系统.js 的完整内容粘贴进去。
3. 保存脚本并启用。
4. 登录武汉理工大学教务系统。
5. 进入 jwxt.whut.edu.cn/jwapp/sys/ 下的教务页面，右下角会出现悬浮球。
6. 点击悬浮球打开“教务系统小助手”面板。

使用说明

悬浮面板

• 点击悬浮球打开主面板。
• 面板顶部可以拖拽移动。
• 点击右上角关闭按钮后，面板会收起回悬浮球。
• 面板和悬浮球位置会保存在浏览器本地。

学业监测

• 打开脚本后会自动尝试加载学业监测数据。
• 如果数据为空或不是最新，可点击“手动同步”。
• 点击培养方案模块可展开课程明细。
• 点击“导出综合表现”可下载教务系统生成的综合表现文件。

成绩分析

• 脚本会自动抓取成绩查询数据。
• 可使用搜索框、学期筛选、课程性质筛选和排序控件查看目标课程。
• 点击课程卡片可展开成绩详情。
• 若成绩显示“未评教”，脚本会在学业监测数据可用时尝试回填。

GPA 查询

• 首次进入 GPA 查询页会自动加载全学程与各学期 GPA。
• 若某些学期未被自动识别，可点击“手动更新学期”维护学期列表。
• 学期格式示例：2025-2026-2。

官方证明

• 进入“官方证明”页后自动读取可打印材料。
• 点击对应材料右侧的“下载 PDF”即可下载。

一键评教

• 进入“一键评教”页后自动读取评教任务。
• 点击“配置”可设置评语、请求间隔和评分策略；默认评分策略为全满分。
• 勾选需要处理的课程后，点击“开始一键评教”。
• 建议在网络稳定时使用，并保留合理请求间隔。

权限说明

脚本声明的权限均用于教务系统页面内功能：

• GM_addStyle：注入悬浮球、面板、图表和列表样式。
• GM_xmlhttpRequest：请求教务系统接口，下载 PDF 或 Excel 等文件流。
• @connect jwxt.whut.edu.cn：限制跨域请求目标为武汉理工大学教务系统域名。
• @require html2canvas：用于生成成绩/GPA 图片。
• @require SheetJS：用于导出 Excel 文件。
• @require SweetAlert2：用于弹窗、提示和配置确认。

数据与隐私

• 脚本不主动向第三方服务器上传教务数据。
• 脚本请求的数据来自当前登录账号可访问的武汉理工大学教务系统接口。
• 浏览器本地会保存少量配置：
  • 悬浮球位置
  • 面板位置
  • GPA 自定义学期列表
  • 评教配置
• 脚本通过公共 CDN 加载 html2canvas、SheetJS 和 SweetAlert2 依赖库。
• 反馈问题时请勿公开 Cookie、会话 ID、学号、姓名、成绩等敏感信息。

常见问题

看不到悬浮球怎么办？

• 确认脚本已启用。
• 确认当前网址匹配 jwxt.whut.edu.cn/jwapp/sys/。
• 刷新页面或重新登录教务系统。
• 检查脚本管理器是否拦截了外部依赖加载。

学业监测显示 0 / - 学分怎么办？

• 点击“手动同步”重新触发教务系统计算。
• 进入学校官方“学业监测/个人学业监测报告”页面确认官方页面是否有数据。
• 如果官方页面有数据但脚本没有显示，可能是接口返回结构变动。反馈时建议提供 queryXyzhbx.do 的响应结构示例，但不要包含 Cookie 或个人敏感信息。

GPA 某些学期没有数据怎么办？

• 点击“手动更新学期”。
• 按 2025-2026-2 这类格式添加缺失学期。
• 保存后脚本会重新加载 GPA 数据。

“未评教”成绩没有回填怎么办？

• 先进入“学业监测”页等待数据加载完成。
• 若仍未回填，说明当前教务接口可能没有暴露对应课程成绩。
• 可以尝试手动同步学业监测后再回到“成绩分析”查看。

官方证明 PDF 下载失败怎么办？

• 确认当前登录会话没有过期。
• 先在官方证明页面打开一次对应功能。
• 若系统返回 HTML 或空文件，通常是教务系统后台未生成成功，可稍后重试。

为什么学业监测会出现多次请求？

为兼容不同年级、不同培养方案和不同 BYNF 参数形态，脚本会自动尝试多个参数组合。只要最终能显示正确数据，这属于正常行为。

注意事项

• 本脚本为非官方辅助工具，不代表学校或教务系统官方功能。
• 所有统计结果仅作辅助参考，最终数据以学校教务系统官方页面和导出文件为准。
• 请遵守学校相关规定，合理使用自动化功能。
• 教务系统接口或页面结构变动后，部分功能可能需要更新适配。

更新记录

v3.6.9

• 必修绩点颜色调整为 home.haoli.site 亮色主题中的深蓝色 #1565c0，用于成绩分析底部统计、成绩长图和 GPA 查询面板。
• 将全局轻提示从 SweetAlert2 Toast 改为自定义浮窗，避免与脚本弹窗互相抢占。
• 强化更新内容区域左对齐，避免 SweetAlert2 默认居中样式影响列表正文。

v3.6.7

• 更新面板说明改为直连 home.haoli.site 的 user.js 文件，减少对脚本猫页面的依赖。
• 检查更新时不再使用 SweetAlert2 Toast，避免“当前已是最新版”等提示把更新面板关闭。
• 更新内容列表改为左对齐显示，阅读更自然。

v3.6.6

• 顶部更新按钮改为“🔄 检查更新”，含义更明确；发现新版本后自动变为“有新版”状态。
• 新增自动检查更新：进入教务系统后会按 6 小时间隔静默检查 latest.json，发现新版时弹出轻提示。

v3.6.5

• 脚本更新入口移到顶部标题栏右侧，不再占用功能标签页。
• 标题栏补充作者标识“毫厘制作”，更明确展示脚本名称、版本和作者。
• 自托管更新文件调整为独立目录：/assets/scripts/whut-jw-helper/，便于后续维护多个脚本。

v3.6.4

• 继续增强学业监测课程明细去重，针对接口直接返回两份相同课程数据的情况按页面显示内容兜底去重。
• 灰色待修/未修读课程不再因接口重复节点而显示两遍。

v3.6.3

• 修复学业监测模块中同一课程在同一培养方案分组内重复显示的问题。
• 优化学业监测课程明细去重逻辑，避免重复节点导致已修学分或课程列表重复累加。

v3.6.2

• 优化成绩分析绩点统计，缓考、待定、未公布等非最终成绩不再按 0 绩点计入平均绩点。
• 修正最新学期存在缓考课程时绩点被明显拉低的问题。

v3.6.1

• 一键评教默认评分策略调整为全满分。
• 仍可在配置中手动切换为随机波动模式。

v3.6

• 学业监测页移除学期学分趋势板块，页面更聚焦毕业资格和培养方案模块。
• 成绩详情页移除平时、期中、期末成绩构成小面板，仅保留班级对比和成绩分布。
• 学业监测加载时不再请求学期趋势接口，减少一次无必要的数据请求。

v3.5

• 新增现代化浮窗面板，支持拖拽、收起和位置记忆。
• 新增学业监测视图，展示毕业资格、培养方案模块和预警信息。
• 增强学业监测接口兼容能力，适配多种 PYFADM 与 BYNF 参数组合。
• 增强课程数据递归解析，兼容不同接口返回结构。
• 优化成绩分析筛选、排序、导出和统计。
• 支持从学业监测数据回填“未评教”隐藏成绩。
• 新增 GPA 学期手动管理。
• 新增官方证明 PDF 下载。
• 新增评教配置与批量处理能力。