FAQ

常见问题

以仓库 README/FAQ 与代码为准整理。版本相关答案随发布更新。

关于项目

Q:Sleepy 和 WakeUp 课程表什么关系? 没有关系。独立项目、独立作者、独立代码。格式层面兼容:WakeUp 导出的 JSON/分享文本 Sleepy 能导,反向 WakeUp 兼容 JSON 也能导出。

Q:免费吗?有内购吗? 免费,GPL-3.0 开源,无内购无订阅。

Q:有广告吗?会上传数据吗? 无广告,代码里没有广告 SDK;无分析 SDK(Firebase/Crashlytics/Sentry 等都没有),课表数据只在本地 Room 库。

Q:要注册账号吗? 不要。不收任何个人信息。

Q:iPhone 能装吗? 不能。截至 2026-09 没有公开 iOS 版。

安装运行

Q:最低 Android 版本? Android 8.0(API 26)。compileSdk 37。

Q:三种 APK 怎么选? arm64-v8a 主流机型;armeabi-v7a 32 位老机;x86_64 模拟器。

Q:ColorOS/OPPO/一加桌面组件空白? v1.0.29 前用 Glance 异步渲染,ColorOS 冻 SessionWorker 导致不刷新;v1.0.29 起全切同步 RemoteViews + Canvas。升级解决。详见桌面组件渲染技术。

导入导出

Q:学校不在名单里怎么办? 用 school_adaptation.yml 模板开 issue,附教务系统 URL + 失败现象。维护者先做 URL 协议指纹识别,不行才要采集包,采集按 adapt-kit 走。账号密码验证码永远不提交。详见新学校适配指南。

Q:教务直连安全吗? WebView 加载真实教务登录页,账号密码只进 WebView,不进 Sleepy 任何持久化层。抓到课表数据即关闭。

Q:支持哪些导入格式? 七种:WakeUp 分享文本(以「【来自WakeUp课程表】」开头)、WakeUp JSON、ICS、CSV、HTML 表格、制表符分隔纯文本、sleepy-v1。自动识别,不用手动指定。详见导入格式全解。

Q:sleepy-v1 是什么? v1.0.49 引入的 Sleepy 原生纯文本格式,带 chk 完整性校验字段,导入导出完整还原。老格式继续保留。详见导出课表。

Q:导出格式有哪些? WakeUp 兼容 JSON、分享文本、ICS、sleepy-v1。文件落 Download/Sleepy/,自动弹系统分享。

Q:导出去的文件别人能导回 Sleepy 吗? 能。WakeUp JSON / ICS / sleepy-v1 三个方向都能回。

Q:能从 WakeUp 迁移吗? 能。WakeUp 导出 JSON 或分享文本 → Sleepy 导入。2021 前的老格式也认。

桌面组件

Q:五种桌面组件分别是什么? Today(4×3,今日列表)、TwoDay(5×3,今天+明天)、WeekList(5×4,7 日概览)、WeekView(5×4,周视图缩略)、WeekGrid(4×5,完整时间网格)。详见桌面组件总览。

Q:WeekGrid 颜色和主 app 不一样? 那是 bug。三条渲染路径(主 app / WeekGrid / 截图渲染器)统一走黄金角 HSL(137.508°)课程配色。

Q:桌面组件不刷新?

1. 通知权限给了没;2) 省电白名单(ColorOS/MIUI/EMUI 都吃这个);3) 版本 < v1.0.29 是 Glance 问题,升级。

Q:桌面组件上点课程没反应? 部分厂商桌面(MIUI/ColorOS/OneUI)吃点击事件,换第三方桌面(如 Nova)验证。

提醒

Q:课前提醒能自由设吗? 能,1-999 分钟自由输入。

Q:关了提醒还能收到? 不能。master toggle 在「我的 → 提醒」,默认关闭。

Q:提醒是本地推还是云推? 本地。AlarmManager 精确 + 非精确双路,BootReceiver 开机重注册。

课程与冲突

Q:同一时间两门课会丢一门? 不会。网格视图冲突多层保留,点被覆盖区域轮换显示。手动加冲突课会列实际重叠周次,确认才保存。详见冲突课程。

Q:撤回能撤多远? 最近一次课表数据修改。切课表不算数据修改。详见撤回系统。

Q:能存多张课表? 能。每张表独立节次、开学日期、最大周数。

Q:节次能自动算? 能。自动模式填每节时长 + 总节数 + 首节时间 + 课间模板,推算全部。详见节次系统。

主题

Q:跟系统切深色吗? 「我的 → 外观与主题」可设跟随系统(动态取色)或 5 套预设。详见外观与主题。

Q:Material You 动态色? Android 12+ 从壁纸取色,旧设备走预设。

开发构建

Q:自己编译?

git clone https://github.com/lingion/sleepy.git
cd sleepy
./gradlew assembleDebug

JDK 17+。产物 app/build/outputs/apk/debug/,约 20 MB。Windows 用 .\gradlew.bat assembleDebug。

Q:跑测试? ./gradlew testDebugUnitTest。

Q:怎么贡献? 看仓库 CONTRIBUTING.md。commit 不带 Co-Authored-By。详见参与贡献。

相关页面

• 快速上手
• 教务系统导入总览
• 桌面组件总览
• 参与贡献