feat: Bark 增加开始运行与获得学分提醒

收尾通知去掉重复的积分台账与完成门数;学习统计在无 TTY 时照常累计,保证 Docker 里也能推送学分提醒。

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
voidandClaude Sonnet 4.6 committed 2026-11-02 22:30:11 +08:00
1 parent 18c5e5a3be
commit 6b508a0b1a
15 files changed
+188 -51

No files matched your search

+46 -5
View File
@@ -1,11 +1,16 @@
// Bark 推送:运行器自己收尾时把结果发到手机。
//
// 只覆盖「运行器自己结束」的场景(正常刷完 / 长时间无进展 / 登录失败),
// 手动 Ctrl+C 主动停止不发:人就在键盘前,不需要再提醒一次。
// 覆盖三类事件(都只在 headless 运行器里发,浏览器端油猴脚本不推送):
// · 开始运行:「进程已经跑起来了」
// · 获得学分:每刷完一门有学分的课推一条
// · 收尾:正常刷完 / 长时间无进展 / 登录失败
// 手动 Ctrl+C 主动停止不推送:人就在键盘前,不需要再提醒一次。
// 通知是附加信息:发送失败只记告警,绝不影响退出码,也不阻塞下一次会话。
//
// Bark 接口:GET https://api.day.app/<key>/<title>/<body>?group=<分组>&ttl=<秒>
import { formatCredit } from './study.mjs';
/** 单次请求超时:Bark 正常在 1 秒内返回,卡住就当失败,别拖慢收尾 */
export const BARK_TIMEOUT_MS = 8000;
@@ -62,6 +67,28 @@ export function buildFinishMessage(result) {
return { title, body: lines.join('\n') };
}
/** 启动通知:预检通过、浏览器即将启动时发一条,手机上能确认「程序真的跑起来了」 */
export function buildStartMessage(cfg) {
const c = cfg || {};
const lines = ['正在启动浏览器并自动登录'];
lines.push('模式:' + (c.POINTS_MODE ? '每日积分' : '普通刷课'));
const budget = Number(c.BUDGET_MINUTES) || 0;
lines.push('运行预算:' + (budget > 0 ? budget + ' 分钟' : '不限'));
return { title: '云学堂助手:开始运行', body: lines.join('\n') };
}
/** 学分通知:每刷完一门课发一条,带上本次累计学分与已完成门数 */
export function buildCreditMessage(event) {
const e = event || {};
const title = '云学堂助手:获得 ' + formatCredit(e.credit) + ' 学分';
const lines = [];
if (e.course) lines.push('课程「' + String(e.course) + '」');
let total = '本次累计 ' + formatCredit(e.total) + ' 学分';
if (e.completed != null) total += ' · 已完成 ' + (Number(e.completed) || 0) + ' 门';
lines.push(total);
return { title, body: lines.join('\n') };
}
/**
* 发送 Bark 通知。永远不抛异常。
* @returns {Promise<{ok?:boolean, skipped?:boolean, status?:number}>}
@@ -98,10 +125,9 @@ export async function sendBark(opts) {
}
}
/** 按运行器配置发送收尾通知;没配 barkUrl 时是空操作 */
export function notifyRunFinished(cfg, result, io) {
/** 按运行器配置发一条通知;没配 barkUrl 时是空操作 */
function notifyWith(cfg, msg, io) {
if (!cfg || !cfg.BARK_URL) return Promise.resolve({ skipped: true });
const msg = buildFinishMessage(result);
return sendBark({
url: cfg.BARK_URL,
group: cfg.BARK_GROUP,
@@ -112,3 +138,18 @@ export function notifyRunFinished(cfg, result, io) {
warn: io && io.warn,
});
}
/** 开始运行通知 */
export function notifyRunStarted(cfg, io) {
return notifyWith(cfg, buildStartMessage(cfg), io);
}
/** 获得学分通知(每门刷完的课一条) */
export function notifyCreditEarned(cfg, event, io) {
return notifyWith(cfg, buildCreditMessage(event), io);
}
/** 收尾通知 */
export function notifyRunFinished(cfg, result, io) {
return notifyWith(cfg, buildFinishMessage(result), io);
}