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

+3 -1
View File
@@ -4,6 +4,8 @@ node_modules/
# ---- 运行 / 调试产物 ----
# 本地实跑会在这里生成浏览器配置目录、截图和一次性调试脚本,体积很大,不入库
.run-tmp/
# 真机测试(dev/tests/real-*.mjs)每次跑都重新生成的截图
.run-tmp/screenshots/
# 无头运行器的持久化 profile(含登录 cookie,绝不能入库)和运行日志
.run-profile/
run-logs/
@@ -21,5 +23,5 @@ desktop.ini
# ---- 本地私有配置(不要提交账号信息) ----
.env
.env.*
# 个人临时覆盖用的运行器配置(放进仓库的 runner.config.mjs 保持通用)
# 个人临时覆盖用的运行器配置(仓库里的 config/runner.config.mjs 保持通用)
runner.local.mjs
+35 -20
View File
@@ -86,7 +86,7 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
sudo apt install -y chromium # 或安装官方包:google-chrome-stable
# 2. 构建产物
npm install && npm run build
# 3. 调参:改仓库根目录的 runner.config.mjs(maxCourses、budgetMinutes、preferShort…)
# 3. 调参:改 config/runner.config.mjs(maxCourses、budgetMinutes、preferShort…)
# 只想临时覆盖就用命令行,例如 npm run headless -- --max-courses 3
# 4. 凭据走环境变量(不要写进配置文件)
export YUN_XUE_TANG_USR='你的账号'
@@ -112,7 +112,7 @@ tail -f run-logs/headless.log # 也可以直接看日志文件
winget install --id Google.Chrome
# 2. 构建产物
npm install; npm run build
# 3. 调参:改 runner.config.mjs(无需重新 build)
# 3. 调参:改 config/runner.config.mjs(无需重新 build)
# 4. 凭据(PowerShell;用 CMD 请改成 set YUN_XUE_TANG_USR=...)
$env:YUN_XUE_TANG_USR='你的账号'
$env:YUN_XUE_TANG_PWD='你的密码'
@@ -121,7 +121,7 @@ npm run headless:check
npm run headless
```
也可以直接双击 [`start-headless.cmd`](start-headless.cmd):它会自动构建、检查 Node、跑完后
也可以直接双击 [`scripts/start-headless.cmd`](scripts/start-headless.cmd):它会自动构建、检查 Node、跑完后
用 `pause` 留住退出码信息(方便看报错)。注意这个批处理文件**只写 ASCII 字符**——中文提示
全部由 Node 侧输出,原因见下方常见坑表里的「`'鍏?npm' 不是内部或外部命令`」。
@@ -136,7 +136,7 @@ schtasks /create /tn "云学堂助手" /tr "node runner\headless.mjs" /sc onlogo
# C. 只跑一段(例如每天凌晨跑 2 小时):命令行临时覆盖配置
npm run headless -- --budget-minutes 120
# 或把 budgetMinutes: 120 写进 runner.config.mjs,然后直接 npm run headless
# 或把 budgetMinutes: 120 写进 config/runner.config.mjs,然后直接 npm run headless
```
Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停批量、关浏览器)。
@@ -165,7 +165,7 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
| --- | --- | --- |
| `runner/headless.mjs` | ~130 | 入口:解析参数 → 预检 → 交给 supervisor,只做组装 |
| `runner/config.mjs` | ~360 | 三层合并(配置文件 / 环境变量 / 命令行)+ 校验 + `--help`,其它模块只读导出常量 |
| `runner.config.mjs`(仓库根) | ~50 | **日常调参就改这里**:普通 JS 模块,可写注释,改完不用 build |
| `config/runner.config.mjs` | ~50 | **日常调参就改这里**:普通 JS 模块,可写注释,改完不用 build |
| `runner/platform.mjs` | ~230 | 平台差异:有无图形会话、沙箱参数、进程树收尾、残留进程清理、排查命令 |
| `runner/preflight.mjs` | ~95 | 启动前检查:产物、Node 版本、凭据、浏览器、调试端口(端口被占会先自愈) |
| `runner/log.mjs` | ~50 | 终端 + 文件日志,超上限轮转成 `.1` |
@@ -184,7 +184,7 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
命令行参数(**日常改配置文件就行**;这里的开关只是临时覆盖,适合写进 `tmux` 命令或 `~/.bashrc`):
优先级:**内置默认值 < `runner.config.mjs` < 环境变量 `YUN_XUE_TANG_*` < 命令行参数**。
优先级:**内置默认值 < `config/runner.config.mjs` < 环境变量 `YUN_XUE_TANG_*` < 命令行参数**。
| 参数 | 环境变量 | 配置文件字段 | 默认 | 作用 |
| --- | --- | --- | --- | --- |
@@ -203,7 +203,7 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
| `--extra-args "…"` | `YUN_XUE_TANG_EXTRA_ARGS` | `extraArgs` | 空 | 追加给浏览器的命令行参数(空格分隔) |
| `--log-file PATH`(旧名 `--log`) | `YUN_XUE_TANG_LOG_FILE` | `logFile` | `./run-logs/headless.log` | 日志文件路径 |
| `--log-max-bytes N`(旧名 `--log-max`) | `YUN_XUE_TANG_LOG_MAX_BYTES` | `logMaxBytes` | `5242880` | 单文件上限,超出轮转 |
| `--config PATH` | `YUN_XUE_TANG_CONFIG` | — | `./runner.config.mjs` | 指定另一个配置文件 |
| `--config PATH` | `YUN_XUE_TANG_CONFIG` | — | `./config/runner.config.mjs` | 指定另一个配置文件 |
| `--help` / `-h` | — | — | — | 打印完整参数表(含配置文件字段、环境变量、当前生效值) |
| — | `YUN_XUE_TANG_HAS_DISPLAY` | — | 自动判断 | `1`/`0` 强制认定「有无图形会话」(Linux 看 `DISPLAY`,Windows 看 `SESSIONNAME`;判断不准时用) |
| — | `YUN_XUE_TANG_USR` / `YUN_XUE_TANG_PWD` | **不写入配置文件** | 必填 | 账号密码。故意只走环境变量:命令行会进进程列表/计划任务历史 |
@@ -212,11 +212,11 @@ Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停
### 配置文件
日常调参改仓库根目录的 `runner.config.mjs` 即可,它是普通 JS 模块(可写注释、可写表达式),
日常调参改 `config/runner.config.mjs` 即可,它是普通 JS 模块(可写注释、可写表达式),
改完**不需要 `npm run build`**(构建只打包注入浏览器的 `src/`):
```js
// runner.config.mjs
// config/runner.config.mjs
export default {
maxCourses: 0, // 0 = 不限,一直刷到没有未学完的课
budgetMinutes: 0, // 0 = 不限运行时长
@@ -268,12 +268,16 @@ npm run build:watch # 监听 src/,保存即自动重新打包
npm run dev # 等价于 node dev/serve.mjs,默认 127.0.0.1:8899
```
Windows 下也可以直接双击 [`dev/start-dev.cmd`](dev/start-dev.cmd)。脚本暴露 `window.__yunXueTangDispose()`,
Windows 下也可以直接双击 [`scripts/start-dev.cmd`](scripts/start-dev.cmd)。脚本暴露 `window.__yunXueTangDispose()`,
加载器在注入新版本前先释放旧实例(定时器、监听器、面板),因此视频播放不会被打断。
## 目录结构
```text
README.md 说明文档(本文件)
package.json / package-lock.json npm scripts 与依赖锁(唯一依赖:esbuild)
.gitattributes / .gitignore 换行符与忽略规则
yun-xue-tang-assistant.user.js 构建产物(唯一需要安装的文件,不要手改)
src/ 业务脚本源码(拆成多个模块,日常改这里)
meta.js UserScript 头 + 用法注释
config.js CFG / 常量 / VERSION
@@ -289,9 +293,11 @@ src/ 业务脚本源码(拆成多个模块,日
course.js 课程页主循环
complete.js 完成 / 未完成重试
index.js 主循环 / 启动 / 调试入口
build.mjs esbuild 打包脚本
runner.config.mjs 无头运行器配置文件(日常调参改这里,不用 build)
start-headless.cmd Windows 一键启动无头运行器(双击即可)
scripts/ 开发与运维脚本(不在构建产物里)
build.mjs esbuild 打包脚本(产物写回仓库根)
check.mjs 静态检查:node --check + 批处理纯 ASCII/CRLF 校验
start-dev.cmd Windows 一键启动本地热加载服务(双击即可)
start-headless.cmd Windows 一键启动无头运行器(双击即可)
runner/ 无头运行器(Linux / Windows,无图形化环境)
headless.mjs 入口:组装 配置 → 预检 → supervisor
config.mjs 参数 / 配置文件 / 环境变量三层合并 + --help
@@ -305,13 +311,22 @@ runner/ 无头运行器(Linux / Windows,无图形
session.mjs 单次会话:起浏览器 / 注入 / 自动重登 / 崩溃自愈
selfcheck.mjs --check 只读环境自检
supervisor.mjs 崩溃重启循环与退出码
package-lock.json 依赖锁(esbuild)
package.json npm scripts(build / build:watch / dev / headless / check)
yun-xue-tang-assistant.user.js 构建产物(唯一需要安装的文件,不要手改)
config/
runner.config.mjs 无头运行器配置(日常调参改这里,不用 build)
dev/ 本地热加载开发工具(HTTP 服务 + 薄加载器)
docs/screenshots/ 实跑截图
docs/evidence/ 实跑日志与接口证据
运行报告.md 2026-10-19 实跑报告(v2.0.3)
serve.mjs 本地 HTTP 服务(默认 127.0.0.1:8899)
dev-loader.user.js Tampermonkey 里的薄加载器
tests/ 真机测试(真实 Chrome + 真实站点)
real-cdp.mjs 极简 CDP 客户端(三个测试共用)
real-test.mjs 面板渲染 / 路由 / 热替换断言(只读)
real-e2e.mjs 真实账号登录 → 列表 → 进课 → 播放
real-run.mjs 持续跑:跨章节 / 跨课程 / 断线重启
docs/
reports/ 历史实跑报告
run-report-v203.md 2026-10-19 实跑报告(v2.0.3)
evidence/ 当前版本的证据(叙述 + 接口日志)
archive/v2.0-snapshots/ v2.0.x 时期的原始抓取片段(仅存档)
screenshots/ 手工挑选的展示截图(测试自动截图不进库)
```
## 本机数据
@@ -357,7 +372,7 @@ docs/evidence/ 实跑日志与接口证据
## 实跑记录
真实站点(`kfmic.yunxuetang.cn`)的完整实跑过程、发现的问题与修复记录见 [运行报告.md](运行报告.md),
真实站点(`kfmic.yunxuetang.cn`)的完整实跑过程、发现的问题与修复记录见 [`docs/reports/run-report-v203.md`](docs/reports/run-report-v203.md),
证据文件在 [`docs/evidence/`](docs/evidence/),截图在 [`docs/screenshots/`](docs/screenshots/)。
v2.5.2 修复「进入课程不从第一个未学完的课时开始」的定位过程、复刻用例与修复前后对比,
File renamed without changes.
+16 -12
View File
@@ -5,15 +5,19 @@
## 结构
`dev/` 只放「在浏览器里跑」的开发工具(HTTP 服务 + 薄加载器 + 真机测试),
构建与检查脚本在 `../scripts/`,运行器配置在 `../config/`。
| 文件 | 作用 |
| --- | --- |
| `src/` | 业务脚本源码(拆成多个模块,改这里) |
| `build.mjs` | 用 esbuild 把 `src/` 打包成单文件 `.user.js`(产物文件名与原脚本一致,热加载链路无需改动) |
| `../src/` | 业务脚本源码(拆成多个模块,改这里) |
| `../scripts/build.mjs` | 用 esbuild 把 `src/` 打包成单文件 `.user.js`(产物写在仓库根,热加载链路无需改动) |
| `../yun-xue-tang-assistant.user.js` | **构建产物**(不要手改,改 `src/` 后 `npm run build`) |
| `serve.mjs` | 本地 HTTP 服务,向浏览器提供源码与版本哈希(127.0.0.1:8899) |
| `dev-loader.user.js` | Tampermonkey 里的薄加载器,轮询版本、释放旧实例、注入新实例 |
| `start-dev.cmd` | 双击启动服务 |
| `check.mjs` | `npm run check` 的实现:自动遍历 `runner/`、`dev/` 与顶层文件跑 `node --check`,同时检查 `.cmd` 必须是纯 ASCII + CRLF(cmd.exe 逐字节按代码页读批处理,中文和裸 LF 会让行偏移错位);新增模块不用再手改命令 |
| `tests/` | 真机测试脚本(真实 Chrome + 真实站点,见下方「真机测试」) |
| `../scripts/start-dev.cmd` | 双击启动服务 |
| `../scripts/check.mjs` | `npm run check` 的实现:自动遍历 `runner/`、`dev/`、`scripts/`、`config/` 跑 `node --check`,同时检查 `.cmd` 必须是纯 ASCII + CRLF(cmd.exe 逐字节按代码页读批处理,中文和裸 LF 会让行偏移错位);新增模块不用再手改命令 |
原理:加载器每 1 秒请求 `/version`,发现哈希变化就调用旧实例暴露的
`window.__yunXueTangDispose()`(清定时器 / 监听器 / 面板),再把新源码以 `<script>` 形式注入页面主世界。
@@ -21,7 +25,7 @@
## 一次性安装
1. 双击 `dev/start-dev.cmd` 启动本地服务(保持窗口开着)。
1. 双击 `scripts/start-dev.cmd` 启动本地服务(保持窗口开着)。
2. 浏览器打开 <http://127.0.0.1:8899/>,点「安装 / 更新热加载器」,Tampermonkey 弹窗确认安装。
> 手动方式:Tampermonkey 面板 → 添加新脚本 → 粘贴 `dev/dev-loader.user.js` 全文 → 保存。
3. **停用或删除** Tampermonkey 里原来那份「云学堂助手」完整脚本。
@@ -45,10 +49,10 @@
npm run build # 先出产物
npm run test:real # 有界面 Chrome,能看见面板真实渲染
npm run test:real:headless # 无头模式(CI / 无人值守)
node dev/real-test.mjs --keep # 跑完不关浏览器,便于人工复核
node dev/tests/real-test.mjs --keep # 跑完不关浏览器,便于人工复核
```
三个真机脚本(`real-test` / `real-e2e` / `real-run`)会自动适配当前平台:
三个真机脚本(`dev/tests/real-test.mjs` / `real-e2e.mjs` / `real-run.mjs`)会自动适配当前平台:
没有图形会话时强制 `--headless=new`(即使没传 `--headless`),并补上该平台需要的参数
(Linux:`--no-sandbox --disable-setuid-sandbox --disable-dev-shm-usage`;Windows:不弹崩溃恢复气泡),
因此可以原样在无图形化服务器 / 容器 / CI / Windows 后台里跑。平台判断复用
@@ -72,7 +76,7 @@ node dev/real-test.mjs --keep # 跑完不关浏览器,便于人工复核
| 路由 | SPA 内改 `location.hash` 后 `route()` 自动跟随,无需重新注入 |
| 整页重定向 | 未登录访问 `#/list` 被站点跳回登录页(新 document),脚本无残留、重注入后正常 |
产物:截图存到 `docs/screenshots/real-chrome-login.png`。
产物:截图存到 `.run-tmp/screenshots/real-chrome-login.png`(测试产物不入库,`--shotdir` / `YUN_XUE_TANG_SHOT_DIR` 可改)。
需要 Node 22+(全局 `WebSocket` / `fetch`),无需 puppeteer / playwright。
测试**只读**:不填账号密码、不点登录、不改线上数据。
@@ -89,8 +93,8 @@ node dev/real-test.mjs --keep # 跑完不关浏览器,便于人工复核
npm run test:e2e # 登录 + 列表;默认只读,不碰学习进度
npm run test:e2e:play # 额外进入最短的未学完课程,采样 25 秒后立即暂停
npm run test:e2e:play -- --seconds 60
node dev/real-e2e.mjs --headless # 无头
node dev/real-e2e.mjs --keep # 跑完不关浏览器
node dev/tests/real-e2e.mjs --headless # 无头
node dev/tests/real-e2e.mjs --keep # 跑完不关浏览器
```
覆盖的断言(`--play` 时是 19 项,否则 12 项):
@@ -119,7 +123,7 @@ node dev/real-e2e.mjs --keep # 跑完不关浏览器
| 现象 | 处理 |
| --- | --- |
| 左下角红条「未连上本地开发服务」 | 服务没启动,或端口被占用;运行 `dev/start-dev.cmd` |
| 左下角红条「未连上本地开发服务」 | 服务没启动,或端口被占用;运行 `scripts/start-dev.cmd` |
| 改完没反应 | 看控制台是否有 `热更新` 日志;确认 `npm run build:watch` 在跑,改的是 `src/` 下的模块 |
| 页面出现两个面板 | 旧完整脚本没停用,去 Tampermonkey 停用它 |
| 端口冲突 | `node dev/serve.mjs 8900`,同时把加载器里的 `SERVER` 常量改成对应端口 |
@@ -132,5 +136,5 @@ node dev/real-e2e.mjs --keep # 跑完不关浏览器
## 开机自启(可选)
把 `dev/start-dev.cmd` 的快捷方式放进
把 `scripts/start-dev.cmd` 的快捷方式放进
`%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup`,开机即后台常驻。
+3 -3
View File
@@ -21,7 +21,7 @@
* 3. 服务没开时回退到上一次缓存的源码,保证照常可用;
* 4. 新源码语法错误时拒绝注入,旧实例继续运行(不会把页面搞挂)。
*
* 依赖:先运行 dev/start-dev.cmd(或 node dev/serve.mjs)启动本地服务。
* 依赖:先运行 scripts/start-dev.cmd(或 node dev/serve.mjs)启动本地服务。
* 生效方式:MODE = 'hot' 不刷新页面;'reload' 变更后整页刷新。
*/
(function () {
@@ -203,8 +203,8 @@
console.warn(TAG, '开发服务不可用,使用缓存源码:', e.message);
apply(cached);
} else {
console.error(TAG, '开发服务不可用且无缓存。请先运行 dev/start-dev.cmd');
badge('未连上本地开发服务(' + SERVER + ')\n请运行 dev/start-dev.cmd');
console.error(TAG, '开发服务不可用且无缓存。请先运行 scripts/start-dev.cmd');
badge('未连上本地开发服务(' + SERVER + ')\n请运行 scripts/start-dev.cmd');
}
}).then(function () {
if (isTop) schedule(POLL_MS);
+2 -2
View File
@@ -5,9 +5,9 @@
import fs from 'node:fs';
import {
resolveBrowser as _resolveBrowser, safetyArgs as _safetyArgs, hasDisplay,
} from '../runner/browser.mjs';
} from '../../runner/browser.mjs';
export { cleanStaleSingleton } from '../runner/browser.mjs';
export { cleanStaleSingleton } from '../../runner/browser.mjs';
export async function connect(wsUrl) {
const ws = new WebSocket(wsUrl);
+3 -2
View File
@@ -27,7 +27,8 @@ import { fileURLToPath } from 'node:url';
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
const HERE = path.dirname(fileURLToPath(import.meta.url));
const ROOT = path.resolve(HERE, '..');
// 本文件在 dev/tests/ 下,仓库根目录是上两级
const ROOT = path.resolve(HERE, '..', '..');
const SCRIPT_SRC = fs.readFileSync(path.join(ROOT, 'yun-xue-tang-assistant.user.js'), 'utf8');
const argv = process.argv.slice(2);
@@ -44,7 +45,7 @@ const SAMPLE_SECONDS = Number(opt('--seconds', 25));
const HEADLESS = flag('--headless') || process.env.YUN_XUE_TANG_HEADLESS === '1';
const KEEP = flag('--keep');
const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9334);
const SHOT_DIR = opt('--shotdir', path.join(ROOT, 'docs/screenshots'));
const SHOT_DIR = opt('--shotdir', path.join(ROOT, '.run-tmp', 'screenshots'));
const ORIGIN = 'https://kfmic.yunxuetang.cn';
const CANDIDATES = [
+2 -1
View File
@@ -27,7 +27,8 @@ import { fileURLToPath } from 'node:url';
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
const HERE = path.dirname(fileURLToPath(import.meta.url));
const ROOT = path.resolve(HERE, '..');
// 本文件在 dev/tests/ 下,仓库根目录是上两级
const ROOT = path.resolve(HERE, '..', '..');
const SCRIPT_SRC = fs.readFileSync(path.join(ROOT, 'yun-xue-tang-assistant.user.js'), 'utf8');
const argv = process.argv.slice(2);
+10 -6
View File
@@ -16,7 +16,7 @@
* YUN_XUE_TANG_CHROME Chrome/Edge 可执行文件路径
* YUN_XUE_TANG_CDP_PORT 调试端口,默认 9333
* YUN_XUE_TANG_URL 起始页面,默认 https://kfmic.yunxuetang.cn/login.html
* YUN_XUE_TANG_SHOT_DIR 截图目录,默认 docs/screenshots
* YUN_XUE_TANG_SHOT_DIR 截图目录,默认 .run-tmp/screenshots(不入库)
*
* 需要 Node 22+(用到全局 WebSocket 与 fetch);只做只读探测:
* 不填写账号密码、不点登录、不修改线上数据。
@@ -29,9 +29,13 @@ import { fileURLToPath } from 'node:url';
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
const HERE = path.dirname(fileURLToPath(import.meta.url));
const ROOT = path.resolve(HERE, '..');
// 本文件在 dev/tests/ 下,仓库根目录是上两级
const ROOT = path.resolve(HERE, '..', '..');
const SCRIPT_FILE = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
const SCRIPT_SRC = fs.readFileSync(SCRIPT_FILE, 'utf8');
// 版本号只有 package.json 一个来源(与 build.mjs 注入产物的一致),避免断言写死后每次升版都要改测试
const VERSION = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8')).version;
const EXPECT_VERSION = 'v' + VERSION;
const CANDIDATES = [
process.env.YUN_XUE_TANG_CHROME,
@@ -49,7 +53,7 @@ const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9333);
const START_URL = process.env.YUN_XUE_TANG_URL || 'https://kfmic.yunxuetang.cn/login.html';
const HEADLESS = process.env.YUN_XUE_TANG_HEADLESS === '1' || process.argv.includes('--headless');
const KEEP = process.env.YUN_XUE_TANG_KEEP === '1' || process.argv.includes('--keep');
const SHOT_DIR = process.env.YUN_XUE_TANG_SHOT_DIR || path.join(ROOT, 'docs/screenshots');
const SHOT_DIR = process.env.YUN_XUE_TANG_SHOT_DIR || path.join(ROOT, '.run-tmp', 'screenshots');
const results = [];
const consoleLogs = [];
@@ -171,7 +175,7 @@ try {
})())`);
check('面板渲染进真实 DOM 且可见', panel && panel.visible && panel.w > 0 && panel.h > 0,
panel && { 宽: panel.w, 高: panel.h, position: panel.position, zIndex: panel.zIndex });
check('面板版本号 v2.7.0', panel && panel.version === 'v2.7.0', panel && panel.version);
check('面板版本号 ' + EXPECT_VERSION, panel && panel.version === EXPECT_VERSION, panel && panel.version);
check('固定在右下角', panel && panel.right >= 0 && panel.right < 40 && panel.bottom >= 0 && panel.bottom < 40,
panel && { 距右: panel.right, 距下: panel.bottom });
check('面板含按钮与密码框', panel && panel.buttons.length >= 2 && panel.inputTypes.includes('password'),
@@ -246,7 +250,7 @@ try {
})`);
check('dispose 后真实 DOM 面板被移除', hot.panel === false && hot.api === 'undefined',
hot);
check('重新注入后面板唯一且版本正确', hot2.count === 1 && hot2.api === 'object' && hot2.version === 'v2.7.0', hot2);
check('重新注入后面板唯一且版本正确', hot2.count === 1 && hot2.api === 'object' && hot2.version === EXPECT_VERSION, hot2);
// ---- 9. 截图存证 ----
try {
@@ -300,7 +304,7 @@ try {
bodyScrollable: document.body.scrollHeight > 0,
})`);
check('重定向后重新注入:面板唯一且脚本正常',
reinjected.panel === 1 && reinjected.version === 'v2.7.0' && reinjected.route !== 'no-api', reinjected);
reinjected.panel === 1 && reinjected.version === EXPECT_VERSION && reinjected.route !== 'no-api', reinjected);
check('列表页导航无脚本报错', scriptErrors().length === 0, scriptErrors().map((e) => e.text.slice(0, 140)));
// ---- 汇总控制台 ----
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.
+1 -1
View File
@@ -4,7 +4,7 @@
背景
----
用户反馈:进入课程后不会从「第一个未学完的课时」开始,前面的课时被跳过 / 整门课学不完。
真实站点需要登录,无法在本地直接复现,因此按 docs/evidence/probe.txt、probe2.txt、probe4.txt
真实站点需要登录,无法在本地直接复现,因此按 docs/archive/v2.0-snapshots/probe.txt、probe2.txt、probe4.txt
里记录的真实目录结构,复刻课程页 DOM,再用无头 Chromium 注入用户脚本跑 20 秒,
读取目录高亮、面板状态与控制台日志。复刻页面与用例脚本在 .run-tmp/align/(本机调试用,未入库)。
+22 -22
View File
@@ -38,7 +38,7 @@
- `runner/browser.mjs:hasDisplay()` 判 `DISPLAY` / `WAYLAND_DISPLAY`;
- `runner/headless.mjs` 里 `VISIBLE = WANT_VISIBLE && hasDisplay()`,
即**即使传了 `--visible` 也会被强制无头并打警告**;
- `dev/real-cdp.mjs:forceHeadless()` 让三个真机测试脚本同样自动无头。
- `dev/tests/real-cdp.mjs:forceHeadless()` 让三个真机测试脚本同样自动无头。
2) root 运行:Chromium 拒绝启动(`Running as root without --no-sandbox is not supported`)。
- `safetyArgs()` 在 `process.getuid()===0` 时补 `--no-sandbox --disable-setuid-sandbox --disable-gpu`;
- `buildArgs()` 在 Linux 上恒加 `--no-sandbox --disable-setuid-sandbox`。
@@ -125,10 +125,10 @@
六、回归(改动没有破坏原有链路)
- `npm run check`:12 个文件逐个 `node --check` 全通过(新增 runner/*.mjs 与 dev/real-run.mjs 也已纳入)。
- `npm run check`:24 个文件逐个 `node --check` 全通过(新增 runner/*.mjs 与 dev/tests/real-run.mjs 也已纳入)。
- `npm run test:real:headless`(真机只读断言):**24/24 通过,失败 0**。
- `node dev/real-e2e.mjs --headless`:**12/12 通过,失败 0**(真实登录 → 新 document → 列表 16 张卡片 / 322 页)。
- `node dev/real-run.mjs --headless --scan`:**3/3 通过,失败 0**。
- `node dev/tests/real-e2e.mjs --headless`:**12/12 通过,失败 0**(真实登录 → 新 document → 列表 16 张卡片 / 322 页)。
- `node dev/tests/real-run.mjs --headless --scan`:**3/3 通过,失败 0**。
七、已知限制
@@ -145,7 +145,7 @@
入口只剩 90 行(结构见第二节表格),**不引入打包步骤**(按用户选择:保持直接 import)。
同时把 package.json 的 check 从「一长串 node --check a && node --check b …」
改成 dev/check.mjs 自动遍历 runner/、dev/ 与顶层文件 —— 以前新增模块必须手改那行命令,
改成 scripts/check.mjs 自动遍历 runner/、dev/、scripts/ 与 config/ —— 以前新增模块必须手改那行命令,
漏改就会静默不被检查。现在输出:语法检查:20/20 个文件通过。
拆分过程中发现并修掉 3 个真实缺陷(都是原单文件里藏着的):
@@ -175,8 +175,8 @@
kill 浏览器主进程 会话异常:CDP 连接断开 → 15 秒后第 2 次尝试 → 自动重登 → 继续刷课
SIGTERM 浏览器 code=143,残留 chrome 进程数 0
npm run test:real:headless 24/24 通过
node dev/real-e2e.mjs --headless 12/12 通过
node dev/real-run.mjs --headless --scan 3/3 通过
node dev/tests/real-e2e.mjs --headless 12/12 通过
node dev/tests/real-run.mjs --headless --scan 3/3 通过
stop.mjs 的单元核查(一次性脚本,未入库):注册的收尾函数全部执行、已注销的不执行、
重复信号不重复执行、收尾后调用 onExit(0)。
@@ -211,7 +211,7 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
browserInstallHint() / residentHint() 按平台出安装与常驻建议
browser.mjs 转发 platform.mjs 的导出(safetyArgs / hasDisplay / isRunningAsRoot 等),
老的调用方(dev/real-cdp.mjs、dev/real-*.mjs)不需要改 import。
老的调用方(dev/tests/real-cdp.mjs、dev/tests/real-*.mjs)不需要改 import。
9.2 各模块的改动点
@@ -229,7 +229,7 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
config.mjs VISIBLE = WANT_VISIBLE && hasDisplay(),导出 platformName / noDisplayReason。
supervisor.mjs 启动横幅打平台名;--visible 被忽略时用 noDisplayReason() 说原因。
headless.mjs 注释补 Windows 用法(set / $env:)与代码结构。
dev/real-*.mjs spawn 补 windowsHide: true。
dev/tests/real-*.mjs spawn 补 windowsHide: true。
9.3 实测(Windows 11 / Chrome 155.0.8059.85 / Node v24.19.0)
@@ -271,13 +271,13 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
npm run headless:check 5/5 PASS,退出码 0
node runner/headless.mjs --max 1 已完成 1 门(用时 3 分 9 秒),退出码 0
npm run test:real:headless 24/24 通过
node dev/real-e2e.mjs --headless 12/12 通过
node dev/real-run.mjs --headless --scan 3/3 通过
npm run check(dev/check.mjs) 21/21 个文件通过
node dev/tests/real-e2e.mjs --headless 12/12 通过
node dev/tests/real-run.mjs --headless --scan 3/3 通过
npm run check(scripts/check.mjs) 24/24 个文件通过
9.4 Windows 额外交付
start-headless.cmd 一键启动(自动构建 / 检查 Node / 退出码说明 + pause)
scripts/start-headless.cmd 一键启动(自动构建 / 检查 Node / 退出码说明 + pause)
README「无头运行」一节 改成 Linux / Windows 双栏,补「Windows 常驻三种方式」
与按平台分的「无图形环境常见坑」表
环境变量 YUN_XUE_TANG_HAS_DISPLAY 0/1 强制认定有无图形会话(自动判断不准时用)
@@ -301,12 +301,12 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
改为 [...new Set(args)] 去重后再拼 extraArgs。Windows 侧核查重复项:无。
======================================================================
十、Windows 批处理启动脚本的编码陷阱(start-headless.cmd 报「不是内部或外部命令」)
十、Windows 批处理启动脚本的编码陷阱(scripts/start-headless.cmd 报「不是内部或外部命令」)
======================================================================
10.1 现象
双击 start-headless.cmd,控制台输出:
双击 scripts/start-headless.cmd,控制台输出:
'e' 不是内部或外部命令,也不是可运行的程序或批处理文件。
'鍏?npm' 不是内部或外部命令,也不是可运行的程序或批处理文件。
'rofile' 不是内部或外部命令,也不是可运行的程序或批处理文件。
@@ -334,22 +334,22 @@ Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模
10.3 采用方案:批处理只用 ASCII,中文交给 Node 输出
start-headless.cmd 与 dev/start-dev.cmd 全部改写为纯 ASCII + CRLF:
scripts/start-headless.cmd 与 scripts/start-dev.cmd 全部改写为纯 ASCII + CRLF:
- 注释里写明「本文件必须保持纯 ASCII」及原因,避免以后有人手改回去;
- 所有面向用户的提示(构建中 / 启动中 / 退出码含义 / 缺 Node)改用英文短句
(如 [build] / [run] / [exit] / [error]),中文提示由 Node 侧日志输出;
- 文件仍保留 chcp 65001,这样 Node 输出的 UTF-8 中文在控制台正常显示。
验证:
file start-headless.cmd → DOS batch file, ASCII text, with CRLF line terminators
非 ASCII 字节数 → 0(dev/start-dev.cmd 同样为 0,原为 50)
cmd /c start-headless.cmd --check → 5/5 PASS,退出码 0
cmd /c start-headless.cmd(错误凭据) → 连续 5 次登录失败 → [exit] code 3 → pause
file scripts/start-headless.cmd → DOS batch file, ASCII text, with CRLF line terminators
非 ASCII 字节数 → 0(scripts/start-dev.cmd 同样为 0,原为 50)
cmd /c scripts\start-headless.cmd --check → 5/5 PASS,退出码 0
cmd /c scripts\start-headless.cmd(错误凭据)→ 连续 5 次登录失败 → [exit] code 3 → pause
10.4 防回归:dev/check.mjs 增加批处理检查
10.4 防回归:scripts/check.mjs 增加批处理检查
`npm run check` 原来只跑 node --check,对 .cmd 完全无感知(所以这个 bug 是双击才发现)。
现在 dev/check.mjs 同时遍历 *.cmd / *.bat 并断言两件事:
现在 scripts/check.mjs 同时遍历 *.cmd / *.bat 并断言两件事:
1. 不含任何 >0x7F 的字节(报错时给出首次出现的偏移与上下文片段);
2. LF 与 CRLF 数量相等(存在裸 LF 就报错)。
自测(临时文件,验证完即删):
+1 -1
View File
@@ -69,4 +69,4 @@ orderBy 传 studyHours 不会被服务端接受(返回默认顺序),所以
- 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。
七、面板截图
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选)
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选;展示图随仓库入库)
@@ -1,11 +1,11 @@
# 云学堂助手 · 实跑报告(v2.0.3)
> 历史记录:本报告对应 **v2.0.3**,当时的文件名为 `yunxuetang-auto-play.user.js`。
> 脚本现已更名为 [`yun-xue-tang-assistant.user.js`](yun-xue-tang-assistant.user.js),当前版本 **v2.7.0**,
> 脚本现已更名为 [`yun-xue-tang-assistant.user.js`](../../yun-xue-tang-assistant.user.js),当前版本 **v2.8.0**,
> 下文记录的修复均已包含在当前版本中。v2.6.0 新增「优先短课程(时长正序)」,
> 实跑与回归证据见 [`docs/evidence/short-course-evidence.txt`](docs/evidence/short-course-evidence.txt);
> 实跑与回归证据见 [`docs/evidence/short-course-evidence.txt`](../../docs/evidence/short-course-evidence.txt);
> v2.7.0 修复单视频课程不自动播放与课程完成后不转下一门,
> 证据见 [`docs/evidence/completion-next-evidence.txt`](docs/evidence/completion-next-evidence.txt)。
> 证据见 [`docs/evidence/completion-next-evidence.txt`](../../docs/evidence/completion-next-evidence.txt)。
日期:2026-10-19 21:19–21:51(Asia/Shanghai)
脚本:`yun-xue-tang-assistant.user.js`(v2.0.3 时名为 `yunxuetang-auto-play.user.js`),最终版本 **v2.0.3**
@@ -33,7 +33,7 @@
| 倒计时 | 「还需 2小时 8分钟 34秒」 |
| 停止 | 手动停在 234s,避免无人值守跑 2 小时以上 |
![课程播放中(首轮)](docs/screenshots/watch-006.png)
![课程播放中(首轮)](../../docs/screenshots/watch-006.png)
## 实跑 2:短课时验证自动切节
@@ -73,7 +73,7 @@
[21:36:40.930] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
```
![切到下一节后的画面](docs/screenshots/15-after-advance.png)
![切到下一节后的画面](../../docs/screenshots/15-after-advance.png)
## v2.0.3 复跑:第 2 节 → 第 3 节
@@ -97,7 +97,7 @@
096 study/summary finishNum=2/3 acqHours=607
```
![第 3 节播放中,汇总 2/3](docs/screenshots/16-v203-next.png)
![第 3 节播放中,汇总 2/3](../../docs/screenshots/16-v203-next.png)
测试过程中有一个插曲:第一次在批量运行中直接 `goto` 第 2 节地址,页面加载瞬间标题还是 `loading...`,脚本判定「页面课程与队列不一致」,按保护逻辑回到列表并选中了第一门未完成课程 KFMI,播了约 221 秒后才被手动停掉。正常从列表进入课程不会触发;但**刷新课程页/直接改 URL** 时确实可能遇到,属于已知限制,本轮未改。
@@ -179,15 +179,15 @@ const localDone = (cd != null && cd <= 0) ||
## 证据文件
- [`docs/evidence/advance-evidence.txt`](docs/evidence/advance-evidence.txt):平台进度 0→1、切节日志、最终状态
- [`docs/evidence/v203-advance-evidence.txt`](docs/evidence/v203-advance-evidence.txt):v2.0.3 第 2→3 节、平台进度 1→2、最终状态
- [`docs/evidence/completion-banner-evidence.txt`](docs/evidence/completion-banner-evidence.txt):完成后「还需 5分钟」出现的时序
- [`docs/evidence/countdown-regex-test.txt`](docs/evidence/countdown-regex-test.txt):4 种倒计时格式的解析结果
- [`docs/evidence/probe.txt`](docs/evidence/probe.txt)、[`probe2.txt`](docs/evidence/probe2.txt)、[`probe4.txt`](docs/evidence/probe4.txt):目录结构与新旧切节逻辑对比
- [`docs/evidence/report.txt`](docs/evidence/report.txt):首轮运行状态与日志摘录
- [`docs/screenshots/watch-006.png`](docs/screenshots/watch-006.png):首轮播放中截图
- [`docs/screenshots/15-after-advance.png`](docs/screenshots/15-after-advance.png):v2.0.2 切到第 2 节后的画面
- [`docs/screenshots/16-v203-next.png`](docs/screenshots/16-v203-next.png):v2.0.3 切到第 3 节、汇总 2/3 的画面
- [`docs/archive/v2.0-snapshots/advance-evidence.txt`](../../docs/archive/v2.0-snapshots/advance-evidence.txt):平台进度 0→1、切节日志、最终状态
- [`docs/archive/v2.0-snapshots/v203-advance-evidence.txt`](../../docs/archive/v2.0-snapshots/v203-advance-evidence.txt):v2.0.3 第 2→3 节、平台进度 1→2、最终状态
- [`docs/archive/v2.0-snapshots/completion-banner-evidence.txt`](../../docs/archive/v2.0-snapshots/completion-banner-evidence.txt):完成后「还需 5分钟」出现的时序
- [`docs/evidence/countdown-regex-test.txt`](../../docs/evidence/countdown-regex-test.txt):4 种倒计时格式的解析结果
- [`docs/archive/v2.0-snapshots/probe.txt`](../../docs/archive/v2.0-snapshots/probe.txt)、[`probe2.txt`](../../docs/archive/v2.0-snapshots/probe2.txt)、[`probe4.txt`](../../docs/archive/v2.0-snapshots/probe4.txt):目录结构与新旧切节逻辑对比
- [`docs/archive/v2.0-snapshots/report.txt`](../../docs/archive/v2.0-snapshots/report.txt):首轮运行状态与日志摘录
- [`docs/screenshots/watch-006.png`](../../docs/screenshots/watch-006.png):首轮播放中截图
- [`docs/screenshots/15-after-advance.png`](../../docs/screenshots/15-after-advance.png):v2.0.2 切到第 2 节后的画面
- [`docs/screenshots/16-v203-next.png`](../../docs/screenshots/16-v203-next.png):v2.0.3 切到第 3 节、汇总 2/3 的画面
> 整理仓库时已删除 `.run-tmp/`(浏览器配置目录、一次性调试脚本与其余截图,约 460 MB);
> 报告引用到的日志与截图已移到 `docs/` 下保留。
> 报告引用到的原始抓取片段已归档到 `docs/archive/v2.0-snapshots/`,截图仍在 `docs/screenshots/`。
Binary file not shown.

Before

Width:  |  Height:  |  Size: 5.1 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 453 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 677 KiB

+7 -7
View File
@@ -4,14 +4,14 @@
"private": true,
"description": "云学堂(*.yunxuetang.cn)Tampermonkey 助手:自动登录、顺序听课、自动切节、批量刷课",
"scripts": {
"build": "node build.mjs",
"build:watch": "node build.mjs --watch",
"build": "node scripts/build.mjs",
"build:watch": "node scripts/build.mjs --watch",
"dev": "node dev/serve.mjs",
"check": "node dev/check.mjs",
"test:real": "node dev/real-test.mjs",
"test:real:headless": "node dev/real-test.mjs --headless",
"test:e2e": "node dev/real-e2e.mjs",
"test:e2e:play": "node dev/real-e2e.mjs --play",
"check": "node scripts/check.mjs",
"test:real": "node dev/tests/real-test.mjs",
"test:real:headless": "node dev/tests/real-test.mjs --headless",
"test:e2e": "node dev/tests/real-e2e.mjs",
"test:e2e:play": "node dev/tests/real-e2e.mjs --play",
"headless": "node runner/headless.mjs",
"headless:check": "node runner/headless.mjs --check"
},
+1 -1
View File
@@ -20,7 +20,7 @@ import {
isWindows, isLinux, isRunningAsRoot, safetyArgs, killTree, killProfileOrphans,
} from './platform.mjs';
// 由本模块统一再导出,老的调用方(dev/real-cdp.mjs 等)不用改
// 由本模块统一再导出,老的调用方(dev/tests/real-cdp.mjs 等)不用改
// (hasDisplay / safetyArgs 只在这里转发,本模块内部不直接用)
export {
hasDisplay, safetyArgs, isRunningAsRoot, platformName, noDisplayReason,
+1 -1
View File
@@ -1,5 +1,5 @@
// 极简 CDP 客户端:Node 22+ 原生 WebSocket,无需 puppeteer / playwright。
// 与 dev/real-cdp.mjs 同一套思路,额外提供「连接断开回调」与事件订阅失败隔离,
// 与 dev/tests/real-cdp.mjs 同一套思路,额外提供「连接断开回调」与事件订阅失败隔离,
// 供无人值守的 runner/headless.mjs 在断线时判断是否需要重建浏览器。
export async function connect(wsUrl, opts = {}) {
const ws = new WebSocket(wsUrl);
+5 -5
View File
@@ -45,7 +45,7 @@ const argv = process.argv.slice(2);
const DEPRECATED = {
'--visible': '已废弃:等价于设置 headless: false(或 --headless 0),本版本仍然可用',
};
/** 旧参数名 -> 配置字段(保持向后兼容,dev/ 下的脚本还在用) */
/** 旧参数名 -> 配置字段(保持向后兼容,dev/tests/ 下的脚本还在用) */
const ALIASES = {
'--max': 'maxCourses',
'--budget': 'budgetMinutes',
@@ -58,12 +58,12 @@ const ALIASES = {
// ---------------------------------------------------------------------------
// 两层:读配置文件(JS 模块)
// ---------------------------------------------------------------------------
/** 配置文件路径:命令行 --config > 环境变量 YUN_XUE_TANG_CONFIG > 仓库根目录 runner.config.mjs */
/** 配置文件路径:命令行 --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, 'runner.config.mjs');
const def = path.join(ROOT, 'config/runner.config.mjs');
return fs.existsSync(def) ? def : '';
}
@@ -336,7 +336,7 @@ export function helpText() {
lines.push('');
lines.push('用法:node runner/headless.mjs [参数…]');
lines.push('优先级:内置默认值 < 配置文件 < 环境变量 YUN_XUE_TANG_* < 命令行参数');
lines.push('配置文件:' + (CONFIG_FILE || '(未找到)') + (CONFIG_FILE ? '' : ' —— 复制仓库里的 runner.config.mjs 即可'));
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++) {
@@ -349,7 +349,7 @@ export function helpText() {
lines.push(' node runner/headless.mjs --check # 只做环境自检');
lines.push(' node runner/headless.mjs --max-courses 3 # 本次最多 3 门');
lines.push(' node runner/headless.mjs --headless 0 # 开有界面浏览器调试');
lines.push(' node runner/headless.mjs --config ./runner.config.mjs # 显式指定配置文件');
lines.push(' node runner/headless.mjs --config ./config/runner.config.mjs # 显式指定配置文件');
lines.push('');
lines.push('旧参数名(仍然兼容):--max / --budget / --restart / --idle / --log / --log-max / --visible');
return lines.join('\n');
+1 -1
View File
@@ -28,7 +28,7 @@ export async function runSupervisor(o) {
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 runner.config.mjs,使用内置默认值)'));
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 config/runner.config.mjs,使用内置默认值)'));
log('浏览器 ' + o.binary);
log('profile ' + cfg.PROFILE_DIR + '(cookie / localStorage 持久化,删掉即重置登录态与进度缓存)');
if (cfg.WANT_VISIBLE && !cfg.VISIBLE) {
+6 -5
View File
@@ -2,20 +2,21 @@
/**
* 用 esbuild 把 src/ 下的模块打包成单个 Tampermonkey 脚本。
*
* 产物:yun-xue-tang-assistant.user.js(与拆分前的文件名完全一致,
* 产物:仓库根目录的 yun-xue-tang-assistant.user.js(与拆分前的文件名完全一致,
* 因此 dev/serve.mjs、dev/dev-loader.user.js 热加载链路无需任何改动)。
*
* 用法:
* node build.mjs 一次性打包
* node build.mjs --watch 监听 src/ 自动重新打包(配合热加载器,保存即生效)
* node build.mjs --minify 压缩产物(发布用)
* 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';
const ROOT = path.dirname(fileURLToPath(import.meta.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');
+4 -9
View File
@@ -18,11 +18,10 @@ import { spawnSync } from 'node:child_process';
import { fileURLToPath } from 'node:url';
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
/** 要遍历的目录(JS 与 bat 一起收) */
const DIRS = ['runner', 'dev'];
/** 顶层要单独检查的文件(runner.config.mjs 是配置文件,也要求语法正确) */
const FILES = ['build.mjs', 'runner.config.mjs', 'yun-xue-tang-assistant.user.js'];
const TOP_CMD = ['start-headless.cmd'];
/** 要遍历的目录(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 = []) {
@@ -52,10 +51,6 @@ for (const f of FILES) {
const p = path.join(ROOT, f);
if (fs.existsSync(p)) jsTargets.push(p);
}
for (const f of TOP_CMD) {
const p = path.join(ROOT, f);
if (fs.existsSync(p)) cmdTargets.push(p);
}
let failed = 0;
+2 -2
View File
@@ -1,5 +1,5 @@
@echo off
rem NOTE: keep this file PURE ASCII, see start-headless.cmd for why.
rem NOTE: keep this file PURE ASCII, see scripts\start-headless.cmd for why.
rem (cmd.exe parses batch files byte-by-byte with the current code page;
rem multi-byte characters corrupt line offsets.)
chcp 65001 >nul
@@ -11,5 +11,5 @@ if errorlevel 1 (
pause
exit /b 1
)
node "%~dp0serve.mjs" %*
node "%~dp0..\dev\serve.mjs" %*
if errorlevel 1 pause
@@ -7,13 +7,13 @@ rem it report nonsense like "'npm' is not recognized".
rem All Chinese messages come from the Node runner output instead.
rem
rem Usage:
rem start-headless.cmd use runner.config.mjs
rem start-headless.cmd --help print all options
rem start-headless.cmd --max 3 command line overrides config file
rem scripts\start-headless.cmd use config␍unner.config.mjs
rem scripts\start-headless.cmd --help print all options
rem scripts\start-headless.cmd --max 3 command line overrides config file
rem ---------------------------------------------------------------
setlocal
chcp 65001 >nul
cd /d "%~dp0"
cd /d "%~dp0.."
title YunXueTang Assistant - headless runner
where node >nul 2>nul
@@ -25,12 +25,12 @@ call npm run build
if errorlevel 1 goto build_fail
:have_build
if not exist "runner.config.mjs" goto no_config
echo [config] runner.config.mjs found, editing it is enough (no rebuild needed)
if not exist "config␍unner.config.mjs" goto no_config
echo [config] config␍unner.config.mjs found, editing it is enough (no rebuild needed)
goto run
:no_config
echo [warn] runner.config.mjs not found, built-in defaults will be used
echo [warn] config␍unner.config.mjs not found, built-in defaults will be used
:run
echo [run] headless runner starting, press Ctrl+C to stop