根目录原来平铺了构建脚本、运行器配置、两个 .cmd 启动器和一份中文名的 实跑报告,四类东西混在一起,新人分不清哪个是源码、哪个是产物。这次按 职责分层重排: - 构建与检查脚本收进 scripts/:build.mjs、check.mjs - 一键启动器收进 scripts/:start-headless.cmd、start-dev.cmd - 运行器配置独立成 config/runner.config.mjs(日常调参不用重新 build) - 真机测试收进 dev/tests/:real-cdp / real-test / real-e2e / real-run - 运行报告改成 ASCII 名并移入 docs/reports/run-report-v203.md - v2.0.x 时期的 7 份原始抓取片段归档到 docs/archive/v2.0-snapshots/, docs/evidence/ 只留当前版本的有效证据 - 测试每次重新生成的 3 张截图(e2e-01-after-login、e2e-02-playing、 real-chrome-login)移出仓库并加入 .gitignore,改写到 .run-tmp/screenshots/; docs/screenshots/ 只保留手工挑选的 5 张展示图 路径修正:build.mjs 的 ROOT 上跳一级;dev/tests/ 四个脚本 ROOT 上跳两级、 对 runner/browser.mjs 的引用改 ../../;runner/config.mjs 默认配置文件路径改 config/runner.config.mjs;两个 .cmd 的 cd 改为仓库根、start-dev.cmd 指向 dev/serve.mjs;package.json 全部 npm scripts 同步;README、dev/README、证据 文件与源码注释里的路径一并更新。 顺带修掉测试里硬编码的 v2.7.0 断言:版本号改为从 package.json 读取。 验证:npm run build(104798 字节 / 102.3 KB)、npm run check(24/24)、 npm run test:real:headless(24/24 通过)。
81 lines
3.6 KiB
JavaScript
81 lines
3.6 KiB
JavaScript
// 进程层:日志开关、启动横幅、崩溃重启循环、退出码。
|
||
//
|
||
// 一次会话(session.mjs)只管一个浏览器进程;这里管「崩了就重来」以及「什么情况该放弃」。
|
||
// 重试等待递增:15s → 30s → 45s …,上限 120s,避免持续失败时疯狂刷 CDP 端口。
|
||
import { sleep } from './cdp.mjs';
|
||
import { cleanStaleSingleton } from './browser.mjs';
|
||
import { runSession, disposeActiveSession } from './session.mjs';
|
||
import { openLog } from './log.mjs';
|
||
import { noDisplayReason, platformName } from './platform.mjs';
|
||
|
||
const RETRY_BASE_MS = 15000;
|
||
const RETRY_MAX_MS = 120000;
|
||
|
||
/**
|
||
* @param {object} o
|
||
* @param {object} o.cfg
|
||
* @param {string} o.binary
|
||
* @param {string} o.scriptSrc
|
||
* @param {object} o.stop
|
||
* @param {Function} o.log / o.warn / o.error
|
||
*/
|
||
export async function runSupervisor(o) {
|
||
const { cfg, stop } = o;
|
||
const log = o.log, warn = o.warn, error = o.error;
|
||
|
||
// 自检不写文件日志:避免每次 --check 都改仓库内容
|
||
if (!cfg.CHECK_ONLY) openLog(cfg.LOG_FILE, cfg.LOG_MAX_BYTES);
|
||
|
||
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
|
||
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
|
||
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 config/runner.config.mjs,使用内置默认值)'));
|
||
log('浏览器 ' + o.binary);
|
||
log('profile ' + cfg.PROFILE_DIR + '(cookie / localStorage 持久化,删掉即重置登录态与进度缓存)');
|
||
if (cfg.WANT_VISIBLE && !cfg.VISIBLE) {
|
||
warn(noDisplayReason() + ',配置里的 headless: false 被忽略,强制无头运行。');
|
||
}
|
||
if (!cfg.CHECK_ONLY) {
|
||
log('日志 ' + cfg.LOG_FILE + '(' + (process.platform === 'win32' ? 'Ctrl+C 结束' : 'Ctrl+C 结束') + ')');
|
||
}
|
||
|
||
let attempt = 0;
|
||
let last = null;
|
||
|
||
while (!stop.stopping) {
|
||
attempt++;
|
||
if (attempt > 1) log('--- 第 ' + attempt + ' 次尝试 ---');
|
||
try {
|
||
last = await runSession({ ...o, cfg });
|
||
if (stop.stopping) break;
|
||
if (cfg.CHECK_ONLY) break;
|
||
// 正常结束:只有「脚本自己停了 / 无进展」且配了重启间隔才再来一轮
|
||
const restartable = !last.limitReached && cfg.RESTART_MINUTES > 0;
|
||
if (!restartable) break;
|
||
log('按 YUN_XUE_TANG_RESTART_MINUTES=' + cfg.RESTART_MINUTES + ' 等待后重新开始…');
|
||
const until = Date.now() + cfg.RESTART_MINUTES * 60000;
|
||
while (!stop.stopping && Date.now() < until) await sleep(2000);
|
||
if (stop.stopping) break;
|
||
cleanStaleSingleton(cfg.PROFILE_DIR);
|
||
} catch (e) {
|
||
if (stop.stopping) break;
|
||
// 会话抛错时内部的收尾代码已被跳过,这里补上:否则浏览器进程会残留、端口被占
|
||
await disposeActiveSession();
|
||
error('会话异常:' + (e && e.message ? e.message : e));
|
||
// 连登 5 次失败基本都是密码错 / 要验证码,重试没意义,直接用专门的退出码结束
|
||
if (e && e.message && /连续 \d+ 次登录失败/.test(e.message)) {
|
||
return { exitCode: 3, last };
|
||
}
|
||
const waitMs = Math.min(RETRY_BASE_MS * attempt, RETRY_MAX_MS);
|
||
warn('浏览器/连接异常,' + Math.round(waitMs / 1000) + ' 秒后重试(第 ' + attempt + ' 次)');
|
||
await sleep(waitMs);
|
||
}
|
||
}
|
||
|
||
log('=== 运行器退出 ===');
|
||
|
||
if (cfg.CHECK_ONLY) return { exitCode: last && last.ok ? 0 : 1, last };
|
||
// 0 = 正常收尾(达到上限 / 预算 / 无更多课程);1 = 无进展卡死
|
||
if (last && /没有任何进展/.test(last.finishReason || '')) return { exitCode: 1, last };
|
||
return { exitCode: 0, last };
|
||
}
|