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

+1 -1
View File
@@ -39,7 +39,7 @@ const DEFAULTS = {
logMaxBytes: 5 * 1024 * 1024,
tui: true, // true = 交互式终端里启用面板;非 TTY 自动退化为逐行日志
color: true, // false = 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
// Bark 推送:运行器自己收尾时发一条手机通知(正常刷完 / 卡死 / 登录失败)。
// Bark 推送:运行器在开始运行、每门课获得学分、收尾时各发一条手机通知。
// barkUrl 是含设备 key 的地址(https://api.day.app/<key>),留空 = 不推送。
// key 等价于「谁能往你手机推通知」,别提交到公开仓库;可用环境变量覆盖。
barkUrl: '',
+1 -1
View File
@@ -17,7 +17,7 @@
* page.mjs 注入后要调用的页面 JS 表达式 + page 求值封装
* session.mjs 单次会话:起浏览器 → 注入 → 自动登录 → 刷课 → 监控 → 收尾
* selfcheck.mjs --check 的只读环境自检
* notify.mjs 任务结束时的 Bark 手机通知
* notify.mjs Bark 手机通知(开始运行 / 获得学分 / 收尾)
* supervisor.mjs 崩溃重启循环与退出码
* tui.mjs 交互式终端面板(框线 + 进度条,q 退出;非 TTY 自动关闭)
*
+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);
}
+27 -10
View File
@@ -10,6 +10,7 @@ import {
exprStartBatch, exprAutoLogin,
} from './page.mjs';
import { runSelfCheck } from './selfcheck.mjs';
import { notifyCreditEarned } from './notify.mjs';
/** 看护循环间隔:既不能太密(CDP 往返),也要能及时补注入 */
export const WATCHDOG_MS = 1500;
@@ -185,17 +186,16 @@ export async function runSession(o) {
// 不会出现「浏览器重启后自动接着刷」或「未登录就报运行中」。
const raw = await page.tryEval(`JSON.stringify((function () {
var a = window.__yunXueTangAuto;
return { route: a.route(), batchRunning: a.S.batchRunning, batchFinished: a.S.batchFinished, completed: a.S.completedThisRun };
return { route: a.route(), batchRunning: a.S.batchRunning, batchFinished: a.S.batchFinished,
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '' };
})())`);
if (!raw) return; // 路由跳转中,下一轮再试
const st = JSON.parse(raw);
if (st.batchFinished) {
if (cfg.RESTART_MINUTES > 0) {
finishReason = '脚本已停止(本次完成 ' + st.completed + ' 门),按 YUN_XUE_TANG_RESTART_MINUTES 稍后重新开始';
} else {
finishReason = '脚本已停止(本次完成 ' + st.completed + ' 门;无更多可学课程)';
}
// 完成门数由收尾日志和通知正文另行给出,这里只留页面给出的停止原因
finishReason = String(st.status || '').trim().slice(0, 120) ||
(cfg.RESTART_MINUTES > 0 ? '无更多可学课程,稍后重新开始' : '无更多可学课程');
finished = true;
return;
}
@@ -276,8 +276,8 @@ export async function runSession(o) {
continue;
}
lastStateAt = Date.now();
// 面板每一轮都刷(快照本身就是最新状态,不需要另算);未启用时是空操作
tui.snap(snap);
// 面板每一轮都刷(快照本身就是最新状态,不需要另算);面板未启用时也照常累计学时/学分
const study = tui.snap(snap);
if (!finishReason) {
if (snap.runFinished) tui.set({ phase: '脚本已停止', tone: 'ok' });
else if (snap.retryWait > 0) tui.set({ phase: '等待重试', tone: 'warn' });
@@ -285,6 +285,19 @@ export async function runSession(o) {
else if (snap.route === 'list') tui.set({ phase: '列表页排队中', tone: 'info' });
else tui.set({ phase: '运行中', tone: 'info' });
}
// 每刷完一门课推一条学分提醒;study.earned 已经按课程去重,重试不会重复推
if (study && study.earned && study.earned.length && !stop.stopping) {
for (const ev of study.earned) {
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
await notifyCreditEarned(cfg, {
course: ev.course,
credit: ev.credit,
total: study.creditEarned,
completed: snap.completed,
}, { log, warn });
}
}
// 编解码器缺失:视频元素有源但解码错误(MEDIA_ERR_DECODE / SRC_NOT_SUPPORTED)
if (!codecWarned && snap.video && snap.video.src && snap.video.err >= 3) {
@@ -322,10 +335,14 @@ export async function runSession(o) {
}
// 脚本停止 / 长时间无进展
if (snap.runFinished) { finishReason = '脚本已停止:' + (snap.status || '未知原因'); break; }
if (snap.runFinished) {
// 标题已经说明「结束了」,这里只要有具体原因就够了
finishReason = String(snap.status || '').trim() || '页面脚本已停止';
break;
}
if (Date.now() - lastProgressAt > stallLimit) {
finishReason = '超过 ' + Math.round(stallLimit / 60000) + ' 分钟没有任何进展(最后停在 ' +
(snap.course || '列表') + '),退出等待重启';
(snap.course || '列表') + ')';
break;
}
+13 -5
View File
@@ -35,9 +35,10 @@ export function createStudyTracker(opts = {}) {
* 传进来的快照字段可能缺失(页面刚跳转时就是半空的),所以全部按可选处理。
*/
function update(snap) {
if (!snap || snap.noApi) return get();
if (!snap || snap.noApi) return { ...get(), earned: [] };
const at = now();
const course = snap.course || '';
const earned = [];
// ---- 学习时长:只算视频真的在播的时间 ----
// 用「两次快照的真实间隔」而不是写死的轮询周期:CDP 往返偶尔会慢,
@@ -70,13 +71,15 @@ export function createStudyTracker(opts = {}) {
const justDone = lastCourse || course;
if (justDone && creditOf.has(justDone) && !credited.has(justDone)) {
credited.add(justDone);
creditEarned += creditOf.get(justDone);
const amount = creditOf.get(justDone);
creditEarned += amount;
earned.push({ course: justDone, credit: amount });
}
lastCompleted = completed;
}
if (course) lastCourse = course;
return get();
return { ...get(), earned };
}
/** 当前统计值(不会被外部改到内部状态) */
@@ -93,13 +96,18 @@ export function createStudyTracker(opts = {}) {
/** 学分文本:整数不带小数点,小数保留最多两位并去掉尾随 0 */
function creditText(value) {
const v = value === undefined ? creditEarned : value;
return String(Number(v.toFixed(2)));
return formatCredit(value === undefined ? creditEarned : value);
}
return { update, get, summary, creditText, reset() { studySeconds = 0; creditEarned = 0; credit = null; lastAt = 0; lastPlaying = false; lastCompleted = 0; lastCourse = ''; creditOf.clear(); credited.clear(); } };
}
/** 学分文本:整数不带小数点,小数保留最多两位并去掉尾随 0 */
export function formatCredit(value) {
const v = Number(value) || 0;
return String(Number(v.toFixed(2)));
}
/** 秒 → 1:23:45 / 23:45(与面板显示保持一致,面板自己那份在 tui.mjs) */
function fmt(sec) {
const s = Math.max(0, Math.round(Number(sec) || 0));
+6 -1
View File
@@ -8,7 +8,7 @@ import { runSession, disposeActiveSession } from './session.mjs';
import { openLog } from './log.mjs';
import { noDisplayReason, platformName } from './platform.mjs';
import { createTui } from './tui.mjs';
import { notifyRunFinished } from './notify.mjs';
import { notifyRunStarted, notifyRunFinished } from './notify.mjs';
const RETRY_BASE_MS = 15000;
const RETRY_MAX_MS = 120000;
@@ -55,6 +55,11 @@ export async function runSupervisor(o) {
}
if (!cfg.TUI && cfg.tuiDisabledReason) log('面板:' + cfg.tuiDisabledReason());
tui.set({ phase: '启动中' });
if (!cfg.CHECK_ONLY) {
// 整个进程只发一次「开始运行」;配了 restartMinutes 时每轮会话重开不再推
tui.set({ phase: '发送 Bark 通知', tone: 'info' });
await notifyRunStarted(cfg, { log, warn });
}
let attempt = 0;
let last = null;
+5 -1
View File
@@ -524,11 +524,14 @@ export function createTui(opts = {}) {
},
/**
* 用 session 的主监控快照刷新面板,顺便累计学习时长与学分(详细规则见 study.mjs)。
* 面板关闭时也照常统计:学分明细要拿来发 Bark 通知,不能只在 TTY 下有。
* @returns {object|null} study.update() 的结果,含本次新增的学分事件
*/
snap(s) {
if (!enabled || !s || s.noApi) return;
if (!s || s.noApi) return null;
const pick = (v, d) => (v === undefined ? d : v);
const st = study.update(s);
if (!enabled) return st;
state.studySeconds = st.studySeconds;
state.creditEarned = st.creditEarned;
state.credit = st.credit;
@@ -544,6 +547,7 @@ export function createTui(opts = {}) {
state.retryWait = pick(s.retryWait, 0);
state.lessons = pick(s.lessons, 0);
state.video = s.video || null;
return st;
},
render,
redraw,