推开五楼那间教室的门,里面黑漆漆的,一个人都没有。
我背着书包在门口愣了好几秒,才猛然反应过来:今天是双周,这门课根本不在这栋楼。(站在空荡荡的走廊里被穿堂风一吹,整个人倒是彻底醒了。)
那学期每天早上七点半闹钟一响,我都要眯着眼从枕头底下摸出手机,解锁,划开相册,在一堆表情包和乱七八糟的截图里翻出开学初存的那张教务系统课表,再把图片放大到糊成一片像素格,费劲去辨认今天是单周还是双周、第一节课在哪栋楼哪一层。那天就是睡眼惺忪看错了周次,背着书包白爬了五层楼。
回到宿舍,我下定决心用 GitHub Actions 给自己搭一套课表提醒,每天清晨准时推到微信上。
动手之前,我以为这不过是个几十行脚本就能打发的小玩具。可真把它放进日常生活的齿轮里转上几周才发觉,要让一条通知每天清晨安安分分地出现,调通外部发送接口只是最微不足道的开头;难的是把课程、日期、单双周推算以及推送渠道各自的分工梳理得清清楚楚。一个提醒工具一旦融入日常习惯,某天偶尔罢工一次反倒还好,最怕的是它在网络抖动时连发三四遍把人震醒、算错调休把人骗去空教室,或者明明本地早改了配置,云端却还固执地推着上周的旧课表。
先把课表变成纯粹的数据
为了不让后面的业务逻辑被杂乱的展示格式牵着鼻子走,我做的头一件事,是把课表从花里胡哨的文本里剥离出来,收敛成一个小而克制的数据结构:星期几、开始时间、结束时间、单双周标记、教室门牌号以及课程名称,不多不少刚好够用。
不管是存成静态的 JSON 文件还是塞进轻量数据库,底层记录里只管老老实实保存这些干巴巴的客观事实。至于推到手机屏幕上那句带表情符号的早安问候,或是排版紧凑的提醒卡片,统统留到最外层的发送阶段现场拼装。事实和寒暄拆开之后,哪天心血来潮想换一套说话的语气,犯不着去动底层的周次判断;学期中途某门课临时换了教室,也无需把整套定时任务推倒重来。
每次定时任务在清晨被唤醒、准备生成当天的课表时,程序都得先在底层把当前的时区和自然日期对齐,再去推算眼下正处在学期的第几周。大学里的周次推算从来不是一道简单的除法题:国庆长假的连休、教务处临时下发的调休补课,随时能把按时间戳硬算出来的“第几周”搅得一塌糊涂。正因如此,开学第一周的基准日期必须明明白白写进配置文件,同时还得在旁边留出一个随时可以手动指定周次或特殊日期的开关。碰上那些规则模糊、怎么算都拿不准的特殊调休日,我给程序定下的规矩是:宁可安静闭嘴不发,也绝不自作聪明地瞎猜。
让计算与推送各司其职
在代码结构上,我把通知渠道彻底请出了核心排课逻辑之外。负责排课计算的模块只回答一个问题:今天究竟有哪些课需要提醒?这份结构化的结果最后变成微信公众号的模板消息、企业微信的机器人卡片,还是飞书与邮件里的纯文本,完全由最外层的发送适配器去操心格式转换。
这么做的好处显而易见:哪天某个平台的接口规则变了,或者想换个更顺手的推送工具,底下那套课表数据结构和单双周推算逻辑连一个标点都不用动。
只要牵扯到调用外部平台的官方接口,密钥和凭证就得格外留神。所有的 AppSecret 与 Token 一律老老实实待在 GitHub Secrets 或运行环境变量里;控制台打印出来的运行日志只记下当次请求的唯一 ID 和返回状态码,绝不图调试省事把完整的令牌原样吐进公开日志流。
平时改代码时,跨周与跨月交界处的推算往往是最容易出漏子的重灾区。为了不拿自己的真实微信号当小白鼠、大半夜被测试消息震个不停,我在本地专门攒了一套固定的学期样本:单周、双周、开学第一周、跨月交界日以及临时调课,挨个写成测试用例,并且让预览输出与发送适配器彻底解耦。测试环境只管对接本地预览和这批静态样本,哪怕在深夜把卡片排版折腾上一百遍,手机也不会多发出一声多余的震动。
重试不能制造重复提醒
把定时任务挂到云端之后,我还遇上过一回尴尬的连环推送。在免费的容器环境里,网络请求偶尔抖一下、超个时,站在原地的脚本根本无从得知刚才那包数据究竟是死在了半路,还是其实已经送达微信服务器、仅仅是回执丢了。如果一见超时就闷头发起重试,大清早手机屏幕上十有八九会接连蹦出好几条一模一样的早八提醒。
为了按住这种烦人的重复,我拿“用户、日期、课程、渠道”这四个维度拼成了一把唯一的幂等键。每次动手发送前先去查查本地记录,确认今天这门课还没发过才放行,拿到成功回执后立刻记账;倘若对应平台还返回了消息 ID,就顺手把它和本地记录绑在一起,留作日后对账的凭据。
跑在云端后台的定时任务,最怕做成一个只报喜不报忧的黑盒。每次脚本跑完,日志里都要清清楚楚留下一串脚印:今天一共算出了几门课、因为单双周不符跳过了哪几门、最终发送结果如何、耗时多少毫秒。在状态记录上,我也把各种结局拆成了互不混淆的标记——今天没课空手而归、配置文件格式写错、第三方渠道拒绝接收、网络请求超时,翻开日志一眼便知。
遇到单双周切换或节假日调休这种容易踩坑的节点,我还在脚本里顺手留了一个只读的预览命令。改完配置,先在终端里敲一行命令看看它明天早上打算发什么,心里有了底再推上仓库,交给云端的定时任务。
温情不靠随机句子
刚写这个小工具的那阵子,我曾颇为起劲地在代码里塞过不少花里胡哨的彩蛋,比如在傍晚顺带发一句嘘寒问暖的随机诗词或鸡汤语录,总觉得这样能让冷冰冰的脚本多点人情味。可真正用了小半年才慢慢体会到,日常工具里最让人感到踏实的温情,靠的从来不是这些刻意讨巧的随机句子,而是那份从不添乱的克制与确定性。
每天在固定的时间点安静抵达、页面上留着显眼且随时可用的暂停开关、配置文件普通同学一眼就能看懂——这些朴实的细节远比每天换着花样抖机灵更能让人安心。一个提醒工具在生活里最本分的价值,原本就是替脑子少记一桩琐事;它要是天天用泛滥的寒暄来加戏,反倒又占去了一份注意力。
回头翻看这个陪伴了我好几个学期的开源小仓库,它留给我的经验其实朴素得不能再朴素:把时间推算、内容拼装、渠道投递与状态记录一层层剥离开来;把敏感凭证与公开日志严格隔开;把每一次失败重试都关进幂等的笼子里;在真正对外发声之前,先留一只只读预览的眼睛。哪一样单拎出来都算不上高深,可唯有耐下心来把每一处衔接都认认真真写进代码,一个自动化脚本才能在漫长的学期里不添乱、不掉链子。
后来再没走错过教室。闹钟响过不久,微信里就会跳出一条:今天单周,第一节,三楼。