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