#!/usr/bin/env node /** * 真机持续运行测试:跨章节 + 跨课程。 * * 真实 Chrome + 真实账号,让脚本自己跑列表刷课,观察它能否 * 1) 在一门多课时课程里自动从第 N 节切到第 N+1 节(跨章节) * 2) 一门课完成后回到列表、进下一门课(跨课程) * 3) 每次整页跳转(新 document)后重新注入并接续运行 * 4) 全程视频持续推进、无脚本 error、没学完的课程按退避重试而不是被跳过 * * 用法: * node dev/real-run.mjs --scan 只登录 + 列表,打印所有卡片(只读) * node dev/real-run.mjs --probe 8 读前 8 门课最短的「未学完」课的目录(不进播放,不动进度) * node dev/real-run.mjs --max 2 --budget 15 跑批量,最多完成 2 门 / 最多 15 分钟 * node dev/real-run.mjs --title 坚持 --max 2 先把匹配标题的课程跑完,再自动跑下一门 * node dev/real-run.mjs --headless --keep 无头 / 跑完不关浏览器 * node dev/real-run.mjs --out run.json 时间线写到指定文件(默认临时目录) * * 注意:这个测试会**真实推进学习进度**(这就是它的目的)。 * 只读的登录/列表测试请看 dev/real-e2e.mjs。 */ import fs from 'node:fs'; import path from 'node:path'; import os from 'node:os'; import { spawn } from 'node:child_process'; import { fileURLToPath } from 'node:url'; import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs'; const HERE = path.dirname(fileURLToPath(import.meta.url)); // 本文件在 dev/tests/ 下,仓库根目录是上两级 const ROOT = path.resolve(HERE, '..', '..'); const SCRIPT_SRC = fs.readFileSync(path.join(ROOT, 'yun-xue-tang-assistant.user.js'), 'utf8'); const argv = process.argv.slice(2); const flag = (n) => argv.includes(n); const opt = (n, d) => { const i = argv.indexOf(n); return i >= 0 && argv[i + 1] ? argv[i + 1] : d; }; const USR = process.env.YUN_XUE_TANG_USR || ''; const PWD = process.env.YUN_XUE_TANG_PWD || ''; const SCAN = flag('--scan'); const PROBE = flag('--probe') ? Number(opt('--probe', 8)) : 0; const HEADLESS = flag('--headless') || process.env.YUN_XUE_TANG_HEADLESS === '1'; const KEEP = flag('--keep'); const MAX_COURSES = Number(opt('--max', 2)); const BUDGET_MIN = Number(opt('--budget', 15)); const PIN_TITLE = opt('--title', ''); const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9335); const ORIGIN = 'https://kfmic.yunxuetang.cn'; const OUT = opt('--out', path.join(os.tmpdir(), 'yun-xue-tang-run-' + Date.now() + '.json')); const CANDIDATES = [ process.env.YUN_XUE_TANG_CHROME, 'C:/Program Files/Google/Chrome/Application/chrome.exe', 'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe', 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe', '/usr/bin/google-chrome', '/usr/bin/chromium', ].filter(Boolean); const CHROME = findChrome(CANDIDATES); const results = []; const consoleLogs = []; const timeline = []; const log = (...a) => console.log(...a); const clock = () => new Date().toISOString().slice(11, 19); function check(name, ok, detail) { results.push({ name, ok: !!ok, detail }); log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail))); } if (!CHROME) { console.error('找不到 Chrome/Edge,可用 YUN_XUE_TANG_CHROME=... 指定'); process.exit(2); } if (!USR || !PWD) { console.error('缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD'); process.exit(2); } if (typeof WebSocket !== 'function' || typeof fetch !== 'function') { console.error('需要 Node 22+,当前 ' + process.version); process.exit(2); } log('[RUN] 账号:' + USR.slice(0, 3) + '***' + USR.slice(-2)); log('[RUN] 模式:' + (SCAN ? '只读扫描列表' : (PROBE ? '只读探测前 ' + PROBE + ' 门课的目录' : '批量持续运行(最多 ' + MAX_COURSES + ' 门 / ' + BUDGET_MIN + ' 分钟)')) + (PIN_TITLE ? ' 指定课程:' + PIN_TITLE : '')); // Linux 无图形化服务器:没有 DISPLAY 时强制无头,并补容器/root 必需参数 const HEADLESS_ONLY = HEADLESS || forceHeadless(); const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yun-xue-tang-run-')); const args = [ `--remote-debugging-port=${PORT}`, `--user-data-dir=${userDataDir}`, '--no-first-run', '--no-default-browser-check', '--disable-sync', // 后台标签页/最小化时不要把定时器和视频节流,否则「持续运行」测不准 '--disable-background-timer-throttling', '--disable-renderer-backgrounding', '--disable-backgrounding-occluded-windows', '--autoplay-policy=no-user-gesture-required', '--window-size=1360,940', ].concat(safetyArgs(), ['about:blank']); if (HEADLESS_ONLY) args.unshift('--headless=new'); let chrome = null; let cdp = null; log('[RUN] 浏览器:' + CHROME + (HEADLESS_ONLY ? '(headless)' : '(有界面)')); try { chrome = spawn(CHROME, args, { stdio: 'ignore', windowsHide: true }); let version = null; for (let i = 0; i < 100; i++) { try { const v = await httpJson(`http://127.0.0.1:${PORT}/json/version`); if (v && v.webSocketDebuggerUrl) { version = v; break; } } catch (e) {} await sleep(250); } if (!version) throw new Error('Chrome CDP 未就绪'); log('[RUN] ' + version.Browser); const target = await httpJson(`http://127.0.0.1:${PORT}/json/new?${encodeURIComponent(ORIGIN + '/login.html')}`, 'PUT'); cdp = await connect(target.webSocketDebuggerUrl); await cdp.send('Page.enable'); await cdp.send('Runtime.enable'); await cdp.send('Log.enable'); cdp.onEvent((m) => { if (m.method === 'Runtime.consoleAPICalled') { const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' '); consoleLogs.push({ t: Date.now(), type: m.params.type, text: String(text) }); } else if (m.method === 'Log.entryAdded') { consoleLogs.push({ t: Date.now(), type: m.params.entry.level, text: m.params.entry.text }); } }); const evalJS = async (expr) => { const r = await cdp.send('Runtime.evaluate', { expression: expr, returnByValue: true, awaitPromise: true, userGesture: true }); if (r.exceptionDetails) { const d = r.exceptionDetails; throw new Error((d.exception && d.exception.description) || d.text); } return r.result.value; }; const json = async (expr) => JSON.parse(await evalJS(expr)); const waitFor = async (exprFn, timeoutMs) => { const started = Date.now(); while (Date.now() - started < timeoutMs) { try { if (await evalJS(exprFn)) return true; } catch (e) {} await sleep(500); } return false; }; // ---------- 整页跳转后自动重新注入(等价 Tampermonkey 按 @match 重注入) ---------- let injections = 0; let reinjectTimer = null; const injectIfMissing = async () => { let t; try { t = await evalJS('typeof window.__yunXueTangAuto'); } catch (e) { return false; } if (t === 'object') return false; try { await evalJS(SCRIPT_SRC); injections++; return true; } catch (e) { return false; } }; // 每 1.5 秒兜底检查一次:任何原因导致脚本不在,就补注入(真实环境里由 @match 保证) const startWatchdog = () => { if (reinjectTimer) clearInterval(reinjectTimer); reinjectTimer = setInterval(() => { injectIfMissing().then((did) => { if (did) console.log('[RUN] ' + clock() + ' 新 document 已重新注入(第 ' + injections + ' 次)'); }).catch(() => {}); }, 1500); }; const loaded = cdp.waitEvent('Page.loadEventFired', 45000).catch(() => null); await cdp.send('Page.navigate', { url: ORIGIN + '/login.html' }); await loaded; await sleep(2000); // ---------- 登录 ---------- await evalJS(SCRIPT_SRC); injections++; await sleep(1200); const loginPage = await evalJS(`!!(window.__yunXueTangAuto && window.__yunXueTangAuto.isLoginPage())`); check('登录页脚本就绪', loginPage === true, await evalJS('location.pathname')); await evalJS(`(() => { const a = window.__yunXueTangAuto; a.fillLoginForm(${JSON.stringify(USR)}, ${JSON.stringify(PWD)}); try { a.checkLoginAgreement(); } catch (e) {} return true; })()`); await evalJS(`(document.getElementById('yun-xue-tang-oneclick').click(), true)`); const loginOk = await waitFor(`(() => { if (/\\/login/.test(location.pathname)) return false; if (!document.body) return false; return !document.querySelector('input[type=password]'); })()`, 45000); check('真实登录成功', loginOk === true, await evalJS('location.pathname')); // 进列表(新 document) const loaded2 = cdp.waitEvent('Page.loadEventFired', 30000).catch(() => null); await evalJS(`(location.href = '${ORIGIN}/kng/#/list', true)`); await loaded2; await sleep(2500); await injectIfMissing(); if (injections === 1) injections++; // 上面那次是列表页注入 await waitFor(`!!window.__yunXueTangAuto && window.__yunXueTangAuto.scanCards().length > 0`, 45000); await sleep(1500); // 优先短课程(缩短验证耗时;真机上这是默认勾选行为) await evalJS(`(() => { try { localStorage.setItem('yun-xue-tang-prefer-short', '1'); } catch (e) {} const a = window.__yunXueTangAuto; if (a) a.state.preferShortCourses = true; return true; })()`); // ---------- --probe:只读探测目录(关掉自动播放,避免动进度) ---------- if (PROBE) { // 当前课程自动连播开关关掉:进课后脚本不会自动起播、也不会自动切节 await evalJS(`(() => { localStorage.setItem('yun-xue-tang-auto-play-enabled', '0'); const a = window.__yunXueTangAuto; if (a) a.state.autoPlayEnabled = false; return true; })()`); const picks = await json(`JSON.stringify((() => { const a = window.__yunXueTangAuto; const ul = document.querySelector('ul.kng-list-new'); let v = ul && ul.__vue__; while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent; const data = (v && v.kngListData) || []; const byTitle = new Map(); for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d); return a.scanCards() .filter((c) => c.title && !/已学完|已完成|已学习/.test(c.status)) .map((c) => { const d = byTitle.get(c.title) || {}; return { i: c.i, title: c.title, studyHours: Number(d.studyHours) || 0, id: String(d.id || '') }; }) .filter((c) => c.studyHours > 0) .sort((x, y) => x.studyHours - y.studyHours) .slice(0, ${PROBE}); })())`); log('\n[RUN] 探测 ' + picks.length + ' 门课(按总时长正序):'); const report = []; for (const p of picks) { await evalJS(`(() => { try { localStorage.setItem('yun-xue-tang-auto-play-enabled', '0'); } catch (e) {} const a = window.__yunXueTangAuto; a.state.autoPlayEnabled = false; const card = a.scanCards().find((c) => c.i === ${p.i}); if (card) a.startCourse(card); return true; })()`).catch(() => {}); const ok = await waitFor(`(() => { const a = window.__yunXueTangAuto; return !!a && a.route() === 'course' && a.lessonItems().length > 0; })()`, 25000); let info = null; if (ok) { await sleep(1200); info = await json(`JSON.stringify((() => { const a = window.__yunXueTangAuto; const items = a.lessonItems(); return { lessons: items.length, completed: items.filter((li) => a.isLessonCompleted(li)).length, quiz: /考试|测验|问卷|答题/.test((document.querySelector('.yxtulcdsdk-catalog') || {}).innerText || ''), names: items.map((li) => ((li.innerText || '').replace(/\\s+/g, ' ').trim()).slice(0, 22)), summary: a.readSummary(), }; })())`); } const remaining = info ? info.lessons - info.completed : 0; log(' ' + (info ? (info.lessons + ' 节/剩 ' + remaining + (info.quiz ? ' [含考试]' : '')) : '进课失败').padEnd(18) + ' ' + String(Math.round(p.studyHours / 60)).padStart(4) + ' 分 ' + p.title.slice(0, 40)); report.push({ ...p, ...(info || {}), remaining }); // 回列表 await evalJS(`(location.href = '${ORIGIN}/kng/#/list', true)`).catch(() => {}); await sleep(2500); await injectIfMissing(); await waitFor(`!!window.__yunXueTangAuto && window.__yunXueTangAuto.scanCards().length > 0`, 40000); await sleep(1200); } const multi = report.filter((r) => r.remaining >= 2 && !r.quiz); log('\n[RUN] 适合测「跨章节」的候选(≥2 节未学完且不含考试):'); for (const m of multi) log(' ' + m.remaining + ' 节待学 ' + m.title.slice(0, 40) + ' → ' + m.names.join(' / ')); check('找到可跨章节验证的课程(≥2 节未学完)', multi.length > 0, multi.slice(0, 5).map((m) => ({ title: m.title.slice(0, 30), remaining: m.remaining }))); fs.writeFileSync(path.join(os.tmpdir(), 'yun-xue-tang-probe.json'), JSON.stringify(report, null, 2)); } else if (SCAN) { const cards = await json(`JSON.stringify((() => { const a = window.__yunXueTangAuto; const ul = document.querySelector('ul.kng-list-new'); let v = ul && ul.__vue__; while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent; const data = (v && v.kngListData) || []; const byTitle = new Map(); for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d); return a.scanCards().map((c) => { const d = byTitle.get(c.title) || {}; return { title: c.title, status: c.status, studyHours: d.studyHours, id: String(d.id || '') }; }); })())`); log('\n[RUN] 列表卡片(' + cards.length + ' 张):'); for (const c of cards) { log(' ' + (c.status || '-').padEnd(4) + ' ' + (c.studyHours ? String(Math.round(c.studyHours / 60)).padStart(5) + ' 分' : ' ? 分') + ' ' + c.title.slice(0, 46)); } check('列表可读', cards.length > 0, { 卡片数: cards.length }); } else { // ---------- 启动批量 ---------- await evalJS(`(() => { const a = window.__yunXueTangAuto; a.S.completedThisRun = 0; a.S.batchFinished = false; a.startBatch(); return true; })()`); await sleep(1500); // 指定课程:进入列表后抢先开始它(S.batchRunning 先关掉,避免 listTick 抢选别的课) if (PIN_TITLE) { const armed = await waitFor(`window.__yunXueTangAuto && window.__yunXueTangAuto.route() === 'list' && window.__yunXueTangAuto.scanCards().length > 0`, 60000); if (armed) { const pinned = await json(`JSON.stringify((() => { const a = window.__yunXueTangAuto; a.S.batchRunning = false; a.save(); const card = a.scanCards().find((c) => c.title.indexOf(${JSON.stringify(PIN_TITLE)}) >= 0); if (!card) { a.S.batchRunning = true; a.save(); return { ok: false }; } a.startCourse(card); a.S.batchRunning = true; a.save(); return { ok: true, title: card.title }; })())`); check('已指定首门课程并开始', pinned.ok === true, pinned); } else { check('已指定首门课程并开始', false, '列表未就绪'); } } // ---------- 持续监控 ---------- const startedAt = Date.now(); const deadline = startedAt + BUDGET_MIN * 60 * 1000; let lastSig = ''; let lastSample = null; let lastAdvanceAt = Date.now(); let lastCt = 0; let maxStallMs = 0; const perCourse = new Map(); // title -> lesson keys seen const transitions = []; // { t, from, to, course } let playEvidence = 0; // currentTime 增长次数 const sample = async () => { try { return await json(`JSON.stringify((() => { const a = window.__yunXueTangAuto; if (!a) return { gone: true, href: location.href }; const v = document.querySelector('video, audio'); const items = a.lessonItems(); return { href: location.href, route: a.route(), phase: a.S.coursePhase, running: a.S.batchRunning, runFinished: a.S.batchFinished, completed: a.S.completedThisRun, pendingRetries: Object.keys(a.S.courseRetries || {}).length, cur: a.S.activeCourse ? a.S.activeCourse.title : null, curId: a.S.activeCourse ? a.S.activeCourse.id : null, lesson: a.readActiveLessonKey ? a.readActiveLessonKey() : '', lessonCount: items.length, summary: a.readSummary(), countdown: a.readCountdown(), status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '', video: v ? { ct: Math.round(v.currentTime), dur: Math.round(v.duration), paused: v.paused, muted: v.muted, rate: v.playbackRate } : null, done: Object.keys(a.S.completedTitles || {}).length, retryTitles: Object.keys(a.S.courseRetries || {}).length, }; })())`); } catch (e) { return null; // 跳转中 DOM 不可用 } }; log('\n[RUN] 开始持续监控(Ctrl+C 或到点自动结束)…\n'); while (Date.now() < deadline) { const s = await sample(); if (s && !s.gone) { lastSample = s; // 视频推进证据 if (s.video && !s.video.paused && s.video.ct > lastCt) { playEvidence++; lastAdvanceAt = Date.now(); lastCt = s.video.ct; } else if (s.video && s.video.paused && s.video.ct !== lastCt) { lastCt = s.video.ct; } if (Date.now() - lastAdvanceAt > maxStallMs) maxStallMs = Date.now() - lastAdvanceAt; // 每门课出现过的课时 if (s.cur) { if (!perCourse.has(s.cur)) perCourse.set(s.cur, []); const keys = perCourse.get(s.cur); if (s.lesson && keys[keys.length - 1] !== s.lesson) keys.push(s.lesson); } const sig = [s.cur, s.lesson, s.completed, s.phase, s.runFinished].join('|'); if (sig !== lastSig) { const prev = lastSample && lastSig ? lastSig.split('|') : null; log('[RUN] ' + clock() + ' ' + (s.cur ? s.cur.slice(0, 26) : '(列表)') + ' ' + (s.phase || '-') + (s.runFinished ? ' [已停止]' : '') + ' 完成 ' + s.completed + ' 待重试 ' + s.pendingRetries + (s.lesson ? ' 课时:' + s.lesson.slice(0, 30) : '') + (s.summary ? ' 汇总:' + s.summary.text : '') + (s.countdown != null ? ' 倒计时 ' + s.countdown + 's' : '')); if (prev && prev[0] && s.cur && prev[0] === s.cur && prev[1] && s.lesson && prev[1] !== s.lesson) { transitions.push({ t: Date.now() - startedAt, course: s.cur, from: prev[1], to: s.lesson }); } timeline.push({ at: Date.now() - startedAt, ...s }); lastSig = sig; } if (s.completed >= MAX_COURSES) { log('\n[RUN] 已完成 ' + s.completed + ' 门,达到上限,收尾'); break; } if (s.runFinished) { log('\n[RUN] 脚本自己停止了:' + s.status); break; } if (s.runFinished && /重试 .* 次仍未完成/.test(s.status || '')) { log('[RUN] 重试用尽,脚本已停止,收尾'); break; } } await sleep(2000); } const elapsed = Math.round((Date.now() - startedAt) / 1000); const errors = consoleLogs.filter((l) => l.type === 'error' && /云学堂助手/.test(l.text)); const final = (await sample()) || lastSample || {}; check('持续运行未因脚本 exception 中断', errors.length === 0, errors.map((e) => e.text.slice(0, 140))); check('批处理仍在运行或已按上限结束', final.runFinished !== undefined, { running: final.running, runFinished: final.runFinished }); check('至少完成 2 门课程(跨课程)', (final.completed || 0) >= 2, { 完成: final.completed, 用时秒: elapsed }); check('观察到课时自动切换(跨章节)', transitions.length >= 1, { 切换次数: transitions.length, 明细: transitions.map((x) => x.from.slice(0, 14) + ' → ' + x.to.slice(0, 14)) }); check('视频持续推进(无长时间卡死)', playEvidence >= 3 && maxStallMs < 120000, { 推进采样: playEvidence, 最长停滞秒: Math.round(maxStallMs / 1000) }); check('整页跳转后自动恢复(重新注入)', injections >= 2, { 注入次数: injections }); check('没有课程被永久跳过(重试计数可控)', (final.retryTitles || 0) < 5, { 待重试标题: final.retryTitles }); log('\n[RUN] 每门课观察到的课时:'); for (const [title, keys] of perCourse) { log(' ' + title.slice(0, 34) + ' → ' + keys.length + ' 节:' + keys.map((k) => k.slice(0, 18)).join(' / ')); } log('[RUN] 完成后本地已记录 done:' + (final.done || 0) + ' 门;用时 ' + Math.round(elapsed / 60) + ' 分 ' + (elapsed % 60) + ' 秒'); // 收尾:停批量 + 暂停媒体 await evalJS(`(() => { const a = window.__yunXueTangAuto; if (a) { a.S.batchRunning = false; a.save(); if (a.pauseAllMedia) a.pauseAllMedia(); } return true; })()`).catch(() => {}); await sleep(1000); const disposed = await json(`JSON.stringify((() => { try { window.__yunXueTangDispose(); } catch (e) {} return { panel: !!document.getElementById('yun-xue-tang-panel'), api: typeof window.__yunXueTangAuto }; })())`).catch(() => ({ panel: null, api: 'n/a' })); check('dispose 后面板与 API 清理干净', disposed.panel === false && disposed.api === 'undefined', disposed); } log('\n[RUN] 脚本日志(' + consoleLogs.filter((l) => /云学堂助手/.test(l.text)).length + ' 条):'); for (const l of consoleLogs.filter((x) => /云学堂助手/.test(x.text)).slice(-40)) log(' [' + l.type + '] ' + l.text.slice(0, 170)); } catch (e) { check('持续运行流程执行完毕', false, e && e.stack ? e.stack.split('\n').slice(0, 5).join(' | ') : String(e)); } finally { if (cdp && !KEEP) cdp.close(); if (chrome && !KEEP) { try { chrome.kill(); } catch (e) {} } if (!KEEP) { await sleep(700); try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch (e) {} } else log('[RUN] --keep:浏览器保持打开 ' + userDataDir); try { fs.writeFileSync(OUT, JSON.stringify({ timeline, results, logs: consoleLogs.slice(-400) }, null, 2)); log('[RUN] 时间线已写入 ' + OUT); } catch (e) { /* ignore */ } } const failed = results.filter((r) => !r.ok); log('\n===== RUN 结果:' + (results.length - failed.length) + '/' + results.length + ' 通过,失败 ' + failed.length + ' ====='); for (const f of failed) log(' FAIL ' + f.name + ' → ' + JSON.stringify(f.detail)); process.exit(failed.length ? 1 : 0);