Files
class-schedule/starschedule/docs/常见问题.md
T
2026-09-20 13:33:09 +08:00

69 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 常见问题
## 正方导入
**导入按钮点了没反应或提示不在课表页**
脚本会检查当前页 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`。