feat: 考试结果页去重与跳课,构建镜像脚本支持国内换源
考试: - 新增 src/exam-plan.js(纯函数)判定结果页处置:只有本页确实点过 「提交考试/确定交卷」才算一次空卷交卷,平台恢复的旧结果页先回 「考试说明页」重进,不再在结果页和课程页之间空转 - 重试也不会好的确定性失败(交卷次数到上限、说明页无「开始考试」、 答卷页无「提交考试」、结果页反复回退)改为本轮跳过该课继续下一门, 记录在 S.skippedCourses(sessionStorage),不会停下整轮刷课 - 新一轮开跑时清空 skippedCourses / examEmptySubmits,人工处理后可重试 - 补 dev/tests/exam-test.mjs(npm run test:exam,5 条用例) 构建: - 新增 scripts/build-docker.mjs/.cmd/.sh(npm run docker:build): 国内换源、按包版本打标签、构建后自检、--dry-run - Dockerfile 增加 APT_MIRROR / NPM_REGISTRY 构建参数, docker-compose.yml 透传三个 build args,.env.example 补说明
This commit is contained in:
1 parent
b588b1042f
commit
17217dbeb1
18 files changed
+763
-53
No files matched your search
@@ -0,0 +1,33 @@
|
||||
@echo off
|
||||
rem ---------------------------------------------------------------
|
||||
rem This file must stay PURE ASCII and CRLF (see scripts\start-headless.cmd
|
||||
rem for the full explanation: cmd.exe parses batch files byte-by-byte with
|
||||
rem the current code page, so multi-byte chars / bare LF corrupt line offsets).
|
||||
rem All Chinese messages come from the Node script instead.
|
||||
rem
|
||||
rem Usage:
|
||||
rem scripts\build-docker.cmd build with default tags
|
||||
rem scripts\build-docker.cmd --mirror --check build with CN mirrors, then self-check
|
||||
rem scripts\build-docker.cmd --help list all options
|
||||
rem ---------------------------------------------------------------
|
||||
setlocal
|
||||
chcp 65001 >nul
|
||||
cd /d "%~dp0.."
|
||||
title YunXueTang Assistant - docker build
|
||||
|
||||
where node >nul 2>nul
|
||||
if errorlevel 1 goto no_node
|
||||
|
||||
node "scripts\build-docker.mjs" %*
|
||||
set RC=%ERRORLEVEL%
|
||||
if "%RC%"=="0" exit /b 0
|
||||
|
||||
echo.
|
||||
echo [exit] code %RC% (0 ok 1 build failed 2 env/args problem)
|
||||
pause
|
||||
exit /b %RC%
|
||||
|
||||
:no_node
|
||||
echo [error] node.exe not found. Install Node.js 22+ from https://nodejs.org/
|
||||
pause
|
||||
exit /b 2
|
||||
@@ -0,0 +1,342 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 构建 Docker 镜像的便捷入口。
|
||||
*
|
||||
* 为什么要有这层脚本,而不是让人手敲 `docker build`:
|
||||
* 1. Dockerfile 里有三个构建参数(APT_MIRROR / NPM_REGISTRY / CHROME_DEB_URL),
|
||||
* 国内机器几乎必须换源才能构建成功,但每次手写 `--build-arg` 又长又容易漏;
|
||||
* 这里统一从命令行、环境变量、.env 三处按优先级取值。
|
||||
* 2. 镜像标签跟着 package.json 的 version 走,顺手再打一个 latest;
|
||||
* 版本号只在 package.json 维护一处,不靠人记。
|
||||
* 3. 构建完能直接 `--check`(只读自检:不登录、不动进度),一步验证镜像真的能起来。
|
||||
*
|
||||
* 用法:
|
||||
* npm run docker:build # 默认标签 = 包里版本号 + latest
|
||||
* npm run docker:build -- --mirror # 一键换国内源(apt 清华 + npm npmmirror)
|
||||
* npm run docker:build -- --check # 构建完立刻跑一次 --check 自检
|
||||
* npm run docker:build -- --tag my/yxt:dev # 只打指定标签
|
||||
* npm run docker:build -- --dry-run # 只打印将要执行的 docker 命令
|
||||
* npm run docker:build -- --help
|
||||
*
|
||||
* 退出码与仓库其它脚本保持一致:0 成功 / 1 构建失败 / 2 环境或参数问题。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { spawnSync } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
||||
|
||||
/** 国内常用镜像源预设(--mirror 一键套用);Chrome 的 deb 没有公认镜像,只能由使用者用 --chrome-url 指定 */
|
||||
const MIRROR_PRESET = {
|
||||
apt: 'mirrors.tuna.tsinghua.edu.cn',
|
||||
npm: 'https://registry.npmmirror.com',
|
||||
};
|
||||
|
||||
const HELP = `构建云学堂助手 Docker 镜像
|
||||
|
||||
用法:node scripts/build-docker.mjs [选项]
|
||||
|
||||
选项:
|
||||
-t, --tag <名称:标签> 镜像标签;可重复给多次。默认 <包名>:<package.json 版本> 加 <包名>:latest
|
||||
--mirror 一键套用国内镜像源(apt = ${MIRROR_PRESET.apt},npm = ${MIRROR_PRESET.npm})
|
||||
--apt-mirror <host> Debian 源地址,对应 Dockerfile 的 APT_MIRROR
|
||||
--npm-registry <url> npm 源地址,对应 NPM_REGISTRY
|
||||
--chrome-url <url> Chrome deb 直链,对应 CHROME_DEB_URL(国内下不动 dl.google.com 时用)
|
||||
--platform <平台> 如 linux/amd64、linux/arm64(默认用构建机架构)
|
||||
--build-arg <K=V> 透传任意额外构建参数,可重复
|
||||
--no-cache 不用构建缓存
|
||||
--pull 先拉取最新的基础镜像
|
||||
--check 构建成功后跑一次 \`docker run --rm <镜像> --check\` 自检
|
||||
--dry-run 只打印 docker 命令,不真正构建
|
||||
-h, --help 显示本帮助
|
||||
|
||||
取值优先级:命令行 > 同名环境变量 > 仓库根目录 .env > 默认值
|
||||
(只从 .env 读 APT_MIRROR / NPM_REGISTRY / CHROME_DEB_URL 三个键,凭据类变量一律不读)
|
||||
|
||||
示例:
|
||||
node scripts/build-docker.mjs --mirror --check
|
||||
node scripts/build-docker.mjs -t yun-xue-tang-assistant:test --no-cache
|
||||
APT_MIRROR=mirrors.aliyun.com node scripts/build-docker.mjs
|
||||
`;
|
||||
|
||||
/** 解析成 { options, error } —— 手写解析而非引入依赖,仓库唯一的 devDependency 是 esbuild */
|
||||
function parseArgs(argv) {
|
||||
const opts = {
|
||||
tags: [],
|
||||
mirror: false,
|
||||
aptMirror: '',
|
||||
npmRegistry: '',
|
||||
chromeUrl: '',
|
||||
platform: '',
|
||||
buildArgs: [],
|
||||
noCache: false,
|
||||
pull: false,
|
||||
check: false,
|
||||
dryRun: false,
|
||||
help: false,
|
||||
};
|
||||
|
||||
const needValue = (i, name) => {
|
||||
const v = argv[i + 1];
|
||||
if (v === undefined || v.startsWith('-')) {
|
||||
throw new Error(`选项 ${name} 需要一个值`);
|
||||
}
|
||||
return v;
|
||||
};
|
||||
|
||||
for (let i = 0; i < argv.length; i++) {
|
||||
const arg = argv[i];
|
||||
// 支持 --key=value 与 --key value 两种写法
|
||||
const eq = arg.indexOf('=');
|
||||
const key = arg.startsWith('--') && eq > 0 ? arg.slice(0, eq) : arg;
|
||||
const inline = arg.startsWith('--') && eq > 0 ? arg.slice(eq + 1) : null;
|
||||
const take = (name) => (inline !== null ? inline : needValue(i, name));
|
||||
const takeAndSkip = (name) => {
|
||||
const v = take(name);
|
||||
if (inline === null) i++;
|
||||
return v;
|
||||
};
|
||||
|
||||
switch (key) {
|
||||
case '-t':
|
||||
case '--tag': {
|
||||
const v = takeAndSkip(key);
|
||||
if (!v.trim()) throw new Error('镜像标签不能为空');
|
||||
opts.tags.push(v.trim());
|
||||
break;
|
||||
}
|
||||
case '--mirror':
|
||||
opts.mirror = true;
|
||||
break;
|
||||
case '--apt-mirror':
|
||||
opts.aptMirror = takeAndSkip(key);
|
||||
break;
|
||||
case '--npm-registry':
|
||||
opts.npmRegistry = takeAndSkip(key);
|
||||
break;
|
||||
case '--chrome-url':
|
||||
opts.chromeUrl = takeAndSkip(key);
|
||||
break;
|
||||
case '--platform':
|
||||
opts.platform = takeAndSkip(key);
|
||||
break;
|
||||
case '--build-arg':
|
||||
opts.buildArgs.push(takeAndSkip(key));
|
||||
break;
|
||||
case '--no-cache':
|
||||
opts.noCache = true;
|
||||
break;
|
||||
case '--pull':
|
||||
opts.pull = true;
|
||||
break;
|
||||
case '--check':
|
||||
opts.check = true;
|
||||
break;
|
||||
case '--dry-run':
|
||||
opts.dryRun = true;
|
||||
break;
|
||||
case '-h':
|
||||
case '--help':
|
||||
opts.help = true;
|
||||
break;
|
||||
default:
|
||||
throw new Error(`未知选项:${arg}`);
|
||||
}
|
||||
}
|
||||
return opts;
|
||||
}
|
||||
|
||||
/** 极简 .env 解析:只认 KEY=VALUE / KEY="VALUE",忽略注释与空行 */
|
||||
function readDotEnv(file) {
|
||||
const out = {};
|
||||
if (!fs.existsSync(file)) return out;
|
||||
let text = '';
|
||||
try {
|
||||
text = fs.readFileSync(file, 'utf8');
|
||||
} catch {
|
||||
return out;
|
||||
}
|
||||
for (const raw of text.split(/\r?\n/)) {
|
||||
const line = raw.trim();
|
||||
if (!line || line.startsWith('#')) continue;
|
||||
const m = /^(?:export\s+)?([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/.exec(line);
|
||||
if (!m) continue;
|
||||
let v = m[2].trim();
|
||||
if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
|
||||
v = v.slice(1, -1);
|
||||
}
|
||||
out[m[1]] = v;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function readPackage(file) {
|
||||
try {
|
||||
return JSON.parse(fs.readFileSync(file, 'utf8'));
|
||||
} catch (e) {
|
||||
throw new Error(`读不出 ${path.relative(ROOT, file)}:${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
/** 把参数数组还原成可以直接粘进终端的命令行(仅用于日志展示) */
|
||||
function quote(argv) {
|
||||
return argv
|
||||
.map((a) => (/^[\w@%+=:,./-]+$/.test(a) ? a : `'${a.replace(/'/g, `'\\''`)}'`))
|
||||
.join(' ');
|
||||
}
|
||||
|
||||
function run(cmd, args, { capture = false } = {}) {
|
||||
return spawnSync(cmd, args, {
|
||||
cwd: ROOT,
|
||||
stdio: capture ? ['ignore', 'pipe', 'pipe'] : 'inherit',
|
||||
encoding: 'utf8',
|
||||
});
|
||||
}
|
||||
|
||||
function main() {
|
||||
let opts;
|
||||
try {
|
||||
opts = parseArgs(process.argv.slice(2));
|
||||
} catch (e) {
|
||||
console.error('[错误] ' + e.message);
|
||||
console.error('用 --help 查看用法。');
|
||||
return 2;
|
||||
}
|
||||
|
||||
if (opts.help) {
|
||||
process.stdout.write(HELP);
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (!fs.existsSync(path.join(ROOT, 'Dockerfile'))) {
|
||||
console.error('[错误] 找不到 Dockerfile,请在仓库根目录运行。');
|
||||
return 2;
|
||||
}
|
||||
|
||||
// ---- 1. 检查 docker 是否可用(CLI 缺失和守护进程没起来,处理方式完全不同,分开报) ----
|
||||
// --dry-run 只打印命令、不真的构建,所以这里只警告不拦截,方便在没有 docker 的机器上预览
|
||||
const cli = run('docker', ['--version'], { capture: true });
|
||||
const cliOk = !cli.error && cli.status === 0;
|
||||
if (!cliOk) {
|
||||
const msg = '找不到可用的 docker 命令,请先安装 Docker Desktop / Docker Engine。';
|
||||
if (!opts.dryRun) {
|
||||
console.error('[错误] ' + msg);
|
||||
if (cli.stderr) console.error(String(cli.stderr).trim());
|
||||
return 2;
|
||||
}
|
||||
console.log('[警告] ' + msg + '(dry-run 继续)');
|
||||
} else {
|
||||
console.log('[环境] ' + String(cli.stdout).trim());
|
||||
}
|
||||
|
||||
// 守护进程没启动时,docker build 会报一长串语焉不详的连接错误,这里提前拦下
|
||||
if (cliOk) {
|
||||
const daemon = run('docker', ['info', '--format', '{{.ServerVersion}}'], { capture: true });
|
||||
if (daemon.status !== 0) {
|
||||
const detail = String(daemon.stderr || '').trim();
|
||||
if (!opts.dryRun) {
|
||||
console.error('[错误] docker 守护进程未运行(Docker Desktop 没启动 / 当前用户没权限连 socket)。');
|
||||
if (detail) console.error(detail);
|
||||
return 2;
|
||||
}
|
||||
console.log('[警告] docker 守护进程未运行(dry-run 继续)');
|
||||
} else {
|
||||
console.log('[环境] 守护进程 ' + String(daemon.stdout).trim());
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 2. 收集构建参数:命令行 > 环境变量 > .env > 默认 ----
|
||||
const pkg = readPackage(path.join(ROOT, 'package.json'));
|
||||
const dotenv = readDotEnv(path.join(ROOT, '.env'));
|
||||
const pick = (cliValue, envKey) =>
|
||||
cliValue || process.env[envKey] || dotenv[envKey] || '';
|
||||
|
||||
let aptMirror = pick(opts.aptMirror, 'APT_MIRROR');
|
||||
let npmRegistry = pick(opts.npmRegistry, 'NPM_REGISTRY');
|
||||
const chromeUrl = pick(opts.chromeUrl, 'CHROME_DEB_URL');
|
||||
if (opts.mirror) {
|
||||
// --mirror 只填空位,不覆盖使用者显式给的值
|
||||
if (!aptMirror) aptMirror = MIRROR_PRESET.apt;
|
||||
if (!npmRegistry) npmRegistry = MIRROR_PRESET.npm;
|
||||
}
|
||||
|
||||
const buildArgs = [];
|
||||
if (aptMirror) buildArgs.push('--build-arg', 'APT_MIRROR=' + aptMirror);
|
||||
if (npmRegistry) buildArgs.push('--build-arg', 'NPM_REGISTRY=' + npmRegistry);
|
||||
if (chromeUrl) buildArgs.push('--build-arg', 'CHROME_DEB_URL=' + chromeUrl);
|
||||
// 额外的 --build-arg 放最后,允许覆盖上面的预设
|
||||
for (const kv of opts.buildArgs) buildArgs.push('--build-arg', kv);
|
||||
|
||||
// ---- 3. 标签:没给就按 package.json 的版本号打 version + latest ----
|
||||
const repoName = (pkg.name || 'yun-xue-tang-assistant').toLowerCase();
|
||||
const version = pkg.version || 'dev';
|
||||
const tags = opts.tags.length ? opts.tags : [`${repoName}:${version}`, `${repoName}:latest`];
|
||||
|
||||
const args = ['build'];
|
||||
if (opts.platform) args.push('--platform', opts.platform);
|
||||
if (opts.noCache) args.push('--no-cache');
|
||||
if (opts.pull) args.push('--pull');
|
||||
for (const t of tags) args.push('-t', t);
|
||||
args.push(...buildArgs, '.');
|
||||
|
||||
const cmdline = 'docker ' + quote(args);
|
||||
console.log('[构建] 镜像标签:' + tags.join('、'));
|
||||
console.log('[构建] 上下文:' + ROOT);
|
||||
if (aptMirror) console.log('[构建] APT_MIRROR = ' + aptMirror);
|
||||
if (npmRegistry) console.log('[构建] NPM_REGISTRY = ' + npmRegistry);
|
||||
if (chromeUrl) console.log('[构建] CHROME_DEB_URL= ' + chromeUrl);
|
||||
if (!chromeUrl) console.log('[构建] CHROME_DEB_URL 未指定,将从 dl.google.com 下载(国内网络可能失败,见 README 常见问题)');
|
||||
console.log('[构建] 命令:' + cmdline);
|
||||
console.log('[构建] 首次构建约 3-5 分钟(主要是下 Chrome 的 deb),后续走缓存会快很多。\n');
|
||||
|
||||
if (opts.dryRun) {
|
||||
console.log('[dry-run] 未执行构建。');
|
||||
return 0;
|
||||
}
|
||||
|
||||
// ---- 4. 真正构建 ----
|
||||
const build = run('docker', args);
|
||||
if (build.error) {
|
||||
console.error('[错误] 启动 docker build 失败:' + build.error.message);
|
||||
return 2;
|
||||
}
|
||||
if (build.status !== 0) {
|
||||
console.error('\n[失败] 构建未通过(退出码 ' + build.status + ')。常见原因:');
|
||||
console.error(' · 拉不到 Chrome deb → 加 --chrome-url <你的镜像地址>,或先配好代理');
|
||||
console.error(' · apt / npm 太慢 → 加 --mirror 换国内源');
|
||||
console.error(' · 依赖变了但缓存没失效 → 加 --no-cache 重来一次');
|
||||
return 1;
|
||||
}
|
||||
|
||||
const primary = tags[0];
|
||||
console.log('\n[完成] 已构建:' + tags.join('、'));
|
||||
|
||||
// ---- 5. 可选自检:只读,不登录、不动课程进度,用来确认镜像真的能起来 ----
|
||||
if (opts.check) {
|
||||
console.log('[自检] 运行 docker run --rm ' + primary + ' --check ...\n');
|
||||
const chk = run('docker', ['run', '--rm', primary, '--check']);
|
||||
if (chk.status !== 0) {
|
||||
console.error('\n[失败] 镜像自检未通过(退出码 ' + chk.status + ')。');
|
||||
return 1;
|
||||
}
|
||||
console.log('\n[自检] 通过:镜像内的 Node、Chrome、构建产物都可用。');
|
||||
}
|
||||
|
||||
console.log(`
|
||||
下一步:
|
||||
# 自检(不需要账号,只读)
|
||||
docker run --rm ${primary} --check
|
||||
|
||||
# 正式刷课(凭据只走环境变量,别写进镜像)
|
||||
docker run -d --name yun-xue-tang \\
|
||||
-e YUN_XUE_TANG_USR='账号' -e YUN_XUE_TANG_PWD='密码' \\
|
||||
-v "$PWD/.run-profile:/app/.run-profile" -v "$PWD/run-logs:/app/run-logs" \\
|
||||
--shm-size=512m --restart on-failure:3 ${primary}
|
||||
|
||||
# 或用 compose(账号写在 .env 里):cp .env.example .env && docker compose up -d
|
||||
`);
|
||||
return 0;
|
||||
}
|
||||
|
||||
process.exit(main());
|
||||
@@ -0,0 +1,11 @@
|
||||
#!/bin/sh
|
||||
# 构建 Docker 镜像的薄封装(Linux / macOS 用)。
|
||||
# 所有逻辑都在 scripts/build-docker.mjs 里,这里只负责切到仓库根目录再转交。
|
||||
#
|
||||
# ./scripts/build-docker.sh 默认标签
|
||||
# ./scripts/build-docker.sh --mirror --check 国内源 + 构建后自检
|
||||
# ./scripts/build-docker.sh --help
|
||||
set -e
|
||||
ROOT=$(CDPATH= cd -- "$(dirname -- "$0")/.." && pwd)
|
||||
cd "$ROOT"
|
||||
exec node scripts/build-docker.mjs "$@"
|
||||
Reference in new issue
Block a user