# 常见问题 ## 正方导入 **导入按钮点了没反应或提示不在课表页** 脚本会检查当前页 HTML 是否包含「课表查询」,并读取 `#shcPDF` 的 `data-type`。必须已经登录,进入「学生课表查询」,选学年学期并点过查询,页面上能看到课。 **提示没有 jQuery** 正方课表页一般自带 jQuery。若学校改过前端、或当前不是标准课表查询页,脚本会失败。可试网页右上角切到「电脑模式」再查询。 **导入成功但时间不准** 正方脚本只写入课程名、星期、节次、周次、教师、地点,**不写入节次钟点和开学日期**。请到「自定义时间段」「设置开学日期」按本校作息补全,否则提醒和小组件的钟点会对不上。 **导入后原来的课没了** 这是覆盖语义:会先删除目标课表的全部课程再插入。导入前先选对课表,或先做 ZIP / JSON 备份。 **学校不是正方 / 页面结构不同** 本应用不维护多学校适配仓库。只适配常见正方 HTML 列表(`#kblist_table`)与网格(`#kbgrid_table_0`)。其他教务请用 JSON 导入或手动排课。 ## 周次与显示 **今日课表一直提示设置开学日期** 「我的 → 设置开学日期」,选教务第一周对应的那一天(再配合每周起始日对齐)。未设置时无法计算当前周。 **当前周和教务差一周** 开学日期必须是「第一周」的锚定日,且「每周起始日」与教务一致(周一或周日)。改「当前周数」会反推开学日期。 **周末没有格子** 打开「我的 → 是否显示周末」。这是按课表保存的,换课表可能不一样。 ## 提醒 **到点没有通知** 1. 打开「课程提醒」,授予通知权限。 2. Android 12+ 打开精确闹钟权限。 3. 国产系统允许自启动、忽略电池优化。 4. 确认已设开学日期和节次时间,且当天不在跳过日期里。 5. 提醒依赖近 7 天已展开的小组件库数据;改课后打开一次应用,让同步跑完。 **上课没有自动勿扰** 必须先开课程提醒,再选勿扰,并授予系统「勿扰模式」权限。静音模式改的是铃声音量,部分机型会被系统策略拦住。 **手环收不到通知** 打开「兼容穿戴设备同步通知」,关闭实时(Ongoing)通知属性,方便部分同步软件抓取。 ## 小组件 **桌面搜不到或名字不对** 系统桌面长按 → 小组件 → 搜索「星课表」。四种名称:超小课程2x1、紧凑课程2x2、近日课程4x2、垂直列表课表4xN。 **内容不更新** 小组件读独立 Widget 库。打开一次应用触发同步;或移走再添加。定期还有 15 分钟 UI 刷新与每天一次全量同步(WorkManager,系统可能推迟)。 ## 备份 **WebDAV 连不上** 检查地址是否含协议(`https://` 或 `http://`)、账号密码、远端目录是否有权限。密码只存在本机加密存储。默认根目录名仍是历史字符串 `ShiguangSchedule`,备份文件在其下的 `Backup/`。 **恢复失败,提示版本过新** 备份模块的 schema 比当前应用新。先升级应用再恢复。 **恢复后壁纸没了** 样式备份会尽量带上本地壁纸路径;换机后原路径无效,需在个性化里重新选图。 ## 构建 **找不到 `gradlew` / `:androidApp`** 在 `starschedule/` 目录执行。模块已改名为 `:app`:`gradlew.bat :app:assembleDebug`。