feat: Bark 增加开始运行与获得学分提醒
收尾通知去掉重复的积分台账与完成门数;学习统计在无 TTY 时照常累计,保证 Docker 里也能推送学分提醒。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
1 parent
18c5e5a3be
commit
6b508a0b1a
15 files changed
+188
-51
No files matched your search
+1
-1
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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));
|
||||
|
||||
@@ -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
@@ -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,
|
||||
|
||||
Reference in new issue
Block a user