maxCourses 按整门课计数,而积分按课时计;只剩考试的课会白占名额, 曾出现 5 门用光但今日视频积分只拿到 1/3 就停止的情况。现在只由 今日积分完成、没有可学内容或 budgetMinutes 决定收尾。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
355 lines
15 KiB
JavaScript
355 lines
15 KiB
JavaScript
// 单次会话:一个浏览器进程的生命周期。
|
||
//
|
||
// 顺序:起浏览器 → 建标签页 → 连 CDP → 转发页面日志 → 每 1.5 秒看护
|
||
// (补注入 / 自动重登 / 启动批量)→ 主监控(进度、卡死、退出条件)→ 收尾。
|
||
// 崩溃或断线时直接抛错,由 supervisor.mjs 负责重建浏览器。
|
||
import { connect, httpJson, sleep } from './cdp.mjs';
|
||
import { launchBrowser } from './browser.mjs';
|
||
import {
|
||
createPage, EXPR_WATCH, EXPR_SNAPSHOT, EXPR_FINAL_STATS, EXPR_PAUSE_AND_SAVE,
|
||
exprStartBatch, exprAutoLogin,
|
||
} from './page.mjs';
|
||
import { runSelfCheck } from './selfcheck.mjs';
|
||
|
||
/** 看护循环间隔:既不能太密(CDP 往返),也要能及时补注入 */
|
||
export const WATCHDOG_MS = 1500;
|
||
/** 主监控轮询间隔:与面板的 1 秒刷新对齐,画面才不会一帧新一帧旧 */
|
||
export const MONITOR_MS = 1000;
|
||
/** 状态读不到多久后判定浏览器不可用 */
|
||
const STATE_TIMEOUT_MS = 90000;
|
||
/** 连续多少次登录失败判定为凭据/验证码问题(退出码 3) */
|
||
const MAX_LOGIN_ATTEMPTS = 5;
|
||
|
||
// 当前会话的清理句柄。runSession 抛错时(CDP 断线、登录失败…)内部收尾代码不会执行,
|
||
// 由 supervisor 在 catch 里调用 disposeActiveSession() 保证浏览器被收干净、端口能立刻复用。
|
||
let activeCleanup = null;
|
||
|
||
/** 收掉当前会话(幂等,可在任何时刻调用) */
|
||
export async function disposeActiveSession() {
|
||
const fn = activeCleanup;
|
||
activeCleanup = null;
|
||
if (fn) await fn();
|
||
}
|
||
/** 两次自动登录之间的最小间隔,避免把账号刷到风控 */
|
||
const LOGIN_COOLDOWN_MS = 20000;
|
||
|
||
/**
|
||
* @param {object} o
|
||
* @param {object} o.cfg config.mjs 的常量集合(见 headless.mjs 传入的 cfg 对象)
|
||
* @param {string} o.binary 浏览器可执行文件
|
||
* @param {string} o.scriptSrc 构建产物源码(注入用)
|
||
* @param {object} o.stop stop.mjs 的 stop 句柄
|
||
* @param {object} [o.tui] tui.mjs 的面板(不传 / 未启用时所有调用都是空操作)
|
||
* @param {Function} o.log / o.warn / o.error 日志函数
|
||
*/
|
||
export async function runSession(o) {
|
||
const { cfg, binary, scriptSrc, stop } = o;
|
||
const log = o.log, warn = o.warn, error = o.error;
|
||
// 面板是可选件:未启用时 set/snap 都是空操作,这里不需要分支判断
|
||
const tui = o.tui || { set: () => {}, snap: () => {}, finish: () => {}, enabled: false };
|
||
|
||
let browser = null;
|
||
let cdp = null;
|
||
let watchdog = null;
|
||
let disconnected = false;
|
||
let injected = 0;
|
||
let loginAttempts = 0;
|
||
let loginLastAt = 0;
|
||
let finished = false;
|
||
let finishReason = '';
|
||
let lastSig = '';
|
||
let lastStateAt = Date.now();
|
||
let codecWarned = false;
|
||
// 看护循环里抛出的致命错误(如连续登录失败)不能就地丢掉:定时器的 catch
|
||
// 拿不到主循环的控制流,必须把错误寄存下来,由主循环抛出。
|
||
let fatalError = null;
|
||
const consoleErrors = [];
|
||
|
||
const page = {
|
||
evalJS: null, json: null, tryEval: null,
|
||
};
|
||
|
||
const disposeSession = async () => {
|
||
if (watchdog) { clearInterval(watchdog); watchdog = null; }
|
||
if (page.evalJS && cdp && !cdp.closed) {
|
||
try { await page.evalJS(EXPR_PAUSE_AND_SAVE); } catch (e) { /* ignore */ }
|
||
}
|
||
if (cdp) { cdp.close(); cdp = null; }
|
||
if (browser) { await browser.kill(); browser = null; }
|
||
};
|
||
const unregister = stop.add(disposeSession);
|
||
activeCleanup = async () => { await disposeSession(); unregister(); };
|
||
|
||
// ---- 起浏览器 + 建标签页 + 连 CDP ----
|
||
// 注意:attempt 由 supervisor 管,这里不要传(传 undefined 会把它抹掉)
|
||
tui.set({ phase: '启动浏览器', tone: 'info' });
|
||
browser = await launchBrowser({
|
||
binary,
|
||
profileDir: cfg.PROFILE_DIR,
|
||
port: cfg.PORT,
|
||
headless: !cfg.VISIBLE,
|
||
extraArgs: cfg.EXTRA_ARGS,
|
||
log,
|
||
});
|
||
log('浏览器就绪:' + browser.version.Browser + ' profile=' + cfg.PROFILE_DIR);
|
||
tui.set({ phase: '打开页面', tone: 'info' });
|
||
|
||
const target = await httpJson('http://127.0.0.1:' + cfg.PORT + '/json/new?' + encodeURIComponent(cfg.START_URL), 'PUT');
|
||
const wsUrl = target && target.webSocketDebuggerUrl;
|
||
if (!wsUrl) throw new Error('无法创建标签页(/json/new 未返回 webSocketDebuggerUrl)');
|
||
cdp = await connect(wsUrl, { onClose: () => { disconnected = true; } });
|
||
await cdp.send('Page.enable');
|
||
await cdp.send('Runtime.enable');
|
||
await cdp.send('Log.enable');
|
||
|
||
const p = createPage(cdp);
|
||
page.evalJS = p.evalJS;
|
||
page.json = p.json;
|
||
page.tryEval = p.tryEval;
|
||
|
||
// 页面 console / Log 转发:只关心脚本自己打的日志,其它 UA 噪声不看
|
||
cdp.onEvent((m) => {
|
||
if (m.method === 'Runtime.consoleAPICalled') {
|
||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||
if (!/云学堂助手/.test(String(text))) return;
|
||
if (m.params.type === 'error') {
|
||
consoleErrors.push(String(text));
|
||
error('页面脚本报错:' + String(text).slice(0, 300));
|
||
} else {
|
||
log('页面:' + String(text).slice(0, 300));
|
||
}
|
||
} else if (m.method === 'Log.entryAdded') {
|
||
const t = m.params.entry;
|
||
if (t.level === 'error' && /云学堂助手/.test(t.text)) {
|
||
consoleErrors.push(t.text);
|
||
error('页面报错:' + t.text.slice(0, 300));
|
||
}
|
||
}
|
||
});
|
||
|
||
// ---------------- 看护循环 ----------------
|
||
// 每 WATCHDOG_MS 跑一次:新 document 补注入;掉登录自动重登;启动/接续批量。
|
||
const tickWatchdog = async () => {
|
||
if (disconnected || stop.stopping) return;
|
||
const s = await page.tryEval(EXPR_WATCH).then((v) => (v ? JSON.parse(v) : null));
|
||
if (!s || !s.href) return;
|
||
|
||
// 新 document / 首次加载:注入脚本(等价 Tampermonkey 按 @match 重注入)
|
||
if (!s.ready) {
|
||
if (/^(about:|chrome-error:|data:)/.test(String(s.href))) return; // 还没导航到真页面
|
||
if (!s.bodyLen && !s.hasPwd) return; // 页面还在渲染
|
||
try {
|
||
await page.evalJS(scriptSrc);
|
||
const t = await page.evalJS('typeof window.__yunXueTangAuto');
|
||
if (t === 'object') {
|
||
injected++;
|
||
tui.set({ injected, phase: '已注入脚本' });
|
||
log('已注入脚本(第 ' + injected + ' 次):' + String(s.href).slice(0, 90));
|
||
} else {
|
||
warn('注入后未生成 window.__yunXueTangAuto(typeof=' + t + ')');
|
||
}
|
||
} catch (e) {
|
||
warn('注入失败:' + (e && e.message ? e.message : e));
|
||
}
|
||
return;
|
||
}
|
||
|
||
// 掉登录:用环境变量里的账号自动重登(限速 + 次数上限)
|
||
if (s.onLogin) {
|
||
if (loginAttempts >= MAX_LOGIN_ATTEMPTS) {
|
||
throw new Error('连续 ' + MAX_LOGIN_ATTEMPTS + ' 次登录失败:请检查 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,'
|
||
+ '或站点要求人工验证码(无头环境无法完成)');
|
||
}
|
||
if (Date.now() - loginLastAt < LOGIN_COOLDOWN_MS) return;
|
||
loginLastAt = Date.now();
|
||
loginAttempts++;
|
||
tui.set({ phase: '自动登录(第 ' + loginAttempts + ' 次)', tone: 'warn' });
|
||
log('登录页:自动登录(第 ' + loginAttempts + ' 次尝试)');
|
||
try {
|
||
const r = await page.evalJS(exprAutoLogin(cfg.USR, cfg.PWD));
|
||
if (r === 'no-fields') warn('登录页没找到账号/密码输入框:可能站点改版或页面尚未渲染完');
|
||
} catch (e) {
|
||
warn('自动登录调用失败:' + (e && e.message ? e.message : e));
|
||
}
|
||
return;
|
||
}
|
||
|
||
if (loginAttempts) {
|
||
loginAttempts = 0;
|
||
tui.set({ phase: '已登录,准备刷课', tone: 'ok' });
|
||
log('已离开登录页,登录成功');
|
||
}
|
||
|
||
// 启动 / 接续批量。注意:脚本的运行状态存在 sessionStorage,
|
||
// 每个会话都是新标签页 → 必然从「未运行」开始,所以这里每次都会显式启动一次,
|
||
// 不会出现「浏览器重启后自动接着刷」或「未登录就报运行中」。
|
||
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 };
|
||
})())`);
|
||
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 + ' 门;无更多可学课程)';
|
||
}
|
||
finished = true;
|
||
return;
|
||
}
|
||
if (!st.batchRunning && st.route !== 'other') {
|
||
const ok = await page.tryEval(exprStartBatch(cfg.PREFER_SHORT, cfg.POINTS_MODE));
|
||
if (ok) {
|
||
tui.set({ phase: '刷课中', tone: 'ok' });
|
||
log('已启动列表刷课' + (cfg.PREFER_SHORT ? '(优先短课程)' : '') +
|
||
(cfg.POINTS_MODE ? '(每日积分模式)' : ''));
|
||
}
|
||
}
|
||
};
|
||
|
||
// ---------------- 自检模式 ----------------
|
||
if (cfg.CHECK_ONLY) {
|
||
tui.set({ phase: '环境自检中', tone: 'info' });
|
||
const result = await runSelfCheck({
|
||
page,
|
||
tickWatchdog,
|
||
isDisconnected: () => disconnected,
|
||
log,
|
||
});
|
||
await disposeSession();
|
||
unregister();
|
||
activeCleanup = null;
|
||
return result;
|
||
}
|
||
|
||
log('模式:无头 ' + (browser.headless ? 'headless' : '否') +
|
||
' 预算 ' + (cfg.BUDGET_MINUTES > 0 ? cfg.BUDGET_MINUTES + ' 分钟' : '不限') +
|
||
' 短课程优先 ' + (cfg.PREFER_SHORT ? '开' : '关') +
|
||
' 每日积分 ' + (cfg.POINTS_MODE ? '开' : '关') +
|
||
' 无进展 ' + cfg.IDLE_RESTART_MINUTES + ' 分钟');
|
||
|
||
watchdog = setInterval(() => {
|
||
tickWatchdog().catch((e) => {
|
||
if (stop.stopping || disconnected) return;
|
||
// 登录次数用尽这类错误是终局的,不能只警告后继续轮询
|
||
if (/连续 \d+ 次登录失败/.test(e && e.message ? e.message : '')) {
|
||
fatalError = e;
|
||
if (watchdog) { clearInterval(watchdog); watchdog = null; }
|
||
return;
|
||
}
|
||
warn('看护循环异常:' + (e && e.message ? e.message : e));
|
||
});
|
||
}, WATCHDOG_MS);
|
||
await tickWatchdog();
|
||
if (fatalError) throw fatalError;
|
||
|
||
// ---------------- 主监控 ----------------
|
||
const startedAt = Date.now();
|
||
const stallLimit = cfg.IDLE_RESTART_MINUTES > 0 ? cfg.IDLE_RESTART_MINUTES * 60 * 1000 : 30 * 60 * 1000;
|
||
const deadline = cfg.BUDGET_MINUTES > 0 ? startedAt + cfg.BUDGET_MINUTES * 60 * 1000 : Infinity;
|
||
let lastProgressAt = Date.now();
|
||
let lastProgressKey = '';
|
||
let doneReported = 0;
|
||
|
||
while (!stop.stopping) {
|
||
if (fatalError) throw fatalError;
|
||
if (disconnected) throw new Error('CDP 连接断开,重启浏览器');
|
||
if (Date.now() > deadline) { finishReason = '达到运行预算 ' + cfg.BUDGET_MINUTES + ' 分钟'; break; }
|
||
if (finished) break;
|
||
|
||
const raw = await page.tryEval(EXPR_SNAPSHOT);
|
||
if (!raw) {
|
||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||
}
|
||
await sleep(MONITOR_MS);
|
||
continue;
|
||
}
|
||
const snap = JSON.parse(raw);
|
||
if (snap.noApi) {
|
||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||
}
|
||
await sleep(MONITOR_MS);
|
||
continue;
|
||
}
|
||
lastStateAt = Date.now();
|
||
// 面板每一轮都刷(快照本身就是最新状态,不需要另算);未启用时是空操作
|
||
tui.snap(snap);
|
||
if (!finishReason) {
|
||
if (snap.runFinished) tui.set({ phase: '脚本已停止', tone: 'ok' });
|
||
else if (snap.retryWait > 0) tui.set({ phase: '等待重试', tone: 'warn' });
|
||
else if (snap.video && !snap.video.paused) tui.set({ phase: '刷课中', tone: 'ok' });
|
||
else if (snap.route === 'list') tui.set({ phase: '列表页排队中', tone: 'info' });
|
||
else tui.set({ phase: '运行中', tone: 'info' });
|
||
}
|
||
|
||
// 编解码器缺失:视频元素有源但解码错误(MEDIA_ERR_DECODE / SRC_NOT_SUPPORTED)
|
||
if (!codecWarned && snap.video && snap.video.src && snap.video.err >= 3) {
|
||
codecWarned = true;
|
||
warn('视频解码失败(error.code=' + snap.video.err + '):这个 Chromium 很可能不带 H.264/AAC 编解码器。');
|
||
warn('请改装官方 google-chrome-stable,或换用带专有编解码器的 Chromium 构建。');
|
||
}
|
||
|
||
// 有进展就重置停滞计时:课程/课时/进度/视频在播任一都算
|
||
const key = [snap.course, snap.lesson, snap.completed, snap.summary && snap.summary.text, snap.doneCount].join('|');
|
||
if (key !== lastProgressKey || (snap.video && !snap.video.paused)) {
|
||
lastProgressKey = key;
|
||
lastProgressAt = Date.now();
|
||
}
|
||
|
||
// 只在状态变化时打日志,避免刷屏
|
||
const sig = [snap.route, snap.course, snap.lesson, snap.completed, snap.phase, snap.runFinished].join('|');
|
||
if (sig !== lastSig) {
|
||
lastSig = sig;
|
||
const parts = [];
|
||
parts.push(snap.course ? ('课程「' + String(snap.course).slice(0, 28) + '」')
|
||
: (snap.route === 'list' ? '列表页' : snap.route));
|
||
if (snap.lesson) parts.push('课时 ' + String(snap.lesson).slice(0, 24));
|
||
if (snap.summary && snap.summary.text) parts.push(String(snap.summary.text).slice(0, 24));
|
||
if (snap.countdown != null) parts.push('倒计时 ' + snap.countdown + 's');
|
||
parts.push('本次完成 ' + snap.completed);
|
||
if (snap.retryWait) parts.push('等待重试 ' + snap.retryWait + 's');
|
||
else if (snap.retryCount) parts.push('待重试 ' + snap.retryCount);
|
||
log(parts.join(' '));
|
||
if (snap.status) log(' 状态:' + String(snap.status).slice(0, 120));
|
||
}
|
||
if (snap.completed > doneReported) {
|
||
doneReported = snap.completed;
|
||
log('✔ 已完成 ' + snap.completed + ' 门(累计记录 ' + snap.doneCount + ' 门)');
|
||
}
|
||
|
||
// 脚本停止 / 长时间无进展
|
||
if (snap.runFinished) { finishReason = '脚本已停止:' + (snap.status || '未知原因'); break; }
|
||
if (Date.now() - lastProgressAt > stallLimit) {
|
||
finishReason = '超过 ' + Math.round(stallLimit / 60000) + ' 分钟没有任何进展(最后停在 ' +
|
||
(snap.course || '列表') + '),退出等待重启';
|
||
break;
|
||
}
|
||
|
||
await sleep(MONITOR_MS);
|
||
}
|
||
|
||
// ---------------- 收尾 ----------------
|
||
const elapsed = Math.round((Date.now() - startedAt) / 1000);
|
||
const final = await page.tryEval(EXPR_FINAL_STATS).then((v) => (v ? JSON.parse(v) : {})).catch(() => ({}));
|
||
tui.set({ phase: '本次会话结束,收尾中', tone: 'ok', completed: final.completed || 0 });
|
||
log('本次会话结束:' + (finishReason || '收到退出信号') +
|
||
' 用时 ' + Math.floor(elapsed / 60) + ' 分 ' + (elapsed % 60) + ' 秒' +
|
||
' 本次完成 ' + (final.completed || 0) + ' 门,累计 ' + (final.doneCount || 0) + ' 门');
|
||
if (consoleErrors.length) {
|
||
warn('本次共 ' + consoleErrors.length + ' 条页面脚本报错,最后一条:' + consoleErrors.slice(-1)[0].slice(0, 200));
|
||
}
|
||
|
||
await disposeSession();
|
||
unregister();
|
||
activeCleanup = null;
|
||
|
||
return {
|
||
finishReason, completed: final.completed || 0, elapsed, injected, ok: true,
|
||
points: final.points || null,
|
||
};
|
||
}
|