收尾通知去掉重复的积分台账与完成门数;学习统计在无 TTY 时照常累计,保证 Docker 里也能推送学分提醒。 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
413 lines
21 KiB
JavaScript
413 lines
21 KiB
JavaScript
// 运行参数与路径:配置文件 / 环境变量 / 命令行在这里集中解析,其它模块只读导出的常量。
|
||
//
|
||
// 优先级(后者覆盖前者):
|
||
// 内置默认值 < runner.config.mjs < 环境变量 YUN_XUE_TANG_* < 命令行参数 --x
|
||
//
|
||
// 配置文件是 JS 模块(见仓库根目录的 runner.config.mjs),可以写注释和表达式。
|
||
// 账号密码不在配置文件里,只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,
|
||
// 避免凭据进入版本库、进程列表和计划任务历史。
|
||
import fs from 'node:fs';
|
||
import path from 'node:path';
|
||
import { fileURLToPath, pathToFileURL } from 'node:url';
|
||
import { defaultProfileDir } from './browser.mjs';
|
||
import { hasDisplay, noDisplayReason, platformName } from './platform.mjs';
|
||
|
||
export { platformName, noDisplayReason };
|
||
|
||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||
export const ROOT = path.resolve(HERE, '..');
|
||
/** 构建产物(注入页面的单文件脚本) */
|
||
export const SCRIPT_FILE = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// 一层:内置默认值
|
||
// ---------------------------------------------------------------------------
|
||
const DEFAULTS = {
|
||
budgetMinutes: 0, // 0 = 不限
|
||
preferShort: true,
|
||
pointsMode: true, // 每日积分模式:整门课完成计 1 次,四类封顶后停止(文档1/视频3/音频2/微课2)
|
||
restartMinutes: 0, // 0 = 停下就退出
|
||
idleRestartMinutes: 30,
|
||
origin: 'https://kfmic.yunxuetang.cn',
|
||
url: '', // 留空 = <origin>/login.html
|
||
port: 9336,
|
||
headless: true,
|
||
chrome: '',
|
||
extraArgs: '',
|
||
profile: '', // 留空 = ./.run-profile
|
||
logFile: '', // 留空 = ./run-logs/headless.log
|
||
logMaxBytes: 5 * 1024 * 1024,
|
||
tui: true, // true = 交互式终端里启用面板;非 TTY 自动退化为逐行日志
|
||
color: true, // false = 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
|
||
// Bark 推送:运行器在开始运行、每门课获得学分、收尾时各发一条手机通知。
|
||
// barkUrl 是含设备 key 的地址(https://api.day.app/<key>),留空 = 不推送。
|
||
// key 等价于「谁能往你手机推通知」,别提交到公开仓库;可用环境变量覆盖。
|
||
barkUrl: '',
|
||
barkGroup: '', // 通知分组(Bark App 里按组折叠),留空 = Bark 默认
|
||
barkTtl: 0, // 通知在 Bark 服务端保留多少秒;0 = Bark 默认
|
||
};
|
||
|
||
const argv = process.argv.slice(2);
|
||
|
||
// 已废弃 / 旧版参数别名:老脚本里的写法继续可用,不报错
|
||
const DEPRECATED = {
|
||
'--visible': '已废弃:等价于设置 headless: false(或 --headless 0),本版本仍然可用',
|
||
};
|
||
/** 旧参数名 -> 配置字段(保持向后兼容,dev/tests/ 下的脚本还在用) */
|
||
const ALIASES = {
|
||
'--budget': 'budgetMinutes',
|
||
'--restart': 'restartMinutes',
|
||
'--idle': 'idleRestartMinutes',
|
||
'--log': 'logFile',
|
||
'--log-max': 'logMaxBytes',
|
||
};
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// 两层:读配置文件(JS 模块)
|
||
// ---------------------------------------------------------------------------
|
||
/** 配置文件路径:命令行 --config > 环境变量 YUN_XUE_TANG_CONFIG > config/runner.config.mjs */
|
||
function configPath() {
|
||
const i = argv.indexOf('--config');
|
||
if (i >= 0 && argv[i + 1]) return path.resolve(argv[i + 1]);
|
||
if (process.env.YUN_XUE_TANG_CONFIG) return path.resolve(process.env.YUN_XUE_TANG_CONFIG);
|
||
const def = path.join(ROOT, 'config/runner.config.mjs');
|
||
return fs.existsSync(def) ? def : '';
|
||
}
|
||
|
||
export const CONFIG_FILE = configPath();
|
||
const CONFIG_KNOWN = new Set([...Object.keys(DEFAULTS), 'username', 'password', 'check']);
|
||
|
||
let fileConfig = {};
|
||
const configWarnings = [];
|
||
if (CONFIG_FILE) {
|
||
try {
|
||
const mod = await import(pathToFileURL(CONFIG_FILE).href + '?t=' + Date.now());
|
||
const raw = mod.default;
|
||
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
|
||
throw new Error('默认导出必须是一个对象:export default { ... }');
|
||
}
|
||
for (const [k, v] of Object.entries(raw)) {
|
||
if (!CONFIG_KNOWN.has(k)) configWarnings.push('配置文件里有未知字段「' + k + '」,已忽略');
|
||
else if (v !== undefined) fileConfig[k] = v;
|
||
}
|
||
// 配置里写了账号:不采纳,只提示一次,避免有人以为这样能生效
|
||
if (fileConfig.username !== undefined || fileConfig.password !== undefined) {
|
||
configWarnings.push('配置文件里的 username / password 已忽略:凭据只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD');
|
||
}
|
||
} catch (e) {
|
||
const explicit = argv.includes('--config') || !!process.env.YUN_XUE_TANG_CONFIG;
|
||
const msg = e && e.code === 'ERR_MODULE_NOT_FOUND'
|
||
? (explicit ? '指定的配置文件不存在' : '配置文件导入失败')
|
||
: '配置文件内容有误';
|
||
console.error(msg + ':' + CONFIG_FILE + '\n ' + (e && e.message ? e.message.split('\n')[0] : e));
|
||
process.exit(2);
|
||
}
|
||
}
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// 命令行解析:--key value / --key=value / --flag
|
||
// ---------------------------------------------------------------------------
|
||
const BOOL_KEYS = ['preferShort', 'pointsMode', 'headless', 'check', 'tui', 'color'];
|
||
const NUM_KEYS = ['budgetMinutes', 'restartMinutes', 'idleRestartMinutes', 'port', 'logMaxBytes', 'barkTtl'];
|
||
const STR_KEYS = ['origin', 'url', 'profile', 'logFile', 'chrome', 'extraArgs', 'config', 'barkUrl', 'barkGroup'];
|
||
|
||
/** kebab-case → camelCase:--budget-minutes → budgetMinutes */
|
||
function toCamel(flag) {
|
||
return flag.replace(/^--/, '').replace(/-([a-z])/g, (m, c) => c.toUpperCase());
|
||
}
|
||
const camelToFlag = (k) => '--' + k.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase());
|
||
|
||
function parseBool(v, raw) {
|
||
const s = String(v).trim().toLowerCase();
|
||
if (['1', 'true', 'yes', 'on', 'y'].includes(s)) return true;
|
||
if (['0', 'false', 'no', 'off', 'n'].includes(s)) return false;
|
||
console.error('参数值不是布尔值:' + raw + '(可用 1/0、true/false、on/off)');
|
||
process.exit(2);
|
||
}
|
||
|
||
const cliRaw = {};
|
||
const unknownFlags = [];
|
||
const missingValues = [];
|
||
for (let i = 0; i < argv.length; i++) {
|
||
const a = argv[i];
|
||
if (!a.startsWith('--')) {
|
||
unknownFlags.push(a);
|
||
continue;
|
||
}
|
||
const eq = a.indexOf('=');
|
||
let name;
|
||
let inline;
|
||
if (eq > 0) {
|
||
name = a.slice(0, eq);
|
||
inline = a.slice(eq + 1);
|
||
} else {
|
||
name = a;
|
||
}
|
||
if (DEPRECATED[name]) configWarnings.push(DEPRECATED[name]);
|
||
let key = toCamel(name);
|
||
if (ALIASES[name]) key = ALIASES[name];
|
||
if (name === '--visible') key = 'headless'; // --visible = headless false
|
||
if (name === '--no-tui') key = 'tui'; // --no-tui = tui false
|
||
if (name === '--no-color') key = 'color'; // --no-color = color false
|
||
if (name === '--help' || name === '-h') key = 'help';
|
||
if (name === '--check') key = 'check';
|
||
const known = CONFIG_KNOWN.has(key) || key === 'help' || key === 'config';
|
||
if (!known) {
|
||
unknownFlags.push(name);
|
||
// 把未知参数的值一并吞掉,否则它会被当成一个独立的多余位置参数一起报
|
||
if (inline === undefined && argv[i + 1] !== undefined && !argv[i + 1].startsWith('-')) i++;
|
||
continue;
|
||
}
|
||
if (!BOOL_KEYS.includes(key) && !NUM_KEYS.includes(key) && !STR_KEYS.includes(key) && key !== 'help' && key !== 'config') {
|
||
unknownFlags.push(name);
|
||
if (inline === undefined && argv[i + 1] !== undefined && !argv[i + 1].startsWith('-')) i++;
|
||
continue;
|
||
}
|
||
// 布尔量可以不带值(--check 等于 --check 1);数值和字符串必须带值
|
||
let val;
|
||
if (inline !== undefined) val = inline;
|
||
else if (BOOL_KEYS.includes(key) && (argv[i + 1] === undefined || argv[i + 1].startsWith('--'))) val = '1';
|
||
else if (argv[i + 1] !== undefined && !argv[i + 1].startsWith('--')) val = argv[++i];
|
||
else {
|
||
missingValues.push(name);
|
||
continue;
|
||
}
|
||
if (name === '--visible') val = String(parseBool(val, name) ? 0 : 1); // --visible 0 → headless 1
|
||
if (name === '--no-tui' || name === '--no-color') val = String(parseBool(val, name) ? 0 : 1);
|
||
cliRaw[key] = val;
|
||
}
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// 三层:环境变量
|
||
// ---------------------------------------------------------------------------
|
||
const envNum = (name, cur) => {
|
||
const v = process.env[name];
|
||
if (v === undefined || v === '') return cur;
|
||
const n = Number(v);
|
||
if (!Number.isFinite(n)) {
|
||
configWarnings.push(name + ' 不是数字,已忽略:' + v);
|
||
return cur;
|
||
}
|
||
return n;
|
||
};
|
||
const envBool = (name, cur) => {
|
||
const v = process.env[name];
|
||
if (v === undefined || v === '') return cur;
|
||
return !/^(0|false|no|off)$/i.test(v);
|
||
};
|
||
const envStr = (name, cur) => {
|
||
const v = process.env[name];
|
||
return v === undefined || v === '' ? cur : v;
|
||
};
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// 合并:defaults < 配置文件 < 环境变量 < 命令行
|
||
// ---------------------------------------------------------------------------
|
||
const merged = { ...DEFAULTS, ...fileConfig };
|
||
|
||
merged.budgetMinutes = envNum('YUN_XUE_TANG_BUDGET_MINUTES', merged.budgetMinutes);
|
||
merged.restartMinutes = envNum('YUN_XUE_TANG_RESTART_MINUTES', merged.restartMinutes);
|
||
merged.idleRestartMinutes = envNum('YUN_XUE_TANG_IDLE_RESTART_MINUTES', merged.idleRestartMinutes);
|
||
merged.port = envNum('YUN_XUE_TANG_CDP_PORT', merged.port);
|
||
merged.logMaxBytes = envNum('YUN_XUE_TANG_LOG_MAX_BYTES', merged.logMaxBytes);
|
||
merged.preferShort = envBool('YUN_XUE_TANG_PREFER_SHORT', merged.preferShort);
|
||
merged.pointsMode = envBool('YUN_XUE_TANG_POINTS_MODE', merged.pointsMode);
|
||
merged.headless = envBool('YUN_XUE_TANG_HEADLESS', merged.headless);
|
||
merged.origin = envStr('YUN_XUE_TANG_ORIGIN', merged.origin);
|
||
merged.url = envStr('YUN_XUE_TANG_URL', merged.url);
|
||
merged.logFile = envStr('YUN_XUE_TANG_LOG_FILE', merged.logFile);
|
||
merged.profile = envStr('YUN_XUE_TANG_PROFILE_DIR', merged.profile);
|
||
merged.chrome = envStr('YUN_XUE_TANG_CHROME_BIN', merged.chrome);
|
||
merged.extraArgs = envStr('YUN_XUE_TANG_EXTRA_ARGS', merged.extraArgs);
|
||
merged.tui = envBool('YUN_XUE_TANG_TUI', merged.tui);
|
||
merged.color = envBool('YUN_XUE_TANG_COLOR', merged.color);
|
||
merged.barkTtl = envNum('YUN_XUE_TANG_BARK_TTL', merged.barkTtl);
|
||
merged.barkUrl = envStr('YUN_XUE_TANG_BARK_URL', merged.barkUrl);
|
||
merged.barkGroup = envStr('YUN_XUE_TANG_BARK_GROUP', merged.barkGroup);
|
||
|
||
// 命令行最后覆盖
|
||
const numBad = [];
|
||
for (const [key, raw] of Object.entries(cliRaw)) {
|
||
if (key === 'help' || key === 'config') continue;
|
||
if (key === 'check') { merged.check = parseBool(raw, '--check'); continue; }
|
||
if (BOOL_KEYS.includes(key)) { merged[key] = parseBool(raw, camelToFlag(key)); continue; }
|
||
if (NUM_KEYS.includes(key)) {
|
||
const n = Number(raw);
|
||
if (!Number.isFinite(n)) numBad.push(camelToFlag(key) + ' 需要数字,收到「' + raw + '」');
|
||
else merged[key] = n;
|
||
continue;
|
||
}
|
||
merged[key] = raw;
|
||
}
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// 校验
|
||
// ---------------------------------------------------------------------------
|
||
const problems = [...numBad];
|
||
if (numBad.length === 0) {
|
||
if (!(merged.port >= 1 && merged.port <= 65535)) problems.push('port 必须在 1-65535 之间,收到 ' + merged.port);
|
||
if (!(merged.budgetMinutes >= 0)) problems.push('budgetMinutes 不能为负,收到 ' + merged.budgetMinutes);
|
||
if (!(merged.restartMinutes >= 0)) problems.push('restartMinutes 不能为负,收到 ' + merged.restartMinutes);
|
||
if (!(merged.idleRestartMinutes >= 0)) problems.push('idleRestartMinutes 不能为负,收到 ' + merged.idleRestartMinutes);
|
||
if (!(merged.logMaxBytes >= 0)) problems.push('logMaxBytes 不能为负,收到 ' + merged.logMaxBytes);
|
||
if (!(merged.barkTtl >= 0)) problems.push('barkTtl 不能为负,收到 ' + merged.barkTtl);
|
||
}
|
||
if (unknownFlags.length) {
|
||
const uniq = [...new Set(unknownFlags)];
|
||
problems.push('无法识别的参数:' + uniq.join(' ') + '(用 --help 查看支持的参数)');
|
||
}
|
||
if (missingValues.length) {
|
||
const uniq = [...new Set(missingValues)];
|
||
problems.push('这些参数缺少值:' + uniq.join(' '));
|
||
}
|
||
|
||
export const HELP = argv.includes('--help') || argv.includes('-h');
|
||
if (problems.length && !HELP) {
|
||
console.error('参数有误:');
|
||
for (const p of problems) console.error(' · ' + p);
|
||
console.error('\n用 --help 查看支持的参数与配置文件字段。');
|
||
process.exit(2);
|
||
}
|
||
|
||
// ---------------------------------------------------------------------------
|
||
// 导出(保持原有大写下划线命名,其它模块不用改)
|
||
// ---------------------------------------------------------------------------
|
||
export const CHECK_ONLY = !!merged.check;
|
||
export const ORIGIN = String(merged.origin || DEFAULTS.origin).replace(/\/+$/, '');
|
||
export const START_URL = merged.url ? String(merged.url) : ORIGIN + '/login.html';
|
||
export const USR = process.env.YUN_XUE_TANG_USR || '';
|
||
export const PWD = process.env.YUN_XUE_TANG_PWD || '';
|
||
export const PORT = merged.port;
|
||
/** 运行多少分钟后收尾(0 = 不限) */
|
||
export const BUDGET_MINUTES = merged.budgetMinutes;
|
||
export const PROFILE_DIR = merged.profile
|
||
? path.resolve(ROOT, merged.profile)
|
||
: defaultProfileDir(ROOT);
|
||
|
||
// 没有图形显示的环境(Linux 无 DISPLAY、Windows 的 Session 0)上开不了有界面浏览器,
|
||
// 即使配置成有界面也强制无头:否则 Chrome 在 Linux 上报「Missing X server」然后退出,
|
||
// 在 Windows 服务会话里则是起来就崩。
|
||
export const WANT_VISIBLE = !merged.headless;
|
||
export const VISIBLE = WANT_VISIBLE && hasDisplay();
|
||
|
||
export const PREFER_SHORT = merged.preferShort;
|
||
export const POINTS_MODE = merged.pointsMode;
|
||
/** 脚本自己停下后等待多少分钟再开新一轮(0 = 直接退出) */
|
||
export const RESTART_MINUTES = merged.restartMinutes;
|
||
/** 连续多少分钟没有任何进展判定卡死 */
|
||
export const IDLE_RESTART_MINUTES = merged.idleRestartMinutes;
|
||
export const LOG_FILE = merged.logFile
|
||
? path.resolve(ROOT, merged.logFile)
|
||
: path.join(ROOT, 'run-logs/headless.log');
|
||
export const LOG_MAX_BYTES = merged.logMaxBytes;
|
||
export const EXTRA_ARGS = String(merged.extraArgs || '').split(/\s+/).filter(Boolean);
|
||
/** 配置文件里指定的浏览器路径(空 = 自动探测;优先级低于 YUN_XUE_TANG_CHROME_BIN,见 browser.mjs) */
|
||
export const CHROME_BIN = merged.chrome || '';
|
||
/** Bark 推送地址(含设备 key);空 = 不推送 */
|
||
export const BARK_URL = String(merged.barkUrl || '').trim();
|
||
export const BARK_GROUP = String(merged.barkGroup || '').trim();
|
||
export const BARK_TTL = merged.barkTtl;
|
||
export const WARNINGS = configWarnings;
|
||
|
||
/** 打印/展示 Bark 地址时把路径里的第一段(设备 key)打码,避免日志泄露推送权限 */
|
||
export function maskBarkUrl(url) {
|
||
const s = String(url || '');
|
||
if (!s) return '(未配置)';
|
||
const m = s.match(/^(https?:\/\/[^/]+)(\/.*)?$/i);
|
||
if (!m) return '(已配置)';
|
||
return m[1] + (m[2] || '').replace(/^\/([^/?]*)/, '/***');
|
||
}
|
||
|
||
/** 面板是否带颜色:配置 / 环境变量 / 行业惯例的 NO_COLOR 都生效 */
|
||
export const COLOR = merged.color && !process.env.NO_COLOR;
|
||
|
||
/**
|
||
* 是否启用终端面板(TUI)。
|
||
* 三个条件都满足才开:配置没关 + stdout 是交互式终端 + 不是自检模式。
|
||
* 自检要打印 PASS/FAIL 清单,塞进面板的日志区会看不到,所以强制逐行输出。
|
||
* 重定向到文件、管道、CI、计划任务里 stdout 不是 TTY,会自然退化。
|
||
*/
|
||
export const TUI = !!merged.tui && !CHECK_ONLY && !!process.stdout.isTTY;
|
||
|
||
/** 面板没开时,给一句人能看懂的原因(日志里只打一次) */
|
||
export function tuiDisabledReason() {
|
||
if (TUI) return '';
|
||
if (CHECK_ONLY) return '自检模式不启用面板(要逐行看 PASS/FAIL)';
|
||
if (!merged.tui) return '已按配置 / --no-tui 关闭面板';
|
||
if (!process.stdout.isTTY) return 'stdout 不是交互式终端(重定向 / 管道 / 服务),改用逐行日志';
|
||
return '环境不支持终端面板,改用逐行日志';
|
||
}
|
||
|
||
/** 一条便于粘贴到 issue / 日志的自述 */
|
||
export function describeRun() {
|
||
return {
|
||
configFile: CONFIG_FILE || '(未找到,使用内置默认值)',
|
||
platform: platformName,
|
||
checkOnly: CHECK_ONLY,
|
||
headless: !VISIBLE,
|
||
port: PORT,
|
||
budgetMinutes: BUDGET_MINUTES > 0 ? BUDGET_MINUTES : '不限',
|
||
preferShort: PREFER_SHORT,
|
||
pointsMode: POINTS_MODE,
|
||
restartMinutes: RESTART_MINUTES,
|
||
idleRestartMinutes: IDLE_RESTART_MINUTES,
|
||
profileDir: PROFILE_DIR,
|
||
logFile: LOG_FILE,
|
||
tui: TUI,
|
||
color: COLOR,
|
||
bark: BARK_URL ? (maskBarkUrl(BARK_URL) + (BARK_GROUP ? '(分组 ' + BARK_GROUP + ')' : '')) : '(未配置)',
|
||
};
|
||
}
|
||
|
||
/** --help 文本:字段、命令行名、环境变量、当前生效值一起列出 */
|
||
export function helpText() {
|
||
const rows = [
|
||
['配置字段', '命令行', '环境变量', '当前生效', '说明'],
|
||
['budgetMinutes', '--budget-minutes', 'YUN_XUE_TANG_BUDGET_MINUTES', BUDGET_MINUTES, '跑多少分钟后收尾;0 = 不限'],
|
||
['preferShort', '--prefer-short', 'YUN_XUE_TANG_PREFER_SHORT', PREFER_SHORT, '优先总时长最短的课程'],
|
||
['pointsMode', '--points-mode', 'YUN_XUE_TANG_POINTS_MODE', POINTS_MODE, '每日积分模式:文档1/视频3/音频2/微课2,封顶即停'],
|
||
['restartMinutes', '--restart-minutes', 'YUN_XUE_TANG_RESTART_MINUTES', RESTART_MINUTES, '脚本停下后等几分钟开新一轮;0 = 退出'],
|
||
['idleRestartMinutes', '--idle-restart-minutes', 'YUN_XUE_TANG_IDLE_RESTART_MINUTES', IDLE_RESTART_MINUTES, '多少分钟无进展判卡死'],
|
||
['origin', '--origin', 'YUN_XUE_TANG_ORIGIN', ORIGIN, '站点根地址'],
|
||
['url', '--url', 'YUN_XUE_TANG_URL', START_URL, '起始页面;空 = <origin>/login.html'],
|
||
['port', '--port', 'YUN_XUE_TANG_CDP_PORT', PORT, 'CDP 调试端口'],
|
||
['headless', '--headless 0|1', 'YUN_XUE_TANG_HEADLESS', !VISIBLE, '1 = 无头,0 = 有界面'],
|
||
['chrome', '--chrome', 'YUN_XUE_TANG_CHROME_BIN', CHROME_BIN || '(自动探测)', '浏览器可执行文件'],
|
||
['extraArgs', '--extra-args', 'YUN_XUE_TANG_EXTRA_ARGS', EXTRA_ARGS.join(' ') || '(无)', '追加给浏览器的参数'],
|
||
['profile', '--profile', 'YUN_XUE_TANG_PROFILE_DIR', PROFILE_DIR, '持久化 profile 目录'],
|
||
['tui', '--no-tui', 'YUN_XUE_TANG_TUI', TUI ? '开' : '关', '交互式终端里的进度面板;非 TTY 自动关闭'],
|
||
['color', '--no-color', 'YUN_XUE_TANG_COLOR', COLOR ? '开' : '关', '面板是否用 ANSI 颜色(也认 NO_COLOR)'],
|
||
['logFile', '--log-file', 'YUN_XUE_TANG_LOG_FILE', LOG_FILE, '日志文件'],
|
||
['logMaxBytes', '--log-max-bytes', 'YUN_XUE_TANG_LOG_MAX_BYTES', LOG_MAX_BYTES, '单文件上限,超出轮转'],
|
||
['barkUrl', '--bark-url', 'YUN_XUE_TANG_BARK_URL', maskBarkUrl(BARK_URL), 'Bark 推送地址(含设备 key);留空 = 不推送'],
|
||
['barkGroup', '--bark-group', 'YUN_XUE_TANG_BARK_GROUP', BARK_GROUP || '(Bark 默认)', 'Bark 通知分组'],
|
||
['barkTtl', '--bark-ttl', 'YUN_XUE_TANG_BARK_TTL', BARK_TTL, 'Bark 通知在服务端保留秒数;0 = 默认'],
|
||
['(字段 check)', '--check', '', CHECK_ONLY, '只做环境自检,不动进度'],
|
||
['(无字段)', '--config', 'YUN_XUE_TANG_CONFIG', CONFIG_FILE || '(内置默认)', '指定配置文件路径'],
|
||
];
|
||
const widths = [0, 1, 2, 3].map((c) => Math.max(...rows.map((r) => String(r[c]).length)));
|
||
const lines = [];
|
||
lines.push('云学堂无头运行器');
|
||
lines.push('');
|
||
lines.push('用法:node runner/headless.mjs [参数…]');
|
||
lines.push('优先级:内置默认值 < 配置文件 < 环境变量 YUN_XUE_TANG_* < 命令行参数');
|
||
lines.push('配置文件:' + (CONFIG_FILE || '(未找到)') + (CONFIG_FILE ? '' : ' —— 复制 config/runner.config.mjs 即可'));
|
||
lines.push('账号密码:只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD(不写进配置文件)');
|
||
lines.push('');
|
||
for (let i = 0; i < rows.length; i++) {
|
||
const r = rows[i].map((v, c) => (c < 4 ? String(v).padEnd(widths[c]) : String(v)));
|
||
lines.push((i === 0 ? '' : '') + r.join(' '));
|
||
if (i === 0) lines.push(' '.repeat(0) + widths.map((w) => '-'.repeat(w)).join(' '));
|
||
}
|
||
lines.push('');
|
||
lines.push('示例:');
|
||
lines.push(' node runner/headless.mjs --check # 只做环境自检');
|
||
lines.push(' node runner/headless.mjs --budget-minutes 15 # 最多跑 15 分钟');
|
||
lines.push(' node runner/headless.mjs --headless 0 # 开有界面浏览器调试');
|
||
lines.push(' node runner/headless.mjs --no-tui # 不用面板,回到逐行日志');
|
||
lines.push(' node runner/headless.mjs --config ./config/runner.config.mjs # 显式指定配置文件');
|
||
lines.push('');
|
||
lines.push('旧参数名(仍然兼容):--budget / --restart / --idle / --log / --log-max / --visible');
|
||
return lines.join('\n');
|
||
}
|