Files
yun-xue-tang-assistant/scripts/build.mjs
T
void c1e883d67f refactor: 重组目录结构,脚本收进 scripts/,配置独立成 config/
根目录原来平铺了构建脚本、运行器配置、两个 .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 通过)。
2026-10-25 23:21:59 +08:00

70 lines
2.7 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/usr/bin/env node
/**
* 用 esbuild 把 src/ 下的模块打包成单个 Tampermonkey 脚本。
*
* 产物:仓库根目录的 yun-xue-tang-assistant.user.js(与拆分前的文件名完全一致,
* 因此 dev/serve.mjs、dev/dev-loader.user.js 热加载链路无需任何改动)。
*
* 用法:
* npm run build 一次性打包
* npm run build:watch 监听 src/ 自动重新打包(配合热加载器,保存即生效)
* node scripts/build.mjs --minify 压缩产物(发布用)
*/
import esbuild from 'esbuild';
import path from 'node:path';
import { readFile, stat } from 'node:fs/promises';
import { fileURLToPath } from 'node:url';
// 本文件在 scripts/ 下,仓库根目录是它的上一级
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
const SRC_DIR = path.join(ROOT, 'src');
const ENTRY = path.join(SRC_DIR, 'index.js');
const META = path.join(SRC_DIR, 'meta.js');
const OUT = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
// 版本号只有 package.json 一个来源:banner 的 @version 与 config.js 的 VERSION 都由它生成
const { version } = JSON.parse(await readFile(path.join(ROOT, 'package.json'), 'utf8'));
const args = process.argv.slice(2);
const watch = args.includes('--watch');
const minify = args.includes('--minify');
const common = {
entryPoints: [ENTRY],
bundle: true,
format: 'iife',
target: ['chrome80', 'firefox78', 'safari13'],
minify,
charset: 'utf8',
// __YUN_XUE_TANG_VERSION__ 由 src/config.js 引用,构建时替换成 package.json 的版本号
define: { __YUN_XUE_TANG_VERSION__: JSON.stringify(version) },
// 用原生 import/export + format=iife,esbuild 不会注入 __export 等辅助代码。
logLevel: 'info',
};
// src/meta.js 里的 @version 写成 __YUN_XUE_TANG_VERSION__,由这里按 package.json 替换
async function bannerText() {
const raw = await readFile(META, 'utf8');
return raw.replace('__YUN_XUE_TANG_VERSION__', version).trimEnd() + '\n';
}
const buildOptions = (banner) => ({ ...common, banner: { js: banner }, outfile: OUT });
async function runOnce() {
const startedAt = Date.now();
await esbuild.build(buildOptions(await bannerText()));
const size = (await stat(OUT)).size;
console.log(`[build] 已生成 ${OUT}(${size} 字节 / ${(size / 1024).toFixed(1)} KB)${minify ? '(压缩)' : ''},耗时 ${Date.now() - startedAt}ms`);
}
async function runWatch() {
const ctx = await esbuild.context(buildOptions(await bannerText()));
await ctx.watch();
console.log('[build] 监听中:保存 src/ 下的文件即自动重新打包(dev 服务会感知哈希变化)');
}
(watch ? runWatch() : runOnce()).catch((e) => {
console.error('[build] 失败:', e);
process.exit(1);
});