根目录原来平铺了构建脚本、运行器配置、两个 .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 通过)。
111 lines
3.8 KiB
JavaScript
111 lines
3.8 KiB
JavaScript
#!/usr/bin/env node
|
||
/**
|
||
* 静态检查:对仓库里会直接 `node` 执行的脚本跑 `node --check`,
|
||
* 并对批处理文件做两项硬性检查(这两项一旦坏掉就极难排查):
|
||
* 1. 必须是纯 ASCII —— cmd.exe 按当前代码页逐字节读批处理,
|
||
* 多字节字符(中文)会让行偏移错位,报出 "'鍏?npm' is not recognized" 这种怪错;
|
||
* 2. 必须用 CRLF 行尾 —— 只有 LF 时 cmd.exe 会把上一行的尾部当成命令的一部分,
|
||
* 同样报出莫名其妙的 "'01' is not recognized"。
|
||
*
|
||
* 以前 package.json 的 check 脚本是一长串 `node --check a && node --check b && …`,
|
||
* 每次新增模块都要手改那行命令(漏了就默默不检查)。现在改为自动遍历目录。
|
||
*
|
||
* 用法:npm run check
|
||
*/
|
||
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)), '..');
|
||
/** 要遍历的目录(JS 与 bat 一起收;scripts/ 也在里面,含本文件自己) */
|
||
const DIRS = ['runner', 'dev', 'scripts', 'config'];
|
||
/** 顶层要单独检查的文件(构建产物不入源码校验,它在 scripts/ 下重新生成后自然被覆盖) */
|
||
const FILES = ['yun-xue-tang-assistant.user.js'];
|
||
const SKIP_DIRS = new Set(['node_modules', '.git', '.run-profile', 'run-logs', '.run-tmp']);
|
||
|
||
function walk(dir, out = []) {
|
||
for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
|
||
const p = path.join(dir, ent.name);
|
||
if (ent.isDirectory()) {
|
||
if (!SKIP_DIRS.has(ent.name)) walk(p, out);
|
||
} else if (/\.m?js$|\.cmd$|\.bat$/i.test(ent.name)) {
|
||
out.push(p);
|
||
}
|
||
}
|
||
return out;
|
||
}
|
||
|
||
const jsTargets = [];
|
||
const cmdTargets = [];
|
||
for (const d of DIRS) {
|
||
const dir = path.join(ROOT, d);
|
||
if (fs.existsSync(dir)) {
|
||
for (const f of walk(dir)) {
|
||
if (/\.m?js$/.test(f)) jsTargets.push(f);
|
||
else cmdTargets.push(f);
|
||
}
|
||
}
|
||
}
|
||
for (const f of FILES) {
|
||
const p = path.join(ROOT, f);
|
||
if (fs.existsSync(p)) jsTargets.push(p);
|
||
}
|
||
|
||
let failed = 0;
|
||
|
||
// ---- 1. JS 语法 ----
|
||
for (const file of jsTargets.sort()) {
|
||
const r = spawnSync(process.execPath, ['--check', file], { encoding: 'utf8' });
|
||
if (r.status !== 0) {
|
||
failed++;
|
||
console.error(' FAIL ' + path.relative(ROOT, file));
|
||
console.error((r.stderr || '').trim());
|
||
}
|
||
}
|
||
|
||
// ---- 2. 批处理文件:纯 ASCII + CRLF ----
|
||
for (const file of cmdTargets.sort()) {
|
||
const rel = path.relative(ROOT, file);
|
||
const buf = fs.readFileSync(file);
|
||
const bad = [];
|
||
|
||
const nonAscii = [];
|
||
for (let i = 0; i < buf.length; i++) {
|
||
if (buf[i] > 0x7f) nonAscii.push(i);
|
||
}
|
||
if (nonAscii.length) {
|
||
const first = nonAscii[0];
|
||
const ctx = buf.slice(Math.max(0, first - 20), first + 20).toString('utf8');
|
||
bad.push('含 ' + nonAscii.length + ' 个非 ASCII 字节(首次出现在偏移 ' + first + ',上下文 “' + ctx + '”);'
|
||
+ 'cmd.exe 按代码页逐字节读取,中文会让行偏移错位');
|
||
}
|
||
|
||
let lf = 0;
|
||
let crlf = 0;
|
||
for (let i = 0; i < buf.length; i++) {
|
||
if (buf[i] === 0x0a) {
|
||
lf++;
|
||
if (i > 0 && buf[i - 1] === 0x0d) crlf++;
|
||
}
|
||
}
|
||
if (lf !== crlf) {
|
||
bad.push('有 ' + (lf - crlf) + ' 处裸 LF 行尾(共 ' + lf + ' 个 LF / ' + crlf + ' 个 CRLF);'
|
||
+ 'cmd.exe 会把上一行尾部当成命令的一部分');
|
||
}
|
||
|
||
if (bad.length) {
|
||
failed++;
|
||
console.error(' FAIL ' + rel);
|
||
for (const b of bad) console.error(' - ' + b);
|
||
}
|
||
}
|
||
|
||
const total = jsTargets.length + cmdTargets.length;
|
||
if (failed) {
|
||
console.error('\n静态检查:' + failed + '/' + total + ' 个文件失败');
|
||
process.exit(1);
|
||
}
|
||
console.log('静态检查:' + total + '/' + total + ' 个文件通过'
|
||
+ '(JS ' + jsTargets.length + ' · 批处理 ' + cmdTargets.length + ')');
|