Repository navigation
Releases
v0.2.1
这一版改的是小组件的可读性
上次装上小组件后,最集中的三条反馈是:字太小看不清、课程名和地点被省略号截掉、翻周按钮太小老点到本体跳进 App。这一版逐条解决。
小组件:字体放大、信息不再被截断
- 字号整体抬升:本周课表的课名从 7.9 号提到 9.2、教室与教师从 6.9 提到 7.8;表头的星期行从「星期」「日期」两行合成一行「今 20」「六 21」,反而能放大到 10.2 号;周次 12 号、日期区间 9.2 号、箭头 17 号。今天与明天的表头与格子同样放大。
- 不再靠省略号硬截,改成三级退让:课名最多占 3 行(先扣掉教室与教师的高度再决定,不会挤掉地点);教室先在 7.8→6.4 之间缩字号保住整串(折行会变成「@a30 / 2」这种断码,比小一号更难认),真放不下才折两行;教师最后才省略。
- 行高加大:44–58dp → 52–68dp;卡片高度 ≥240dp 时(比如 4×3 的 320×260)行高直接给到 62dp,一行能写三行课名,「数据结构与算法」这种 7 字课名也能完整显示。代价是少露两行节次——反正可以滚,信息完整优先。
- 翻周按钮 26×20dp → 32×32dp:可点面积约 2 倍,箭头放大,并加了「半透明底 + 1px 描边 + 圆角」的外框,边界清楚;位图与布局热区位置严格对齐,不会再出现「想翻周结果跳进 App」。
顺手修掉的一个崩溃
上一版「本周课表」在部分系统上显示「载入出现问题」,根因是两个翻周热区用了裸 android.view.View——它没有 @RemoteView 标注,若干桌面在 inflate 时抛 InflateException 直接换成错误占位卡。现已改为 ImageView(同样透明、同样可点),并给两个小组件的 provider 加了完整兜底:数据读不出来或尺寸拿不到时不再整体崩,而是退回「打开 App 同步一次」的提示卡。
其他一并带上的改动
- 教务导入的学校库扩到一千四百余所高校,其中两百六十余所有针对该校页面结构的专用适配,其余按教务系统类型走通用适配;研究生系统单独归类成一个页签,与本科 / 高职分开。
- 导入流程改为手动确认:应用不会替你去点教务系统里的任何按钮,也不会在后台自动抓取;导入教程等你自己打开课表页再亲手点「执行导入」,并写明多数学校需要先连校园网。Excel 导入从「首选」降为「备选」。
- 首次打开不再直接弹导入面板,换成六页功能指引(导入方式、四个页签各自能干什么、提醒与备份),设置里也能随时重看。
- 单门课可以单独设时间:编辑课程时点「自定义」即可,不影响其他课跟随节次表。
- 流畅度:修掉了设了背景图的用户每次保存都卡一下(25ms → 0.06ms)、课表渲染时的测量风暴(每帧 377 次 rect 读取降到 20 次)、以及多余的高斯模糊层(104 个降到 29 个)。
- 排版统一:全站字号与行高收成一套 token,长英文校名/邮箱不再被从单词中间劈开。
- 顶栏「导出」和「更多」原来点开的是同一个面板,现在「导出」直接出图。
升级说明
- 版本号 v0.2.0 → v0.2.1,versionCode 8 → 10(v0.2.0 是 9)。
- 包名与签名都没变,可直接覆盖安装,课程数据不丢。
- 装完之后打开一次应用,小组件才会拿到最新数据;之后每次改课表都会自动同步。
- 小组件的明暗跟随系统深浅色,与 App 里的主题设置无关。
v0.2.0
桌面小组件正式加入,顺带把前几轮攒下的改动一起带上。
新增:桌面小组件
两种规格,都可以随意拉宽拉高:
- 今天与明天 —— 今天、明天各上什么课,几点、在哪、谁教
- 本周课表 —— 整周课表,上下滚动
卡片被拉得很扁的时候,不会把信息裁掉:每一行都固定写全课名、时间、地点、教师,看不完的部分上下滑一下就行(所以两种小组件的最小高度都降到了 110dp,压成一条也能用)。
小组件的深浅色跟随系统,不跟应用内的设置走 —— 桌面上别的卡片都是系统主题,跟着应用就会出现「白底黑块」的割裂感。
其他改动
除了小组件,这次一并改进的还有:
- 手动添加课程可以单独设时间 —— 表单里勾「自定义」就能给某一门课单独填起止时间,不勾就跟随节次表。课表格子、日程时间线、课程详情都按这个时间显示
- 导入流程改为手动确认:应用不会替你去点教务系统里任何按钮,也不会后台自动抓取,读完课表页需要你自己点「执行导入」
- 首次打开有完整的功能指引(六页),不再一进门就弹 Excel 导入
- 导入教程补充校园网说明:多数学校教务系统只在校园网内可访问;少数开放校外访问的学校会在列表里标注
- Excel 导入降级为备选,教务系统导入才是推荐路径
- 内置高校从 270 所扩到 1460 所(其中 260 余所有针对该校页面的专用适配,其余按教务系统类型走通用适配)
- 顶栏「导出」改为直接导出当前周图片,不再和「更多」重复
- 统一了字号与行高,修掉了几处文字换行顶出框、顶栏副标题在括号中间断行、课表右侧一条竖空白带的问题
升级说明
- 版本号 v0.1.7 → v0.2.0(versionCode 8 → 9),覆盖安装即可,数据保留
- 签名不变,可直接覆盖安装
- 已装 v0.1.7 的朋友装完打开一次,让小组件拿到数据;桌面添加小组件后如果显示「打开 App 同步一次」,照做即可
v0.1.7
清笺课程表 v0.1.7
2026-10-29 更新:本版追加了「意见反馈」,安装包已重新打包并覆盖本 Release 的附件。
版号仍是v0.1.7(versionCode 8),已安装过 v0.1.7 的朋友请手动下载覆盖安装。
本版改动
一、新增「意见反馈」
设置 → 关于 → 意见反馈,可以直接联系开发者:
- 展示开发者邮箱
nangongshuo33@gmail.com,旁边「复制」一键抄走 - 点「用邮件应用发送」会调起手机上的邮件应用,主题与正文已按当前版本填好,你只要补上具体描述
- 邮件正文末尾只自动附上版本号与来源(安卓版 / 网页版),不会附带课程表、个人资料或任何本机数据
- 另附「打开项目仓库」,可在 GitHub 上提 Issue 或 Pull Request
- 隐私政策的「联系我们」与联网说明同步更新
二、「上课提醒」改为「一键导入日历」
旧的上课提醒靠网页定时轮询,应用一退出就不响,效果有限。本版把入口挪到主页「更多」菜单,直接写进手机自带的日历,由系统负责到点提醒,应用完全退出也照响。
- 主页 →「更多」→ 「一键导入日历」
- 弹窗里选择是否提醒、提前多久(提前 5 / 10 / 15 / 30 分钟,或不提醒)
- 确认后把当前课表逐周展开,把每一节写进系统日历,每节都带上你选的提醒时间
- 改了课表再点一次即可重建:会先清掉上次导入的课,不会在日历里堆重复
- 也可以取消导入,一键清空日历里的课
- 设置页原有的「上课提醒」模块已移除,避免两套开关各管一半
三、修掉两处此前测试版反馈的问题
- 教务系统窗口里点取消后,原来会直接关闭整个面板,无处可回;现在回到学校列表
- 搜索框用中文输入法打完字,结果不刷新、要再删一个字才更新;现已即时刷新
安装说明
- 包名
com.reiro.qingjian,直接覆盖安装即可,无需卸载,课表数据不会丢 - 版本号
versionCode 8,系统设置里显示0.1.7 - 首次点「一键导入日历」时会申请日历读写权限,允许后才能写入
⚠️ 本次为同版号重打,应用内「检查更新」不会提示,请手动下载本页附件覆盖安装
其他
- 网页版不受影响,仍是「导出为日历(.ics)」后在手机日历里导入文件
桌面小组件功能尚未包含在本版中,仍在开发与验证,完成后再单独发布。
校验
- 文件:
QingJian-CourseTable-v0.1.7.apk(13,181,080 字节) - SHA-256:
85cc54d7d2b0731adbfcf45b06935d4c2c5901736a1b2f4120ee57d3b86d8c4c
v0.1.6
新增
- 日程页:添加日程。日程页右上角新增「+ 添加日程」,可填写名称、日期、起止时间、地点、备注与配色,并可设置提前 5 分钟到提前 1 天的提醒。手工日程与当天的课程混排在同一条时间线上,按时间先后排列,点一条即可修改或删除。
- 同步到手机系统日历(安卓版)。添加日程时可以打开「同步到系统日历」,保存后会把这条日程写进手机自带的日历应用,并按设置带提前提醒。
- 修改已同步的日程会先删除日历里的旧事件再写入新的,不会重复;
- 关掉开关会从系统日历中移除该日程,删除日程也会一并清理;
- 首次使用会向系统申请「读取日历 / 写入日历」权限;权限被拒或手机里没有可写入的日历时,只提示原因,日程仍会保留在应用内。
改进
- 网页版没有系统日历能力,同步开关会置灰,并提示改用「导出 .ics」。导出的 .ics 现在会连同手工日程一起导出(含提前提醒),跨零点时结束时间会自动顺延到第二天。
修复
- 修复日程页「添加日程」按钮只显示一个方块、不显示文字的问题。
说明
- 权限新增「读取日历」「写入日历」两项,只在你添加日程并打开「同步到系统日历」时才向系统申请,平时不会访问日历。原有权限仍为网络访问与「安装未知应用」(后者仅用于应用内检查更新时把安装包交给系统安装器)。
- 当前版本仅适配武汉铁院教务系统的课程表。
v0.1.5
新增
- 从教务系统直接导入:在应用内打开教务系统,用统一身份认证登录后,应用会自动读取课表,不必再先导出 Excel 再回到应用选文件。不保存账号密码,每次都需要手动登录。
- 登录后请进入「学期理论课表」,在课表页面上方点「打印」,课表即会开始下载,应用随后自动读取。
- 点这个功能时,应用会先弹出简短提醒说明这几步,确认后再打开教务系统。
改进
- 「导入教程」修正了保存课表的方式:课表页面没有单独的导出按钮,保存课表是点页面上方的「打印」,并不会真的去打印。
- 导入页面的入口说明同步写清了「点打印」这一步。
修复
- 周次解析支持「周次(节次)」合一的写法,例如
7-18(周)[01-02节]。此前这类课程会因为圆括号残留而丢失整段周次。
说明
- 权限仍然只有网络访问与「安装未知应用」(后者仅用于应用内检查更新时把下载好的安装包交给系统安装器),不涉及相机、相册、存储与定位。
- 当前版本仅适配武汉铁院教务系统的课程表。
v0.1.4
本次更新
这一版修的是「检查更新」本身——上一版里点了「下载并安装」长时间没有反应,最后只能自己去 GitHub 页面手动下载。
修复
- 点了「下载并安装」没反应:安装包改为优先从国内加速镜像下载,不再先试 GitHub 直连
- 下载过程看不到进度:现在会显示百分比、已下载体积和当前使用的线路,能分辨是在下载还是卡住了
- 镜像列表更新:把已经失效的加速站替换掉,改为当前可用的几个,并按顺序逐个尝试
- 检查更新更可靠:直连 GitHub API 失败时,改用能转发 API 的镜像再试一次
- 「打开下载页」改为「用浏览器下载」:直接给出镜像下载链接,由系统浏览器下载
- 修掉一个隐患:下载到 0 字节的文件会被当成下载成功
- 没能自动打开安装器时,会明确提示去系统设置里允许「安装未知应用」
版本号:APP_VERSION / versionCode 5 / versionName / package.json 全部为 0.1.4。
签名沿用首版密钥(证书 CN=Reiro.),已安装 v0.1.3 的设备可直接覆盖安装。
v0.1.3
本次更新
这一版把此前发现的一批缺陷集中修掉,主要是导入与课表渲染的健壮性。
导入
- 自动识别课表所在的工作表:导出文件前面带封面页或说明页时也能正常解析(原先只读第一个工作表)
- 课程块没有写「第 x-y 节」标记时,按它所在的大节定位(原先会全部挤到第 1 大节)
- 表格里的节次超出默认节次时间表时,自动归到最近的一节,不再整门课在课表里消失
课表与导出
- 修复节次时间拆分的两个问题:跨度装不下时可能算出非法时间、起止时间写反
- 导出的图片与课表页保持一致,越界节次的课程不再丢失
- 「日程」页不再出现 undefined;关闭「显示周末」时日期范围正确止到周五
其它
- 「检查更新」:安装包下载完成后,即使没能自动唤起安装器,也不会重复下载
- 移除头像立即生效,重新打开应用后不再复原
- 关闭「显示周末」时,复制课程不再落到看不见的周六、周日
- 上课提醒的去重记录按天清理,不再长期累积
- 版本说明里的链接正常显示
版本号:APP_VERSION / versionCode 4 / versionName / package.json 全部为 0.1.3。
签名沿用首版密钥(证书 CN=Reiro.),已安装 v0.1.2 的设备可直接覆盖安装。
v0.1.2
本次更新
- 导入课表界面新增「查看导入教程」:按步骤说明怎么把课表从教务系统导出来 —— 连接校园网 → 智慧校园 → 登录门户 → 学期理论课表 → 导出 Excel → 回应用导入;门户地址旁可以一键复制
- 教程里明确写明:课表以教务系统和铁院门户的查询结果为准,遇到调课、停课以教务系统与任课教师的通知为准
- 安卓返回键在教程页会先退回导入界面,再按一次才关闭,和设置二级页的行为一致
安装包(11,808,087 字节)
- 需要 Android 10(API 29)及以上
- 签名沿用
CN=Reiro.(证书 SHA-256a743d74e…),可直接覆盖安装 v0.1.1 / v0.1.0,数据不会丢 - 声明的权限只有网络(仅在你主动点「检查更新」时使用)与「安装未知应用」(仅用于把下载好的新版交给系统安装器)
- SHA-256:
232ea22d2f8d53643aa5337f5ec927608689fb2f4de532d0a3ea22603af43cca
已装 v0.1.1 的话,可以在「我的 → 设置 → 检查更新」里直接下载安装。
v0.1.1
本次更新
设置更好找
- 设置面板拆成 6 个二级模块:学期与节次 / 外观 / 上课提醒 / 数据 / 检查更新 / 关于
- 一级列表每行直接显示当前状态(第几周、当前主题、提醒时间、课程表数量、版本号)
新增「检查更新」
- 在应用内查询最新版本,可走国内镜像下载
- 下载完成后直接调起系统安装器安装,不需要跳转浏览器
- 已是最新时会明确提示;检查失败会给出手动下载入口
课程块显示更完整
- 课程名与上课地点优先完整显示,字号按方块高度自动缩放,不再截断
- 修掉了「有教室名却没有房号时,教室名整块不显示」的问题
其他
- 隐私政策与关于页同步更新:除主动点「检查更新」外,应用不发起任何网络请求
- 新增权限「安装未知应用」,仅用于把下载好的安装包交给系统安装器
安装
下载下面的 QingJian-CourseTable-v0.1.1.apk,传到手机上点击安装。
- 需要 Android 10(API 29)及以上
- 安装包只声明
INTERNET与「安装未知应用」两项权限,没有相机 / 相册 / 存储 / 定位 - 与 v0.1.0 使用同一签名证书,可直接覆盖安装,本地数据不受影响
校验
- SHA-256:
1ff44348eed8afe352e09d8d15af584e5e707d8ec040061ef45c4c2b447293cf - 大小:11,806,605 字节(约 11.3 MB)
清笺课程表 v0.1.0
清笺课程表 v0.1.0
导入教务系统导出的 Excel 课表,自动解析并渲染成课表。
本版本内容
导入与解析
- 支持 .xlsx / .xls,按文件头判断真实格式,不依赖扩展名
- 三路解析器自动识别课表版式(大节网格 / 通用网格 / 明细表)
课表与周次
- 多套课表并行管理,可覆盖导入、另存为新课表、合并导入
- 按「学期第 1 周周一」或「本周是第几周」自动换算周次
- 支持临时调整某周课程、课程备注、节次时间自定义
外观
- 默认青绿山水主题,内置 9 套预设,支持自定义主色 / 辅色
- 深色模式、自定义背景图、课程块配色
数据
- 数据仅保存在本机;安卓版额外在应用私有目录保存一份,清理后台不会丢失
- 支持导出课表图片、导出 / 导入 JSON 备份、导出 ICS 日历、模板下载
本次修订(课程块显示)
课程块高度固定(由节次跨度决定),内容却随课名、教室名长短变化。原实现会让超出块高的内容被浏览器压缩、末行在块底被横切一半,不同块显示的信息也不一致。现在改为:
- 渲染前实测真实行高,再按「放得下才加」的顺序分配行数(课程名 → 楼栋房号 → 教室名 → 教师)
- 任何字号下都不再出现半截字,同样高度的块显示同样的信息
JXLⅠ 503这类楼栋房号不再被折成两行- 长课名 / 长教室名统一以省略号收尾
安装
下载下方 QingJian-CourseTable-v0.1.0.apk 安装即可。
- 支持 Android 10(API 29)及以上
- 应用权限仅 INTERNET,不申请相机、相册、存储、定位权限
- 选头像 / 背景图通过系统相册选取
后续版本沿用同一签名证书,可直接覆盖安装,本地数据会保留(不要卸载后重装)。
附件名使用英文,是因为 GitHub 会过滤 Release 附件名中的中文等非 ASCII 字符。
校验
SHA-256 0b7d1623f5a14323ef5d8e4cc088d36892a92d351ccd1427133c79b940e8ea29
大小 11,797,671 字节
签名 v2,CN=Reiro.
已知限制
当前版本仅适配武汉铁院教务系统导出的课程表格式。
网页版可下载仓库中的 清笺课程表.html 直接双击打开,单文件、无需联网。