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 通过)。
This commit is contained in:
void committed 2026-10-25 23:21:59 +08:00
1 parent ae117222df
commit c1e883d67f
32 files changed
+148 -125

No files matched your search

+69
View File
@@ -0,0 +1,69 @@
#!/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);
});