Files
class-schedule/starschedule/docs/隐私与数据.md
T
2026-09-20 13:33:09 +08:00

2.5 KiB
Raw Blame History

隐私与数据

星课表没有账号体系,不提供云端用户服务。课表默认只存在本机。

1. 本机存储

位置 内容
Room 主库 课表、课程、周次、节次、每表学期配置
Room Widget 库 近 7 天已展开课程,供小组件和提醒使用
DataStore app_settings.preferences_pb 当前课表、提醒、主题、跳过日期等
DataStore api_config.preferences_pb WebDAV 地址、账号、加密后的密码
DataStore schedule_style_settings.pb 课表网格样式
应用私有目录 课表背景图
缓存 share_temp/ 导出分享用临时文件,启动时删除

卸载应用会删除上述数据(除非系统备份另行保存)。AndroidManifest 中 allowBackup 为 true,系统备份规则见 app/src/main/res/xml/backup_rules.xml 与 data_extraction_rules.xml。

2. 网络去向

应用主动访问的网络只有三类:

  1. 正方教务:用户在 WebView 中输入的学校地址。Cookie 留在 WebView 会话,应用不采集、不上传教务账号。
  2. WebDAV:用户自己配置的服务器。上传/下载备份包(meta.json、course.cbor、style.cbor)。
  3. 节假日:https://timor.tech/api/holiday/year,用于更新跳过日期。第三方接口,不保证可用。

network_security_config 允许明文 HTTP,因为部分校园教务仍是 HTTP。

3. 权限

权限 用途 不用于
INTERNET / ACCESS_NETWORK_STATE 上述三类网络 广告、统计 SDK(工程内无此类依赖)
SCHEDULE_EXACT_ALARM 上课提醒与勿扰开关闹钟
POST_NOTIFICATIONS 上课通知
ACCESS_NOTIFICATION_POLICY 上课勿扰
RECEIVE_BOOT_COMPLETED 重启后由同步链路重新调度闹钟
POST_PROMOTED_NOTIFICATIONS 实时通知相关

不申请读写系统日历、不申请精确位置、不申请通讯录。ICS 导出是用户主动保存/分享文件,由用户自行导入其他日历软件。

4. 密码与导入脚本

  • WebDAV 密码经 SecureCrypto(Android 系统密钥 + AES)加密后写入 DataStore,IV 一并保存。
  • 正方脚本只通过 JS Bridge 提交课程 JSON。脚本不能直接写数据库。Bridge 对象名为 shiguangBridge / shiguangBridgePromise。

5. 对外分发时建议说明

  • 数据默认仅本机;WebDAV 与教务网页由用户自行决定是否使用。
  • 节假日接口为第三方,可能失败或数据不全。
  • 无应用内检查更新、无远程配置下发。