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

+49
View File
@@ -0,0 +1,49 @@
/**
* 无头运行器配置文件(JS 模块,可以写注释、也可以写表达式)。
*
* 生效优先级(后者覆盖前者):
* 内置默认值 < 本文件 < 环境变量 YUN_XUE_TANG_* < 命令行参数 --x
*
* 账号密码不在这里:仍然只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,
* 这样本文件可以放心提交,也不会出现在 `ps` / 任务管理器 / 计划任务历史里。
*
* 改完直接重新运行 `node runner/headless.mjs` 即生效,不需要 npm run build
* (build 只打包注入浏览器的 src/ 脚本)。
*
* 每一项的覆盖方式见 README「无头运行 → 配置文件」;`--help` 会打印带默认值的完整清单。
*/
export default {
// ---------- 选课 / 刷课策略 ----------
/** 本次最多完成多少门课;0 = 不限(一直刷到没有未学完的课) */
maxCourses: 10,
/** 运行多少分钟后收尾退出;0 = 不限(适合 cron 定长跑时设成 60) */
budgetMinutes: 0,
/** 优先总时长最短的课程(正序);false = 按列表原顺序 */
preferShort: true,
/** 脚本自己停下后等多少分钟再开新一轮;0 = 直接退出。配合 --max 可以实现分段刷完 */
restartMinutes: 0,
/** 连续多少分钟没有任何进展就判定卡死并退出(0 = 用内置的 30 分钟) */
idleRestartMinutes: 30,
// ---------- 站点 / 浏览器 ----------
/** 站点根地址(换分公司环境只改这一行) */
origin: 'https://kfmic.yunxuetang.cn',
/** 起始页面;留空 = <origin>/login.html */
url: '',
/** CDP 调试端口;同机跑多个实例时分开 */
port: 9336,
/** true = 无头(默认);false = 开有界面浏览器,需要图形会话,没有时会被强制无头 */
headless: true,
/** Chrome/Chromium 可执行文件路径;留空 = 自动探测 */
chrome: '',
/** 追加给浏览器的命令行参数(空格分隔),例如 '--proxy-server=socks5://127.0.0.1:1080' */
extraArgs: '',
// ---------- 文件 / 日志 ----------
/** 持久化 profile 目录(cookie / localStorage);留空 = ./.run-profile,删掉即重置登录态 */
profile: './.run-profile',
/** 日志文件;留空 = ./run-logs/headless.log */
logFile: './run-logs/headless.log',
/** 单个日志文件上限(字节),超出后轮转成 .1 */
logMaxBytes: 5 * 1024 * 1024,
};