Compare commits
7
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
b588b1042f | ||
|
|
65bf63ea6a | ||
|
|
c1e883d67f | ||
|
|
ae117222df | ||
|
|
8193326b70 | ||
|
|
8200bfa0c5 | ||
|
|
7d6493bca5 |
No files matched your search
@@ -0,0 +1,26 @@
|
||||
# 让镜像只带源码与运行必需文件,别把本机的浏览器 profile / 日志 / 凭据 / node_modules 打进去
|
||||
node_modules
|
||||
.run-profile
|
||||
.run-tmp
|
||||
run-logs
|
||||
*.log
|
||||
|
||||
# 凭据绝对不能进镜像层
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
runner.local.mjs
|
||||
|
||||
# 开发工具与文档:容器里跑无头用不到,省体积
|
||||
.git
|
||||
.gitattributes
|
||||
.gitignore
|
||||
.vscode
|
||||
.idea
|
||||
docs
|
||||
dev/tests
|
||||
|
||||
# 镜像自身文件(entrypoint.sh 由 Dockerfile 单独 COPY,这里的 .dockerignore 规则不影响)
|
||||
Dockerfile
|
||||
docker-compose.yml
|
||||
.dockerignore
|
||||
@@ -0,0 +1,4 @@
|
||||
# 复制成 .env 后填自己的账号密码(.env 已在 .gitignore 里,不会入库)
|
||||
# 凭据只认这两个变量,不能写进 config/runner.config.mjs
|
||||
YUN_XUE_TANG_USR=
|
||||
YUN_XUE_TANG_PWD=
|
||||
@@ -0,0 +1,19 @@
|
||||
# 统一换行符,避免 Windows / macOS 混合编辑产生整文件 diff
|
||||
* text=auto eol=lf
|
||||
|
||||
# Windows 批处理必须 CRLF,否则 cmd.exe 解析 if/goto 可能出错
|
||||
*.cmd text eol=crlf
|
||||
*.bat text eol=crlf
|
||||
|
||||
# 容器 entrypoint 必须 LF:带 CRLF 时 shebang 会变成 "/bin/sh\r",容器启动直接报 exec format error
|
||||
*.sh text eol=lf
|
||||
Dockerfile text eol=lf
|
||||
docker-compose.yml text eol=lf
|
||||
|
||||
# 二进制文件不做文本转换
|
||||
*.png binary
|
||||
*.jpg binary
|
||||
*.jpeg binary
|
||||
*.gif binary
|
||||
*.ico binary
|
||||
*.woff2 binary
|
||||
+29
@@ -0,0 +1,29 @@
|
||||
# ---- 依赖 ----
|
||||
node_modules/
|
||||
|
||||
# ---- 运行 / 调试产物 ----
|
||||
# 本地实跑会在这里生成浏览器配置目录、截图和一次性调试脚本,体积很大,不入库
|
||||
.run-tmp/
|
||||
# 真机测试(dev/tests/real-*.mjs)每次跑都重新生成的截图
|
||||
.run-tmp/screenshots/
|
||||
# 无头运行器的持久化 profile(含登录 cookie,绝不能入库)和运行日志
|
||||
.run-profile/
|
||||
run-logs/
|
||||
*.log
|
||||
*.tmp
|
||||
|
||||
# ---- 编辑器 / 系统 ----
|
||||
.vscode/
|
||||
.idea/
|
||||
.DS_Store
|
||||
Thumbs.db
|
||||
desktop.ini
|
||||
*~
|
||||
|
||||
# ---- 本地私有配置(不要提交账号信息) ----
|
||||
.env
|
||||
.env.*
|
||||
# 模板要入库:只有它不含真实凭据
|
||||
!.env.example
|
||||
# 个人临时覆盖用的运行器配置(仓库里的 config/runner.config.mjs 保持通用)
|
||||
runner.local.mjs
|
||||
+97
@@ -0,0 +1,97 @@
|
||||
# 云学堂助手 · 无头运行器镜像
|
||||
#
|
||||
# 设计要点(为什么是这些选择):
|
||||
# · 基础镜像用 node:22-bookworm-slim —— runner/ 依赖全局 WebSocket / fetch,
|
||||
# preflight.mjs 会硬性要求 Node 22+,低于这个版本连预检都过不去;
|
||||
# · 浏览器装官方 google-chrome-stable,而不是 Debian 的 chromium:
|
||||
# 发行版 chromium 不带 H.264/AAC 专有编解码器,课程视频会一直停在 0 秒
|
||||
# (README「无图形环境常见的坑」里那条 error.code=4 就是这个原因);
|
||||
# · 构建在镜像内完成(npm ci → npm run build),产物落在 /app 根目录,
|
||||
# 所以镜像可以直接跑,不依赖宿主机先 build;
|
||||
# · 容器内必然没有 DISPLAY,运行器会自动走无头;以 root 运行时
|
||||
# platform.mjs / browser.mjs 会自动补 --no-sandbox 与 --disable-dev-shm-usage,
|
||||
# 不需要在命令行里手写这些参数。
|
||||
#
|
||||
# 构建:docker build -t yun-xue-tang-assistant .
|
||||
# 运行:见 docker-compose.yml 或 README「容器(Docker)」
|
||||
|
||||
FROM node:22-bookworm-slim
|
||||
|
||||
# 国内或内网环境从 dl.google.com 下不动时,可用内网镜像 / 本地文件替换:
|
||||
# docker build --build-arg CHROME_DEB_URL=https://your-mirror/google-chrome-stable_current_amd64.deb .
|
||||
# 留空则按架构自动取官网地址。
|
||||
ARG CHROME_DEB_URL=
|
||||
# tzdata 让日志时间戳跟随 TZ(默认给上海时区);fonts-noto-cjk 只影响截图观感,
|
||||
# 但缺了它中文在页面里是方块,排查问题时不方便
|
||||
ENV TZ=Asia/Shanghai \
|
||||
DEBIAN_FRONTEND=noninteractive
|
||||
|
||||
# 注意:这段 RUN 里不要夹注释行——Docker 解析续行时可能把注释当成命令的一部分,容易把命令拼断。
|
||||
# 步骤:装基础包 → 按架构下官方 Chrome deb → 用 apt 一次装齐依赖 → 清缓存 → 验证能起来。
|
||||
# procps 提供 ps:运行器启动时靠它找「占着本 profile 的残留浏览器」并收掉(缺了也可跑,自愈会退化)。
|
||||
RUN set -eux; \
|
||||
apt-get update; \
|
||||
apt-get install -y --no-install-recommends \
|
||||
ca-certificates \
|
||||
curl \
|
||||
fonts-liberation \
|
||||
fonts-noto-cjk \
|
||||
gnupg \
|
||||
procps \
|
||||
tzdata \
|
||||
wget; \
|
||||
arch="$(dpkg --print-architecture)"; \
|
||||
case "$arch" in \
|
||||
amd64) chrome_deb="google-chrome-stable_current_amd64.deb" ;; \
|
||||
arm64) chrome_deb="google-chrome-stable_current_arm64.deb" ;; \
|
||||
*) echo "不支持的架构:$arch(可用 amd64 / arm64)" >&2; exit 1 ;; \
|
||||
esac; \
|
||||
chrome_url="${CHROME_DEB_URL:-https://dl.google.com/linux/direct/${chrome_deb}}"; \
|
||||
echo "下载 Chrome:$chrome_url"; \
|
||||
wget -q -O /tmp/chrome.deb "$chrome_url"; \
|
||||
apt-get install -y --no-install-recommends /tmp/chrome.deb; \
|
||||
rm -f /tmp/chrome.deb; \
|
||||
rm -rf /var/lib/apt/lists/*; \
|
||||
dpkg-query -W -f='chrome ${Version}\n' google-chrome-stable; \
|
||||
timeout 60 google-chrome-stable --headless=new --no-sandbox --disable-gpu \
|
||||
--disable-dev-shm-usage --dump-dom about:blank > /dev/null
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
# 依赖层单独缓存:只有 lockfile 变了才重装。
|
||||
# devDependencies 里的 esbuild 是构建注入脚本必需的,所以不能用 --omit=dev;
|
||||
# 留着它也能让使用者在容器里直接 `npm run build`
|
||||
COPY package.json package-lock.json ./
|
||||
RUN npm ci --no-audit --no-fund
|
||||
|
||||
# 业务源码 + 构建脚本 + 无头运行器(node_modules / .run-profile / run-logs / .env 由 .dockerignore 排除)
|
||||
COPY . .
|
||||
|
||||
# 构建注入浏览器用的单文件脚本,并确认产物真的生成了
|
||||
RUN npm run build && test -s yun-xue-tang-assistant.user.js
|
||||
|
||||
# 运行期目录:profile(含登录 cookie)与日志。用命名卷 / 绑定挂载覆盖即可持久化
|
||||
RUN mkdir -p /app/.run-profile /app/run-logs && chmod 700 /app/.run-profile
|
||||
|
||||
COPY docker/entrypoint.sh /usr/local/bin/docker-entrypoint.sh
|
||||
# 用 tr 去掉可能存在的 CR(Windows 上检出后容易带 CRLF,shebang 会变成 /bin/sh\r,exec 直接报 exec format error),
|
||||
# 然后当场用 sh -n 验一遍语法,把问题拦在构建阶段
|
||||
RUN tr -d '\r' < /usr/local/bin/docker-entrypoint.sh > /tmp/ep.sh \
|
||||
&& mv /tmp/ep.sh /usr/local/bin/docker-entrypoint.sh \
|
||||
&& chmod +x /usr/local/bin/docker-entrypoint.sh \
|
||||
&& sh -n /usr/local/bin/docker-entrypoint.sh
|
||||
|
||||
# 容器里没有图形会话,强制无头;面板需要 TTY,后台跑时保持关闭
|
||||
# (`docker run -it -e YUN_XUE_TANG_TUI=1` 可以打开面板)
|
||||
ENV YUN_XUE_TANG_HEADLESS=1 \
|
||||
YUN_XUE_TANG_TUI=0 \
|
||||
YUN_XUE_TANG_PROFILE_DIR=/app/.run-profile \
|
||||
YUN_XUE_TANG_LOG_FILE=/app/run-logs/headless.log \
|
||||
YUN_XUE_TANG_CHROME_BIN=/usr/bin/google-chrome-stable
|
||||
|
||||
# 凭据只走环境变量,不在镜像里 ENV(否则会被写进镜像层):
|
||||
# docker run ... -e YUN_XUE_TANG_USR=账号 -e YUN_XUE_TANG_PWD=密码
|
||||
|
||||
ENTRYPOINT ["/usr/local/bin/docker-entrypoint.sh"]
|
||||
# 默认无参数:入口脚本在「没参数且没填凭据」时自动降级成 --check(只读自检)
|
||||
CMD []
|
||||
@@ -0,0 +1,509 @@
|
||||
# 云学堂助手
|
||||
|
||||
在云学堂(`*.yunxuetang.cn`)上自动登录、按目录顺序听课、自动切节,并在课程列表页逐门推进的
|
||||
Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含考试章节的课程会自动进入考试、
|
||||
不答题直接交卷;一门课学完会自动回列表选下一门。
|
||||
平台按**真实播放时长**计时,脚本只负责「自动点播放、自动切下一节、处理防挂机弹窗」,
|
||||
不快进、不改进度、不伪造学时。
|
||||
|
||||

|
||||
|
||||
## 功能
|
||||
|
||||
| 能力 | 说明 |
|
||||
| --- | --- |
|
||||
| 一键登录 | 面板里填账号密码,自动填充表单、勾选协议、点击登录;支持记住密码与自动登录 |
|
||||
| 顺序听课 | 进入课程(列表刷课或自己点开)后先对齐到「第一个未学完的课时」,从第一章第一节顺序往下学 |
|
||||
| 自动切节 | 本节播完(`video.ended` 或平台倒计时归零)后自动进入下一节,并等平台记账后再继续 |
|
||||
| 完成即跳课 | 平台汇总变成 `已完成学习`、进度 100% 或 `x/y` 满时判定整门课完成,自动回列表选下一门;不会停在已完成页,也不会把播完的视频从头重播 |
|
||||
| 多类型播放页 | 识别 `#/course/play`、`#/video/play`、`#/audio/play`、`#/ppt/play` 等播放页;单视频课程同样自动点「开始学习」 |
|
||||
| 防挂机验证 | 识别「已触发防挂机验证」弹窗并点「继续学习」;滑块/拼图类验证不绕过,提示人工处理 |
|
||||
| 课程列表自动刷课 | 在列表页逐门进入未学完的课程;每完成一门都重新调列表接口拿平台实时状态再选下一门,本次门数上限见下方配置表 |
|
||||
| 短课程优先 | 列表刷课默认按课程总时长**从短到长**选课(跨页),先完成 1 分钟的课再学 1 小时的课;面板可关闭 |
|
||||
| 考试自动空卷 | 含考试章节的课程不再跳过:自动点进考试节 → 开始/继续考试 → 一题不做直接「提交考试」→ 点「确定」交卷,交卷后课程进度被平台记账,课程即可完成;同一门课最多交卷 `maxExamTries` 次,防平台不记账时死循环 |
|
||||
| 不跳过课程 | 没有任何「跳过本课」入口,也不会把某门课加入黑名单;没学完就退避重试(30 秒起翻倍,最长 5 分钟),同一门课最多重试 `maxCourseRetries` 次,超过才停下整轮刷课并提示原因,等人工处理 |
|
||||
| 进度可续 | 学习进度存在 `sessionStorage`(`yun-xue-tang-run-state-v3`),整页跳转/刷新后继续上次的队列和页码;**运行开关不跨会话** —— 浏览器重启、运行器新建标签页后一律回到待机,必须显式开跑(避免未登录就报「运行中」) |
|
||||
| 无头运行 | 在有/无图形界面的机器上都能跑;`runner/` 可自己起无头 Chromium 并注入脚本,适合 Linux 服务器 / Windows 无人值守常驻(见下方「无头运行」) |
|
||||
|
||||
## 安装
|
||||
|
||||
1. 浏览器安装 [Tampermonkey](https://www.tampermonkey.net/)。
|
||||
2. 打开 Tampermonkey 面板 → 添加新脚本 → 粘贴 [`yun-xue-tang-assistant.user.js`](yun-xue-tang-assistant.user.js) 全文 → 保存。
|
||||
3. 打开 <https://kfmic.yunxuetang.cn/login.html>,右下角出现「云学堂助手」面板:
|
||||
- 填账号密码 → 点「一键登录并刷课」,登录后自动进入列表并开始逐门学习;
|
||||
- 或手动登录后,在列表页点「一键刷课」。
|
||||
|
||||
脚本 `@grant none`,不依赖任何本地服务,可独立运行。
|
||||
|
||||
## 配置
|
||||
|
||||
配置项集中在 `src/config.js` 的 `CFG`(改完 `npm run build` 重新打包):
|
||||
|
||||
| 配置项 | 默认 | 作用 |
|
||||
| --- | --- | --- |
|
||||
| `mute` | `true` | 静音播放(自动播放更稳) |
|
||||
| `autoNext` | `true` | 当前课程自动连播:本节结束自动下一节 |
|
||||
| `tickMs` | `2000` | 主循环间隔 |
|
||||
| `startClickCooldownMs` | `3000` | 「开始学习」重复点击冷却:3 秒内没起播就补点 |
|
||||
| `entryGraceMs` | `30000` | 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」 |
|
||||
| `stuckMs` | `5 分钟` | 连续多久没有计时进展就放弃当前课程 |
|
||||
| `maxCourses` | `10` | 本次最多完成多少门;`0` = 不限 |
|
||||
| `maxCourseRetries` | `5` | 同一门课最多重试多少次;超过则停止整轮刷课并提示(不会跳过该课) |
|
||||
| `courseRetryDelayMs` | `30000` | 首次重试前的等待;每次翻倍,最长 5 分钟 |
|
||||
| `alignToFirstIncomplete` | `true` | 进入课程先从第一个未学完的课时学起;`false` = 沿用平台上次位置 |
|
||||
| `preferShortCourses` | `true` | 列表刷课时优先总时长更短的课程(正序);面板勾选框「优先短课程(时长正序)」可随时切换 |
|
||||
| `maxExamTries` | `2` | 同一门课「空卷交卷」的最大次数;超过仍没计入进度就按普通未完成重试(防死循环) |
|
||||
| `examClickCooldownMs` | `1500` | 考试页内两次点击的间隔(毫秒) |
|
||||
|
||||
对齐起点对「一键刷课」和自己点开的课程(需勾选「当前课程自动连播」)都生效,
|
||||
每门课只在进入时对齐一次,之后手动点其它课时不会被拉回。
|
||||
|
||||
短课程优先开启时,列表刷课启动会先读取一次列表接口里的课程总时长(首次约 5–10 秒,
|
||||
结果在当前标签页缓存 5 分钟),把未学完课程按 `studyHours` 正序排队,再跳到目标页
|
||||
逐个进入。接口不可用(未登录、跨域、平台改版)时自动降级为「当前页按时长正序」,
|
||||
再不行就回到原来的列表顺序,不会让刷课任务卡住。
|
||||
|
||||
## 无头运行(Linux / Windows 服务器)
|
||||
|
||||
用 `runner/headless.mjs` 把整套逻辑跑在一个无头 Chromium 里:自己起浏览器、用 CDP 把构建产物
|
||||
注入页面主世界(等价 Tampermonkey `@grant none`),不需要装浏览器插件、不需要桌面环境、
|
||||
不需要 Xvfb。Linux 与 Windows 都支持,macOS 也能跑。
|
||||
|
||||
支持的环境:
|
||||
|
||||
| 环境 | 说明 |
|
||||
| --- | --- |
|
||||
| Linux 服务器 | 机房机器、云主机、容器;root 运行、`/dev/shm` 只有 64MB 都自动适配 |
|
||||
| Docker 容器 | 自带官方 Chrome 与 Node 22,镜像内已完成构建;见下方「容器(Docker)」 |
|
||||
| Windows 桌面 | 后台挂着跑;关掉控制台窗口或 `Ctrl+C` 都能让它收尾 |
|
||||
| Windows 服务器核心版 / 无桌面 | 无交互桌面也能跑(Chromium 无头不需要窗口站) |
|
||||
| Windows 服务 / 计划任务 Session 0 | 会检测到 `SESSIONNAME=Services` 强制无头,`headless: false` 被忽略 |
|
||||
| macOS | 无头可用(本机调试场景) |
|
||||
|
||||
**Linux / macOS:**
|
||||
|
||||
```bash
|
||||
# 1. 依赖(Ubuntu / Debian 为例)
|
||||
sudo apt install -y chromium # 或安装官方包:google-chrome-stable
|
||||
# 2. 构建产物
|
||||
npm install && npm run build
|
||||
# 3. 调参:改 config/runner.config.mjs(maxCourses、budgetMinutes、preferShort…)
|
||||
# 只想临时覆盖就用命令行,例如 npm run headless -- --max-courses 3
|
||||
# 4. 凭据走环境变量(不要写进配置文件)
|
||||
export YUN_XUE_TANG_USR='你的账号'
|
||||
export YUN_XUE_TANG_PWD='你的密码'
|
||||
# 5. 先自检(只读:不登录、不点课程、不改进度)
|
||||
npm run headless:check
|
||||
# 6. 正式跑,前台常驻,Ctrl+C 结束
|
||||
npm run headless
|
||||
```
|
||||
|
||||
Linux 上建议用 `tmux` / `nohup` 托管,因为运行器是**前台进程**(不内置守护模式):
|
||||
|
||||
```bash
|
||||
tmux new -d -s yun-xue-tang 'cd ~/yun-xue-tang-assistant && npm run headless'
|
||||
tmux attach -t yun-xue-tang # 看实时输出
|
||||
tail -f run-logs/headless.log # 也可以直接看日志文件
|
||||
```
|
||||
|
||||
**Windows:**
|
||||
|
||||
```powershell
|
||||
# 1. 浏览器:Chrome 或 Edge 都行(Edge 是 Chromium 内核,同样可用)
|
||||
winget install --id Google.Chrome
|
||||
# 2. 构建产物
|
||||
npm install; npm run 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='你的密码'
|
||||
# 5. 自检 + 正式跑
|
||||
npm run headless:check
|
||||
npm run headless
|
||||
```
|
||||
|
||||
也可以直接双击 [`scripts/start-headless.cmd`](scripts/start-headless.cmd):它会自动构建、检查 Node、跑完后
|
||||
用 `pause` 留住退出码信息(方便看报错)。注意这个批处理文件**只写 ASCII 字符**——中文提示
|
||||
全部由 Node 侧输出,原因见下方常见坑表里的「`'鍏?npm' 不是内部或外部命令`」。
|
||||
|
||||
Windows 上常驻的三种方式:
|
||||
|
||||
```powershell
|
||||
# A. 隐藏窗口后台跑(立刻返回,日志看 run-logs\headless.log)
|
||||
Start-Process -WindowStyle Hidden node -ArgumentList "runner/headless.mjs" -WorkingDirectory $PWD
|
||||
|
||||
# B. 计划任务:登录时自动开始(勾「不管用户是否登录」也能跑,会强制无头)
|
||||
schtasks /create /tn "云学堂助手" /tr "node runner\headless.mjs" /sc onlogon /rl highest
|
||||
|
||||
# C. 只跑一段(例如每天凌晨跑 2 小时):命令行临时覆盖配置
|
||||
npm run headless -- --budget-minutes 120
|
||||
# 或把 budgetMinutes: 120 写进 config/runner.config.mjs,然后直接 npm run headless
|
||||
```
|
||||
|
||||
Windows 上要注意:`Ctrl+C` 会让运行器优雅收尾(暂停视频、停批量、关浏览器)。
|
||||
但如果是在任务管理器里「结束任务」或 `taskkill /F`,进程会被直接终止、收尾代码不会执行;
|
||||
这种情况下次启动时会自动清理残留的浏览器进程与 `lockfile`,不需要手工处理。
|
||||
|
||||
### 终端面板
|
||||
|
||||
在终端里前台运行时(`npm run headless`、`tmux`、SSH 会话),运行器会自动开一块实时面板:
|
||||
|
||||
```text
|
||||
╭ 云学堂助手 · 无头运行器 ─────────────────────────────────────────────────────────╮
|
||||
│ 状态 刷课中 已运行 1:12:01 │
|
||||
│ 课程 2025年安全生产月专题培训课程(第三期) │
|
||||
│ 学时 已学 1:23:45 · 学分 12.75 · 本门 6.52 │
|
||||
│ 课时 第三章 事故应急处置与自救互救 已学 62% │
|
||||
│ 视频 ████████████████████░░░░░░░░░░░░ 62% 13:32/22:00 │
|
||||
│ 进度 本次 3/10 · 累计 17 · 课时数 8 · 等待重试 12s · 倒计时 42s │
|
||||
│ 日志 ./run-logs/headless.log · 已注入 4 次 │
|
||||
├ 最近日志 ────────────────────────────────────────────────────────────────────────┤
|
||||
│ [2024-05-21 09:12:03] [信息] 浏览器就绪:HeadlessChrome/124.0.6367.91 │
|
||||
│ [2024-05-21 09:12:07] [信息] 已注入脚本(第 1 次):…/course/play/xxx │
|
||||
╰──────────────────────────────────────────────────────────────────────────────────╯
|
||||
q 退出(等价 Ctrl+C:暂停视频、停批量、关浏览器)· 完整日志照常写入日志文件
|
||||
```
|
||||
|
||||
- **学习统计**:`学时` 那行给出两个数字——
|
||||
- `已学`:**视频真正在播**的累计时长(排队、重试退避、页面加载都不计;暂停时右侧会标「暂停中,不计时」,好确认面板是活的而不是卡住了);
|
||||
- `学分`:**本次运行里真正刷完**的课程累计能拿到的学分,按课程去重,重试/刷新页面不会重复计。
|
||||
- `本门 6.52` 是当前在刷这门课学完能拿多少分——平台只把这个数字写在倒计时文案里(「还需 2小时 8分钟 可完成本课程学习并获得6.52学分」),学完后文案元素就消失了,所以运行器是边播边记。
|
||||
- 两个数字都只统计本次运行(不落盘、不加 `stats.json`),退出即清零;退出时日志里会多一行「本次学习:视频累计播放 1:23:45,获得 12.75 学分」。
|
||||
- 注意学分口径是「运行器亲眼看到刷完的课」,如果中途 `Ctrl+C` 退出,正在刷的那门课即使已经学了 90% 也不会算进学分(平台只在课程真正完成时才给分)。
|
||||
- **只读**:面板不接收命令,唯一的按键是 `q`(等价 `Ctrl+C`,走同一套优雅退出:暂停视频 → 停批量 → 关浏览器)。`Ctrl+L` 可强制重绘。
|
||||
- **自动降级**:stdout 不是 TTY(重定向到文件、计划任务、`nohup cmd > out.txt`)时自动关闭,回到原来的逐行日志,不会往日志里写 ANSI 控制字符。
|
||||
- **不想用面板**:`--no-tui`(或配置文件 `tui: false`、环境变量 `YUN_XUE_TANG_TUI=0`)。
|
||||
- **不想用颜色**:`--no-color`、配置文件 `color: false` 或 `NO_COLOR=1`;关闭后只剩框线与符号,排版不变。
|
||||
- **完整日志不受影响**:面板只是终端的另一种显示方式,`run-logs/headless.log` 还是纯文本、按时间递增,`tail -f` 照常可看。
|
||||
- **跟随窗口**:面板宽度直接取终端宽度,多宽就画多宽(不再封顶 120 列),每秒重画一次。拖拽窗口或用 `tmux` 分屏时,能收到 `resize` 事件的终端(Linux / macOS / Windows Terminal)去抖 60ms 后立即重排;收到不到的(Windows 传统控制台 `conhost` 拖窗口、最大化,Node 不会发任何事件)由每秒的定时刷新发现尺寸变了、自动重画,最多晚 1 秒。
|
||||
- **变窄 / 还原**时要额外处理一件事:终端会把之前那些更宽的行重新折成多行,旧面板实际占的屏幕行数会比记录的逻辑行数多。运行器按「旧帧在新宽度下会折成几行」来回退光标,而不是数逻辑行;如果折完比整个窗口还高(最大化后还原就是这样),光标退不到块首,只能整屏重置(`Esc[H` + `Esc[2J`)后在顶部重画——代价是上方已经滚出去的历史日志不在屏幕上(但 `run-logs/*.log` 里一直都有一份)。小幅变窄(折完仍装得下窗口)走精确回退,不丢历史。
|
||||
- **宽度不够**时按重要性丢字段,而不是一律打省略号:「进度」先丢倒计时、课时数,「视频」先缩进度条、再丢 `13:32/22:00` 这种时间标——剩下的始终是百分比和「本次/累计」骨架。
|
||||
- **高度不够**时先降级成紧凑模式(不足 15 行省掉课时、日志两行,但**学时行一定保留**),再矮(不足 10 行)连 `q` 提示也省掉,更矮时连日志区一起省。任何时候帧高都不超过窗口,否则会把回滚区里的历史顶掉。
|
||||
|
||||
运行器做的事:
|
||||
|
||||
| 能力 | 说明 |
|
||||
| --- | --- |
|
||||
| 脚本注入 | 每次整页跳转(新 document)后自动补注入,和 Tampermonkey 按 `@match` 重注入等价 |
|
||||
| 持久化登录 | 浏览器 profile 固定到 `./.run-profile`,cookie / localStorage 都留着,重启不用重登 |
|
||||
| 掉登录自动重登 | cookie 失效或被踢回登录页时,用 `YUN_XUE_TANG_USR` / `YUN_XUE_TANG_PWD` 自动登录并接着刷课 |
|
||||
| 崩溃自愈 | CDP 断线、浏览器崩溃、90 秒读不到脚本状态都会重启浏览器,并由看护循环在新会话里显式重新开跑(浏览器重启后 sessionStorage 清空,进度里的「完成书目」会重新从平台接口取) |
|
||||
| 无进展保护 | 连续 30 分钟没有任何进展(`YUN_XUE_TANG_IDLE_RESTART_MINUTES`)时退出,避免无意义挂机 |
|
||||
| 优雅退出 | `Ctrl+C` / `q`(面板里)/ `SIGTERM` 时先 `pauseAllMedia`、停批量、再关浏览器,不留脏状态(Windows 上监听 `SIGINT` / `SIGBREAK` / `SIGHUP`) |
|
||||
| 残留自愈 | 上次被强杀(`kill -9` / 任务管理器「结束任务」)留下的浏览器进程与锁文件,启动时按 profile 目录自动清理,端口不会一直被占 |
|
||||
| 平台适配 | 平台差异集中在 `runner/platform.mjs`:有无图形会话、沙箱参数、进程树收尾、端口排查命令都按系统出 |
|
||||
| 日志 | 同时写终端和 `./run-logs/headless.log`(`YUN_XUE_TANG_LOG_MAX_BYTES` 默认 5MB,超出轮转成 `.1`) |
|
||||
|
||||
### 代码结构
|
||||
|
||||
`runner/` 按职责拆成小模块,入口只有 90 行,改哪块就看哪个文件:
|
||||
|
||||
| 文件 | 行数级别 | 职责 |
|
||||
| --- | --- | --- |
|
||||
| `runner/headless.mjs` | ~130 | 入口:解析参数 → 预检 → 交给 supervisor,只做组装 |
|
||||
| `runner/config.mjs` | ~360 | 三层合并(配置文件 / 环境变量 / 命令行)+ 校验 + `--help`,其它模块只读导出常量 |
|
||||
| `config/runner.config.mjs` | ~50 | **日常调参就改这里**:普通 JS 模块,可写注释,改完不用 build |
|
||||
| `runner/platform.mjs` | ~230 | 平台差异:有无图形会话、沙箱参数、进程树收尾、残留进程清理、排查命令 |
|
||||
| `runner/preflight.mjs` | ~95 | 启动前检查:产物、Node 版本、凭据、浏览器、调试端口(端口被占会先自愈) |
|
||||
| `runner/log.mjs` | ~50 | 终端 + 文件日志,超上限轮转成 `.1` |
|
||||
| `runner/stop.mjs` | ~60 | 终止信号优雅退出(Windows 走 SIGINT/SIGBREAK/SIGHUP) |
|
||||
| `runner/browser.mjs` | ~230 | 浏览器探测、启动参数、陈旧锁与孤儿进程清理 |
|
||||
| `runner/cdp.mjs` | ~90 | 极简 CDP 客户端(Node 22+ 原生 WebSocket,无第三方依赖) |
|
||||
| `runner/page.mjs` | ~155 | 注入后要调用的页面 JS 表达式 + `page.evalJS/json/tryEval` 封装 |
|
||||
| `runner/session.mjs` | ~310 | 单次会话:起浏览器 → 注入 → 自动重登 → 刷课 → 监控 → 收尾 |
|
||||
| `runner/selfcheck.mjs` | ~60 | `--check` 的只读环境自检 |
|
||||
| `runner/tui.mjs` | ~470 | 终端面板:框线布局、进度条、ANSI 宽度对齐、`q` 退出、尺寸自适应、非 TTY 自动关闭 |
|
||||
| `runner/study.mjs` | ~110 | 学习统计:本次跑了多久(只算视频真在播)、拿到多少学分(按课程去重) |
|
||||
| `runner/supervisor.mjs` | ~85 | 崩溃重启循环、退出码与本次学习统计汇总 |
|
||||
|
||||
模块之间是单向依赖(`headless` → `supervisor` → `session` → `page`/`selfcheck` → `cdp`),
|
||||
平台相关的判断全部下沉到 `platform.mjs`(`browser.mjs` 转发它的导出,老代码不用改),
|
||||
没有循环引用,也没有需要打包的步骤:`node runner/headless.mjs` 直接跑多文件 ESM。
|
||||
`tui.mjs` 只单向依赖 `log.mjs`(接管终端输出)与 `study.mjs`(学时/学分累计),
|
||||
所以对它来说 `session.mjs`、`supervisor.mjs` 都是「可选调用方」——面板关了也不会影响它们任何逻辑。
|
||||
`study.mjs` 不读终端也不读浏览器(只吃快照 + 一个可替换的时钟),所以能脱离两者直接用假时钟测。
|
||||
改脚本内部 API(`window.__yunXueTangAuto` 上的方法)只需要动 `runner/page.mjs`。
|
||||
|
||||
命令行参数(**日常改配置文件就行**;这里的开关只是临时覆盖,适合写进 `tmux` 命令或 `~/.bashrc`):
|
||||
|
||||
优先级:**内置默认值 < `config/runner.config.mjs` < 环境变量 `YUN_XUE_TANG_*` < 命令行参数**。
|
||||
|
||||
| 参数 | 环境变量 | 配置文件字段 | 默认 | 作用 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `--check` | — | (不支持) | 关 | 只做环境自检:浏览器能启动、页面能打开、脚本能注入、视频编解码可用;不登录、不动进度,通过则退出码 0 |
|
||||
| `--max-courses N`(旧名 `--max`) | `YUN_XUE_TANG_MAX_COURSES` | `maxCourses` | `10` | 本次最多完成 N 门课,`0` = 不限 |
|
||||
| `--budget-minutes N`(旧名 `--budget`) | `YUN_XUE_TANG_BUDGET_MINUTES` | `budgetMinutes` | `0` | 运行 N 分钟后收尾退出(适合放进 cron 定长跑) |
|
||||
| `--restart-minutes N`(旧名 `--restart`) | `YUN_XUE_TANG_RESTART_MINUTES` | `restartMinutes` | `0` | 脚本自己停下后等待多少分钟再开新一轮;`0` = 直接退出 |
|
||||
| `--idle-restart-minutes N`(旧名 `--idle`) | `YUN_XUE_TANG_IDLE_RESTART_MINUTES` | `idleRestartMinutes` | `30` | 连续多少分钟无进展判定卡死 |
|
||||
| `--prefer-short 0\|1` | `YUN_XUE_TANG_PREFER_SHORT` | `preferShort` | `1` | 是否优先短课程(时长正序) |
|
||||
| `--headless 0\|1`(旧名 `--visible`) | `YUN_XUE_TANG_HEADLESS` | `headless` | `1` | `1` = 无头;`0` = 开有界面浏览器(仅本机调试;无图形会话时被忽略并强制无头) |
|
||||
| `--origin URL` | `YUN_XUE_TANG_ORIGIN` | `origin` | `https://kfmic.yunxuetang.cn` | 站点根地址(换分公司环境时改这个) |
|
||||
| `--url URL` | `YUN_XUE_TANG_URL` | `url` | `<origin>/login.html` | 起始页面 |
|
||||
| `--port N` | `YUN_XUE_TANG_CDP_PORT` | `port` | `9336` | CDP 调试端口,同机多实例时分开 |
|
||||
| `--profile DIR` | `YUN_XUE_TANG_PROFILE_DIR` | `profile` | `./.run-profile` | 持久化 profile 目录,删掉即重置登录态与进度缓存 |
|
||||
| `--chrome PATH` | `YUN_XUE_TANG_CHROME_BIN` | `chrome` | 自动探测 | 指定 Chrome/Chromium 可执行文件 |
|
||||
| `--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` | 单文件上限,超出轮转 |
|
||||
| `--no-tui` | `YUN_XUE_TANG_TUI` | `tui` | 开 | `1`/`0`,是否在终端显示实时面板;stdout 不是 TTY 时自动关闭 |
|
||||
| `--no-color` | `YUN_XUE_TANG_COLOR` | `color` | 开 | `1`/`0`,面板是否带 ANSI 颜色(也认 `NO_COLOR`) |
|
||||
| `--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` | **不写入配置文件** | 必填 | 账号密码。故意只走环境变量:命令行会进进程列表/计划任务历史 |
|
||||
|
||||
未知参数、缺值参数、非数字值都会**直接报错并以退出码 2 退出**(不再静默忽略,避免 `--prefer-short` 拼错却以为生效了)。
|
||||
|
||||
### 配置文件
|
||||
|
||||
日常调参改 `config/runner.config.mjs` 即可,它是普通 JS 模块(可写注释、可写表达式),
|
||||
改完**不需要 `npm run build`**(构建只打包注入浏览器的 `src/`):
|
||||
|
||||
```js
|
||||
// config/runner.config.mjs
|
||||
export default {
|
||||
maxCourses: 0, // 0 = 不限,一直刷到没有未学完的课
|
||||
budgetMinutes: 0, // 0 = 不限运行时长
|
||||
preferShort: true, // 时长正序选课
|
||||
restartMinutes: 0, // 0 = 停下就退出
|
||||
idleRestartMinutes: 30,
|
||||
port: 9336,
|
||||
profile: './.run-profile',
|
||||
logFile: './run-logs/headless.log',
|
||||
tui: true, // 终端面板;false = 逐行日志
|
||||
color: true, // 面板颜色;false 或不设 NO_COLOR 都可
|
||||
};
|
||||
```
|
||||
|
||||
- 想看全部字段与当前生效值:`node runner/headless.mjs --help`
|
||||
- 想只为一个场景换配置:`node runner/headless.mjs --config ./my.mjs`
|
||||
- 个人机器的差异建议放 `runner.local.mjs`(已在 `.gitignore` 里)并用 `--config ./runner.local.mjs`
|
||||
- 配置文件里写 `username` / `password` 会被**忽略并告警**(凭据只认环境变量);写未知字段也会告警
|
||||
|
||||
退出码:`0` 正常收尾(达到 `maxCourses` / `budgetMinutes` / 无更多可学课程)、`1` 无进展卡死、
|
||||
`2` 环境或参数问题(缺构建产物、缺凭据、找不到浏览器、端口被占、参数写错)、`3` 连续 5 次登录失败(见 runner/)
|
||||
(多半是密码错误或站点要求验证码)。
|
||||
|
||||
无图形环境常见的坑:
|
||||
|
||||
| 现象 | 平台 | 原因与处理 |
|
||||
| --- | --- | --- |
|
||||
| 启动报 `Missing X server or $DISPLAY` | Linux | 有界面模式需要显示服务。运行器已自动判断:无 `DISPLAY` 强制无头 |
|
||||
| `Running as root without --no-sandbox is not supported` | Linux | 运行器在 Linux 上默认加 `--no-sandbox --disable-setuid-sandbox` |
|
||||
| 标签页莫名崩溃 / `Target closed` | Linux 容器 | `/dev/shm` 太小(默认 64MB)。运行器自动加 `--disable-dev-shm-usage` |
|
||||
| 中文显示成方块 | Linux | 只影响截图观感(脚本靠 DOM 文本匹配,不依赖字体)。需要截图时 `apt install fonts-noto-cjk` |
|
||||
| 视频一直 0 秒、`error.code=4` | 全平台 | 该 Chromium 不带 H.264/AAC 专有编解码器。Linux 上改装 `google-chrome-stable`(官方包带);Windows 上用官方 Chrome/Edge 即可。`npm run headless:check` 会直接告诉你 |
|
||||
| 登录页自动登录失败 | 全平台 | 站点要求验证码/滑块时无头环境无法完成,需要人工在 `headless: false`(有界面)模式下登录一次,之后靠持久化 profile 的 cookie |
|
||||
| 端口被占 | 全平台 | 运行器会先清理「命令行带本 profile」的残留浏览器(自愈);仍被别的程序占用时按提示换 `--port`。提示命令按平台出:Linux `pkill -f "remote-debugging-port=9336"`,Windows `netstat -ano \| findstr :9336` + `taskkill /PID <PID> /T /F` |
|
||||
| `"无法创建数据目录"` / `配置文件正在使用中` | Windows | 上次浏览器被强杀后 profile 还锁着。运行器启动时会自动清理;也可手动删掉 `.run-profile`(会丢失登录态) |
|
||||
| `Ctrl+C` 后浏览器没关 | Windows | 用了任务管理器「结束任务」/ `taskkill /F` 时收尾代码不执行(TerminateProcess)。下次启动会自动清理残留进程 |
|
||||
| 面板显示错行 / 有残留字符 | 全平台 | 终端被非运行器输出(后台脚本、`echo`、另一个进程)插话会打乱面板,按 `Ctrl+L` 重绘一次即可;或用 `--no-tui` 退回逐行日志 |
|
||||
| 计划任务里一起床就退出 | Windows | 运行在 Session 0 没有桌面。运行器检测 `SESSIONNAME=Services` 后强制无头,正常;若仍失败看 `run-logs/headless.log` |
|
||||
| `'鍏?npm' 不是内部或外部命令` / `'01' 不是内部或外部命令` / `'rofile' 不是内部或外部命令` | Windows | 批处理文件里出现了**中文(非 ASCII)字符**或**裸 LF 行尾**。cmd.exe 按当前代码页逐字节读批处理,多字节字符和 LF 都会让行偏移错位,于是把一行拆成几段当命令执行。修法:`.cmd` 只用 ASCII 且必须 CRLF。`npm run check` 会直接拦下这类文件 |
|
||||
|
||||
### 容器(Docker)
|
||||
|
||||
仓库自带 `Dockerfile` / `docker-compose.yml` / `.dockerignore`,镜像里已经装好
|
||||
Node 22 与 **官方 google-chrome-stable**(不是发行版 chromium —— 后者不带 H.264/AAC,
|
||||
课程视频会一直停在 0 秒),并在构建阶段跑完 `npm run build`,所以镜像开箱即用。
|
||||
|
||||
```bash
|
||||
# 1. 构建(首次约 3-5 分钟,主要是下 Chrome 的 deb)
|
||||
docker build -t yun-xue-tang-assistant .
|
||||
|
||||
# 2. 先自检:只读,不登录、不动进度,不需要账号
|
||||
docker run --rm yun-xue-tang-assistant --check
|
||||
|
||||
# 3. 正式刷课(凭据只走环境变量,别写进镜像)
|
||||
docker run -d --name yun-xue-tang \
|
||||
-e YUN_XUE_TANG_USR='你的账号' \
|
||||
-e YUN_XUE_TANG_PWD='你的密码' \
|
||||
-e YUN_XUE_TANG_MAX_COURSES=100 \
|
||||
-v "$PWD/.run-profile:/app/.run-profile" \
|
||||
-v "$PWD/run-logs:/app/run-logs" \
|
||||
--shm-size=512m \
|
||||
--restart on-failure:3 \
|
||||
yun-xue-tang-assistant
|
||||
|
||||
# 4. 看日志 / 收尾
|
||||
docker logs -f yun-xue-tang # 或 tail -f run-logs/headless.log
|
||||
docker stop yun-xue-tang # SIGTERM → 暂停视频 → 停批量 → 关浏览器
|
||||
```
|
||||
|
||||
用 `docker compose` 更省事(账号写在 `.env` 里,`.env` 已在 `.gitignore`):
|
||||
|
||||
```bash
|
||||
cp .env.example .env # 填 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD
|
||||
docker compose build
|
||||
docker compose run --rm yun-xue-tang --check # 自检
|
||||
docker compose run --rm yun-xue-tang --max-courses 3 # 只刷 3 门,跑完就退
|
||||
docker compose up -d # 常驻
|
||||
docker compose logs -f
|
||||
docker compose down
|
||||
```
|
||||
|
||||
需要注意的几点:
|
||||
|
||||
| 事项 | 说明 |
|
||||
| --- | --- |
|
||||
| 挂载目录 | `/app/.run-profile`(登录 cookie,**别提交**)与 `/app/run-logs`(日志)要挂出来,否则重建容器就等于重登 + 丢日志 |
|
||||
| 卷权限 | 容器内以 root 跑。用绑定挂载时宿主机目录会被写成 root 所有;想用自己的 UID 就在 compose 里加 `user: "${UID}:${GID}"`(运行器会据此自动降级沙箱参数) |
|
||||
| `/dev/shm` | 容器默认只有 64MB,`shm_size: 512m` 更稳(运行器本身也加了 `--disable-dev-shm-usage` 兜底) |
|
||||
| 沙箱 | 容器内 Chrome 沙箱受限,运行器检测到 root/容器会自动补 `--no-sandbox --disable-setuid-sandbox`,不用手写 |
|
||||
| 终端面板 | 面板要求 stdout 是 TTY,后台容器里自动关闭、退回逐行日志。想在 `docker run -it` 里看面板:`docker run -it -e YUN_XUE_TANG_TUI=1 …` |
|
||||
| 验证码 | 首个登录若被要求验证码/滑块,无头环境无法完成:先在宿主机用 `npm run headless -- --headless 0` 有界面登录一次,再把宿主机 `.run-profile` 目录挂进容器复用 cookie |
|
||||
| 时区 | 镜像默认 `TZ=Asia/Shanghai`,日志时间戳与之对齐;要改就用 `-e TZ=...` |
|
||||
| 退出码与重启策略 | 与裸机一致:`0` 正常收尾、`1` 无进展、`2` 环境/参数问题、`3` 连续登录失败。**别用 `--restart always / unless-stopped`**:它们不看退出码,刷完课(`0`)会自动重启再来一轮,形成热循环;用 `--restart on-failure:3` 这类只在失败时重试的策略 |
|
||||
| 缺凭据 | 入口脚本在**没传参数且没填凭据**时自动降级成 `--check`,避免容器无意义重启空转 |
|
||||
| Chrome 下载失败 | 国内机器常从 dl.google.com 下不动,用构建参数换镜像源:`docker build --build-arg CHROME_DEB_URL=https://你的镜像/google-chrome-stable_current_amd64.deb .` |
|
||||
| 镜像内容 | 构建阶段已跑 `npm ci` + `npm run build`,产物 `/app/yun-xue-tang-assistant.user.js` 在镜像里;`node_modules` / `.run-profile` / `run-logs` / `.env` 由 `.dockerignore` 排除在外 |
|
||||
|
||||
Linux 上不需要 Xvfb,但如果你确实想跑有界面模式(例如远程看面板、人工过验证码),
|
||||
可以 `apt install xvfb x11vnc` 后 `xvfb-run -s "-screen 0 1360x940x24" npm run headless -- --headless 0`。
|
||||
|
||||
## 开发热加载
|
||||
|
||||
源码已拆分为 `src/` 下的多个模块,构建后合成单文件脚本。改完保存即生效,不用复制粘贴、不用刷新页面。详见 [dev/README.md](dev/README.md)。
|
||||
|
||||
```powershell
|
||||
npm install # 首次需要(安装 esbuild)
|
||||
npm run build # 打包 src/ → yun-xue-tang-assistant.user.js
|
||||
npm run build:watch # 监听 src/,保存即自动重新打包
|
||||
npm run dev # 等价于 node dev/serve.mjs,默认 127.0.0.1:8899
|
||||
```
|
||||
|
||||
Windows 下也可以直接双击 [`scripts/start-dev.cmd`](scripts/start-dev.cmd)。脚本暴露 `window.__yunXueTangDispose()`,
|
||||
加载器在注入新版本前先释放旧实例(定时器、监听器、面板),因此视频播放不会被打断。
|
||||
|
||||
## 目录结构
|
||||
|
||||
```text
|
||||
README.md 说明文档(本文件)
|
||||
package.json / package-lock.json npm scripts 与依赖锁(唯一依赖:esbuild)
|
||||
.gitattributes / .gitignore 换行符与忽略规则
|
||||
Dockerfile 容器镜像:Node 22 + 官方 Chrome,构建期完成 npm run build
|
||||
docker-compose.yml 一键构建 / 自检 / 常驻(挂载 profile、日志,限制 shm 与日志大小)
|
||||
.dockerignore 镜像上下文排除 node_modules / .run-profile / run-logs / docs
|
||||
docker/
|
||||
entrypoint.sh 容器入口:建目录 → 无凭据时降级 --check → exec 运行器
|
||||
yun-xue-tang-assistant.user.js 构建产物(唯一需要安装的文件,不要手改)
|
||||
src/ 业务脚本源码(拆成多个模块,日常改这里)
|
||||
meta.js UserScript 头 + 用法注释
|
||||
config.js CFG / 常量 / VERSION
|
||||
lifecycle.js 定时器·监听器·dispose
|
||||
utils.js DOM 工具
|
||||
state.js S / R / 持久化
|
||||
panel.js 悬浮面板
|
||||
route.js 路由识别
|
||||
login.js 登录 / 一键刷课
|
||||
list.js 列表页 + 短课程优先
|
||||
player.js 播放器 / 防挂机 / 课时切换
|
||||
exam.js 考试自动空卷交卷
|
||||
course.js 课程页主循环
|
||||
complete.js 完成 / 未完成重试
|
||||
index.js 主循环 / 启动 / 调试入口
|
||||
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
|
||||
platform.mjs 平台差异(图形会话、沙箱、进程树、残留清理、排查命令)
|
||||
preflight.mjs 启动前检查(产物 / Node / 凭据 / 浏览器 / 端口)
|
||||
log.mjs 终端 + 文件日志
|
||||
stop.mjs 终止信号优雅退出
|
||||
browser.mjs 浏览器探测、启动参数、陈旧锁与孤儿进程清理
|
||||
cdp.mjs 极简 CDP 客户端(Node 22+ 原生 WebSocket)
|
||||
page.mjs 页面求值封装与注入后调用的表达式
|
||||
session.mjs 单次会话:起浏览器 / 注入 / 自动重登 / 崩溃自愈
|
||||
selfcheck.mjs --check 只读环境自检
|
||||
tui.mjs 终端面板(框线 + 进度条,q 退出,非 TTY 自动关闭)
|
||||
study.mjs 学习统计(本次播放时长 / 获得学分)
|
||||
supervisor.mjs 崩溃重启循环与退出码
|
||||
config/
|
||||
runner.config.mjs 无头运行器配置(日常调参改这里,不用 build)
|
||||
.env.example 账号环境变量模板(复制成 .env 后填;.env 不入库)
|
||||
dev/ 本地热加载开发工具(HTTP 服务 + 薄加载器)
|
||||
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 持续跑:跨章节 / 跨课程 / 断线重启
|
||||
tui-test.mjs 终端面板自测(不用浏览器:列宽 / 截断 / 极端尺寸)
|
||||
study-test.mjs 学习统计自测(假时钟:暂停不计时 / 防重复计分)
|
||||
docs/
|
||||
reports/ 历史实跑报告
|
||||
run-report-v203.md 2026-10-19 实跑报告(v2.0.3)
|
||||
evidence/ 当前版本的证据(叙述 + 接口日志)
|
||||
archive/v2.0-snapshots/ v2.0.x 时期的原始抓取片段(仅存档)
|
||||
screenshots/ 手工挑选的展示截图(测试自动截图不进库)
|
||||
```
|
||||
|
||||
## 本机数据
|
||||
|
||||
本机数据分三层存放,按「这条信息跨会话是否还成立」区分:
|
||||
|
||||
| `localStorage` 键(用户偏好,跨会话有效) | 内容 |
|
||||
| --- | --- |
|
||||
| `yun-xue-tang-login-v1` | 勾选「记住密码」时的账号密码(base64 混淆,**不是加密**) |
|
||||
| `yun-xue-tang-auto-play-enabled` | 「当前课程自动连播」开关 |
|
||||
| `yun-xue-tang-prefer-short` | 「优先短课程(时长正序)」开关(`1` / `0`) |
|
||||
| `yun-xue-tang-target-catalog-url` | 目标目录 URL:决定刷哪个学院/目录的课(短课程队列的缓存键也来自它) |
|
||||
| `yun-xue-tang-auto-start-after-login` | 登录后自动开始刷课的一次性标记(5 分钟内有效) |
|
||||
|
||||
| `sessionStorage` 键(本次运行,关掉标签页即清空) | 内容 |
|
||||
| --- | --- |
|
||||
| `yun-xue-tang-run-state-v3` | 本轮是否在跑、页码、当前课程、本轮已完成与待重试记录 |
|
||||
| `yun-xue-tang-short-catalog-v1` | 短课程时长队列缓存(TTL 5 分钟) |
|
||||
|
||||
旧版本(v2.8.0 之前)把所有状态整块存在 `localStorage` 的 `yun-xue-tang-batch-v2` 里,
|
||||
包括「是否在跑」。现在这个键只在启动时做一次性迁移:只迁进度(已完成书目、
|
||||
待重试、页码、目标目录),**不再恢复运行状态与当前课程**,迁移完即删除。
|
||||
|
||||
无头运行时这些键存在 `./.run-profile/` 下的浏览器 profile 里(不在仓库、不入库),
|
||||
删掉该目录即等于「清空登录态 + 重置进度」。
|
||||
|
||||
公用电脑请不要勾选「记住密码」;面板上的「清除密码」可随时删除本机保存的凭据。
|
||||
|
||||
## 已知限制
|
||||
|
||||
- 平台按真实播放时长计时,倍速/快进不会减少所需时间;脚本不提供这类加速。
|
||||
- 直接改 URL 或刷新课程页时,脚本优先用 URL 里的 `kngId` 校验课程;只有 URL 没有 id、
|
||||
且页面标题超过 30 秒仍是 `loading...` 时才可能误判并回到列表。从列表正常进入不受影响。
|
||||
- 验证码、滑块、拼图类验证需要人工完成,脚本不会绕过。
|
||||
- 平台存在同名课程(同一门课出现在多个目录)。脚本按课程 id 精确点击,但完成/重试记录仍沿用
|
||||
按标题去重的旧逻辑,同名课程不会重复安排。
|
||||
- 平台改版(目录结构、弹窗、倒计时文案、列表接口字段、完成文案变化)可能导致识别失败,
|
||||
需要更新选择器/完成判定。
|
||||
|
||||
## 免责声明
|
||||
|
||||
本项目仅用于个人学习自动化实践。请遵守所在单位与平台的使用规定,是否使用及由此产生的后果由使用者自行承担。
|
||||
|
||||
## 实跑记录
|
||||
|
||||
真实站点(`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 修复「进入课程不从第一个未学完的课时开始」的定位过程、复刻用例与修复前后对比,
|
||||
见 [`docs/evidence/align-start-evidence.txt`](docs/evidence/align-start-evidence.txt)。
|
||||
|
||||
v2.6.0 新增「优先短课程(时长正序)」:真实站点读取 5148 门课程、跨页跳到最短课程所在页的
|
||||
实跑记录与 3 个回归用例,见 [`docs/evidence/short-course-evidence.txt`](docs/evidence/short-course-evidence.txt);
|
||||
面板效果见 [`docs/screenshots/panel-short.png`](docs/screenshots/panel-short.png)。
|
||||
|
||||
v2.8.0 状态分层重构:刷课开关不再进 localStorage(修「还没登录就开始刷课」)、字段名语义化、
|
||||
短课程模式下页码导航所有权归一到 `chooseShortCourse`(省掉每次多跳一页+白等 3.5 秒)。
|
||||
|
||||
v2.7.0 修复「进入课程有概率不自动播放」和「学完后不转下一门」:新增单视频/音频/课件播放页识别,
|
||||
完成判定同时支持 `已完成 x/y`、`已完成 N%`、`已完成学习`;真机复现、修复前后对比与回归结果见
|
||||
[`docs/evidence/completion-next-evidence.txt`](docs/evidence/completion-next-evidence.txt)。
|
||||
|
||||
无头运行(Linux 服务器 / Windows 无人值守):新增 `runner/`,自己起无头 Chromium + CDP 注入,
|
||||
持久化登录、掉登录自动重登、崩溃自愈;环境自检、真实刷课、断线重启、优雅退出的实跑记录见
|
||||
[`docs/evidence/headless-linux-evidence.txt`](docs/evidence/headless-linux-evidence.txt),
|
||||
平台差异与 Windows 侧适配见其中「九、跨平台适配」一节。
|
||||
@@ -0,0 +1,55 @@
|
||||
/**
|
||||
* 无头运行器配置文件(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: 100,
|
||||
/** 运行多少分钟后收尾退出;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,
|
||||
|
||||
// ---------- 终端面板 ----------
|
||||
/** 终端里显示实时面板(框线 + 进度条);false = 回到逐行日志。非 TTY(重定向/计划任务)时自动关闭 */
|
||||
tui: true,
|
||||
/** 面板是否带 ANSI 颜色;false = 只用框线和符号。也认 NO_COLOR 环境变量 */
|
||||
color: true,
|
||||
};
|
||||
+167
@@ -0,0 +1,167 @@
|
||||
# 开发热加载(保存即生效)
|
||||
|
||||
目标:在编辑器里改 `src/` 下的源码模块,保存后自动重新打包,浏览器里的脚本自动换成新版本,
|
||||
**不用复制粘贴、不用重装、不用刷新页面**。
|
||||
|
||||
## 结构
|
||||
|
||||
`dev/` 只放「在浏览器里跑」的开发工具(HTTP 服务 + 薄加载器 + 真机测试),
|
||||
构建与检查脚本在 `../scripts/`,运行器配置在 `../config/`。
|
||||
|
||||
| 文件 | 作用 |
|
||||
| --- | --- |
|
||||
| `../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 里的薄加载器,轮询版本、释放旧实例、注入新实例 |
|
||||
| `tests/` | 测试脚本(真机测试 + 终端面板纯函数测试,见下方「真机测试」) |
|
||||
| `../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>` 形式注入页面主世界。
|
||||
因为脚本依赖页面里的 `__vue__`(登录组件),注入必须发生在主世界,不能走普通沙箱。
|
||||
|
||||
## 一次性安装
|
||||
|
||||
1. 双击 `scripts/start-dev.cmd` 启动本地服务(保持窗口开着)。
|
||||
2. 浏览器打开 <http://127.0.0.1:8899/>,点「安装 / 更新热加载器」,Tampermonkey 弹窗确认安装。
|
||||
> 手动方式:Tampermonkey 面板 → 添加新脚本 → 粘贴 `dev/dev-loader.user.js` 全文 → 保存。
|
||||
3. **停用或删除** Tampermonkey 里原来那份「云学堂助手」完整脚本。
|
||||
(两份同时跑会出现两个面板、双份定时器,行为会乱。)
|
||||
4. 打开 <https://kfmic.yunxuetang.cn/login.html>,F12 控制台应看到:
|
||||
`[云学堂·热加载] 已注入 xxxxx 字节源码`。
|
||||
|
||||
## 日常使用
|
||||
|
||||
- 改完 `src/` 下的模块保存 → `npm run build:watch` 自动重新打包,约 1 秒内页面控制台打印
|
||||
`[云学堂·热加载] 热更新 → <新哈希>`,面板会重建,视频播放不中断。
|
||||
- 列表刷课的进度存在 `localStorage`(`yun-xue-tang-batch-v2`),热替换 / 刷新都不会丢。
|
||||
- 改坏了(语法错误):构建失败,加载器会拒绝注入并弹出左下角红条提示,**旧版本继续运行**,修好再保存即可。
|
||||
- 想完全回到「手动刷新才生效」:把加载器里的 `MODE` 改成 `'reload'`。
|
||||
|
||||
## 真机测试
|
||||
|
||||
在**真实浏览器 + 真实云学堂页面**上验证脚本,不靠 Node 里的 DOM 桩。
|
||||
|
||||
```bash
|
||||
npm run build # 先出产物
|
||||
npm run test:real # 有界面 Chrome,能看见面板真实渲染
|
||||
npm run test:real:headless # 无头模式(CI / 无人值守)
|
||||
node dev/tests/real-test.mjs --keep # 跑完不关浏览器,便于人工复核
|
||||
```
|
||||
|
||||
### 终端面板自测(不用浏览器)
|
||||
|
||||
`runner/tui.mjs` 有个不联网、不开浏览器的纯函数测试;`runner/study.mjs` 的学时/学分累计也有一份(带假时钟):
|
||||
|
||||
```bash
|
||||
npm run test:tui # 面板渲染 / 列宽 / 尺寸自适应
|
||||
npm run test:study # 学习时长与学分累计口径
|
||||
```
|
||||
|
||||
它用假 stdout 渲染真实帧,逐行量列宽,重点盯五件容易错的事:
|
||||
- 中文/全角/emoji 占 2 列,ANSI 转义序列占 0 列(算错边框就歪、中文被劈成半个);
|
||||
- 截断到指定列宽时要补 `\x1b[0m`,否则颜色会溢出到下几行;
|
||||
- 尺寸自适应:宽度直接跟终端(240 列终端框线就是 240),从 40 行到 8 行的每种高度都不超出窗口,矮到 15 行时自动省掉课时/日志行但仍保留学时与视频进度;
|
||||
- 没有 `resize` 事件的平台(Windows 传统控制台):完全不发事件也能在定时刷新里发现尺寸变化,最大化后框线跟着变宽、缩小后自动清整块重画(不会把旧帧的尾巴留在屏上),尺寸没变时不多做一次清屏;
|
||||
- 折行感知的回退:终端变窄时会把宽行重排成多行,所以按「旧帧在新宽度下的可视行数」算回退步数;如果折完比窗口还高(最大化后还原)就整屏重置(`Esc[H` + `Esc[2J`),否则旧面板的上半截会永远留在屏幕上;小幅变窄(折完仍装得下)走精确回退,不丢上方历史;
|
||||
- 36 列窄终端 / 8 行矮终端下不崩、不超界;缩窗(100×24 → 60×12)后硬重绘的回退步数受新窗口高限制,不会把上面历史顶出屏幕;
|
||||
- 学时/学分累计:暂停时不计时、播放中按两帧间隔累加、倒计时元素消失后沿用学分缓存、完成数没变不重复计分、换课后重新读分。
|
||||
|
||||
`study-test.mjs` 用假时钟(不依赖真实时间)把口径钉死:
|
||||
- 暂停 30 秒一点都不计、
|
||||
- 两帧间隔超过 60 秒(浏览器重启 / 进程挂起)直接丢弃不补计、
|
||||
- 同一门课重复完成不重复计分、没读到学分的课完成后不瞎加分、
|
||||
- `0.1 + 0.2` 这种浮点累加输出成 `0.3` 而不是 `0.30000000000000004`。
|
||||
|
||||
另外还断言了「禁用时是空操作」(上层可以无条件调 `tui.set()`)和
|
||||
「`finish()` 只生效一次且会恢复光标」。改面板布局后先跑这个,比真机跑一轮快得多。
|
||||
|
||||
三个真机脚本(`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 后台里跑。平台判断复用
|
||||
`runner/platform.mjs`,不在这里重复实现。
|
||||
|
||||
> 想在生产环境长期无头挂机(持久化登录、掉登录自动重登、崩溃自愈),用 `runner/headless.mjs`,
|
||||
> 见主 README 的「无头运行(Linux / Windows 服务器)」。
|
||||
|
||||
原理:用独立临时用户目录启动 Chrome(不影响日常配置),开 CDP 端口后新建标签页打开
|
||||
`https://kfmic.yunxuetang.cn/login.html`,把 `yun-xue-tang-assistant.user.js` 注入页面主世界
|
||||
(等价 Tampermonkey `@grant none`),然后在真实 DOM 上断言:
|
||||
|
||||
| 断言 | 说明 |
|
||||
| --- | --- |
|
||||
| 面板渲染 | `#yun-xue-tang-panel` 可见、`position:fixed`、距右下各 16px、含密码框与 4 个按钮 |
|
||||
| 版本号 | `#yun-xue-tang-version` = `v2.7.0`(与 package.json 一致) |
|
||||
| 页面识别 | 真实登录页 `isLoginPage() === true`、`readSummary/readCountdown` 安全返回 `null` |
|
||||
| 点击不崩 | 真点「一键登录并刷课」后脚本仍存活、无自身 error 日志 |
|
||||
| 持久化 | 真实 `localStorage` 可读写 |
|
||||
| 热替换 | `__yunXueTangDispose()` 后真实 DOM 面板移除、`__yunXueTangAuto` 被删;再注入面板唯一 |
|
||||
| 路由 | SPA 内改 `location.hash` 后 `route()` 自动跟随,无需重新注入 |
|
||||
| 整页重定向 | 未登录访问 `#/list` 被站点跳回登录页(新 document),脚本无残留、重注入后正常 |
|
||||
|
||||
产物:截图存到 `.run-tmp/screenshots/real-chrome-login.png`(测试产物不入库,`--shotdir` / `YUN_XUE_TANG_SHOT_DIR` 可改)。
|
||||
|
||||
需要 Node 22+(全局 `WebSocket` / `fetch`),无需 puppeteer / playwright。
|
||||
测试**只读**:不填账号密码、不点登录、不改线上数据。
|
||||
|
||||
## 真机登录 / 进课测试(E2E)
|
||||
|
||||
带**真实账号**跑完整媒体链路。凭据从环境变量读,不写进代码、不打印明文:
|
||||
|
||||
```bash
|
||||
# 环境变量(已在当前环境配置)
|
||||
# YUN_XUE_TANG_USR 员工邮箱 / 账号
|
||||
# YUN_XUE_TANG_PWD 密码
|
||||
|
||||
npm run test:e2e # 登录 + 列表;默认只读,不碰学习进度
|
||||
npm run test:e2e:play # 额外进入最短的未学完课程,采样 25 秒后立即暂停
|
||||
npm run test:e2e:play -- --seconds 60
|
||||
node dev/tests/real-e2e.mjs --headless # 无头
|
||||
node dev/tests/real-e2e.mjs --keep # 跑完不关浏览器
|
||||
```
|
||||
|
||||
覆盖的断言(`--play` 时是 19 项,否则 12 项):
|
||||
|
||||
| 阶段 | 断言 |
|
||||
| --- | --- |
|
||||
| 登录页 | 脚本注入、识别到账号/密码框、`setNativeValue` 写入真实输入框值一致、隐私政策勾选 |
|
||||
| 登录 | 真点「一键登录并刷课」后**真正登录成功**(离开登录页);无脚本 error |
|
||||
| 新 document | 登录是整页跳转,模拟 Tampermonkey 按 `@match` 重新注入后面板恢复 |
|
||||
| 列表 | 16 张卡片(共 322 页)、`scanCards` 标题/状态解析、Vue 组件 `kngListData` 可读、`studyHours` 时长可用 |
|
||||
| 进课(`--play`)| 挑**最短的未学完课程**进入(减少对真实进度影响)、`readSummary`/`readCountdown`/`lessonItems` 读到真实数据 |
|
||||
| 播放(`--play`)| 真实 `<video>` 被接管:`muted=true`、`playbackRate=1`、`paused=false`、`currentTime` 真实推进 |
|
||||
| 收尾 | 立即 `pauseAllMedia` + `S.batchRunning=false`,`__yunXueTangDispose()` 后面板/API 清理干净 |
|
||||
|
||||
行为与安全:
|
||||
- 不加 `--play` 时会在登录成功后**立即停用列表刷课**(清 `yun-xue-tang-auto-start-after-login`、`S.batchRunning=false`),
|
||||
避免在真实账号上意外推进课程。
|
||||
- 加 `--play` 只采样默认 25 秒就暂停并释放,不会把整节课刷完;结束时会打印进度快照(如
|
||||
`进入前「已完成2/3」→ 采样后「已完成2/3」`)便于核对是否被改动。
|
||||
- 实测:进课 `2025坚持的力量`(273s 的第 3 节)采样 25 秒,`currentTime` 推进到 63s,进度保持 `2/3` 未变。
|
||||
|
||||
> 登录后收集的日志里会出现一条 `填写账号密码后,点「一键登录并刷课」`,这是
|
||||
> `loginPageTick` 轮询刷新状态文案造成的噪声(发生在点击登录之前),不影响登录结果。
|
||||
|
||||
## 常见问题
|
||||
|
||||
| 现象 | 处理 |
|
||||
| --- | --- |
|
||||
| 左下角红条「未连上本地开发服务」 | 服务没启动,或端口被占用;运行 `scripts/start-dev.cmd` |
|
||||
| 改完没反应 | 看控制台是否有 `热更新` 日志;确认 `npm run build:watch` 在跑,改的是 `src/` 下的模块 |
|
||||
| 页面出现两个面板 | 旧完整脚本没停用,去 Tampermonkey 停用它 |
|
||||
| 端口冲突 | `node dev/serve.mjs 8900`,同时把加载器里的 `SERVER` 常量改成对应端口 |
|
||||
| 服务没开也想用 | 加载器回退到上次缓存的源码(`GM_getValue('yun-xue-tang-dev-src')`) |
|
||||
|
||||
## 关闭开发模式
|
||||
|
||||
停用热加载器 + 重新安装一次完整脚本(把构建产出的 `.user.js` 全文粘进 Tampermonkey)即可。
|
||||
脚本本身不依赖任何本地服务,`@grant none`,可独立运行。
|
||||
|
||||
## 开机自启(可选)
|
||||
|
||||
把 `scripts/start-dev.cmd` 的快捷方式放进
|
||||
`%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup`,开机即后台常驻。
|
||||
@@ -0,0 +1,215 @@
|
||||
// ==UserScript==
|
||||
// @name 云学堂助手 · 开发热加载器
|
||||
// @namespace yxt.assistant.local
|
||||
// @version 1.0.0
|
||||
// @description 从本机 http://127.0.0.1:8899 拉取 yun-xue-tang-assistant.user.js,保存文件后约 1 秒内自动热替换,免复制粘贴
|
||||
// @author local
|
||||
// @match *://*.yunxuetang.cn/*
|
||||
// @grant GM_xmlhttpRequest
|
||||
// @grant GM_getValue
|
||||
// @grant GM_setValue
|
||||
// @grant unsafeWindow
|
||||
// @connect 127.0.0.1
|
||||
// @connect localhost
|
||||
// @run-at document-idle
|
||||
// ==/UserScript==
|
||||
|
||||
/*
|
||||
* 这是「开发期」用的薄加载器,本身不含业务逻辑:
|
||||
* 1. 页面加载时从本地开发服务拉取最新源码并注入页面主世界;
|
||||
* 2. 每 1 秒问一次 /version,哈希变了就「先释放旧实例、再注入新实例」;
|
||||
* 3. 服务没开时回退到上一次缓存的源码,保证照常可用;
|
||||
* 4. 新源码语法错误时拒绝注入,旧实例继续运行(不会把页面搞挂)。
|
||||
*
|
||||
* 依赖:先运行 scripts/start-dev.cmd(或 node dev/serve.mjs)启动本地服务。
|
||||
* 生效方式:MODE = 'hot' 不刷新页面;'reload' 变更后整页刷新。
|
||||
*/
|
||||
(function () {
|
||||
'use strict';
|
||||
|
||||
const SERVER = 'http://127.0.0.1:8899';
|
||||
const MODE = 'hot'; // 'hot' | 'reload'
|
||||
const POLL_MS = 1000; // 轮询间隔
|
||||
const RETRY_MS = 15000; // 服务不可用时的重试间隔
|
||||
const CACHE_KEY = 'yun-xue-tang-dev-src'; // 最近一次成功拉取的源码
|
||||
const TAG = '[云学堂·热加载]';
|
||||
const isTop = (function () {
|
||||
try { return window.top === window.self; } catch (e) { return true; }
|
||||
})();
|
||||
|
||||
const page = (typeof unsafeWindow !== 'undefined' && unsafeWindow) ? unsafeWindow : window;
|
||||
|
||||
let appliedHash = '';
|
||||
let failures = 0;
|
||||
let timer = 0;
|
||||
|
||||
// ---------- 网络 ----------
|
||||
function httpGet(url, timeoutMs) {
|
||||
return new Promise(function (resolve, reject) {
|
||||
if (typeof GM_xmlhttpRequest !== 'function') {
|
||||
reject(new Error('GM_xmlhttpRequest 不可用(请检查脚本授权)'));
|
||||
return;
|
||||
}
|
||||
GM_xmlhttpRequest({
|
||||
method: 'GET',
|
||||
url: url + (url.indexOf('?') < 0 ? '?' : '&') + '_=' + Date.now(),
|
||||
timeout: timeoutMs || 8000,
|
||||
headers: { 'Cache-Control': 'no-cache', Pragma: 'no-cache' },
|
||||
onload: function (r) {
|
||||
if (r.status >= 200 && r.status < 300) resolve(r.responseText || '');
|
||||
else reject(new Error('HTTP ' + r.status));
|
||||
},
|
||||
onerror: function () { reject(new Error('无法连接 ' + SERVER)); },
|
||||
ontimeout: function () { reject(new Error('请求超时')); },
|
||||
});
|
||||
});
|
||||
}
|
||||
|
||||
// ---------- 注入 ----------
|
||||
function syntaxErrorOf(src) {
|
||||
try {
|
||||
new Function(src); // 只编译不执行,用来提前发现语法错误
|
||||
return null;
|
||||
} catch (e) {
|
||||
if (e && e.name === 'SyntaxError') return e;
|
||||
return null; // 环境不允许 eval 时跳过校验
|
||||
}
|
||||
}
|
||||
|
||||
function disposePrevious() {
|
||||
try {
|
||||
if (page && typeof page.__yunXueTangDispose === 'function') {
|
||||
page.__yunXueTangDispose();
|
||||
return true;
|
||||
}
|
||||
} catch (e) {
|
||||
console.warn(TAG, '旧实例释放失败', e);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
function inject(src) {
|
||||
const el = document.createElement('script');
|
||||
el.type = 'text/javascript';
|
||||
el.setAttribute('data-yun-xue-tang-dev-injected', '1');
|
||||
el.textContent = src;
|
||||
(document.head || document.documentElement).appendChild(el);
|
||||
el.remove();
|
||||
}
|
||||
|
||||
function apply(src) {
|
||||
if (!src || src.length < 500) {
|
||||
console.error(TAG, '拉到的源码异常(长度 ' + String(src && src.length) + '),已忽略');
|
||||
return false;
|
||||
}
|
||||
const err = syntaxErrorOf(src);
|
||||
if (err) {
|
||||
console.error(TAG, '新源码有语法错误,保留旧实例:', err);
|
||||
badge('新代码语法错误:' + err.message);
|
||||
return false;
|
||||
}
|
||||
|
||||
const hadInstance = !!(page && (page.__yunXueTangAuto || document.getElementById('yun-xue-tang-panel')));
|
||||
const disposed = disposePrevious();
|
||||
// 首次注入不存在旧实例,直接注入;之后若旧实例没有 __yunXueTangDispose 或指定了 reload 模式,才刷新整页
|
||||
if (hadInstance && (MODE === 'reload' || !disposed)) {
|
||||
console.log(TAG, MODE === 'reload' ? '源码变更,刷新页面' : '旧实例无 __yunXueTangDispose,刷新页面');
|
||||
location.reload();
|
||||
return false;
|
||||
}
|
||||
|
||||
try {
|
||||
inject(src);
|
||||
GM_setValue(CACHE_KEY, src);
|
||||
clearBadge();
|
||||
console.log(TAG, '已注入 ' + src.length + ' 字节源码');
|
||||
if (isTop && !page.__yunXueTangAuto && !document.getElementById('yun-xue-tang-panel')) {
|
||||
// 站点 CSP 若禁掉 inline script,退一步用页面主世界的 eval(需要 unsafe-eval)
|
||||
try { page.eval(src); } catch (e) { /* 两种方式都不行再看下一条 */ }
|
||||
if (!page.__yunXueTangAuto && !document.getElementById('yun-xue-tang-panel')) {
|
||||
badge('源码已注入但未生效:页面 CSP 可能拦截了注入,请查看控制台');
|
||||
}
|
||||
}
|
||||
return true;
|
||||
} catch (e) {
|
||||
console.error(TAG, '注入失败:', e);
|
||||
badge('注入失败:' + (e && e.message ? e.message : e));
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 失败提示 ----------
|
||||
let badgeEl = null;
|
||||
function badge(msg) {
|
||||
if (!isTop) return;
|
||||
try {
|
||||
if (!badgeEl) {
|
||||
badgeEl = document.createElement('div');
|
||||
badgeEl.style.cssText = [
|
||||
'position:fixed', 'left:12px', 'bottom:12px', 'z-index:2147483647',
|
||||
'background:#7d2f2f', 'color:#fff', 'padding:6px 10px', 'border-radius:6px',
|
||||
'font:12px/1.5 system-ui,"Microsoft YaHei",sans-serif', 'max-width:420px',
|
||||
'box-shadow:0 4px 14px rgba(0,0,0,.35)', 'white-space:pre-wrap',
|
||||
].join(';');
|
||||
document.body.appendChild(badgeEl);
|
||||
}
|
||||
badgeEl.textContent = TAG + ' ' + msg;
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
function clearBadge() {
|
||||
if (badgeEl && badgeEl.parentNode) badgeEl.parentNode.removeChild(badgeEl);
|
||||
badgeEl = null;
|
||||
}
|
||||
|
||||
// ---------- 轮询 ----------
|
||||
function schedule(ms) {
|
||||
clearTimeout(timer);
|
||||
timer = setTimeout(poll, ms || (failures ? RETRY_MS : POLL_MS));
|
||||
}
|
||||
|
||||
function poll() {
|
||||
httpGet(SERVER + '/version', 4000).then(function (body) {
|
||||
failures = 0;
|
||||
let v;
|
||||
try { v = JSON.parse(body); } catch (e) { return; }
|
||||
if (!v || !v.hash || v.hash === appliedHash) return;
|
||||
return httpGet(SERVER + '/src').then(function (src) {
|
||||
if (apply(src)) {
|
||||
appliedHash = v.hash;
|
||||
console.log(TAG, '热更新 → ' + v.hash);
|
||||
} else {
|
||||
appliedHash = v.hash; // 坏版本不再反复重试,修好后再变哈希
|
||||
}
|
||||
});
|
||||
}).catch(function (e) {
|
||||
failures++;
|
||||
if (failures === 1) console.warn(TAG, '开发服务不可用,稍后重试:', e.message);
|
||||
}).then(function () {
|
||||
schedule();
|
||||
});
|
||||
}
|
||||
|
||||
// ---------- 启动 ----------
|
||||
function boot() {
|
||||
httpGet(SERVER + '/version', 3000).then(function (body) {
|
||||
const v = JSON.parse(body);
|
||||
return httpGet(SERVER + '/src').then(function (src) {
|
||||
appliedHash = v.hash || '';
|
||||
return apply(src);
|
||||
});
|
||||
}).catch(function (e) {
|
||||
const cached = GM_getValue(CACHE_KEY, '');
|
||||
if (cached) {
|
||||
console.warn(TAG, '开发服务不可用,使用缓存源码:', e.message);
|
||||
apply(cached);
|
||||
} else {
|
||||
console.error(TAG, '开发服务不可用且无缓存。请先运行 scripts/start-dev.cmd');
|
||||
badge('未连上本地开发服务(' + SERVER + ')\n请运行 scripts/start-dev.cmd');
|
||||
}
|
||||
}).then(function () {
|
||||
if (isTop) schedule(POLL_MS);
|
||||
});
|
||||
}
|
||||
|
||||
boot();
|
||||
})();
|
||||
+153
@@ -0,0 +1,153 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 云学堂助手 · 本地开发服务器
|
||||
*
|
||||
* 作用:把工作目录里的 yun-xue-tang-assistant.user.js 暴露给浏览器里的
|
||||
* Tampermonkey 热加载器(dev/dev-loader.user.js)拉取。
|
||||
*
|
||||
* 端点:
|
||||
* GET / 说明页
|
||||
* GET /src 最新脚本源码(no-store)
|
||||
* GET /version { hash, size, mtime },热加载器靠 hash 判断是否变更
|
||||
* GET /loader.user.js 热加载器本体(用于安装)
|
||||
*
|
||||
* 用法:node dev/serve.mjs [端口] 默认端口 8899
|
||||
*/
|
||||
import http from 'node:http';
|
||||
import path from 'node:path';
|
||||
import crypto from 'node:crypto';
|
||||
import { readFile, stat } from 'node:fs/promises';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
const ROOT = path.resolve(HERE, '..');
|
||||
const HOST = '127.0.0.1';
|
||||
const PORT = Number(process.env.YUN_XUE_TANG_DEV_PORT || process.argv[2] || 8899);
|
||||
|
||||
const FILES = {
|
||||
'/src': path.join(ROOT, 'yun-xue-tang-assistant.user.js'),
|
||||
'/loader.user.js': path.join(HERE, 'dev-loader.user.js'),
|
||||
};
|
||||
|
||||
const BASE = `http://${HOST}:${PORT}`;
|
||||
|
||||
function hashOf(buf) {
|
||||
return crypto.createHash('sha1').update(buf).digest('hex').slice(0, 12);
|
||||
}
|
||||
|
||||
function send(res, status, body, type, origin) {
|
||||
const headers = {
|
||||
'Content-Type': type || 'text/plain; charset=utf-8',
|
||||
'Cache-Control': 'no-store, no-cache, must-revalidate, max-age=0',
|
||||
Pragma: 'no-cache',
|
||||
'Access-Control-Allow-Headers': '*',
|
||||
'Access-Control-Allow-Methods': 'GET,HEAD,OPTIONS',
|
||||
'X-Content-Type-Options': 'nosniff',
|
||||
};
|
||||
// 只放行云学堂页面(Tampermonkey 的 GM_xmlhttpRequest 本来也不受 CORS 限制,
|
||||
// 这里拒绝其它站点读取是为了别让随便哪个网页都能拉到你的脚本)
|
||||
if (origin && /^https?:\/\/([a-z0-9-]+\.)*yunxuetang\.cn(:\d+)?$/i.test(origin)) {
|
||||
headers['Access-Control-Allow-Origin'] = origin;
|
||||
headers.Vary = 'Origin';
|
||||
}
|
||||
res.writeHead(status, headers);
|
||||
res.end(body);
|
||||
}
|
||||
|
||||
function indexHtml() {
|
||||
return `<!doctype html><meta charset="utf-8"><title>YXT Assistant · 本地开发服务</title>
|
||||
<style>body{font:14px/1.7 system-ui,"Microsoft YaHei";max-width:760px;margin:40px auto;padding:0 16px;color:#222}
|
||||
code{background:#f2f2f4;padding:1px 5px;border-radius:4px}a{color:#2f7d5b}
|
||||
.ok{color:#2f7d5b;font-weight:600}</style>
|
||||
<h2>云学堂助手 · 本地开发服务 <span class="ok">运行中</span></h2>
|
||||
<p>源码文件:<code>${path.join(ROOT, 'yun-xue-tang-assistant.user.js')}</code></p>
|
||||
<ul>
|
||||
<li><a href="/loader.user.js">安装 / 更新热加载器</a>(Tampermonkey 会弹出安装页)</li>
|
||||
<li><a href="/src">查看当前源码</a></li>
|
||||
<li><a href="/version">版本哈希</a></li>
|
||||
</ul>
|
||||
<p>改完源码保存后,浏览器页面约 1 秒内自动热替换,无需刷新、无需重装脚本。</p>`;
|
||||
}
|
||||
|
||||
const server = http.createServer(async (req, res) => {
|
||||
const url = new URL(req.url, BASE);
|
||||
const route = url.pathname.replace(/\/+$/, '') || '/';
|
||||
const origin = req.headers.origin || '';
|
||||
const reply = (status, body, type) => send(res, status, body, type, origin);
|
||||
|
||||
if (req.method === 'OPTIONS') return reply(204, '');
|
||||
if (route === '/favicon.ico') return reply(204, '');
|
||||
|
||||
if (route === '/') {
|
||||
return reply(200, indexHtml(), 'text/html; charset=utf-8');
|
||||
}
|
||||
|
||||
if (route === '/version') {
|
||||
try {
|
||||
const file = FILES['/src'];
|
||||
const [buf, st] = await Promise.all([readFile(file), stat(file)]);
|
||||
const body = JSON.stringify({
|
||||
hash: hashOf(buf),
|
||||
size: buf.length,
|
||||
mtime: st.mtimeMs,
|
||||
at: Date.now(),
|
||||
});
|
||||
return reply(200, body, 'application/json; charset=utf-8');
|
||||
} catch (e) {
|
||||
return reply(500, JSON.stringify({ error: String(e.message || e) }), 'application/json; charset=utf-8');
|
||||
}
|
||||
}
|
||||
|
||||
const file = FILES[route];
|
||||
if (file) {
|
||||
try {
|
||||
const buf = await readFile(file);
|
||||
const type = route === '/src'
|
||||
? 'application/javascript; charset=utf-8'
|
||||
: 'text/plain; charset=utf-8';
|
||||
if (route === '/src') {
|
||||
console.log(`[${time()}] /src ${buf.length}B ${hashOf(buf)}`);
|
||||
}
|
||||
return reply(200, buf, type);
|
||||
} catch (e) {
|
||||
console.error(`[${time()}] ${route} 读取失败: ${e.message}`);
|
||||
return reply(500, `读取失败: ${e.message}`);
|
||||
}
|
||||
}
|
||||
|
||||
return reply(404, 'not found: ' + route);
|
||||
});
|
||||
|
||||
function time() {
|
||||
return new Date().toLocaleTimeString('zh-CN', { hour12: false });
|
||||
}
|
||||
|
||||
server.listen(PORT, HOST, () => {
|
||||
console.log('');
|
||||
console.log(' YXT Assistant · 本地开发服务已启动');
|
||||
console.log(' ------------------------------------');
|
||||
console.log(` 脚本源码 : ${FILES['/src']}`);
|
||||
console.log(` 热加载器 : ${BASE}/loader.user.js`);
|
||||
console.log(` 版本接口 : ${BASE}/version`);
|
||||
console.log(` 首页 : ${BASE}/`);
|
||||
console.log(' ------------------------------------');
|
||||
console.log(' 保持本窗口开启;关闭窗口 = 停止服务。');
|
||||
console.log('');
|
||||
});
|
||||
|
||||
server.on('error', (e) => {
|
||||
if (e.code === 'EADDRINUSE') {
|
||||
console.error(`端口 ${PORT} 已被占用。可能服务已在运行,或用 "node dev/serve.mjs 8900" 换端口。`);
|
||||
} else {
|
||||
console.error('服务启动失败:', e);
|
||||
}
|
||||
process.exit(1);
|
||||
});
|
||||
|
||||
for (const sig of ['SIGINT', 'SIGTERM']) {
|
||||
process.on(sig, () => {
|
||||
console.log('\n服务已停止。');
|
||||
server.close(() => process.exit(0));
|
||||
setTimeout(() => process.exit(0), 1500).unref();
|
||||
});
|
||||
}
|
||||
@@ -0,0 +1,88 @@
|
||||
// 极简 CDP 客户端:Node 18+ 原生 WebSocket,无需 puppeteer / playwright。
|
||||
// 只实现本项目真机测试用到的部分:send / waitEvent / 事件堆积。
|
||||
// Linux 无图形化服务器 / 容器的浏览器探测与启动参数统一放在 runner/browser.mjs,
|
||||
// 这里一并转发,避免 dev 测试脚本和 runner 两套逻辑跑偏。
|
||||
import fs from 'node:fs';
|
||||
import {
|
||||
resolveBrowser as _resolveBrowser, safetyArgs as _safetyArgs, hasDisplay,
|
||||
} from '../../runner/browser.mjs';
|
||||
|
||||
export { cleanStaleSingleton } from '../../runner/browser.mjs';
|
||||
|
||||
export async function connect(wsUrl) {
|
||||
const ws = new WebSocket(wsUrl);
|
||||
await new Promise((res, rej) => {
|
||||
ws.addEventListener('open', res, { once: true });
|
||||
ws.addEventListener('error', rej, { once: true });
|
||||
});
|
||||
|
||||
let id = 0;
|
||||
const pending = new Map();
|
||||
const events = [];
|
||||
const waiters = [];
|
||||
const listeners = [];
|
||||
|
||||
ws.addEventListener('message', (ev) => {
|
||||
const msg = JSON.parse(ev.data);
|
||||
if (msg.id != null && pending.has(msg.id)) {
|
||||
const { res, rej } = pending.get(msg.id);
|
||||
pending.delete(msg.id);
|
||||
if (msg.error) rej(new Error(msg.error.message));
|
||||
else res(msg.result);
|
||||
return;
|
||||
}
|
||||
events.push(msg);
|
||||
for (const fn of listeners) {
|
||||
try { fn(msg); } catch (e) { /* 忽略订阅者异常 */ }
|
||||
}
|
||||
for (let i = waiters.length - 1; i >= 0; i--) {
|
||||
if (waiters[i].match(msg)) waiters.splice(i, 1)[0].res(msg);
|
||||
}
|
||||
});
|
||||
|
||||
const send = (method, params = {}) => new Promise((res, rej) => {
|
||||
const mid = ++id;
|
||||
pending.set(mid, { res, rej });
|
||||
ws.send(JSON.stringify({ id: mid, method, params }));
|
||||
});
|
||||
|
||||
const waitEvent = (name, timeoutMs = 30000) => new Promise((res, rej) => {
|
||||
const timer = setTimeout(() => rej(new Error('等待事件超时: ' + name)), timeoutMs);
|
||||
waiters.push({
|
||||
match: (m) => m.method === name,
|
||||
res: (m) => { clearTimeout(timer); res(m.params); },
|
||||
});
|
||||
});
|
||||
|
||||
const onEvent = (fn) => { listeners.push(fn); };
|
||||
|
||||
return { ws, send, waitEvent, onEvent, events, close: () => { try { ws.close(); } catch (e) {} } };
|
||||
}
|
||||
|
||||
export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
|
||||
|
||||
export async function httpJson(url, method = 'GET') {
|
||||
const r = await fetch(url, { method });
|
||||
const t = await r.text();
|
||||
try { return JSON.parse(t); } catch (e) { return t; }
|
||||
}
|
||||
|
||||
// ---- Linux 无图形化服务器 / 容器适配 ----
|
||||
|
||||
// 无显示环境:Linux 上没有 DISPLAY / WAYLAND_DISPLAY 就只能无头
|
||||
// (跑在 Xvfb 下时 Xvfb 会设置 DISPLAY,因此这里只判断变量)
|
||||
export function forceHeadless() {
|
||||
return !hasDisplay();
|
||||
}
|
||||
|
||||
// 按环境变量 / 常见安装位置找到真实存在的浏览器;找不到时返回 null
|
||||
export function findChrome(candidates) {
|
||||
return _resolveBrowser() || candidates.filter(Boolean).find(function (p) {
|
||||
try { return fs.statSync(p).isFile(); } catch (e) { return false; }
|
||||
}) || null;
|
||||
}
|
||||
|
||||
// 必须追加给浏览器的平台安全参数(容器 /dev/shm 小、root 无沙箱)
|
||||
export function safetyArgs() {
|
||||
return _safetyArgs();
|
||||
}
|
||||
@@ -0,0 +1,422 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 真机端到端测试:真实 Chrome + 真实云学堂账号,跑「登录 → 列表 → 进课 → 播放」全链路。
|
||||
*
|
||||
* 账号来源(环境变量,不写进代码、不打印明文):
|
||||
* YUN_XUE_TANG_USR 员工邮箱 / 账号
|
||||
* YUN_XUE_TANG_PWD 密码
|
||||
*
|
||||
* 用法:
|
||||
* node dev/real-e2e.mjs 登录 + 列表断言(不动任何课程进度)
|
||||
* node dev/real-e2e.mjs --play 额外进入最短的一门课,采样播放 N 秒后停止
|
||||
* node dev/real-e2e.mjs --play --seconds 60
|
||||
* node dev/real-e2e.mjs --headless 无头模式
|
||||
* node dev/real-e2e.mjs --keep 跑完不关浏览器(便于人工复核)
|
||||
* node dev/real-e2e.mjs --shotdir X 截图目录
|
||||
*
|
||||
* 安全约束(刻意保守):
|
||||
* - 只有显式传 --play 才会进入课程页;默认全程只读,不改任何学习进度。
|
||||
* - --play 默认只采样 25 秒,采完立刻 pause + 释放脚本,不会把整节课刷完。
|
||||
* - 结束前会打印本轮进度变化(开课前 / 结束后 的 已完成 x/y),便于核对影响。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
// 本文件在 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);
|
||||
const flag = (n) => argv.includes(n);
|
||||
const opt = (n, d) => {
|
||||
const i = argv.indexOf(n);
|
||||
return i >= 0 && argv[i + 1] ? argv[i + 1] : d;
|
||||
};
|
||||
|
||||
const USR = process.env.YUN_XUE_TANG_USR || '';
|
||||
const PWD = process.env.YUN_XUE_TANG_PWD || '';
|
||||
const PLAY = flag('--play');
|
||||
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, '.run-tmp', 'screenshots'));
|
||||
const ORIGIN = 'https://kfmic.yunxuetang.cn';
|
||||
|
||||
const CANDIDATES = [
|
||||
process.env.YUN_XUE_TANG_CHROME,
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/chromium',
|
||||
].filter(Boolean);
|
||||
const CHROME = findChrome(CANDIDATES);
|
||||
|
||||
const results = [];
|
||||
const consoleLogs = [];
|
||||
const log = (...a) => console.log(...a);
|
||||
function check(name, ok, detail) {
|
||||
results.push({ name, ok: !!ok, detail });
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
}
|
||||
|
||||
if (!CHROME) { console.error('找不到 Chrome/Edge,可用 YUN_XUE_TANG_CHROME=... 指定'); process.exit(2); }
|
||||
if (!USR || !PWD) { console.error('缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD'); process.exit(2); }
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
console.error('需要 Node 22+,当前 ' + process.version);
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
log('[E2E] 账号:' + USR.slice(0, 3) + '***' + USR.slice(-2) + ' 密码:' + '*'.repeat(Math.min(PWD.length, 8)) + '(长度 ' + PWD.length + ')');
|
||||
// Linux 无图形化服务器:没有 DISPLAY 时强制无头,并补容器/root 必需参数
|
||||
const HEADLESS_ONLY = HEADLESS || forceHeadless();
|
||||
log('[E2E] 浏览器:' + CHROME + (HEADLESS_ONLY ? '(headless)' : '(有界面)') + ' 进课采样:' + (PLAY ? SAMPLE_SECONDS + ' 秒' : '否(只读)'));
|
||||
const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yun-xue-tang-e2e-'));
|
||||
const args = [
|
||||
`--remote-debugging-port=${PORT}`,
|
||||
`--user-data-dir=${userDataDir}`,
|
||||
'--no-first-run', '--no-default-browser-check', '--disable-sync',
|
||||
'--disable-background-timer-throttling', '--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
'--autoplay-policy=no-user-gesture-required',
|
||||
'--window-size=1360,940',
|
||||
].concat(safetyArgs(), ['about:blank']);
|
||||
if (HEADLESS_ONLY) args.unshift('--headless=new');
|
||||
|
||||
let chrome = null;
|
||||
let cdp = null;
|
||||
|
||||
try {
|
||||
chrome = spawn(CHROME, args, { stdio: 'ignore', windowsHide: true });
|
||||
|
||||
let version = null;
|
||||
for (let i = 0; i < 100; i++) {
|
||||
try { const v = await httpJson(`http://127.0.0.1:${PORT}/json/version`); if (v && v.webSocketDebuggerUrl) { version = v; break; } } catch (e) {}
|
||||
await sleep(250);
|
||||
}
|
||||
if (!version) throw new Error('Chrome CDP 未就绪');
|
||||
log('[E2E] ' + version.Browser);
|
||||
|
||||
const target = await httpJson(`http://127.0.0.1:${PORT}/json/new?${encodeURIComponent(ORIGIN + '/login.html')}`, 'PUT');
|
||||
cdp = await connect(target.webSocketDebuggerUrl);
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
consoleLogs.push({ type: m.params.type, text: String(text) });
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
consoleLogs.push({ type: m.params.entry.level, text: m.params.entry.text });
|
||||
}
|
||||
});
|
||||
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', { expression: expr, returnByValue: true, awaitPromise: true, userGesture: true });
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
const waitFor = async (exprFn, timeoutMs, label) => {
|
||||
const started = Date.now();
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
try { if (await evalJS(exprFn)) return true; } catch (e) {}
|
||||
await sleep(500);
|
||||
}
|
||||
return false;
|
||||
};
|
||||
const shot = async (name) => {
|
||||
try {
|
||||
fs.mkdirSync(SHOT_DIR, { recursive: true });
|
||||
const s = await cdp.send('Page.captureScreenshot', { format: 'png' });
|
||||
const f = path.join(SHOT_DIR, name);
|
||||
fs.writeFileSync(f, Buffer.from(s.data, 'base64'));
|
||||
return path.relative(ROOT, f);
|
||||
} catch (e) { return '截图失败: ' + e.message; }
|
||||
};
|
||||
|
||||
const loaded = cdp.waitEvent('Page.loadEventFired', 45000).catch(() => null);
|
||||
await cdp.send('Page.navigate', { url: ORIGIN + '/login.html' });
|
||||
await loaded;
|
||||
await sleep(2000);
|
||||
|
||||
// ---------- 1. 登录页 + 注入 ----------
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1000);
|
||||
const loginInfo = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
return {
|
||||
url: location.href,
|
||||
title: document.title,
|
||||
isLoginPage: a.isLoginPage(),
|
||||
panel: !!document.getElementById('yun-xue-tang-panel'),
|
||||
fields: (() => { const f = a.loginFields(); return { user: !!f.user, pwd: !!f.pwd, ph: f.user ? f.user.placeholder : null }; })(),
|
||||
};
|
||||
})())`);
|
||||
check('登录页加载 + 脚本注入', loginInfo.isLoginPage === true && loginInfo.panel === true, loginInfo.url);
|
||||
check('识别到账号/密码输入框', loginInfo.fields.user && loginInfo.fields.pwd, loginInfo.fields);
|
||||
|
||||
// ---------- 2. 填账号密码(走真实的 setNativeValue + Vue 双向绑定) ----------
|
||||
const filled = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const u = ${JSON.stringify(USR)};
|
||||
const p = ${JSON.stringify(PWD)};
|
||||
document.getElementById('yun-xue-tang-login-user').value = u;
|
||||
document.getElementById('yun-xue-tang-login-pass').value = p;
|
||||
const okForm = a.fillLoginForm(u, p);
|
||||
const f = a.loginFields();
|
||||
return {
|
||||
okForm,
|
||||
userValueLen: f.user ? f.user.value.length : -1,
|
||||
pwdValueLen: f.pwd ? f.pwd.value.length : -1,
|
||||
userMatched: f.user ? f.user.value === u : false,
|
||||
pwdMatched: f.pwd ? f.pwd.value === p : false,
|
||||
panelUser: document.getElementById('yun-xue-tang-login-user').value.length,
|
||||
};
|
||||
})())`);
|
||||
check('账号密码写入真实输入框', filled.okForm === true && filled.userMatched === true && filled.pwdMatched === true,
|
||||
{ 长度: [filled.userValueLen, filled.pwdValueLen], 一致: [filled.userMatched, filled.pwdMatched] });
|
||||
|
||||
const agree = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const before = [...document.querySelectorAll('label')].filter(x => /已阅读并同意|隐私政策/.test(x.innerText||''))
|
||||
.map(x => { const c = x.querySelector('input[type=checkbox]'); return c ? c.checked : null; });
|
||||
const ok = a.checkLoginAgreement ? a.checkLoginAgreement() : 'no-api';
|
||||
const after = [...document.querySelectorAll('label')].filter(x => /已阅读并同意|隐私政策/.test(x.innerText||''))
|
||||
.map(x => { const c = x.querySelector('input[type=checkbox]'); return c ? c.checked : null; });
|
||||
return { before, after, ok };
|
||||
})())`);
|
||||
check('隐私政策勾选处理正常', agree.ok === true || agree.ok === 'no-api', agree);
|
||||
|
||||
// ---------- 3. 点「一键登录并刷课」,等真实登录成功 ----------
|
||||
// 注意:这个按钮会写 LS_PENDING,登录后自动开启列表刷课(脚本设计行为)。
|
||||
// 默认(不加 --play)测完登录马上刹住,避免动到真实学习进度。
|
||||
await evalJS(`(document.getElementById('yun-xue-tang-oneclick').click(), true)`);
|
||||
const loginOk = await waitFor(`(() => {
|
||||
if (/\\/login/.test(location.pathname)) return false;
|
||||
if (!document.body) return false;
|
||||
if (document.querySelector('input[type=password]')) return false;
|
||||
return true;
|
||||
})()`, 45000);
|
||||
await sleep(2000);
|
||||
const afterLogin = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const status = (document.getElementById('yun-xue-tang-status') || {}).textContent || '';
|
||||
const bodyText = document.body ? (document.body.innerText || '').replace(/\\s+/g, ' ').slice(0, 400) : '';
|
||||
return {
|
||||
url: location.href, title: document.title, status,
|
||||
alive: typeof window.__yunXueTangAuto,
|
||||
isLoginPage: a ? a.isLoginPage() : null,
|
||||
captcha: /验证码|滑块|安全验证/.test(bodyText),
|
||||
errText: (bodyText.match(/(用户名密码错误|账号或密码错误|密码错误|账号不存在|登录失败)[^ ]{0,40}/) || [''])[0],
|
||||
panel: !!document.getElementById('yun-xue-tang-panel'),
|
||||
};
|
||||
})())`);
|
||||
check('真实登录成功(离开登录页)', loginOk === true, afterLogin);
|
||||
const scriptErrs = () => consoleLogs.filter((l) => l.type === 'error' && /云学堂助手/.test(l.text));
|
||||
check('登录流程无脚本 error', scriptErrs().length === 0, scriptErrs().map((e) => e.text.slice(0, 140)));
|
||||
log(' 截图:' + await shot('e2e-01-after-login.png'));
|
||||
|
||||
// 登录是整页跳转(新 document),真实 Tampermonkey 会按 @match 重新注入;
|
||||
// 这里模拟同样的行为。
|
||||
if ((await evalJS('typeof window.__yunXueTangAuto')) === 'undefined') {
|
||||
log('[E2E] 登录后是新 document(' + afterLogin.url + '),重新注入脚本');
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1200);
|
||||
}
|
||||
check('登录后新 document 上脚本已注入', (await evalJS('typeof window.__yunXueTangAuto')) === 'object', await evalJS('document.title || location.pathname'));
|
||||
|
||||
if (!PLAY) {
|
||||
// 立即刹住列表刷课:清 pending 标记 + 关闭 running,防止在真实账号上推进课程
|
||||
const halted = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
try { localStorage.removeItem('yun-xue-tang-auto-start-after-login'); } catch (e) {}
|
||||
if (a) { a.S.batchRunning = false; a.S.batchFinished = false; a.S.activeCourse = null; a.S.coursePhase = 'idle'; a.save(); }
|
||||
return { running: a ? a.S.batchRunning : null, current: a ? a.S.activeCourse : null };
|
||||
})())`);
|
||||
check('默认只读:登录后立即停用列表刷课', halted.running === false && halted.current === null, halted);
|
||||
}
|
||||
|
||||
// ---------- 4. 列表页断言 ----------
|
||||
const listNavStarted = Date.now();
|
||||
await evalJS(`(location.href = 'https://kfmic.yunxuetang.cn/kng/#/list', true)`);
|
||||
await cdp.waitEvent('Page.loadEventFired', 30000).catch(() => null);
|
||||
await sleep(2500);
|
||||
// 换页后可能又是新 document,重新注入
|
||||
if ((await evalJS('typeof window.__yunXueTangAuto')) === 'undefined') {
|
||||
log('[E2E] 列表页是新 document,重新注入脚本');
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1000);
|
||||
}
|
||||
if (!PLAY) {
|
||||
// 新 document 里 S 从 sessionStorage 恢复了 batchRunning=true,再次刹住
|
||||
await evalJS(`(() => {
|
||||
try { localStorage.removeItem('yun-xue-tang-auto-start-after-login'); } catch (e) {}
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (a) { a.S.batchRunning = false; a.S.activeCourse = null; a.S.coursePhase = 'idle'; a.save(); }
|
||||
return true;
|
||||
})()`);
|
||||
await sleep(400);
|
||||
}
|
||||
const listReady = await waitFor(`!!window.__yunXueTangAuto && document.querySelectorAll('li.kng-list-new__item').length > 0`, 45000);
|
||||
await sleep(1500);
|
||||
const listInfo = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto; const cards = a.scanCards();
|
||||
const vm = (() => {
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
return v || null;
|
||||
})();
|
||||
const data = (vm && vm.kngListData) || [];
|
||||
return {
|
||||
url: location.href,
|
||||
route: a.route(),
|
||||
cards: cards.length,
|
||||
page: a.currentPage(),
|
||||
maxPage: a.maxPageNumber(),
|
||||
first3: cards.slice(0, 3).map((c) => ({ title: c.title.slice(0, 30), status: c.status })),
|
||||
vmCount: data.length,
|
||||
vmFirst: data.slice(0, 3).map((d) => ({ title: String(d.title || d.name || '').slice(0, 26), studyHours: d.studyHours, id: String(d.id || d.kngId || '').slice(0, 12) })),
|
||||
pending: cards.filter((c) => c.title && !/已学完|已完成|已学习/.test(c.status)).length,
|
||||
};
|
||||
})())`);
|
||||
check('列表页卡片渲染', listReady === true && listInfo.cards > 0, { 卡片数: listInfo.cards, 页码: listInfo.page + '/' + listInfo.maxPage });
|
||||
check('scanCards 解析标题与状态', listInfo.first3.every((c) => c.title.length > 0), listInfo.first3);
|
||||
check('列表 Vue 组件可读(时长来源)', listInfo.vmCount > 0, { 条数: listInfo.vmCount, 样例: listInfo.vmFirst });
|
||||
const dur = listInfo.vmFirst.filter((d) => Number.isFinite(d.studyHours) && d.studyHours > 0);
|
||||
check('studyHours 时长可用(短课程优先的数据源)', dur.length > 0, dur);
|
||||
|
||||
// ---------- 5. 可选:真实进课 + 采样播放 ----------
|
||||
let beforeProgress = null;
|
||||
let playInfo = null;
|
||||
if (PLAY) {
|
||||
// 选一门「最短」的未学完课程,尽量减小对真实进度的影响
|
||||
const pick = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const cards = a.scanCards();
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
const data = (v && v.kngListData) || [];
|
||||
const byTitle = new Map();
|
||||
for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d);
|
||||
const cand = cards
|
||||
.filter((c) => c.title && !/已学完|已完成|已学习/.test(c.status))
|
||||
.map((c) => ({ c, d: byTitle.get(c.title) }))
|
||||
.filter((x) => x.d && Number(x.d.studyHours) > 0)
|
||||
.sort((x, y) => Number(x.d.studyHours) - Number(y.d.studyHours));
|
||||
if (!cand.length) {
|
||||
const any = cards.find((c) => c.title && !/已学完|已完成|已学习/.test(c.status));
|
||||
return any ? { title: any.title, studyHours: null, idx: any.i, fallback: true } : null;
|
||||
}
|
||||
return { title: cand[0].c.title, studyHours: Number(cand[0].d.studyHours), idx: cand[0].c.i };
|
||||
})())`);
|
||||
check('找到可学的最短课程', !!pick, pick);
|
||||
if (pick) {
|
||||
log('[E2E] 选课:' + pick.title + '(' + (pick.studyHours ? Math.round(pick.studyHours / 60) + ' 分钟' : '时长未知') + ')');
|
||||
// 用脚本自己的 startCourse 走真实进课流程(会写 S.activeCourse 并点卡片)
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const card = a.scanCards().find((c) => c.i === ${pick.idx});
|
||||
if (!card) return 'no-card';
|
||||
a.startCourse(card);
|
||||
return 'started';
|
||||
})()`);
|
||||
|
||||
const entered = await waitFor(`window.__yunXueTangAuto && window.__yunXueTangAuto.route() === 'course' && /\\/play/.test(location.hash)`, 40000);
|
||||
await sleep(2500);
|
||||
const before = await json(`JSON.stringify((() => ({
|
||||
url: location.hash,
|
||||
summary: window.__yunXueTangAuto.readSummary(),
|
||||
countdown: window.__yunXueTangAuto.readCountdown(),
|
||||
lessons: window.__yunXueTangAuto.lessonItems().length,
|
||||
active: window.__yunXueTangAuto.lessonItems().length ? (document.querySelector('.yxtulcdsdk-catalog .liactive') || {}).innerText || '' : '',
|
||||
}))())`);
|
||||
beforeProgress = before.summary && before.summary.text;
|
||||
check('进入真实课程播放页', entered === true, before.url);
|
||||
check('读取到课程汇总/目录', !!before.summary || before.lessons > 0, { 汇总: before.summary && before.summary.text, 目录: before.lessons });
|
||||
|
||||
// 触发「开始学习」并观察播放器
|
||||
const play = await waitFor(`(() => {
|
||||
const v = document.querySelector('video, audio');
|
||||
return !!v && v.duration > 0;
|
||||
})()`, 25000);
|
||||
const t0 = Date.now();
|
||||
// 让主循环自己动起来(模拟用户手动打开课程时的自动连播开关)
|
||||
await evalJS(`(() => { window.__yunXueTangAuto.tick(); return true; })()`);
|
||||
await sleep(SAMPLE_SECONDS * 1000);
|
||||
|
||||
playInfo = await json(`JSON.stringify((() => {
|
||||
const v = document.querySelector('video, audio');
|
||||
const a = window.__yunXueTangAuto;
|
||||
return {
|
||||
found: !!v,
|
||||
muted: v ? v.muted : null,
|
||||
paused: v ? v.paused : null,
|
||||
rate: v ? v.playbackRate : null,
|
||||
currentTime: v ? Math.round(v.currentTime) : null,
|
||||
duration: v ? Math.round(v.duration) : null,
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
elapsedSec: Math.round((Date.now() - ${t0}) / 1000),
|
||||
};
|
||||
})())`);
|
||||
check('播放器被找到并接管(静音 1x)', playInfo.found === true && playInfo.muted === true && playInfo.rate === 1, playInfo);
|
||||
check('视频真实在播放(时间在走)', playInfo.paused === false && playInfo.currentTime > 0, { 已播到: playInfo.currentTime + 's / ' + playInfo.duration + 's' });
|
||||
check('采样期间无脚本 error', scriptErrs().length === 0, scriptErrs().map((e) => e.text.slice(0, 140)));
|
||||
log(' 截图:' + await shot('e2e-02-playing.png'));
|
||||
|
||||
// 立刻停手:暂停媒体 + 关闭批量 + dispose
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.S.batchRunning = false;
|
||||
a.save();
|
||||
a.pauseAllMedia ? a.pauseAllMedia() : document.querySelectorAll('video, audio').forEach((x) => x.pause());
|
||||
return true;
|
||||
})()`);
|
||||
await sleep(1200);
|
||||
const stopped = await json(`JSON.stringify((() => {
|
||||
const v = document.querySelector('video, audio');
|
||||
return { paused: v ? v.paused : null, running: window.__yunXueTangAuto ? window.__yunXueTangAuto.S.batchRunning : null,
|
||||
summary: window.__yunXueTangAuto ? window.__yunXueTangAuto.readSummary() : null };
|
||||
})())`);
|
||||
check('停止后媒体已暂停', stopped.paused === true && stopped.running === false, stopped);
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 6. 释放脚本,确认无残留 ----------
|
||||
if (PLAY) {
|
||||
const disposed = await json(`JSON.stringify((() => {
|
||||
window.__yunXueTangDispose();
|
||||
return { panel: !!document.getElementById('yun-xue-tang-panel'), api: typeof window.__yunXueTangAuto };
|
||||
})())`);
|
||||
check('dispose 后面板与 API 清理干净', disposed.panel === false && disposed.api === 'undefined', disposed);
|
||||
}
|
||||
|
||||
log('\n[E2E] 脚本日志(' + consoleLogs.filter((l) => /云学堂助手/.test(l.text)).length + ' 条脚本相关):');
|
||||
for (const l of consoleLogs.filter((x) => /云学堂助手/.test(x.text)).slice(-25)) log(' [' + l.type + '] ' + l.text.slice(0, 170));
|
||||
if (beforeProgress) log('[E2E] 进度快照:进入前「' + beforeProgress + '」→ 采样后「' + (playInfo && playInfo.summary && playInfo.summary.text) + '」');
|
||||
} catch (e) {
|
||||
check('E2E 流程执行完毕', false, e && e.stack ? e.stack.split('\n').slice(0, 5).join(' | ') : String(e));
|
||||
} finally {
|
||||
if (cdp && !KEEP) cdp.close();
|
||||
if (chrome && !KEEP) { try { chrome.kill(); } catch (e) {} }
|
||||
if (!KEEP) { await sleep(700); try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch (e) {} }
|
||||
else log('[E2E] --keep:浏览器保持打开 ' + userDataDir);
|
||||
}
|
||||
|
||||
const failed = results.filter((r) => !r.ok);
|
||||
log('\n===== E2E 结果:' + (results.length - failed.length) + '/' + results.length + ' 通过,失败 ' + failed.length + ' =====');
|
||||
for (const f of failed) log(' FAIL ' + f.name + ' → ' + JSON.stringify(f.detail));
|
||||
process.exit(failed.length ? 1 : 0);
|
||||
@@ -0,0 +1,468 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 真机持续运行测试:跨章节 + 跨课程。
|
||||
*
|
||||
* 真实 Chrome + 真实账号,让脚本自己跑列表刷课,观察它能否
|
||||
* 1) 在一门多课时课程里自动从第 N 节切到第 N+1 节(跨章节)
|
||||
* 2) 一门课完成后回到列表、进下一门课(跨课程)
|
||||
* 3) 每次整页跳转(新 document)后重新注入并接续运行
|
||||
* 4) 全程视频持续推进、无脚本 error、没学完的课程按退避重试而不是被跳过
|
||||
*
|
||||
* 用法:
|
||||
* node dev/real-run.mjs --scan 只登录 + 列表,打印所有卡片(只读)
|
||||
* node dev/real-run.mjs --probe 8 读前 8 门课最短的「未学完」课的目录(不进播放,不动进度)
|
||||
* node dev/real-run.mjs --max 2 --budget 15 跑批量,最多完成 2 门 / 最多 15 分钟
|
||||
* node dev/real-run.mjs --title 坚持 --max 2 先把匹配标题的课程跑完,再自动跑下一门
|
||||
* node dev/real-run.mjs --headless --keep 无头 / 跑完不关浏览器
|
||||
* node dev/real-run.mjs --out run.json 时间线写到指定文件(默认临时目录)
|
||||
*
|
||||
* 注意:这个测试会**真实推进学习进度**(这就是它的目的)。
|
||||
* 只读的登录/列表测试请看 dev/real-e2e.mjs。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
// 本文件在 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);
|
||||
const flag = (n) => argv.includes(n);
|
||||
const opt = (n, d) => {
|
||||
const i = argv.indexOf(n);
|
||||
return i >= 0 && argv[i + 1] ? argv[i + 1] : d;
|
||||
};
|
||||
|
||||
const USR = process.env.YUN_XUE_TANG_USR || '';
|
||||
const PWD = process.env.YUN_XUE_TANG_PWD || '';
|
||||
const SCAN = flag('--scan');
|
||||
const PROBE = flag('--probe') ? Number(opt('--probe', 8)) : 0;
|
||||
const HEADLESS = flag('--headless') || process.env.YUN_XUE_TANG_HEADLESS === '1';
|
||||
const KEEP = flag('--keep');
|
||||
const MAX_COURSES = Number(opt('--max', 2));
|
||||
const BUDGET_MIN = Number(opt('--budget', 15));
|
||||
const PIN_TITLE = opt('--title', '');
|
||||
const PORT = Number(process.env.YUN_XUE_TANG_CDP_PORT || 9335);
|
||||
const ORIGIN = 'https://kfmic.yunxuetang.cn';
|
||||
const OUT = opt('--out', path.join(os.tmpdir(), 'yun-xue-tang-run-' + Date.now() + '.json'));
|
||||
|
||||
const CANDIDATES = [
|
||||
process.env.YUN_XUE_TANG_CHROME,
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/chromium',
|
||||
].filter(Boolean);
|
||||
const CHROME = findChrome(CANDIDATES);
|
||||
|
||||
const results = [];
|
||||
const consoleLogs = [];
|
||||
const timeline = [];
|
||||
const log = (...a) => console.log(...a);
|
||||
const clock = () => new Date().toISOString().slice(11, 19);
|
||||
function check(name, ok, detail) {
|
||||
results.push({ name, ok: !!ok, detail });
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
}
|
||||
|
||||
if (!CHROME) { console.error('找不到 Chrome/Edge,可用 YUN_XUE_TANG_CHROME=... 指定'); process.exit(2); }
|
||||
if (!USR || !PWD) { console.error('缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD'); process.exit(2); }
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
console.error('需要 Node 22+,当前 ' + process.version);
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
log('[RUN] 账号:' + USR.slice(0, 3) + '***' + USR.slice(-2));
|
||||
log('[RUN] 模式:' + (SCAN ? '只读扫描列表' : (PROBE ? '只读探测前 ' + PROBE + ' 门课的目录' : '批量持续运行(最多 ' + MAX_COURSES + ' 门 / ' + BUDGET_MIN + ' 分钟)')) +
|
||||
(PIN_TITLE ? ' 指定课程:' + PIN_TITLE : ''));
|
||||
|
||||
// Linux 无图形化服务器:没有 DISPLAY 时强制无头,并补容器/root 必需参数
|
||||
const HEADLESS_ONLY = HEADLESS || forceHeadless();
|
||||
const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yun-xue-tang-run-'));
|
||||
const args = [
|
||||
`--remote-debugging-port=${PORT}`,
|
||||
`--user-data-dir=${userDataDir}`,
|
||||
'--no-first-run', '--no-default-browser-check', '--disable-sync',
|
||||
// 后台标签页/最小化时不要把定时器和视频节流,否则「持续运行」测不准
|
||||
'--disable-background-timer-throttling', '--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
'--autoplay-policy=no-user-gesture-required',
|
||||
'--window-size=1360,940',
|
||||
].concat(safetyArgs(), ['about:blank']);
|
||||
if (HEADLESS_ONLY) args.unshift('--headless=new');
|
||||
|
||||
let chrome = null;
|
||||
let cdp = null;
|
||||
|
||||
log('[RUN] 浏览器:' + CHROME + (HEADLESS_ONLY ? '(headless)' : '(有界面)'));
|
||||
|
||||
try {
|
||||
chrome = spawn(CHROME, args, { stdio: 'ignore', windowsHide: true });
|
||||
|
||||
let version = null;
|
||||
for (let i = 0; i < 100; i++) {
|
||||
try { const v = await httpJson(`http://127.0.0.1:${PORT}/json/version`); if (v && v.webSocketDebuggerUrl) { version = v; break; } } catch (e) {}
|
||||
await sleep(250);
|
||||
}
|
||||
if (!version) throw new Error('Chrome CDP 未就绪');
|
||||
log('[RUN] ' + version.Browser);
|
||||
|
||||
const target = await httpJson(`http://127.0.0.1:${PORT}/json/new?${encodeURIComponent(ORIGIN + '/login.html')}`, 'PUT');
|
||||
cdp = await connect(target.webSocketDebuggerUrl);
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
consoleLogs.push({ t: Date.now(), type: m.params.type, text: String(text) });
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
consoleLogs.push({ t: Date.now(), type: m.params.entry.level, text: m.params.entry.text });
|
||||
}
|
||||
});
|
||||
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', { expression: expr, returnByValue: true, awaitPromise: true, userGesture: true });
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
const waitFor = async (exprFn, timeoutMs) => {
|
||||
const started = Date.now();
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
try { if (await evalJS(exprFn)) return true; } catch (e) {}
|
||||
await sleep(500);
|
||||
}
|
||||
return false;
|
||||
};
|
||||
|
||||
// ---------- 整页跳转后自动重新注入(等价 Tampermonkey 按 @match 重注入) ----------
|
||||
let injections = 0;
|
||||
let reinjectTimer = null;
|
||||
const injectIfMissing = async () => {
|
||||
let t;
|
||||
try { t = await evalJS('typeof window.__yunXueTangAuto'); } catch (e) { return false; }
|
||||
if (t === 'object') return false;
|
||||
try {
|
||||
await evalJS(SCRIPT_SRC);
|
||||
injections++;
|
||||
return true;
|
||||
} catch (e) { return false; }
|
||||
};
|
||||
// 每 1.5 秒兜底检查一次:任何原因导致脚本不在,就补注入(真实环境里由 @match 保证)
|
||||
const startWatchdog = () => {
|
||||
if (reinjectTimer) clearInterval(reinjectTimer);
|
||||
reinjectTimer = setInterval(() => {
|
||||
injectIfMissing().then((did) => {
|
||||
if (did) console.log('[RUN] ' + clock() + ' 新 document 已重新注入(第 ' + injections + ' 次)');
|
||||
}).catch(() => {});
|
||||
}, 1500);
|
||||
};
|
||||
|
||||
const loaded = cdp.waitEvent('Page.loadEventFired', 45000).catch(() => null);
|
||||
await cdp.send('Page.navigate', { url: ORIGIN + '/login.html' });
|
||||
await loaded;
|
||||
await sleep(2000);
|
||||
|
||||
// ---------- 登录 ----------
|
||||
await evalJS(SCRIPT_SRC);
|
||||
injections++;
|
||||
await sleep(1200);
|
||||
const loginPage = await evalJS(`!!(window.__yunXueTangAuto && window.__yunXueTangAuto.isLoginPage())`);
|
||||
check('登录页脚本就绪', loginPage === true, await evalJS('location.pathname'));
|
||||
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.fillLoginForm(${JSON.stringify(USR)}, ${JSON.stringify(PWD)});
|
||||
try { a.checkLoginAgreement(); } catch (e) {}
|
||||
return true;
|
||||
})()`);
|
||||
await evalJS(`(document.getElementById('yun-xue-tang-oneclick').click(), true)`);
|
||||
const loginOk = await waitFor(`(() => {
|
||||
if (/\\/login/.test(location.pathname)) return false;
|
||||
if (!document.body) return false;
|
||||
return !document.querySelector('input[type=password]');
|
||||
})()`, 45000);
|
||||
check('真实登录成功', loginOk === true, await evalJS('location.pathname'));
|
||||
|
||||
// 进列表(新 document)
|
||||
const loaded2 = cdp.waitEvent('Page.loadEventFired', 30000).catch(() => null);
|
||||
await evalJS(`(location.href = '${ORIGIN}/kng/#/list', true)`);
|
||||
await loaded2;
|
||||
await sleep(2500);
|
||||
await injectIfMissing();
|
||||
if (injections === 1) injections++; // 上面那次是列表页注入
|
||||
await waitFor(`!!window.__yunXueTangAuto && window.__yunXueTangAuto.scanCards().length > 0`, 45000);
|
||||
await sleep(1500);
|
||||
|
||||
// 优先短课程(缩短验证耗时;真机上这是默认勾选行为)
|
||||
await evalJS(`(() => { try { localStorage.setItem('yun-xue-tang-prefer-short', '1'); } catch (e) {} const a = window.__yunXueTangAuto; if (a) a.state.preferShortCourses = true; return true; })()`);
|
||||
|
||||
// ---------- --probe:只读探测目录(关掉自动播放,避免动进度) ----------
|
||||
if (PROBE) {
|
||||
// 当前课程自动连播开关关掉:进课后脚本不会自动起播、也不会自动切节
|
||||
await evalJS(`(() => { localStorage.setItem('yun-xue-tang-auto-play-enabled', '0'); const a = window.__yunXueTangAuto; if (a) a.state.autoPlayEnabled = false; return true; })()`);
|
||||
const picks = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
const data = (v && v.kngListData) || [];
|
||||
const byTitle = new Map();
|
||||
for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d);
|
||||
return a.scanCards()
|
||||
.filter((c) => c.title && !/已学完|已完成|已学习/.test(c.status))
|
||||
.map((c) => {
|
||||
const d = byTitle.get(c.title) || {};
|
||||
return { i: c.i, title: c.title, studyHours: Number(d.studyHours) || 0, id: String(d.id || '') };
|
||||
})
|
||||
.filter((c) => c.studyHours > 0)
|
||||
.sort((x, y) => x.studyHours - y.studyHours)
|
||||
.slice(0, ${PROBE});
|
||||
})())`);
|
||||
log('\n[RUN] 探测 ' + picks.length + ' 门课(按总时长正序):');
|
||||
const report = [];
|
||||
for (const p of picks) {
|
||||
await evalJS(`(() => {
|
||||
try { localStorage.setItem('yun-xue-tang-auto-play-enabled', '0'); } catch (e) {}
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.state.autoPlayEnabled = false;
|
||||
const card = a.scanCards().find((c) => c.i === ${p.i});
|
||||
if (card) a.startCourse(card);
|
||||
return true;
|
||||
})()`).catch(() => {});
|
||||
const ok = await waitFor(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
return !!a && a.route() === 'course' && a.lessonItems().length > 0;
|
||||
})()`, 25000);
|
||||
let info = null;
|
||||
if (ok) {
|
||||
await sleep(1200);
|
||||
info = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const items = a.lessonItems();
|
||||
return {
|
||||
lessons: items.length,
|
||||
completed: items.filter((li) => a.isLessonCompleted(li)).length,
|
||||
quiz: /考试|测验|问卷|答题/.test((document.querySelector('.yxtulcdsdk-catalog') || {}).innerText || ''),
|
||||
names: items.map((li) => ((li.innerText || '').replace(/\\s+/g, ' ').trim()).slice(0, 22)),
|
||||
summary: a.readSummary(),
|
||||
};
|
||||
})())`);
|
||||
}
|
||||
const remaining = info ? info.lessons - info.completed : 0;
|
||||
log(' ' + (info ? (info.lessons + ' 节/剩 ' + remaining + (info.quiz ? ' [含考试]' : '')) : '进课失败').padEnd(18) +
|
||||
' ' + String(Math.round(p.studyHours / 60)).padStart(4) + ' 分 ' + p.title.slice(0, 40));
|
||||
report.push({ ...p, ...(info || {}), remaining });
|
||||
// 回列表
|
||||
await evalJS(`(location.href = '${ORIGIN}/kng/#/list', true)`).catch(() => {});
|
||||
await sleep(2500);
|
||||
await injectIfMissing();
|
||||
await waitFor(`!!window.__yunXueTangAuto && window.__yunXueTangAuto.scanCards().length > 0`, 40000);
|
||||
await sleep(1200);
|
||||
}
|
||||
const multi = report.filter((r) => r.remaining >= 2 && !r.quiz);
|
||||
log('\n[RUN] 适合测「跨章节」的候选(≥2 节未学完且不含考试):');
|
||||
for (const m of multi) log(' ' + m.remaining + ' 节待学 ' + m.title.slice(0, 40) + ' → ' + m.names.join(' / '));
|
||||
check('找到可跨章节验证的课程(≥2 节未学完)', multi.length > 0, multi.slice(0, 5).map((m) => ({ title: m.title.slice(0, 30), remaining: m.remaining })));
|
||||
fs.writeFileSync(path.join(os.tmpdir(), 'yun-xue-tang-probe.json'), JSON.stringify(report, null, 2));
|
||||
} else if (SCAN) {
|
||||
const cards = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let v = ul && ul.__vue__;
|
||||
while (v && !(v.kngListData && v.kngListData.length)) v = v.$parent;
|
||||
const data = (v && v.kngListData) || [];
|
||||
const byTitle = new Map();
|
||||
for (const d of data) byTitle.set(String(d.title || d.name || '').trim(), d);
|
||||
return a.scanCards().map((c) => {
|
||||
const d = byTitle.get(c.title) || {};
|
||||
return { title: c.title, status: c.status, studyHours: d.studyHours, id: String(d.id || '') };
|
||||
});
|
||||
})())`);
|
||||
log('\n[RUN] 列表卡片(' + cards.length + ' 张):');
|
||||
for (const c of cards) {
|
||||
log(' ' + (c.status || '-').padEnd(4) + ' ' +
|
||||
(c.studyHours ? String(Math.round(c.studyHours / 60)).padStart(5) + ' 分' : ' ? 分') +
|
||||
' ' + c.title.slice(0, 46));
|
||||
}
|
||||
check('列表可读', cards.length > 0, { 卡片数: cards.length });
|
||||
} else {
|
||||
// ---------- 启动批量 ----------
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.S.completedThisRun = 0;
|
||||
a.S.batchFinished = false;
|
||||
a.startBatch();
|
||||
return true;
|
||||
})()`);
|
||||
await sleep(1500);
|
||||
|
||||
// 指定课程:进入列表后抢先开始它(S.batchRunning 先关掉,避免 listTick 抢选别的课)
|
||||
if (PIN_TITLE) {
|
||||
const armed = await waitFor(`window.__yunXueTangAuto && window.__yunXueTangAuto.route() === 'list' && window.__yunXueTangAuto.scanCards().length > 0`, 60000);
|
||||
if (armed) {
|
||||
const pinned = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
a.S.batchRunning = false; a.save();
|
||||
const card = a.scanCards().find((c) => c.title.indexOf(${JSON.stringify(PIN_TITLE)}) >= 0);
|
||||
if (!card) { a.S.batchRunning = true; a.save(); return { ok: false }; }
|
||||
a.startCourse(card);
|
||||
a.S.batchRunning = true; a.save();
|
||||
return { ok: true, title: card.title };
|
||||
})())`);
|
||||
check('已指定首门课程并开始', pinned.ok === true, pinned);
|
||||
} else {
|
||||
check('已指定首门课程并开始', false, '列表未就绪');
|
||||
}
|
||||
}
|
||||
|
||||
// ---------- 持续监控 ----------
|
||||
const startedAt = Date.now();
|
||||
const deadline = startedAt + BUDGET_MIN * 60 * 1000;
|
||||
let lastSig = '';
|
||||
let lastSample = null;
|
||||
let lastAdvanceAt = Date.now();
|
||||
let lastCt = 0;
|
||||
let maxStallMs = 0;
|
||||
const perCourse = new Map(); // title -> lesson keys seen
|
||||
const transitions = []; // { t, from, to, course }
|
||||
let playEvidence = 0; // currentTime 增长次数
|
||||
|
||||
const sample = async () => {
|
||||
try {
|
||||
return await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (!a) return { gone: true, href: location.href };
|
||||
const v = document.querySelector('video, audio');
|
||||
const items = a.lessonItems();
|
||||
return {
|
||||
href: location.href,
|
||||
route: a.route(),
|
||||
phase: a.S.coursePhase,
|
||||
running: a.S.batchRunning,
|
||||
runFinished: a.S.batchFinished,
|
||||
completed: a.S.completedThisRun,
|
||||
pendingRetries: Object.keys(a.S.courseRetries || {}).length,
|
||||
cur: a.S.activeCourse ? a.S.activeCourse.title : null,
|
||||
curId: a.S.activeCourse ? a.S.activeCourse.id : null,
|
||||
lesson: a.readActiveLessonKey ? a.readActiveLessonKey() : '',
|
||||
lessonCount: items.length,
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
video: v ? { ct: Math.round(v.currentTime), dur: Math.round(v.duration), paused: v.paused, muted: v.muted, rate: v.playbackRate } : null,
|
||||
done: Object.keys(a.S.completedTitles || {}).length,
|
||||
retryTitles: Object.keys(a.S.courseRetries || {}).length,
|
||||
};
|
||||
})())`);
|
||||
} catch (e) {
|
||||
return null; // 跳转中 DOM 不可用
|
||||
}
|
||||
};
|
||||
|
||||
log('\n[RUN] 开始持续监控(Ctrl+C 或到点自动结束)…\n');
|
||||
while (Date.now() < deadline) {
|
||||
const s = await sample();
|
||||
if (s && !s.gone) {
|
||||
lastSample = s;
|
||||
// 视频推进证据
|
||||
if (s.video && !s.video.paused && s.video.ct > lastCt) {
|
||||
playEvidence++;
|
||||
lastAdvanceAt = Date.now();
|
||||
lastCt = s.video.ct;
|
||||
} else if (s.video && s.video.paused && s.video.ct !== lastCt) {
|
||||
lastCt = s.video.ct;
|
||||
}
|
||||
if (Date.now() - lastAdvanceAt > maxStallMs) maxStallMs = Date.now() - lastAdvanceAt;
|
||||
|
||||
// 每门课出现过的课时
|
||||
if (s.cur) {
|
||||
if (!perCourse.has(s.cur)) perCourse.set(s.cur, []);
|
||||
const keys = perCourse.get(s.cur);
|
||||
if (s.lesson && keys[keys.length - 1] !== s.lesson) keys.push(s.lesson);
|
||||
}
|
||||
|
||||
const sig = [s.cur, s.lesson, s.completed, s.phase, s.runFinished].join('|');
|
||||
if (sig !== lastSig) {
|
||||
const prev = lastSample && lastSig ? lastSig.split('|') : null;
|
||||
log('[RUN] ' + clock() + ' ' + (s.cur ? s.cur.slice(0, 26) : '(列表)') +
|
||||
' ' + (s.phase || '-') + (s.runFinished ? ' [已停止]' : '') +
|
||||
' 完成 ' + s.completed + ' 待重试 ' + s.pendingRetries +
|
||||
(s.lesson ? ' 课时:' + s.lesson.slice(0, 30) : '') +
|
||||
(s.summary ? ' 汇总:' + s.summary.text : '') +
|
||||
(s.countdown != null ? ' 倒计时 ' + s.countdown + 's' : ''));
|
||||
if (prev && prev[0] && s.cur && prev[0] === s.cur && prev[1] && s.lesson && prev[1] !== s.lesson) {
|
||||
transitions.push({ t: Date.now() - startedAt, course: s.cur, from: prev[1], to: s.lesson });
|
||||
}
|
||||
timeline.push({ at: Date.now() - startedAt, ...s });
|
||||
lastSig = sig;
|
||||
}
|
||||
|
||||
if (s.completed >= MAX_COURSES) { log('\n[RUN] 已完成 ' + s.completed + ' 门,达到上限,收尾'); break; }
|
||||
if (s.runFinished) { log('\n[RUN] 脚本自己停止了:' + s.status); break; }
|
||||
if (s.runFinished && /重试 .* 次仍未完成/.test(s.status || '')) { log('[RUN] 重试用尽,脚本已停止,收尾'); break; }
|
||||
}
|
||||
await sleep(2000);
|
||||
}
|
||||
|
||||
const elapsed = Math.round((Date.now() - startedAt) / 1000);
|
||||
const errors = consoleLogs.filter((l) => l.type === 'error' && /云学堂助手/.test(l.text));
|
||||
const final = (await sample()) || lastSample || {};
|
||||
|
||||
check('持续运行未因脚本 exception 中断', errors.length === 0, errors.map((e) => e.text.slice(0, 140)));
|
||||
check('批处理仍在运行或已按上限结束', final.runFinished !== undefined, { running: final.running, runFinished: final.runFinished });
|
||||
check('至少完成 2 门课程(跨课程)', (final.completed || 0) >= 2, { 完成: final.completed, 用时秒: elapsed });
|
||||
check('观察到课时自动切换(跨章节)', transitions.length >= 1, { 切换次数: transitions.length, 明细: transitions.map((x) => x.from.slice(0, 14) + ' → ' + x.to.slice(0, 14)) });
|
||||
check('视频持续推进(无长时间卡死)', playEvidence >= 3 && maxStallMs < 120000, { 推进采样: playEvidence, 最长停滞秒: Math.round(maxStallMs / 1000) });
|
||||
check('整页跳转后自动恢复(重新注入)', injections >= 2, { 注入次数: injections });
|
||||
check('没有课程被永久跳过(重试计数可控)', (final.retryTitles || 0) < 5, { 待重试标题: final.retryTitles });
|
||||
|
||||
log('\n[RUN] 每门课观察到的课时:');
|
||||
for (const [title, keys] of perCourse) {
|
||||
log(' ' + title.slice(0, 34) + ' → ' + keys.length + ' 节:' + keys.map((k) => k.slice(0, 18)).join(' / '));
|
||||
}
|
||||
log('[RUN] 完成后本地已记录 done:' + (final.done || 0) + ' 门;用时 ' + Math.round(elapsed / 60) + ' 分 ' + (elapsed % 60) + ' 秒');
|
||||
|
||||
// 收尾:停批量 + 暂停媒体
|
||||
await evalJS(`(() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (a) { a.S.batchRunning = false; a.save(); if (a.pauseAllMedia) a.pauseAllMedia(); }
|
||||
return true;
|
||||
})()`).catch(() => {});
|
||||
await sleep(1000);
|
||||
const disposed = await json(`JSON.stringify((() => {
|
||||
try { window.__yunXueTangDispose(); } catch (e) {}
|
||||
return { panel: !!document.getElementById('yun-xue-tang-panel'), api: typeof window.__yunXueTangAuto };
|
||||
})())`).catch(() => ({ panel: null, api: 'n/a' }));
|
||||
check('dispose 后面板与 API 清理干净', disposed.panel === false && disposed.api === 'undefined', disposed);
|
||||
}
|
||||
|
||||
log('\n[RUN] 脚本日志(' + consoleLogs.filter((l) => /云学堂助手/.test(l.text)).length + ' 条):');
|
||||
for (const l of consoleLogs.filter((x) => /云学堂助手/.test(x.text)).slice(-40)) log(' [' + l.type + '] ' + l.text.slice(0, 170));
|
||||
} catch (e) {
|
||||
check('持续运行流程执行完毕', false, e && e.stack ? e.stack.split('\n').slice(0, 5).join(' | ') : String(e));
|
||||
} finally {
|
||||
if (cdp && !KEEP) cdp.close();
|
||||
if (chrome && !KEEP) { try { chrome.kill(); } catch (e) {} }
|
||||
if (!KEEP) { await sleep(700); try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch (e) {} }
|
||||
else log('[RUN] --keep:浏览器保持打开 ' + userDataDir);
|
||||
try {
|
||||
fs.writeFileSync(OUT, JSON.stringify({ timeline, results, logs: consoleLogs.slice(-400) }, null, 2));
|
||||
log('[RUN] 时间线已写入 ' + OUT);
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
const failed = results.filter((r) => !r.ok);
|
||||
log('\n===== RUN 结果:' + (results.length - failed.length) + '/' + results.length + ' 通过,失败 ' + failed.length + ' =====');
|
||||
for (const f of failed) log(' FAIL ' + f.name + ' → ' + JSON.stringify(f.detail));
|
||||
process.exit(failed.length ? 1 : 0);
|
||||
@@ -0,0 +1,329 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 真机测试:真实 Chrome + 真实 https://kfmic.yunxuetang.cn 页面。
|
||||
*
|
||||
* 做法:启动一个独立用户目录的 Chrome(不碰你日常配置),通过 CDP 把打包产物
|
||||
* yun-xue-tang-assistant.user.js 注入页面主世界——这与 Tampermonkey 在
|
||||
* @grant none 下的执行环境一致,所以断言的是脚本在真实浏览器 / 真实站点
|
||||
* DOM 上的行为,而不是 Node 里的 DOM 桩。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/real-test.mjs 有界面浏览器(默认,最接近真机)
|
||||
* node dev/real-test.mjs --headless 无头模式(CI 用)
|
||||
* node dev/real-test.mjs --keep 跑完不关浏览器(便于人工肉眼复核)
|
||||
*
|
||||
* 环境变量:
|
||||
* 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 截图目录,默认 .run-tmp/screenshots(不入库)
|
||||
*
|
||||
* 需要 Node 22+(用到全局 WebSocket 与 fetch);只做只读探测:
|
||||
* 不填写账号密码、不点登录、不修改线上数据。
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import os from 'node:os';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { connect, sleep, httpJson, findChrome, forceHeadless, safetyArgs } from './real-cdp.mjs';
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
// 本文件在 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,
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/chromium',
|
||||
'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
|
||||
].filter(Boolean);
|
||||
|
||||
const CHROME = findChrome(CANDIDATES);
|
||||
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, '.run-tmp', 'screenshots');
|
||||
|
||||
const results = [];
|
||||
const consoleLogs = [];
|
||||
const log = (...a) => console.log(...a);
|
||||
|
||||
function check(name, ok, detail) {
|
||||
results.push({ name, ok: !!ok, detail });
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
}
|
||||
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
console.error('需要 Node 22 及以上(依赖全局 WebSocket / fetch),当前 ' + process.version);
|
||||
process.exit(2);
|
||||
}
|
||||
if (!CHROME) {
|
||||
console.error('找不到 Chrome/Edge,可用 YUN_XUE_TANG_CHROME=/path/to/chrome 指定');
|
||||
process.exit(2);
|
||||
}
|
||||
if (!fs.existsSync(SCRIPT_FILE)) {
|
||||
console.error('缺少构建产物,先运行 npm run build');
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
// Linux 无图形化服务器:没有 DISPLAY 时强制无头,并补容器/root 必需参数
|
||||
const HEADLESS_ONLY = HEADLESS || forceHeadless();
|
||||
const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), 'yun-xue-tang-chrome-'));
|
||||
const args = [
|
||||
`--remote-debugging-port=${PORT}`,
|
||||
`--user-data-dir=${userDataDir}`,
|
||||
'--no-first-run', '--no-default-browser-check', '--disable-sync',
|
||||
'--disable-background-timer-throttling', '--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
'--window-size=1280,900',
|
||||
].concat(safetyArgs(), ['about:blank']);
|
||||
if (HEADLESS_ONLY) args.unshift('--headless=new');
|
||||
|
||||
let chrome = null;
|
||||
let cdp = null;
|
||||
|
||||
try {
|
||||
log('[真机] 浏览器:' + CHROME + (HEADLESS_ONLY ? '(headless=new)' : '(有界面)'));
|
||||
chrome = spawn(CHROME, args, { stdio: 'ignore', windowsHide: true });
|
||||
|
||||
// ---- 1. 等 CDP 就绪 ----
|
||||
let version = null;
|
||||
for (let i = 0; i < 100; i++) {
|
||||
try {
|
||||
const v = await httpJson(`http://127.0.0.1:${PORT}/json/version`);
|
||||
if (v && v.webSocketDebuggerUrl) { version = v; break; }
|
||||
} catch (e) { /* 还没起来 */ }
|
||||
await sleep(250);
|
||||
}
|
||||
if (!version) throw new Error('Chrome CDP 端口未就绪(' + PORT + ')');
|
||||
check('真实浏览器进程启动', /^(Chrome|HeadlessChrome|Edg)\//.test(version.Browser || ''), version.Browser);
|
||||
|
||||
// ---- 2. 打开真实页面 ----
|
||||
const target = await httpJson(`http://127.0.0.1:${PORT}/json/new?${encodeURIComponent(START_URL)}`, 'PUT');
|
||||
cdp = await connect(target.webSocketDebuggerUrl);
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
await cdp.send('Network.enable');
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
consoleLogs.push({ type: m.params.type, text: String(text) });
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
consoleLogs.push({ type: m.params.entry.level, text: m.params.entry.text });
|
||||
}
|
||||
});
|
||||
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', {
|
||||
expression: expr, returnByValue: true, awaitPromise: true, userGesture: true,
|
||||
});
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
|
||||
const loaded = cdp.waitEvent('Page.loadEventFired', 45000).catch(() => null);
|
||||
await cdp.send('Page.navigate', { url: START_URL });
|
||||
await loaded;
|
||||
await sleep(1800);
|
||||
|
||||
const page = await json(`JSON.stringify({ url: location.href, title: document.title, host: location.host, ua: navigator.userAgent })`);
|
||||
log('[真机] 页面:' + page.url);
|
||||
log('[真机] 标题:' + page.title);
|
||||
check('落在真实云学堂页面', /(^|\.)yunxuetang\.cn$/.test(page.host), page.host);
|
||||
check('真实浏览器内核', /Chrome\//.test(page.ua), page.ua.slice(0, 96) + '…');
|
||||
|
||||
// ---- 3. 注入(等价 Tampermonkey @grant none 主世界执行)----
|
||||
check('注入前页面无残留实例', (await evalJS('typeof window.__yunXueTangAuto')) === 'undefined', await evalJS('typeof window.__yunXueTangAuto'));
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1200);
|
||||
|
||||
const loadedLog = consoleLogs.find((l) => /云学堂助手 v[\d.]+ 已加载/.test(l.text));
|
||||
check('控制台打印加载日志', !!loadedLog, loadedLog && loadedLog.text);
|
||||
|
||||
// ---- 4. 面板在真实 DOM 里的渲染 ----
|
||||
const panel = await json(`JSON.stringify((() => {
|
||||
const el = document.getElementById('yun-xue-tang-panel');
|
||||
if (!el) return null;
|
||||
const r = el.getBoundingClientRect();
|
||||
const cs = getComputedStyle(el);
|
||||
return {
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent || '',
|
||||
w: Math.round(r.width), h: Math.round(r.height),
|
||||
right: Math.round(innerWidth - r.right), bottom: Math.round(innerHeight - r.bottom),
|
||||
visible: cs.display !== 'none' && cs.visibility !== 'hidden' && Number(cs.opacity) > 0,
|
||||
position: cs.position, zIndex: cs.zIndex,
|
||||
buttons: [...el.querySelectorAll('button')].map((b) => b.textContent.trim()),
|
||||
inputTypes: [...el.querySelectorAll('input')].map((i) => i.type),
|
||||
text: el.innerText.replace(/\\s+/g, ' ').trim().slice(0, 220),
|
||||
};
|
||||
})())`);
|
||||
check('面板渲染进真实 DOM 且可见', panel && panel.visible && panel.w > 0 && panel.h > 0,
|
||||
panel && { 宽: panel.w, 高: panel.h, position: panel.position, zIndex: panel.zIndex });
|
||||
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'),
|
||||
panel && { 按钮: panel.buttons, 输入框: panel.inputTypes });
|
||||
|
||||
// ---- 5. 真实页面上调试入口 / 页面识别 ----
|
||||
const api = await json(`JSON.stringify((() => {
|
||||
const a = window.__yunXueTangAuto;
|
||||
if (!a) return null;
|
||||
return {
|
||||
keys: Object.keys(a).length,
|
||||
route: a.route(),
|
||||
isLoginPage: a.isLoginPage(),
|
||||
hasDispose: typeof window.__yunXueTangDispose === 'function',
|
||||
courseId: a.courseIdFromUrl(),
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
};
|
||||
})())`);
|
||||
check('window.__yunXueTangAuto 调试入口存在', !!api && api.keys > 20, api && { 导出项: api.keys });
|
||||
check('真实登录页被正确识别', api && api.isLoginPage === true, api && { route: api.route, isLoginPage: api.isLoginPage });
|
||||
check('__yunXueTangDispose 可用(热替换前提)', api && api.hasDispose === true, api && api.hasDispose);
|
||||
check('登录页上 readSummary/readCountdown 安全返回 null',
|
||||
api && api.summary === null && api.countdown === null, api && { summary: api.summary, countdown: api.countdown });
|
||||
|
||||
// ---- 6. 真实点击面板按钮(不填账号,只验证不崩)----
|
||||
const click = await json(`JSON.stringify((() => {
|
||||
const panel = document.getElementById('yun-xue-tang-panel');
|
||||
const btn = document.getElementById('yun-xue-tang-oneclick');
|
||||
if (!btn) return { error: 'no #yun-xue-tang-oneclick' };
|
||||
btn.click();
|
||||
return {
|
||||
label: btn.textContent.trim(),
|
||||
panelVisibleAfter: getComputedStyle(panel).display !== 'none',
|
||||
statusLine: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
panelText: panel.innerText.replace(/\\s+/g, ' ').slice(0, 200),
|
||||
};
|
||||
})())`);
|
||||
await sleep(800);
|
||||
const afterClick = await json(`JSON.stringify(({
|
||||
url: location.href,
|
||||
alive: typeof window.__yunXueTangAuto,
|
||||
panel: !!document.getElementById('yun-xue-tang-panel'),
|
||||
}))`);
|
||||
check('点击「一键登录并刷课」不崩溃', afterClick.alive === 'object' && afterClick.panel === true, { 点击前标签: click.label, ...afterClick });
|
||||
|
||||
const scriptErrors = () => consoleLogs.filter((l) => l.type === 'error' && /云学堂助手/.test(l.text));
|
||||
check('无脚本自身 error 日志', scriptErrors().length === 0, scriptErrors().map((e) => e.text.slice(0, 140)));
|
||||
|
||||
// ---- 7. 真实 localStorage 读写 ----
|
||||
const ls = await json(`JSON.stringify((() => {
|
||||
const before = localStorage.getItem('yun-xue-tang-auto-play-enabled');
|
||||
localStorage.setItem('yun-xue-tang-auto-play-enabled', '0');
|
||||
const read = localStorage.getItem('yun-xue-tang-auto-play-enabled');
|
||||
if (before === null) localStorage.removeItem('yun-xue-tang-auto-play-enabled'); else localStorage.setItem('yun-xue-tang-auto-play-enabled', before);
|
||||
return { read, keys: Object.keys(localStorage).filter((k) => k.indexOf('yun-xue-tang-') === 0) };
|
||||
})())`);
|
||||
check('真实 localStorage 可读写', ls.read === '0', ls);
|
||||
|
||||
// ---- 8. 真实热替换:dispose → 重新注入 ----
|
||||
const hot = await json(`JSON.stringify((() => {
|
||||
window.__yunXueTangDispose();
|
||||
return { panel: !!document.getElementById('yun-xue-tang-panel'), api: typeof window.__yunXueTangAuto, dispose: typeof window.__yunXueTangDispose };
|
||||
})())`);
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(900);
|
||||
const hot2 = await json(`JSON.stringify({
|
||||
count: document.querySelectorAll('#yun-xue-tang-panel').length,
|
||||
api: typeof window.__yunXueTangAuto,
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent,
|
||||
timers: 'n/a',
|
||||
})`);
|
||||
check('dispose 后真实 DOM 面板被移除', hot.panel === false && hot.api === 'undefined',
|
||||
hot);
|
||||
check('重新注入后面板唯一且版本正确', hot2.count === 1 && hot2.api === 'object' && hot2.version === EXPECT_VERSION, hot2);
|
||||
|
||||
// ---- 9. 截图存证 ----
|
||||
try {
|
||||
fs.mkdirSync(SHOT_DIR, { recursive: true });
|
||||
const shot = await cdp.send('Page.captureScreenshot', { format: 'png' });
|
||||
const file = path.join(SHOT_DIR, 'real-chrome-login.png');
|
||||
fs.writeFileSync(file, Buffer.from(shot.data, 'base64'));
|
||||
const size = fs.statSync(file).size;
|
||||
check('真机截图已保存', size > 5000, path.relative(ROOT, file) + ' (' + size + ' 字节)');
|
||||
} catch (e) {
|
||||
check('真机截图已保存', false, e.message);
|
||||
}
|
||||
|
||||
// ---- 10. SPA 内 hash 路由(不换 document):脚本靠 hashchange 自更新,不需要重新注入 ----
|
||||
const hashNav = await json(`JSON.stringify((() => {
|
||||
location.hash = '#/list';
|
||||
return { hash: location.hash, route: window.__yunXueTangAuto.route(), panel: !!document.getElementById('yun-xue-tang-panel') };
|
||||
})())`);
|
||||
await sleep(600);
|
||||
const hashAfter = await json(`JSON.stringify({ hash: location.hash, route: window.__yunXueTangAuto.route(), alive: typeof window.__yunXueTangAuto })`);
|
||||
check('SPA 内 hash 切换后脚本自动跟随路由', hashAfter.route === 'list' && hashAfter.alive === 'object', { 切前: hashNav, 切后: hashAfter });
|
||||
|
||||
// ---- 11. 未登录访问 #/list:站点整页重定向到登录页(新 document)----
|
||||
// 真实 Tampermonkey 会在新 document 上按 @match 重新注入,这里同样重新注入后再断言。
|
||||
// 先订阅 load 事件再触发跳转,避免竞态。
|
||||
const redirected = cdp.waitEvent('Page.loadEventFired', 30000).catch(() => null);
|
||||
await evalJS(`(() => { window.__yunXueTangDocMarker = 'before-nav'; location.href = 'https://kfmic.yunxuetang.cn/kng/#/list'; return true; })()`);
|
||||
await redirected;
|
||||
await sleep(2500);
|
||||
|
||||
const afterNav = await json(`JSON.stringify({
|
||||
url: location.href,
|
||||
host: location.host,
|
||||
title: document.title,
|
||||
newDocument: window.__yunXueTangDocMarker === undefined,
|
||||
alive: typeof window.__yunXueTangAuto,
|
||||
})`);
|
||||
check('未登录访问 #/list 被站点重定向(document 已换新)',
|
||||
/(^|\.)yunxuetang\.cn$/.test(afterNav.host) && afterNav.newDocument === true, afterNav);
|
||||
check('新 document 上脚本未残留(重定向后必须重新注入)', afterNav.alive === 'undefined', afterNav.alive);
|
||||
|
||||
// 模拟 Tampermonkey 在新 document 上按 @match 自动注入
|
||||
await evalJS(SCRIPT_SRC);
|
||||
await sleep(1200);
|
||||
const reinjected = await json(`JSON.stringify({
|
||||
url: location.href,
|
||||
route: window.__yunXueTangAuto ? window.__yunXueTangAuto.route() : 'no-api',
|
||||
isLoginPage: window.__yunXueTangAuto ? window.__yunXueTangAuto.isLoginPage() : null,
|
||||
panel: document.querySelectorAll('#yun-xue-tang-panel').length,
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent,
|
||||
bodyScrollable: document.body.scrollHeight > 0,
|
||||
})`);
|
||||
check('重定向后重新注入:面板唯一且脚本正常',
|
||||
reinjected.panel === 1 && reinjected.version === EXPECT_VERSION && reinjected.route !== 'no-api', reinjected);
|
||||
check('列表页导航无脚本报错', scriptErrors().length === 0, scriptErrors().map((e) => e.text.slice(0, 140)));
|
||||
|
||||
// ---- 汇总控制台 ----
|
||||
log('\n[真机] 控制台共 ' + consoleLogs.length + ' 条,最后 15 条:');
|
||||
for (const l of consoleLogs.slice(-15)) log(' [' + l.type + '] ' + l.text.slice(0, 170));
|
||||
} catch (e) {
|
||||
check('真机流程执行完毕', false, e && e.stack ? e.stack.split('\n').slice(0, 4).join(' | ') : String(e));
|
||||
} finally {
|
||||
if (cdp && !KEEP) cdp.close();
|
||||
if (chrome && !KEEP) { try { chrome.kill(); } catch (e) {} }
|
||||
if (!KEEP) {
|
||||
await sleep(600);
|
||||
try { fs.rmSync(userDataDir, { recursive: true, force: true }); } catch (e) {}
|
||||
} else {
|
||||
log('[真机] YUN_XUE_TANG_KEEP=1,浏览器保持打开:' + userDataDir);
|
||||
}
|
||||
}
|
||||
|
||||
const failed = results.filter((r) => !r.ok);
|
||||
log('\n===== 真机结果:' + (results.length - failed.length) + '/' + results.length + ' 通过,失败 ' + failed.length + ' =====');
|
||||
for (const f of failed) log(' FAIL ' + f.name + ' → ' + JSON.stringify(f.detail));
|
||||
process.exit(failed.length ? 1 : 0);
|
||||
@@ -0,0 +1,212 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 学习统计(runner/study.mjs)自测:纯数据逻辑,假时钟,不需要浏览器也不碰终端。
|
||||
*
|
||||
* 为什么单独测:这段逻辑的口径一旦错,面板上的「已学 1:23:45 / 学分 12.75」就是假的,
|
||||
* 而这种错在日志里完全看不出来(日志只有收尾那一行)。用假时钟把
|
||||
* 「暂停不计时」「间隔过大不补计」「重复完成不重复计分」这些边界钉死。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/study-test.mjs
|
||||
* npm run test:study
|
||||
*/
|
||||
import { createStudyTracker } from '../../runner/study.mjs';
|
||||
|
||||
let failed = 0;
|
||||
function ok(cond, name, extra) {
|
||||
if (cond) console.log(' ✔ ' + name);
|
||||
else { failed++; console.log(' ✘ ' + name + (extra ? ' → ' + extra : '')); }
|
||||
}
|
||||
function eq(actual, expect, name) {
|
||||
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
|
||||
/** 假时钟:手动推进,不依赖真实时间 */
|
||||
function clock(start = 1700000000000) {
|
||||
let t = start;
|
||||
return { now: () => t, tick(sec) { t += sec * 1000; } };
|
||||
}
|
||||
|
||||
const video = (paused) => ({ t: 10, d: 100, paused, err: 0, src: 1 });
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 1. 学习时长:只在视频真的在播时累加
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学习时长');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 0, '首帧没有上一帧可比,不计时');
|
||||
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 2, '连续两帧都在播,累加 2 秒');
|
||||
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(true) });
|
||||
eq(s.get().studySeconds, 2, '这一帧已暂停:上一段播到暂停前就停了,不再补');
|
||||
|
||||
c.tick(30);
|
||||
s.update({ course: 'A', video: video(true) });
|
||||
eq(s.get().studySeconds, 2, '暂停 30 秒一点都不计(排队/挂机不算学习)');
|
||||
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
c.tick(3);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 5, '恢复播放后从 2 秒接着累加');
|
||||
|
||||
// 没有 video(列表页 / 加载中)等于没在播
|
||||
c.tick(10);
|
||||
s.update({ course: 'A', video: null });
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: null });
|
||||
eq(s.get().studySeconds, 5, 'video 为 null 时不计时(列表页/加载中的时间不算学习)');
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 5, '从 null 回到播放:这一帧不算(上一帧没在播)');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 2. 学习时长:间隔异常(浏览器重启 / 进程挂起)不补计
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('异常间隔');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
c.tick(600); // 10 分钟没有任何快照:中间肯定断过
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 0, '间隔 600 秒视为断线,不补计(上限 60 秒)');
|
||||
|
||||
c.tick(59);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 59, '间隔 59 秒仍在容忍范围内');
|
||||
|
||||
c.tick(61);
|
||||
s.update({ course: 'A', video: video(false) });
|
||||
eq(s.get().studySeconds, 59, '间隔 61 秒丢弃');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 3. 学分:边播边记,倒计时消失后沿用缓存
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学分读取');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
|
||||
s.update({ course: 'A', credit: 2.5, video: video(false) });
|
||||
eq(s.get().credit, 2.5, '播放期间读到本门可得学分');
|
||||
|
||||
// 学完后倒计时元素消失(credit=null),本门学分仍要显示
|
||||
s.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
eq(s.get().credit, 2.5, '倒计时消失后沿用缓存(否则面板会突然变 —)');
|
||||
eq(s.get().creditEarned, 2.5, '课程完成后计入获得学分');
|
||||
|
||||
// 换到新课,还没读到学分
|
||||
s.update({ course: 'B', credit: null, completed: 1, video: video(false) });
|
||||
eq(s.get().credit, null, '换课后本门学分先清空(还没读到新课的分)');
|
||||
|
||||
s.update({ course: 'B', credit: 1.25, completed: 1, video: video(false) });
|
||||
eq(s.get().credit, 1.25, '读到新课学分');
|
||||
s.update({ course: 'B', credit: null, completed: 2, video: video(false) });
|
||||
eq(s.get().creditEarned, 3.75, '第二门学完累加(2.5 + 1.25)');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 4. 学分:不重复计数
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('防重复计数');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
|
||||
s.update({ course: 'A', credit: 2.5, completed: 0, video: video(false) });
|
||||
s.update({ course: 'A', credit: 2.5, completed: 1, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '第一次完成计 2.5');
|
||||
|
||||
// completed 没变(页面刷新 / 重试后重复上报)
|
||||
for (let i = 0; i < 5; i++) s.update({ course: 'A', credit: 2.5, completed: 1, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '完成数没变不重复加');
|
||||
|
||||
// completed 涨到 2 但课程名还是 A(重试同一门又完成了一遍)——按课程去重,仍不加
|
||||
s.update({ course: 'A', credit: 2.5, completed: 2, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '同一门课重复完成不重复计分');
|
||||
|
||||
// 没读到过学分的课,完成后也不瞎加
|
||||
s.update({ course: 'C', credit: null, completed: 3, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, '没读到学分的课完成后不加分');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 5. 学分文本:浮点累加不出现 3.7499999
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学分文本');
|
||||
{
|
||||
const s = createStudyTracker({ now: clock().now });
|
||||
eq(s.creditText(3.75), '3.75', '3.75 原样输出');
|
||||
eq(s.creditText(1), '1', '整数不带小数点');
|
||||
eq(s.creditText(0.1 + 0.2), '0.3', '浮点误差被抹平(0.1+0.2)');
|
||||
eq(s.creditText(6.5), '6.5', '一位小数不带尾随 0');
|
||||
eq(s.creditText(12.75), '12.75', '两位小数');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 6. 摘要 / 空状态
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('摘要与空状态');
|
||||
{
|
||||
const s = createStudyTracker({ now: clock().now });
|
||||
eq(s.summary(), '', '什么都没学时摘要为空(收尾不该打一行 0 学时的废话)');
|
||||
eq(s.get().studySeconds, 0, '初始时长为 0');
|
||||
eq(s.get().creditEarned, 0, '初始学分为 0');
|
||||
eq(s.get().credit, null, '初始本门学分为 null');
|
||||
|
||||
const c = clock();
|
||||
const s2 = createStudyTracker({ now: c.now });
|
||||
s2.update({ course: 'A', credit: 2.5, video: video(false) });
|
||||
c.tick(3600);
|
||||
s2.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
// 间隔 3600 秒 > 60 被丢弃,所以时长仍是 0;这里主要是验证摘要格式
|
||||
eq(s2.summary(), '视频累计播放 00:00,获得 2.5 学分', '摘要把时长和学分写在一句里');
|
||||
|
||||
const c3 = clock();
|
||||
const s3 = createStudyTracker({ now: c3.now });
|
||||
s3.update({ course: 'A', video: video(false) });
|
||||
c3.tick(2);
|
||||
s3.update({ course: 'A', video: video(false) });
|
||||
eq(s3.summary(), '视频累计播放 00:02,获得 0 学分', '只有时长没有学分时也照常输出');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7. reset:重开一轮(supervisor 重启的会话之间)要能清零
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('重置');
|
||||
{
|
||||
const c = clock();
|
||||
const s = createStudyTracker({ now: c.now });
|
||||
s.update({ course: 'A', credit: 2.5, video: video(false) });
|
||||
c.tick(2);
|
||||
s.update({ course: 'A', credit: null, completed: 1, video: video(false) });
|
||||
ok(s.get().studySeconds > 0 && s.get().creditEarned > 0, '重置前有数据');
|
||||
|
||||
s.reset();
|
||||
eq(s.get().studySeconds, 0, 'reset 清空时长');
|
||||
eq(s.get().creditEarned, 0, 'reset 清空学分');
|
||||
eq(s.get().credit, null, 'reset 清空本门学分');
|
||||
eq(s.summary(), '', 'reset 后摘要为空');
|
||||
|
||||
// 重置后再来一门同名的课,应该能重新计分(去重表也清了)
|
||||
s.update({ course: 'A', credit: 2.5, completed: 1, video: video(false) });
|
||||
eq(s.get().creditEarned, 2.5, 'reset 后同名课程能重新计分');
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (failed) {
|
||||
console.log('学习统计自测:' + failed + ' 项失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('学习统计自测:全部通过');
|
||||
@@ -0,0 +1,449 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 终端面板(runner/tui.mjs)自测:纯函数 + 假终端渲染,不需要浏览器、不联网。
|
||||
*
|
||||
* 为什么需要它:面板的正确性全在「列宽」上——中文占 2 列、ANSI 转义不占列、
|
||||
* 截断后要补 reset。这三处一旦算错,边框就会歪或者把中文劈成半个,
|
||||
* 而这类问题是肉眼看日志发现不了的(日志文件里根本没有面板)。
|
||||
*
|
||||
* 用法:
|
||||
* node dev/tests/tui-test.mjs # 断言全部通过则退出码 0
|
||||
* npm run test:tui
|
||||
*/
|
||||
import { textWidth, stripAnsi, formatDuration, progressBar, visualRows, createTui } from '../../runner/tui.mjs';
|
||||
|
||||
let failed = 0;
|
||||
function ok(cond, name, extra) {
|
||||
if (cond) {
|
||||
console.log(' ✔ ' + name);
|
||||
} else {
|
||||
failed++;
|
||||
console.log(' ✘ ' + name + (extra ? ' → ' + extra : ''));
|
||||
}
|
||||
}
|
||||
function eq(actual, expect, name) {
|
||||
ok(actual === expect, name, '期望 ' + JSON.stringify(expect) + ',实际 ' + JSON.stringify(actual));
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 1. 列宽:中文 2 列、emoji 2 列、组合/控制字符 0 列
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('列宽计算');
|
||||
eq(textWidth('abc'), 3, 'ASCII 每字符 1 列');
|
||||
eq(textWidth('课程'), 4, '中文每字 2 列');
|
||||
eq(textWidth('课'), 2, '单字中文');
|
||||
eq(textWidth('(三)'), 6, '全角标点 2 列');
|
||||
eq(textWidth('a课b'), 4, '中英混排');
|
||||
eq(textWidth(''), 0, '空串 0 列');
|
||||
eq(textWidth('\x1b[32m课\x1b[0m'), 2, 'ANSI 序列不占列');
|
||||
eq(textWidth(stripAnsi('\x1b[1m\x1b[31mabc\x1b[0m')), 3, 'stripAnsi 后再量');
|
||||
eq(textWidth('😀'), 2, 'emoji 2 列');
|
||||
eq(textWidth('█░'), 2, '进度条字符 1 列(非全角)');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 2. 时长 / 进度条
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('时长与进度条');
|
||||
eq(formatDuration(0), '00:00', '0 秒');
|
||||
eq(formatDuration(72), '01:12', '72 秒');
|
||||
eq(formatDuration(3600), '1:00:00', '整小时');
|
||||
eq(formatDuration(3661), '1:01:01', '超一小时');
|
||||
eq(formatDuration(-5), '00:00', '负数按 0');
|
||||
eq(progressBar(0, 4), '░░░░', '0% 全空');
|
||||
eq(progressBar(1, 4), '████', '100% 全满');
|
||||
eq(progressBar(0.5, 4), '██░░', '50% 一半');
|
||||
eq(progressBar(2, 4), '████', '大于 1 截到 1');
|
||||
eq(progressBar(0.5, 4).length, 4, '进度条宽度准确');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 3. 帧渲染:假 stdout 捕获一帧,逐行量宽度
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('帧渲染');
|
||||
function makeFrame(opts) {
|
||||
const chunks = [];
|
||||
const out = {
|
||||
columns: opts.columns || 80,
|
||||
rows: opts.rows || 24,
|
||||
isTTY: true,
|
||||
write(s) { chunks.push(s); },
|
||||
on() {},
|
||||
removeListener() {},
|
||||
};
|
||||
const tui = createTui({
|
||||
enabled: true,
|
||||
out,
|
||||
stdin: null,
|
||||
color: opts.color !== false,
|
||||
logFile: './run-logs/headless.log',
|
||||
title: '面板测试',
|
||||
});
|
||||
if (opts.setup) opts.setup(tui, out);
|
||||
// 强制重画一帧(createTui 建的时候已经画过一帧,这里要最后一帧)
|
||||
tui.render();
|
||||
const frame = chunks[chunks.length - 1] || '';
|
||||
// 一帧内用 \r\n 分隔;最后一行后面紧跟 \x1b[0J
|
||||
const lines = frame.split('\r\n').map((l) => l.replace(/\x1b\[0J$/, '').replace(/\x1b\[K/g, ''));
|
||||
tui.finish();
|
||||
return { lines, chunks, frame, out, tui };
|
||||
}
|
||||
|
||||
const plain = makeFrame({ columns: 80, color: false });
|
||||
ok(plain.lines.length >= 12, '帧有足够行数(' + plain.lines.length + ' 行)');
|
||||
for (const line of plain.lines) {
|
||||
const w = textWidth(stripAnsi(line));
|
||||
ok(w <= 80, '行宽不超过 80 列', w + ' 列:' + JSON.stringify(stripAnsi(line)));
|
||||
}
|
||||
// 边框的三行必须等宽,否则右边框会锯齿
|
||||
const boxLines = plain.lines.filter((l) => /^[╭├╰│]/.test(stripAnsi(l)));
|
||||
const widths = [...new Set(boxLines.map((l) => textWidth(stripAnsi(l))))];
|
||||
eq(widths.length, 1, '所有框线行等宽(实际宽度集合:' + widths.join(',') + ')');
|
||||
ok(widths[0] === 80, '框线正好占满终端宽度', String(widths[0]));
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 4. 彩色帧:ANSI 序列混在中文里也不能顶歪边框
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('彩色帧');
|
||||
const colored = makeFrame({
|
||||
columns: 84,
|
||||
color: true,
|
||||
setup(tui) {
|
||||
tui.snap({
|
||||
course: '2025年安全生产月专题培训课程(第三期)',
|
||||
lesson: '第三章 事故应急处置与自救互救',
|
||||
summary: { text: '已学 62%' },
|
||||
countdown: 42,
|
||||
completed: 3,
|
||||
doneCount: 17,
|
||||
retryCount: 1,
|
||||
retryWait: 12,
|
||||
lessons: 8,
|
||||
video: { t: 812, d: 1320, paused: false, err: 0, src: 1 },
|
||||
});
|
||||
tui.set({ phase: '刷课中', tone: 'ok', injected: 4, maxCourses: 10 });
|
||||
},
|
||||
});
|
||||
ok(colored.frame.includes('\x1b['), '彩色帧里确实有 ANSI 序列');
|
||||
for (const line of colored.lines) {
|
||||
const w = textWidth(stripAnsi(line));
|
||||
ok(w <= 84, '彩色帧行宽不超过 84 列', w + ' 列');
|
||||
}
|
||||
const coloredBox = colored.lines.filter((l) => /^[╭├╰│]/.test(stripAnsi(l)));
|
||||
const cw = [...new Set(coloredBox.map((l) => textWidth(stripAnsi(l))))];
|
||||
eq(cw.length, 1, '彩色帧里框线仍等宽(' + cw.join(',') + ')');
|
||||
ok(cw[0] === 84, '彩色帧框线占满宽度', String(cw[0]));
|
||||
// 状态行不该出现「多余的省略号」(上一版把带色的状态行误判成超宽)
|
||||
const statusLine = colored.lines.find((l) => stripAnsi(l).includes('状态'));
|
||||
ok(statusLine && !stripAnsi(statusLine).includes('刷课中…'), '状态行没有被误截断');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 5. 窗口尺寸自适应:宽度跟随终端(不再封顶 120 列)+ 矮终端降级
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('窗口尺寸自适应');
|
||||
{
|
||||
// 宽终端(240 列):框线也得撑满 240,不能停在 120
|
||||
const wide = makeFrame({ columns: 240, rows: 30, color: false });
|
||||
const wideBox = wide.lines.filter((l) => /^[╭├╰│]/.test(stripAnsi(l)));
|
||||
const ww = [...new Set(wideBox.map((l) => textWidth(stripAnsi(l))))];
|
||||
eq(ww.length, 1, '240 列终端:框线仍等宽(' + ww.join(',') + ')');
|
||||
eq(ww[0], 240, '240 列终端:框线跟随终端宽度(不再封顶 120)');
|
||||
|
||||
// 每种高度下,帧的行数都不能超过窗口,否则会把回滚区里的历史顶掉
|
||||
for (const rows of [40, 30, 24, 20, 16, 14, 12, 10, 8]) {
|
||||
const f = makeFrame({ columns: 100, rows, color: false });
|
||||
ok(f.lines.length <= rows, rows + ' 行窗口:帧高 ' + f.lines.length + ' 不超过窗口');
|
||||
}
|
||||
|
||||
// 24 行:正常模式(有课时 / 日志行)
|
||||
const full = makeFrame({ columns: 100, rows: 24, color: false });
|
||||
ok(stripAnsi(full.lines.join('\n')).includes('课时'), '24 行窗口:显示课时行');
|
||||
ok(stripAnsi(full.lines.join('\n')).includes('已注入'), '24 行窗口:显示日志行');
|
||||
ok(stripAnsi(full.lines.join('\n')).includes('q 退出'), '24 行窗口:显示 q 提示');
|
||||
|
||||
// 12 行:紧凑模式,先丢课时/日志,保住视频进度与 q 提示
|
||||
const tight = makeFrame({ columns: 100, rows: 12, color: false });
|
||||
const tightText = stripAnsi(tight.lines.join('\n'));
|
||||
ok(!tightText.includes('课时'), '12 行窗口:省掉课时行');
|
||||
ok(tightText.includes('视频'), '12 行窗口:保留视频进度行');
|
||||
ok(tightText.includes('进度'), '12 行窗口:保留完成数行');
|
||||
ok(tightText.includes('q 退出'), '12 行窗口:仍显示 q 提示');
|
||||
ok(tightText.includes('最近日志'), '12 行窗口:保留日志区(只是变矮)');
|
||||
|
||||
// 8 行:极端矮,连 q 提示都省掉,也绝不能有半截框
|
||||
const tiny = makeFrame({ columns: 100, rows: 8, color: false });
|
||||
ok(tiny.lines.length <= 8, '8 行窗口:帧高不超过 8(实际 ' + tiny.lines.length + ')');
|
||||
ok(!tiny.lines[0].includes('\n'), '8 行窗口:标题行完整');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 6. 尺寸变化时重画不错位:上帧 24 行 → 窗口缩到 12 行
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('尺寸变化重绘');
|
||||
{
|
||||
const chunks = [];
|
||||
const ESC = String.fromCharCode(27);
|
||||
const CRLF = String.fromCharCode(13, 10);
|
||||
const ANSI_ALL = new RegExp(ESC + '\\\[[0-9;]*[A-Za-z]', 'g');
|
||||
const foldMarker = ESC + '[H';
|
||||
const out = {
|
||||
columns: 100, rows: 24, isTTY: true,
|
||||
write(s) { chunks.push(s); },
|
||||
on() {}, removeListener() {},
|
||||
};
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
tui.render();
|
||||
// 窗口缩小到 60×12:上帧每行 100 列,在 60 列下要折成 2 行,
|
||||
// 整块折完远超新窗口高度 —— 光标退不到块首,只能整屏重置
|
||||
out.rows = 12;
|
||||
out.columns = 60;
|
||||
chunks.length = 0;
|
||||
tui.redraw();
|
||||
const after = chunks.join('');
|
||||
ok(after.includes(foldMarker), '旧帧折行后比窗口还高时走整屏重置(ESC[H)');
|
||||
const lines = after.split(CRLF).map((l) => l.replace(ANSI_ALL, ''));
|
||||
const box = lines.filter((l) => /^[╭├╰│]/.test(l));
|
||||
const bw = [...new Set(box.map((l) => textWidth(l)))];
|
||||
eq(bw.length, 1, '缩窗后框线仍等宽(' + bw.join(',') + ')');
|
||||
eq(bw[0], 60, '缩窗后框线跟新宽度 60');
|
||||
ok(box.length <= 12, '缩窗后帧高不超过 12(实际 ' + box.length + ')');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 6b. 尺寸小幅变窄:折行后仍装得下窗口 → 精确回退,不整屏重置(保住可视历史)
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('小幅变窄');
|
||||
{
|
||||
const chunks = [];
|
||||
const ESC = String.fromCharCode(27);
|
||||
const out = { columns: 120, rows: 48, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
tui.render();
|
||||
// 120 列的行在 110 列下折成 2 行,整块约 42 行但仍装得进 48 行的窗口
|
||||
out.columns = 110;
|
||||
chunks.length = 0;
|
||||
tui.redraw();
|
||||
const frame = chunks.join('');
|
||||
ok(!frame.includes(ESC + '[2J'), '装得下时不整屏重置(不白白丢掉上方历史日志)');
|
||||
ok(/\x1b\[\d+A\x1b\[0J/.test(frame), '改用精确回退(向上退到旧帧首行)');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7. 没有 resize 事件的平台(Windows 传统控制台):靠定时刷新自己发现尺寸变化
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('无 resize 事件的尺寸变化');
|
||||
{
|
||||
const chunks = [];
|
||||
const CRLF = String.fromCharCode(13, 10);
|
||||
const ESC = String.fromCharCode(27);
|
||||
// 注意:on/removeListener 是空实现,模拟「平台根本不发 resize 事件」
|
||||
const out = {
|
||||
columns: 100, rows: 24, isTTY: true,
|
||||
write(s) { chunks.push(s); },
|
||||
on() {}, removeListener() {},
|
||||
};
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
tui.render();
|
||||
ok(chunks.length > 0, '首帧已画');
|
||||
|
||||
const boxWidths = (text) => [...new Set(text.split(CRLF).map(stripAnsi).filter((l) => /^[╭├╰│]/.test(l)).map(textWidth))];
|
||||
const boxHeight = (text) => text.split(CRLF).map(stripAnsi).filter((l) => /^[╭├╰│]/.test(l)).length;
|
||||
const clears = (text) => text.split(ESC + '[0J').length - 1;
|
||||
|
||||
// 最大化:100×24 → 180×40,全程不触发任何事件
|
||||
out.columns = 180;
|
||||
out.rows = 40;
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
eq(boxWidths(chunks.join('')).join(','), '180', '最大化后框线跟到 180 列(不靠 resize 事件)');
|
||||
|
||||
// 缩回去:同样没有事件,必须自己发现并清旧帧
|
||||
out.columns = 80;
|
||||
out.rows = 20;
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
const shrunk = chunks.join('');
|
||||
ok(shrunk.includes(ESC + '[2J'), '缩窗时整屏重置(旧帧折行后比窗口还高)');
|
||||
eq(boxWidths(shrunk).join(','), '80', '缩窗后框线跟到 80 列');
|
||||
ok(boxHeight(shrunk) <= 20, '缩窗后帧高不超 20 行');
|
||||
|
||||
// 尺寸没变时不该多清屏(每帧都清屏会闪)
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
eq(clears(chunks.join('')), 1, '尺寸未变时不多做清屏(只留帧尾那一次)');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7b. 最大化后还原:终端会把宽行折成多行,回退行数必须按折行后的可视行算
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('最大化后还原');
|
||||
{
|
||||
const chunks = [];
|
||||
const ESC = String.fromCharCode(27);
|
||||
const CRLF = String.fromCharCode(13, 10);
|
||||
const out = { columns: 180, rows: 40, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false, title: '面板测试' });
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
// 上一帧是 180 列宽的一整块面板(帧内用 CRLF 分隔,首行前面还有回退控制符);
|
||||
// 只看框线行,它们才是真正撑满宽度的内容行
|
||||
const wideWidths = chunks.join('').split(CRLF)
|
||||
.map((l) => stripAnsi(l))
|
||||
.filter((l) => /^[╭├╰│]/.test(l))
|
||||
.map(textWidth);
|
||||
ok(wideWidths.length > 0 && wideWidths.every((w) => w > 80), '上一帧那些框线行都比 80 列宽(还原后必然折行)');
|
||||
|
||||
const folded = visualRows(wideWidths, 80);
|
||||
ok(folded > wideWidths.length, '按 80 列重排后行数变多(' + wideWidths.length + ' → ' + folded + ' 行)');
|
||||
|
||||
ok(folded > 24, '折行后(' + folded + ' 行)比新窗口 24 行还高,光标退不到块首');
|
||||
|
||||
// 还原到 80 列:不发 resize 事件,靠定时刷新发现
|
||||
out.columns = 80;
|
||||
out.rows = 24;
|
||||
chunks.length = 0;
|
||||
tui.render();
|
||||
const back = chunks.join('');
|
||||
ok(back.includes(ESC + '[H') && back.includes(ESC + '[2J'), '还原时整屏重置,旧帧上半截不会残留');
|
||||
ok(!/\x1b\[\d+A\x1b\[0J/.test(back), '不再用「向上退 N 行」那条路径(退不到块首)');
|
||||
const box = back.split(CRLF).map(stripAnsi).filter((l) => /^[╭├╰│]/.test(l));
|
||||
eq([...new Set(box.map(textWidth))].join(','), '80', '重置后框线是 80 列');
|
||||
ok(box.length <= 24, '重置后帧高不超 24(实际 ' + box.length + ')');
|
||||
tui.finish();
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 7c. visualRows 纯函数
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('可视行换算');
|
||||
{
|
||||
eq(visualRows([80, 80, 80], 80), 3, '不折行时等于行数');
|
||||
eq(visualRows([160, 160], 80), 4, '两行 160 列在 80 列终端下折成 4 行');
|
||||
eq(visualRows([181], 80), 3, '181 列折成 3 行(向上取整)');
|
||||
eq(visualRows([], 80), 0, '空数组 0 行');
|
||||
eq(visualRows([0, 0], 80), 2, '空白行也占一行');
|
||||
eq(visualRows([40], 0), 1, '宽度非法时按 1 行算,不会崩');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 8. 窄终端:不超界、不硬截断(字段按重要性递降)
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('极端尺寸');
|
||||
const narrow = makeFrame({ columns: 36, rows: 12, color: true, setup(tui) {
|
||||
tui.snap({ course: '课程', completed: 3, doneCount: 17, lessons: 8, retryCount: 1, countdown: 812, video: { t: 812, d: 1320, paused: false, err: 0, src: 1 } });
|
||||
tui.set({ maxCourses: 10 });
|
||||
}});
|
||||
for (const line of narrow.lines) {
|
||||
ok(textWidth(stripAnsi(line)) <= 36, '36 列终端:行宽不超界', String(textWidth(stripAnsi(line))));
|
||||
}
|
||||
ok(narrow.lines.length <= 12, '矮终端帧行数不超过 12', String(narrow.lines.length));
|
||||
const narrowText = narrow.lines.map((l) => stripAnsi(l));
|
||||
const progressLine = narrowText.find((l) => l.includes('进度'));
|
||||
ok(progressLine.includes('本次') && progressLine.includes('累计'), '36 列:进度行保住本次/累计两个骨架字段');
|
||||
ok(!progressLine.includes('倒计时'), '36 列:进度行主动丢掉倒计时字段(而不是截断成省略号)');
|
||||
const videoLine = narrowText.find((l) => l.includes('视频'));
|
||||
ok(videoLine.includes('%'), '36 列:视频行保住百分比');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 9. 学习时长与学分:只算视频真在播的时间,学分只算刷完的课
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('学习时长与学分');
|
||||
{
|
||||
const chunks = [];
|
||||
const out = { columns: 100, rows: 24, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false });
|
||||
const snap = (o) => tui.snap({ course: 'A课', lessons: 3, video: { t: 10, d: 100, paused: false, err: 0, src: 1 }, ...o });
|
||||
|
||||
// 视频在播:靠真实的 Date.now 差累计,这里直接用间隔验证(把时钟往前拨太脏,改断言区间)
|
||||
snap({ credit: 2.5 });
|
||||
eq(tui.state.credit, 2.5, '学分:在播时从倒计时文案读到的本门学分');
|
||||
eq(tui.state.studySeconds, 0, '首帧没有上一帧可比,不计时');
|
||||
|
||||
// 暂停期间不累加:间隔再长也不计入
|
||||
tui.snap({ course: 'A课', video: { t: 10, d: 100, paused: true, err: 0, src: 1 } });
|
||||
const pausedAt = tui.state.studySeconds;
|
||||
tui.snap({ course: 'A课', video: { t: 10, d: 100, paused: true, err: 0, src: 1 } });
|
||||
eq(tui.state.studySeconds, pausedAt, '视频暂停时不计学习时长');
|
||||
|
||||
// 播放中才有增量(正常应 < 1 秒,断言「大于 0 且不超 30 秒封顶」)
|
||||
snap({ video: { t: 20, d: 100, paused: false, err: 0, src: 1 } });
|
||||
const t1 = tui.state.studySeconds;
|
||||
snap({ video: { t: 21, d: 100, paused: false, err: 0, src: 1 } });
|
||||
const t2 = tui.state.studySeconds;
|
||||
ok(t2 >= t1 && t2 - t1 < 30, '两帧之间按真实间隔累计', t1 + ' → ' + t2);
|
||||
|
||||
// 倒计时消失(学完)后沿用缓存,不会变回 —
|
||||
snap({ credit: undefined });
|
||||
eq(tui.state.credit, 2.5, '倒计时消失后沿用本门学分缓存');
|
||||
|
||||
// 真的完成了才发分;重复上报不重复计数
|
||||
snap({ completed: 1 });
|
||||
eq(tui.state.creditEarned, 2.5, '课程完成后计入获得学分');
|
||||
snap({ completed: 1 });
|
||||
eq(tui.state.creditEarned, 2.5, '完成数没变不重复加学分');
|
||||
|
||||
// 换课:学分清零待读,学完再累加
|
||||
snap({ course: 'B课', completed: 1, credit: 1.25 });
|
||||
eq(tui.state.credit, 1.25, '换课后读到新课的学分');
|
||||
snap({ course: 'B课', completed: 2, credit: null });
|
||||
eq(tui.state.creditEarned, 3.75, '第二门学完后累加(2.5 + 1.25)');
|
||||
|
||||
// 面板上真的画出来了吗
|
||||
tui.render();
|
||||
const frame = (chunks[chunks.length - 1] || '').split('\r\n').map(stripAnsi).join('\n');
|
||||
ok(frame.includes('学时'), '面板有「学时」行');
|
||||
ok(frame.includes('已学 '), '「学时」行显示学习时长');
|
||||
ok(frame.includes('学分 3.75'), '「学时」行显示累计学分', frame.match(/学分[^·│]*/)?.[0]);
|
||||
tui.finish();
|
||||
|
||||
// 暂停时提示「不计时」,避免用户以为面板死了
|
||||
const f2 = makeFrame({ columns: 100, rows: 24, color: false, setup(t2ui) {
|
||||
t2ui.snap({ course: 'A课', video: { t: 10, d: 100, paused: true, err: 0, src: 1 } });
|
||||
} });
|
||||
ok(f2.lines.map(stripAnsi).some((l) => l.includes('暂停中,不计时')), '暂停时明确提示不计时');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 10. 禁用时是空操作(上层可以无条件调用)
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('禁用即空操作');
|
||||
{
|
||||
const chunks = [];
|
||||
const out = { columns: 80, rows: 24, isTTY: false, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
let quitCalled = 0;
|
||||
const tui = createTui({ enabled: false, out, stdin: null, onQuit: () => quitCalled++ });
|
||||
tui.set({ phase: '不该出现' });
|
||||
tui.snap({ course: '不该出现', video: { t: 1, d: 2 } });
|
||||
tui.render();
|
||||
tui.finish();
|
||||
eq(chunks.length, 0, '禁用时不写任何字节');
|
||||
eq(tui.state.phase, '启动中', '禁用时 set 不改状态');
|
||||
eq(tui.logLines.length, 0, '禁用时不缓存日志');
|
||||
eq(quitCalled, 0, '禁用时不会触发退出回调');
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 11. 收尾:finish 只生效一次,且恢复光标 / 换行
|
||||
// ---------------------------------------------------------------------------
|
||||
console.log('收尾');
|
||||
{
|
||||
const chunks = [];
|
||||
const out = { columns: 80, rows: 24, isTTY: true, write(s) { chunks.push(s); }, on() {}, removeListener() {} };
|
||||
const tui = createTui({ enabled: true, out, stdin: null, color: false });
|
||||
chunks.length = 0;
|
||||
tui.finish();
|
||||
const after = chunks.join('');
|
||||
ok(after.includes('\x1b[?25h'), 'finish 恢复了光标(?25h)');
|
||||
ok(after.startsWith('\n'), 'finish 先换行,收尾日志不会盖在面板上');
|
||||
chunks.length = 0;
|
||||
tui.finish();
|
||||
eq(chunks.length, 0, '重复 finish 不重复输出');
|
||||
}
|
||||
|
||||
console.log('');
|
||||
if (failed) {
|
||||
console.log('TUI 自测:' + failed + ' 项失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('TUI 自测:全部通过');
|
||||
@@ -0,0 +1,54 @@
|
||||
# docker compose 用法:
|
||||
# cp .env.example .env # 填账号密码(.env 已在 .gitignore 里,不会入库)
|
||||
# docker compose build
|
||||
# docker compose run --rm yun-xue-tang --check # 先自检(只读,不登录)
|
||||
# docker compose run --rm yun-xue-tang --max-courses 3 # 只刷 3 门,跑完就退
|
||||
# docker compose up -d # 正式后台刷课
|
||||
# docker compose logs -f # 跟随日志(也可 tail -f ./run-logs/headless.log)
|
||||
# docker compose down # 停(SIGTERM → 暂停视频 → 关浏览器)
|
||||
#
|
||||
# 凭据走 environment 插值(compose 会自动读同目录的 .env),而不是 env_file:
|
||||
# 这样 .env 不存在时也不会直接报错,入口脚本会降级成 --check。
|
||||
services:
|
||||
yun-xue-tang:
|
||||
build: .
|
||||
image: yun-xue-tang-assistant:latest
|
||||
container_name: yun-xue-tang
|
||||
# 为什么不是 unless-stopped:运行器「刷完了」会以退出码 0 正常退出,
|
||||
# 而 unless-stopped / always 不看退出码,会造成「退出 → 立即重启 → 又刷完 → 再重启」的
|
||||
# 热循环,反复请求平台。on-failure 只在非 0 时重试,正常收尾就停下。
|
||||
# 想让它长期挂着,用运行器自己的 restartMinutes / budgetMinutes(见 config/runner.config.mjs),
|
||||
# 或用 cron 定期 `docker compose up -d`。
|
||||
restart: on-failure:3
|
||||
# 自带一个极小的 init(tini)当 PID 1:node 是它 exec 出来的子进程,
|
||||
# 信号照常透传(SIGTERM 仍能让运行器收尾),同时回收 Chrome 被收养的孤儿进程
|
||||
init: true
|
||||
environment:
|
||||
TZ: "${TZ:-Asia/Shanghai}"
|
||||
# 凭据只走环境变量,绝不写进镜像或提交到仓库
|
||||
YUN_XUE_TANG_USR: "${YUN_XUE_TANG_USR:-}"
|
||||
YUN_XUE_TANG_PWD: "${YUN_XUE_TANG_PWD:-}"
|
||||
# 面板要求 stdout 是 TTY,后台跑必须关(默认就是关的,这里显式写出来防误改)
|
||||
YUN_XUE_TANG_TUI: "0"
|
||||
# 本次最多完成几门课;0 = 不限
|
||||
YUN_XUE_TANG_MAX_COURSES: "${YUN_XUE_TANG_MAX_COURSES:-100}"
|
||||
volumes:
|
||||
# 持久化登录态(cookie / localStorage):删掉该目录等于重置登录与进度缓存
|
||||
# 注意:与裸机运行共用同一个目录,容器内以 root 写入,宿主机上会是 root 所有
|
||||
- ./.run-profile:/app/.run-profile
|
||||
# 日志跟着宿主机走,方便 tail -f
|
||||
- ./run-logs:/app/run-logs
|
||||
# 容器内 /dev/shm 默认 64MB,Chrome 多标签时容易崩;给大一点更稳
|
||||
# (运行器本身也加了 --disable-dev-shm-usage 兜底)
|
||||
shm_size: 512m
|
||||
# 运行器是前台进程,不需要端口映射(CDP 只监听容器内 127.0.0.1)
|
||||
stop_grace_period: 30s
|
||||
security_opt:
|
||||
# 容器内 Chrome 沙箱受限,运行器会自动加 --no-sandbox;
|
||||
# seccomp 默认策略也会拦 Chrome 的 namespace 调用,放宽到 unconfined 更省事
|
||||
- seccomp=unconfined
|
||||
logging:
|
||||
driver: json-file
|
||||
options:
|
||||
max-size: "10m"
|
||||
max-file: "3"
|
||||
@@ -0,0 +1,39 @@
|
||||
#!/bin/sh
|
||||
# 容器入口:只做三件事——兜底默认路径、保证 profile / 日志目录存在、必要时降级成自检。
|
||||
# 所有实际逻辑仍在 runner/headless.mjs 里,这里不复制任何业务判断,避免两处行为分叉。
|
||||
#
|
||||
# docker run 镜像 → 没凭据则 --check(只读自检),有凭据则正式刷课
|
||||
# docker run 镜像 --max-courses 3 → 参数原样透传给运行器
|
||||
# docker run -it 镜像 sh → 进容器排查
|
||||
set -e
|
||||
|
||||
PROFILE_DIR="${YUN_XUE_TANG_PROFILE_DIR:-/app/.run-profile}"
|
||||
LOG_FILE="${YUN_XUE_TANG_LOG_FILE:-/app/run-logs/headless.log}"
|
||||
export YUN_XUE_TANG_PROFILE_DIR="$PROFILE_DIR"
|
||||
export YUN_XUE_TANG_LOG_FILE="$LOG_FILE"
|
||||
|
||||
mkdir -p "$PROFILE_DIR" "$(dirname "$LOG_FILE")"
|
||||
# profile 里有登录 cookie,收窄权限(挂载卷时可能已经是宿主机权限,失败就算了)
|
||||
chmod 700 "$PROFILE_DIR" 2>/dev/null || true
|
||||
|
||||
# 第一个参数是可执行文件时直接 exec,方便 docker run -it 镜像 sh / node -v 之类排查
|
||||
case "${1:-}" in
|
||||
sh|bash|node|npm|google-chrome|google-chrome-stable|chromium)
|
||||
exec "$@"
|
||||
;;
|
||||
esac
|
||||
|
||||
# 没有参数且没填凭据:跑正式刷课只会被预检拦下(退出码 2),容器会反复重启。
|
||||
# 这里降级成 --check,让容器稳定地给出「环境 OK 但缺凭据」的结论。
|
||||
if [ "$#" -eq 0 ]; then
|
||||
if [ -z "${YUN_XUE_TANG_USR:-}" ] || [ -z "${YUN_XUE_TANG_PWD:-}" ]; then
|
||||
{
|
||||
echo "[入口] 未提供凭据,改为只读自检(--check):不登录、不点课程、不动进度。"
|
||||
echo "[入口] 正式刷课请带上环境变量:"
|
||||
echo "[入口] docker run -e YUN_XUE_TANG_USR=账号 -e YUN_XUE_TANG_PWD=密码 ..."
|
||||
} >&2
|
||||
set -- --check
|
||||
fi
|
||||
fi
|
||||
|
||||
exec node /app/runner/headless.mjs "$@"
|
||||
@@ -0,0 +1,25 @@
|
||||
=== 平台进度接口 study/summary ===
|
||||
026 finishNum=0/3 acqHours=0
|
||||
049 finishNum=1/3 acqHours=302
|
||||
|
||||
=== 脚本日志(切节瞬间) ===
|
||||
[2026-10-19T13:36:34.933Z] [page] [云学堂自动] 本节已记录,切换下一节…
|
||||
[2026-10-19T13:36:34.934Z] [page] [云学堂自动] 进入下一节
|
||||
[2026-10-19T13:36:40.930Z] [page] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
|
||||
[2026-10-19T13:36:43.870Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":0.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 5分钟 5秒 可完成本课程学习并
|
||||
[2026-10-19T13:36:48.784Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":5.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 5分钟 可完成本课程学习并获得0
|
||||
[2026-10-19T13:36:53.786Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":10.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 55秒 可完成本课程学
|
||||
[2026-10-19T13:36:58.799Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":15.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 50秒 可完成本课程学
|
||||
[2026-10-19T13:37:03.801Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":20.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 45秒 可完成本课程学
|
||||
[2026-10-19T13:37:08.802Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":25.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 40秒 可完成本课程学
|
||||
[2026-10-19T13:37:13.882Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":30.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 35秒 可完成本课程学
|
||||
[2026-10-19T13:37:18.815Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":35.6,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 30秒 可完成本课程学
|
||||
[2026-10-19T13:37:23.826Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":40.7,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 25秒 可完成本课程学
|
||||
[2026-10-19T13:37:28.842Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":45.7,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 20秒 可完成本课程学
|
||||
[2026-10-19T13:37:33.929Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=d8a4b8d0-430c-4f1e-9e0d-fcbd80f57e06&projectId=&btid=&gwnlUrl=&locateshare=f9d53a20-36f1-4900-bf13-5876d7582533","status":"学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":50.8,"duration":304.5,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"},"summary":"已完成 1/3","countdown":"还需 4分钟 15秒 可完成本课程学
|
||||
|
||||
=== 最终状态 ===
|
||||
summary: 已完成 1/3
|
||||
countdown: 还需 4分钟 10秒 可完成本课程学习并获得0.25学分,加油!
|
||||
video: {"paused": true, "ended": false, "currentTime": 55.7, "duration": 304.5, "muted": false, "rate": 1, "src": "blob:https://kfmic.yunxuetang.cn/b908a831-1c97-404c-b778-06b15314ddd1"}
|
||||
status: 自动刷课已暂停
|
||||
@@ -0,0 +1,6 @@
|
||||
2026-10-19T13:36:23.764Z | countdown='还需 10秒 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 0/3' | t=291.5 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:28.770Z | countdown='还需 5秒 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 0/3' | t=296.5 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:33.772Z | countdown='' | summary='已完成 1/3' | t=301.5 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:38.784Z | countdown='' | summary='已完成 1/3' | t=1.8 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》上(黄文杰)'
|
||||
2026-10-19T13:36:43.870Z | countdown='还需 5分钟 5秒 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 1/3' | t=0.6 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)'
|
||||
2026-10-19T13:36:48.784Z | countdown='还需 5分钟 可完成本课程学习并获得0.25学分,加油!' | summary='已完成 1/3' | t=5.6 | active='学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)'
|
||||
@@ -0,0 +1,164 @@
|
||||
{
|
||||
"title": "KFMI2025年品质能力强化培训(APQP/CP/FMEA) - 江丰云课堂",
|
||||
"url": "https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7",
|
||||
"iframes": [
|
||||
""
|
||||
],
|
||||
"catalogCount": 10,
|
||||
"catalogClass": [
|
||||
"yxtulcdsdk-catalog mb20"
|
||||
],
|
||||
"activeText": "视频2025-05-29--1",
|
||||
"activeHasLi": true,
|
||||
"summary": "已完成 0/8",
|
||||
"countdown": "还需 2小时 7分钟 59秒 可完成本课程学习并获得6.52学分,加油!",
|
||||
"countdownNorm": "还需2小时7分钟59秒可完成本课程学习并获得6.52学分,加油!",
|
||||
"oldRegexMatch": null,
|
||||
"newRegexMatch": [
|
||||
"2",
|
||||
"7",
|
||||
"59"
|
||||
],
|
||||
"tagTypes": [
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频",
|
||||
"视频"
|
||||
],
|
||||
"lessons": [
|
||||
{
|
||||
"text": "第1章:先期产品质量策划\n视频2025-05-29--1\n视频2025-05-29--2\n视频202",
|
||||
"active": true,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M4.286.146a.5.5 0 ",
|
||||
"M20 0H0v20h20z",
|
||||
"M10 2a8 8 0 100 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--1",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M20 0H0v20h20z",
|
||||
"M10 2a8 8 0 100 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--2",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--3",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-29--4",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--1",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--2",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "第2章:控制计划培训\n视频2025-05-30--3\n视频2025-05-30--4",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M4.286.146a.5.5 0 ",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16",
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--3",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
},
|
||||
{
|
||||
"text": "视频2025-05-30--4",
|
||||
"active": false,
|
||||
"hand": true,
|
||||
"paths": [
|
||||
"M0 0h20v20H0z",
|
||||
"M10 2a8 8 0 110 16"
|
||||
]
|
||||
}
|
||||
],
|
||||
"videos": [
|
||||
{
|
||||
"duration": 7829.442033,
|
||||
"paused": false,
|
||||
"ended": false,
|
||||
"muted": true,
|
||||
"rate": 1
|
||||
},
|
||||
{
|
||||
"duration": null,
|
||||
"paused": true,
|
||||
"ended": false,
|
||||
"muted": true,
|
||||
"rate": 1
|
||||
}
|
||||
],
|
||||
"startButtons": [
|
||||
"继续学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习",
|
||||
"开始学习"
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"activeTag": "LI",
|
||||
"activeClass": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16 liactive",
|
||||
"activeLiIndex": 1,
|
||||
"leafCount": 8,
|
||||
"leafIdx": 0,
|
||||
"activeLiText": "视频2025-05-29--1",
|
||||
"nextLeafText": "视频2025-05-29--2",
|
||||
"nextLeafHand": true,
|
||||
"oldFindIdx": 0,
|
||||
"oldNextText": "视频2025-05-29--1",
|
||||
"items": [
|
||||
{
|
||||
"i": 0,
|
||||
"cls": "",
|
||||
"directUl": true,
|
||||
"anyUl": true,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": true,
|
||||
"text": "第1章:先期产品质量策划\n视频2025-05-29--1\n视频2025-05-29--2\n视频2025-05-29--3"
|
||||
},
|
||||
{
|
||||
"i": 1,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16 liactive",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": true,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--1"
|
||||
},
|
||||
{
|
||||
"i": 2,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--2"
|
||||
},
|
||||
{
|
||||
"i": 3,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--3"
|
||||
},
|
||||
{
|
||||
"i": 4,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-29--4"
|
||||
},
|
||||
{
|
||||
"i": 5,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--1"
|
||||
},
|
||||
{
|
||||
"i": 6,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--2"
|
||||
},
|
||||
{
|
||||
"i": 7,
|
||||
"cls": "",
|
||||
"directUl": true,
|
||||
"anyUl": true,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "第2章:控制计划培训\n视频2025-05-30--3\n视频2025-05-30--4"
|
||||
},
|
||||
{
|
||||
"i": 8,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--3"
|
||||
},
|
||||
{
|
||||
"i": 9,
|
||||
"cls": "hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16",
|
||||
"directUl": false,
|
||||
"anyUl": false,
|
||||
"hand": true,
|
||||
"activeSelf": false,
|
||||
"hasActive": false,
|
||||
"text": "视频2025-05-30--4"
|
||||
}
|
||||
],
|
||||
"activeHtml": "<li class=\"hand font-w400 textcolorop6 linozj mb4 font-size-14 lh22 ml16 mr16 liactive\"><div class=\"ml24 flex-center flex-space-between\"><span class=\"yxtf-tooltip ulcdsdk-ellipsis-2 ulcdsdk-break item\" aria-describedby=\"yxtf-tooltip-2494\" tabindex=\"0\"><span class=\"tag-type mr6\">视频</span>2025-05-29--1</span><svg aria-hidden=\"true\" class=\"yxt-svg-icon mr14 ml14 hand\" style=\"display: inline-block; width: 20px; height: 20px;\" xmlns=\"http://www.w3.org/2000/svg\" width=\"20\" height=\"20\" viewBox=\"0 0 20 20\"><g fill=\"none\" fill-rule=\"evenodd\"><path d=\"M20 0H0v20h20z\"></path><path fill=\"currentColor\" fil"
|
||||
}
|
||||
@@ -0,0 +1,16 @@
|
||||
{
|
||||
"nextTag": "svg",
|
||||
"nextClass": "yxt-svg-icon mr14 ml14 hand",
|
||||
"nextLiText": "视频2025-05-29--2",
|
||||
"activeLiText": "视频2025-05-29--1",
|
||||
"leafTexts": [
|
||||
"视频2025-05-29--1",
|
||||
"视频2025-05-29--2",
|
||||
"视频2025-05-29--3",
|
||||
"视频2025-05-29--4",
|
||||
"视频2025-05-30--1",
|
||||
"视频2025-05-30--2",
|
||||
"视频2025-05-30--3",
|
||||
"视频2025-05-30--4"
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
PHASE: running
|
||||
UPDATED: 2026-10-19T13:20:57.653Z
|
||||
URL: https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7
|
||||
TITLE: KFMI2025年品质能力强化培训(APQP/CP/FMEA) - 江丰云课堂
|
||||
PANEL: True
|
||||
BATCH: True
|
||||
STATUS: 点击开始学习…
|
||||
STATS: 本次 0/10 · 失败 0
|
||||
COUNTDOWN: 还需 2小时 8分钟 34秒 可完成本课程学习并获得6.52学分,加油!
|
||||
SUMMARY: 已完成 0/8
|
||||
VIDEO: {"paused": false, "ended": false, "currentTime": 114.1, "duration": 7829.4, "muted": true, "rate": 1, "src": "blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"}
|
||||
S: {"running": true, "runFinished": false, "completedThisRun": 0, "consecutiveFailures": 0, "listUrl": "https://kfmic.yunxuetang.cn/kng/#/list?catalogId=&cid=f644032e-e9dd-4b81-9adf-48645c4d78aa&order=0&sort=0&type=", "listPage": 1, "current": {"title": "KFMI2025年品质能力强化培训(APQP/CP/FMEA)", "status": "学习中", "startedAt": 1792416015027, "page": 1}, "returning": false, "phase": "learning", "done": {}, "failed": {}}
|
||||
CARDS: 0
|
||||
|
||||
LOG MARKERS:
|
||||
进入课程: 2
|
||||
点击开始学习: 9
|
||||
学习中:: 1
|
||||
自动刷课已开启: 1
|
||||
pageerror: 4
|
||||
FATAL: 0
|
||||
loop error: 0
|
||||
|
||||
LOG TAIL:
|
||||
[2026-10-19T13:20:16.926Z] [nav] https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7
|
||||
[2026-10-19T13:20:16.953Z] [page] [云学堂自动] 学习中:视频2025-05-29--1
|
||||
[2026-10-19T13:20:17.591Z] screenshot -> C:\Users\void\Desktop\yunxuetang-auto-play\.run-tmp\13-batch-on.png
|
||||
[2026-10-19T13:20:17.594Z] batch enabled, watching...
|
||||
[2026-10-19T13:20:18.919Z] [page] [云学堂自动] 点击开始学习…
|
||||
[2026-10-19T13:20:22.600Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":79.1,"duration":7829.4,"muted":false,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 9分钟 9秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:27.604Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":84.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 9分钟 4秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:32.611Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":89.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 59秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:37.619Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":94.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 54秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:42.620Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":99.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 49秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:47.751Z] screenshot -> C:\Users\void\Desktop\yunxuetang-auto-play\.run-tmp\watch-006.png
|
||||
[2026-10-19T13:20:47.752Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":104.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 44秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:52.639Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":109.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 39秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
[2026-10-19T13:20:57.654Z] snapshot {"url":"https://kfmic.yunxuetang.cn/kng/#/course/play?kngId=ec43b92d-818a-4578-9101-379f81fee08f&projectId=&btid=&gwnlUrl=&locateshare=5b1ce1d6-3153-433e-b3e9-420ccd5798d7","status":"点击开始学习…","stats":"本次 0/10 · 失败 0","video":{"paused":false,"ended":false,"currentTime":114.1,"duration":7829.4,"muted":true,"rate":1,"src":"blob:https://kfmic.yunxuetang.cn/b44f9918-de1d-48a3-86a6-f200ad1cf6dd"},"summary":"已完成 0/8","countdown":"还需 2小时 8分钟 34秒 可完成本课程学习并获得6.52学分,加油!","current":{"title":"KFMI2025年品质能力强化培训(APQP/CP/FMEA)","status":"学习中","startedAt":1792416015027,"page":1}}
|
||||
@@ -0,0 +1,20 @@
|
||||
=== v2.0.3 复跑:第 2 节 -> 第 3 节 ===
|
||||
|
||||
平台 study/summary 接口:
|
||||
049 finishNum=0/8 acqHours=221
|
||||
073 finishNum=1/3 acqHours=342
|
||||
096 finishNum=2/3 acqHours=607
|
||||
|
||||
脚本日志(本地时间 21:50:46 - 21:50:53):
|
||||
[2026-10-19T13:50:46.567Z] [api] 200 https://api-phx-tc.yunxuetang.cn/kng/study/summary
|
||||
[2026-10-19T13:50:47.198Z] [page] [云学堂自动] 本节已记录,切换下一节…
|
||||
[2026-10-19T13:50:47.198Z] [page] [云学堂自动] 进入下一节
|
||||
[2026-10-19T13:50:49.202Z] [page] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
|
||||
[2026-10-19T13:50:52.966Z] [api] 200 https://api-phx-tc.yunxuetang.cn/kng/study/kngPlay
|
||||
[2026-10-19T13:50:53.198Z] [page] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》下(钱百峰)
|
||||
|
||||
最终状态:
|
||||
summary=已完成 2/3
|
||||
status=自动刷课已暂停
|
||||
video={"paused": true, "ended": false, "currentTime": 58.4, "duration": 273, "muted": false, "rate": 1, "src": "blob:https://kfmic.yunxuetang.cn/3d699349-bcb6-40eb-a7f8-67b9602149a2"}
|
||||
countdown=还需 3分钟 35秒 可完成本课程学习并获得0.23学分,加油!
|
||||
@@ -0,0 +1,68 @@
|
||||
云学堂助手 v2.5.2 · 起点对齐回归(本地复刻目录)
|
||||
==================================================
|
||||
|
||||
背景
|
||||
----
|
||||
用户反馈:进入课程后不会从「第一个未学完的课时」开始,前面的课时被跳过 / 整门课学不完。
|
||||
真实站点需要登录,无法在本地直接复现,因此按 docs/archive/v2.0-snapshots/probe.txt、probe2.txt、probe4.txt
|
||||
里记录的真实目录结构,复刻课程页 DOM,再用无头 Chromium 注入用户脚本跑 20 秒,
|
||||
读取目录高亮、面板状态与控制台日志。复刻页面与用例脚本在 .run-tmp/align/(本机调试用,未入库)。
|
||||
|
||||
复刻的真实结构(来自 probe2.txt / probe4.txt)
|
||||
--------------------------------------------
|
||||
- .yxtulcdsdk-catalog ul > li:章节点含子 ul,课时是叶子 li
|
||||
- 课时 li > div.ml24.flex-center.flex-space-between > span.item(tag-type 在标题之前)+ 右侧 svg 状态图标
|
||||
- 完成态图标:起点 M10 2.75 的实心圆 + 对勾;未学完:空心圆;当前课时:带「!」的圆
|
||||
- 进入课程时平台停在「上次学习的位置」(用例里用 resume 参数模拟)
|
||||
- 本节视频 ended 后平台把完成数 +1,脚本据此切下一节
|
||||
|
||||
用例与结果(v2.5.1 → v2.5.2)
|
||||
------------------------------
|
||||
A1 批量 · 点击句柄在 li PASS → PASS
|
||||
A2 批量 · 点击句柄在行容器 PASS → PASS
|
||||
A3 批量 · 点击句柄在标题 span FAIL(停在平台上次位置第 5 节)→ PASS
|
||||
A4 批量 · 点击句柄在状态图标 PASS(第 6 次点击才命中)→ PASS
|
||||
A5 批量 · 完成态只有文字标签 FAIL(已学完被当成未学,退回第 1 节)→ PASS
|
||||
A6 批量 · 全部未学 PASS → PASS
|
||||
A7 批量 · 切换有确认弹窗 PASS → PASS
|
||||
A8 批量 · 目标在折叠章(展开箭头是 svg) PASS → PASS(展开章节日志正常)
|
||||
A9 手动 · 点击句柄在 li FAIL(完全不对齐,停在第 5 节)→ PASS
|
||||
A10 手动 · 点击句柄在标题 span FAIL(同上)→ PASS
|
||||
A11 批量 · 本节结束后切下一节 FAIL(记账后仍停在第 3 节)→ PASS
|
||||
A12 批量 · 本节结束后切下一节(图标句柄) FAIL(同上)→ PASS
|
||||
A13 手动 · 本节结束后切下一节 FAIL(未对齐,无进展)→ PASS
|
||||
|
||||
汇总:v2.5.1 = 6 PASS / 7 FAIL;v2.5.2 = 13 PASS / 0 FAIL
|
||||
|
||||
原因
|
||||
----
|
||||
1) clickLesson() 只点 li 和「li 内第一个 .hand」。真实目录里 .hand 是右侧的 <svg>,
|
||||
而 SVGSVGElement 没有 HTMLElement.click()(Chromium 实测 typeof svg.click === 'undefined'),
|
||||
svg.click() 抛 TypeError 后被 try/catch 静默吞掉,等于没点;句柄挂在标题 span /
|
||||
行容器上时,前 4 次点击都没命中,脚本就放弃并「按当前位置继续」。
|
||||
2) isLessonCompleted() 的文本兜底写成 /(已学完|已完成)$/,要求标签出现在 li 文本末尾;
|
||||
真实目录的 tag-type 在标题之前(probe2.txt:<span class="tag-type">视频</span>标题),
|
||||
标成「已学完 第1节」时永远匹配不到 → 已学完的课时被当成未学 → 目标退回第 1 节。
|
||||
3) 起点对齐只写在 courseTick()(批量刷课)里,manualCourseTick()(手动打开课程)没有对齐。
|
||||
4) findNextLessonElement() 返回 li 内第一个 .hand(真实目录里是 svg),
|
||||
advanceLesson() / manualCourseTick() 直接 next.click() → 同 (1),切节点击不生效。
|
||||
(docs 里 2.0.3 实跑看起来「切成功」,其实是平台自己播完自动连播。)
|
||||
|
||||
修复(v2.5.2)
|
||||
--------------
|
||||
- 新增 clickNode():HTMLElement 用 click(),svg 等没有 click() 的节点改派发 MouseEvent。
|
||||
- clickLesson() 按「标题 span → 行容器 → li → 状态图标」逐次尝试,并补 pointer/mouse 序列;
|
||||
对齐重试次数 4 → 8。
|
||||
- isLessonCompleted() 文案匹配去掉结尾锚定,并补充 aria-label/title/class 语义与图标路径兜底。
|
||||
- 起点对齐抽成 alignToFirstIncomplete(),courseTick() 与 manualCourseTick() 共用;
|
||||
手动模式按课程标题判断换课,每门课只对齐一次,标题还是 loading 时不做任何判断。
|
||||
- findNextLessonElement() 改回返回课时 li;切节用 switchLesson()(标题 → 行容器 → li → 图标,
|
||||
每步先确认还没切过去),advanceLesson() 与手动连播共用。
|
||||
- 章节展开、确认弹窗按钮统一走 clickNode();确认弹窗只在弹层内找按钮,避免误点页面其它按钮。
|
||||
|
||||
复现方式(本机)
|
||||
----------------
|
||||
$env:PLAYWRIGHT_PATH="<playwright 包目录>"
|
||||
$env:CHROME_PATH="<chromium 可执行文件>"
|
||||
node .run-tmp/align/run.mjs # 当前脚本
|
||||
$env:SCRIPT=".run-tmp/align/before.user.js"; node .run-tmp/align/run.mjs # 修复前对照
|
||||
@@ -0,0 +1,142 @@
|
||||
云学堂助手 v2.7.0 · 单视频自动播放 / 完成后转下一门 实跑与回归
|
||||
================================================================
|
||||
|
||||
结论
|
||||
----
|
||||
用户反馈的两个问题是同一个根因链条上的两处断点,均已在真实站点复现并修复:
|
||||
|
||||
1) 进入课程「有概率」不自动播放
|
||||
- 平台的播放页不只有 #/course/play。单个视频课程点开后走的是
|
||||
#/scan?kngId=… -> #/video/play?kngId=…,音频/课件还有 #/audio/play、#/ppt/play。
|
||||
- v2.6.0 的 route() 只把 #/course/play 识别为课程页,其它播放页返回 'other',
|
||||
主循环既不跑 courseTick 也不跑 manualCourseTick:不点「开始学习」、不接管视频。
|
||||
- 真实站点「氦泄漏通用」(type=2 / fileType=video / 60 秒,列表第 307 页)复现:
|
||||
进课后 150 秒内 S.phase 一直是 entering,video=null,面板停在
|
||||
「进入课程(1 分钟):氦泄漏通用」,done=0。
|
||||
|
||||
2) 一门课学完后不自动转到下一门
|
||||
- 平台课程真正学完时,汇总文案会从「已完成 0/1」变成 **「已完成学习」**;
|
||||
单视频页则是「已完成 0%」->「已完成 67%」-> **「已完成学习」**。
|
||||
此时倒计时和进度条都会消失。
|
||||
- v2.6.0 的 readSummary() 只匹配 /已完成(\d+)\/(\d+)/,读不到「已完成学习」和百分比,
|
||||
永远不判完成:停在课程页、不回列表、也不选下一门;而且播放器会把视频重置到 0 秒,
|
||||
v.ended 变回 false,脚本又调用 play() 从头重播。
|
||||
- 真实站点「如何搭建分销体系,实现用户指数级增长?(上篇)」(1 节 / 127 秒)复现:
|
||||
127 秒时 study/summary 已返回 finishNum=1/1、acqHours=127,页面汇总变成「已完成学习」,
|
||||
但 20 秒后 S.completedThisRun 仍为 0、S.current 未清空,video 被重新 play 到 0.5 秒。
|
||||
|
||||
真实站点证据
|
||||
------------
|
||||
复现环境:https://kfmic.yunxuetang.cn(江丰云课堂),2026-10-22,Asia/Shanghai。
|
||||
登录凭据来自用户级环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,没有写入脚本或仓库。
|
||||
|
||||
A. 单视频课程的实际路由与完成文案(#/video/play)
|
||||
------------------------------------------------
|
||||
NAV /kng/#/scan?kngId=283c683a-fa98-4f69-9e08-c45116118aa1
|
||||
NAV /kng/#/video/play?kngId=283c683a-fa98-4f69-9e08-c45116118aa1&projectId=&btid=&gwnlUrl=
|
||||
NET /kng/study/kngInfo {"title":"氦泄漏通用","type":2,"fileType":"video",...}
|
||||
NET /kng/study/summary {"finishNum":0,"totalNum":1,...,"studyHours":60}
|
||||
页面汇总:已完成 0% -> 已完成 33% -> 已完成 67% -> 已完成学习
|
||||
倒计时: 还需 59秒 …(从 60 秒开始,注意视频本身 107 秒,平台按 required time 计时)
|
||||
开始按钮:<button class="yxtf-button yxtf-button--primary yxtf-button--larger">开始学习</button>
|
||||
|
||||
修复前(v2.6.0)在该页连续 150 个 tick 的状态:
|
||||
status=进入课程(1 分钟):氦泄漏通用
|
||||
phase=entering done=0 video=- sum=已完成0% 150 秒无变化
|
||||
|
||||
B. 多课时课程完成后汇总变成「已完成学习」
|
||||
----------------------------------------
|
||||
NET /kng/study/summary {"finishNum":0,"totalNum":1,...,"studyHours":127}
|
||||
[14s] 页面汇总:已完成0/1
|
||||
[21s] 视频开始播放:video=play@0/127.1
|
||||
[148s] NET /kng/study/summary {"finishNum":1,"totalNum":1,"acqHours":127,...}
|
||||
[149s] 页面汇总:已完成学习(倒计时、进度条消失)
|
||||
status=学习中:视频如何搭建分销体系,实现用户指数型增长?(上)
|
||||
done=0 video=PAUSE@0/127.1
|
||||
[150s] video=play@0.5/127.1 ← 平台重置后脚本又把视频从头播放
|
||||
|
||||
修复内容(v2.7.0)
|
||||
------------------
|
||||
1) route() 识别全部播放页:#/course/play、#/video/play、#/audio/play、#/ppt/play、
|
||||
#/document/play、#/article/play,以及进课过渡页 #/scan。
|
||||
新增 mediaPage() 区分「有目录的多课时课程」和「单媒体播放页」。
|
||||
|
||||
2) readSummary() 同时解析三种真实完成文案:
|
||||
- 已完成 2/3 -> { x:2, y:3, complete:false, kind:'ratio' }
|
||||
- 已完成 67% -> { x:67, y:100, complete:false, kind:'percent' }
|
||||
- 已完成学习 -> { x:100, y:100, complete:true, kind:'done' }
|
||||
另用 [role="progressbar"] 的 aria-valuenow 兜底。
|
||||
|
||||
3) courseTick():
|
||||
- 单视频/音频页不再走目录对齐,也不把百分比进度当成「一节学完」去切节;
|
||||
- 汇总 complete 时(比例满、100%、已完成学习)统一 completeCurrent();
|
||||
- 新增 doneLatchKey:倒计时归零/video.ended 后记住本节已播完,
|
||||
平台把播放器重置到 0 秒时不再自动 play,避免完成后重播;
|
||||
- 单媒体页等待记账时只轮询汇总,不调用 advanceLesson()。
|
||||
|
||||
4) 进课判定改用 URL 的 kngId:startCourse() 把课程 id 写入 S.current.id,
|
||||
courseTick() 优先用 kngId 比对,标题短暂是 loading.../在线课堂 时不再误判;
|
||||
宽限从 12 秒提高到 30 秒(CFG.entryGraceMs)。#/scan 只是过渡页,此时不做完成判定,
|
||||
防止读到上一门课残留的「已完成学习」。
|
||||
|
||||
5) 自动播放兜底:「开始学习」冷却 15 秒 -> 3 秒(3 秒没起播就补点);
|
||||
选择器在 button/a 之外支持最内层 div/span,并跳过 disabled 按钮;
|
||||
手动模式(手动课程自动连播)在单媒体页也会点开始;
|
||||
点课程卡片后 4 秒仍停在列表时自动补点,最多 2 次,不再直接记为失败跳过。
|
||||
|
||||
6) 完成文案连续两次读到才确认(三种完成文案统一),避免 SPA 切页瞬间
|
||||
把上一门课的完成文案算到新课程上。completeCurrent() 改为强制返回列表
|
||||
(不受 goToList 5 秒节流影响),并先 pause 播放器;列表页把「已完成/已学习」
|
||||
也当作完成状态过滤。
|
||||
|
||||
回归用例(本地复刻 DOM,Playwright)
|
||||
------------------------------------
|
||||
node .run-tmp/align/run.mjs => 13 PASS / 0 FAIL(起点对齐 + 自动切节)
|
||||
node .run-tmp/complete/run.mjs => 8 PASS / 0 FAIL
|
||||
E1 首次点卡片无反应:自动补点进入课程
|
||||
U1 readSummary 解析 x/y、百分比、已完成学习
|
||||
U2 route 识别 course/video/audio/ppt/scan
|
||||
V1 单视频课:自动播放 -> 完成后进入下一门
|
||||
C1 多课时课:已完成学习 -> 回列表 -> 下一门
|
||||
L1 标题 loading 但 kngId 匹配:不误判、继续播放
|
||||
T1 倒计时归零后平台重置视频:不重播,汇总更新后照常进入下一门
|
||||
D1 「开始学习」是 div 时仍能自动播放
|
||||
|
||||
真机修复后验证
|
||||
--------------
|
||||
场景 1:已完成的多课时课程(#/course/play,汇总「已完成学习」)
|
||||
[11s] 课程完成:如何搭建分销体系,实现用户指数级增长?(上篇)第 1 门,返回列表选下一门
|
||||
[12s] NAV /kng/#/list
|
||||
[15s] 回到列表第 1 页,继续…
|
||||
[22s] 短课程队列已就绪:待学 5131 门;最短 2 分钟
|
||||
[25s] 进入课程(2 分钟):如何制定渠道战略
|
||||
[27s] 跳过:如何制定渠道战略(课程包含考试/测验章节)
|
||||
[28s] 回到列表第 13 页,继续… -> 第 63 页
|
||||
[31s] 进入课程(2 分钟):APP做裂变的三大专属玩法
|
||||
[38s] 学习中:视频APP做裂变的三大专属玩法(video=0.6/132.1)
|
||||
[PASS] complete=true next=APP做裂变的三大专属玩法 playing=true
|
||||
|
||||
场景 2:已完成的单视频课程(#/video/play,汇总「已完成学习」)
|
||||
[11s] 课程完成:氦泄漏通用 第 1 门,返回列表选下一门
|
||||
[12s] NAV /kng/#/list
|
||||
[16s] 短课程队列已就绪:待学 5131 门;最短 2 分钟
|
||||
[19s] 进入课程(2 分钟):如何制定渠道战略 -> 跳过(考试/测验章节)
|
||||
[25s] 进入课程(2 分钟):APP做裂变的三大专属玩法
|
||||
[32s] 学习中:视频APP做裂变的三大专属玩法(video=1.3/132.1)
|
||||
[PASS] complete=true next=APP做裂变的三大专属玩法 playing=true
|
||||
|
||||
复现命令(本机)
|
||||
----------------
|
||||
$env:PLAYWRIGHT_PATH="<playwright 包目录>"
|
||||
$env:CHROME_PATH="<chromium 可执行文件>"
|
||||
node .run-tmp/align/run.mjs
|
||||
node .run-tmp/complete/run.mjs
|
||||
# 真机观测/验证需要 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD
|
||||
$env:YUN_XUE_TANG_USR=...; $env:YUN_XUE_TANG_PWD=...
|
||||
node .run-tmp/real/probe-bugs2.mjs # 修复前:video/play 全程不动作
|
||||
node .run-tmp/real/verify-fix.mjs # 修复后:两个场景 PASS
|
||||
|
||||
清理说明
|
||||
--------
|
||||
- 登录态 storageState(.run-tmp/real/state.json)与调试截图只在本地调试目录,验证完成后删除。
|
||||
- 仓库内没有写入账号、密码、token 或 cookie。
|
||||
@@ -0,0 +1,5 @@
|
||||
还需2小时7分钟59秒可完成本课程学习并获得6.52学分,加油! -> 7679
|
||||
还需5分钟可完成本课程学习并获得0.25学分,加油! -> 300
|
||||
还需4分钟10秒可完成本课程学习并获得0.25学分,加油! -> 250
|
||||
还需59秒可完成本课程学习并获得0.25学分,加油! -> 59
|
||||
已完成 -> null
|
||||
@@ -0,0 +1,361 @@
|
||||
云学堂助手 · 无头运行(Linux 无图形化服务器)证据
|
||||
==================================================
|
||||
|
||||
一、需求
|
||||
- 用户诉求:「支持无头模式运行在linux无图形化服务器上」。
|
||||
- 澄清后的范围:新增无头运行器 + 部署说明;常驻方式为手动前台跑(tmux/nohup,
|
||||
不做 systemd / Docker);持久化 profile,掉登录时用环境变量账号自动重登。
|
||||
|
||||
|
||||
二、方案
|
||||
新增 `runner/`,不装 Tampermonkey、不装桌面环境、不需要 Xvfb:
|
||||
|
||||
| 文件 | 作用 |
|
||||
| --- | --- |
|
||||
| runner/headless.mjs | 入口(约 90 行):解析参数 → 预检 → 交给 supervisor |
|
||||
| runner/config.mjs | 命令行参数与环境变量(--max / YUN_XUE_TANG_* 集中在此) |
|
||||
| runner/preflight.mjs | 启动前检查:产物、Node 版本、凭据、浏览器、调试端口 |
|
||||
| runner/log.mjs | 终端 + 文件日志(5MB 轮转) |
|
||||
| runner/stop.mjs | SIGINT / SIGTERM 优雅退出(注册式收尾) |
|
||||
| runner/browser.mjs | 浏览器探测(含 Linux/容器常见路径)、启动参数、陈旧 SingletonLock 清理 |
|
||||
| runner/cdp.mjs | 极简 CDP 客户端(Node 22+ 原生 WebSocket + fetch,无第三方依赖) |
|
||||
| runner/page.mjs | 注入后要调用的页面 JS 表达式 + page.evalJS/json/tryEval |
|
||||
| runner/session.mjs | 单次会话:起浏览器 → 注入 → 自动重登 → 起批量 → 监控 → 收尾 |
|
||||
| runner/selfcheck.mjs | --check 的只读环境自检 |
|
||||
| runner/supervisor.mjs | 崩溃重启循环与退出码 |
|
||||
|
||||
依赖方向是单向的:headless → supervisor → session → page/selfcheck → cdp,无循环引用。
|
||||
按需求不打包:node runner/headless.mjs 直接跑多文件 ESM,部署时整个 runner/ 目录一起带走。
|
||||
改脚本内部 API(window.__yunXueTangAuto 上的方法)时只需要改 runner/page.mjs。
|
||||
|
||||
注入方式与 Tampermonkey 等价:用 `Runtime.evaluate` 把构建产物源码注入页面主世界
|
||||
(脚本 `@grant none`,不需要沙箱隔离),因此每次整页跳转(新 document)都要重新注入,
|
||||
运行器用 1.5 秒的看护循环检测 `window.__yunXueTangAuto` 是否存在并补注入。
|
||||
|
||||
|
||||
三、Linux 无图形化环境的三个必踩坑(与代码对应)
|
||||
1) 没有 DISPLAY:有界面模式直接报 `Missing X server or $DISPLAY` 并退出。
|
||||
- `runner/browser.mjs:hasDisplay()` 判 `DISPLAY` / `WAYLAND_DISPLAY`;
|
||||
- `runner/headless.mjs` 里 `VISIBLE = WANT_VISIBLE && hasDisplay()`,
|
||||
即**即使传了 `--visible` 也会被强制无头并打警告**;
|
||||
- `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`。
|
||||
3) 容器 /dev/shm 只有 64MB:标签页会莫名崩溃(`Target closed`)。
|
||||
- Linux 上恒加 `--disable-dev-shm-usage`。
|
||||
|
||||
另外补的稳定性参数:`--no-zygote`、`--disable-gpu`、`--mute-audio`、
|
||||
`--autoplay-policy=no-user-gesture-required`(无人值守必须能自己起播)、
|
||||
`--disable-background-timer-throttling` / `--disable-renderer-backgrounding` /
|
||||
`--disable-backgrounding-occluded-windows`(后台标签页不节流,否则计时会停)。
|
||||
|
||||
实测(在 Windows 上把 process.platform 覆盖成 linux、getuid 覆盖成 0 验证分支取值):
|
||||
|
||||
safetyArgs() root ["--disable-dev-shm-usage","--no-sandbox","--disable-setuid-sandbox","--disable-gpu"]
|
||||
hasDisplay() 无 DISPLAY false
|
||||
hasDisplay() 有 DISPLAY true
|
||||
关键参数(root 无头) ["--autoplay-policy=no-user-gesture-required","--mute-audio","--disable-dev-shm-usage",
|
||||
"--disable-gpu","--no-zygote","--no-sandbox","--disable-setuid-sandbox","--headless=new"]
|
||||
有界面+关沙箱 [] ← 非 Linux 不注入任何沙箱参数,保留本机 Chrome 沙箱
|
||||
|
||||
陈旧的 `SingletonLock`(上次被 kill -9 留下的符号链接指向已不存在的 pid)会被清理,
|
||||
活跃的锁保留;清理后普通文件形式的 `SingletonCookie` 也一并删除(实测:lock=false, cookie=false)。
|
||||
|
||||
|
||||
四、可观测能力与容错
|
||||
- 持久化:profile 固定到 `./.run-profile`(`YUN_XUE_TANG_PROFILE_DIR` 可改),cookie / localStorage 都在里面;
|
||||
删掉该目录 = 重置登录态 + 进度缓存。
|
||||
- 自动重登:看护循环每 1.5 秒读一次 `isLoginPage()`,是登录页就填账号密码 + 勾协议 + 点登录;
|
||||
20 秒限速、连续 5 次失败则退出码 3(多半是密码错或站点要验证码)。
|
||||
- 崩溃自愈:CDP 断线 / 90 秒读不到脚本状态 → 抛错 → 外层等 15s、30s… 最多 120s 后重建浏览器,
|
||||
进度由页面 localStorage(`yun-xue-tang-batch-v2`)接续。
|
||||
- 无进展保护:课程/课时/进度/视频任一有变化即重置计时,连续 30 分钟(`YUN_XUE_TANG_IDLE_RESTART_MINUTES`)
|
||||
没变化则判定卡死退出。
|
||||
- 编解码自检:`--check` 会探测 `video/mp4; codecs="avc1.42E01E"`;运行中若
|
||||
`video.error.code >= 3` 立刻告警「这个 Chromium 不带 H.264/AAC」。
|
||||
- 优雅退出:SIGINT/SIGTERM → 页面内 `pauseAllMedia()` + `S.running=false` + `save()` → 关浏览器。
|
||||
- 日志:终端 + `./run-logs/headless.log`,超 5MB 轮转成 `.1`。
|
||||
- 端口占用:启动前先探 `/json/version`,被占时直接提示 `pkill -f "remote-debugging-port=9336"`
|
||||
或换 `--port`(实测提示正确,exit 2)。
|
||||
|
||||
|
||||
五、实跑验证(真实站点 kfmic.yunxuetang.cn,真实账号)
|
||||
1) 环境自检 `npm run headless:check`(只读、不登录、不动进度):
|
||||
|
||||
PASS 页面可访问 → https://kfmic.yunxuetang.cn/login.html
|
||||
PASS 脚本已注入 window.__yunXueTangAuto → object
|
||||
PASS 面板渲染唯一 → {"面板数":1,"可见":true}
|
||||
PASS 脚本版本可读 → "v2.7.0"
|
||||
PASS 视频编解码 H.264 可用 → {"h264":"probably","aac":"probably","vp9":"probably"}
|
||||
页面识别的路由:other 是否登录页:true
|
||||
|
||||
2) 真跑 `node runner/headless.mjs --max 1`(无头、自动登录、真实刷课):
|
||||
|
||||
浏览器就绪:Chrome/155.0.8059.85
|
||||
已注入脚本(第 1 次):https://kfmic.yunxuetang.cn/login.html
|
||||
登录页:自动登录(第 1 次尝试)
|
||||
已注入脚本(第 2 次):https://kfmic.yunxuetang.cn/sparring/#/web/drillmate
|
||||
已注入脚本(第 3 次):https://kfmic.yunxuetang.cn/kng/#/list?...
|
||||
页面:优先短课程:共 5109 门待学,最短 2 分钟
|
||||
页面:跳过:如何制定渠道战略(课程包含考试/测验章节)
|
||||
页面:起点已对齐:第 1 节 视频如何读懂留存曲线?
|
||||
页面:学习中:视频如何读懂留存曲线?
|
||||
页面:课程完成: 如何读懂留存曲线? 第 1 门,返回列表选下一门
|
||||
页面:本次已完成 1 门,已停止。
|
||||
本次会话结束:已完成 1 门(达到 --max 上限) 用时 2 分 19 秒 本次完成 1 门,累计 1 门
|
||||
=== 运行器退出 === (退出码 0)
|
||||
|
||||
3) 崩溃自愈(kill -F 掉浏览器主进程后):
|
||||
会话异常:CDP 连接断开,重启浏览器
|
||||
浏览器/连接异常,15 秒后重试(第 1 次)
|
||||
--- 第 2 次尝试 ---
|
||||
浏览器就绪:Chrome/ ...
|
||||
登录页:自动登录(第 1 次尝试) ← profile 里的 cookie 过期后被站点踢回登录页,自动重登成功
|
||||
已注入脚本(第 3 次):...#/list... ← 列表页新 document 重新注入
|
||||
状态:进入课程(3 分钟):什么是增长黑客
|
||||
页面:点击开始学习 继续学习
|
||||
页面:学习中:视频什么是增长黑客?
|
||||
|
||||
4) 优雅退出(kill -TERM 运行器进程):
|
||||
[浏览器] 进程退出 code=143 ← 浏览器被 SIGTERM 收掉
|
||||
残留 chrome 进程数:0 ← 没有孤儿进程
|
||||
|
||||
5) 缺凭据时直接拒绝并给原因:`缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD。`,退出码 2。
|
||||
|
||||
|
||||
六、回归(改动没有破坏原有链路)
|
||||
- `npm run check`:24 个文件逐个 `node --check` 全通过(新增 runner/*.mjs 与 dev/tests/real-run.mjs 也已纳入)。
|
||||
- `npm run test:real:headless`(真机只读断言):**24/24 通过,失败 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**。
|
||||
|
||||
|
||||
七、已知限制
|
||||
- 无头环境无法完成滑块/拼图类验证码:需要先在有界面模式(本机或 `xvfb-run` + `x11vnc`)
|
||||
人工登录一次,之后靠持久化 profile 的 cookie 免登录。
|
||||
- 服务器上如果装的是 `chromium`(Debian/Ubuntu 的 Chromium 包),可能不带 H.264/AAC:
|
||||
课程视频会一直 0 秒。`--check` 会直接给出提示,改装 `google-chrome-stable` 即可。
|
||||
- 运行器是前台进程,进程管理交给 tmux / nohup / screen,不内置守护模式(按需求如此)。
|
||||
|
||||
|
||||
八、拆分重构(单文件过长 → 模块化)与回归
|
||||
------------------------------------------
|
||||
用户反馈「单文件代码太多了,考虑拆分」。runner/headless.mjs 从 626 行拆成 11 个模块、
|
||||
入口只剩 90 行(结构见第二节表格),**不引入打包步骤**(按用户选择:保持直接 import)。
|
||||
|
||||
同时把 package.json 的 check 从「一长串 node --check a && node --check b …」
|
||||
改成 scripts/check.mjs 自动遍历 runner/、dev/、scripts/ 与 config/ —— 以前新增模块必须手改那行命令,
|
||||
漏改就会静默不被检查。现在输出:语法检查:20/20 个文件通过。
|
||||
|
||||
拆分过程中发现并修掉 3 个真实缺陷(都是原单文件里藏着的):
|
||||
|
||||
1) 端口占用检查被自己的 try/catch 吞掉
|
||||
- preflight 里 fail() 在 try 块内抛出,又被同一个 catch 接住,等于端口占用永不报警;
|
||||
- 而 Chrome 起来后会拒绝启动,外层只是不断重试。现在只捕获探测本身的异常。
|
||||
- 实测:假 CDP 服务占住 9336 → 退出码 2,三行提示(占用者、pkill 命令、换端口建议)。
|
||||
|
||||
2) 连续登录失败不会退出(最严重)
|
||||
- 原代码在看护循环里 throw,但 setInterval 的 catch 把它当「看护循环异常」打印成警告,
|
||||
主循环永远看不到这个错误:错误凭据下会无限刷日志、永不退出。
|
||||
- 修法:致命错误寄存到 fatalError + 停掉定时器,主循环抛出;supervisor 据此返回退出码 3。
|
||||
- 实测(故意错的账号密码):5 次尝试(每次 20 秒限速)→
|
||||
会话异常:连续 5 次登录失败:请检查 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,… → 退出码 3。
|
||||
|
||||
3) 会话抛错时浏览器没收干净
|
||||
- 异常路径跳过了 disposeSession,浏览器进程残留会占住 CDP 端口,下一轮重启撞端口。
|
||||
- 修法:session 暴露 disposeActiveSession()(幂等),supervisor 在 catch 里先调用它。
|
||||
- 实测:退出码 3 之后残留 chrome 进程数 0。
|
||||
|
||||
回归(重构后全部重跑,真实站点、真实账号):
|
||||
|
||||
npm run check 语法检查:20/20 个文件通过(原 12 个,新增 8 个模块)
|
||||
npm run headless:check 5/5 PASS,退出码 0
|
||||
node runner/headless.mjs --max 1 真实完成 1 门,退出码 0(多次重跑:2 分 16 秒 / 3 分 39 秒)
|
||||
kill 浏览器主进程 会话异常:CDP 连接断开 → 15 秒后第 2 次尝试 → 自动重登 → 继续刷课
|
||||
SIGTERM 浏览器 code=143,残留 chrome 进程数 0
|
||||
npm run test:real:headless 24/24 通过
|
||||
node dev/tests/real-e2e.mjs --headless 12/12 通过
|
||||
node dev/tests/real-run.mjs --headless --scan 3/3 通过
|
||||
|
||||
stop.mjs 的单元核查(一次性脚本,未入库):注册的收尾函数全部执行、已注销的不执行、
|
||||
重复信号不重复执行、收尾后调用 onExit(0)。
|
||||
stop.mjs 全部断言通过:{"order":["browser.kill","log.close"],"exited":0,"lines":["收到 SIGTERM,正在收尾…"]}
|
||||
|
||||
======================================================================
|
||||
九、跨平台适配(追加 Windows / macOS 支持,实测于 Windows)
|
||||
======================================================================
|
||||
|
||||
背景:无头运行器最初只按「Linux 无图形化服务器」设计,但项目主开发机是 Windows。
|
||||
实际运行暴露了一批 Windows 专属问题(强杀后残留、锁文件名字不同、SIGTERM 收不到、
|
||||
Session 0 没有桌面、spawn 会闪黑框),因此把平台差异从各模块里抽出来集中处理。
|
||||
|
||||
9.1 新增 runner/platform.mjs(平台差异唯一出口)
|
||||
|
||||
isWindows / isLinux / isMac / platformName
|
||||
isRunningAsRoot() getuid()===0
|
||||
hasDisplay() 有无图形会话;支持 YUN_XUE_TANG_HAS_DISPLAY=0/1 强制覆盖
|
||||
Linux 看 DISPLAY/WAYLAND_DISPLAY
|
||||
Windows 看 SESSIONNAME(Services = Session 0,无桌面)
|
||||
noDisplayReason() 给日志用的人话原因
|
||||
safetyArgs() 本平台需要的额外启动参数
|
||||
Linux: --disable-dev-shm-usage(+ root: --no-sandbox 等)
|
||||
Windows: 不注入 --no-sandbox;只加 --disable-session-crashed-bubble
|
||||
--hide-crash-restore-bubble(避免无人值守时弹窗等人点)
|
||||
killTree(child) 进程树收尾:POSIX SIGTERM→SIGKILL;Windows TerminateProcess
|
||||
+ 兜底 taskkill /T /F
|
||||
killProfileOrphans(profileDir) 按 --user-data-dir 找残留浏览器进程并杀掉(自愈)
|
||||
Linux: ps -eo pid=,args=
|
||||
Windows: Get-CimInstance Win32_Process + taskkill
|
||||
portInUseHint(port) 按平台出排查命令
|
||||
browserInstallHint() / residentHint() 按平台出安装与常驻建议
|
||||
|
||||
browser.mjs 转发 platform.mjs 的导出(safetyArgs / hasDisplay / isRunningAsRoot 等),
|
||||
老的调用方(dev/tests/real-cdp.mjs、dev/tests/real-*.mjs)不需要改 import。
|
||||
|
||||
9.2 各模块的改动点
|
||||
|
||||
browser.mjs CANDIDATES 补 Windows 用户级安装(LOCALAPPDATA)与 Edge/Chromium 路径,
|
||||
可执行名匹配改为 EXE_RE(认 .exe);
|
||||
buildArgs 把 --disable-dev-shm-usage / --no-zygote 限定为非 Windows;
|
||||
spawn 加 windowsHide(否则无人值守时闪黑框);
|
||||
kill() 改为 platform.killTree();
|
||||
cleanStaleSingleton 在 Windows 上额外清 lockfile(普通文件,无法反查 pid,
|
||||
所以先 killProfileOrphans 再清)。
|
||||
preflight.mjs 浏览器缺失提示、Node 升级提示、端口排查命令全部按平台出;
|
||||
端口被占时先 killProfileOrphans 自愈一次,再判断是否真的失败。
|
||||
stop.mjs 监听 SIGINT + SIGBREAK + SIGHUP(Windows 上 SIGTERM 根本收不到,
|
||||
Ctrl+C 是 SIGINT,Ctrl+Break 是 SIGBREAK,关窗口是 SIGHUP)。
|
||||
config.mjs VISIBLE = WANT_VISIBLE && hasDisplay(),导出 platformName / noDisplayReason。
|
||||
supervisor.mjs 启动横幅打平台名;--visible 被忽略时用 noDisplayReason() 说原因。
|
||||
headless.mjs 注释补 Windows 用法(set / $env:)与代码结构。
|
||||
dev/tests/real-*.mjs spawn 补 windowsHide: true。
|
||||
|
||||
9.3 实测(Windows 11 / Chrome 155.0.8059.85 / Node v24.19.0)
|
||||
|
||||
平台判断
|
||||
hasDisplay() → true(SESSIONNAME=Console)
|
||||
safetyArgs() → ["--disable-session-crashed-bubble",
|
||||
"--hide-crash-restore-bubble"]
|
||||
buildArgs 平台相关参数 → --disable-gpu / --disable-session-crashed-bubble
|
||||
/ --hide-crash-restore-bubble / --headless=new
|
||||
(无 --no-sandbox / --disable-dev-shm-usage)
|
||||
模拟 SESSIONNAME=Services → hasDisplay() false,--visible 被忽略
|
||||
|
||||
killTree(进程树收尾)
|
||||
启动后同 profile chrome 进程数 10
|
||||
b.kill() 返回用时 206ms
|
||||
kill 后进程数 0 ✔ 无残留
|
||||
|
||||
killProfileOrphans(残留自愈)—— 用 detached 造出「父进程退出后仍活着」的浏览器
|
||||
detached 浏览器进程数 10
|
||||
端口 9358 可响应 true
|
||||
killProfileOrphans 返回 10
|
||||
清理后进程数 / 端口 9358 0 / false ✔
|
||||
|
||||
预检自愈(端到端)
|
||||
先用残留浏览器占住默认端口 9336 端口可响应 true
|
||||
node runner/headless.mjs --check
|
||||
[预检] 已清理 11 个占用本 profile 的残留进程,重新检测端口…
|
||||
PASS 页面可访问 / 脚本已注入 / 面板渲染唯一 / 版本可读 / H.264 可用
|
||||
退出码 0 ✔ 自愈成功(不再误报退出码 2)
|
||||
|
||||
Windows 上的信号事实(一次性脚本核查,未入库)
|
||||
process.kill(pid, 'SIGINT') 子进程被直接终止,SIGINT 处理函数不执行
|
||||
process.kill(pid, 'SIGTERM') 报 ESRCH,不可用
|
||||
taskkill /pid <pid>(不带 /F) 报「无法终止」;必须 /F,而 /F 是 TerminateProcess
|
||||
→ 结论:Windows 上跨进程没有优雅信号,只有当前控制台的 Ctrl+C 能触发 SIGINT。
|
||||
因此 stop.mjs 监听 SIGINT/SIGBREAK/SIGHUP,并把「强杀留下残局」交给 killProfileOrphans 兜底。
|
||||
|
||||
真实链路回归(真实站点 kfmic.yunxuetang.cn、真实账号)
|
||||
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/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 额外交付
|
||||
|
||||
scripts/start-headless.cmd 一键启动(自动构建 / 检查 Node / 退出码说明 + pause)
|
||||
README「无头运行」一节 改成 Linux / Windows 双栏,补「Windows 常驻三种方式」
|
||||
与按平台分的「无图形环境常见坑」表
|
||||
环境变量 YUN_XUE_TANG_HAS_DISPLAY 0/1 强制认定有无图形会话(自动判断不准时用)
|
||||
|
||||
9.5 buildArgs 参数去重(Linux 分支在 Windows 上模拟验证)
|
||||
|
||||
platform.mjs 在模块加载时就用 process.platform 定下了常量,因此模拟 Linux 必须在
|
||||
import 之前改写(一次性脚本 .run-tmp/linux-sim.mjs,用 Object.defineProperty 覆盖
|
||||
process.platform='linux'、process.getuid=()=>0、清掉 DISPLAY/WAYLAND_DISPLAY)。
|
||||
|
||||
hasDisplay() → false(无 DISPLAY)
|
||||
noDisplayReason() → 当前环境没有图形显示(DISPLAY / WAYLAND_DISPLAY 都为空)
|
||||
safetyArgs() → ["--disable-dev-shm-usage","--no-sandbox",
|
||||
"--disable-setuid-sandbox","--disable-gpu"]
|
||||
buildArgs(去重后) → --disable-gpu / --disable-dev-shm-usage / --no-zygote
|
||||
/ --no-sandbox / --disable-setuid-sandbox / --headless=new
|
||||
portInUseHint(9336) → ["ss -lptn \"sport = :9336\"", "pkill -f \"remote-debugging-port=9336\""]
|
||||
|
||||
发现并修掉:手写的 Linux 参数与 safetyArgs() 有重叠(--disable-dev-shm-usage /
|
||||
--no-sandbox / --disable-setuid-sandbox 各出现两次),Chrome 收到重复开关没有意义,
|
||||
改为 [...new Set(args)] 去重后再拼 extraArgs。Windows 侧核查重复项:无。
|
||||
|
||||
======================================================================
|
||||
十、Windows 批处理启动脚本的编码陷阱(scripts/start-headless.cmd 报「不是内部或外部命令」)
|
||||
======================================================================
|
||||
|
||||
10.1 现象
|
||||
|
||||
双击 scripts/start-headless.cmd,控制台输出:
|
||||
'e' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'鍏?npm' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'rofile' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'nner' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
'姝e父鏀跺熬' 不是内部或外部命令,也不是可运行的程序或批处理文件。
|
||||
即:整行被拆成几段、中文乱码(UTF-8 字节被按 GBK 解释)、还丢了字符。
|
||||
|
||||
10.2 根因(两个独立问题叠加)
|
||||
|
||||
a) 行尾是裸 LF。cmd.exe 逐行读取批处理,但它只认 CRLF;只有 LF 时会漏掉换行,
|
||||
把上一行的尾部当成下一行命令的一部分 —— 于是出现 'e' / 'rofile' / 'nner'
|
||||
这种「从单词中间开始」的片段。
|
||||
b) 文件里有非 ASCII 字符(中文)。cmd.exe 按当前代码页(中文 Windows 是 936/GBK)
|
||||
逐字节读,UTF-8 编码的中文占 3 字节,被当成 3 个 GBK 字符,行读取指针随之错位,
|
||||
后续命令也跟着被截断 —— 于是出现 '鍏?npm'(UTF-8 的「关」被读成 GBK 乱码,
|
||||
连后面的空格和 npm 一起粘进来)和 '姝e父鏀跺熬'(「正常收尾」的乱码)。
|
||||
|
||||
对照实验(同一台机器,同一目录):
|
||||
CRLF + chcp 65001 + 中文 → 输出「中文提示 CRLF」「second line」 ✔ 正常
|
||||
LF + chcp 65001 + 中文 → '01' 不是内部或外部命令 / '文提示' 不是内部或外部命令 ✘ 错位
|
||||
所以 chcp 65001 并不能救 UTF-8 中文 —— 偏移发生在解析阶段,而不是显示阶段。
|
||||
|
||||
GBK 编码 + 不 chcp 的方案虽然能执行,但显示是乱码(终端代码页不匹配),
|
||||
且文件必须随系统区域设置改动,不适合入库。
|
||||
|
||||
10.3 采用方案:批处理只用 ASCII,中文交给 Node 输出
|
||||
|
||||
scripts/start-headless.cmd 与 scripts/start-dev.cmd 全部改写为纯 ASCII + CRLF:
|
||||
- 注释里写明「本文件必须保持纯 ASCII」及原因,避免以后有人手改回去;
|
||||
- 所有面向用户的提示(构建中 / 启动中 / 退出码含义 / 缺 Node)改用英文短句
|
||||
(如 [build] / [run] / [exit] / [error]),中文提示由 Node 侧日志输出;
|
||||
- 文件仍保留 chcp 65001,这样 Node 输出的 UTF-8 中文在控制台正常显示。
|
||||
|
||||
验证:
|
||||
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 防回归:scripts/check.mjs 增加批处理检查
|
||||
|
||||
`npm run check` 原来只跑 node --check,对 .cmd 完全无感知(所以这个 bug 是双击才发现)。
|
||||
现在 scripts/check.mjs 同时遍历 *.cmd / *.bat 并断言两件事:
|
||||
1. 不含任何 >0x7F 的字节(报错时给出首次出现的偏移与上下文片段);
|
||||
2. LF 与 CRLF 数量相等(存在裸 LF 就报错)。
|
||||
自测(临时文件,验证完即删):
|
||||
造一个 UTF-8 + LF 的坏文件 → FAIL,两条都被指出
|
||||
造一个 ASCII + CRLF 的对照文件 → PASS
|
||||
现在输出:静态检查:23/23 个文件通过(JS 21 · 批处理 2)
|
||||
|
||||
同时把这两条写进 README 的「无图形环境常见的坑」表(新增一行,症状列直接给出
|
||||
'鍏?npm' / '01' / 'rofile' 这三个典型报错原文,方便以后按报错搜索)。
|
||||
@@ -0,0 +1,72 @@
|
||||
云学堂助手 v2.6.0 · 优先短课程(时长正序)证据
|
||||
日期:2026-10-22(Asia/Shanghai)
|
||||
站点:https://kfmic.yunxuetang.cn/kng/#/list(已登录账号)
|
||||
|
||||
一、需求
|
||||
批量刷课时,不再只按列表顺序(最新发布)选课,而是优先学习总时长更短的课程(正序)。
|
||||
|
||||
二、真实数据结构
|
||||
列表卡片本身不显示时长。列表组件 ul.kng-list-new.__vue__ 的 kngListData 每项包含:
|
||||
- title 课程名
|
||||
- studyHours 课程总时长(秒)
|
||||
- status 1=学习中,2=已学完,0=未开始
|
||||
- id 课程 id(用于精确匹配卡片,避免同名课程点错)
|
||||
列表接口:POST https://api-phx-tc.yunxuetang.cn/kng/knowledge/pagelist
|
||||
?limit=6000&offset=0&orderType=desc&orderBy=createTime
|
||||
请求体:
|
||||
{"collegeId":"<orgId>","catalogId":"","title":"","type":"","allTag":1,"tagIds":[]}
|
||||
鉴权最小请求头(实测):
|
||||
content-type: application/json;charset=UTF-8
|
||||
token: <localStorage.token>
|
||||
yxt-orgdomain: kfmic.yunxuetang.cn
|
||||
source: 501
|
||||
其中 limit=6000 可一次返回全站 5148 门课程(实测 8.65 MB,6.3 秒)。
|
||||
orderBy 传 studyHours 不会被服务端接受(返回默认顺序),所以脚本自行按 studyHours 正序排序。
|
||||
|
||||
三、真实站点读取结果(2026-10-22 20:07 左右)
|
||||
课程总数:5148
|
||||
未学完(status != 2):5134
|
||||
最短课程:氦泄漏通用,60 秒,status=0,位于第 307 页
|
||||
下一页最短:想精准触达消费者,你得了解立体用户画像!113 秒,第 73 页
|
||||
再下一页:如何搭建分销体系,实现用户指数型增长?(上篇)127 秒,第 71 页
|
||||
说明:平台存在同名课程(如「如何制定渠道战略」出现在多页),脚本优先按课程 id 匹配卡片。
|
||||
|
||||
四、真实列表页跳页 / 匹配验证
|
||||
目标:{"title":"氦泄漏通用","duration":60,"status":0,"page":307}
|
||||
1) 脚本读取时长队列后,jumpToPage(307) 成功,浏览器页码变为 307。
|
||||
2) 第 307 页 16 张卡片的标题中确实包含「氦泄漏通用」(第 12 张)。
|
||||
3) chooseShortCourse 返回 { title: "氦泄漏通用", duration: 60 },说明跨页映射与卡片匹配正确。
|
||||
日志:
|
||||
[云学堂助手] 正在读取课程时长,优先安排短课程…
|
||||
[云学堂助手] 短课程队列已就绪:待学 5134 门;最短 1 分钟
|
||||
[云学堂助手] 跳转到第 307 页
|
||||
[云学堂助手] 优先短课程:转到第 307 页(1 分钟)
|
||||
|
||||
五、回归测试(Playwright + 本地列表 fixture,3 个用例)
|
||||
命令:node .run-tmp/short-course/test-list.mjs
|
||||
结果:3 PASS / 0 FAIL
|
||||
[PASS] S1 短课程优先 · 跨页选全局最短
|
||||
点击 D 短课(期望 D 短课)/ 页码 2(期望 2)
|
||||
[PASS] S2 关闭开关 · 沿用列表顺序
|
||||
点击 A 长课(期望 A 长课)/ 页码 1(期望 1)
|
||||
[PASS] S3 接口失败 · 退回当前页时长正序
|
||||
点击 B 中课(期望 B 中课)/ 页码 1(期望 1)
|
||||
命令:node .run-tmp/short-course/test-restore.mjs
|
||||
结果:PASS
|
||||
[PASS] 回到列表恢复第 9 页:实际第 9 页(直接跳页,不一页页翻)
|
||||
覆盖点:
|
||||
- 接口可用时跨页选择全局最短;
|
||||
- 面板开关关闭时恢复原有顺序;
|
||||
- 接口 500 时降级为当前页 studyHours 正序;
|
||||
- 已学完(status=2)课程不进入队列;
|
||||
- 课程完成回到列表时,深页码(短课程优先会到 300+ 页)直接跳回,不逐页翻。
|
||||
|
||||
六、实现要点
|
||||
- 面板新增「优先短课程(时长正序)」复选框,默认开启,保存在 localStorage `yun-xue-tang-prefer-short`。
|
||||
- 队列缓存在 sessionStorage `yun-xue-tang-short-catalog-v1`,5 分钟有效,关闭标签页即清空。
|
||||
- 选课时按 studyHours 升序;时长未知的排最后。
|
||||
- 目标课程在其他页时先 jumpToPage,落地后按 id(不可用时按标题)匹配卡片。
|
||||
- 失败降级链:跨页队列 → 当前页时长排序 → 原列表顺序,不会卡住批量任务。
|
||||
|
||||
七、面板截图
|
||||
docs/screenshots/panel-short.png(v2.6.0,新增「优先短课程(时长正序)」复选框,默认勾选;展示图随仓库入库)
|
||||
@@ -0,0 +1,193 @@
|
||||
# 云学堂助手 · 实跑报告(v2.0.3)
|
||||
|
||||
> 历史记录:本报告对应 **v2.0.3**,当时的文件名为 `yunxuetang-auto-play.user.js`。
|
||||
> 脚本现已更名为 [`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);
|
||||
> v2.7.0 修复单视频课程不自动播放与课程完成后不转下一门,
|
||||
> 证据见 [`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**
|
||||
|
||||
## 结论
|
||||
|
||||
- 脚本在真实站点(`kfmic.yunxuetang.cn`,江丰云课堂)跑通:登录 → 课程列表 → 批量选课 → 自动进入课程 → 静音 1x 播放 → 读取进度/倒计时。
|
||||
- **自动切节已端到端验证通过**:302 秒的第 1 节播完后平台进度 `0/3 → 1/3`,脚本切到第 2 节;v2.0.3 复跑又把第 2 节(305 秒)播完,进度 `1/3 → 2/3`,切到第 3 节「下(钱百峰)」。
|
||||
- 实跑共发现 4 个真实问题,均已修复:
|
||||
1. 「2小时 8分钟 34秒」格式的倒计时解析为 `null`;
|
||||
2. 只剩分钟(「还需 5分钟」)的倒计时也解析为 `null`;
|
||||
3. 自动切节会点回当前节(目录「章」节点也包含 `.liactive`);
|
||||
4. 平台在切节后自动显示的「还需 5分钟」是**下一节**的时长,旧逻辑可能据此把已结束的上一节视频拉回开头重播。
|
||||
- 实际影响了账号进度:`2025坚持的力量` 已完成第 1、2 节,当前 `2/3`;第 3 节在 58 秒处手动暂停。`KFMI2025...` 本轮又播了约 221 秒,进度仍为 `0/8`。
|
||||
|
||||
## 实跑 1:长课程 + 批量入口
|
||||
|
||||
| 步骤 | 实际结果 |
|
||||
| --- | --- |
|
||||
| 登录页 | `https://kfmic.yunxuetang.cn/login.html`,标题「登录-江丰云课堂」 |
|
||||
| 课程列表 | 第 1 页 16 张卡片;前两张「已学完」被正确跳过 |
|
||||
| 选中课程 | `KFMI2025年品质能力强化培训(APQP/CP/FMEA)`(学习中) |
|
||||
| 目录 | 10 个 `li` = 2 个章节点 + 8 个课时;汇总「已完成 0/8」 |
|
||||
| 播放 | `paused=false`、`muted=true`、`playbackRate=1`;`currentTime` 79s → 114s → 234s |
|
||||
| 倒计时 | 「还需 2小时 8分钟 34秒」 |
|
||||
| 停止 | 手动停在 234s,避免无人值守跑 2 小时以上 |
|
||||
|
||||

|
||||
|
||||
## 实跑 2:短课时验证自动切节
|
||||
|
||||
为了不让批量模式继续跑 2 小时的 KFMI 课程,这次把 `S.current` 指向短课程后开启批量逻辑(列表筛选逻辑已在实跑 1 验证)。课程来自同一列表,状态「学习中」:
|
||||
|
||||
`2025坚持的力量(黄文杰、袁倩靖、钱百峰)`,总时长 880 秒,共 3 节:
|
||||
|
||||
| 节 | 时长 | 起始进度 |
|
||||
| --- | --- | --- |
|
||||
| 上(黄文杰) | 302s | 0 |
|
||||
| 中(袁倩靖) | 305s | 0 |
|
||||
| 下(钱百峰) | 273s | 0 |
|
||||
|
||||
时间线(本地时间):
|
||||
|
||||
| 时间 | 事件 |
|
||||
| --- | --- |
|
||||
| 21:31:28 | 第 1 节开始播放,`duration=302.4s`,静音 1x |
|
||||
| 21:36:33 | 平台 `study/summary` 返回 `finishNum: 0 → 1`,`acqHours: 0 → 302` |
|
||||
| 21:36:34.933 | 脚本日志「本节已记录,切换下一节…」 |
|
||||
| 21:36:34.934 | 脚本日志「进入下一节」 |
|
||||
| 21:36:40.930 | 脚本日志「学习中:…中(袁倩靖)」;汇总「已完成 1/3」 |
|
||||
| 21:37:04 | 第 2 节播放到 20.6s 时手动暂停(最终停在 55.7s) |
|
||||
|
||||
平台接口证据:
|
||||
|
||||
```
|
||||
026 study/summary finishNum=0/3 acqHours=0
|
||||
049 study/summary finishNum=1/3 acqHours=302
|
||||
```
|
||||
|
||||
脚本日志证据:
|
||||
|
||||
```
|
||||
[21:36:34.933] [云学堂自动] 本节已记录,切换下一节…
|
||||
[21:36:34.934] [云学堂自动] 进入下一节
|
||||
[21:36:40.930] [云学堂自动] 学习中:视频江丰创业故事微宣讲《坚持的力量》中(袁倩靖)
|
||||
```
|
||||
|
||||

|
||||
|
||||
## v2.0.3 复跑:第 2 节 → 第 3 节
|
||||
|
||||
这一轮专门验证「视频结束后不会被下一节的倒计时文案拉回重播」。为了避开目录点击,这次直接用第 2 节的 `locateshare` 地址进入:
|
||||
|
||||
| 时间 | 事件 |
|
||||
| --- | --- |
|
||||
| 21:45:37 | 第 2 节开始播放(平台自动起播),`duration=304.5s`;21:46:17 脚本接管时已到 40s |
|
||||
| 21:50:46 | 平台 `study/summary` 返回 `finishNum=2/3`,`acqHours=607`(302+305) |
|
||||
| 21:50:47.198 | 脚本日志「本节已记录,切换下一节…」 |
|
||||
| 21:50:47.198 | 脚本日志「进入下一节」 |
|
||||
| 21:50:53.198 | 脚本日志「学习中:…下(钱百峰)」,新视频 `duration=273s` 开始播放 |
|
||||
| 21:51:01+ | 第 3 节正常计时;到 58.4s 时手动暂停 |
|
||||
|
||||
关键点:第 2 节结束时,页面先出现的是第 3 节的提示「还需 4分钟 33秒」(第 3 节总长 273 秒),不是上一节的剩余时间;脚本没有把它当成第 2 节还没结束,也没有 seek 回 0,而是按 `video.ended` 直接进入第 3 节。平台汇总从 `1/3` 变为 `2/3`。
|
||||
|
||||
平台接口:
|
||||
|
||||
```
|
||||
073 study/summary finishNum=1/3 acqHours=342
|
||||
096 study/summary finishNum=2/3 acqHours=607
|
||||
```
|
||||
|
||||

|
||||
|
||||
测试过程中有一个插曲:第一次在批量运行中直接 `goto` 第 2 节地址,页面加载瞬间标题还是 `loading...`,脚本判定「页面课程与队列不一致」,按保护逻辑回到列表并选中了第一门未完成课程 KFMI,播了约 221 秒后才被手动停掉。正常从列表进入课程不会触发;但**刷新课程页/直接改 URL** 时确实可能遇到,属于已知限制,本轮未改。
|
||||
|
||||
## 问题 1:小时级倒计时解析失败
|
||||
|
||||
真实文案:
|
||||
|
||||
```
|
||||
还需 2小时 8分钟 34秒 可完成本课程学习并获得6.52学分,加油!
|
||||
```
|
||||
|
||||
旧正则 `/还需(\d+)分钟(\d+)秒/` 只认「分钟+秒」,`readCountdown()` 返回 `null`。
|
||||
|
||||
修复(`readCountdown()`):改为小时/分钟/秒都可选,并至少匹配到一个数字。
|
||||
|
||||
## 问题 2:只剩分钟时也解析失败
|
||||
|
||||
这条文案不是上一节完成后的“剩余时间”,而是平台切到下一节后自动显示的下一节提示。实跑日志能看清顺序:
|
||||
|
||||
```
|
||||
21:36:28 当前节「还需 5秒」 汇总 0/3
|
||||
21:36:33 倒计时为空 汇总 1/3
|
||||
21:36:48 下一节「还需 5分钟」 下一节已播放 5.6s
|
||||
```
|
||||
|
||||
也就是说,`5分钟` 是下一节的总时长。对下一节本身来说它是有效的倒计时,但第一次修复后仍要求「秒」,所以这条会解析成 `null`。已把秒改为可选,并用 4 种真实格式验证:
|
||||
|
||||
| 文案 | 解析结果 |
|
||||
| --- | --- |
|
||||
| 还需2小时7分钟59秒… | 7679 |
|
||||
| 还需5分钟… | 300 |
|
||||
| 还需4分钟10秒… | 250 |
|
||||
| 还需59秒… | 59 |
|
||||
|
||||
## 问题 3:自动切节会点回当前节
|
||||
|
||||
真实目录里「章」节点也包含 `.liactive`,旧代码 `findIndex(li => li.querySelector('.liactive'))` 先命中章节点,于是「下一节」= 当前节。
|
||||
|
||||
线上对比(KFMI 课程):
|
||||
|
||||
- 旧逻辑:`视频2025-05-29--1`(当前节)
|
||||
- 修复后:`视频2025-05-29--2`(正确下一节)
|
||||
|
||||
修复(`findNextLessonElement()` / `lessonItems()`):新增 `lessonItems()` 过滤包含子 `ul` 的章节点;用 `active.closest('li')` 定位当前课时后再取下一个。`findFirstIncompleteLessonElement()` 同步改用 `lessonItems()`。
|
||||
|
||||
短课时实测已证明修复有效:脚本没有点回「上(黄文杰)」,而是进入「中(袁倩靖)」。
|
||||
|
||||
## 问题 4:切节后的「还需 5分钟」被误当成上一节还没结束
|
||||
|
||||
旧判断:
|
||||
|
||||
```js
|
||||
const localDone = (cd != null && cd <= 0) ||
|
||||
(v && v.ended && (cd == null || cd <= 3));
|
||||
```
|
||||
|
||||
如果视频已经 `ended`,但页面先挂出下一节的「还需 5分钟」(`cd=300`),`localDone` 会是 `false`;随后 `ensurePlaying()` 命中 `v.ended && cd > 3`,把视频 `currentTime = 0` 并重新播放,导致本节迟迟不切走。
|
||||
|
||||
这次实跑在 21:36:33 时倒计时刚好为空,所以脚本正常切了;但按你指出的平台行为,这条文案不能作为上一节是否结束的依据。修复:
|
||||
|
||||
- `localDone` 改为 `v.ended || cd <= 0`,`video.ended` 是本节结束的主信号(`courseTick()` 中的 `localDone`)。
|
||||
- `ensurePlaying()` 遇到 `ended` 直接返回,不再 seek 回 0(`if (v.ended) return`)。
|
||||
- 删除只为“提前结束补时长”服务的 `lastRestartAt` 重播分支;平台按真实时长计时,脚本本身也不快进,不需要它。
|
||||
|
||||
## 其他小修
|
||||
|
||||
- 视频开始播放后,面板从「点击开始学习…」恢复为「学习中:…」。
|
||||
- 列表状态标签优先匹配 `已学完/学习中/未开始/…`,避免其它标签被误判。
|
||||
- 版本号:2.0.0 → 2.0.1(前两个修复)→ 2.0.2(分钟级倒计时)→ **2.0.3**(完成后提示不再触发重播)。
|
||||
|
||||
## 说明
|
||||
|
||||
- 平台按真实播放时长计时,倍速/快进不会减少所需时间;本次没有伪造进度。
|
||||
- v2.0.2 验证了第 1 → 2 节;v2.0.3 验证了第 2 → 3 节,均实际切成功。
|
||||
- 第 3 节只有 273 秒,结束提示是下一节的「4分钟 33秒」,没有正好出现「5分钟」文案;但结束判断已改为 `video.ended`,本次确认没有重播。
|
||||
- 第 3 节停在 58 秒,没有再继续,避免把课程刷到 3/3。
|
||||
- 直接改 URL/刷新课程页时,页面标题短暂为 `loading...`,批量逻辑可能误判为课程不一致并回到列表;正常从列表进入不受影响。
|
||||
- 测试浏览器的登录配置目录已删除,未把会话留在工作区。
|
||||
|
||||
## 证据文件
|
||||
|
||||
- [`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/archive/v2.0-snapshots/`,截图仍在 `docs/screenshots/`。
|
||||
Binary file not shown.
|
After Width: | Height: | Size: 263 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 273 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 11 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 51 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 403 KiB |
Generated
+502
@@ -0,0 +1,502 @@
|
||||
{
|
||||
"name": "yun-xue-tang-assistant",
|
||||
"version": "2.7.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "yun-xue-tang-assistant",
|
||||
"version": "2.7.0",
|
||||
"devDependencies": {
|
||||
"esbuild": "^0.28.2"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/aix-ppc64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/aix-ppc64/-/aix-ppc64-0.28.2.tgz",
|
||||
"integrity": "sha512-XExcO+dvLKvVtNTibSTBej1NCAbaGhWn9Ww1ZPx80qsahhPFe/8jgWP0IchNe0F3HwkU7n8ejhH8bjonqht8mQ==",
|
||||
"cpu": [
|
||||
"ppc64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"aix"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-arm": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/android-arm/-/android-arm-0.28.2.tgz",
|
||||
"integrity": "sha512-kXXoiPVVGQcnIYGOeaovwOURpniDBpSq4A03qkQ+BMQqtGG6HYap3xne9C1O1yo4TR3qxlCX5IqqmX6fFo2Lqg==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/android-arm64/-/android-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-5YfKeeI8qWfBZIX+u2xZC3Zlb3Os/gLS2sbEKM+I4ZOcsWmHS2WLysCcQZDAFRslDUU5Oiq44gf6PYN1vGwG5A==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/android-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/android-x64/-/android-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-O387ite7SzUyCcy3JQX4P4bLtEA7bLLkx+esve5JHnyYfNTxcVpXZo9jhdB0lTKN44gztELTdU7nS8Nr16Fs1Q==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"android"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/darwin-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/darwin-arm64/-/darwin-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-n4KqkOQrraxHJcgjM1RvwbigfQKIKJVpM7xp+KsxiyUSrRdIXnt73VhrPAx0fV44hgfmIVKjxMN9J1t5jySVkw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/darwin-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/darwin-x64/-/darwin-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-uq6suIWYP37qzGddBKPw5QEQPi6HiLGsO7UmkpfyaYNQ3D+rN6w6WfwH+nuqcGXWvawGwxOEroO4YGnFh95azw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"darwin"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/freebsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-n+I0BTSRIoy+d6RPKnEVwql5UwBJolytvY4mAOIEJorKlqgPII8ix6slVVrfZ5Tnj7glIZvloylbB/EJPMWEXw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/freebsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/freebsd-x64/-/freebsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-78XJTJkvPs0kz2w61301PJjXl4g7q3JqiYMZ/M/yVI73EHBrCRTgkhu9oqG7vPqq+a/yadEW8aD+agKlk5xrmg==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"freebsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-arm": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-arm/-/linux-arm-0.28.2.tgz",
|
||||
"integrity": "sha512-XlDnu2q5yoqems+xay6wSAcg9DDD7K9RLKZEBOMZm3ckNpJBvOX20tSfby8KfrrhINDyv9V2YVZKY/SpoGJI8w==",
|
||||
"cpu": [
|
||||
"arm"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-arm64/-/linux-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-pW4AC0P3it8c7do9MVM4p51FzHzdM/TZrerurgRcHJ2WTa1VQ1CIq18xncfpBJw4ojkiZZrKW2yIBWBP92j6Ug==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-ia32": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-ia32/-/linux-ia32-0.28.2.tgz",
|
||||
"integrity": "sha512-CYbnj78HsIeA+DhgUKgFCfvNsTHFhMMrinUrMZpDXJXKN8T3XViTZ/+wtHeVxEWY8ewSzTFN+nRmSwO2tZaLUQ==",
|
||||
"cpu": [
|
||||
"ia32"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-loong64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-loong64/-/linux-loong64-0.28.2.tgz",
|
||||
"integrity": "sha512-buwkd8nsph4R+ajRvw0qM5Hja/TXQow3ptzWO2EbG/cqcIkHloRrdlBtQlshyYGTNFvfkfJ5tpPLVkY4DtsPfQ==",
|
||||
"cpu": [
|
||||
"loong64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-mips64el": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-mips64el/-/linux-mips64el-0.28.2.tgz",
|
||||
"integrity": "sha512-ZVykbDyk7519VwiNb9Lcj9m8XM6v5V9uKPvrEMkkEedVewf+0itkhahp4HDpgERXhwLRpWFypsGbG/J8s0QjJA==",
|
||||
"cpu": [
|
||||
"mips64el"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-ppc64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-ppc64/-/linux-ppc64-0.28.2.tgz",
|
||||
"integrity": "sha512-CAXl+Dtd9UUuJd8pKKdwh6MLm3MUMiqMPmhZ3tTSXPqfyQ3vDl6R5hZdZ/kYojK4ofXtdfSv1tFq8XzWx3heNQ==",
|
||||
"cpu": [
|
||||
"ppc64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-riscv64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-riscv64/-/linux-riscv64-0.28.2.tgz",
|
||||
"integrity": "sha512-GeXCej4IQtU1B+QlDV8W/RRvbzI3O/Stss+/bCXv4lZls5WGRtu2a+3JkA3i4qIUlMXpcHebWpF8AkJhATowuA==",
|
||||
"cpu": [
|
||||
"riscv64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-s390x": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-s390x/-/linux-s390x-0.28.2.tgz",
|
||||
"integrity": "sha512-3H1weTYZPxt/WOhByszQZybS9w5lKzUn1FDMsgEChbHWQwHYQQRfBxgCcZvPhjHfKyJjIievvMmEUawJrdY9Dg==",
|
||||
"cpu": [
|
||||
"s390x"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/linux-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/linux-x64/-/linux-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-4xTZr1FUmSoQW4XIWmit3tzQrUTZM+N3P0XV8xROKYF50XfI7xeO90+1bZvNwxIufQ9hDQVRJH5YhgPVF8A/HQ==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"linux"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/netbsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-sSATRjPeDBg3pdgHoQfoYBob11Kk1FGa9lui5RIHZCoCkJa9QKlvl3/vKz2usCmYYjs7ymJR/2Nnsqe+Hjt5nw==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"netbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/netbsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/netbsd-x64/-/netbsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-lqnzCV+mM0gIADaKihiCg6ifgfU2L3h5E33rNQBN1Y4MaVGnzryzmvvf7UHxprpQdE8hpqLolJ9Rl+SkIRDpyw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"netbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openbsd-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-AL2qJILH7lNjrDmCQDvdxMfAUIv8KMNZOvrwAQ8i8//ntL9FflhOyMJ8OZSMBb8/AWXe3/5v5S20y3zCoZWKoQ==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openbsd-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/openbsd-x64/-/openbsd-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-QtiuPytchRyC4rwUKhexJdQKvDuZ6hWloi3igqPQNUJCS1/v9EiO3UTOXR6A3FoMo4fnAKbWJdqaIwhOzh8qEw==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openbsd"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/openharmony-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-WkhYDmpTjLvGlScA1rwjRUmhl4k8oXR3cIbtqWmELgU/dFeHHlEllxDvdWcNJV9rbzCexB5vz8gtNewWLgCT7Q==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"openharmony"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/sunos-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/sunos-x64/-/sunos-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-GPMSkTOtMnv2U2F8gxe4Io6qmVs+YKyp832Etqqxr0hFngmXQ3rzwytelm3GIn7T4VviRUlf3sOgBOiTdvaf7g==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"sunos"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-arm64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/win32-arm64/-/win32-arm64-0.28.2.tgz",
|
||||
"integrity": "sha512-PIhhEkE9uPBleRBrQEJpUn7MBnibZzbGzYWPmY3x+YoVg/95zbjB4CxPPOQ8l5tYYM4mMaCthF8/1DIfBQQyWQ==",
|
||||
"cpu": [
|
||||
"arm64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-ia32": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/win32-ia32/-/win32-ia32-0.28.2.tgz",
|
||||
"integrity": "sha512-YmJbfTlvU7Sdn9BB+4PRES4oB6pxgS37MAONj+hBr/cpXS1aBPKXxNnDbu+QCWPj0o9dgyxeq79g6c5P8KeuYA==",
|
||||
"cpu": [
|
||||
"ia32"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/@esbuild/win32-x64": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/@esbuild/win32-x64/-/win32-x64-0.28.2.tgz",
|
||||
"integrity": "sha512-5ebpxr3nWMzrL/rnUI755Jkuee0bHL/Gq0WTF9lvcpv73wAp5eu8MfBUgWK9bhWvZjj7yX8etf/8tI8Ney695g==",
|
||||
"cpu": [
|
||||
"x64"
|
||||
],
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"optional": true,
|
||||
"os": [
|
||||
"win32"
|
||||
],
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
},
|
||||
"node_modules/esbuild": {
|
||||
"version": "0.28.2",
|
||||
"resolved": "https://registry.npmmirror.com/esbuild/-/esbuild-0.28.2.tgz",
|
||||
"integrity": "sha512-HKVLS8dvII+xoKW9kmqxbRKrnWEXfJJr/FZhhJmiqIB0e053QNYFqOBouTMO/k5sID4MvCiUCvv8b9M4h32wIA==",
|
||||
"dev": true,
|
||||
"hasInstallScript": true,
|
||||
"license": "MIT",
|
||||
"bin": {
|
||||
"esbuild": "bin/esbuild"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"optionalDependencies": {
|
||||
"@esbuild/aix-ppc64": "0.28.2",
|
||||
"@esbuild/android-arm": "0.28.2",
|
||||
"@esbuild/android-arm64": "0.28.2",
|
||||
"@esbuild/android-x64": "0.28.2",
|
||||
"@esbuild/darwin-arm64": "0.28.2",
|
||||
"@esbuild/darwin-x64": "0.28.2",
|
||||
"@esbuild/freebsd-arm64": "0.28.2",
|
||||
"@esbuild/freebsd-x64": "0.28.2",
|
||||
"@esbuild/linux-arm": "0.28.2",
|
||||
"@esbuild/linux-arm64": "0.28.2",
|
||||
"@esbuild/linux-ia32": "0.28.2",
|
||||
"@esbuild/linux-loong64": "0.28.2",
|
||||
"@esbuild/linux-mips64el": "0.28.2",
|
||||
"@esbuild/linux-ppc64": "0.28.2",
|
||||
"@esbuild/linux-riscv64": "0.28.2",
|
||||
"@esbuild/linux-s390x": "0.28.2",
|
||||
"@esbuild/linux-x64": "0.28.2",
|
||||
"@esbuild/netbsd-arm64": "0.28.2",
|
||||
"@esbuild/netbsd-x64": "0.28.2",
|
||||
"@esbuild/openbsd-arm64": "0.28.2",
|
||||
"@esbuild/openbsd-x64": "0.28.2",
|
||||
"@esbuild/openharmony-arm64": "0.28.2",
|
||||
"@esbuild/sunos-x64": "0.28.2",
|
||||
"@esbuild/win32-arm64": "0.28.2",
|
||||
"@esbuild/win32-ia32": "0.28.2",
|
||||
"@esbuild/win32-x64": "0.28.2"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,26 @@
|
||||
{
|
||||
"name": "yun-xue-tang-assistant",
|
||||
"version": "2.8.0",
|
||||
"private": true,
|
||||
"description": "云学堂(*.yunxuetang.cn)Tampermonkey 助手:自动登录、顺序听课、自动切节、批量刷课",
|
||||
"scripts": {
|
||||
"build": "node scripts/build.mjs",
|
||||
"build:watch": "node scripts/build.mjs --watch",
|
||||
"dev": "node dev/serve.mjs",
|
||||
"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",
|
||||
"test:tui": "node dev/tests/tui-test.mjs",
|
||||
"test:study": "node dev/tests/study-test.mjs",
|
||||
"headless": "node runner/headless.mjs",
|
||||
"headless:check": "node runner/headless.mjs --check"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"devDependencies": {
|
||||
"esbuild": "^0.28.2"
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,271 @@
|
||||
// 浏览器探测与启动:Linux 无图形化服务器(含 root / 容器)与 Windows 无人值守都适配。
|
||||
//
|
||||
// 关键点:
|
||||
// - 无显示环境下必须 --headless=new(或回退 --headless),否则 Chrome 起不来;
|
||||
// - 以 root 运行时 Chromium 拒绝启动,必须 --no-sandbox;
|
||||
// - 容器里 /dev/shm 通常只有 64MB,必须 --disable-dev-shm-usage,否则标签页会崩;
|
||||
// - 服务器上没有 GPU/音频设备,关闭相关初始化可减少噪声与卡顿;
|
||||
// - user-data-dir 固定到可配置目录(持久化 cookie),并清理上次被强杀留下的残局:
|
||||
// Linux 的 SingletonLock 符号链接、Windows 的 lockfile,以及两个平台上
|
||||
// 「被任务管理器/ kill -9 杀掉后留下来占着端口的孤儿浏览器进程」。
|
||||
//
|
||||
// 平台相关的判断(有无图形会话、沙箱参数、进程树怎么收)全部在 platform.mjs,
|
||||
// 这里只负责「探测路径 + 拼参数 + 启动 + 等端口就绪」。
|
||||
import fs from 'node:fs';
|
||||
import os from 'node:os';
|
||||
import path from 'node:path';
|
||||
import { spawn } from 'node:child_process';
|
||||
import { httpJson, sleep } from './cdp.mjs';
|
||||
import {
|
||||
isWindows, isLinux, isRunningAsRoot, safetyArgs, killTree, killProfileOrphans,
|
||||
} from './platform.mjs';
|
||||
|
||||
// 由本模块统一再导出,老的调用方(dev/tests/real-cdp.mjs 等)不用改
|
||||
// (hasDisplay / safetyArgs 只在这里转发,本模块内部不直接用)
|
||||
export {
|
||||
hasDisplay, safetyArgs, isRunningAsRoot, platformName, noDisplayReason,
|
||||
} from './platform.mjs';
|
||||
|
||||
// 各平台常见的 Chrome / Chromium 安装位置(按优先级)
|
||||
const CANDIDATES = [
|
||||
process.env.YUN_XUE_TANG_CHROME_BIN,
|
||||
process.env.YUN_XUE_TANG_CHROME,
|
||||
// Linux(发行版包管理器)
|
||||
'/usr/bin/google-chrome',
|
||||
'/usr/bin/google-chrome-stable',
|
||||
'/usr/bin/chromium',
|
||||
'/usr/bin/chromium-browser',
|
||||
'/snap/bin/chromium',
|
||||
'/opt/google/chrome/chrome',
|
||||
// 常见容器镜像(playwright / puppeteer 预装)
|
||||
'/root/.cache/ms-playwright/chromium-latest-linux/chrome-linux/chrome',
|
||||
'/ms-playwright/chromium-*/chrome-linux/chrome',
|
||||
'/usr/lib/chromium/chromium',
|
||||
'/usr/lib/chromium-browser/chromium-browser',
|
||||
// Windows:Chrome / Edge / Chromium 的常见安装位置(含按用户安装的 LOCALAPPDATA)
|
||||
process.env.LOCALAPPDATA && path.join(process.env.LOCALAPPDATA, 'Google/Chrome/Application/chrome.exe'),
|
||||
process.env.LOCALAPPDATA && path.join(process.env.LOCALAPPDATA, 'Chromium/Application/chrome.exe'),
|
||||
process.env.PROGRAMFILES && path.join(process.env.PROGRAMFILES, 'Google/Chrome/Application/chrome.exe'),
|
||||
process.env['PROGRAMFILES(X86)'] && path.join(process.env['PROGRAMFILES(X86)'], 'Google/Chrome/Application/chrome.exe'),
|
||||
process.env.PROGRAMFILES && path.join(process.env.PROGRAMFILES, 'Microsoft/Edge/Application/msedge.exe'),
|
||||
process.env['PROGRAMFILES(X86)'] && path.join(process.env['PROGRAMFILES(X86)'], 'Microsoft/Edge/Application/msedge.exe'),
|
||||
'C:/Program Files/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Google/Chrome/Application/chrome.exe',
|
||||
'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe',
|
||||
'C:/Program Files/Microsoft/Edge/Application/msedge.exe',
|
||||
// macOS
|
||||
'/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
|
||||
'/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
|
||||
'/Applications/Chromium.app/Contents/MacOS/Chromium',
|
||||
].filter(Boolean);
|
||||
|
||||
// 运行时的可执行名(Windows 上文件名带 .exe,Linux 上可执行名不带扩展名)
|
||||
const EXE_RE = /(^|[\/])(chrome|chromium|msedge)(\.exe)?$/i;
|
||||
|
||||
function isFile(p) {
|
||||
try { return fs.statSync(p).isFile(); } catch (e) { return false; }
|
||||
}
|
||||
|
||||
// 通配符路径(例如 playwright 缓存目录带哈希后缀)逐个展开
|
||||
function expandGlob(patterns) {
|
||||
const out = [];
|
||||
const seen = new Set();
|
||||
const walk = function (dir, depth) {
|
||||
if (depth > 6) return;
|
||||
let entries;
|
||||
try { entries = fs.readdirSync(dir, { withFileTypes: true }); } catch (e) { return; }
|
||||
for (const en of entries) {
|
||||
const full = path.join(dir, en.name);
|
||||
if (en.isFile() && EXE_RE.test(full) && isFile(full)) {
|
||||
if (!seen.has(full)) { seen.add(full); out.push(full); }
|
||||
} else if (en.isDirectory()) {
|
||||
walk(full, depth + 1);
|
||||
}
|
||||
}
|
||||
};
|
||||
for (const p of patterns) {
|
||||
if (p.indexOf('*') < 0) continue;
|
||||
const base = p.slice(0, p.indexOf('*'));
|
||||
walk(base.endsWith('/') ? base : base.slice(0, base.lastIndexOf('/') + 1), 0);
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
export function resolveBrowser() {
|
||||
const globbed = expandGlob(CANDIDATES);
|
||||
const all = CANDIDATES.concat(globbed);
|
||||
for (const p of all) {
|
||||
if (p && p.indexOf('*') < 0 && isFile(p)) return p;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
export function listCandidatePaths() {
|
||||
return CANDIDATES.concat(expandGlob(CANDIDATES));
|
||||
}
|
||||
|
||||
// 上次进程被强杀(kill -9 / 任务管理器「结束任务」)时,profile 目录会留下锁文件,
|
||||
// Chrome 可能因此拒绝启动或一直弹「配置文件正在使用中」。
|
||||
//
|
||||
// 两套锁的名字不同:
|
||||
// POSIX SingletonLock / SingletonSocket / SingletonCookie,lock 是指向 hostname-pid 的符号链接,
|
||||
// 目标 pid 不存在即视为陈旧(还存在就说明真有浏览器在跑,不能动)。
|
||||
// Windows 用普通的空文件 lockfile;Windows 上没法从文件反查 pid,
|
||||
// 所以由调用方先用 killProfileOrphans() 把残留进程收掉,再清文件。
|
||||
export function cleanStaleSingleton(profileDir) {
|
||||
const names = isWindows
|
||||
? ['lockfile', 'SingletonLock', 'SingletonSocket', 'SingletonCookie']
|
||||
: ['SingletonLock', 'SingletonSocket', 'SingletonCookie'];
|
||||
|
||||
for (const name of names) {
|
||||
const p = path.join(profileDir, name);
|
||||
let st;
|
||||
try { st = fs.lstatSync(p); } catch (e) { continue; }
|
||||
try {
|
||||
if (st.isSymbolicLink()) {
|
||||
const target = fs.readlinkSync(p);
|
||||
const m = /-(\d+)$/.exec(target);
|
||||
const pid = m ? Number(m[1]) : 0;
|
||||
let alive = false;
|
||||
if (pid > 0) {
|
||||
try { process.kill(pid, 0); alive = true; } catch (e) { alive = false; }
|
||||
}
|
||||
if (alive) continue; // 真的有浏览器在跑,别动
|
||||
fs.unlinkSync(p);
|
||||
} else {
|
||||
fs.unlinkSync(p);
|
||||
}
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
}
|
||||
|
||||
export function buildArgs({
|
||||
profileDir, port, headless, noSandbox, windowSize = '1360,940', extraArgs = [],
|
||||
}) {
|
||||
const args = [
|
||||
`--remote-debugging-port=${port}`,
|
||||
`--remote-debugging-address=127.0.0.1`,
|
||||
`--user-data-dir=${profileDir}`,
|
||||
'--no-first-run',
|
||||
'--no-default-browser-check',
|
||||
'--disable-sync',
|
||||
'--disable-background-networking',
|
||||
'--disable-component-update',
|
||||
'--disable-features=Translate,MediaRouter,OptimizationHints',
|
||||
// 后台标签页/最小化时不要把定时器与视频节流,否则「持续听课」测不准
|
||||
'--disable-background-timer-throttling',
|
||||
'--disable-renderer-backgrounding',
|
||||
'--disable-backgrounding-occluded-windows',
|
||||
// 无人值守必须自己能起播,不能等用户手势
|
||||
'--autoplay-policy=no-user-gesture-required',
|
||||
'--mute-audio',
|
||||
// 服务器 / 无人值守机器上没有可用的 GPU 加速,关掉能少一类崩溃与噪声
|
||||
'--disable-gpu',
|
||||
'--window-size=' + windowSize,
|
||||
];
|
||||
|
||||
// 下面这些都是 POSIX 概念,Windows 上不认(加了也无害,但没必要)
|
||||
if (!isWindows) {
|
||||
args.push(
|
||||
// 容器里 /dev/shm 通常只有 64MB,不加会随机崩标签页
|
||||
'--disable-dev-shm-usage',
|
||||
// 部分发行版 / 容器里 zygote 起不来
|
||||
'--no-zygote',
|
||||
);
|
||||
}
|
||||
|
||||
if (noSandbox && (isLinux || isRunningAsRoot())) {
|
||||
// Linux 服务器常见两种情况都需要它:以 root 运行、容器内 namespace 受限
|
||||
args.push('--no-sandbox', '--disable-setuid-sandbox');
|
||||
}
|
||||
|
||||
// 本平台额外需要的稳定性参数(Windows:不弹崩溃恢复气泡,免得无人值守时卡在等点击)
|
||||
args.push(...safetyArgs());
|
||||
|
||||
if (headless) args.push('--headless=new', '--hide-scrollbars');
|
||||
// 去重:上面手写的 Linux 参数和 safetyArgs() 有重叠,同一个开关重复传给 Chrome 没意义
|
||||
// (但 --disable-features 这类「后面的覆盖前面的」要注意,所以按首次出现保留并合并)
|
||||
return [...new Set(args)].concat(extraArgs, ['about:blank']);
|
||||
}
|
||||
|
||||
// 启动浏览器并等 CDP 端口就绪。失败时回退到老的无头开关(老版本 Chromium 不认 --headless=new)。
|
||||
export async function launchBrowser(opts) {
|
||||
const {
|
||||
binary, profileDir, port, headless = true, noSandbox = true,
|
||||
extraArgs = [], timeoutMs = 45000, log = () => {},
|
||||
} = opts;
|
||||
|
||||
fs.mkdirSync(profileDir, { recursive: true });
|
||||
// 先收残留进程(被强杀后留下的孤儿会一直占着 CDP 端口),再清锁文件
|
||||
const orphans = await killProfileOrphans(profileDir, { log });
|
||||
if (orphans) log('[浏览器] 已清理 ' + orphans + ' 个残留浏览器进程');
|
||||
cleanStaleSingleton(profileDir);
|
||||
|
||||
// headless=true 先试 --headless=new,起不来再试 --headless
|
||||
const modes = headless ? [true, 'old'] : [false];
|
||||
|
||||
let lastErr = null;
|
||||
for (const mode of modes) {
|
||||
const isNew = mode === true || mode === 'old';
|
||||
let args = buildArgs({
|
||||
profileDir, port, headless: isNew, noSandbox, extraArgs,
|
||||
});
|
||||
if (mode === 'old') {
|
||||
args = args.map((a) => (a === '--headless=new' ? '--headless' : a));
|
||||
}
|
||||
log('[浏览器] 启动:' + binary + ' ' + (isNew ? (mode === 'old' ? '(headless 旧模式)' : '(headless=new)') : '(有界面)'));
|
||||
|
||||
// windowsHide:Windows 上不加会闪一个黑色控制台窗口,无人值守时必须隐藏
|
||||
const child = spawn(binary, args, { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true });
|
||||
let stderrTail = '';
|
||||
child.stderr.on('data', (b) => { stderrTail = (stderrTail + String(b)).slice(-4000); });
|
||||
child.stdout.on('data', () => {});
|
||||
let exited = false;
|
||||
child.on('exit', (code, signal) => {
|
||||
exited = true;
|
||||
if (code !== 0 && code !== null) log('[浏览器] 进程退出 code=' + code + ' signal=' + signal);
|
||||
});
|
||||
|
||||
const started = Date.now();
|
||||
let version = null;
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
if (exited) break;
|
||||
try {
|
||||
const v = await httpJson(`http://127.0.0.1:${port}/json/version`);
|
||||
if (v && v.webSocketDebuggerUrl) { version = v; break; }
|
||||
} catch (e) { /* 还没起来 */ }
|
||||
await sleep(300);
|
||||
}
|
||||
|
||||
if (version) {
|
||||
return {
|
||||
child, version, args,
|
||||
headless: isNew,
|
||||
kill: function () {
|
||||
// 跨平台收进程树(Windows 走 TerminateProcess + taskkill /T,POSIX 走 SIGTERM→SIGKILL)
|
||||
return killTree(child, { log });
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
await killTree(child, { log, timeoutMs: 3000 });
|
||||
await sleep(500);
|
||||
lastErr = new Error('CDP 端口未就绪(' + port + ')');
|
||||
if (stderrTail.trim()) {
|
||||
lastErr.message += '\n浏览器 stderr(尾部):\n' + stderrTail.trim().split('\n').slice(-12).join('\n');
|
||||
}
|
||||
// 只有 headless 才需要回退,非 headless 直接报错
|
||||
if (!headless) break;
|
||||
}
|
||||
throw lastErr || new Error('浏览器启动失败');
|
||||
}
|
||||
|
||||
// 建议的持久化 profile 目录:默认放项目内的 .run-profile(可用 YUN_XUE_TANG_PROFILE_DIR 覆盖)
|
||||
export function defaultProfileDir(root) {
|
||||
if (process.env.YUN_XUE_TANG_PROFILE_DIR) return path.resolve(process.env.YUN_XUE_TANG_PROFILE_DIR);
|
||||
return path.join(root, '.run-profile');
|
||||
}
|
||||
|
||||
export function tmpProfileDir(prefix = 'yun-xue-tang-headless-') {
|
||||
return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
|
||||
}
|
||||
@@ -0,0 +1,87 @@
|
||||
// 极简 CDP 客户端:Node 22+ 原生 WebSocket,无需 puppeteer / playwright。
|
||||
// 与 dev/tests/real-cdp.mjs 同一套思路,额外提供「连接断开回调」与事件订阅失败隔离,
|
||||
// 供无人值守的 runner/headless.mjs 在断线时判断是否需要重建浏览器。
|
||||
export async function connect(wsUrl, opts = {}) {
|
||||
const ws = new WebSocket(wsUrl);
|
||||
await new Promise(function (res, rej) {
|
||||
ws.addEventListener('open', res, { once: true });
|
||||
ws.addEventListener('error', rej, { once: true });
|
||||
});
|
||||
|
||||
let id = 0;
|
||||
const pending = new Map();
|
||||
const events = [];
|
||||
const waiters = [];
|
||||
const listeners = [];
|
||||
const state = { closed: false };
|
||||
|
||||
ws.addEventListener('close', function () {
|
||||
state.closed = true;
|
||||
// 断线后所有未完成的调用直接拒绝,避免 runner 卡死在 await 上
|
||||
for (const [, p] of pending) {
|
||||
try { p.rej(new Error('CDP 连接已断开')); } catch (e) { /* ignore */ }
|
||||
}
|
||||
pending.clear();
|
||||
if (typeof opts.onClose === 'function') {
|
||||
try { opts.onClose(); } catch (e) { /* ignore */ }
|
||||
}
|
||||
});
|
||||
|
||||
ws.addEventListener('message', function (ev) {
|
||||
const msg = JSON.parse(ev.data);
|
||||
if (msg.id != null && pending.has(msg.id)) {
|
||||
const { res, rej } = pending.get(msg.id);
|
||||
pending.delete(msg.id);
|
||||
if (msg.error) rej(new Error(msg.error.message));
|
||||
else res(msg.result);
|
||||
return;
|
||||
}
|
||||
events.push(msg);
|
||||
for (const fn of listeners) {
|
||||
try { fn(msg); } catch (e) { /* 忽略订阅者异常 */ }
|
||||
}
|
||||
for (let i = waiters.length - 1; i >= 0; i--) {
|
||||
if (waiters[i].match(msg)) waiters.splice(i, 1)[0].res(msg);
|
||||
}
|
||||
});
|
||||
|
||||
const send = function (method, params = {}) {
|
||||
return new Promise(function (res, rej) {
|
||||
if (state.closed) { rej(new Error('CDP 连接已断开')); return; }
|
||||
const mid = ++id;
|
||||
pending.set(mid, { res, rej });
|
||||
try {
|
||||
ws.send(JSON.stringify({ id: mid, method, params }));
|
||||
} catch (e) {
|
||||
pending.delete(mid);
|
||||
rej(e);
|
||||
}
|
||||
});
|
||||
};
|
||||
|
||||
const waitEvent = function (name, timeoutMs = 30000) {
|
||||
return new Promise(function (res, rej) {
|
||||
const timer = setTimeout(function () { rej(new Error('等待事件超时: ' + name)); }, timeoutMs);
|
||||
waiters.push({
|
||||
match: (m) => m.method === name,
|
||||
res: (m) => { clearTimeout(timer); res(m.params); },
|
||||
});
|
||||
});
|
||||
};
|
||||
|
||||
const onEvent = function (fn) { listeners.push(fn); };
|
||||
|
||||
return {
|
||||
ws, send, waitEvent, onEvent, events,
|
||||
get closed() { return state.closed; },
|
||||
close: function () { try { ws.close(); } catch (e) { /* ignore */ } },
|
||||
};
|
||||
}
|
||||
|
||||
export const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
|
||||
|
||||
export async function httpJson(url, method = 'GET') {
|
||||
const r = await fetch(url, { method });
|
||||
const t = await r.text();
|
||||
try { return JSON.parse(t); } catch (e) { return t; }
|
||||
}
|
||||
@@ -0,0 +1,388 @@
|
||||
// 运行参数与路径:配置文件 / 环境变量 / 命令行在这里集中解析,其它模块只读导出的常量。
|
||||
//
|
||||
// 优先级(后者覆盖前者):
|
||||
// 内置默认值 < runner.config.mjs < 环境变量 YUN_XUE_TANG_* < 命令行参数 --x
|
||||
//
|
||||
// 配置文件是 JS 模块(见仓库根目录的 runner.config.mjs),可以写注释和表达式。
|
||||
// 账号密码不在配置文件里,只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,
|
||||
// 避免凭据进入版本库、进程列表和计划任务历史。
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { fileURLToPath, pathToFileURL } from 'node:url';
|
||||
import { defaultProfileDir } from './browser.mjs';
|
||||
import { hasDisplay, noDisplayReason, platformName } from './platform.mjs';
|
||||
|
||||
export { platformName, noDisplayReason };
|
||||
|
||||
const HERE = path.dirname(fileURLToPath(import.meta.url));
|
||||
export const ROOT = path.resolve(HERE, '..');
|
||||
/** 构建产物(注入页面的单文件脚本) */
|
||||
export const SCRIPT_FILE = path.join(ROOT, 'yun-xue-tang-assistant.user.js');
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 一层:内置默认值
|
||||
// ---------------------------------------------------------------------------
|
||||
const DEFAULTS = {
|
||||
maxCourses: 0, // 0 = 不限(一直刷到没有未学完的课)
|
||||
budgetMinutes: 0, // 0 = 不限
|
||||
preferShort: true,
|
||||
restartMinutes: 0, // 0 = 停下就退出
|
||||
idleRestartMinutes: 30,
|
||||
origin: 'https://kfmic.yunxuetang.cn',
|
||||
url: '', // 留空 = <origin>/login.html
|
||||
port: 9336,
|
||||
headless: true,
|
||||
chrome: '',
|
||||
extraArgs: '',
|
||||
profile: '', // 留空 = ./.run-profile
|
||||
logFile: '', // 留空 = ./run-logs/headless.log
|
||||
logMaxBytes: 5 * 1024 * 1024,
|
||||
tui: true, // true = 交互式终端里启用面板;非 TTY 自动退化为逐行日志
|
||||
color: true, // false = 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
|
||||
};
|
||||
|
||||
const argv = process.argv.slice(2);
|
||||
|
||||
// 已废弃 / 旧版参数别名:老脚本里的写法继续可用,不报错
|
||||
const DEPRECATED = {
|
||||
'--visible': '已废弃:等价于设置 headless: false(或 --headless 0),本版本仍然可用',
|
||||
};
|
||||
/** 旧参数名 -> 配置字段(保持向后兼容,dev/tests/ 下的脚本还在用) */
|
||||
const ALIASES = {
|
||||
'--max': 'maxCourses',
|
||||
'--budget': 'budgetMinutes',
|
||||
'--restart': 'restartMinutes',
|
||||
'--idle': 'idleRestartMinutes',
|
||||
'--log': 'logFile',
|
||||
'--log-max': 'logMaxBytes',
|
||||
};
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 两层:读配置文件(JS 模块)
|
||||
// ---------------------------------------------------------------------------
|
||||
/** 配置文件路径:命令行 --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, 'config/runner.config.mjs');
|
||||
return fs.existsSync(def) ? def : '';
|
||||
}
|
||||
|
||||
export const CONFIG_FILE = configPath();
|
||||
const CONFIG_KNOWN = new Set([...Object.keys(DEFAULTS), 'username', 'password', 'check']);
|
||||
|
||||
let fileConfig = {};
|
||||
const configWarnings = [];
|
||||
if (CONFIG_FILE) {
|
||||
try {
|
||||
const mod = await import(pathToFileURL(CONFIG_FILE).href + '?t=' + Date.now());
|
||||
const raw = mod.default;
|
||||
if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
|
||||
throw new Error('默认导出必须是一个对象:export default { ... }');
|
||||
}
|
||||
for (const [k, v] of Object.entries(raw)) {
|
||||
if (!CONFIG_KNOWN.has(k)) configWarnings.push('配置文件里有未知字段「' + k + '」,已忽略');
|
||||
else if (v !== undefined) fileConfig[k] = v;
|
||||
}
|
||||
// 配置里写了账号:不采纳,只提示一次,避免有人以为这样能生效
|
||||
if (fileConfig.username !== undefined || fileConfig.password !== undefined) {
|
||||
configWarnings.push('配置文件里的 username / password 已忽略:凭据只认环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD');
|
||||
}
|
||||
} catch (e) {
|
||||
const explicit = argv.includes('--config') || !!process.env.YUN_XUE_TANG_CONFIG;
|
||||
const msg = e && e.code === 'ERR_MODULE_NOT_FOUND'
|
||||
? (explicit ? '指定的配置文件不存在' : '配置文件导入失败')
|
||||
: '配置文件内容有误';
|
||||
console.error(msg + ':' + CONFIG_FILE + '\n ' + (e && e.message ? e.message.split('\n')[0] : e));
|
||||
process.exit(2);
|
||||
}
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 命令行解析:--key value / --key=value / --flag
|
||||
// ---------------------------------------------------------------------------
|
||||
const BOOL_KEYS = ['preferShort', 'headless', 'check', 'tui', 'color'];
|
||||
const NUM_KEYS = ['maxCourses', 'budgetMinutes', 'restartMinutes', 'idleRestartMinutes', 'port', 'logMaxBytes'];
|
||||
const STR_KEYS = ['origin', 'url', 'profile', 'logFile', 'chrome', 'extraArgs', 'config'];
|
||||
|
||||
/** kebab-case → camelCase:--max-courses → maxCourses */
|
||||
function toCamel(flag) {
|
||||
return flag.replace(/^--/, '').replace(/-([a-z])/g, (m, c) => c.toUpperCase());
|
||||
}
|
||||
const camelToFlag = (k) => '--' + k.replace(/[A-Z]/g, (c) => '-' + c.toLowerCase());
|
||||
|
||||
function parseBool(v, raw) {
|
||||
const s = String(v).trim().toLowerCase();
|
||||
if (['1', 'true', 'yes', 'on', 'y'].includes(s)) return true;
|
||||
if (['0', 'false', 'no', 'off', 'n'].includes(s)) return false;
|
||||
console.error('参数值不是布尔值:' + raw + '(可用 1/0、true/false、on/off)');
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
const cliRaw = {};
|
||||
const unknownFlags = [];
|
||||
const missingValues = [];
|
||||
for (let i = 0; i < argv.length; i++) {
|
||||
const a = argv[i];
|
||||
if (!a.startsWith('--')) {
|
||||
unknownFlags.push(a);
|
||||
continue;
|
||||
}
|
||||
const eq = a.indexOf('=');
|
||||
let name;
|
||||
let inline;
|
||||
if (eq > 0) {
|
||||
name = a.slice(0, eq);
|
||||
inline = a.slice(eq + 1);
|
||||
} else {
|
||||
name = a;
|
||||
}
|
||||
if (DEPRECATED[name]) configWarnings.push(DEPRECATED[name]);
|
||||
let key = toCamel(name);
|
||||
if (ALIASES[name]) key = ALIASES[name];
|
||||
if (name === '--visible') key = 'headless'; // --visible = headless false
|
||||
if (name === '--no-tui') key = 'tui'; // --no-tui = tui false
|
||||
if (name === '--no-color') key = 'color'; // --no-color = color false
|
||||
if (name === '--help' || name === '-h') key = 'help';
|
||||
if (name === '--check') key = 'check';
|
||||
const known = CONFIG_KNOWN.has(key) || key === 'help' || key === 'config';
|
||||
if (!known) {
|
||||
unknownFlags.push(name);
|
||||
// 把未知参数的值一并吞掉,否则它会被当成一个独立的多余位置参数一起报
|
||||
if (inline === undefined && argv[i + 1] !== undefined && !argv[i + 1].startsWith('-')) i++;
|
||||
continue;
|
||||
}
|
||||
if (!BOOL_KEYS.includes(key) && !NUM_KEYS.includes(key) && !STR_KEYS.includes(key) && key !== 'help' && key !== 'config') {
|
||||
unknownFlags.push(name);
|
||||
if (inline === undefined && argv[i + 1] !== undefined && !argv[i + 1].startsWith('-')) i++;
|
||||
continue;
|
||||
}
|
||||
// 布尔量可以不带值(--check 等于 --check 1);数值和字符串必须带值
|
||||
let val;
|
||||
if (inline !== undefined) val = inline;
|
||||
else if (BOOL_KEYS.includes(key) && (argv[i + 1] === undefined || argv[i + 1].startsWith('--'))) val = '1';
|
||||
else if (argv[i + 1] !== undefined && !argv[i + 1].startsWith('--')) val = argv[++i];
|
||||
else {
|
||||
missingValues.push(name);
|
||||
continue;
|
||||
}
|
||||
if (name === '--visible') val = String(parseBool(val, name) ? 0 : 1); // --visible 0 → headless 1
|
||||
if (name === '--no-tui' || name === '--no-color') val = String(parseBool(val, name) ? 0 : 1);
|
||||
cliRaw[key] = val;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 三层:环境变量
|
||||
// ---------------------------------------------------------------------------
|
||||
const envNum = (name, cur) => {
|
||||
const v = process.env[name];
|
||||
if (v === undefined || v === '') return cur;
|
||||
const n = Number(v);
|
||||
if (!Number.isFinite(n)) {
|
||||
configWarnings.push(name + ' 不是数字,已忽略:' + v);
|
||||
return cur;
|
||||
}
|
||||
return n;
|
||||
};
|
||||
const envBool = (name, cur) => {
|
||||
const v = process.env[name];
|
||||
if (v === undefined || v === '') return cur;
|
||||
return !/^(0|false|no|off)$/i.test(v);
|
||||
};
|
||||
const envStr = (name, cur) => {
|
||||
const v = process.env[name];
|
||||
return v === undefined || v === '' ? cur : v;
|
||||
};
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 合并:defaults < 配置文件 < 环境变量 < 命令行
|
||||
// ---------------------------------------------------------------------------
|
||||
const merged = { ...DEFAULTS, ...fileConfig };
|
||||
|
||||
merged.maxCourses = envNum('YUN_XUE_TANG_MAX_COURSES', merged.maxCourses);
|
||||
merged.budgetMinutes = envNum('YUN_XUE_TANG_BUDGET_MINUTES', merged.budgetMinutes);
|
||||
merged.restartMinutes = envNum('YUN_XUE_TANG_RESTART_MINUTES', merged.restartMinutes);
|
||||
merged.idleRestartMinutes = envNum('YUN_XUE_TANG_IDLE_RESTART_MINUTES', merged.idleRestartMinutes);
|
||||
merged.port = envNum('YUN_XUE_TANG_CDP_PORT', merged.port);
|
||||
merged.logMaxBytes = envNum('YUN_XUE_TANG_LOG_MAX_BYTES', merged.logMaxBytes);
|
||||
merged.preferShort = envBool('YUN_XUE_TANG_PREFER_SHORT', merged.preferShort);
|
||||
merged.headless = envBool('YUN_XUE_TANG_HEADLESS', merged.headless);
|
||||
merged.origin = envStr('YUN_XUE_TANG_ORIGIN', merged.origin);
|
||||
merged.url = envStr('YUN_XUE_TANG_URL', merged.url);
|
||||
merged.logFile = envStr('YUN_XUE_TANG_LOG_FILE', merged.logFile);
|
||||
merged.profile = envStr('YUN_XUE_TANG_PROFILE_DIR', merged.profile);
|
||||
merged.chrome = envStr('YUN_XUE_TANG_CHROME_BIN', merged.chrome);
|
||||
merged.extraArgs = envStr('YUN_XUE_TANG_EXTRA_ARGS', merged.extraArgs);
|
||||
merged.tui = envBool('YUN_XUE_TANG_TUI', merged.tui);
|
||||
merged.color = envBool('YUN_XUE_TANG_COLOR', merged.color);
|
||||
|
||||
// 命令行最后覆盖
|
||||
const numBad = [];
|
||||
for (const [key, raw] of Object.entries(cliRaw)) {
|
||||
if (key === 'help' || key === 'config') continue;
|
||||
if (key === 'check') { merged.check = parseBool(raw, '--check'); continue; }
|
||||
if (BOOL_KEYS.includes(key)) { merged[key] = parseBool(raw, camelToFlag(key)); continue; }
|
||||
if (NUM_KEYS.includes(key)) {
|
||||
const n = Number(raw);
|
||||
if (!Number.isFinite(n)) numBad.push(camelToFlag(key) + ' 需要数字,收到「' + raw + '」');
|
||||
else merged[key] = n;
|
||||
continue;
|
||||
}
|
||||
merged[key] = raw;
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 校验
|
||||
// ---------------------------------------------------------------------------
|
||||
const problems = [...numBad];
|
||||
if (numBad.length === 0) {
|
||||
if (!(merged.port >= 1 && merged.port <= 65535)) problems.push('port 必须在 1-65535 之间,收到 ' + merged.port);
|
||||
if (!(merged.maxCourses >= 0)) problems.push('maxCourses 不能为负,收到 ' + merged.maxCourses);
|
||||
if (!(merged.budgetMinutes >= 0)) problems.push('budgetMinutes 不能为负,收到 ' + merged.budgetMinutes);
|
||||
if (!(merged.restartMinutes >= 0)) problems.push('restartMinutes 不能为负,收到 ' + merged.restartMinutes);
|
||||
if (!(merged.idleRestartMinutes >= 0)) problems.push('idleRestartMinutes 不能为负,收到 ' + merged.idleRestartMinutes);
|
||||
if (!(merged.logMaxBytes >= 0)) problems.push('logMaxBytes 不能为负,收到 ' + merged.logMaxBytes);
|
||||
}
|
||||
if (unknownFlags.length) {
|
||||
const uniq = [...new Set(unknownFlags)];
|
||||
problems.push('无法识别的参数:' + uniq.join(' ') + '(用 --help 查看支持的参数)');
|
||||
}
|
||||
if (missingValues.length) {
|
||||
const uniq = [...new Set(missingValues)];
|
||||
problems.push('这些参数缺少值:' + uniq.join(' '));
|
||||
}
|
||||
|
||||
export const HELP = argv.includes('--help') || argv.includes('-h');
|
||||
if (problems.length && !HELP) {
|
||||
console.error('参数有误:');
|
||||
for (const p of problems) console.error(' · ' + p);
|
||||
console.error('\n用 --help 查看支持的参数与配置文件字段。');
|
||||
process.exit(2);
|
||||
}
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 导出(保持原有大写下划线命名,其它模块不用改)
|
||||
// ---------------------------------------------------------------------------
|
||||
export const CHECK_ONLY = !!merged.check;
|
||||
export const ORIGIN = String(merged.origin || DEFAULTS.origin).replace(/\/+$/, '');
|
||||
export const START_URL = merged.url ? String(merged.url) : ORIGIN + '/login.html';
|
||||
export const USR = process.env.YUN_XUE_TANG_USR || '';
|
||||
export const PWD = process.env.YUN_XUE_TANG_PWD || '';
|
||||
export const PORT = merged.port;
|
||||
/** 本次最多完成几门课(0 = 不限) */
|
||||
export const MAX_COURSES = merged.maxCourses;
|
||||
/** 运行多少分钟后收尾(0 = 不限) */
|
||||
export const BUDGET_MINUTES = merged.budgetMinutes;
|
||||
export const PROFILE_DIR = merged.profile
|
||||
? path.resolve(ROOT, merged.profile)
|
||||
: defaultProfileDir(ROOT);
|
||||
|
||||
// 没有图形显示的环境(Linux 无 DISPLAY、Windows 的 Session 0)上开不了有界面浏览器,
|
||||
// 即使配置成有界面也强制无头:否则 Chrome 在 Linux 上报「Missing X server」然后退出,
|
||||
// 在 Windows 服务会话里则是起来就崩。
|
||||
export const WANT_VISIBLE = !merged.headless;
|
||||
export const VISIBLE = WANT_VISIBLE && hasDisplay();
|
||||
|
||||
export const PREFER_SHORT = merged.preferShort;
|
||||
/** 脚本自己停下后等待多少分钟再开新一轮(0 = 直接退出) */
|
||||
export const RESTART_MINUTES = merged.restartMinutes;
|
||||
/** 连续多少分钟没有任何进展判定卡死 */
|
||||
export const IDLE_RESTART_MINUTES = merged.idleRestartMinutes;
|
||||
export const LOG_FILE = merged.logFile
|
||||
? path.resolve(ROOT, merged.logFile)
|
||||
: path.join(ROOT, 'run-logs/headless.log');
|
||||
export const LOG_MAX_BYTES = merged.logMaxBytes;
|
||||
export const EXTRA_ARGS = String(merged.extraArgs || '').split(/\s+/).filter(Boolean);
|
||||
/** 配置文件里指定的浏览器路径(空 = 自动探测;优先级低于 YUN_XUE_TANG_CHROME_BIN,见 browser.mjs) */
|
||||
export const CHROME_BIN = merged.chrome || '';
|
||||
export const WARNINGS = configWarnings;
|
||||
|
||||
/** 面板是否带颜色:配置 / 环境变量 / 行业惯例的 NO_COLOR 都生效 */
|
||||
export const COLOR = merged.color && !process.env.NO_COLOR;
|
||||
|
||||
/**
|
||||
* 是否启用终端面板(TUI)。
|
||||
* 三个条件都满足才开:配置没关 + stdout 是交互式终端 + 不是自检模式。
|
||||
* 自检要打印 PASS/FAIL 清单,塞进面板的日志区会看不到,所以强制逐行输出。
|
||||
* 重定向到文件、管道、CI、计划任务里 stdout 不是 TTY,会自然退化。
|
||||
*/
|
||||
export const TUI = !!merged.tui && !CHECK_ONLY && !!process.stdout.isTTY;
|
||||
|
||||
/** 面板没开时,给一句人能看懂的原因(日志里只打一次) */
|
||||
export function tuiDisabledReason() {
|
||||
if (TUI) return '';
|
||||
if (CHECK_ONLY) return '自检模式不启用面板(要逐行看 PASS/FAIL)';
|
||||
if (!merged.tui) return '已按配置 / --no-tui 关闭面板';
|
||||
if (!process.stdout.isTTY) return 'stdout 不是交互式终端(重定向 / 管道 / 服务),改用逐行日志';
|
||||
return '环境不支持终端面板,改用逐行日志';
|
||||
}
|
||||
|
||||
/** 一条便于粘贴到 issue / 日志的自述 */
|
||||
export function describeRun() {
|
||||
return {
|
||||
configFile: CONFIG_FILE || '(未找到,使用内置默认值)',
|
||||
platform: platformName,
|
||||
checkOnly: CHECK_ONLY,
|
||||
headless: !VISIBLE,
|
||||
port: PORT,
|
||||
maxCourses: MAX_COURSES > 0 ? MAX_COURSES : '不限',
|
||||
budgetMinutes: BUDGET_MINUTES > 0 ? BUDGET_MINUTES : '不限',
|
||||
preferShort: PREFER_SHORT,
|
||||
restartMinutes: RESTART_MINUTES,
|
||||
idleRestartMinutes: IDLE_RESTART_MINUTES,
|
||||
profileDir: PROFILE_DIR,
|
||||
logFile: LOG_FILE,
|
||||
tui: TUI,
|
||||
color: COLOR,
|
||||
};
|
||||
}
|
||||
|
||||
/** --help 文本:字段、命令行名、环境变量、当前生效值一起列出 */
|
||||
export function helpText() {
|
||||
const rows = [
|
||||
['配置字段', '命令行', '环境变量', '当前生效', '说明'],
|
||||
['maxCourses', '--max-courses', 'YUN_XUE_TANG_MAX_COURSES', MAX_COURSES, '本次最多完成几门课;0 = 不限'],
|
||||
['budgetMinutes', '--budget-minutes', 'YUN_XUE_TANG_BUDGET_MINUTES', BUDGET_MINUTES, '跑多少分钟后收尾;0 = 不限'],
|
||||
['preferShort', '--prefer-short', 'YUN_XUE_TANG_PREFER_SHORT', PREFER_SHORT, '优先总时长最短的课程'],
|
||||
['restartMinutes', '--restart-minutes', 'YUN_XUE_TANG_RESTART_MINUTES', RESTART_MINUTES, '脚本停下后等几分钟开新一轮;0 = 退出'],
|
||||
['idleRestartMinutes', '--idle-restart-minutes', 'YUN_XUE_TANG_IDLE_RESTART_MINUTES', IDLE_RESTART_MINUTES, '多少分钟无进展判卡死'],
|
||||
['origin', '--origin', 'YUN_XUE_TANG_ORIGIN', ORIGIN, '站点根地址'],
|
||||
['url', '--url', 'YUN_XUE_TANG_URL', START_URL, '起始页面;空 = <origin>/login.html'],
|
||||
['port', '--port', 'YUN_XUE_TANG_CDP_PORT', PORT, 'CDP 调试端口'],
|
||||
['headless', '--headless 0|1', 'YUN_XUE_TANG_HEADLESS', !VISIBLE, '1 = 无头,0 = 有界面'],
|
||||
['chrome', '--chrome', 'YUN_XUE_TANG_CHROME_BIN', CHROME_BIN || '(自动探测)', '浏览器可执行文件'],
|
||||
['extraArgs', '--extra-args', 'YUN_XUE_TANG_EXTRA_ARGS', EXTRA_ARGS.join(' ') || '(无)', '追加给浏览器的参数'],
|
||||
['profile', '--profile', 'YUN_XUE_TANG_PROFILE_DIR', PROFILE_DIR, '持久化 profile 目录'],
|
||||
['tui', '--no-tui', 'YUN_XUE_TANG_TUI', TUI ? '开' : '关', '交互式终端里的进度面板;非 TTY 自动关闭'],
|
||||
['color', '--no-color', 'YUN_XUE_TANG_COLOR', COLOR ? '开' : '关', '面板是否用 ANSI 颜色(也认 NO_COLOR)'],
|
||||
['logFile', '--log-file', 'YUN_XUE_TANG_LOG_FILE', LOG_FILE, '日志文件'],
|
||||
['logMaxBytes', '--log-max-bytes', 'YUN_XUE_TANG_LOG_MAX_BYTES', LOG_MAX_BYTES, '单文件上限,超出轮转'],
|
||||
['(字段 check)', '--check', '', CHECK_ONLY, '只做环境自检,不动进度'],
|
||||
['(无字段)', '--config', 'YUN_XUE_TANG_CONFIG', CONFIG_FILE || '(内置默认)', '指定配置文件路径'],
|
||||
];
|
||||
const widths = [0, 1, 2, 3].map((c) => Math.max(...rows.map((r) => String(r[c]).length)));
|
||||
const lines = [];
|
||||
lines.push('云学堂无头运行器');
|
||||
lines.push('');
|
||||
lines.push('用法:node runner/headless.mjs [参数…]');
|
||||
lines.push('优先级:内置默认值 < 配置文件 < 环境变量 YUN_XUE_TANG_* < 命令行参数');
|
||||
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++) {
|
||||
const r = rows[i].map((v, c) => (c < 4 ? String(v).padEnd(widths[c]) : String(v)));
|
||||
lines.push((i === 0 ? '' : '') + r.join(' '));
|
||||
if (i === 0) lines.push(' '.repeat(0) + widths.map((w) => '-'.repeat(w)).join(' '));
|
||||
}
|
||||
lines.push('');
|
||||
lines.push('示例:');
|
||||
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 --no-tui # 不用面板,回到逐行日志');
|
||||
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');
|
||||
}
|
||||
@@ -0,0 +1,129 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 无头运行器入口:在**无图形化环境**里跑云学堂助手。
|
||||
* 支持 Linux 服务器(机房机器 / 云主机 / 容器)与 Windows(桌面后台、服务器核心版、
|
||||
* 计划任务、Session 0 服务),也能在 macOS 上无头跑。
|
||||
*
|
||||
* 这个文件只做「组装」:解析参数 → 启动前预检 → 交给 supervisor 跑。
|
||||
* 具体实现在同目录的模块里:
|
||||
*
|
||||
* config.mjs 参数与环境变量(--max / YUN_XUE_TANG_* 全部集中在这里)
|
||||
* platform.mjs 平台差异(有无图形会话、沙箱参数、进程树收尾、端口排查命令)
|
||||
* preflight.mjs 启动前检查(产物 / Node 版本 / 凭据 / 浏览器 / 端口)
|
||||
* log.mjs 终端 + 文件日志(超上限轮转)
|
||||
* stop.mjs 终止信号优雅退出(Windows 上按 SIGINT/SIGBREAK/SIGHUP)
|
||||
* browser.mjs 浏览器探测、启动参数(root / 容器 / Windows 无人值守适配)、残局清理
|
||||
* cdp.mjs 极简 CDP 客户端
|
||||
* page.mjs 注入后要调用的页面 JS 表达式 + page 求值封装
|
||||
* session.mjs 单次会话:起浏览器 → 注入 → 自动登录 → 刷课 → 监控 → 收尾
|
||||
* selfcheck.mjs --check 的只读环境自检
|
||||
* supervisor.mjs 崩溃重启循环与退出码
|
||||
* tui.mjs 交互式终端面板(框线 + 进度条,q 退出;非 TTY 自动关闭)
|
||||
*
|
||||
* 用法(详见 README「无头运行」):
|
||||
* npm run build # 先出构建产物
|
||||
* Linux/macOS: export YUN_XUE_TANG_USR=... export YUN_XUE_TANG_PWD=...
|
||||
* Windows CMD: set YUN_XUE_TANG_USR=... set YUN_XUE_TANG_PWD=...
|
||||
* Windows PS: $env:YUN_XUE_TANG_USR='...'
|
||||
* npm run headless # 前台常驻,Ctrl+C 结束
|
||||
* npm run headless:check # 只做环境自检(只读,不登录、不刷课)
|
||||
*
|
||||
* 常用参数 / 环境变量:
|
||||
* --check 只自检:浏览器可启动、页面可访问、脚本可注入、视频编解码可用,
|
||||
* 不登录、不点课程、不动进度
|
||||
* --max N 本次最多完成 N 门课(0 = 不限,默认读脚本自身配置)
|
||||
* --budget N 运行 N 分钟后收尾(0 = 不限,默认 0)
|
||||
* --profile DIR 持久化 profile 目录(默认 ./.run-profile)
|
||||
* --port N CDP 调试端口(默认 9336)
|
||||
* --visible 不无头(无图形环境里会被忽略;本机调试用)
|
||||
* --no-tui 不用终端面板,回到逐行日志(stdout 非 TTY 时自动如此)
|
||||
* --no-color 面板不用 ANSI 颜色(也认 NO_COLOR 环境变量)
|
||||
* --url URL 起始页面(默认 https://kfmic.yunxuetang.cn/login.html)
|
||||
* YUN_XUE_TANG_CHROME_BIN Chrome/Chromium 可执行文件路径(默认自动探测)
|
||||
* YUN_XUE_TANG_EXTRA_ARGS 追加给浏览器的命令行参数(空格分隔)
|
||||
* YUN_XUE_TANG_PREFER_SHORT 1/0,是否优先短课程(默认 1)
|
||||
* YUN_XUE_TANG_RESTART_MINUTES 脚本停止/无进展后等待多久重新开始(0 = 直接退出,默认 0)
|
||||
* YUN_XUE_TANG_IDLE_RESTART_MINUTES 连续无进展多少分钟后判定卡死(默认 30)
|
||||
* YUN_XUE_TANG_LOG_FILE 日志文件路径(默认 ./run-logs/headless.log)
|
||||
* YUN_XUE_TANG_LOG_MAX_BYTES 单个日志文件上限,超过就轮转成 .1(默认 5MB)
|
||||
* YUN_XUE_TANG_HAS_DISPLAY 0/1,强制认定「有没有图形显示会话」(自动判断不准时用)
|
||||
* YUN_XUE_TANG_TUI 0/1,是否启用终端面板(默认 1,非 TTY 时无效)
|
||||
* YUN_XUE_TANG_COLOR 0/1,面板是否带颜色(也认 NO_COLOR)
|
||||
*
|
||||
* 退出码:0 正常收尾 / 1 无进展卡死 / 2 环境或参数问题 / 3 连续登录失败
|
||||
*/
|
||||
import * as cfg from './config.mjs';
|
||||
import { log, warn, error, closeLog } from './log.mjs';
|
||||
import { createStopHandler } from './stop.mjs';
|
||||
import { runPreflight, PreflightError } from './preflight.mjs';
|
||||
import { runSupervisor } from './supervisor.mjs';
|
||||
import { createTui } from './tui.mjs';
|
||||
|
||||
async function main() {
|
||||
// --help:打印完整参数表(含配置文件字段、环境变量、当前生效值)后直接退出
|
||||
if (cfg.HELP) {
|
||||
console.log(cfg.helpText());
|
||||
process.exit(0);
|
||||
}
|
||||
|
||||
const stop = createStopHandler({ log });
|
||||
|
||||
// 面板在预检之前就建好:预检的提示也进面板日志区,不会出现「先刷屏再盖住」
|
||||
const tui = createTui({
|
||||
enabled: cfg.TUI,
|
||||
title: '云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : ''),
|
||||
logFile: cfg.CHECK_ONLY ? '' : cfg.LOG_FILE,
|
||||
color: cfg.COLOR,
|
||||
onQuit: (reason) => stop.request(reason),
|
||||
});
|
||||
tui.set({ phase: '环境预检', tone: 'info' });
|
||||
|
||||
// 配置文件里有未知字段 / 废弃参数 / 被忽略的凭据:起来先提醒一句,不阻断
|
||||
for (const w of cfg.WARNINGS || []) warn('配置:' + w);
|
||||
|
||||
let pre;
|
||||
try {
|
||||
pre = await runPreflight({
|
||||
checkOnly: cfg.CHECK_ONLY,
|
||||
scriptFile: cfg.SCRIPT_FILE,
|
||||
usr: cfg.USR,
|
||||
pwd: cfg.PWD,
|
||||
port: cfg.PORT,
|
||||
profileDir: cfg.PROFILE_DIR,
|
||||
chromeBin: cfg.CHROME_BIN,
|
||||
log,
|
||||
});
|
||||
} catch (e) {
|
||||
if (e instanceof PreflightError) {
|
||||
tui.set({ phase: '环境预检失败', tone: 'error' });
|
||||
tui.finish();
|
||||
for (const l of e.lines) error(l);
|
||||
warn('修好上面问题后重跑;参数用 --help 查看。');
|
||||
closeLog();
|
||||
process.exit(e.exitCode);
|
||||
}
|
||||
tui.finish();
|
||||
closeLog();
|
||||
throw e;
|
||||
}
|
||||
|
||||
const { exitCode } = await runSupervisor({
|
||||
cfg,
|
||||
binary: pre.browser,
|
||||
scriptSrc: pre.scriptSrc,
|
||||
stop,
|
||||
tui,
|
||||
log,
|
||||
warn,
|
||||
error,
|
||||
});
|
||||
|
||||
closeLog();
|
||||
process.exit(exitCode);
|
||||
}
|
||||
|
||||
main().catch((e) => {
|
||||
error('致命错误:' + (e && e.stack ? e.stack : e));
|
||||
closeLog();
|
||||
process.exit(1);
|
||||
});
|
||||
@@ -0,0 +1,69 @@
|
||||
// 日志:同时写终端和日志文件(文件超上限就轮转成 .1)。
|
||||
//
|
||||
// 用法:
|
||||
// import { openLog, closeLog, log, warn, error } from './log.mjs';
|
||||
// openLog(file, maxBytes); // 不调用就只打终端
|
||||
// log('信息A', { x: 1 }); // → [2026-01-01 00:00:00] [信息] 信息A {"x":1}
|
||||
//
|
||||
// 终端面板(tui.mjs)启用时会把「终端」这一路改道到面板的日志区(setConsoleSink),
|
||||
// 文件那一路始终是纯文本逐行 —— 面板不会污染日志文件,grep / 采集不受影响。
|
||||
//
|
||||
// 注意:openLog 必须在任何写文件之前调用;closeLog 在进程退出路径上兜底调用。
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
|
||||
let stream = null;
|
||||
/** 终端输出目标;null = 直接 console.log(未启用面板时的默认行为) */
|
||||
let consoleSink = null;
|
||||
|
||||
/**
|
||||
* 接管 / 归还终端输出。传 null 恢复逐行 console.log。
|
||||
* sink(level, text) 收到的是完整的一行(不含换行)。
|
||||
* @param {null | ((level: string, text: string) => void)} fn
|
||||
*/
|
||||
export function setConsoleSink(fn) {
|
||||
consoleSink = typeof fn === 'function' ? fn : null;
|
||||
}
|
||||
|
||||
/** 打开日志文件;maxBytes 为单文件上限,超出时把现有文件改名成 .1 */
|
||||
export function openLog(file, maxBytes) {
|
||||
try {
|
||||
fs.mkdirSync(path.dirname(file), { recursive: true });
|
||||
try {
|
||||
const st = fs.statSync(file);
|
||||
if (st.size > maxBytes) fs.renameSync(file, file + '.1');
|
||||
} catch (e) { /* 文件还不存在 */ }
|
||||
stream = fs.createWriteStream(file, { flags: 'a' });
|
||||
} catch (e) {
|
||||
console.error('[日志] 无法写入 ' + file + ':' + e.message);
|
||||
}
|
||||
}
|
||||
|
||||
/** 关闭日志文件(可重复调用) */
|
||||
export function closeLog() {
|
||||
if (!stream) return;
|
||||
try { stream.end(); } catch (e) { /* ignore */ } finally { stream = null; }
|
||||
}
|
||||
|
||||
export function isLogOpen() {
|
||||
return stream !== null;
|
||||
}
|
||||
|
||||
const clock = () => new Date().toISOString().replace('T', ' ').slice(0, 19);
|
||||
|
||||
function line(level, args) {
|
||||
const text = '[' + clock() + '] [' + level + '] ' + args.map(function (a) {
|
||||
if (typeof a === 'string') return a;
|
||||
try { return JSON.stringify(a); } catch (e) { return String(a); }
|
||||
}).join(' ');
|
||||
if (consoleSink) {
|
||||
try { consoleSink(level, text); } catch (e) { /* 面板异常不影响日志文件 */ }
|
||||
} else {
|
||||
console.log(text);
|
||||
}
|
||||
if (stream) { try { stream.write(text + '\n'); } catch (e) { /* ignore */ } }
|
||||
}
|
||||
|
||||
export const log = (...a) => line('信息', a);
|
||||
export const warn = (...a) => line('警告', a);
|
||||
export const error = (...a) => line('错误', a);
|
||||
+159
@@ -0,0 +1,159 @@
|
||||
// 页面侧接口:所有「注入后要调用的 JS 表达式」集中在这里,外加把 CDP 的求值包成
|
||||
// 好用的 page 对象。改脚本内部 API 时只需要动这一个文件。
|
||||
//
|
||||
// page.evalJS(expr) 求值并返回值(异常会抛出)
|
||||
// page.json(expr) 求值并把返回的 JSON 字符串解析成对象
|
||||
// page.tryEval(expr) 求值但吞掉异常,返回 undefined(页面正在跳转时用)
|
||||
import { sleep } from './cdp.mjs';
|
||||
|
||||
/**
|
||||
* @param {object} cdp cdp.mjs 的客户端
|
||||
*/
|
||||
export function createPage(cdp) {
|
||||
const evalJS = async (expr) => {
|
||||
const r = await cdp.send('Runtime.evaluate', {
|
||||
expression: expr, returnByValue: true, awaitPromise: true, userGesture: true,
|
||||
});
|
||||
if (r.exceptionDetails) {
|
||||
const d = r.exceptionDetails;
|
||||
throw new Error((d.exception && d.exception.description) || d.text);
|
||||
}
|
||||
return r.result.value;
|
||||
};
|
||||
const json = async (expr) => JSON.parse(await evalJS(expr));
|
||||
const tryEval = async (expr) => {
|
||||
try { return await evalJS(expr); } catch (e) { return undefined; }
|
||||
};
|
||||
return { evalJS, json, tryEval };
|
||||
}
|
||||
|
||||
/** 环境自检:脚本是否注入、面板是否渲染、视频编解码能力、中文字体 */
|
||||
export const EXPR_SELF_CHECK = `JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
var probe = document.createElement('video');
|
||||
var codecs = {
|
||||
h264: probe.canPlayType('video/mp4; codecs="avc1.42E01E"') || '',
|
||||
aac: probe.canPlayType('audio/mp4; codecs="mp4a.40.2"') || '',
|
||||
vp9: probe.canPlayType('video/webm; codecs="vp9"') || '',
|
||||
};
|
||||
return {
|
||||
url: location.href,
|
||||
ua: navigator.userAgent,
|
||||
api: typeof a,
|
||||
version: (document.getElementById('yun-xue-tang-version') || {}).textContent || '',
|
||||
panels: document.querySelectorAll('#yun-xue-tang-panel').length,
|
||||
panelVisible: (function () {
|
||||
var el = document.getElementById('yun-xue-tang-panel');
|
||||
if (!el) return false;
|
||||
var r = el.getBoundingClientRect();
|
||||
return r.width > 0 && r.height > 0;
|
||||
})(),
|
||||
isLoginPage: a ? a.isLoginPage() : null,
|
||||
route: a ? a.route() : null,
|
||||
codecs: codecs,
|
||||
fonts: (function () {
|
||||
// 中文字体缺失不影响逻辑(靠 DOM 文本匹配),仅影响截图观感
|
||||
var c = document.createElement('canvas').getContext('2d');
|
||||
if (!c) return 'n/a';
|
||||
c.font = '16px sans-serif';
|
||||
var w = c.measureText('云学堂助手').width;
|
||||
var w2 = c.measureText('abcd').width;
|
||||
return w > 0 && w2 > 0 ? 'ok' : 'unknown';
|
||||
})(),
|
||||
};
|
||||
})())`;
|
||||
|
||||
/** 看护循环:判断是否需要注入 / 是否在登录页 / 当前 --max 生效值 */
|
||||
export const EXPR_WATCH = `JSON.stringify({
|
||||
href: location.href,
|
||||
ready: typeof window.__yunXueTangAuto === 'object',
|
||||
onLogin: !!(window.__yunXueTangAuto && window.__yunXueTangAuto.isLoginPage()),
|
||||
hasPwd: !!document.querySelector('input[type=password]'),
|
||||
bodyLen: (document.body && document.body.innerText || '').length,
|
||||
maxCourses: (window.__yunXueTangAuto && window.__yunXueTangAuto.CFG) ? window.__yunXueTangAuto.CFG.maxCourses : null,
|
||||
})`;
|
||||
|
||||
/** 主监控快照:课程、课时、进度、倒计时、视频状态 */
|
||||
export const EXPR_SNAPSHOT = `JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (!a) return { noApi: true, href: location.href };
|
||||
var v = document.querySelector('video, audio');
|
||||
var items = [];
|
||||
try { items = a.lessonItems(); } catch (e) {}
|
||||
return {
|
||||
href: location.href,
|
||||
route: a.route(),
|
||||
running: a.S.batchRunning,
|
||||
runFinished: a.S.batchFinished,
|
||||
phase: a.S.coursePhase,
|
||||
completed: a.S.completedThisRun,
|
||||
pendingRetries: Object.keys(a.S.courseRetries || {}).length,
|
||||
course: a.S.activeCourse ? a.S.activeCourse.title : null,
|
||||
lesson: (a.readActiveLessonKey ? a.readActiveLessonKey() : ''),
|
||||
lessons: items.length,
|
||||
summary: a.readSummary(),
|
||||
countdown: a.readCountdown(),
|
||||
// 本课程可获得多少学分:平台只把它写在倒计时文案里
|
||||
// 「还需 2小时 7分钟 可完成本课程学习并获得6.52学分,加油!」
|
||||
// 学完后倒计时会消失,所以必须在播放期间就读出来(运行器靠它累计到手学分)
|
||||
credit: (function () {
|
||||
var el = document.querySelector('.yxtulcdsdk-course-player__countdown');
|
||||
if (!el) return null;
|
||||
var t = String(el.innerText || el.textContent || '').replace(/\\s+/g, '');
|
||||
var m = t.match(/获得([0-9]+(?:\\.[0-9]+)?)学分/);
|
||||
return m ? Number(m[1]) : null;
|
||||
})(),
|
||||
status: (document.getElementById('yun-xue-tang-status') || {}).textContent || '',
|
||||
doneCount: Object.keys(a.S.completedTitles || {}).length,
|
||||
retryCount: Object.keys(a.S.courseRetries || {}).length,
|
||||
retryWait: (a.retryWaitSeconds ? a.retryWaitSeconds() : 0),
|
||||
retryTitle: a.R.retryTitle || '',
|
||||
video: v ? {
|
||||
t: Math.round(v.currentTime), d: Math.round(v.duration || 0),
|
||||
paused: v.paused, err: v.error ? v.error.code : 0, src: v.currentSrc ? 1 : 0,
|
||||
} : null,
|
||||
};
|
||||
})())`;
|
||||
|
||||
/** 会话结尾的累计统计 */
|
||||
export const EXPR_FINAL_STATS = `JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (!a) return {};
|
||||
return {
|
||||
completed: a.S.completedThisRun,
|
||||
doneCount: Object.keys(a.S.completedTitles || {}).length,
|
||||
retryCount: Object.keys(a.S.courseRetries || {}).length,
|
||||
};
|
||||
})())`;
|
||||
|
||||
/** 收尾:暂停媒体、停批量、存进度(浏览器关掉前调用) */
|
||||
export const EXPR_PAUSE_AND_SAVE = `(function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (a) { try { a.pauseAllMedia(); a.S.batchRunning = false; a.save(); } catch (e) {} }
|
||||
return true;
|
||||
})()`;
|
||||
|
||||
/** 把 maxCourses 同步到页面(0 = 不限,必须一并推送) */
|
||||
export const exprSetMaxCourses = (max) =>
|
||||
`(function(){ var a = window.__yunXueTangAuto; if (a && a.CFG) a.CFG.maxCourses = ${Number(max)}; return true; })()`;
|
||||
|
||||
/** 启动 / 接续批量刷课,同时同步「优先短课程」偏好 */
|
||||
export const exprStartBatch = (preferShort) => `(function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
try { localStorage.setItem('yun-xue-tang-prefer-short', '${preferShort ? '1' : '0'}'); } catch (e) {}
|
||||
a.state.preferShortCourses = ${preferShort ? 'true' : 'false'};
|
||||
a.startBatch();
|
||||
return true;
|
||||
})()`;
|
||||
|
||||
/** 登录页:填账号密码、勾协议、点登录并接着刷课 */
|
||||
export const exprAutoLogin = (usr, pwd) => `(function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
if (!a) return 'no-api';
|
||||
var ok = a.fillLoginForm(${JSON.stringify(usr)}, ${JSON.stringify(pwd)});
|
||||
try { a.checkLoginAgreement(); } catch (e) {}
|
||||
a.doLoginAndStart();
|
||||
return ok ? 'filled' : 'no-fields';
|
||||
})()`;
|
||||
|
||||
export { sleep };
|
||||
@@ -0,0 +1,230 @@
|
||||
// 平台差异集中在这里,其它模块不再直接判断 process.platform。
|
||||
//
|
||||
// 三个操作系统要处理的差异:
|
||||
// Linux 无 DISPLAY 必须无头;root 必须 --no-sandbox;容器 /dev/shm 小;SIGTERM 可优雅退出
|
||||
// Windows 会话 0(服务 / 计划任务「不管用户是否登录」)没有交互桌面;
|
||||
// 关闭终端窗口发的是 SIGHUP、Ctrl+Break 发的是 SIGBREAK(SIGTERM 根本收不到);
|
||||
// 跨进程只能用 taskkill 强杀(process.kill 是 TerminateProcess,子进程来不及收尾);
|
||||
// 浏览器进程树要用 taskkill /T 收;spawn 要 windowsHide 避免弹黑框
|
||||
// macOS 与 Linux 类似但没有 root 沙箱问题,SIGTERM 可用
|
||||
import { spawnSync } from 'node:child_process';
|
||||
|
||||
export const isWindows = process.platform === 'win32';
|
||||
export const isLinux = process.platform === 'linux';
|
||||
export const isMac = process.platform === 'darwin';
|
||||
/** 给人看的平台名(日志 / 提示里用) */
|
||||
export const platformName = isWindows ? 'Windows' : isMac ? 'macOS' : 'Linux';
|
||||
|
||||
export function isRunningAsRoot() {
|
||||
return typeof process.getuid === 'function' && process.getuid() === 0;
|
||||
}
|
||||
|
||||
/**
|
||||
* 有没有图形显示会话(决定能不能开有界面浏览器)。
|
||||
* 拿不准时返回 true(宁可按有界面处理,免得把正常桌面环境误判成无头)。
|
||||
* 可用 YUN_XUE_TANG_HAS_DISPLAY=0/1 强制覆盖。
|
||||
*/
|
||||
export function hasDisplay() {
|
||||
const force = process.env.YUN_XUE_TANG_HAS_DISPLAY;
|
||||
if (force !== undefined && force !== '') return !/^(0|false|no|off)$/i.test(force);
|
||||
|
||||
if (isLinux) {
|
||||
// 跑在 Xvfb / x11vnc 下时这两个变量会被设置
|
||||
return !!(process.env.DISPLAY || process.env.WAYLAND_DISPLAY);
|
||||
}
|
||||
if (isWindows) {
|
||||
// SESSIONNAME=Services 表示当前在 Session 0(服务、计划任务勾了「不管用户是否登录」),
|
||||
// 那里没有交互式桌面,带界面的 Chrome 起不来。正常控制台是 Console,远程桌面是 RDP-Tcp#N。
|
||||
const sess = process.env.SESSIONNAME || '';
|
||||
if (/^Services$/i.test(sess)) return false;
|
||||
return true;
|
||||
}
|
||||
return true; // macOS:登录会话里默认有 WindowServer
|
||||
}
|
||||
|
||||
/** 为什么判定没有图形显示(无图形时的日志用,有图形时返回 '') */
|
||||
export function noDisplayReason() {
|
||||
if (isLinux) {
|
||||
return '当前环境没有图形显示(DISPLAY / WAYLAND_DISPLAY 都为空)';
|
||||
}
|
||||
if (isWindows) {
|
||||
return '当前进程运行在 Session 0(SESSIONNAME=Services,服务或「不管用户是否登录」的计划任务),没有交互式桌面';
|
||||
}
|
||||
return '当前环境没有图形显示';
|
||||
}
|
||||
|
||||
// 平台安全参数验证:Windows 不注入 --no-sandbox(沙箱能正常工作,关掉只会削弱安全)
|
||||
// 注意:不要在这里返回 --disable-features,因为 Chrome 对同名开关只认最后一个,
|
||||
// 会抵消 buildArgs 里已有的 --disable-features=Translate,MediaRouter,OptimizationHints。
|
||||
export function safetyArgs() {
|
||||
if (isWindows) {
|
||||
// Windows 上不存在 /dev/shm 与 zygote;需要的是「别弹崩溃恢复气泡」,
|
||||
// 否则无人值守时会卡在一个等点击的窗口上。
|
||||
return ['--disable-session-crashed-bubble', '--hide-crash-restore-bubble'];
|
||||
}
|
||||
if (isLinux) {
|
||||
const args = ['--disable-dev-shm-usage'];
|
||||
if (isRunningAsRoot()) args.push('--no-sandbox', '--disable-setuid-sandbox', '--disable-gpu');
|
||||
return args;
|
||||
}
|
||||
return [];
|
||||
}
|
||||
|
||||
/**
|
||||
* 按 --user-data-dir 找出属于本 profile 的残留浏览器进程并杀掉。
|
||||
*
|
||||
* 很必要的自愈:Windows 上用户常用任务管理器「结束任务」(= TerminateProcess),
|
||||
* 信号收尾根本不会执行,浏览器就成了孤儿进程占着 CDP 端口,下次启动直接失败;
|
||||
* Linux 上 kill -9 同理。这里只杀命令行里带我们专属 profile 目录的进程,
|
||||
* 不碰用户自己的 Chrome。
|
||||
*
|
||||
* @param {string} profileDir
|
||||
* @param {{ log?: Function, timeoutMs?: number }} [opts]
|
||||
* @returns {Promise<number>} 杀掉的进程数
|
||||
*/
|
||||
export async function killProfileOrphans(profileDir, opts = {}) {
|
||||
const log = opts.log || (() => {});
|
||||
const timeoutMs = opts.timeoutMs || 5000;
|
||||
if (!profileDir) return 0;
|
||||
const self = process.pid;
|
||||
let pids = [];
|
||||
|
||||
try {
|
||||
if (isWindows) {
|
||||
// 注意:PowerShell 的各条语句必须用 '; ' 分隔,不能用空格连——
|
||||
// 否则 "$p -join ','" 会被当成上一条 Select-Object 的参数,变量永远为空。
|
||||
const pattern = profileDir.replace(/'/g, "''");
|
||||
const ps = [
|
||||
"$p = Get-CimInstance Win32_Process -Filter \"Name='chrome.exe' or Name='msedge.exe' or Name='chromium.exe'\"",
|
||||
' | Where-Object { $_.CommandLine -like \'*' + pattern + '*\' }',
|
||||
' | Select-Object -ExpandProperty ProcessId;',
|
||||
'$p -join \",\"',
|
||||
].join(' ');
|
||||
const r = spawnSync('powershell', ['-NoProfile', '-NonInteractive', '-Command', ps], {
|
||||
encoding: 'utf8', windowsHide: true, timeout: timeoutMs,
|
||||
});
|
||||
if (opts.debug) log('[浏览器] 排查命令输出:' + JSON.stringify(String(r.stdout || '').trim()));
|
||||
pids = String(r.stdout || '').trim().split(/[,\s]+/).filter(Boolean).map(Number);
|
||||
} else {
|
||||
const r = spawnSync('sh', ['-c', 'ps -eo pid=,args= 2>/dev/null || ps ax -o pid=,args='], {
|
||||
encoding: 'utf8', timeout: timeoutMs,
|
||||
});
|
||||
pids = String(r.stdout || '').split('\n')
|
||||
.filter((line) => line.includes(profileDir) && /(chrome|chromium|msedge)/i.test(line))
|
||||
.map((line) => Number(String(line).trim().split(/\s+/)[0]))
|
||||
.filter(Boolean);
|
||||
}
|
||||
} catch (e) {
|
||||
return 0;
|
||||
}
|
||||
|
||||
pids = pids.filter((pid) => Number.isFinite(pid) && pid > 0 && pid !== self);
|
||||
if (!pids.length) return 0;
|
||||
|
||||
log('[浏览器] 发现 ' + pids.length + ' 个占用本 profile 的残留进程(pid ' + pids.join(', ') + '),先收掉');
|
||||
if (isWindows) {
|
||||
spawnSync('taskkill', ['/pid', String(pids[0]), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
|
||||
for (const pid of pids) {
|
||||
spawnSync('taskkill', ['/pid', String(pid), '/F'], { windowsHide: true, stdio: 'ignore' });
|
||||
}
|
||||
} else {
|
||||
for (const pid of pids) {
|
||||
try { process.kill(pid, 'SIGKILL'); } catch (e) { /* 已经没了 */ }
|
||||
}
|
||||
}
|
||||
await new Promise((r) => setTimeout(r, 600));
|
||||
return pids.length;
|
||||
}
|
||||
|
||||
/**
|
||||
* 收掉浏览器进程(含子进程)。跨平台差异都在这里。
|
||||
* @param {import('node:child_process').ChildProcess} child
|
||||
* @param {{ log?: Function, timeoutMs?: number, profileDir?: string }} [opts]
|
||||
*/
|
||||
export async function killTree(child, opts = {}) {
|
||||
const log = opts.log || (() => {});
|
||||
const timeoutMs = opts.timeoutMs || 8000;
|
||||
const pid = child && child.pid;
|
||||
if (!pid) return;
|
||||
|
||||
const exited = () => child.exitCode !== null || child.signalCode !== null;
|
||||
const waitExit = async (ms) => {
|
||||
const t0 = Date.now();
|
||||
while (!exited() && Date.now() - t0 < ms) await new Promise((r) => setTimeout(r, 150));
|
||||
};
|
||||
|
||||
if (isWindows) {
|
||||
// Windows 上 child.kill() 就是 TerminateProcess:不优雅但立即生效。
|
||||
// 主进程若被 updater / crashpad handler 之类接管没退掉,退回 taskkill /T /F 收整棵树。
|
||||
try { child.kill(); } catch (e) { /* ignore */ }
|
||||
await waitExit(timeoutMs);
|
||||
if (!exited()) {
|
||||
log('[浏览器] 主进程未退出,用 taskkill /T /F 收整棵树(pid=' + pid + ')');
|
||||
try {
|
||||
spawnSync('taskkill', ['/pid', String(pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' });
|
||||
} catch (e) { /* ignore */ }
|
||||
await waitExit(3000);
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// POSIX:先 SIGTERM 让它自己收拾(Chrome 会 flush profile),超时再 SIGKILL
|
||||
try { child.kill('SIGTERM'); } catch (e) { /* ignore */ }
|
||||
await waitExit(timeoutMs);
|
||||
if (!exited()) { try { child.kill('SIGKILL'); } catch (e) { /* ignore */ } }
|
||||
}
|
||||
|
||||
/**
|
||||
* 端口被占用时给用户可以照抄的命令(按平台出)。
|
||||
* @param {number} port
|
||||
*/
|
||||
export function portInUseHint(port) {
|
||||
if (isWindows) {
|
||||
return [
|
||||
'netstat -ano | findstr :' + port + ' (最后一列是 PID)',
|
||||
'taskkill /PID <上一步的 PID> /T /F',
|
||||
];
|
||||
}
|
||||
if (isMac) {
|
||||
return ['lsof -nP -iTCP:' + port + ' -sTCP:LISTEN', 'kill <PID>'];
|
||||
}
|
||||
return [
|
||||
'ss -lptn "sport = :' + port + '"',
|
||||
'pkill -f "remote-debugging-port=' + port + '"',
|
||||
];
|
||||
}
|
||||
|
||||
/** 启动前提示:本平台的浏览器装在哪 / 怎么装 */
|
||||
export function browserInstallHint() {
|
||||
if (isWindows) {
|
||||
return [
|
||||
'装一个 Chrome 或 Edge 即可(Edge 是 Chromium 内核,同样可用):',
|
||||
' winget install --id Google.Chrome',
|
||||
' 或 YUN_XUE_TANG_CHROME_BIN="C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"',
|
||||
];
|
||||
}
|
||||
if (isMac) {
|
||||
return ['安装 Chrome:brew install --cask google-chrome(或下载 .dmg)',
|
||||
'或 YUN_XUE_TANG_CHROME_BIN="/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"'];
|
||||
}
|
||||
return [
|
||||
'安装浏览器:sudo apt install -y chromium (或 google-chrome-stable)',
|
||||
'或指定路径:YUN_XUE_TANG_CHROME_BIN=/usr/bin/chromium',
|
||||
];
|
||||
}
|
||||
|
||||
/** 常驻方式提示(README 里也有,这里给的是「照着敲」的命令) */
|
||||
export function residentHint() {
|
||||
if (isWindows) {
|
||||
return [
|
||||
'前台:npm run headless (Ctrl+C 结束)',
|
||||
'后台:Start-Process -WindowStyle Hidden node -ArgumentList "runner/headless.mjs"',
|
||||
'开机自启:把上面一行做成「登录时运行」的计划任务(勾「不管用户是否登录」也支持)',
|
||||
];
|
||||
}
|
||||
return [
|
||||
'前台:npm run headless (Ctrl+C 结束)',
|
||||
'后台:tmux new -d -s yun-xue-tang "npm run headless"',
|
||||
'看日志:tail -f run-logs/headless.log',
|
||||
];
|
||||
}
|
||||
@@ -0,0 +1,97 @@
|
||||
// 启动前预检:构建产物、Node 版本、凭据、浏览器、调试端口。
|
||||
//
|
||||
// 目标是把「失败」变成一段人能照着做的说明,而不是一个栈。所有检查失败都抛
|
||||
// PreflightError(exitCode=2),由 headless.mjs 统一打印并退出。
|
||||
import fs from 'node:fs';
|
||||
import { httpJson } from './cdp.mjs';
|
||||
import { resolveBrowser, listCandidatePaths } from './browser.mjs';
|
||||
import {
|
||||
isWindows, platformName, portInUseHint, browserInstallHint, killProfileOrphans,
|
||||
} from './platform.mjs';
|
||||
|
||||
export class PreflightError extends Error {
|
||||
constructor(lines, exitCode = 2) {
|
||||
super(Array.isArray(lines) ? lines.join('\n') : String(lines));
|
||||
this.name = 'PreflightError';
|
||||
this.lines = Array.isArray(lines) ? lines : [String(lines)];
|
||||
this.exitCode = exitCode;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 逐项检查,全部通过后返回 { browser, scriptSrc }。
|
||||
* @param {object} o
|
||||
* @param {boolean} o.checkOnly 自检模式不校验凭据
|
||||
* @param {string} o.scriptFile 构建产物路径
|
||||
* @param {string} o.usr
|
||||
* @param {string} o.pwd
|
||||
* @param {number} o.port
|
||||
* @param {string} o.profileDir 端口被占时用来找出「自己的」残留浏览器
|
||||
* @param {string} [o.chromeBin] 配置文件里指定的浏览器路径(空 = 自动探测)
|
||||
* @param {Function} [o.log]
|
||||
*/
|
||||
export async function runPreflight(o) {
|
||||
const fail = (lines) => { throw new PreflightError(lines); };
|
||||
|
||||
// 1) 构建产物:没有它就没东西可注入
|
||||
if (!fs.existsSync(o.scriptFile)) {
|
||||
fail([
|
||||
'缺少构建产物 ' + o.scriptFile + ',先运行 npm run build',
|
||||
'(仓库里只提交源码 src/,产物由 esbuild 生成)',
|
||||
]);
|
||||
}
|
||||
|
||||
// 2) Node 运行时能力:cdp.mjs 用全局 WebSocket / fetch,Node 22 起才稳定
|
||||
if (typeof WebSocket !== 'function' || typeof fetch !== 'function') {
|
||||
fail([
|
||||
'需要 Node 22+(依赖全局 WebSocket / fetch),当前 ' + process.version,
|
||||
isWindows
|
||||
? 'Windows 上升级:winget install OpenJS.NodeJS.LTS 或到 nodejs.org 下载 LTS 安装包'
|
||||
: 'Linux 上可用 nvm / nodesource 升级:curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -',
|
||||
]);
|
||||
}
|
||||
|
||||
// 3) 凭据:自检模式不需要(只读检查不登录)
|
||||
if (!o.checkOnly && (!o.usr || !o.pwd)) {
|
||||
fail([
|
||||
'缺少环境变量 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD。',
|
||||
'(即使 profile 里有有效 cookie,也建议填上:cookie 失效时才能自动重登)',
|
||||
]);
|
||||
}
|
||||
|
||||
// 4) 浏览器:找不到就把所有尝试过的路径列出来,省得用户猜
|
||||
const browser = o.chromeBin || resolveBrowser();
|
||||
if (!browser || !fs.existsSync(browser)) {
|
||||
fail(['找不到 Chrome/Chromium(' + platformName + '),可用 YUN_XUE_TANG_CHROME_BIN=/path/to/chrome '
|
||||
+ '或配置文件里的 chrome 字段指定。已尝试:']
|
||||
.concat(listCandidatePaths().map((p) => ' ' + p))
|
||||
.concat(browserInstallHint()));
|
||||
}
|
||||
|
||||
// 5) 调试端口:被占用意味着上一次的浏览器还在跑,Chrome 会直接拒绝启动。
|
||||
// 无人值守场景下「自己上次没退干净」是最常见的原因,先按 profile 自愈一次:
|
||||
// 只杀命令行里带本 profile 目录的进程,不碰用户自己的浏览器。
|
||||
const probe = async () => {
|
||||
try { return await httpJson('http://127.0.0.1:' + o.port + '/json/version'); } catch (e) { return null; }
|
||||
};
|
||||
let live = await probe();
|
||||
if (live && live.webSocketDebuggerUrl) {
|
||||
const killed = await killProfileOrphans(o.profileDir, { log: o.log });
|
||||
if (killed) {
|
||||
o.log('[预检] 已清理 ' + killed + ' 个占用本 profile 的残留进程,重新检测端口…');
|
||||
await new Promise((r) => setTimeout(r, 1200));
|
||||
live = await probe();
|
||||
}
|
||||
}
|
||||
if (live && live.webSocketDebuggerUrl) {
|
||||
const hint = portInUseHint(o.port);
|
||||
fail([
|
||||
'CDP 端口 ' + o.port + ' 已被占用(' + (live.Browser || '未知浏览器') + ')。',
|
||||
'先结束占用该端口的进程:' + hint[0],
|
||||
hint[1],
|
||||
'或换端口重跑:--port ' + (o.port + 1) + ' / YUN_XUE_TANG_CDP_PORT=' + (o.port + 1),
|
||||
]);
|
||||
}
|
||||
|
||||
return { browser, scriptSrc: fs.readFileSync(o.scriptFile, 'utf8') };
|
||||
}
|
||||
@@ -0,0 +1,62 @@
|
||||
// 环境自检(--check):只读,不登录、不点课程、不动进度。
|
||||
//
|
||||
// 检查项:页面能不能打开、脚本能不能注入、面板是否唯一可见、版本是否可读、
|
||||
// 这个 Chromium 到底带不带 H.264/AAC(服务器上最常见的问题:装了发行版 chromium 却放不了视频)。
|
||||
import { sleep } from './cdp.mjs';
|
||||
import { EXPR_SELF_CHECK } from './page.mjs';
|
||||
|
||||
/**
|
||||
* @param {object} o
|
||||
* @param {object} o.page page.mjs 的 page 对象
|
||||
* @param {Function} o.tickWatchdog 会话里负责注入 / 重登的看护函数
|
||||
* @param {Function} o.isDisconnected 判断 CDP 是否已断开
|
||||
* @param {number} [o.timeoutMs] 注入自检的最长等待
|
||||
* @returns {Promise<{ok:boolean, failed:string[], reason:string}>}
|
||||
*/
|
||||
export async function runSelfCheck(o) {
|
||||
const timeoutMs = o.timeoutMs || 60000;
|
||||
const log = o.log;
|
||||
|
||||
// 等页面加载完 + 注入成功(tickWatchdog 会补注入)
|
||||
const info = await (async () => {
|
||||
const started = Date.now();
|
||||
while (Date.now() - started < timeoutMs) {
|
||||
if (o.isDisconnected()) throw new Error('CDP 连接断开');
|
||||
try {
|
||||
await o.tickWatchdog();
|
||||
const v = await o.page.json(EXPR_SELF_CHECK);
|
||||
if (v && v.api === 'object') return v;
|
||||
} catch (e) { /* 页面仍在加载 */ }
|
||||
await sleep(1000);
|
||||
}
|
||||
throw new Error(Math.round(timeoutMs / 1000) + ' 秒内未能完成注入自检');
|
||||
})();
|
||||
|
||||
const failed = [];
|
||||
const ck = (name, ok, detail) => {
|
||||
log((ok ? ' PASS ' : ' FAIL ') + name + (detail === undefined ? '' : ' → ' + JSON.stringify(detail)));
|
||||
if (!ok) failed.push(name);
|
||||
};
|
||||
|
||||
log('--- 无头环境自检(只读)---');
|
||||
ck('页面可访问', /yunxuetang\.cn$/.test(new URL(info.url).host), info.url);
|
||||
ck('脚本已注入 window.__yunXueTangAuto', info.api === 'object', info.api);
|
||||
ck('面板渲染唯一', info.panels === 1 && info.panelVisible, { 面板数: info.panels, 可见: info.panelVisible });
|
||||
ck('脚本版本可读', /^v\d+\.\d+\.\d+$/.test(info.version || ''), info.version);
|
||||
ck('视频编解码 H.264 可用', info.codecs.h264 === 'probably' || info.codecs.h264 === 'maybe',
|
||||
{ h264: info.codecs.h264, aac: info.codecs.aac, vp9: info.codecs.vp9 });
|
||||
|
||||
log(' 提示:H.264 为 "maybe" 通常仍可播放;为空字符串说明该 Chromium 不带专有编解码器,');
|
||||
log(' 请改装 google-chrome-stable(官方包带 H.264/AAC),否则课程视频会一直是 0 秒。');
|
||||
log(' 页面识别的路由:' + info.route + ' 是否登录页:' + info.isLoginPage);
|
||||
log(' UA:' + String(info.ua).slice(0, 110));
|
||||
if (info.fonts && info.fonts !== 'ok') {
|
||||
log(' 提示:中文字体可能缺失(fonts=' + info.fonts + '),只影响截图观感;需要截图时 apt install fonts-noto-cjk');
|
||||
}
|
||||
|
||||
return {
|
||||
ok: failed.length === 0,
|
||||
failed,
|
||||
reason: failed.length ? '自检失败:' + failed.join('、') : '',
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,367 @@
|
||||
// 单次会话:一个浏览器进程的生命周期。
|
||||
//
|
||||
// 顺序:起浏览器 → 建标签页 → 连 CDP → 转发页面日志 → 每 1.5 秒看护
|
||||
// (补注入 / 自动重登 / 启动批量 / 同步 --max)→ 主监控(进度、卡死、退出条件)→ 收尾。
|
||||
// 崩溃或断线时直接抛错,由 supervisor.mjs 负责重建浏览器。
|
||||
import { connect, httpJson, sleep } from './cdp.mjs';
|
||||
import { launchBrowser } from './browser.mjs';
|
||||
import {
|
||||
createPage, EXPR_WATCH, EXPR_SNAPSHOT, EXPR_FINAL_STATS, EXPR_PAUSE_AND_SAVE,
|
||||
exprSetMaxCourses, exprStartBatch, exprAutoLogin,
|
||||
} from './page.mjs';
|
||||
import { runSelfCheck } from './selfcheck.mjs';
|
||||
|
||||
/** 看护循环间隔:既不能太密(CDP 往返),也要能及时补注入 */
|
||||
export const WATCHDOG_MS = 1500;
|
||||
/** 主监控轮询间隔:与面板的 1 秒刷新对齐,画面才不会一帧新一帧旧 */
|
||||
export const MONITOR_MS = 1000;
|
||||
/** 状态读不到多久后判定浏览器不可用 */
|
||||
const STATE_TIMEOUT_MS = 90000;
|
||||
/** 连续多少次登录失败判定为凭据/验证码问题(退出码 3) */
|
||||
const MAX_LOGIN_ATTEMPTS = 5;
|
||||
|
||||
// 当前会话的清理句柄。runSession 抛错时(CDP 断线、登录失败…)内部收尾代码不会执行,
|
||||
// 由 supervisor 在 catch 里调用 disposeActiveSession() 保证浏览器被收干净、端口能立刻复用。
|
||||
let activeCleanup = null;
|
||||
|
||||
/** 收掉当前会话(幂等,可在任何时刻调用) */
|
||||
export async function disposeActiveSession() {
|
||||
const fn = activeCleanup;
|
||||
activeCleanup = null;
|
||||
if (fn) await fn();
|
||||
}
|
||||
/** 两次自动登录之间的最小间隔,避免把账号刷到风控 */
|
||||
const LOGIN_COOLDOWN_MS = 20000;
|
||||
|
||||
/**
|
||||
* @param {object} o
|
||||
* @param {object} o.cfg config.mjs 的常量集合(见 headless.mjs 传入的 cfg 对象)
|
||||
* @param {string} o.binary 浏览器可执行文件
|
||||
* @param {string} o.scriptSrc 构建产物源码(注入用)
|
||||
* @param {object} o.stop stop.mjs 的 stop 句柄
|
||||
* @param {object} [o.tui] tui.mjs 的面板(不传 / 未启用时所有调用都是空操作)
|
||||
* @param {Function} o.log / o.warn / o.error 日志函数
|
||||
*/
|
||||
export async function runSession(o) {
|
||||
const { cfg, binary, scriptSrc, stop } = o;
|
||||
const log = o.log, warn = o.warn, error = o.error;
|
||||
// 面板是可选件:未启用时 set/snap 都是空操作,这里不需要分支判断
|
||||
const tui = o.tui || { set: () => {}, snap: () => {}, finish: () => {}, enabled: false };
|
||||
|
||||
let browser = null;
|
||||
let cdp = null;
|
||||
let watchdog = null;
|
||||
let disconnected = false;
|
||||
let injected = 0;
|
||||
let loginAttempts = 0;
|
||||
let loginLastAt = 0;
|
||||
let finished = false;
|
||||
let finishReason = '';
|
||||
let limitReached = false;
|
||||
let lastSig = '';
|
||||
let lastStateAt = Date.now();
|
||||
let codecWarned = false;
|
||||
// 看护循环里抛出的致命错误(如连续登录失败)不能就地丢掉:定时器的 catch
|
||||
// 拿不到主循环的控制流,必须把错误寄存下来,由主循环抛出。
|
||||
let fatalError = null;
|
||||
const consoleErrors = [];
|
||||
/** 是否达到配置的上限(maxCourses=0 表示不限) */
|
||||
const limitReachedByConfig = (completed) => cfg.MAX_COURSES > 0 && completed >= cfg.MAX_COURSES;
|
||||
|
||||
const page = {
|
||||
evalJS: null, json: null, tryEval: null,
|
||||
};
|
||||
|
||||
const disposeSession = async () => {
|
||||
if (watchdog) { clearInterval(watchdog); watchdog = null; }
|
||||
if (page.evalJS && cdp && !cdp.closed) {
|
||||
try { await page.evalJS(EXPR_PAUSE_AND_SAVE); } catch (e) { /* ignore */ }
|
||||
}
|
||||
if (cdp) { cdp.close(); cdp = null; }
|
||||
if (browser) { await browser.kill(); browser = null; }
|
||||
};
|
||||
const unregister = stop.add(disposeSession);
|
||||
activeCleanup = async () => { await disposeSession(); unregister(); };
|
||||
|
||||
// ---- 起浏览器 + 建标签页 + 连 CDP ----
|
||||
// 注意:attempt 由 supervisor 管,这里不要传(传 undefined 会把它抹掉)
|
||||
tui.set({ phase: '启动浏览器', tone: 'info' });
|
||||
browser = await launchBrowser({
|
||||
binary,
|
||||
profileDir: cfg.PROFILE_DIR,
|
||||
port: cfg.PORT,
|
||||
headless: !cfg.VISIBLE,
|
||||
extraArgs: cfg.EXTRA_ARGS,
|
||||
log,
|
||||
});
|
||||
log('浏览器就绪:' + browser.version.Browser + ' profile=' + cfg.PROFILE_DIR);
|
||||
tui.set({ phase: '打开页面', tone: 'info' });
|
||||
|
||||
const target = await httpJson('http://127.0.0.1:' + cfg.PORT + '/json/new?' + encodeURIComponent(cfg.START_URL), 'PUT');
|
||||
const wsUrl = target && target.webSocketDebuggerUrl;
|
||||
if (!wsUrl) throw new Error('无法创建标签页(/json/new 未返回 webSocketDebuggerUrl)');
|
||||
cdp = await connect(wsUrl, { onClose: () => { disconnected = true; } });
|
||||
await cdp.send('Page.enable');
|
||||
await cdp.send('Runtime.enable');
|
||||
await cdp.send('Log.enable');
|
||||
|
||||
const p = createPage(cdp);
|
||||
page.evalJS = p.evalJS;
|
||||
page.json = p.json;
|
||||
page.tryEval = p.tryEval;
|
||||
|
||||
// 页面 console / Log 转发:只关心脚本自己打的日志,其它 UA 噪声不看
|
||||
cdp.onEvent((m) => {
|
||||
if (m.method === 'Runtime.consoleAPICalled') {
|
||||
const text = (m.params.args || []).map((a) => (a.value !== undefined ? a.value : a.description || '')).join(' ');
|
||||
if (!/云学堂助手/.test(String(text))) return;
|
||||
if (m.params.type === 'error') {
|
||||
consoleErrors.push(String(text));
|
||||
error('页面脚本报错:' + String(text).slice(0, 300));
|
||||
} else {
|
||||
log('页面:' + String(text).slice(0, 300));
|
||||
}
|
||||
} else if (m.method === 'Log.entryAdded') {
|
||||
const t = m.params.entry;
|
||||
if (t.level === 'error' && /云学堂助手/.test(t.text)) {
|
||||
consoleErrors.push(t.text);
|
||||
error('页面报错:' + t.text.slice(0, 300));
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
// ---------------- 看护循环 ----------------
|
||||
// 每 WATCHDOG_MS 跑一次:新 document 补注入;掉登录自动重登;启动/接续批量;同步 --max。
|
||||
const tickWatchdog = async () => {
|
||||
if (disconnected || stop.stopping) return;
|
||||
const s = await page.tryEval(EXPR_WATCH).then((v) => (v ? JSON.parse(v) : null));
|
||||
if (!s || !s.href) return;
|
||||
|
||||
// 新 document / 首次加载:注入脚本(等价 Tampermonkey 按 @match 重注入)
|
||||
if (!s.ready) {
|
||||
if (/^(about:|chrome-error:|data:)/.test(String(s.href))) return; // 还没导航到真页面
|
||||
if (!s.bodyLen && !s.hasPwd) return; // 页面还在渲染
|
||||
try {
|
||||
await page.evalJS(scriptSrc);
|
||||
const t = await page.evalJS('typeof window.__yunXueTangAuto');
|
||||
if (t === 'object') {
|
||||
injected++;
|
||||
tui.set({ injected, phase: '已注入脚本' });
|
||||
log('已注入脚本(第 ' + injected + ' 次):' + String(s.href).slice(0, 90));
|
||||
} else {
|
||||
warn('注入后未生成 window.__yunXueTangAuto(typeof=' + t + ')');
|
||||
}
|
||||
} catch (e) {
|
||||
warn('注入失败:' + (e && e.message ? e.message : e));
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 运行策略同步到页面:maxCourses > 0 时覆盖脚本内置的 CFG.maxCourses;
|
||||
// 配成 0 表示「不限」,也要推 0 过去,否则页面里仍是脚本自己的 10 门上限。
|
||||
if (s.maxCourses !== null && s.maxCourses !== cfg.MAX_COURSES) {
|
||||
await page.tryEval(exprSetMaxCourses(cfg.MAX_COURSES));
|
||||
}
|
||||
|
||||
// 掉登录:用环境变量里的账号自动重登(限速 + 次数上限)
|
||||
if (s.onLogin) {
|
||||
if (loginAttempts >= MAX_LOGIN_ATTEMPTS) {
|
||||
throw new Error('连续 ' + MAX_LOGIN_ATTEMPTS + ' 次登录失败:请检查 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD,'
|
||||
+ '或站点要求人工验证码(无头环境无法完成)');
|
||||
}
|
||||
if (Date.now() - loginLastAt < LOGIN_COOLDOWN_MS) return;
|
||||
loginLastAt = Date.now();
|
||||
loginAttempts++;
|
||||
tui.set({ phase: '自动登录(第 ' + loginAttempts + ' 次)', tone: 'warn' });
|
||||
log('登录页:自动登录(第 ' + loginAttempts + ' 次尝试)');
|
||||
try {
|
||||
const r = await page.evalJS(exprAutoLogin(cfg.USR, cfg.PWD));
|
||||
if (r === 'no-fields') warn('登录页没找到账号/密码输入框:可能站点改版或页面尚未渲染完');
|
||||
} catch (e) {
|
||||
warn('自动登录调用失败:' + (e && e.message ? e.message : e));
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (loginAttempts) {
|
||||
loginAttempts = 0;
|
||||
tui.set({ phase: '已登录,准备刷课', tone: 'ok' });
|
||||
log('已离开登录页,登录成功');
|
||||
}
|
||||
|
||||
// 启动 / 接续批量。注意:脚本的运行状态存在 sessionStorage,
|
||||
// 每个会话都是新标签页 → 必然从「未运行」开始,所以这里每次都会显式启动一次,
|
||||
// 不会出现「浏览器重启后自动接着刷」或「未登录就报运行中」。
|
||||
const raw = await page.tryEval(`JSON.stringify((function () {
|
||||
var a = window.__yunXueTangAuto;
|
||||
return { route: a.route(), batchRunning: a.S.batchRunning, batchFinished: a.S.batchFinished, completed: a.S.completedThisRun };
|
||||
})())`);
|
||||
if (!raw) return; // 路由跳转中,下一轮再试
|
||||
const st = JSON.parse(raw);
|
||||
|
||||
if (st.batchFinished) {
|
||||
if (limitReachedByConfig(st.completed)) {
|
||||
limitReached = true;
|
||||
finishReason = '已完成 ' + st.completed + ' 门(达到上限 maxCourses=' + cfg.MAX_COURSES + ')';
|
||||
} else if (cfg.RESTART_MINUTES > 0) {
|
||||
finishReason = '脚本已停止(本次完成 ' + st.completed + ' 门),按 YUN_XUE_TANG_RESTART_MINUTES 稍后重新开始';
|
||||
} else {
|
||||
finishReason = '脚本已停止(本次完成 ' + st.completed + ' 门;无更多可学课程或达到脚本内上限)';
|
||||
}
|
||||
finished = true;
|
||||
return;
|
||||
}
|
||||
if (!st.batchRunning && st.route !== 'other') {
|
||||
const ok = await page.tryEval(exprStartBatch(cfg.PREFER_SHORT));
|
||||
if (ok) {
|
||||
tui.set({ phase: '刷课中', tone: 'ok' });
|
||||
log('已启动列表刷课' + (cfg.PREFER_SHORT ? '(优先短课程)' : ''));
|
||||
}
|
||||
}
|
||||
};
|
||||
|
||||
// ---------------- 自检模式 ----------------
|
||||
if (cfg.CHECK_ONLY) {
|
||||
tui.set({ phase: '环境自检中', tone: 'info' });
|
||||
const result = await runSelfCheck({
|
||||
page,
|
||||
tickWatchdog,
|
||||
isDisconnected: () => disconnected,
|
||||
log,
|
||||
});
|
||||
await disposeSession();
|
||||
unregister();
|
||||
activeCleanup = null;
|
||||
return result;
|
||||
}
|
||||
|
||||
log('模式:无头 ' + (browser.headless ? 'headless' : '否') +
|
||||
' 上限 ' + (cfg.MAX_COURSES > 0 ? cfg.MAX_COURSES + ' 门' : '不限') +
|
||||
' 预算 ' + (cfg.BUDGET_MINUTES > 0 ? cfg.BUDGET_MINUTES + ' 分钟' : '不限') +
|
||||
' 短课程优先 ' + (cfg.PREFER_SHORT ? '开' : '关') +
|
||||
' 无进展 ' + cfg.IDLE_RESTART_MINUTES + ' 分钟');
|
||||
|
||||
watchdog = setInterval(() => {
|
||||
tickWatchdog().catch((e) => {
|
||||
if (stop.stopping || disconnected) return;
|
||||
// 登录次数用尽这类错误是终局的,不能只警告后继续轮询
|
||||
if (/连续 \d+ 次登录失败/.test(e && e.message ? e.message : '')) {
|
||||
fatalError = e;
|
||||
if (watchdog) { clearInterval(watchdog); watchdog = null; }
|
||||
return;
|
||||
}
|
||||
warn('看护循环异常:' + (e && e.message ? e.message : e));
|
||||
});
|
||||
}, WATCHDOG_MS);
|
||||
await tickWatchdog();
|
||||
if (fatalError) throw fatalError;
|
||||
|
||||
// ---------------- 主监控 ----------------
|
||||
const startedAt = Date.now();
|
||||
const stallLimit = cfg.IDLE_RESTART_MINUTES > 0 ? cfg.IDLE_RESTART_MINUTES * 60 * 1000 : 30 * 60 * 1000;
|
||||
const deadline = cfg.BUDGET_MINUTES > 0 ? startedAt + cfg.BUDGET_MINUTES * 60 * 1000 : Infinity;
|
||||
let lastProgressAt = Date.now();
|
||||
let lastProgressKey = '';
|
||||
let doneReported = 0;
|
||||
|
||||
while (!stop.stopping) {
|
||||
if (fatalError) throw fatalError;
|
||||
if (disconnected) throw new Error('CDP 连接断开,重启浏览器');
|
||||
if (Date.now() > deadline) { finishReason = '达到运行预算 ' + cfg.BUDGET_MINUTES + ' 分钟'; break; }
|
||||
if (finished) break;
|
||||
|
||||
const raw = await page.tryEval(EXPR_SNAPSHOT);
|
||||
if (!raw) {
|
||||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||||
}
|
||||
await sleep(MONITOR_MS);
|
||||
continue;
|
||||
}
|
||||
const snap = JSON.parse(raw);
|
||||
if (snap.noApi) {
|
||||
if (Date.now() - lastStateAt > STATE_TIMEOUT_MS) {
|
||||
throw new Error('超过 ' + Math.round(STATE_TIMEOUT_MS / 1000) + ' 秒读不到脚本状态,重启浏览器');
|
||||
}
|
||||
await sleep(MONITOR_MS);
|
||||
continue;
|
||||
}
|
||||
lastStateAt = Date.now();
|
||||
// 面板每一轮都刷(快照本身就是最新状态,不需要另算);未启用时是空操作
|
||||
tui.snap(snap);
|
||||
if (!finishReason) {
|
||||
if (snap.runFinished) tui.set({ phase: '脚本已停止', tone: 'ok' });
|
||||
else if (snap.retryWait > 0) tui.set({ phase: '等待重试', tone: 'warn' });
|
||||
else if (snap.video && !snap.video.paused) tui.set({ phase: '刷课中', tone: 'ok' });
|
||||
else if (snap.route === 'list') tui.set({ phase: '列表页排队中', tone: 'info' });
|
||||
else tui.set({ phase: '运行中', tone: 'info' });
|
||||
}
|
||||
|
||||
// 编解码器缺失:视频元素有源但解码错误(MEDIA_ERR_DECODE / SRC_NOT_SUPPORTED)
|
||||
if (!codecWarned && snap.video && snap.video.src && snap.video.err >= 3) {
|
||||
codecWarned = true;
|
||||
warn('视频解码失败(error.code=' + snap.video.err + '):这个 Chromium 很可能不带 H.264/AAC 编解码器。');
|
||||
warn('请改装官方 google-chrome-stable,或换用带专有编解码器的 Chromium 构建。');
|
||||
}
|
||||
|
||||
// 有进展就重置停滞计时:课程/课时/进度/视频在播任一都算
|
||||
const key = [snap.course, snap.lesson, snap.completed, snap.summary && snap.summary.text, snap.doneCount].join('|');
|
||||
if (key !== lastProgressKey || (snap.video && !snap.video.paused)) {
|
||||
lastProgressKey = key;
|
||||
lastProgressAt = Date.now();
|
||||
}
|
||||
|
||||
// 只在状态变化时打日志,避免刷屏
|
||||
const sig = [snap.route, snap.course, snap.lesson, snap.completed, snap.phase, snap.runFinished].join('|');
|
||||
if (sig !== lastSig) {
|
||||
lastSig = sig;
|
||||
const parts = [];
|
||||
parts.push(snap.course ? ('课程「' + String(snap.course).slice(0, 28) + '」')
|
||||
: (snap.route === 'list' ? '列表页' : snap.route));
|
||||
if (snap.lesson) parts.push('课时 ' + String(snap.lesson).slice(0, 24));
|
||||
if (snap.summary && snap.summary.text) parts.push(String(snap.summary.text).slice(0, 24));
|
||||
if (snap.countdown != null) parts.push('倒计时 ' + snap.countdown + 's');
|
||||
parts.push('本次完成 ' + snap.completed + (cfg.MAX_COURSES > 0 ? '/' + cfg.MAX_COURSES : ''));
|
||||
if (snap.retryWait) parts.push('等待重试 ' + snap.retryWait + 's');
|
||||
else if (snap.retryCount) parts.push('待重试 ' + snap.retryCount);
|
||||
log(parts.join(' '));
|
||||
if (snap.status) log(' 状态:' + String(snap.status).slice(0, 120));
|
||||
}
|
||||
if (snap.completed > doneReported) {
|
||||
doneReported = snap.completed;
|
||||
log('✔ 已完成 ' + snap.completed + ' 门(累计记录 ' + snap.doneCount + ' 门)');
|
||||
}
|
||||
|
||||
// 到达上限 / 脚本停止 / 长时间无进展
|
||||
if (limitReachedByConfig(snap.completed)) {
|
||||
limitReached = true;
|
||||
finishReason = '已完成 ' + snap.completed + ' 门(达到上限 maxCourses=' + cfg.MAX_COURSES + ')';
|
||||
break;
|
||||
}
|
||||
if (snap.runFinished) { finishReason = '脚本已停止:' + (snap.status || '未知原因'); break; }
|
||||
if (Date.now() - lastProgressAt > stallLimit) {
|
||||
finishReason = '超过 ' + Math.round(stallLimit / 60000) + ' 分钟没有任何进展(最后停在 ' +
|
||||
(snap.course || '列表') + '),退出等待重启';
|
||||
break;
|
||||
}
|
||||
|
||||
await sleep(MONITOR_MS);
|
||||
}
|
||||
|
||||
// ---------------- 收尾 ----------------
|
||||
const elapsed = Math.round((Date.now() - startedAt) / 1000);
|
||||
const final = await page.tryEval(EXPR_FINAL_STATS).then((v) => (v ? JSON.parse(v) : {})).catch(() => ({}));
|
||||
tui.set({ phase: '本次会话结束,收尾中', tone: 'ok', completed: final.completed || 0 });
|
||||
log('本次会话结束:' + (finishReason || '收到退出信号') +
|
||||
' 用时 ' + Math.floor(elapsed / 60) + ' 分 ' + (elapsed % 60) + ' 秒' +
|
||||
' 本次完成 ' + (final.completed || 0) + ' 门,累计 ' + (final.doneCount || 0) + ' 门');
|
||||
if (consoleErrors.length) {
|
||||
warn('本次共 ' + consoleErrors.length + ' 条页面脚本报错,最后一条:' + consoleErrors.slice(-1)[0].slice(0, 200));
|
||||
}
|
||||
|
||||
await disposeSession();
|
||||
unregister();
|
||||
activeCleanup = null;
|
||||
|
||||
return { finishReason, limitReached, completed: final.completed || 0, elapsed, injected, ok: true };
|
||||
}
|
||||
@@ -0,0 +1,72 @@
|
||||
// 优雅退出:收到终止信号时按注册顺序并行执行收尾函数,然后退出。
|
||||
//
|
||||
// 用法:把「怎么把浏览器关干净」注册进来,主程序不用到处写信号处理。
|
||||
// const stop = createStopHandler({ log });
|
||||
// const unregister = stop.add(() => browser.kill());
|
||||
// if (stop.stopping) return; // 主循环里轮询这个开关
|
||||
// stop.request('q'); // 面板里按 q 也走同一条收尾路径
|
||||
//
|
||||
// 收尾完成后会 closeLog() 并以 0 退出,所以主循环不用自己处理信号。
|
||||
//
|
||||
// 各平台的信号差异(很重要,不然 Windows 上会「关不掉」):
|
||||
// Linux/macOS Ctrl+C = SIGINT,kill = SIGTERM,两者都能收
|
||||
// Windows Ctrl+C = SIGINT(可用),Ctrl+Break = SIGBREAK,关闭控制台窗口 = SIGHUP
|
||||
// SIGTERM 根本收不到;用 taskkill /F 或任务管理器「结束任务」是 TerminateProcess,
|
||||
// 任何处理函数都不会执行 —— 那种情况只能靠下次启动时清理残留进程+锁文件。
|
||||
import { closeLog, log as defaultLog } from './log.mjs';
|
||||
|
||||
/** 各平台实际可能收到的终止信号 */
|
||||
const SIGNALS = process.platform === 'win32'
|
||||
? ['SIGINT', 'SIGBREAK', 'SIGHUP']
|
||||
: ['SIGINT', 'SIGTERM', 'SIGHUP'];
|
||||
|
||||
/**
|
||||
* @param {{ log?: Function, onExit?: (code:number)=>void }} [opts]
|
||||
*/
|
||||
export function createStopHandler(opts = {}) {
|
||||
const say = opts.log || defaultLog;
|
||||
const exit = opts.onExit || ((code) => process.exit(code));
|
||||
const cleaners = [];
|
||||
let stopping = false;
|
||||
let triggered = null;
|
||||
|
||||
const run = async (signal) => {
|
||||
if (stopping) return;
|
||||
stopping = true;
|
||||
triggered = signal;
|
||||
say('收到 ' + signal + ',正在收尾…');
|
||||
// 收尾函数并行跑,谁也挡不住谁(浏览器关不掉也要退)
|
||||
await Promise.allSettled(cleaners.map((fn) => {
|
||||
try { return Promise.resolve(fn()); } catch (e) { return Promise.reject(e); }
|
||||
}));
|
||||
closeLog();
|
||||
exit(0);
|
||||
};
|
||||
|
||||
process.on('SIGINT', () => run('SIGINT'));
|
||||
process.on('SIGTERM', () => run('SIGTERM'));
|
||||
process.on('SIGBREAK', () => run('SIGBREAK')); // Windows:Ctrl+Break
|
||||
process.on('SIGHUP', () => run('SIGHUP')); // Windows:关闭控制台窗口
|
||||
|
||||
return {
|
||||
/** 注册一个收尾函数,返回取消注册的函数 */
|
||||
add(fn) {
|
||||
cleaners.push(fn);
|
||||
return () => {
|
||||
const i = cleaners.indexOf(fn);
|
||||
if (i >= 0) cleaners.splice(i, 1);
|
||||
};
|
||||
},
|
||||
/**
|
||||
* 主动请求收尾(终端面板里按 q / Ctrl+C 走这里),
|
||||
* 与收到信号完全同一条路径:并行收尾 → closeLog → exit(0)。
|
||||
*/
|
||||
request(reason) {
|
||||
run(reason || '面板退出');
|
||||
},
|
||||
get stopping() { return stopping; },
|
||||
get signal() { return triggered; },
|
||||
/** 本平台实际监听的信号列表(自检 / 日志里用) */
|
||||
signals: SIGNALS,
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,111 @@
|
||||
// 学习统计:本次运行学了多久、拿到多少学分。
|
||||
//
|
||||
// 两个口径都是用户能直接验证的,所以规则要写死在这里、别散到面板里:
|
||||
// · 学习时长 = 视频真正在播的累计时间(暂停 / 排队 / 重试退避 / 页面加载都不算)
|
||||
// · 获得学分 = 本次运行里真正刷完的课程能拿到的学分之和(按课程去重)
|
||||
//
|
||||
// 数据都来自 page.mjs 的 EXPR_SNAPSHOT:视频状态来自 <video> 元素,
|
||||
// 学分来自倒计时文案「…可完成本课程学习并获得6.52学分,加油!」。
|
||||
// 学完之后那个倒计时元素就消失了,所以学分必须边播边记进 creditOf。
|
||||
//
|
||||
// 这里不读时钟以外的任何东西,也不太碰终端——所以能脱离浏览器和 TTY 直接测。
|
||||
/** 两次快照间隔超过这个秒数就认为中间断过(浏览器重启 / 进程被挂起),不补计 */
|
||||
const MAX_GAP_SECONDS = 60;
|
||||
|
||||
/**
|
||||
* @param {object} [opts]
|
||||
* @param {Function} [opts.now] 取当前时间(毫秒),测试里可换成假时钟
|
||||
*/
|
||||
export function createStudyTracker(opts = {}) {
|
||||
const now = opts.now || (() => Date.now());
|
||||
|
||||
let studySeconds = 0; // 本次运行累计播放时长(秒)
|
||||
let creditEarned = 0; // 本次运行累计获得学分
|
||||
let credit = null; // 当前这门课学完能拿多少学分(平台只在播放期间写出来)
|
||||
let lastAt = 0; // 上一条快照的时间,用来算两次之间播了多少秒
|
||||
let lastPlaying = false;
|
||||
let lastCompleted = 0;
|
||||
let lastCourse = '';
|
||||
|
||||
const creditOf = new Map(); // 课程名 → 可得学分(学完后元素消失,只能靠缓存)
|
||||
const credited = new Set(); // 已计入的课程,防止重试 / 刷新页面重复累加
|
||||
|
||||
/**
|
||||
* 吃一条主监控快照,返回最新的统计值。
|
||||
* 传进来的快照字段可能缺失(页面刚跳转时就是半空的),所以全部按可选处理。
|
||||
*/
|
||||
function update(snap) {
|
||||
if (!snap || snap.noApi) return get();
|
||||
const at = now();
|
||||
const course = snap.course || '';
|
||||
|
||||
// ---- 学习时长:只算视频真的在播的时间 ----
|
||||
// 用「两次快照的真实间隔」而不是写死的轮询周期:CDP 往返偶尔会慢,
|
||||
// 写死一个常数会让长跑下来明显偏少或偏多。间隔过大说明中间断过,直接丢弃不补计。
|
||||
// 只有「上一帧在播、这一帧也在播」才计:宁可少算一秒,不能把
|
||||
// 暂停后挂机的时间 算成学习时长(挂机好几分钟才是常态)。
|
||||
const playing = !!(snap.video && !snap.video.paused);
|
||||
if (lastPlaying && playing && lastAt > 0) {
|
||||
const gap = (at - lastAt) / 1000;
|
||||
if (gap > 0 && gap <= MAX_GAP_SECONDS) studySeconds += gap;
|
||||
}
|
||||
lastPlaying = playing;
|
||||
lastAt = at;
|
||||
|
||||
// ---- 学分:边播边记「这门课值多少分」----
|
||||
const read = typeof snap.credit === 'number' && snap.credit > 0 ? snap.credit : null;
|
||||
if (read != null) {
|
||||
credit = read;
|
||||
if (course) creditOf.set(course, read);
|
||||
} else if (course && creditOf.has(course)) {
|
||||
credit = creditOf.get(course); // 倒计时消失(学完了)后沿用缓存值
|
||||
} else if (course && course !== lastCourse) {
|
||||
credit = null; // 换课了,新课的学分还没读出来
|
||||
}
|
||||
|
||||
// ---- 学分:只给真正刷完的课发分 ----
|
||||
const completed = Number(snap.completed) || 0;
|
||||
if (completed > lastCompleted) {
|
||||
// 完成数涨了:刚刷完的那门课此刻可能已经从快照里切走,所以用上一次记的课程名
|
||||
const justDone = lastCourse || course;
|
||||
if (justDone && creditOf.has(justDone) && !credited.has(justDone)) {
|
||||
credited.add(justDone);
|
||||
creditEarned += creditOf.get(justDone);
|
||||
}
|
||||
lastCompleted = completed;
|
||||
}
|
||||
if (course) lastCourse = course;
|
||||
|
||||
return get();
|
||||
}
|
||||
|
||||
/** 当前统计值(不会被外部改到内部状态) */
|
||||
function get() {
|
||||
// 学分保留两位小数:平台给的本来就是 0.23 / 6.52 这种,浮点累加会出现 3.7499999
|
||||
return { studySeconds, credit, creditEarned };
|
||||
}
|
||||
|
||||
/** 日志 / 收尾用的一句话(没有数据时返回空串,调用方直接跳过) */
|
||||
function summary() {
|
||||
if (studySeconds <= 0 && creditEarned <= 0) return '';
|
||||
return '视频累计播放 ' + fmt(studySeconds) + ',获得 ' + creditText() + ' 学分';
|
||||
}
|
||||
|
||||
/** 学分文本:整数不带小数点,小数保留最多两位并去掉尾随 0 */
|
||||
function creditText(value) {
|
||||
const v = value === undefined ? creditEarned : value;
|
||||
return String(Number(v.toFixed(2)));
|
||||
}
|
||||
|
||||
return { update, get, summary, creditText, reset() { studySeconds = 0; creditEarned = 0; credit = null; lastAt = 0; lastPlaying = false; lastCompleted = 0; lastCourse = ''; creditOf.clear(); credited.clear(); } };
|
||||
}
|
||||
|
||||
/** 秒 → 1:23:45 / 23:45(与面板显示保持一致,面板自己那份在 tui.mjs) */
|
||||
function fmt(sec) {
|
||||
const s = Math.max(0, Math.round(Number(sec) || 0));
|
||||
const h = Math.floor(s / 3600);
|
||||
const two = (n) => String(n).padStart(2, '0');
|
||||
const m = Math.floor((s % 3600) / 60);
|
||||
const r = s % 60;
|
||||
return h > 0 ? h + ':' + two(m) + ':' + two(r) : two(m) + ':' + two(r);
|
||||
}
|
||||
@@ -0,0 +1,120 @@
|
||||
// 进程层:日志开关、终端面板、启动横幅、崩溃重启循环、退出码。
|
||||
//
|
||||
// 一次会话(session.mjs)只管一个浏览器进程;这里管「崩了就重来」以及「什么情况该放弃」。
|
||||
// 重试等待递增:15s → 30s → 45s …,上限 120s,避免持续失败时疯狂刷 CDP 端口。
|
||||
import { sleep } from './cdp.mjs';
|
||||
import { cleanStaleSingleton } from './browser.mjs';
|
||||
import { runSession, disposeActiveSession } from './session.mjs';
|
||||
import { openLog } from './log.mjs';
|
||||
import { noDisplayReason, platformName } from './platform.mjs';
|
||||
import { createTui } from './tui.mjs';
|
||||
|
||||
const RETRY_BASE_MS = 15000;
|
||||
const RETRY_MAX_MS = 120000;
|
||||
|
||||
/**
|
||||
* @param {object} o
|
||||
* @param {object} o.cfg
|
||||
* @param {string} o.binary
|
||||
* @param {string} o.scriptSrc
|
||||
* @param {object} o.stop stop.mjs 的句柄
|
||||
* @param {object} [o.tui] 已创建的面板(不传就按 cfg.TUI 自己建)
|
||||
* @param {Function} [o.onQuitRequest] 面板按 q 时的回调(默认接到 stop 上)
|
||||
* @param {Function} o.log / o.warn / o.error
|
||||
*/
|
||||
export async function runSupervisor(o) {
|
||||
const { cfg, stop } = o;
|
||||
const log = o.log, warn = o.warn, error = o.error;
|
||||
|
||||
// 自检不写文件日志:避免每次 --check 都改仓库内容
|
||||
if (!cfg.CHECK_ONLY) openLog(cfg.LOG_FILE, cfg.LOG_MAX_BYTES);
|
||||
|
||||
// 面板要先于启动横幅建好:横幅和后续日志都会进面板的日志区
|
||||
const tui = o.tui || createTui({
|
||||
enabled: cfg.TUI,
|
||||
title: '云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : ''),
|
||||
logFile: cfg.CHECK_ONLY ? '' : cfg.LOG_FILE,
|
||||
color: cfg.COLOR,
|
||||
onQuit: (reason) => {
|
||||
if (o.onQuitRequest) o.onQuitRequest(reason);
|
||||
else if (typeof stop.request === 'function') stop.request(reason);
|
||||
},
|
||||
});
|
||||
tui.set({ maxCourses: cfg.MAX_COURSES });
|
||||
|
||||
log('=== 云学堂助手 · 无头运行器' + (cfg.CHECK_ONLY ? '(自检)' : '') + ' 启动 ===');
|
||||
log('Node ' + process.version + ' ' + platformName + '/' + process.arch);
|
||||
log('配置 ' + (cfg.CONFIG_FILE || '(未找到 config/runner.config.mjs,使用内置默认值)'));
|
||||
log('浏览器 ' + o.binary);
|
||||
log('profile ' + cfg.PROFILE_DIR + '(cookie / localStorage 持久化,删掉即重置登录态与进度缓存)');
|
||||
if (cfg.WANT_VISIBLE && !cfg.VISIBLE) {
|
||||
warn(noDisplayReason() + ',配置里的 headless: false 被忽略,强制无头运行。');
|
||||
}
|
||||
if (!cfg.CHECK_ONLY) {
|
||||
log('日志 ' + cfg.LOG_FILE + '(Ctrl+C 或面板里按 q 结束)');
|
||||
}
|
||||
if (!cfg.TUI && cfg.tuiDisabledReason) log('面板:' + cfg.tuiDisabledReason());
|
||||
tui.set({ phase: '启动中' });
|
||||
|
||||
let attempt = 0;
|
||||
let last = null;
|
||||
|
||||
/** 收尾时先把面板收掉,退出日志和退出码提示才会逐行打印出来 */
|
||||
const finishTui = (phase, tone) => {
|
||||
tui.set({ phase, tone });
|
||||
tui.finish();
|
||||
};
|
||||
|
||||
while (!stop.stopping) {
|
||||
attempt++;
|
||||
if (attempt > 1) log('--- 第 ' + attempt + ' 次尝试 ---');
|
||||
tui.set({ attempt, phase: attempt > 1 ? '重启浏览器' : '启动浏览器', tone: 'info' });
|
||||
try {
|
||||
last = await runSession({ ...o, cfg, tui });
|
||||
if (stop.stopping) break;
|
||||
if (cfg.CHECK_ONLY) break;
|
||||
// 正常结束:只有「脚本自己停了 / 无进展」且配了重启间隔才再来一轮
|
||||
const restartable = !last.limitReached && cfg.RESTART_MINUTES > 0;
|
||||
if (!restartable) break;
|
||||
log('按 YUN_XUE_TANG_RESTART_MINUTES=' + cfg.RESTART_MINUTES + ' 等待后重新开始…');
|
||||
tui.set({ phase: '等待 ' + cfg.RESTART_MINUTES + ' 分钟后重开', tone: 'ok' });
|
||||
const until = Date.now() + cfg.RESTART_MINUTES * 60000;
|
||||
while (!stop.stopping && Date.now() < until) await sleep(2000);
|
||||
if (stop.stopping) break;
|
||||
cleanStaleSingleton(cfg.PROFILE_DIR);
|
||||
} catch (e) {
|
||||
if (stop.stopping) break;
|
||||
// 会话抛错时内部的收尾代码已被跳过,这里补上:否则浏览器进程会残留、端口被占
|
||||
await disposeActiveSession();
|
||||
error('会话异常:' + (e && e.message ? e.message : e));
|
||||
tui.set({ phase: '会话异常,准备重试', tone: 'error' });
|
||||
// 连登 5 次失败基本都是密码错 / 要验证码,重试没意义,直接用专门的退出码结束
|
||||
if (e && e.message && /连续 \d+ 次登录失败/.test(e.message)) {
|
||||
finishTui('登录失败,检查账号密码 / 验证码', 'error');
|
||||
return { exitCode: 3, last };
|
||||
}
|
||||
const waitMs = Math.min(RETRY_BASE_MS * attempt, RETRY_MAX_MS);
|
||||
const secs = Math.round(waitMs / 1000);
|
||||
warn('浏览器/连接异常,' + secs + ' 秒后重试(第 ' + attempt + ' 次)');
|
||||
tui.set({ phase: '会话异常,' + secs + ' 秒后重试', tone: 'warn' });
|
||||
await sleep(waitMs);
|
||||
}
|
||||
}
|
||||
|
||||
const stalled = !!(last && /没有任何进展/.test(last.finishReason || ''));
|
||||
const exitCode = cfg.CHECK_ONLY ? (last && last.ok ? 0 : 1) : (stalled ? 1 : 0);
|
||||
// 0 = 正常收尾(达到上限 / 预算 / 无更多课程);1 = 无进展卡死;3 = 连续登录失败
|
||||
const phase = cfg.CHECK_ONLY
|
||||
? (exitCode === 0 ? '自检通过' : '自检失败')
|
||||
: stalled ? '退出:长时间无进展' : '正常收尾';
|
||||
finishTui(phase, exitCode === 0 ? 'ok' : (stalled ? 'warn' : 'error'));
|
||||
|
||||
log('=== 运行器退出 ===');
|
||||
if (last && last.finishReason) log('结束原因:' + last.finishReason);
|
||||
if (cfg.CHECK_ONLY && last) log('自检结果:' + (last.ok ? '通过' : '失败 —— ' + last.reason));
|
||||
// 学习统计只在本次运行内有效(不落盘),退出时在日志里留一行,方便事后回看
|
||||
const studyLine = typeof tui.studySummary === 'function' ? tui.studySummary() : '';
|
||||
if (!cfg.CHECK_ONLY && studyLine) log('本次学习:' + studyLine);
|
||||
|
||||
return { exitCode, last, tui };
|
||||
}
|
||||
+558
@@ -0,0 +1,558 @@
|
||||
// 终端面板(TUI):把无头运行器的状态画成一个会自己刷新的框,代替刷屏的逐行日志。
|
||||
//
|
||||
// 设计约束(都很重要,改之前先看一遍):
|
||||
// 1. 只读:面板不提供暂停 / 改配置之类的操作,唯一按键是 q(或 Ctrl+C)优雅退出。
|
||||
// 「改行为」仍然走配置文件 / 环境变量 / 命令行,面板不制造第二套控制入口。
|
||||
// 2. 不碰日志文件:面板只接管「终端」输出(log.mjs 的控制台 sink),
|
||||
// run-logs/*.log 仍然是纯文本逐行,grep / 采集都不受影响。
|
||||
// 3. 自动降级:stdout 不是交互式终端(重定向到文件、CI、计划任务)时完全不启用,
|
||||
// 行为与旧版逐行日志一模一样(见 config.mjs 的 TUI 判断)。
|
||||
//
|
||||
// 重绘方式:不整屏清空,而是「回到本帧首行重画」——面板上方的启动横幅等历史输出
|
||||
// 仍留在回滚区里。技巧是最后一帧不留结尾换行,光标停在帧尾;下次从帧尾向上移动
|
||||
// (行数-1) 行即回到首行,因此永远不会触发终端滚动、也不会闪烁。
|
||||
import { setConsoleSink } from './log.mjs';
|
||||
import { createStudyTracker } from './study.mjs';
|
||||
|
||||
const ESC = '\x1b[';
|
||||
const RESET = ESC + '0m';
|
||||
/** 保留多少行历史日志(终端再高也只显示其中一部分) */
|
||||
const BUFFER_MAX = 200;
|
||||
/** 标签列宽(「倒计时」这类三字标签也放得下) */
|
||||
const LABEL_W = 7;
|
||||
|
||||
// ---------------------------------------------------------------------------
|
||||
// 中文对齐:全角字符占 2 列,直接用 String.length 补空格会把边框顶歪
|
||||
// ---------------------------------------------------------------------------
|
||||
function charWidth(ch) {
|
||||
const cp = ch.codePointAt(0);
|
||||
if (cp === 0 || cp < 32 || (cp >= 0x7f && cp < 0xa0)) return 0;
|
||||
if (cp === 0x2329 || cp === 0x232a) return 2;
|
||||
if (cp >= 0x1100 && cp <= 0x115f) return 2;
|
||||
if (cp >= 0x2e80 && cp <= 0xa4cf && cp !== 0x303f) return 2;
|
||||
if (cp >= 0xac00 && cp <= 0xd7a3) return 2;
|
||||
if (cp >= 0xf900 && cp <= 0xfaff) return 2;
|
||||
if (cp >= 0xfe30 && cp <= 0xfe6f) return 2;
|
||||
if (cp >= 0xff00 && cp <= 0xff60) return 2;
|
||||
if (cp >= 0xffe0 && cp <= 0xffe6) return 2;
|
||||
if (cp >= 0x1f300 && cp <= 0x1f64f) return 2;
|
||||
if (cp >= 0x1f900 && cp <= 0x1f9ff) return 2;
|
||||
if (cp >= 0x20000 && cp <= 0x3fffd) return 2;
|
||||
return 1;
|
||||
}
|
||||
|
||||
/** 字符串在终端里占几列(ANSI 转义序列不计数) */
|
||||
export function textWidth(s) {
|
||||
let w = 0;
|
||||
for (const ch of stripAnsi(s)) w += charWidth(ch);
|
||||
return w;
|
||||
}
|
||||
|
||||
/** 去掉 ANSI 序列(算可见宽度用) */
|
||||
export function stripAnsi(s) {
|
||||
return String(s).replace(/\x1b\[[0-9;]*[A-Za-z]/g, '');
|
||||
}
|
||||
|
||||
const ANSI_RE = /\x1b\[[0-9;]*[A-Za-z]/g;
|
||||
|
||||
/**
|
||||
* 按可见列宽遍历:回调拿到 (token, width),ANSI 转义序列 width=0。
|
||||
* cut / padEnd 都靠它,否则带颜色的字符串会被当成超宽而错误截断。
|
||||
*/
|
||||
function walkWidth(s, fn) {
|
||||
s = String(s);
|
||||
let i = 0;
|
||||
ANSI_RE.lastIndex = 0;
|
||||
let m;
|
||||
while ((m = ANSI_RE.exec(s))) {
|
||||
for (const ch of s.slice(i, m.index)) fn(ch, charWidth(ch));
|
||||
fn(m[0], 0);
|
||||
i = m.index + m[0].length;
|
||||
}
|
||||
for (const ch of s.slice(i)) fn(ch, charWidth(ch));
|
||||
}
|
||||
|
||||
/** 右侧补空格到指定列宽(ANSI 序列不计数) */
|
||||
function padEnd(s, width) {
|
||||
const gap = width - textWidth(s);
|
||||
return gap > 0 ? String(s) + ' '.repeat(gap) : String(s);
|
||||
}
|
||||
|
||||
/** 截断到指定列宽,被截断时末尾用 … 占位(ANSI 序列不计数,截断后补 reset) */
|
||||
function cut(s, width) {
|
||||
s = String(s);
|
||||
if (width <= 0) return '';
|
||||
const plain = stripAnsi(s);
|
||||
if (textWidth(plain) <= width) return s;
|
||||
let out = '';
|
||||
let w = 0;
|
||||
let truncated = false;
|
||||
walkWidth(s, (tok, cw) => {
|
||||
if (truncated) return;
|
||||
if (cw === 0) { out += tok; return; } // ANSI 序列照常透传
|
||||
if (w + cw > width - 1) { truncated = true; return; }
|
||||
out += tok;
|
||||
w += cw;
|
||||
});
|
||||
return out + '…' + (s.includes('\x1b[') ? '\x1b[0m' : '');
|
||||
}
|
||||
|
||||
/** 秒数 → 01:12:45 / 12:45 */
|
||||
export function formatDuration(sec) {
|
||||
const s = Math.max(0, Math.round(Number(sec) || 0));
|
||||
const h = Math.floor(s / 3600);
|
||||
const two = (n) => String(n).padStart(2, '0');
|
||||
const m = Math.floor((s % 3600) / 60);
|
||||
const r = s % 60;
|
||||
return h > 0 ? h + ':' + two(m) + ':' + two(r) : two(m) + ':' + two(r);
|
||||
}
|
||||
|
||||
/** 进度条:█ / ░ 各占 1 列 */
|
||||
export function progressBar(ratio, width) {
|
||||
const r = Math.max(0, Math.min(1, Number(ratio) || 0));
|
||||
const filled = Math.round(r * width);
|
||||
return '█'.repeat(filled) + '░'.repeat(Math.max(0, width - filled));
|
||||
}
|
||||
|
||||
/**
|
||||
* 一组行在宽度 cols 下实际占的屏幕行数。
|
||||
* 终端在窗口变窄时会把超宽的行自己折成多行,所以「逻辑行数」≠「屏幕行数」;
|
||||
* 回退光标、决定清屏起点都得用这个函数,否则窗口一变就会留下半截面板。
|
||||
* 行宽为 0 时算一行(空白行不折)。
|
||||
*/
|
||||
export function visualRows(widths, cols) {
|
||||
const w = Math.max(1, Number(cols) || 80);
|
||||
let total = 0;
|
||||
for (const raw of widths || []) {
|
||||
const width = Number(raw) || 0;
|
||||
total += Math.max(1, Math.ceil(width / w));
|
||||
}
|
||||
return total;
|
||||
}
|
||||
|
||||
/** ANSI 颜色;关闭时全部退化为恒等函数(NO_COLOR / --no-color) */
|
||||
function makeColors(on) {
|
||||
const wrap = (code) => (s) => (on ? ESC + code + 'm' + s + RESET : String(s));
|
||||
return {
|
||||
bold: wrap('1'), dim: wrap('2'), gray: wrap('90'),
|
||||
red: wrap('31'), green: wrap('32'), yellow: wrap('33'),
|
||||
blue: wrap('34'), magenta: wrap('35'), cyan: wrap('36'),
|
||||
};
|
||||
}
|
||||
|
||||
/**
|
||||
* 创建面板实例。enabled 为 false 时所有方法都是空操作,
|
||||
* 所以上层(supervisor / session)可以无条件调用 tui.set() / tui.snap()。
|
||||
*
|
||||
* @param {object} opts
|
||||
* @param {boolean} opts.enabled 是否启用(由 config.mjs 按 TTY 判断)
|
||||
* @param {Function} [opts.onQuit] 用户按 q / Ctrl+C 时的回调(接到 stop.mjs 上)
|
||||
* @param {string} [opts.title] 标题
|
||||
* @param {string} [opts.logFile] 日志文件路径(面板里显示)
|
||||
* @param {boolean} [opts.color] 是否用 ANSI 颜色(默认看 NO_COLOR)
|
||||
* @param {object} [opts.out] 输出流(测试用,默认 process.stdout)
|
||||
* @param {object} [opts.stdin] 输入流(测试用,默认 process.stdin)
|
||||
*/
|
||||
export function createTui(opts = {}) {
|
||||
const enabled = !!opts.enabled;
|
||||
const out = opts.out || process.stdout;
|
||||
const stdin = opts.stdin || process.stdin;
|
||||
const onQuit = opts.onQuit || (() => {});
|
||||
const colorOn = enabled && opts.color !== false && !process.env.NO_COLOR;
|
||||
const C = makeColors(colorOn);
|
||||
|
||||
const state = {
|
||||
title: opts.title || '云学堂助手 · 无头运行器',
|
||||
phase: '启动中',
|
||||
tone: 'info', // info / ok / warn / error
|
||||
attempt: 1,
|
||||
course: '',
|
||||
lesson: '',
|
||||
summary: '',
|
||||
countdown: null,
|
||||
completed: 0,
|
||||
maxCourses: 0,
|
||||
doneCount: 0,
|
||||
retryCount: 0,
|
||||
retryWait: 0,
|
||||
lessons: 0,
|
||||
video: null,
|
||||
// 学习统计(只在本次运行内累计,退出清零,不落盘)
|
||||
studySeconds: 0, // 学习时长:只累加视频真正在播的时间
|
||||
creditEarned: 0, // 获得学分:只算本次运行里完成(刷完)的课程
|
||||
credit: null, // 当前课程可得多少学分(平台只在播放期间写在倒计时文案里)
|
||||
injected: 0,
|
||||
logFile: opts.logFile || '',
|
||||
startedAt: Date.now(),
|
||||
};
|
||||
|
||||
const buffer = [];
|
||||
// 学时 / 学分累计逻辑在 study.mjs(纯数据,可脱离终端与浏览器单测)
|
||||
const study = createStudyTracker(opts.studyOpts);
|
||||
let timer = null;
|
||||
let resizeTimer = null;
|
||||
let lastLines = 0;
|
||||
// 上一帧每行的「可见列宽」。终端变窄时它会把自己重排(把宽行折成多行),
|
||||
// 所以回退光标时不能只数逻辑行数,得按新宽度算出旧帧实际占了几行。
|
||||
let lastWidths = [];
|
||||
let finished = false;
|
||||
let rawAttached = false;
|
||||
|
||||
// ---------------- 布局 ----------------
|
||||
// 窗口大小每画一帧都重新读:拖动终端、tmux 分屏、浏览器式面板都会改 out.columns / out.rows,
|
||||
// 不做缓存,resize 之后第一帧就是对的。宽度跟终端走(只保留最小 36 列防止破版)。
|
||||
const columns = () => Math.max(36, Number(out.columns) || 80);
|
||||
const rowsOf = () => Math.max(8, Number(out.rows) || 24);
|
||||
|
||||
// 记住上一次实际用过的尺寸。Windows 的 Node 不会在最大化 / 拉伸控制台时发 resize 事件
|
||||
// (libuv 拿不到那边的控制台尺寸变更通知),所以不能只靠事件,必须每次画之前自己比一次。
|
||||
let lastCols = columns();
|
||||
let lastRows = rowsOf();
|
||||
/** 终端尺寸真的变了就记录并报告;缩小需要先清整块(否则旧帧的尾巴会露在框外) */
|
||||
function syncSize() {
|
||||
const cols = columns();
|
||||
const rows = rowsOf();
|
||||
if (cols === lastCols && rows === lastRows) return false;
|
||||
const shrank = cols < lastCols || rows < lastRows;
|
||||
lastCols = cols;
|
||||
lastRows = rows;
|
||||
return shrank;
|
||||
}
|
||||
|
||||
/**
|
||||
* 当前窗口下的行分配。
|
||||
* 矮窗口(<15 行)进紧凑模式:省掉「课时」「日志」两行,先保住视频进度和学时;
|
||||
* 更矮时连日志区和底部 q 提示也省掉——绝不让面板超出窗口,超出会把回滚区里的历史顶掉。
|
||||
*/
|
||||
function layout() {
|
||||
const rows = rowsOf();
|
||||
const compact = rows < 15;
|
||||
const hint = rows >= 10 ? 1 : 0;
|
||||
const infoRows = compact ? 5 : 7; // 状态 / 课程 / 学时 / 视频 / 进度(+ 课时 / 日志)
|
||||
// 1 标题行 + infoRows + 1 分隔行 + room 日志行 + 1 底边框 + hint
|
||||
const slack = rows - (infoRows + 3 + hint);
|
||||
const showLogs = slack >= 1;
|
||||
const room = showLogs ? Math.min(10, slack) : 0;
|
||||
return { rows, compact, hint, showLogs, room };
|
||||
}
|
||||
|
||||
function toneWrap(text) {
|
||||
if (state.tone === 'ok') return C.green(text);
|
||||
if (state.tone === 'warn') return C.yellow(text);
|
||||
if (state.tone === 'error') return C.red(text);
|
||||
return C.cyan(text);
|
||||
}
|
||||
|
||||
function videoValue(width) {
|
||||
const v = state.video;
|
||||
if (!v || !v.d) {
|
||||
if (state.countdown != null) return C.gray('等待视频(倒计时 ' + state.countdown + 's)');
|
||||
return C.gray('—');
|
||||
}
|
||||
const ratio = v.d > 0 ? v.t / v.d : 0;
|
||||
// 窄终端里进度条先缩,仍有地方就按实宽决定加不加时光与状态(不硬截断)
|
||||
const times = formatDuration(v.t) + '/' + formatDuration(v.d);
|
||||
const barW = Math.max(10, Math.min(40, width - 30));
|
||||
const parts = [progressBar(ratio, barW), String(Math.round(ratio * 100)).padStart(3) + '%'];
|
||||
const used = () => textWidth(parts.join(' '));
|
||||
if (used() + 2 + textWidth(times) <= width) parts.push(times);
|
||||
const tail = v.err >= 3 ? C.red('解码失败 error.code=' + v.err) : (v.paused ? C.yellow('暂停') : '');
|
||||
if (tail && used() + 2 + textWidth(tail) <= width) parts.push(tail);
|
||||
return parts.join(' ');
|
||||
}
|
||||
|
||||
function countValue(width) {
|
||||
// 字段按重要性递降:本次/累计是骨架,其余在窄终端里从右往左丢,不硬截断
|
||||
const parts = ['本次 ' + state.completed + (state.maxCourses > 0 ? '/' + state.maxCourses : ''),
|
||||
'累计 ' + state.doneCount];
|
||||
const extra = [];
|
||||
if (state.lessons) extra.push('课时数 ' + state.lessons);
|
||||
if (state.retryWait > 0) extra.push(C.yellow('等待重试 ' + state.retryWait + 's'));
|
||||
else if (state.retryCount > 0) extra.push(C.yellow('待重试 ' + state.retryCount));
|
||||
if (state.countdown != null) extra.push('倒计时 ' + state.countdown + 's');
|
||||
const used = () => textWidth(parts.join(' · '));
|
||||
for (const item of extra) {
|
||||
if (used() + 3 + textWidth(item) > width) break; // +3 = ' · '
|
||||
parts.push(item);
|
||||
}
|
||||
return parts.join(' · ');
|
||||
}
|
||||
|
||||
function statusValue(valueW) {
|
||||
const plain = state.phase + (state.attempt > 1 ? ' · 第 ' + state.attempt + ' 次尝试' : '');
|
||||
const colored = toneWrap(plain);
|
||||
const elapsed = '已运行 ' + formatDuration((Date.now() - state.startedAt) / 1000);
|
||||
const gap = valueW - textWidth(plain) - textWidth(elapsed);
|
||||
if (gap < 2) return cut(colored + (gap > 0 ? ' '.repeat(gap) : '') + ' ' + elapsed, valueW);
|
||||
return colored + ' '.repeat(gap) + C.gray(elapsed);
|
||||
}
|
||||
|
||||
/**
|
||||
* 「学时」行:本次已学时长 + 本次获得学分。
|
||||
* 时长按视频实际播放累计(排队 / 重试 / 加载不算);
|
||||
* 学分只算真正刷完的课程,且按课程去重。窄终端先丢「本门」再截断。
|
||||
*/
|
||||
function studyValue(width) {
|
||||
const parts = [C.cyan('已学 ' + formatDuration(state.studySeconds))];
|
||||
parts.push(C.green('学分 ' + study.creditText(state.creditEarned)));
|
||||
const used = () => textWidth(parts.join(' · '));
|
||||
if (state.credit != null) {
|
||||
const now = '本门 ' + study.creditText(state.credit);
|
||||
if (used() + 3 + textWidth(now) <= width) parts.push(now);
|
||||
}
|
||||
const tail = state.video && state.video.paused ? C.gray('暂停中,不计时') : '';
|
||||
if (tail && used() + 3 + textWidth(tail) <= width) parts.push(tail);
|
||||
return parts.join(' · ');
|
||||
}
|
||||
|
||||
/** 组装一帧的所有行(含 ANSI 色,宽度已按列算好) */
|
||||
function buildFrame() {
|
||||
const cols = columns();
|
||||
const inner = cols - 4; // "│ " + 内容 + " │"
|
||||
const valueW = inner - LABEL_W;
|
||||
|
||||
const row = (label, value) => {
|
||||
const text = padEnd(cut(value, valueW), valueW);
|
||||
return '│ ' + C.dim(padEnd(label, LABEL_W)) + text + ' │';
|
||||
};
|
||||
|
||||
const { compact, hint, showLogs, room } = layout();
|
||||
|
||||
const lines = [];
|
||||
const title = ' ' + cut(state.title, cols - 8) + ' ';
|
||||
lines.push('╭' + title + '─'.repeat(Math.max(0, cols - 2 - textWidth(title))) + '╮');
|
||||
lines.push(row('状态', statusValue(valueW)));
|
||||
lines.push(row('课程', state.course || (state.phase === '启动中' ? '—' : '列表页 / 未识别')));
|
||||
// 学时紧跟在课程后面:挂机时最关心「学了多久、赚了多少」
|
||||
lines.push(row('学时', studyValue(valueW)));
|
||||
// 紧凑模式先丢「课时」「日志」:视频进度和学时才是挂机时真想看的
|
||||
if (!compact) lines.push(row('课时', [state.lesson || '—', state.summary].filter(Boolean).join(' ')));
|
||||
lines.push(row('视频', videoValue(valueW)));
|
||||
lines.push(row('进度', countValue(valueW)));
|
||||
if (!compact) {
|
||||
lines.push(row('日志', [state.logFile || '(未写日志文件)', '已注入 ' + state.injected + ' 次'].join(' · ')));
|
||||
}
|
||||
|
||||
if (showLogs) {
|
||||
const sec = ' 最近日志 ';
|
||||
lines.push('├' + C.dim(sec) + '─'.repeat(Math.max(0, cols - 2 - textWidth(sec))) + '┤');
|
||||
|
||||
const recent = buffer.slice(-room);
|
||||
const blank = '│' + ' '.repeat(cols - 2) + '│';
|
||||
for (let i = recent.length; i < room; i++) lines.push(blank);
|
||||
for (const line of recent) {
|
||||
lines.push('│ ' + C.dim(padEnd(cut(line, inner), inner)) + ' │');
|
||||
}
|
||||
}
|
||||
|
||||
lines.push('╰' + '─'.repeat(Math.max(0, cols - 2)) + '╯');
|
||||
if (hint) lines.push(C.gray(cut(' q 退出(等价 Ctrl+C:暂停视频、停批量、关浏览器)· 完整日志照常写入日志文件', cols)));
|
||||
return lines;
|
||||
}
|
||||
|
||||
/**
|
||||
* 画一帧。尺寸变了就改跑 redraw():终端变窄 / 变矮时,上一帧更宽或更高的字符
|
||||
* 会露在新框外面,必须先整块清掉;变大时旧帧完全被盖住,直接重画就行。
|
||||
*/
|
||||
function render() {
|
||||
if (!enabled || finished) return;
|
||||
// Windows 控制台最大化 / 拖动时不会发 resize 事件,只能在这里发现变化
|
||||
if (syncSize()) redraw();
|
||||
else paint();
|
||||
}
|
||||
|
||||
function paint() {
|
||||
if (!enabled || finished) return;
|
||||
let lines;
|
||||
try {
|
||||
lines = buildFrame();
|
||||
} catch (e) {
|
||||
return; // 面板自身出错绝不能影响刷课
|
||||
}
|
||||
const cols = columns();
|
||||
const maxRows = rowsOf();
|
||||
if (lines.length > maxRows) lines = lines.slice(0, maxRows);
|
||||
|
||||
// 上一帧在当前宽度下实际占的可视行数(窗口没变时它就等于上帧的逻辑行数)
|
||||
const prevRows = visualRows(lastWidths, cols);
|
||||
let buf = '';
|
||||
// 上一帧光标停在帧尾;向上移动 (可视行数-1) 行即回到本帧首行
|
||||
if (prevRows > 0) {
|
||||
const up = Math.max(0, Math.min(prevRows - 1, maxRows - 1));
|
||||
buf += ESC + up + 'A\r';
|
||||
}
|
||||
for (let i = 0; i < lines.length; i++) {
|
||||
// 行尾清到行末(\x1b[K):终端变窄或日志变短时,上一帧的尾巴不会残留
|
||||
buf += lines[i] + ESC + 'K';
|
||||
if (i < lines.length - 1) buf += '\r\n';
|
||||
}
|
||||
buf += ESC + '0J'; // 本帧下方的内容一并清掉(终端变矮时防残留)
|
||||
try { out.write(buf); } catch (e) { /* ignore */ }
|
||||
lastLines = lines.length;
|
||||
lastWidths = lines.map((l) => textWidth(stripAnsi(l)));
|
||||
}
|
||||
|
||||
/**
|
||||
* 硬重绘:终端尺寸变了之后,上次记的帧行数已经不可信(终端可能还自己重排过),
|
||||
* 所以先把光标拉回块首、清掉整块,再按新尺寸画一帧。
|
||||
* 向上移动的步数取 min(上帧行数-1, 当前行数-1):窗口缩到比上帧还矮时不会被顶出屏幕。
|
||||
*/
|
||||
function redraw() {
|
||||
if (!enabled || finished) return;
|
||||
if (lastWidths.length > 0 || lastLines > 0) {
|
||||
const cols = columns();
|
||||
const maxRows = rowsOf();
|
||||
// 关键:用「旧帧在新宽度下会被折成几行」来回退,而不是旧的逻辑行数。
|
||||
// 最大化后再还原(170 列 → 80 列)时,旧帧每行都被折成两行,
|
||||
// 按逻辑行数退会落在旧面板中间,上半截就永远留在屏幕上了。
|
||||
const folded = visualRows(lastWidths, cols);
|
||||
if (folded - 1 > maxRows - 1) {
|
||||
// 旧帧折行后比整个窗口还高:它的起点已经滚到屏幕上方去了,
|
||||
// 光标最多只能退到第一行,退不到块首。这种情况只能整屏重置——
|
||||
// 先把光标匀回左上角再清掉全屏,然后在顶部重画。
|
||||
// (屏幕上方的历史会没,但那些日志本来就在 run-logs/*.log 里)
|
||||
try { out.write(ESC + 'H' + ESC + '2J'); } catch (e) { /* ignore */ }
|
||||
} else {
|
||||
const up = Math.max(0, folded - 1);
|
||||
try { out.write('\r' + (up > 0 ? ESC + up + 'A' : '') + ESC + '0J'); } catch (e) { /* ignore */ }
|
||||
}
|
||||
lastLines = 0; // 光标已经回到块首,paint 不必再回退
|
||||
lastWidths = [];
|
||||
}
|
||||
paint();
|
||||
}
|
||||
|
||||
// ---------------- 键盘:只认 q / Q / Ctrl+C ----------------
|
||||
function onKey(chunk) {
|
||||
for (const ch of String(chunk)) {
|
||||
if (ch === 'q' || ch === 'Q' || ch === '\u0003') {
|
||||
// 先收面板再走退出流程,退出日志才能正常打在面板下面
|
||||
const reason = ch === '\u0003' ? 'Ctrl+C' : 'q';
|
||||
finish();
|
||||
onQuit(reason);
|
||||
return;
|
||||
}
|
||||
if (ch === '\u000c') redraw(); // Ctrl+L 强制重画(终端被外部输出打乱时用)
|
||||
}
|
||||
}
|
||||
|
||||
function attachInput() {
|
||||
if (!enabled || rawAttached) return;
|
||||
if (!stdin || !stdin.isTTY || typeof stdin.setRawMode !== 'function') return;
|
||||
try {
|
||||
stdin.setRawMode(true);
|
||||
stdin.setEncoding('utf8');
|
||||
stdin.on('data', onKey);
|
||||
stdin.resume();
|
||||
rawAttached = true;
|
||||
} catch (e) {
|
||||
rawAttached = false;
|
||||
}
|
||||
}
|
||||
|
||||
function restoreInput() {
|
||||
if (!rawAttached) return;
|
||||
rawAttached = false;
|
||||
try {
|
||||
stdin.off('data', onKey);
|
||||
stdin.setRawMode(false);
|
||||
stdin.pause();
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
// ---------------- 生命周期 ----------------
|
||||
function finish() {
|
||||
if (!enabled || finished) return;
|
||||
finished = true;
|
||||
if (timer) { clearInterval(timer); timer = null; }
|
||||
if (resizeTimer) { clearTimeout(resizeTimer); resizeTimer = null; }
|
||||
if (typeof out.removeListener === 'function') {
|
||||
out.removeListener('resize', onResize);
|
||||
}
|
||||
restoreInput();
|
||||
setConsoleSink(null); // 终端输出恢复逐行,收尾日志才看得见
|
||||
// 摘掉 exit 监听:supervisor 重试用例里同一进程会建多次面板,不摘会触发 MaxListeners 警告
|
||||
try { process.removeListener('exit', finish); } catch (e) { /* ignore */ }
|
||||
try { out.write('\n' + ESC + '?25h'); } catch (e) { /* ignore */ } // 换行 + 显示光标
|
||||
}
|
||||
|
||||
/**
|
||||
* 窗口尺寸变化:拖拽终端时 resize 事件会连发几十次,去抖后再硬重绘。
|
||||
* 注意这条路径只在支持该事件的平台生效(Linux / macOS / Windows Terminal);
|
||||
* Windows 传统控制台(conhost)拖窗口 / 最大化不会发事件,那种情况靠
|
||||
* render() 里的 syncSize() 在 1 秒内发现。两者取其一即可,都碰到也只是多一次重绘。
|
||||
*/
|
||||
function onResize() {
|
||||
if (resizeTimer) clearTimeout(resizeTimer);
|
||||
resizeTimer = setTimeout(() => {
|
||||
resizeTimer = null;
|
||||
lastCols = columns(); // 事件已经告诉我们尺寸变了,直接记录,避免 syncSize 再判一次
|
||||
lastRows = rowsOf();
|
||||
redraw();
|
||||
}, 60);
|
||||
if (typeof resizeTimer.unref === 'function') resizeTimer.unref();
|
||||
}
|
||||
|
||||
function install() {
|
||||
if (!enabled || finished) return;
|
||||
attachInput();
|
||||
try { out.write(ESC + '?25l'); } catch (e) { /* ignore */ } // 隐藏光标
|
||||
// 终端输出改道到面板日志区;文件日志不受影响(log.mjs 里两路分开写)
|
||||
setConsoleSink((level, text) => {
|
||||
buffer.push(text);
|
||||
if (buffer.length > BUFFER_MAX) buffer.splice(0, buffer.length - BUFFER_MAX);
|
||||
// 警告 / 错误立即重绘,普通信息等下一次定时刷新,避免频繁重绘
|
||||
if (level !== '信息') render();
|
||||
});
|
||||
if (typeof out.on === 'function') out.on('resize', onResize);
|
||||
render();
|
||||
timer = setInterval(render, 1000);
|
||||
if (typeof timer.unref === 'function') timer.unref();
|
||||
if (typeof process.on === 'function') process.on('exit', finish);
|
||||
}
|
||||
|
||||
if (enabled) install();
|
||||
|
||||
return {
|
||||
enabled,
|
||||
/** 合并更新面板状态(enabled=false 时是空操作) */
|
||||
set(patch) {
|
||||
if (enabled && patch) Object.assign(state, patch);
|
||||
},
|
||||
/**
|
||||
* 用 session 的主监控快照刷新面板,顺便累计学习时长与学分(详细规则见 study.mjs)。
|
||||
*/
|
||||
snap(s) {
|
||||
if (!enabled || !s || s.noApi) return;
|
||||
const pick = (v, d) => (v === undefined ? d : v);
|
||||
const st = study.update(s);
|
||||
state.studySeconds = st.studySeconds;
|
||||
state.creditEarned = st.creditEarned;
|
||||
state.credit = st.credit;
|
||||
|
||||
state.course = pick(s.course, '');
|
||||
state.lesson = pick(s.lesson, '');
|
||||
state.summary = (s.summary && s.summary.text) || '';
|
||||
state.countdown = s.countdown == null ? null : s.countdown;
|
||||
state.completed = Number(s.completed) || 0;
|
||||
state.doneCount = pick(s.doneCount, 0);
|
||||
state.retryCount = pick(s.retryCount, 0);
|
||||
state.retryWait = pick(s.retryWait, 0);
|
||||
state.lessons = pick(s.lessons, 0);
|
||||
state.video = s.video || null;
|
||||
},
|
||||
render,
|
||||
redraw,
|
||||
finish,
|
||||
/** 学习统计(收尾日志用,与面板显示同一份数据) */
|
||||
get study() { return study.get(); },
|
||||
/** 学习统计的一句话摘要(没有数据时是空串) */
|
||||
studySummary() { return study.summary(); },
|
||||
/** 当前布局分配(自测里断言矮终端降级用) */
|
||||
get layout() { return layout(); },
|
||||
/** 当前状态快照(自检 / 测试用) */
|
||||
get state() { return { ...state }; },
|
||||
/** 已缓存的终端日志行(测试用) */
|
||||
get logLines() { return buffer.slice(); },
|
||||
};
|
||||
}
|
||||
@@ -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);
|
||||
});
|
||||
@@ -0,0 +1,143 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* 静态检查:对仓库里会直接 `node` 执行的脚本跑 `node --check`,
|
||||
* 并对批处理文件做两项硬性检查(这两项一旦坏掉就极难排查):
|
||||
* 1. 必须是纯 ASCII —— cmd.exe 按当前代码页逐字节读批处理,
|
||||
* 多字节字符(中文)会让行偏移错位,报出 "'鍏?npm' is not recognized" 这种怪错;
|
||||
* 2. 必须用 CRLF 行尾 —— 只有 LF 时 cmd.exe 会把上一行的尾部当成命令的一部分,
|
||||
* 同样报出莫名其妙的 "'01' is not recognized"。
|
||||
*
|
||||
* 以前 package.json 的 check 脚本是一长串 `node --check a && node --check b && …`,
|
||||
* 每次新增模块都要手改那行命令(漏了就默默不检查)。现在改为自动遍历目录。
|
||||
*
|
||||
* 用法:npm run check
|
||||
*/
|
||||
import fs from 'node:fs';
|
||||
import path from 'node:path';
|
||||
import { spawnSync } from 'node:child_process';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
|
||||
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
|
||||
/** 要遍历的目录(JS 与 bat 一起收;scripts/ 也在里面,含本文件自己) */
|
||||
const DIRS = ['runner', 'dev', 'scripts', 'config', 'docker'];
|
||||
/** 顶层要单独检查的文件(构建产物不入源码校验,它在 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 = []) {
|
||||
for (const ent of fs.readdirSync(dir, { withFileTypes: true })) {
|
||||
const p = path.join(dir, ent.name);
|
||||
if (ent.isDirectory()) {
|
||||
if (!SKIP_DIRS.has(ent.name)) walk(p, out);
|
||||
} else if (/\.m?js$|\.cmd$|\.bat$|\.sh$/i.test(ent.name)) {
|
||||
out.push(p);
|
||||
}
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
const jsTargets = [];
|
||||
const cmdTargets = [];
|
||||
const shTargets = [];
|
||||
for (const d of DIRS) {
|
||||
const dir = path.join(ROOT, d);
|
||||
if (fs.existsSync(dir)) {
|
||||
for (const f of walk(dir)) {
|
||||
if (/\.m?js$/.test(f)) jsTargets.push(f);
|
||||
else if (/\.sh$/i.test(f)) shTargets.push(f);
|
||||
else cmdTargets.push(f);
|
||||
}
|
||||
}
|
||||
}
|
||||
for (const f of FILES) {
|
||||
const p = path.join(ROOT, f);
|
||||
if (fs.existsSync(p)) jsTargets.push(p);
|
||||
}
|
||||
|
||||
let failed = 0;
|
||||
|
||||
// ---- 1. JS 语法 ----
|
||||
for (const file of jsTargets.sort()) {
|
||||
const r = spawnSync(process.execPath, ['--check', file], { encoding: 'utf8' });
|
||||
if (r.status !== 0) {
|
||||
failed++;
|
||||
console.error(' FAIL ' + path.relative(ROOT, file));
|
||||
console.error((r.stderr || '').trim());
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 2. 批处理文件:纯 ASCII + CRLF ----
|
||||
for (const file of cmdTargets.sort()) {
|
||||
const rel = path.relative(ROOT, file);
|
||||
const buf = fs.readFileSync(file);
|
||||
const bad = [];
|
||||
|
||||
const nonAscii = [];
|
||||
for (let i = 0; i < buf.length; i++) {
|
||||
if (buf[i] > 0x7f) nonAscii.push(i);
|
||||
}
|
||||
if (nonAscii.length) {
|
||||
const first = nonAscii[0];
|
||||
const ctx = buf.slice(Math.max(0, first - 20), first + 20).toString('utf8');
|
||||
bad.push('含 ' + nonAscii.length + ' 个非 ASCII 字节(首次出现在偏移 ' + first + ',上下文 “' + ctx + '”);'
|
||||
+ 'cmd.exe 按代码页逐字节读取,中文会让行偏移错位');
|
||||
}
|
||||
|
||||
let lf = 0;
|
||||
let crlf = 0;
|
||||
let loneCr = 0;
|
||||
for (let i = 0; i < buf.length; i++) {
|
||||
if (buf[i] === 0x0a) {
|
||||
lf++;
|
||||
if (i > 0 && buf[i - 1] === 0x0d) crlf++;
|
||||
} else if (buf[i] === 0x0d && buf[i + 1] !== 0x0a) {
|
||||
loneCr++;
|
||||
}
|
||||
}
|
||||
// 裸 CR(不是 CRLF 的一部分)会把下一个字符吃掉:'config\runner' 里的反斜杠
|
||||
// 曾经变成 CR,报“configunner.config.mjs not found”
|
||||
if (loneCr) {
|
||||
bad.push('有 ' + loneCr + ' 处裸 CR(不是 CRLF 的 CR);'
|
||||
+ '它会吞掉后面的字符,例如 config\\runner 变成 config<CR>unner');
|
||||
}
|
||||
if (lf !== crlf) {
|
||||
bad.push('有 ' + (lf - crlf) + ' 处裸 LF 行尾(共 ' + lf + ' 个 LF / ' + crlf + ' 个 CRLF);'
|
||||
+ 'cmd.exe 会把上一行尾部当成命令的一部分');
|
||||
}
|
||||
|
||||
if (bad.length) {
|
||||
failed++;
|
||||
console.error(' FAIL ' + rel);
|
||||
for (const b of bad) console.error(' - ' + b);
|
||||
}
|
||||
}
|
||||
|
||||
// ---- 3. 容器入口脚本:sh -n 语法 + 必须是 LF 行尾 ----
|
||||
// 容器的 entrypoint 若带 CRLF,shebang 会变成 "/bin/sh\r",直接报 exec format error。
|
||||
// Windows 上不一定有 sh(纯 CMD / PowerShell 环境),找不到就跳过语法检查,但行尾照样校验。
|
||||
const hasSh = spawnSync('sh', ['-c', 'exit 0'], { stdio: 'ignore' }).status === 0;
|
||||
for (const file of shTargets.sort()) {
|
||||
const rel = path.relative(ROOT, file);
|
||||
const buf = fs.readFileSync(file);
|
||||
const bad = [];
|
||||
const crlf = buf.indexOf('\r\n') >= 0;
|
||||
if (crlf) bad.push('含 CRLF 行尾;容器里的 sh 会把 shebang 读成 "/bin/sh\\r" 而报 exec format error');
|
||||
if (hasSh) {
|
||||
const r = spawnSync('sh', ['-n', file], { encoding: 'utf8' });
|
||||
if (r.status !== 0) bad.push((r.stderr || '').trim());
|
||||
}
|
||||
if (bad.length) {
|
||||
failed++;
|
||||
console.error(' FAIL ' + rel);
|
||||
for (const b of bad) console.error(' - ' + b);
|
||||
}
|
||||
}
|
||||
|
||||
const total = jsTargets.length + cmdTargets.length + shTargets.length;
|
||||
if (failed) {
|
||||
console.error('\n静态检查:' + failed + '/' + total + ' 个文件失败');
|
||||
process.exit(1);
|
||||
}
|
||||
console.log('静态检查:' + total + '/' + total + ' 个文件通过'
|
||||
+ '(JS ' + jsTargets.length + ' · 批处理 ' + cmdTargets.length
|
||||
+ ' · 容器入口 ' + shTargets.length + (hasSh ? '' : '(当前环境无 sh,仅校验行尾)') + ')');
|
||||
@@ -0,0 +1,15 @@
|
||||
@echo off
|
||||
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
|
||||
cd /d "%~dp0.."
|
||||
title YXT Cruise - dev server
|
||||
where node >nul 2>nul
|
||||
if errorlevel 1 (
|
||||
echo [error] node.exe not found. Install Node.js from https://nodejs.org/
|
||||
pause
|
||||
exit /b 1
|
||||
)
|
||||
node "%~dp0..\dev\serve.mjs" %*
|
||||
if errorlevel 1 pause
|
||||
@@ -0,0 +1,60 @@
|
||||
@echo off
|
||||
rem ---------------------------------------------------------------
|
||||
rem This file must stay PURE ASCII.
|
||||
rem cmd.exe reads batch files byte-by-byte with the current code page;
|
||||
rem multi-byte characters (e.g. Chinese) corrupt line offsets and make
|
||||
rem it report nonsense like "'npm' is not recognized".
|
||||
rem All Chinese messages come from the Node runner output instead.
|
||||
rem
|
||||
rem Usage:
|
||||
rem scripts\start-headless.cmd use config\runner.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.."
|
||||
title YunXueTang Assistant - headless runner
|
||||
|
||||
where node >nul 2>nul
|
||||
if errorlevel 1 goto no_node
|
||||
|
||||
if exist "yun-xue-tang-assistant.user.js" goto have_build
|
||||
echo [build] build output not found, running npm run build ...
|
||||
call npm run build
|
||||
if errorlevel 1 goto build_fail
|
||||
|
||||
:have_build
|
||||
if not exist "config\runner.config.mjs" goto no_config
|
||||
echo [config] config\runner.config.mjs found, editing it is enough (no rebuild needed)
|
||||
goto run
|
||||
|
||||
:no_config
|
||||
echo [warn] config\runner.config.mjs not found, built-in defaults will be used
|
||||
|
||||
:run
|
||||
echo [run] headless runner starting, press Ctrl+C to stop
|
||||
echo.
|
||||
node "runner/headless.mjs" %*
|
||||
set RC=%ERRORLEVEL%
|
||||
|
||||
if "%RC%"=="0" goto done
|
||||
echo.
|
||||
echo [exit] code %RC%
|
||||
echo 0 finished 1 no progress 2 env/args error 3 login failed
|
||||
echo full log: run-logs\headless.log
|
||||
pause
|
||||
exit /b %RC%
|
||||
|
||||
:done
|
||||
exit /b 0
|
||||
|
||||
:no_node
|
||||
echo [error] node.exe not found. Install Node.js 22+ from https://nodejs.org/
|
||||
pause
|
||||
exit /b 1
|
||||
|
||||
:build_fail
|
||||
echo [error] build failed. Run npm install first.
|
||||
pause
|
||||
exit /b 1
|
||||
+131
@@ -0,0 +1,131 @@
|
||||
// ======== 完成 / 未完成 ========
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, saveRunState, invalidateShortCatalog, PHASE_IDLE } from './state.js';
|
||||
import { goToList } from './route.js';
|
||||
import { later } from './lifecycle.js';
|
||||
import { truncate, isGenericCourseTitle, norm } from './utils.js';
|
||||
import { setStatus, updatePanel } from './panel.js';
|
||||
import { courseTitle, pauseAllMedia } from './player.js';
|
||||
|
||||
// 取本次要记录的课程名:优先用队列里启动时抓到的真课程名,
|
||||
// 不要在切页瞬间用页面标题(会变成「在线课堂」这类占位文案,
|
||||
// 导致 completedTitles 记错名、下轮又重复进同一门课)。
|
||||
function recordTitle() {
|
||||
const queued = S.activeCourse ? S.activeCourse.title : '';
|
||||
if (queued && !isGenericCourseTitle(queued)) return queued;
|
||||
const page = courseTitle();
|
||||
if (page && !isGenericCourseTitle(page)) return page;
|
||||
return queued || page;
|
||||
}
|
||||
|
||||
// 这门课本轮已试过几次(按标题归一化后的键,同名课程共用一条记录)
|
||||
export function retryCount(title) {
|
||||
const t = norm(title);
|
||||
if (!t) return 0;
|
||||
const rec = (S.courseRetries || {})[t];
|
||||
return rec && rec.n ? rec.n : 0;
|
||||
}
|
||||
|
||||
export function completeCurrent() {
|
||||
const title = recordTitle();
|
||||
if (title) {
|
||||
S.completedTitles[title] = Date.now();
|
||||
delete S.courseRetries[norm(title)];
|
||||
}
|
||||
S.completedThisRun = (S.completedThisRun || 0) + 1;
|
||||
S.activeCourse = null;
|
||||
S.coursePhase = PHASE_IDLE;
|
||||
S.awaitingListReturn = true;
|
||||
saveRunState();
|
||||
R.doneLatchKey = '';
|
||||
R.lastSummary = null;
|
||||
R.retryWaitUntil = 0;
|
||||
R.retryTitle = '';
|
||||
// 完成一门就丢掉时长队列:下一轮重新调列表接口拿平台实时状态
|
||||
invalidateShortCatalog();
|
||||
// 平台在完成后会把播放器重置到 0 秒,先暂停,避免又从头播一遍
|
||||
pauseAllMedia();
|
||||
|
||||
console.log(TAG, '课程完成:', title, '第', S.completedThisRun, '门,返回列表选下一门');
|
||||
|
||||
const limit = CFG.maxCourses > 0 ? CFG.maxCourses : Infinity;
|
||||
if (S.completedThisRun >= limit) {
|
||||
S.batchRunning = false;
|
||||
S.batchFinished = true;
|
||||
saveRunState();
|
||||
setStatus('本次已完成 ' + S.completedThisRun + ' 门,已停止。可重新勾选开始新一轮。');
|
||||
} else {
|
||||
setStatus('课程完成:' + truncate(title, 26) + '(本次 ' + S.completedThisRun + ')');
|
||||
}
|
||||
// 完成后的返回列表不能被 5 秒节流吞掉
|
||||
later(function () { goToList(true); }, 1200);
|
||||
}
|
||||
|
||||
// 课程没学完(不是「跳过」,是「重试」):
|
||||
// 同一门课最多重试 CFG.maxCourseRetries 次,退避等待后重新进这门课;
|
||||
// 超过次数才停止整轮刷课并明确提示——不会把这门课悄悄拉黑、换下一门。
|
||||
export function failCurrent(reason) {
|
||||
const title = recordTitle();
|
||||
const key = norm(title);
|
||||
const rec = key ? (S.courseRetries[key] || { n: 0 }) : { n: 0 };
|
||||
rec.n = (rec.n || 0) + 1;
|
||||
rec.reason = reason;
|
||||
rec.at = Date.now();
|
||||
if (key) S.courseRetries[key] = rec;
|
||||
|
||||
S.activeCourse = null;
|
||||
S.coursePhase = PHASE_IDLE;
|
||||
S.awaitingListReturn = false;
|
||||
|
||||
if (rec.n > CFG.maxCourseRetries) {
|
||||
// 重试用尽:停下整轮刷课,把原因留在面板上,等人工处理
|
||||
S.batchRunning = false;
|
||||
S.batchFinished = true;
|
||||
R.retryWaitUntil = 0;
|
||||
R.retryTitle = '';
|
||||
saveRunState();
|
||||
setStatus('「' + truncate(title || '当前课程', 22) + '」重试 ' + CFG.maxCourseRetries +
|
||||
' 次仍未完成,已停止刷课:' + reason);
|
||||
console.warn(TAG, '重试用尽,停止刷课:', title, reason);
|
||||
pauseAllMedia();
|
||||
updatePanel();
|
||||
return;
|
||||
}
|
||||
|
||||
// 退避:30 秒起,每次翻倍,最长 5 分钟;整轮连续重试次数越多等得越久,
|
||||
// 避免「进课就失败 → 立刻重进」把页面刷爆。
|
||||
const backoff = Math.min(300000, CFG.courseRetryDelayMs * Math.pow(2, Math.min(rec.n - 1, 4)));
|
||||
R.retryWaitUntil = Date.now() + backoff;
|
||||
R.retryTitle = title;
|
||||
R.retryStatusSec = -1;
|
||||
// 重试前重新拉一次列表接口:同一门课可能已被手动学完/状态已变化
|
||||
invalidateShortCatalog();
|
||||
S.awaitingListReturn = true;
|
||||
saveRunState();
|
||||
console.warn(TAG, '课程未完成,' + Math.round(backoff / 1000) + ' 秒后重试(第 ' +
|
||||
rec.n + '/' + CFG.maxCourseRetries + ' 次):', title, reason);
|
||||
setStatus('未学完:' + truncate(title, 20) + '(' + reason + '),' +
|
||||
Math.round(backoff / 1000) + ' 秒后重试第 ' + rec.n + '/' + CFG.maxCourseRetries + ' 次');
|
||||
updatePanel();
|
||||
// 回列表等退避结束(listTick 会在等待期内不进课,到点后重新挑最短的未完成课)
|
||||
later(function () { goToList(true); }, 1200);
|
||||
}
|
||||
|
||||
// 重试退避是否还在等待期内
|
||||
export function retryWaiting() {
|
||||
return !!(R.retryWaitUntil && Date.now() < R.retryWaitUntil);
|
||||
}
|
||||
|
||||
// 重试等待剩余秒数(面板/日志用)
|
||||
export function retryWaitSeconds() {
|
||||
if (!R.retryWaitUntil) return 0;
|
||||
return Math.max(0, Math.ceil((R.retryWaitUntil - Date.now()) / 1000));
|
||||
}
|
||||
|
||||
export function stopBatch(reason) {
|
||||
S.batchRunning = false;
|
||||
S.batchFinished = true;
|
||||
saveRunState();
|
||||
setStatus(reason || '列表刷课结束');
|
||||
updatePanel();
|
||||
}
|
||||
@@ -0,0 +1,38 @@
|
||||
// ======== 配置 ========
|
||||
export const CFG = {
|
||||
mute: true, // 静音(自动播放更稳)
|
||||
autoNext: true, // 当前课程自动连播:本节结束后自动下一节
|
||||
tickMs: 2000, // 主循环间隔
|
||||
startClickCooldownMs: 3000, // 「开始学习」重复点击冷却(3 秒内没起播就补点)
|
||||
entryGraceMs: 30000, // 进课后标题/课程 id 尚未就绪的宽限,避免慢加载被误判为「课程不一致」
|
||||
stuckMs: 5 * 60 * 1000, // 连续多久没有计时进展就放弃当前课程
|
||||
maxCourses: 10, // 本次最多完成多少门;0 = 不限
|
||||
maxCourseRetries: 5, // 同一门课最多重试多少次(不跳过课程,超次数就停下整轮刷课)
|
||||
courseRetryDelayMs: 30000, // 首次重试前的等待;之后每次翻倍,最长 5 分钟
|
||||
alignToFirstIncomplete: true, // 进入课程先从「第一个未学完的课时」学起;false = 沿用平台上次位置
|
||||
preferShortCourses: true, // 列表刷课时优先总时长更短的课程(正序)
|
||||
maxExamTries: 2, // 同一门课「空卷交卷」的最大次数(平台没记账时避免死循环)
|
||||
examClickCooldownMs: 1500, // 考试页内两次点击的间隔
|
||||
staleCourseMs: 10 * 60 * 1000, // 恢复「当前课程」时允许的最大年龄,更旧的一律丢弃
|
||||
};
|
||||
|
||||
// 版本号:由 build.mjs 从 package.json 注入,不要手改
|
||||
export const VERSION = __YUN_XUE_TANG_VERSION__;
|
||||
|
||||
// ---- localStorage:用户偏好(跨会话成立) ----
|
||||
export const LS_ENABLED = 'yun-xue-tang-auto-play-enabled';
|
||||
export const LS_PREFER_SHORT = 'yun-xue-tang-prefer-short';
|
||||
export const LS_TARGET_CATALOG_URL = 'yun-xue-tang-target-catalog-url';
|
||||
export const LS_LOGIN = 'yun-xue-tang-login-v1';
|
||||
export const LS_PENDING = 'yun-xue-tang-auto-start-after-login';
|
||||
|
||||
// ---- sessionStorage:本次进度 + 本次运行状态(换标签页/重启即作废) ----
|
||||
export const SS_RUN_STATE = 'yun-xue-tang-run-state-v3';
|
||||
export const SS_SHORT_CATALOG = 'yun-xue-tang-short-catalog-v1';
|
||||
export const SHORT_CATALOG_TTL = 5 * 60 * 1000;
|
||||
|
||||
// 旧版本把「进度 + 运行意图」整块塞进 localStorage,只用于一次性迁移(迁移后即删除)
|
||||
export const LEGACY_LS_BATCH = 'yun-xue-tang-batch-v2';
|
||||
|
||||
export const PANEL_ID = 'yun-xue-tang-panel';
|
||||
export const TAG = '[云学堂助手]';
|
||||
+434
@@ -0,0 +1,434 @@
|
||||
// ======== 课程页 ========
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, saveRunState, PHASE_LEARNING } from './state.js';
|
||||
import { goToList, mediaPage } from './route.js';
|
||||
import { courseIdFromUrl, norm, textOf, truncate, findVisibleClickable } from './utils.js';
|
||||
import { later } from './lifecycle.js';
|
||||
import { setStatus, statusEl } from './panel.js';
|
||||
import {
|
||||
alignToFirstIncomplete, courseHasQuizLesson, detectQuiz, handleAntiIdle, courseTitle,
|
||||
hookAllVideos, findPlayableVideo, ensurePlaying, readSummary, readCountdown,
|
||||
readActiveLessonKey, findNextLessonElement, findNextButton, clickNode,
|
||||
fireClickSequence, lessonClickNodes, syncManualCourse, pauseAllMedia,
|
||||
findPendingExamLesson, lessonItems, isLessonCompleted, lessonActiveLi, clickLesson,
|
||||
} from './player.js';
|
||||
import { examTick, examPhase } from './exam.js';
|
||||
import { completeCurrent, failCurrent } from './complete.js';
|
||||
|
||||
export function courseTick() {
|
||||
R.listWithCurrentSince = 0;
|
||||
if (!S.activeCourse) {
|
||||
goToList();
|
||||
return;
|
||||
}
|
||||
|
||||
// 播放器可能是点「开始学习」后才创建的;每轮顺带接管一次,
|
||||
// 新视频一出现就静音并挂上 play/ended/timeupdate 监听。
|
||||
hookAllVideos();
|
||||
|
||||
const isMedia = mediaPage();
|
||||
const urlId = courseIdFromUrl();
|
||||
const curId = S.activeCourse.id || '';
|
||||
const title = courseTitle();
|
||||
const nt = norm(title);
|
||||
const nc = norm(S.activeCourse.title);
|
||||
const genericTitle = !nt || /^(loading|加载中|在线课堂|江丰云课堂|云课堂|课程详情|课程)$/.test(nt);
|
||||
const titleSame = genericTitle || !nc || nt === nc ||
|
||||
nt.indexOf(nc) >= 0 || nc.indexOf(nt) >= 0;
|
||||
// 有了 URL 里的 kngId 就以 id 为准:标题在 SPA 切页时经常短暂是 loading/
|
||||
// 在线课堂,旧逻辑会把它当成「课程不一致」在 12 秒后把课退回列表。
|
||||
const idKnown = !!(urlId && curId);
|
||||
const sameCourse = idKnown ? urlId === curId : titleSame;
|
||||
const graceOver = Date.now() - (S.activeCourse.startedAt || 0) > CFG.entryGraceMs;
|
||||
if (!sameCourse) {
|
||||
if (graceOver) {
|
||||
console.warn(TAG, '页面课程与队列不一致:队列', nc, curId,
|
||||
'页面', nt, urlId, location.href);
|
||||
failCurrent('页面课程与队列不一致');
|
||||
return;
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (S.coursePhase !== PHASE_LEARNING) {
|
||||
S.coursePhase = PHASE_LEARNING;
|
||||
saveRunState();
|
||||
}
|
||||
|
||||
// #/scan 只是进课过渡页:此时页面组件里可能还残留上一门课的汇总,
|
||||
// 等路由切到真正的播放页再判断,避免把旧课程的「已完成学习」当成新课程完成。
|
||||
if ((location.hash || '').indexOf('#/scan') === 0) return;
|
||||
|
||||
// 1) 防挂机验证(每 10 分钟弹一次,120 秒内不点「继续学习」就停止计时)
|
||||
if (handleAntiIdle()) return;
|
||||
|
||||
// 2) 考试页(说明页 / 答卷页 / 结果页):自动进考试并空卷交卷
|
||||
if (examTick(false)) return;
|
||||
|
||||
// 3) 答题/测验/问卷仍需人工处理
|
||||
if (detectQuiz()) {
|
||||
failCurrent('检测到答题/测验,需要手动处理');
|
||||
return;
|
||||
}
|
||||
|
||||
// 4) 课程是否包含答题/测验类章节(只需检查一次)
|
||||
if (!R.quizChecked && document.querySelector('.yxtulcdsdk-catalog ul > li .tag-type')) {
|
||||
R.quizChecked = true;
|
||||
if (courseHasQuizLesson()) {
|
||||
failCurrent('课程包含答题/测验章节');
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
// 5) 有未完成的考试课时且当前不在考试页:先点进考试节(进去后下一轮 examTick 接管)
|
||||
// 汇总已满时不再进考试:个别课程考试节未做但平台已算完成,
|
||||
// 再进考试只会白白多交一次卷。
|
||||
if (!examPhase() && !isSummaryComplete() && enterPendingExamLesson()) return;
|
||||
|
||||
// 6) 整门课程是否已完成 / 平台是否刚记录了一节
|
||||
const summary = readSummary();
|
||||
const prevSummaryX = R.lastSummary ? R.lastSummary.x : -1;
|
||||
if (summary) {
|
||||
// 三种完成文案统一走这里:x/y 满、百分比 100%、「已完成学习」。
|
||||
// 页面切换瞬间可能读到上一门课的残留文案,连续两次读到才确认。
|
||||
if (summary.complete) {
|
||||
const confirmed = !!(R.lastSummary && R.lastSummary.complete);
|
||||
R.lastSummary = summary;
|
||||
if (confirmed) {
|
||||
completeCurrent();
|
||||
return;
|
||||
}
|
||||
setStatus('课程已完成,确认中…');
|
||||
return;
|
||||
}
|
||||
|
||||
if (R.lastSummary && summary.x > R.lastSummary.x) {
|
||||
R.lastProgressAt = Date.now();
|
||||
const prevKey = R.lastLessonKey;
|
||||
const curKey = readActiveLessonKey();
|
||||
R.lastSummary = summary;
|
||||
|
||||
// 单视频/音频页的百分比是播放进度,不是「一节学完」,不能据此切节
|
||||
if (!isMedia && summary.kind !== 'percent' && (!prevKey || curKey === prevKey)) {
|
||||
// 平台已记账但没有自动切节 → 脚本主动切下一节
|
||||
setStatus('本节已记录,切换下一节…');
|
||||
advanceLesson();
|
||||
return;
|
||||
}
|
||||
setStatus(summary.kind === 'percent'
|
||||
? '学习进度:' + summary.x + '%'
|
||||
: '进度更新:' + summary.x + '/' + summary.y);
|
||||
return;
|
||||
}
|
||||
|
||||
R.lastSummary = summary;
|
||||
}
|
||||
|
||||
// 5) 对齐起点:进入课程后统一从「第一个未学完的课时」开始(即第一章第一节起顺序学),
|
||||
// 不沿用平台上次停留的位置。否则前面的课时会被跳过,整门课永远学不完。
|
||||
// 单视频/音频页没有目录,不走这一步。
|
||||
if (!isMedia && alignToFirstIncomplete()) return;
|
||||
|
||||
// 6) 计时与当前章节
|
||||
const cd = readCountdown();
|
||||
if (cd != null) {
|
||||
if (R.lastCountdown == null || cd < R.lastCountdown) {
|
||||
R.lastProgressAt = Date.now();
|
||||
}
|
||||
R.lastCountdown = cd;
|
||||
}
|
||||
|
||||
const lessonKey = readActiveLessonKey();
|
||||
if (lessonKey && lessonKey !== R.lastLessonKey) {
|
||||
R.lastLessonKey = lessonKey;
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
R.waitSummaryX = -1;
|
||||
R.waitLessonKey = '';
|
||||
R.lastProgressAt = Date.now();
|
||||
setStatus('学习中:' + truncate(lessonKey, 28) + (R.alignFailed ? '(起点未对齐)' : ''));
|
||||
}
|
||||
|
||||
// 7) 本节是否已在本地结束(必须先判断,避免把已结束的视频重新拉回开头)
|
||||
const v = findPlayableVideo();
|
||||
// 视频 ended 是本节结束的主信号;倒计时文案在切节后可能变成下一节的时长。
|
||||
// doneLatchKey 用来记住「这节已经播完」:平台在完成后会把播放器重置到 0 秒,
|
||||
// video.ended 变回 false、倒计时也消失,若只看即时状态就会把视频从头重播。
|
||||
const latchKey = isMedia ? 'media' : (lessonKey || '');
|
||||
const cdDone = cd != null && cd <= 0;
|
||||
const ended = !!(v && v.ended);
|
||||
if (latchKey && R.doneLatchKey && R.doneLatchKey !== latchKey) R.doneLatchKey = '';
|
||||
if (latchKey && (cdDone || (ended && (cd == null || cd <= 3)))) {
|
||||
R.doneLatchKey = latchKey;
|
||||
}
|
||||
const localDone = ended || cdDone ||
|
||||
(!!latchKey && R.doneLatchKey === latchKey);
|
||||
|
||||
// 8) 播放器
|
||||
if (!localDone) {
|
||||
if (v) {
|
||||
ensurePlaying(v);
|
||||
const want = '学习中:' + truncate(lessonKey || S.activeCourse.title, 30);
|
||||
if (statusEl && (statusEl.textContent === '点击开始学习…' ||
|
||||
(isMedia && statusEl.textContent !== want))) {
|
||||
setStatus(want);
|
||||
}
|
||||
} else {
|
||||
const startBtn = findVisibleClickable(/^(开始学习|继续学习|继续观看)$/);
|
||||
if (startBtn && Date.now() - R.lastStartClickAt > CFG.startClickCooldownMs) {
|
||||
R.lastStartClickAt = Date.now();
|
||||
setStatus('点击开始学习…');
|
||||
console.log(TAG, '点击开始学习', textOf(startBtn) || startBtn.tagName);
|
||||
try { startBtn.click(); } catch (e) {}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 9) 标记等待平台记录
|
||||
if (!localDone) {
|
||||
R.waitStart = 0;
|
||||
} else if (!R.waitStart) {
|
||||
R.waitStart = Date.now();
|
||||
R.waitSummaryX = prevSummaryX;
|
||||
R.waitLessonKey = lessonKey;
|
||||
setStatus(isMedia ? '课程已播完,等待平台记录…' : '本节结束,等待平台记录…');
|
||||
}
|
||||
|
||||
// 10) 等待平台记录本节完成
|
||||
if (R.waitStart) {
|
||||
const newKey = readActiveLessonKey();
|
||||
const s2 = readSummary();
|
||||
|
||||
// 整门课已完成(含「已完成学习」/百分比 100%)
|
||||
if (s2 && s2.complete) {
|
||||
const confirmed = !!(R.lastSummary && R.lastSummary.complete);
|
||||
R.lastSummary = s2;
|
||||
if (!confirmed) {
|
||||
setStatus('课程已完成,确认中…');
|
||||
return;
|
||||
}
|
||||
R.waitStart = 0;
|
||||
R.lastProgressAt = Date.now();
|
||||
completeCurrent();
|
||||
return;
|
||||
}
|
||||
|
||||
// 平台自动进入了下一节(只可能发生在有目录的多课时课程)
|
||||
if (!isMedia && R.waitLessonKey && newKey && newKey !== R.waitLessonKey) {
|
||||
R.waitStart = 0;
|
||||
R.lastLessonKey = newKey;
|
||||
R.doneLatchKey = '';
|
||||
R.lastProgressAt = Date.now();
|
||||
setStatus('已自动进入下一节');
|
||||
return;
|
||||
}
|
||||
|
||||
// 完成数增加 → 手动切下一节
|
||||
if (!isMedia && s2 && s2.x > R.waitSummaryX) {
|
||||
R.waitStart = 0;
|
||||
R.lastProgressAt = Date.now();
|
||||
if (s2.complete) {
|
||||
completeCurrent();
|
||||
} else {
|
||||
advanceLesson();
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (Date.now() - R.waitStart > 30000) {
|
||||
if (isMedia) {
|
||||
// 单视频/音频:平台记账有延迟,继续等,不能把已播完的视频再拉回 0 秒
|
||||
R.waitStart = Date.now();
|
||||
setStatus('课程已播完,等待平台完成记录…');
|
||||
} else {
|
||||
R.waitStart = 0;
|
||||
setStatus('平台未更新进度,尝试下一节…');
|
||||
advanceLesson();
|
||||
}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 11) 长时间无进展 → 放弃
|
||||
if (Date.now() - R.lastProgressAt > CFG.stuckMs) {
|
||||
failCurrent('长时间没有计时进展');
|
||||
}
|
||||
}
|
||||
|
||||
// 自动切下一节:先点标题(事件会冒泡到行容器 / li 上的句柄),
|
||||
// 平台没反应时再依次补点行容器、li、状态图标;每一步都先确认目标课时还没
|
||||
// 变成当前课时,避免平台自己已经切过去之后又被点回来。
|
||||
export function switchLesson(li) {
|
||||
if (!li) return;
|
||||
const want = norm(textOf(li));
|
||||
const nodes = lessonClickNodes(li);
|
||||
const svg = li.querySelector('svg');
|
||||
const steps = [
|
||||
{ at: 0, run: function () { clickNode(nodes[0]); } },
|
||||
{ at: 500, run: function () { if (nodes[1]) clickNode(nodes[1]); } },
|
||||
{ at: 1000, run: function () { fireClickSequence(li); } },
|
||||
{ at: 1500, run: function () { if (svg) fireClickSequence(svg); } },
|
||||
];
|
||||
for (const step of steps) {
|
||||
if (!step.at) {
|
||||
step.run();
|
||||
continue;
|
||||
}
|
||||
later(function () {
|
||||
if (want && readActiveLessonKey() === want) return;
|
||||
step.run();
|
||||
}, step.at);
|
||||
}
|
||||
}
|
||||
|
||||
export function advanceLesson() {
|
||||
if (Date.now() - R.lastAdvanceAt < 5000) return;
|
||||
R.lastAdvanceAt = Date.now();
|
||||
R.lastCountdown = null;
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
|
||||
const next = findNextLessonElement();
|
||||
if (next) {
|
||||
setStatus('进入下一节');
|
||||
switchLesson(next);
|
||||
return;
|
||||
}
|
||||
const btn = findNextButton();
|
||||
if (btn) {
|
||||
setStatus('进入下一节');
|
||||
clickNode(btn);
|
||||
return;
|
||||
}
|
||||
|
||||
const s = readSummary();
|
||||
if (s && s.complete) {
|
||||
completeCurrent();
|
||||
} else {
|
||||
setStatus('没有找到下一节,等待课程完成…');
|
||||
}
|
||||
}
|
||||
|
||||
// ======== 考试课时 ========
|
||||
// 平台汇总已算完成(个别课考试节没做也判完成)时不再进考试,
|
||||
// 否则只会白白多交一次卷。
|
||||
function isSummaryComplete() {
|
||||
const s = readSummary();
|
||||
return !!(s && s.complete);
|
||||
}
|
||||
|
||||
// 目录里有未完成的考试课时时,先点进考试节。点完后平台会渲染考试说明页,
|
||||
// 下一轮 tick 由 examTick() 接管(开始考试 → 不答题 → 提交 → 确定)。
|
||||
// 顺序上把考试放到最后:还有普通课时没学完就不进考试,
|
||||
// 避免「进考试→交卷→重进课程页」的额外跳转打断正常播放。
|
||||
// 返回 true = 本 tick 已在处理,调用方直接 return。
|
||||
export function enterPendingExamLesson() {
|
||||
const li = findPendingExamLesson();
|
||||
if (!li) return false;
|
||||
|
||||
// 换课/离课后重置「点考试节」的计数,否则下一门课会凭空背着上一门课的次数
|
||||
const courseKey = (S.activeCourse && S.activeCourse.id) || courseIdFromUrl() || '';
|
||||
if (R.examLessonKey !== courseKey) {
|
||||
R.examLessonKey = courseKey;
|
||||
R.examLessonTries = 0;
|
||||
R.examLessonAt = 0;
|
||||
}
|
||||
|
||||
const pendingNormal = lessonItems().some(function (item) {
|
||||
const tag = item.querySelector('.tag-type');
|
||||
const isExam = !!tag && /考试/.test(textOf(tag));
|
||||
return !isExam && !isLessonCompleted(item);
|
||||
});
|
||||
if (pendingNormal) return false;
|
||||
|
||||
if (Date.now() - R.examLessonAt < CFG.examClickCooldownMs * 2) return true;
|
||||
|
||||
// 已经停在这一节(说明页/答卷页由 examTick 管),不重复点
|
||||
const activeLi = lessonActiveLi();
|
||||
if (activeLi && activeLi === li && examPhase()) return false;
|
||||
|
||||
if (R.examLessonTries >= 10) {
|
||||
failCurrent('点击考试章节多次后仍未进入考试页');
|
||||
return true;
|
||||
}
|
||||
|
||||
R.examLessonAt = Date.now();
|
||||
R.examLessonTries++;
|
||||
setStatus('进入考试章节:' + truncate(textOf(li), 20) +
|
||||
(R.examLessonTries > 1 ? '(第 ' + R.examLessonTries + ' 次)' : ''));
|
||||
clickLesson(li, R.examLessonTries);
|
||||
return true;
|
||||
}
|
||||
|
||||
// ======== 当前课程自动连播(手动打开的课) ========
|
||||
export function manualCourseTick() {
|
||||
hookAllVideos();
|
||||
if (handleAntiIdle()) return;
|
||||
|
||||
// 课程标题就绪前不做任何判断,避免在旧课程的目录上点来点去
|
||||
const title = courseTitle();
|
||||
if (!title || /^(loading|加载中)/i.test(title)) return;
|
||||
|
||||
// 手动进入课程时同样先对齐到「第一个未学完的课时」;每门课只对齐一次,
|
||||
// 之后用户自己点别的课时不会被拉回来
|
||||
syncManualCourse();
|
||||
if (!mediaPage() && alignToFirstIncomplete()) return;
|
||||
|
||||
// 考试页:同样自动进考试、空卷交卷(出错只提示,不影响手动听课)
|
||||
if (examTick(true)) return;
|
||||
if (!examPhase() && !isSummaryComplete() && enterPendingExamLesson()) return;
|
||||
|
||||
const lessonKey = readActiveLessonKey();
|
||||
if (lessonKey && lessonKey !== R.lastLessonKey) {
|
||||
R.lastLessonKey = lessonKey;
|
||||
R.doneLatchKey = '';
|
||||
setStatus('学习中:' + truncate(lessonKey, 28));
|
||||
}
|
||||
|
||||
// 整门课已完成(平台汇总会变成「已完成学习」/100%):停在这里,别再重播
|
||||
const summary = readSummary();
|
||||
if (summary && summary.complete) {
|
||||
pauseAllMedia();
|
||||
setStatus('课程已完成:' + truncate(S.activeCourse ? S.activeCourse.title : title, 24));
|
||||
return;
|
||||
}
|
||||
|
||||
const v = findPlayableVideo();
|
||||
if (!v) {
|
||||
// 单视频/音频页初始只有封面和「开始学习」,手动模式也要能点开
|
||||
if (!mediaPage()) return;
|
||||
const startBtn = findVisibleClickable(/^(开始学习|继续学习|继续观看)$/);
|
||||
if (startBtn && Date.now() - R.lastStartClickAt > CFG.startClickCooldownMs) {
|
||||
R.lastStartClickAt = Date.now();
|
||||
setStatus('点击开始学习…');
|
||||
try { startBtn.click(); } catch (e) {}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
const cd = readCountdown();
|
||||
if (cd != null) {
|
||||
if (R.lastCountdown == null || cd < R.lastCountdown) R.lastProgressAt = Date.now();
|
||||
R.lastCountdown = cd;
|
||||
}
|
||||
|
||||
if (v.ended || (cd != null && cd <= 0)) R.doneLatchKey = 'manual';
|
||||
const localDone = v.ended || (cd != null && cd <= 0) || R.doneLatchKey === 'manual';
|
||||
|
||||
if (localDone) {
|
||||
if (CFG.autoNext && Date.now() - R.manualAdvanceAt > 6000) {
|
||||
R.manualAdvanceAt = Date.now();
|
||||
const next = findNextLessonElement();
|
||||
if (next) {
|
||||
switchLesson(next);
|
||||
} else {
|
||||
const btn = findNextButton();
|
||||
if (btn) clickNode(btn);
|
||||
}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
ensurePlaying(v);
|
||||
}
|
||||
+302
@@ -0,0 +1,302 @@
|
||||
// ======== 考试:自动进入考试并空卷交卷 ========
|
||||
// 平台的考试章节不是可播放的课时:进课后显示的是「考试说明页」(开始考试 / 继续考试),
|
||||
// 点进去是答卷页(答题卡 + 提交考试),交卷后是结果页(查看答卷详情 / 返回考试说明页)。
|
||||
// 这里的目标只有一个:进入考试后一题不做,直接交卷,让考试章节计入课程进度,
|
||||
// 从而让「含考试章节的课程」也能被刷完,而不是整门课被跳过。
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, saveRunState } from './state.js';
|
||||
import { textOf, isVisible, courseIdFromUrl } from './utils.js';
|
||||
import { later } from './lifecycle.js';
|
||||
import { setStatus } from './panel.js';
|
||||
import { failCurrent, completeCurrent } from './complete.js';
|
||||
import { readSummary } from './player.js';
|
||||
|
||||
// 只认「考试」相关文案:答题/测验/问卷仍按「需要人工处理」跳过
|
||||
const START_RE = /^(开始考试|继续考试|进入考试)$/;
|
||||
const SUBMIT_RE = /^(提交考试|提交试卷|交卷|交卷并退出)$/;
|
||||
// 「交卷」类文案里只有考试独有的几个能用来判定「当前是考试答卷页」;
|
||||
// 「提交试卷」同样会出现在答题/测验页上,不能拿来当考试标志(否则会误抢答题页)。
|
||||
const EXAM_SUBMIT_RE = /^(提交考试|交卷|交卷并退出)$/;
|
||||
const CONFIRM_RE = /^(确定|确认|确定交卷|确认交卷|提交|提交试卷)$/;
|
||||
const RESULT_RE = /^(查看答卷详情|返回考试说明页)$/;
|
||||
|
||||
function visibleAll(sel, root) {
|
||||
let list = [];
|
||||
try {
|
||||
list = [...(root || document).querySelectorAll(sel)];
|
||||
} catch (e) {
|
||||
return [];
|
||||
}
|
||||
return list.filter(isVisible);
|
||||
}
|
||||
|
||||
// 点击优先级:真正的 button > 按钮类样式 > a > span > 其它。
|
||||
// 站点把点击回调绑在 <button> 上,点到外层 div 不会有任何反应。
|
||||
function rankOf(el) {
|
||||
const tag = el.tagName;
|
||||
if (tag === 'BUTTON' || tag === 'INPUT') return 0;
|
||||
if (/yxtf?-button|btn/i.test(String(el.className || ''))) return 1;
|
||||
if (tag === 'A') return 2;
|
||||
if (tag === 'SPAN') return 3;
|
||||
return 4;
|
||||
}
|
||||
|
||||
// 有些节点是 svg 包装,没有 click();统一派发鼠标事件序列
|
||||
export function examClick(el) {
|
||||
if (!el) return false;
|
||||
try {
|
||||
el.dispatchEvent(new MouseEvent('mousedown', { bubbles: true, cancelable: true, view: window }));
|
||||
el.dispatchEvent(new MouseEvent('mouseup', { bubbles: true, cancelable: true, view: window }));
|
||||
el.dispatchEvent(new MouseEvent('click', { bubbles: true, cancelable: true, view: window }));
|
||||
return true;
|
||||
} catch (e) {
|
||||
try { el.click(); return true; } catch (e2) { return false; }
|
||||
}
|
||||
}
|
||||
|
||||
// 按「去掉全部空白后的完整文案」匹配可点元素(平台按钮文案带大量换行缩进)
|
||||
function findClickableByText(re, root) {
|
||||
const cands = visibleAll('button, [role="button"], a, span, div', root);
|
||||
const hit = cands.filter(function (el) {
|
||||
const t = textOf(el);
|
||||
return !!t && t.length <= 12 && re.test(t);
|
||||
});
|
||||
if (!hit.length) return null;
|
||||
hit.sort(function (a, b) {
|
||||
const d = rankOf(a) - rankOf(b);
|
||||
if (d) return d;
|
||||
return textOf(a).length - textOf(b).length;
|
||||
});
|
||||
return hit[0];
|
||||
}
|
||||
|
||||
// ---- 考试页的三种形态 ----
|
||||
export function examPreviewRoot() {
|
||||
return visibleAll('.yxtulcdsdk-uexam-preview, [class*="uexam-preview"]')[0] || null;
|
||||
}
|
||||
|
||||
export function examPaperRoot() {
|
||||
return visibleAll('[class*="answer-card"], [class*="answerSheet"], [class*="answer-sheet"]')[0] || null;
|
||||
}
|
||||
|
||||
export function examResultRoot() {
|
||||
const btns = visibleAll('button, [role="button"], a');
|
||||
for (const b of btns) {
|
||||
const t = textOf(b);
|
||||
if (t && t.length <= 12 && RESULT_RE.test(t)) return b;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 'preview' = 考试说明页 | 'paper' = 答卷页 | 'result' = 交卷后的结果页 | '' = 不在考试页
|
||||
export function examPhase() {
|
||||
if (examResultRoot()) return 'result';
|
||||
if (examPaperRoot()) return 'paper';
|
||||
if (examPreviewRoot()) return 'preview';
|
||||
// 兜底:容器类名改版时按按钮文案判断。
|
||||
// 「提交试卷」不单独作数:答题/测验页也有这个按钮,只有从考试说明页进来后才认它,
|
||||
// 避免把需要人工处理的答题页误当成考试自动交卷。
|
||||
if (findClickableByText(EXAM_SUBMIT_RE)) return 'paper';
|
||||
if (R.examPhase === 'preview' && findClickableByText(SUBMIT_RE)) return 'paper';
|
||||
if (findClickableByText(START_RE)) return 'preview';
|
||||
return '';
|
||||
}
|
||||
|
||||
// 交卷确认框里的「确定」按钮:只认可见、文案短、且提到交卷/未做的弹层,避免点到隐藏的弹窗模板。
|
||||
// 注意:弹层里文案最短的一层往往是「还有 N 道题未做,是否确认交卷?」的消息体,
|
||||
// 它本身不包含底部按钮,所以按文案长度升序逐个尝试,谁里面有「确定」就用谁。
|
||||
function confirmState() {
|
||||
const boxes = visibleAll('.yxtf-dialog__wrapper, .yxt-dialog__wrapper, [class*="dialog"], [class*="modal"], [role="dialog"]');
|
||||
const cands = boxes.filter(function (b) {
|
||||
const t = textOf(b);
|
||||
return !!t && t.length <= 300 && /交卷|未做|确认提交|是否确认/.test(t);
|
||||
});
|
||||
if (!cands.length) return { shown: false, btn: null };
|
||||
cands.sort(function (a, b) { return textOf(a).length - textOf(b).length; });
|
||||
for (const b of cands) {
|
||||
const btn = findClickableByText(CONFIRM_RE, b);
|
||||
if (btn) return { shown: true, btn: btn };
|
||||
}
|
||||
return { shown: true, btn: null };
|
||||
}
|
||||
|
||||
// 手动刷课(自己点开的课)里出错不应该动队列,只停下并提示;
|
||||
// 批量刷课走 failCurrent(重试退避,超过次数才停止整轮)。
|
||||
function examAbort(reason, manual) {
|
||||
if (manual) {
|
||||
setStatus('考试:' + reason);
|
||||
return true;
|
||||
}
|
||||
failCurrent(reason);
|
||||
return true;
|
||||
}
|
||||
|
||||
function examCourseKey() {
|
||||
return (S.activeCourse && S.activeCourse.id) || courseIdFromUrl() || (location.pathname + location.hash);
|
||||
}
|
||||
|
||||
export function examTriedTimes(key) {
|
||||
const m = S.examEmptySubmits || {};
|
||||
return m[key || examCourseKey()] || 0;
|
||||
}
|
||||
|
||||
// 交卷后返回课程页有两种真实情况:
|
||||
// 1) 结果页是课程页里的一个视图,location.href 目标与当前 URL 相同,赋值不会触发任何导航
|
||||
// → 必须 reload,否则会停在结果页无限循环交卷;
|
||||
// 2) 正常的跨路由跳转,href 赋值即可。
|
||||
export function backToCourse() {
|
||||
const id = (S.activeCourse && S.activeCourse.id) || courseIdFromUrl() || '';
|
||||
const target = id ? location.origin + '/kng/#/course/play?kngId=' + encodeURIComponent(id) : '';
|
||||
// 重新进课要重新对齐起点,否则会停在考试节点上没有任何可播内容
|
||||
R.initialLessonChecked = false;
|
||||
R.alignTries = 0;
|
||||
R.alignStable = 0;
|
||||
R.alignFailed = false;
|
||||
R.phaseSince = 0;
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
R.lastCountdown = null;
|
||||
R.lastSummary = null;
|
||||
R.examLeaving = false;
|
||||
try {
|
||||
const cur = location.href;
|
||||
if (!target || cur === target) {
|
||||
location.reload();
|
||||
return;
|
||||
}
|
||||
location.href = target;
|
||||
// 兜底:SPA 有时只换 hash 不重渲染,1.5 秒后仍在原地址就强制刷新
|
||||
later(function () {
|
||||
if (location.href === cur) {
|
||||
try { location.reload(); } catch (e) { /* ignore */ }
|
||||
}
|
||||
}, 1500);
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
function finishExam() {
|
||||
if (R.examLeaving) return;
|
||||
R.examLeaving = true;
|
||||
const key = examCourseKey();
|
||||
if (!S.examEmptySubmits) S.examEmptySubmits = {};
|
||||
S.examEmptySubmits[key] = examTriedTimes(key) + 1;
|
||||
saveRunState();
|
||||
const times = S.examEmptySubmits[key];
|
||||
console.log(TAG, '考试已空卷交卷(第', times, '次),返回课程页继续学习');
|
||||
|
||||
// 交卷后平台会立刻更新课程汇总;已经「已完成学习」就直接判这门课完成,不必再跳一轮
|
||||
const s = readSummary();
|
||||
if (s && s.complete) {
|
||||
setStatus('考试已交卷(未答题),课程已完成');
|
||||
later(completeCurrent, 1500);
|
||||
return;
|
||||
}
|
||||
|
||||
if (times >= Math.max(1, CFG.maxExamTries)) {
|
||||
examAbort('已空卷交卷 ' + times + ' 次,仍未计入课程进度,请手动处理', false);
|
||||
return;
|
||||
}
|
||||
|
||||
setStatus('考试已交卷(未答题),返回课程继续…');
|
||||
later(backToCourse, 1800);
|
||||
}
|
||||
|
||||
// 每个 tick 调用。返回 true = 本 tick 已在处理考试页,调用方应直接 return。
|
||||
export function examTick(manual) {
|
||||
const now = Date.now();
|
||||
const phase = examPhase();
|
||||
|
||||
if (!phase) {
|
||||
// 不在考试页:清掉考试引导状态,交回正常播放逻辑
|
||||
if (R.examPhase) {
|
||||
R.examPhase = '';
|
||||
R.examPaperAt = 0;
|
||||
R.examSubmits = 0;
|
||||
R.examConfirms = 0;
|
||||
R.examStarts = 0;
|
||||
R.examActionAt = 0;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
// 换形态(说明页 → 答卷页 → 结果页)时重置本形态的点击节奏
|
||||
if (R.examPhase !== phase) {
|
||||
R.examPhase = phase;
|
||||
R.examActionAt = 0;
|
||||
R.examSubmits = 0;
|
||||
R.examConfirms = 0;
|
||||
R.examStarts = 0;
|
||||
R.examPaperAt = 0;
|
||||
if (phase === 'preview') {
|
||||
console.log(TAG, '检测到考试章节:进入考试后不答题,直接交卷');
|
||||
setStatus('检测到考试:进入考试后直接交卷…');
|
||||
}
|
||||
}
|
||||
|
||||
if (phase === 'result') {
|
||||
finishExam();
|
||||
return true;
|
||||
}
|
||||
|
||||
// 同一门课空卷交卷次数上限:平台没记账时避免「进考试→交卷→再进考试」死循环
|
||||
const key = examCourseKey();
|
||||
if (examTriedTimes(key) >= Math.max(1, CFG.maxExamTries)) {
|
||||
return examAbort('已空卷交卷 ' + examTriedTimes(key) + ' 次,仍未计入课程进度,请手动处理', manual);
|
||||
}
|
||||
|
||||
if (now - R.examActionAt < CFG.examClickCooldownMs) return true;
|
||||
|
||||
if (phase === 'preview') {
|
||||
const root = examPreviewRoot();
|
||||
const btn = findClickableByText(START_RE, root) || findClickableByText(START_RE);
|
||||
if (!btn) {
|
||||
setStatus('考试:未找到「开始考试」按钮,等待页面渲染…');
|
||||
return true;
|
||||
}
|
||||
R.examActionAt = now;
|
||||
R.examStarts++;
|
||||
if (R.examStarts > Math.max(3, CFG.maxExamTries + 3)) {
|
||||
return examAbort('点击「开始考试」多次仍不进答卷页', manual);
|
||||
}
|
||||
setStatus(R.examStarts > 1
|
||||
? '考试:再次点击「' + textOf(btn) + '」…(第 ' + R.examStarts + ' 次)'
|
||||
: '考试:进入考试(不答题,随后直接交卷)');
|
||||
examClick(btn);
|
||||
return true;
|
||||
}
|
||||
|
||||
// ---- 答卷页:等题目渲染出来 → 点提交考试 → 在确认框点确定 ----
|
||||
if (!R.examPaperAt) R.examPaperAt = now;
|
||||
if (now - R.examPaperAt < 2000) return true;
|
||||
|
||||
const cs = confirmState();
|
||||
if (cs.shown) {
|
||||
if (!cs.btn) {
|
||||
setStatus('考试:交卷确认框里没找到「确定」按钮');
|
||||
return true;
|
||||
}
|
||||
R.examActionAt = now;
|
||||
R.examConfirms++;
|
||||
if (R.examConfirms > 6) {
|
||||
return examAbort('交卷确认框点了多次仍未交卷', manual);
|
||||
}
|
||||
setStatus('考试:不答题,确认交卷…');
|
||||
examClick(cs.btn);
|
||||
return true;
|
||||
}
|
||||
|
||||
const sub = findClickableByText(SUBMIT_RE);
|
||||
if (!sub) {
|
||||
setStatus('考试:等待「提交考试」按钮…');
|
||||
return true;
|
||||
}
|
||||
if (R.examSubmits >= 6) {
|
||||
return examAbort('「提交考试」点了多次仍无结果', manual);
|
||||
}
|
||||
R.examActionAt = now;
|
||||
R.examSubmits++;
|
||||
setStatus('考试:不答题,直接交卷…');
|
||||
examClick(sub);
|
||||
return true;
|
||||
}
|
||||
+119
@@ -0,0 +1,119 @@
|
||||
// ======== 主循环 ========
|
||||
'use strict';
|
||||
import { CFG, VERSION, TAG } from './config.js';
|
||||
import { R, S, state, saveRunState, flushRunState, invalidateShortCatalog } from './state.js';
|
||||
import { every, later, onWindow } from './lifecycle.js';
|
||||
import { courseIdFromUrl } from './utils.js';
|
||||
import { route, mediaPage } from './route.js';
|
||||
import { ensurePanel, setStatus } from './panel.js';
|
||||
import { isLoginPage, loginPageTick, doLoginAndStart, fillLoginForm, startBatch, consumePendingStart, setTick, loginFields, findLoginVm, checkLoginAgreement, setNativeValue, saveCreds, loadCreds, clearSavedCreds } from './login.js';
|
||||
import {
|
||||
listTick, listVm, shortCatalogKey, courseIdOfCard, ensureShortCatalog,
|
||||
chooseShortCourse, sortCardsByDuration, formatDuration,
|
||||
pendingShortItems, scanCards, currentPage, maxPageNumber,
|
||||
startCourse, jumpToPage, nextPage,
|
||||
} from './list.js';
|
||||
import { courseTick, manualCourseTick } from './course.js';
|
||||
import {
|
||||
stopBatch, retryCount, retryWaiting, retryWaitSeconds,
|
||||
completeCurrent, failCurrent,
|
||||
} from './complete.js';
|
||||
import { examTick, examPhase } from './exam.js';
|
||||
import {
|
||||
hookAllVideos, readSummary, readCountdown, lessonItems,
|
||||
findNextLessonElement, clickLesson, alignToFirstIncomplete,
|
||||
isLessonCompleted, findFirstIncompleteLessonElement, dumpCatalog,
|
||||
pauseAllMedia, findPlayableVideo, ensurePlaying, readActiveLessonKey,
|
||||
detectQuiz, courseTitle, findNextButton, clickNode,
|
||||
examLessonElements, findPendingExamLesson,
|
||||
} from './player.js';
|
||||
|
||||
function tick() {
|
||||
try {
|
||||
if (window.top !== window.self) return;
|
||||
ensurePanel();
|
||||
if (isLoginPage()) loginPageTick();
|
||||
if (consumePendingStart()) return;
|
||||
|
||||
if (!S.batchRunning) {
|
||||
if (route() === 'course' && state.autoPlayEnabled) {
|
||||
manualCourseTick();
|
||||
} else {
|
||||
R.manualCourseKey = ''; // 离开课程页后,下次进入同一门课要重新对齐
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
const r = route();
|
||||
if (r === 'list') {
|
||||
listTick();
|
||||
} else if (r === 'course') {
|
||||
courseTick();
|
||||
}
|
||||
} catch (e) {
|
||||
console.error(TAG, e);
|
||||
}
|
||||
}
|
||||
|
||||
// 把主循环回填给 login.startBatch(它在点击「一键刷课」后需要立即 tick 一次)
|
||||
setTick(tick);
|
||||
|
||||
// iframe 内只负责接管视频
|
||||
if (window.top !== window.self) {
|
||||
every(function () {
|
||||
try { hookAllVideos(); } catch (e) {}
|
||||
}, CFG.tickMs);
|
||||
} else {
|
||||
ensurePanel();
|
||||
hookAllVideos();
|
||||
every(tick, CFG.tickMs);
|
||||
onWindow(window, 'hashchange', function () {
|
||||
later(tick, 300);
|
||||
});
|
||||
}
|
||||
|
||||
// 调试入口(仅本地使用,可在控制台查看状态)
|
||||
try {
|
||||
Object.defineProperty(window, '__yunXueTangAuto', {
|
||||
value: {
|
||||
S, R, state, tick, save: saveRunState, flush: flushRunState, route,
|
||||
// CFG 暴露给无头运行器:可用 --max / YUN_XUE_TANG_MAX_COURSES 覆盖本次运行的门数上限
|
||||
CFG,
|
||||
mediaPage, courseIdFromUrl,
|
||||
readCountdown, readSummary,
|
||||
isLoginPage, loginPageTick,
|
||||
doLoginAndStart, fillLoginForm,
|
||||
startBatch, consumePendingStart,
|
||||
findNextLessonElement, lessonItems,
|
||||
dumpCatalog, clickLesson,
|
||||
alignToFirstIncomplete,
|
||||
isLessonCompleted,
|
||||
findFirstIncompleteLessonElement,
|
||||
listVm, shortCatalogKey,
|
||||
courseIdOfCard,
|
||||
ensureShortCatalog, chooseShortCourse,
|
||||
sortCardsByDuration, formatDuration,
|
||||
pendingShortItems, invalidateShortCatalog,
|
||||
retryCount, retryWaiting, retryWaitSeconds,
|
||||
completeCurrent, failCurrent,
|
||||
// 以下供开发/真机测试驱动内部路径使用:
|
||||
scanCards, currentPage, maxPageNumber, startCourse, jumpToPage, nextPage,
|
||||
listTick, courseTick, manualCourseTick,
|
||||
loginFields, findLoginVm, checkLoginAgreement, setNativeValue,
|
||||
saveCreds, loadCreds, clearSavedCreds,
|
||||
pauseAllMedia, findPlayableVideo, ensurePlaying, readActiveLessonKey,
|
||||
detectQuiz, courseTitle, findNextButton, clickNode,
|
||||
stopBatch,
|
||||
// 考试:调试/真机验证用
|
||||
examTick, examPhase, examLessonElements, findPendingExamLesson,
|
||||
},
|
||||
configurable: true,
|
||||
});
|
||||
} catch (e) { /* ignore */ }
|
||||
|
||||
console.log('%c云学堂助手 v' + VERSION + ' 已加载', 'color:#3c9;font-weight:bold');
|
||||
// 刷课是否在跑由 sessionStorage 里的本标签页状态决定:
|
||||
// 浏览器重启 / 运行器新建标签页后一定是待机,不会在未登录的页面上谎报「运行中」。
|
||||
setStatus(S.batchFinished
|
||||
? '本次已完成 ' + S.completedThisRun + ' 门(已停止)'
|
||||
: (S.batchRunning ? '列表刷课运行中' : '待机'));
|
||||
@@ -0,0 +1,66 @@
|
||||
// ======== 生命周期(支持热替换:新版本注入前先 dispose 旧实例) ========
|
||||
import { PANEL_ID, TAG } from './config.js';
|
||||
|
||||
export const TIMERS = []; // setInterval id
|
||||
export const DELAYS = []; // setTimeout id
|
||||
export const WINDOW_LISTENERS = [];// [target, type, fn]
|
||||
export const ELEMENT_LISTENERS = [];// [el, type, fn]
|
||||
|
||||
export function every(fn, ms) {
|
||||
const id = setInterval(fn, ms);
|
||||
TIMERS.push(id);
|
||||
return id;
|
||||
}
|
||||
|
||||
export function later(fn, ms) {
|
||||
const id = setTimeout(function () {
|
||||
const i = DELAYS.indexOf(id);
|
||||
if (i >= 0) DELAYS.splice(i, 1);
|
||||
try { fn(); } catch (e) { console.error(TAG, e); }
|
||||
}, ms);
|
||||
DELAYS.push(id);
|
||||
return id;
|
||||
}
|
||||
|
||||
export function onWindow(target, type, fn) {
|
||||
target.addEventListener(type, fn);
|
||||
WINDOW_LISTENERS.push([target, type, fn]);
|
||||
}
|
||||
|
||||
export function onElement(el, type, fn) {
|
||||
el.addEventListener(type, fn);
|
||||
ELEMENT_LISTENERS.push([el, type, fn]);
|
||||
}
|
||||
|
||||
// 登记表里的一项:[target, type, fn]
|
||||
function detachListener(x) {
|
||||
x[0].removeEventListener(x[1], x[2]);
|
||||
}
|
||||
|
||||
// 清空一个登记表并逐项释放;单项抛错不影响其余项
|
||||
function drain(arr, fn) {
|
||||
arr.splice(0).forEach(function (x) { try { fn(x); } catch (e) {} });
|
||||
}
|
||||
|
||||
export function dispose() {
|
||||
drain(TIMERS, clearInterval);
|
||||
drain(DELAYS, clearTimeout);
|
||||
drain(WINDOW_LISTENERS, detachListener);
|
||||
drain(ELEMENT_LISTENERS, detachListener);
|
||||
try {
|
||||
document.querySelectorAll('video[data-yun-xue-tang-hooked]').forEach(function (v) {
|
||||
v.removeAttribute('data-yun-xue-tang-hooked');
|
||||
});
|
||||
} catch (e) {}
|
||||
const panel = document.getElementById(PANEL_ID);
|
||||
if (panel && panel.parentNode) panel.parentNode.removeChild(panel);
|
||||
try { delete window.__yunXueTangAuto; } catch (e) {}
|
||||
try { if (window.__yunXueTangDispose === dispose) delete window.__yunXueTangDispose; } catch (e) {}
|
||||
console.log(TAG, '旧实例已释放');
|
||||
}
|
||||
|
||||
try {
|
||||
Object.defineProperty(window, '__yunXueTangDispose', {
|
||||
value: dispose, configurable: true, writable: true,
|
||||
});
|
||||
} catch (e) { /* 重复注入时忽略 */ }
|
||||
+665
@@ -0,0 +1,665 @@
|
||||
// ======== 列表页 ========
|
||||
import { SHORT_CATALOG_TTL, SS_SHORT_CATALOG, TAG } from './config.js';
|
||||
import {
|
||||
R, S, state, saveRunState, setTargetCatalogUrl, resetCourseRuntime, invalidateShortCatalog,
|
||||
PHASE_ENTERING, PHASE_LEARNING, PHASE_IDLE,
|
||||
} from './state.js';
|
||||
import { norm, textOf, truncate } from './utils.js';
|
||||
import { clickNode } from './player.js';
|
||||
import { setStatus, updatePanel } from './panel.js';
|
||||
import { failCurrent, stopBatch } from './complete.js';
|
||||
import { retryWaiting, retryWaitSeconds } from './complete.js';
|
||||
|
||||
export function scanCards() {
|
||||
return [...document.querySelectorAll('li.kng-list-new__item')].map((li, i) => {
|
||||
const titleEl = li.querySelector('.yxtf-tooltip');
|
||||
const tags = [...li.querySelectorAll('.kng-list-new__tag')].map(textOf);
|
||||
const status = tags.find((t) => /已学完|学习中|未开始|未学习|已完成/.test(t)) ||
|
||||
tags.find((t) => t !== '课程') || '';
|
||||
return {
|
||||
li: li,
|
||||
i: i,
|
||||
title: norm(titleEl ? titleEl.innerText : ''),
|
||||
status: status,
|
||||
tags: tags,
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
export function currentPage() {
|
||||
const el = document.querySelector('.yxtf-pager .number.active');
|
||||
if (!el) return null;
|
||||
const n = Number(textOf(el));
|
||||
return Number.isFinite(n) ? n : null;
|
||||
}
|
||||
|
||||
export function maxPageNumber() {
|
||||
const nums = [...document.querySelectorAll('.yxtf-pager .number')]
|
||||
.map((e) => Number(textOf(e)))
|
||||
.filter((n) => Number.isFinite(n) && n > 0);
|
||||
return nums.length ? Math.max.apply(null, nums) : null;
|
||||
}
|
||||
|
||||
export function cardsSignature(cards) {
|
||||
cards = cards || scanCards();
|
||||
if (!cards.length) return '';
|
||||
return cards.length + '|' + cards[0].title + '|' + cards[cards.length - 1].title;
|
||||
}
|
||||
|
||||
export function jumpToPage(target) {
|
||||
if (!target) return false;
|
||||
if (Date.now() - R.lastPageJumpAt < 3000) return false;
|
||||
R.lastPageJumpAt = Date.now();
|
||||
R.pageChangeAt = Date.now();
|
||||
R.pageChangeSig = cardsSignature();
|
||||
|
||||
const input = document.querySelector(
|
||||
'.yxtf-pagination__editor input, .yxtf-pagination input[type="number"]'
|
||||
);
|
||||
if (input) {
|
||||
try {
|
||||
const setter = Object.getOwnPropertyDescriptor(
|
||||
window.HTMLInputElement.prototype, 'value'
|
||||
).set;
|
||||
setter.call(input, String(target));
|
||||
} catch (e) {
|
||||
input.value = String(target);
|
||||
}
|
||||
input.dispatchEvent(new Event('input', { bubbles: true }));
|
||||
input.dispatchEvent(new Event('change', { bubbles: true }));
|
||||
input.dispatchEvent(new KeyboardEvent('keydown', {
|
||||
key: 'Enter', code: 'Enter', keyCode: 13, which: 13, bubbles: true,
|
||||
}));
|
||||
console.log(TAG, '跳转到第', target, '页');
|
||||
return true;
|
||||
}
|
||||
|
||||
const btn = [...document.querySelectorAll('.yxtf-pager .number')]
|
||||
.find((e) => Number(textOf(e)) === target);
|
||||
if (btn) {
|
||||
btn.click();
|
||||
return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
export function nextPage() {
|
||||
if (Date.now() - R.lastPageJumpAt < 3000) return;
|
||||
R.lastPageJumpAt = Date.now();
|
||||
R.pageChangeAt = Date.now();
|
||||
R.pageChangeSig = cardsSignature();
|
||||
const btn = document.querySelector('.yxtf-pagination .btn-next');
|
||||
if (btn && !btn.disabled) {
|
||||
btn.click();
|
||||
console.log(TAG, '翻到下一页');
|
||||
}
|
||||
}
|
||||
|
||||
// ======== 短课程优先(时长正序) ========
|
||||
// 列表卡片本身不显示时长,但列表组件(ul.kng-list-new.__vue__)的 kngListData
|
||||
// 里每门课都带 studyHours(秒)。当前页可据此按时长排序;要进一步跨页优先,
|
||||
// 再用同一套列表接口一次性读取全部课程,按 studyHours 正序排队。
|
||||
// 接口失败时逐级降级:跨页队列 → 当前页时长排序 → 原列表顺序,绝不卡住刷课任务。
|
||||
|
||||
export function formatDuration(seconds) {
|
||||
const n = Number(seconds);
|
||||
if (!Number.isFinite(n) || n <= 0) return '时长未知';
|
||||
const minutes = Math.max(1, Math.round(n / 60));
|
||||
if (minutes < 60) return minutes + ' 分钟';
|
||||
const h = Math.floor(minutes / 60);
|
||||
const m = minutes % 60;
|
||||
return h + ' 小时' + (m ? ' ' + m + ' 分钟' : '');
|
||||
}
|
||||
|
||||
function listData(vm) {
|
||||
return (vm && vm.kngListData) || [];
|
||||
}
|
||||
|
||||
// 列表页组件:优先取直接挂载 kngListData 的父组件
|
||||
export function listVm() {
|
||||
const ul = document.querySelector('ul.kng-list-new');
|
||||
let vm = ul && ul.__vue__;
|
||||
while (vm && !Array.isArray(vm.kngListData)) vm = vm.$parent;
|
||||
return vm && Array.isArray(vm.kngListData) ? vm : null;
|
||||
}
|
||||
|
||||
// 列表接口的分页/排序参数:缓存 key 与实际请求共用同一份默认值,避免两处飘移
|
||||
function shortQuery(vm) {
|
||||
return {
|
||||
pageSize: Number(vm && vm.pageSize) || 16,
|
||||
orderBy: (vm && vm.sortColumn) || 'createTime',
|
||||
orderType: (vm && vm.sortType) || 'desc',
|
||||
};
|
||||
}
|
||||
|
||||
export function shortCatalogKey(vm) {
|
||||
const q = shortQuery(vm);
|
||||
const key = {
|
||||
collegeId: (vm && vm.collegeId) || '',
|
||||
catalogId: (vm && vm.currentCatalogId) || '',
|
||||
title: (vm && vm.searchKey) || '',
|
||||
type: vm && vm.kngType != null ? vm.kngType : '',
|
||||
allTag: vm && vm.tagIds && vm.tagIds.length ? 0 : 1,
|
||||
tagIds: (vm && vm.tagIds) || [],
|
||||
orderBy: q.orderBy,
|
||||
orderType: q.orderType,
|
||||
pageSize: q.pageSize,
|
||||
};
|
||||
return JSON.stringify(key);
|
||||
}
|
||||
|
||||
export function readShortCatalog(key) {
|
||||
try {
|
||||
const raw = sessionStorage.getItem(SS_SHORT_CATALOG);
|
||||
if (!raw) return null;
|
||||
const obj = JSON.parse(raw);
|
||||
if (!obj || obj.key !== key || !Array.isArray(obj.items)) return null;
|
||||
if (Date.now() - (obj.at || 0) > SHORT_CATALOG_TTL) return null;
|
||||
return obj;
|
||||
} catch (e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
export function writeShortCatalog(cat) {
|
||||
if (!cat) return;
|
||||
try {
|
||||
sessionStorage.setItem(SS_SHORT_CATALOG, JSON.stringify(cat));
|
||||
} catch (e) { /* 容量不足时只保留内存队列 */ }
|
||||
}
|
||||
|
||||
export function shortApiBase() {
|
||||
try {
|
||||
const hit = performance.getEntriesByType('resource')
|
||||
.map(function (e) { return e.name; })
|
||||
.find(function (u) { return /\/kng\/knowledge\/pagelist/.test(u); });
|
||||
if (hit) return new URL(hit).origin + '/kng/knowledge/pagelist';
|
||||
} catch (e) { /* 用默认域名 */ }
|
||||
return 'https://api-phx-tc.yunxuetang.cn/kng/knowledge/pagelist';
|
||||
}
|
||||
|
||||
export function shortCatalogRequest(vm) {
|
||||
const orgId = (vm && vm.collegeId) || localStorage.getItem('orgId') || '';
|
||||
const token = localStorage.getItem('token') || '';
|
||||
if (!token) throw new Error('未找到登录 token,可能尚未登录或登录已过期');
|
||||
|
||||
const body = JSON.stringify({
|
||||
collegeId: orgId,
|
||||
catalogId: (vm && vm.currentCatalogId) || '',
|
||||
title: (vm && vm.searchKey) || '',
|
||||
type: vm && vm.kngType != null ? vm.kngType : '',
|
||||
allTag: vm && vm.tagIds && vm.tagIds.length ? 0 : 1,
|
||||
tagIds: (vm && vm.tagIds) || [],
|
||||
});
|
||||
const headers = {
|
||||
'content-type': 'application/json;charset=UTF-8',
|
||||
accept: 'application/json, text/plain, */*',
|
||||
token: token,
|
||||
'yxt-orgdomain': location.hostname,
|
||||
source: '501',
|
||||
};
|
||||
return { body: body, headers: headers };
|
||||
}
|
||||
|
||||
// 刚完成的课程平台记账有延迟,这段窗口内不剔除 done 里的旧记录
|
||||
const DONE_STALE_MS = 10 * 60 * 1000;
|
||||
|
||||
// 一次性读取列表接口(limit=6000 可覆盖当前 5000+ 门课程的站点),
|
||||
// 只保留「未学完」的课程,并映射到它所在的页码。
|
||||
async function fetchShortCatalog(vm) {
|
||||
const key = shortCatalogKey(vm);
|
||||
const q = shortQuery(vm);
|
||||
const req = shortCatalogRequest(vm);
|
||||
const api = shortApiBase();
|
||||
const datas = [];
|
||||
let offset = 0;
|
||||
let total = Infinity;
|
||||
let requests = 0;
|
||||
|
||||
while (offset < total && requests < 20) {
|
||||
const limit = Number.isFinite(total) ? Math.min(6000, total - offset) : 6000;
|
||||
if (limit <= 0) break;
|
||||
const url = api + '?limit=' + limit + '&offset=' + offset +
|
||||
'&orderType=' + encodeURIComponent(q.orderType) +
|
||||
'&orderBy=' + encodeURIComponent(q.orderBy);
|
||||
const res = await fetch(url, { method: 'POST', headers: req.headers, body: req.body });
|
||||
if (!res.ok) throw new Error('列表接口 HTTP ' + res.status);
|
||||
const json = await res.json();
|
||||
const list = json && json.datas;
|
||||
if (!Array.isArray(list)) throw new Error('列表接口返回格式异常');
|
||||
if (!list.length) break;
|
||||
datas.push.apply(datas, list);
|
||||
total = Number(json.paging && json.paging.count);
|
||||
if (!Number.isFinite(total)) total = datas.length;
|
||||
offset += list.length;
|
||||
requests++;
|
||||
}
|
||||
|
||||
const items = [];
|
||||
let pruned = 0;
|
||||
datas.forEach(function (item, index) {
|
||||
if (!item || !item.title) return;
|
||||
const title = norm(item.title);
|
||||
if (Number(item.status) === 2 || item.studyComplete === 1 || item.studyComplete === true) return;
|
||||
// 平台说这门课还没学完,但本地 done 里有记录:说明本地快照旧了
|
||||
// (例如平台回滚了进度、或之前是在另一目录下学完的同名课)。
|
||||
// 刚完成的那门课平台记账有延迟,所以只剔除超过 DONE_STALE_MS 的旧记录。
|
||||
if (S.completedTitles[title] && Date.now() - Number(S.completedTitles[title]) > DONE_STALE_MS) {
|
||||
delete S.completedTitles[title];
|
||||
pruned++;
|
||||
}
|
||||
const seconds = Number(item.studyHours);
|
||||
items.push({
|
||||
id: item.id ? String(item.id) : '',
|
||||
title: title,
|
||||
duration: Number.isFinite(seconds) && seconds > 0 ? seconds : 0,
|
||||
status: item.status,
|
||||
page: Math.floor(index / q.pageSize) + 1,
|
||||
});
|
||||
});
|
||||
if (pruned) {
|
||||
saveRunState();
|
||||
console.log(TAG, '平台显示未学完,已重新纳入队列的旧记录:', pruned, '门');
|
||||
}
|
||||
// 时长未知的排最后;相同时按原来的列表顺序(页码)
|
||||
items.sort(function (a, b) {
|
||||
const da = a.duration > 0 ? a.duration : Number.MAX_SAFE_INTEGER;
|
||||
const db = b.duration > 0 ? b.duration : Number.MAX_SAFE_INTEGER;
|
||||
return da === db ? a.page - b.page : da - db;
|
||||
});
|
||||
|
||||
return { key: key, at: Date.now(), pageSize: q.pageSize, total: datas.length, items: items };
|
||||
}
|
||||
|
||||
// 返回 'off' | 'loading' | 'ready' | 'failed'
|
||||
export function ensureShortCatalog() {
|
||||
if (!state.preferShortCourses) return 'off';
|
||||
|
||||
const vm = listVm();
|
||||
if (!vm) {
|
||||
if (!R.shortNoVmSince) R.shortNoVmSince = Date.now();
|
||||
if (Date.now() - R.shortNoVmSince > 5000) {
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
if (Date.now() - (R.shortWarnedAt || 0) > 10000) {
|
||||
R.shortWarnedAt = Date.now();
|
||||
console.warn(TAG, '未找到课程列表组件,退回当前页时长排序');
|
||||
setStatus('未读取到课程列表数据,先按当前页时长排序');
|
||||
}
|
||||
return 'failed';
|
||||
}
|
||||
return 'loading';
|
||||
}
|
||||
R.shortNoVmSince = 0;
|
||||
|
||||
const key = shortCatalogKey(vm);
|
||||
if (R.shortCatalog && R.shortCatalog.key === key &&
|
||||
Date.now() - (R.shortCatalog.at || 0) < SHORT_CATALOG_TTL) {
|
||||
return 'ready';
|
||||
}
|
||||
|
||||
if (R.shortCatalogLoading) {
|
||||
if (Date.now() - R.shortFetchStartedAt > 20000) {
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
return 'failed';
|
||||
}
|
||||
return 'loading';
|
||||
}
|
||||
if (R.shortCatalogFailedAt && Date.now() - R.shortCatalogFailedAt < 30000) return 'failed';
|
||||
|
||||
const cached = readShortCatalog(key);
|
||||
if (cached) {
|
||||
R.shortCatalog = cached;
|
||||
return 'ready';
|
||||
}
|
||||
|
||||
R.shortCatalogLoading = true;
|
||||
R.shortFetchStartedAt = Date.now();
|
||||
setStatus('正在读取课程时长,优先安排短课程…');
|
||||
fetchShortCatalog(vm).then(function (cat) {
|
||||
R.shortCatalogLoading = false;
|
||||
if (!state.preferShortCourses) return;
|
||||
R.shortCatalogFailedAt = 0;
|
||||
R.shortCatalog = cat;
|
||||
writeShortCatalog(cat);
|
||||
const shortest = cat.items[0];
|
||||
console.log(TAG, '短课程队列已就绪:待学', cat.items.length, '门;最短',
|
||||
shortest ? formatDuration(shortest.duration) : '无');
|
||||
setStatus(shortest
|
||||
? '优先短课程:共 ' + cat.items.length + ' 门待学,最短 ' + formatDuration(shortest.duration)
|
||||
: '时长队列为空,按当前页继续');
|
||||
updatePanel();
|
||||
}).catch(function (e) {
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
if (!state.preferShortCourses) return;
|
||||
console.warn(TAG, '读取课程时长失败,退回当前页时长排序:',
|
||||
e && e.message ? e.message : e);
|
||||
setStatus('未能读取全部课程时长,先按当前页时长排序');
|
||||
updatePanel();
|
||||
});
|
||||
return 'loading';
|
||||
}
|
||||
|
||||
export function shortFallback(reason) {
|
||||
R.shortCatalog = null;
|
||||
R.shortCatalogFailedAt = Date.now();
|
||||
try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) { /* ignore */ }
|
||||
if (Date.now() - (R.shortWarnedAt || 0) > 10000) {
|
||||
R.shortWarnedAt = Date.now();
|
||||
console.warn(TAG, '短课程优先暂不可用,退回当前页时长排序:', reason);
|
||||
setStatus('短课程优先暂不可用,先按当前页时长排序');
|
||||
}
|
||||
}
|
||||
|
||||
export function pendingShortItems() {
|
||||
const cat = R.shortCatalog;
|
||||
if (!cat) return [];
|
||||
return cat.items.filter(function (item) {
|
||||
if (!item || !item.title) return false;
|
||||
// 只排除「本轮已完成」;不再排除任何「失败/跳过」——没过就是重试,不是拉黑
|
||||
if (S.completedTitles[item.title]) return false;
|
||||
return true;
|
||||
});
|
||||
}
|
||||
|
||||
// 列表卡片 -> 课程 id。卡片的打开逻辑按 id 跳转,而播放页 URL 带 kngId:
|
||||
// 有了 id 就能在标题还没刷新时准确判断「进的是不是队列里的这门课」,
|
||||
// 不再因为页面标题短暂是 loading/在线课堂 就误判并退回列表。
|
||||
export function courseIdOfCard(card) {
|
||||
if (!card) return '';
|
||||
const vm = listVm();
|
||||
const data = listData(vm);
|
||||
const byIndex = data[card.i];
|
||||
const t = norm(card.title);
|
||||
if (byIndex && String(byIndex.id || '') && norm(byIndex.title) === t) {
|
||||
return String(byIndex.id);
|
||||
}
|
||||
const hit = data.find(function (x) { return x && norm(x.title) === t; });
|
||||
return hit && hit.id ? String(hit.id) : '';
|
||||
}
|
||||
|
||||
export function durationOfCard(card, vm) {
|
||||
if (!card) return 0;
|
||||
const data = listData(vm);
|
||||
const hit = data.find(function (item) { return norm(item.title) === card.title; });
|
||||
const n = hit ? Number(hit.studyHours) : 0;
|
||||
return Number.isFinite(n) && n > 0 ? n : 0;
|
||||
}
|
||||
|
||||
// 优先用课程 id 匹配卡片,避免同名课程(平台上确实有)点错;
|
||||
// id 不可用时再退回标题匹配。
|
||||
export function cardForShortItem(cards, item) {
|
||||
if (!item) return null;
|
||||
if (item.id) {
|
||||
const vm = listVm();
|
||||
const data = listData(vm);
|
||||
const index = data.findIndex(function (x) { return x && String(x.id) === item.id; });
|
||||
if (index >= 0 && cards[index] && cards[index].title === item.title) return cards[index];
|
||||
}
|
||||
return cards.find(function (c) { return c.title === item.title; }) || null;
|
||||
}
|
||||
|
||||
export function sortCardsByDuration(cards, vm) {
|
||||
vm = vm || listVm();
|
||||
return cards.slice().sort(function (a, b) {
|
||||
const da = durationOfCard(a, vm) || Number.MAX_SAFE_INTEGER;
|
||||
const db = durationOfCard(b, vm) || Number.MAX_SAFE_INTEGER;
|
||||
return da - db;
|
||||
});
|
||||
}
|
||||
|
||||
export function forgetShortCourse(title) {
|
||||
const t = norm(title);
|
||||
if (!t || !R.shortCatalog || !Array.isArray(R.shortCatalog.items)) return;
|
||||
const before = R.shortCatalog.items.length;
|
||||
R.shortCatalog.items = R.shortCatalog.items.filter(function (item) { return item.title !== t; });
|
||||
if (R.shortCatalog.items.length !== before) writeShortCatalog(R.shortCatalog);
|
||||
}
|
||||
|
||||
// 时长队列是否可用(可用时页码导航由 chooseShortCourse 独占,listTick 不再恢复页码)
|
||||
export function isShortCatalogActive() {
|
||||
return !!(state.preferShortCourses && R.shortCatalog &&
|
||||
Date.now() - (R.shortCatalog.at || 0) < SHORT_CATALOG_TTL);
|
||||
}
|
||||
|
||||
// 返回 { card } 表示本 tick 可以进入该课程;{ wait: true } 表示正在加载/翻页。
|
||||
export function chooseShortCourse(cards, pending) {
|
||||
if (!state.preferShortCourses) return null;
|
||||
const status = ensureShortCatalog();
|
||||
|
||||
if (status === 'loading') return { wait: true };
|
||||
|
||||
if (status === 'ready') {
|
||||
const items = pendingShortItems();
|
||||
if (items.length) {
|
||||
const target = items[0];
|
||||
const page = currentPage() || S.listPage || 1;
|
||||
if (target.page && target.page !== page) {
|
||||
if (Date.now() - R.shortJumpAt < 6000) return { wait: true };
|
||||
R.shortJumpAt = Date.now();
|
||||
if (jumpToPage(target.page)) {
|
||||
S.listPage = target.page;
|
||||
saveRunState();
|
||||
setStatus('优先短课程:转到第 ' + target.page + ' 页(' +
|
||||
formatDuration(target.duration) + ')');
|
||||
return { wait: true };
|
||||
}
|
||||
if (Date.now() - R.lastPageJumpAt < 3500) return { wait: true };
|
||||
shortFallback('无法跳转到第 ' + target.page + ' 页');
|
||||
} else {
|
||||
const card = cardForShortItem(cards, target);
|
||||
if (card) {
|
||||
if (card.status === '已学完' || S.completedTitles[card.title]) {
|
||||
// 缓存与实际状态不一致:剔除这一门,下一 tick 继续挑下一门
|
||||
forgetShortCourse(card.title);
|
||||
return { wait: true };
|
||||
}
|
||||
card.duration = target.duration;
|
||||
R.shortJumpAt = 0;
|
||||
return { card: card };
|
||||
}
|
||||
// 刚翻到目标页时卡片可能还没渲染完
|
||||
if (Date.now() - R.shortJumpAt < 8000) return { wait: true };
|
||||
shortFallback('目标课程不在第 ' + target.page + ' 页');
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 兜底:当前页未学完课程按时长正序
|
||||
if (pending && pending.length) {
|
||||
const vm = listVm();
|
||||
const sorted = sortCardsByDuration(pending, vm);
|
||||
if (sorted.length) {
|
||||
sorted[0].duration = durationOfCard(sorted[0], vm);
|
||||
return { card: sorted[0] };
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 短课程优先时页码归 chooseShortCourse 管:它知道下一门课在第几页,会直接跳过去。
|
||||
// 只有「没开短课程优先」或「时长队列拿不到(已明确失败)」时,listTick 才去恢复页码。
|
||||
function shouldRestorePage() {
|
||||
if (!state.preferShortCourses) return true;
|
||||
if (isShortCatalogActive()) return false;
|
||||
// 队列还在加载:先别跳,等 chooseShortCourse 一次跳到位
|
||||
if (R.shortCatalogLoading) return false;
|
||||
return !!R.shortCatalogFailedAt;
|
||||
}
|
||||
|
||||
export function listTick() {
|
||||
const cards = scanCards();
|
||||
if (!cards.length) return; // 列表还没渲染
|
||||
|
||||
// 等待翻页后的新卡片,避免用旧卡片做判断
|
||||
if (R.pageChangeSig) {
|
||||
if (cardsSignature(cards) === R.pageChangeSig &&
|
||||
Date.now() - R.pageChangeAt < 10000) {
|
||||
return;
|
||||
}
|
||||
R.pageChangeSig = '';
|
||||
}
|
||||
if (R.pageChangeAt && Date.now() - R.pageChangeAt < 1500) return;
|
||||
|
||||
// 列表 URL 同时是「目标目录」偏好:它决定刷哪个学院的课,
|
||||
// 也是短课程队列的缓存键来源,所以单独存 localStorage。
|
||||
if (S.catalogUrl !== location.href) setTargetCatalogUrl(location.href, { silent: true });
|
||||
|
||||
const page = currentPage();
|
||||
|
||||
// 回到列表后,恢复到课程所在的页码(仅在拿不到时长队列时才需要)
|
||||
if (S.awaitingListReturn && !shouldRestorePage()) {
|
||||
// 页码不需要恢复:直接交给 chooseShortCourse / 当前页继续
|
||||
S.awaitingListReturn = false;
|
||||
R.pageRestoreAttempts = 0;
|
||||
saveRunState();
|
||||
} else if (S.awaitingListReturn) {
|
||||
if (page != null && S.listPage && page !== S.listPage) {
|
||||
R.pageRestoreAttempts++;
|
||||
if (R.pageRestoreAttempts > 12) {
|
||||
console.warn(TAG, '页码恢复失败,改用当前页继续');
|
||||
S.listPage = page || 1;
|
||||
S.awaitingListReturn = false;
|
||||
saveRunState();
|
||||
} else if (S.listPage > page) {
|
||||
// 短课程优先会直接跳到很靠后的页(例如第 307 页),
|
||||
// 不能一页一页 nextPage,否则要翻几百次;优先用页码输入框直跳。
|
||||
if (jumpToPage(S.listPage)) return;
|
||||
nextPage();
|
||||
return;
|
||||
} else {
|
||||
jumpToPage(S.listPage);
|
||||
return;
|
||||
}
|
||||
} else {
|
||||
S.awaitingListReturn = false;
|
||||
R.pageRestoreAttempts = 0;
|
||||
saveRunState();
|
||||
setStatus('回到列表第 ' + (page || 1) + ' 页,继续…');
|
||||
}
|
||||
}
|
||||
|
||||
// 记录当前页
|
||||
if (!S.awaitingListReturn && page != null && page !== S.listPage) {
|
||||
S.listPage = page;
|
||||
saveRunState();
|
||||
}
|
||||
|
||||
// 已在进入课程的过程中:等路由跳转
|
||||
if (S.activeCourse && S.coursePhase === PHASE_ENTERING) {
|
||||
const waited = Date.now() - (S.activeCourse.startedAt || 0);
|
||||
if (waited > 15000) {
|
||||
failCurrent('未能进入课程页面');
|
||||
return;
|
||||
}
|
||||
// 列表卡片点击偶尔会落在脚本/路由就绪之前(页面毫无反应)。还停在列表时
|
||||
// 最多补点两次,而不是提前判这门课未完成。
|
||||
if (waited > 4000 && R.entryRetries < 2 &&
|
||||
Date.now() - R.lastCardClickAt > 4000) {
|
||||
const card = cards.find(function (c) { return c.title === S.activeCourse.title; });
|
||||
if (card) {
|
||||
R.entryRetries++;
|
||||
R.lastCardClickAt = Date.now();
|
||||
console.log(TAG, '进入课程超时,重试点击卡片(第', R.entryRetries, '次)');
|
||||
setStatus('重新进入课程:' + truncate(S.activeCourse.title, 22));
|
||||
try { clickNode(card.li); } catch (e) { /* ignore */ }
|
||||
}
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
// 从课程页意外回到列表:判断当前课程是已完成还是中断
|
||||
if (S.activeCourse && S.coursePhase === PHASE_LEARNING) {
|
||||
if (!R.listWithCurrentSince) R.listWithCurrentSince = Date.now();
|
||||
if (Date.now() - R.listWithCurrentSince < 5000) return;
|
||||
|
||||
const card = cards.find(function (c) { return c.title === S.activeCourse.title; });
|
||||
if (card && /已学完|已完成|已学习/.test(card.status)) {
|
||||
S.completedTitles[S.activeCourse.title] = Date.now();
|
||||
S.completedThisRun = (S.completedThisRun || 0) + 1;
|
||||
}
|
||||
S.activeCourse = null;
|
||||
S.coursePhase = PHASE_IDLE;
|
||||
S.awaitingListReturn = false;
|
||||
R.listWithCurrentSince = 0;
|
||||
// 回到列表就重新拿平台实时状态(不用本地旧快照选课)
|
||||
invalidateShortCatalog();
|
||||
saveRunState();
|
||||
setStatus('已重置中断的课程状态,继续…');
|
||||
}
|
||||
|
||||
if (S.activeCourse) return; // 其他异常情况,等路由
|
||||
|
||||
// 上一门没学完、正在退避等待时不进任何课:到点后直接重进同一门(它仍是最短的未完成课)
|
||||
if (retryWaiting()) {
|
||||
const left = retryWaitSeconds();
|
||||
// 只在秒数变化时刷状态,避免每 tick 都打一行日志
|
||||
if (R.retryStatusSec !== left) {
|
||||
R.retryStatusSec = left;
|
||||
setStatus('等待重试:' + truncate(R.retryTitle || '上一门课', 20) +
|
||||
'(' + left + ' 秒后)');
|
||||
}
|
||||
return;
|
||||
}
|
||||
R.retryStatusSec = -1;
|
||||
|
||||
const pending = cards.filter((c) => {
|
||||
if (!c.title) return false;
|
||||
if (/已学完|已完成|已学习/.test(c.status)) return false;
|
||||
if (S.completedTitles[c.title]) return false;
|
||||
return true;
|
||||
});
|
||||
|
||||
// 优先短课程:先读时长队列,跨页挑总时长最短的未学完课程;
|
||||
// 接口不可用时 chooseShortCourse 会退回当前页时长排序或原列表顺序。
|
||||
if (state.preferShortCourses) {
|
||||
const choice = chooseShortCourse(cards, pending);
|
||||
if (choice && choice.wait) return;
|
||||
if (choice && choice.card) {
|
||||
if (Date.now() - R.lastCardClickAt < 5000) return;
|
||||
startCourse(choice.card);
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
if (pending.length) {
|
||||
if (Date.now() - R.lastCardClickAt < 5000) return;
|
||||
startCourse(pending[0]);
|
||||
return;
|
||||
}
|
||||
|
||||
const max = maxPageNumber();
|
||||
if (page != null && max && page < max) {
|
||||
nextPage();
|
||||
return;
|
||||
}
|
||||
|
||||
stopBatch('所有页面的未学完课程都已处理完毕');
|
||||
}
|
||||
|
||||
export function startCourse(card) {
|
||||
const page = currentPage() || S.listPage || 1;
|
||||
S.activeCourse = {
|
||||
title: card.title,
|
||||
id: courseIdOfCard(card),
|
||||
startedAt: Date.now(),
|
||||
};
|
||||
S.listPage = page;
|
||||
S.coursePhase = PHASE_ENTERING;
|
||||
S.awaitingListReturn = false;
|
||||
R.lastCardClickAt = Date.now();
|
||||
R.shortJumpAt = 0;
|
||||
resetCourseRuntime();
|
||||
saveRunState();
|
||||
const durationText = card.duration ? '(' + formatDuration(card.duration) + ')' : '';
|
||||
setStatus('进入课程' + durationText + ':' + truncate(card.title, 28));
|
||||
console.log(TAG, '进入课程', card.title, '状态', card.status,
|
||||
card.duration ? '时长 ' + formatDuration(card.duration) : '');
|
||||
try {
|
||||
card.li.click();
|
||||
} catch (e) {
|
||||
console.error(TAG, e);
|
||||
failCurrent('课程卡片点击失败');
|
||||
}
|
||||
}
|
||||
+300
@@ -0,0 +1,300 @@
|
||||
// ======== 登录 / 一键刷课 ========
|
||||
import { LS_LOGIN, LS_PENDING } from './config.js';
|
||||
import { R, S, saveRunState, invalidateShortCatalog, PHASE_IDLE } from './state.js';
|
||||
import { route, goToList } from './route.js';
|
||||
import { truncate, isVisible, findVisibleButton } from './utils.js';
|
||||
import { later, onElement } from './lifecycle.js';
|
||||
import { setStatus, updatePanel, loginUserEl, loginPassEl, loginRememberEl, loginAutoEl } from './panel.js';
|
||||
|
||||
// startBatch 内部会调用 tick()(主循环),tick 定义在 index.js;
|
||||
// 用可变绑定 + setter 在 index.js 装配阶段回填,避免 login -> index 的循环导入。
|
||||
let tick = function () {};
|
||||
export function setTick(fn) { tick = fn; }
|
||||
|
||||
// 「登录后自动开始刷课」的一次性标记,用完/失效就清掉
|
||||
function clearPending() {
|
||||
try { localStorage.removeItem(LS_PENDING); } catch (e) {}
|
||||
}
|
||||
|
||||
export function isLoginPage() {
|
||||
if (/\/login(\.html)?($|[?#])/i.test(location.pathname + location.search)) return true;
|
||||
if (/^#\/login/i.test(location.hash)) return true;
|
||||
return !!document.querySelector('input[type="password"]') && /登录/.test(document.title);
|
||||
}
|
||||
|
||||
export function loginFields() {
|
||||
const pwd = [...document.querySelectorAll('input[type="password"]')].find(isVisible) || null;
|
||||
const all = [...document.querySelectorAll('input')].filter(isVisible);
|
||||
let user = all.find(function (el) {
|
||||
return /员工邮箱|账号|用户名|邮箱|手机号/.test(el.placeholder || '');
|
||||
}) || null;
|
||||
if (!user && pwd) {
|
||||
const pi = all.indexOf(pwd);
|
||||
for (let i = pi - 1; i >= 0; i--) {
|
||||
const el = all[i];
|
||||
if (el.type === 'text' || el.type === 'email' || !el.type) { user = el; break; }
|
||||
}
|
||||
}
|
||||
return { user: user, pwd: pwd };
|
||||
}
|
||||
|
||||
export function setNativeValue(el, value) {
|
||||
if (!el) return false;
|
||||
try {
|
||||
const proto = el.tagName === 'TEXTAREA' ? HTMLTextAreaElement.prototype : HTMLInputElement.prototype;
|
||||
const setter = Object.getOwnPropertyDescriptor(proto, 'value').set;
|
||||
setter.call(el, value);
|
||||
} catch (e) {
|
||||
el.value = value;
|
||||
}
|
||||
el.dispatchEvent(new Event('input', { bubbles: true }));
|
||||
el.dispatchEvent(new Event('change', { bubbles: true }));
|
||||
el.dispatchEvent(new Event('blur', { bubbles: true }));
|
||||
return true;
|
||||
}
|
||||
|
||||
export function findLoginVm() {
|
||||
const btn = findVisibleButton(/^登录$/);
|
||||
let vm = btn && btn.__vue__;
|
||||
while (vm && vm.$options.name !== 'Login') vm = vm.$parent;
|
||||
if (vm) return vm;
|
||||
for (const el of document.querySelectorAll('#app, #app *')) {
|
||||
const v = el.__vue__;
|
||||
if (v && v.pwdLoginForm) return v;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
export function fillLoginForm(user, pass) {
|
||||
const f = loginFields();
|
||||
if (!f.user || !f.pwd) return false;
|
||||
setNativeValue(f.user, user);
|
||||
setNativeValue(f.pwd, pass);
|
||||
const vm = findLoginVm();
|
||||
if (vm && vm.pwdLoginForm) {
|
||||
vm.pwdLoginForm.userName = user;
|
||||
vm.pwdLoginForm.password = pass;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
export function checkLoginAgreement() {
|
||||
const labels = [...document.querySelectorAll('label')].filter(function (l) {
|
||||
return /已阅读并同意|隐私政策/.test(l.innerText || '') && isVisible(l);
|
||||
});
|
||||
if (!labels.length) return true;
|
||||
for (const label of labels) {
|
||||
const cb = label.querySelector('input[type="checkbox"]');
|
||||
if (!cb) continue;
|
||||
if (!cb.checked) {
|
||||
try { label.click(); } catch (e) {}
|
||||
}
|
||||
if (!cb.checked) {
|
||||
try { cb.click(); } catch (e) {}
|
||||
}
|
||||
if (cb.checked) return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
export function b64enc(s) {
|
||||
const bytes = new TextEncoder().encode(String(s));
|
||||
let bin = '';
|
||||
for (let i = 0; i < bytes.length; i++) bin += String.fromCharCode(bytes[i]);
|
||||
return btoa(bin);
|
||||
}
|
||||
|
||||
export function b64dec(s) {
|
||||
const bin = atob(String(s));
|
||||
const bytes = new Uint8Array(bin.length);
|
||||
for (let i = 0; i < bin.length; i++) bytes[i] = bin.charCodeAt(i);
|
||||
return new TextDecoder().decode(bytes);
|
||||
}
|
||||
|
||||
export function saveCreds(user, pass, remember, auto) {
|
||||
try {
|
||||
if (!remember) {
|
||||
localStorage.removeItem(LS_LOGIN);
|
||||
return;
|
||||
}
|
||||
localStorage.setItem(LS_LOGIN, b64enc(JSON.stringify({ u: user, p: pass, auto: !!auto })));
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function loadCreds() {
|
||||
try {
|
||||
const raw = localStorage.getItem(LS_LOGIN);
|
||||
if (!raw) return null;
|
||||
const obj = JSON.parse(b64dec(raw));
|
||||
if (!obj || !obj.u || !obj.p) return null;
|
||||
return { u: String(obj.u), p: String(obj.p), auto: !!obj.auto };
|
||||
} catch (e) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
export function clearSavedCreds() {
|
||||
try { localStorage.removeItem(LS_LOGIN); } catch (e) {}
|
||||
if (loginRememberEl) loginRememberEl.checked = false;
|
||||
}
|
||||
|
||||
export function startBatch() {
|
||||
if (S.batchFinished) {
|
||||
S.completedThisRun = 0;
|
||||
S.batchFinished = false;
|
||||
// 重新开启一轮时清掉重试计数:之前那些课允许重新尝试
|
||||
S.courseRetries = {};
|
||||
R.retryWaitUntil = 0;
|
||||
R.retryTitle = '';
|
||||
}
|
||||
S.batchRunning = true;
|
||||
// 开跑时丢掉旧的时长队列:第一门课也要按平台实时状态挑
|
||||
invalidateShortCatalog();
|
||||
if (!S.activeCourse) S.coursePhase = PHASE_IDLE;
|
||||
saveRunState();
|
||||
setStatus('列表刷课已开启');
|
||||
const r = route();
|
||||
if (r === 'list' || (r === 'course' && S.activeCourse)) {
|
||||
tick();
|
||||
} else {
|
||||
goToList();
|
||||
}
|
||||
updatePanel();
|
||||
}
|
||||
|
||||
export function consumePendingStart() {
|
||||
let ts = 0;
|
||||
try { ts = Number(localStorage.getItem(LS_PENDING) || 0); } catch (e) {}
|
||||
if (!ts) return false;
|
||||
if (Date.now() - ts > 5 * 60 * 1000) {
|
||||
clearPending();
|
||||
return false;
|
||||
}
|
||||
if (isLoginPage()) return false;
|
||||
clearPending();
|
||||
startBatch();
|
||||
return true;
|
||||
}
|
||||
|
||||
export function watchLoginResult() {
|
||||
if (!isLoginPage()) return;
|
||||
const vm = findLoginVm();
|
||||
if (vm && vm.captchaVisible) {
|
||||
setStatus('需要手动完成验证码/滑块,完成后会自动继续');
|
||||
return; // 保留 pending,手动完成登录后仍会自动开始
|
||||
}
|
||||
if (vm && typeof vm.pwd_tips === 'string' && vm.pwd_tips.trim()) {
|
||||
clearPending();
|
||||
R.loginSubmittingAt = 0;
|
||||
setStatus('登录失败:' + truncate(vm.pwd_tips.trim(), 50));
|
||||
return;
|
||||
}
|
||||
const txt = document.body.innerText || '';
|
||||
const err = txt.match(/(用户名密码错误[^\n]{0,60}|账号或密码错误[^\n]{0,60}|密码错误[^\n]{0,60}|账号不存在[^\n]{0,60}|登录失败[^\n]{0,60})/);
|
||||
if (err) {
|
||||
clearPending();
|
||||
R.loginSubmittingAt = 0;
|
||||
setStatus('登录失败:' + truncate(err[0], 50));
|
||||
return;
|
||||
}
|
||||
if (/验证码|安全验证|滑块/.test(txt) && R.loginSubmittingAt) {
|
||||
setStatus('需要手动完成验证码/滑块,完成后会自动继续');
|
||||
return; // 保留 pending,手动完成登录后仍会自动开始
|
||||
}
|
||||
if (R.loginSubmittingAt && Date.now() - R.loginSubmittingAt > 12000) {
|
||||
R.loginSubmittingAt = 0;
|
||||
setStatus('尚未登录成功:请检查账号密码,或手动完成验证');
|
||||
}
|
||||
}
|
||||
|
||||
export function doLoginAndStart() {
|
||||
const f = loginFields();
|
||||
const user = (loginUserEl ? loginUserEl.value.trim() : '') ||
|
||||
(f.user ? String(f.user.value || '').trim() : '');
|
||||
const pass = (loginPassEl ? loginPassEl.value : '') ||
|
||||
(f.pwd ? String(f.pwd.value || '') : '');
|
||||
if (!user || !pass) {
|
||||
setStatus('请先填写账号和密码');
|
||||
return;
|
||||
}
|
||||
if (loginUserEl) loginUserEl.value = user;
|
||||
if (loginPassEl) loginPassEl.value = pass;
|
||||
|
||||
const remember = !!(loginRememberEl && loginRememberEl.checked);
|
||||
const auto = !!(loginAutoEl && loginAutoEl.checked);
|
||||
saveCreds(user, pass, remember, auto);
|
||||
|
||||
fillLoginForm(user, pass);
|
||||
if (!checkLoginAgreement()) {
|
||||
setStatus('请先勾选《隐私政策》');
|
||||
return;
|
||||
}
|
||||
|
||||
try { localStorage.setItem(LS_PENDING, String(Date.now())); } catch (e) {}
|
||||
R.loginSubmittingAt = Date.now();
|
||||
R.loginAutoTried = true;
|
||||
setStatus('正在登录…');
|
||||
|
||||
const vm = findLoginVm();
|
||||
if (vm) {
|
||||
try {
|
||||
if (vm.pwdLoginForm) {
|
||||
vm.pwdLoginForm.userName = user;
|
||||
vm.pwdLoginForm.password = pass;
|
||||
}
|
||||
try { vm.agreeSecretProtocol = true; } catch (e) {}
|
||||
const p = vm.handleLogin();
|
||||
if (p && typeof p.catch === 'function') {
|
||||
p.catch(function (e) {
|
||||
setStatus('登录异常:' + (e && e.message ? e.message : e));
|
||||
});
|
||||
}
|
||||
} catch (e) {
|
||||
setStatus('登录异常:' + (e && e.message ? e.message : e));
|
||||
}
|
||||
} else {
|
||||
const btn = findVisibleButton(/^登录$/);
|
||||
if (btn) {
|
||||
try { btn.click(); } catch (e) {}
|
||||
} else {
|
||||
setStatus('未找到登录按钮,请手动点击');
|
||||
}
|
||||
}
|
||||
later(watchLoginResult, 2500);
|
||||
}
|
||||
|
||||
export function loginPageTick() {
|
||||
if (!isLoginPage()) return;
|
||||
const f = loginFields();
|
||||
if (f.user && f.pwd && (R.loginBoundUser !== f.user || R.loginBoundPwd !== f.pwd)) {
|
||||
R.loginBoundUser = f.user;
|
||||
R.loginBoundPwd = f.pwd;
|
||||
const sync = function () {
|
||||
if (loginUserEl) loginUserEl.value = f.user.value;
|
||||
if (loginPassEl) loginPassEl.value = f.pwd.value;
|
||||
};
|
||||
onElement(f.user, 'input', sync);
|
||||
onElement(f.pwd, 'input', sync);
|
||||
}
|
||||
if (!R.loginFilled) {
|
||||
if (f.user && f.pwd) {
|
||||
R.loginFilled = true;
|
||||
const creds = loadCreds();
|
||||
if (creds) {
|
||||
fillLoginForm(creds.u, creds.p);
|
||||
if (loginUserEl) loginUserEl.value = creds.u;
|
||||
if (loginPassEl) loginPassEl.value = creds.p;
|
||||
if (loginRememberEl) loginRememberEl.checked = true;
|
||||
if (loginAutoEl) loginAutoEl.checked = !!creds.auto;
|
||||
setStatus('已填充保存的账号,可点「一键登录并刷课」');
|
||||
if (creds.auto && !R.loginAutoTried) {
|
||||
R.loginAutoTried = true;
|
||||
later(function () { doLoginAndStart(); }, 800);
|
||||
}
|
||||
} else {
|
||||
setStatus('填写账号密码后,点「一键登录并刷课」');
|
||||
}
|
||||
}
|
||||
}
|
||||
if (R.loginSubmittingAt) watchLoginResult();
|
||||
}
|
||||
+63
@@ -0,0 +1,63 @@
|
||||
// ==UserScript==
|
||||
// @name 云学堂助手
|
||||
// @namespace yun-xue-tang-assistant.local
|
||||
// @version __YUN_XUE_TANG_VERSION__
|
||||
// @description 云学堂助手:自动登录、从第一节顺序听课、自动切节、处理防挂机验证,并在课程列表页逐门自动刷课(单视频/音频课程也支持,含考试章节的课自动空卷交卷,学完自动进入下一门,可优先短课程;不跳过任何课程)
|
||||
// @match *://kfmic.yunxuetang.cn/*
|
||||
// @match *://*.yunxuetang.cn/*
|
||||
// @grant none
|
||||
// @run-at document-idle
|
||||
// ==/UserScript==
|
||||
|
||||
/*
|
||||
* 用法:
|
||||
* 1. 浏览器安装 Tampermonkey,新建脚本,粘贴本文件全部内容并保存。
|
||||
* 2. 打开 https://kfmic.yunxuetang.cn/login.html,在右下角面板填账号/密码,
|
||||
* 点「一键登录并刷课」;登录成功后会自动进入课程列表并开始逐门学习。
|
||||
* 3. 也可以手动登录后,在列表页点「一键刷课」。
|
||||
*
|
||||
* 密码保存:
|
||||
* - 只有勾选「记住密码」才会写入本机 localStorage,使用 base64 混淆(不是加密,
|
||||
* 本机其他脚本仍可读取)。公用电脑请不要勾选。
|
||||
* - 不勾选时密码只用于本次登录,不会落盘。
|
||||
*
|
||||
* 重要说明:
|
||||
* - 平台按“真实播放时长”计时,快进、倍速都不省时间,脚本只做自动播放和自动切节。
|
||||
* - 同时支持多课时课程(#/course/play)和单视频/音频/课件播放页(#/video/play 等):
|
||||
* 单视频课程会自动点「开始学习」;平台汇总变成「已完成学习」/100%/x=y 时判定整门课
|
||||
* 完成,自动回列表并进入下一门。
|
||||
* - 进入课程(列表刷课或自己点开)都会先对齐到「第一个未学完的课时」,即从第一章第一节起
|
||||
* 顺序学习,不沿用平台上次停留的位置(否则前面的课时会被跳过,整门课永远学不完)。
|
||||
* 切换成功与否以目录高亮为准:没切过去会重试并如实提示「未能切换」,不会假装已切换。
|
||||
* - 试跑稳定后,把 config.js 里的 CFG.maxCourses 改成 0 即可不限门数(会持续很久)。
|
||||
* - 脚本不跳过任何课程:没有「跳过本课」,也不会把课程拉黑。某门课没学完(例如遇到
|
||||
* 需要人工完成的滑块/拼图验证、答题/测验章节、长时间无计时进展)就退避重试:
|
||||
* 30 秒起每次翻倍、最长 5 分钟,同一门课最多重试 CFG.maxCourseRetries 次,
|
||||
* 超过才停下整轮刷课并在面板写明原因,等人工处理后点「一键刷课」接着跑。
|
||||
* - 选课每次都动态查询:每完成一门课都重新调列表接口,拿平台实时的已完成/未完成状态,
|
||||
* 再按总时长从短到长挑下一门,不使用本地缓存的旧快照。
|
||||
* - 防挂机验证(每 10 分钟一次、120 秒限时)会自动点「继续学习」。
|
||||
* - 考试章节支持:自动进入考试、不答题直接交卷(空白交卷)。交卷后平台会把考试节点
|
||||
* 计入课程进度,含考试章节的课程也能学完。
|
||||
* 同一门课最多交卷 CFG.maxExamTries 次,超过仍没计入进度就按普通未完成退避重试。
|
||||
* - 验证码/滑块需要手动完成,脚本不会绕过。
|
||||
* - 课程/单位如有相关规定,请自行确认风险。
|
||||
*
|
||||
* 短课程优先:
|
||||
* - 面板勾选「优先短课程(时长正序)」后,列表刷课会先读课程列表接口里的总时长,
|
||||
* 按「未学完课程的总时长从短到长」选课,而不是按列表顺序。接口不可用时会自动
|
||||
* 退回为「当前页按时长正序」,再不行就按原来的列表顺序,不会卡住刷课任务。
|
||||
*
|
||||
* 无头运行(Linux 服务器 / Windows 无人值守):
|
||||
* - 不装 Tampermonkey 也能跑:仓库里的 runner/headless.mjs 会自己起一个无头 Chromium,
|
||||
* 用 CDP 把本文件注入页面主世界(等价 @grant none),并用固定 profile 持久化登录。
|
||||
* npm run build && npm run headless:check && npm run headless(凭据读环境变量)。
|
||||
* Windows 上也可以直接双击 start-headless.cmd。
|
||||
* - 需要在无头环境里调试本文件时,可以把 window.__yunXueTangAuto 当成调试入口,
|
||||
* 用 runtime.evaluate 直接调 tick()/startBatch()/readSummary() 等,不必开界面。
|
||||
*
|
||||
* 开发热加载:
|
||||
* - 本文件可直接被 dev/dev-loader.user.js 热注入:脚本暴露 window.__yunXueTangDispose(),
|
||||
* 加载器在注入新版本前会先调用它清理定时器、监听器与面板,因此保存文件后
|
||||
* 约 1 秒内即可生效,无需手动刷新页面。
|
||||
*/
|
||||
+294
@@ -0,0 +1,294 @@
|
||||
// ======== 面板 ========
|
||||
import { CFG, VERSION, LS_ENABLED, LS_PREFER_SHORT, SS_SHORT_CATALOG, PANEL_ID, TAG } from './config.js';
|
||||
import { R, S, state, saveRunState } from './state.js';
|
||||
import { route } from './route.js';
|
||||
import { isLoginPage, startBatch, doLoginAndStart, clearSavedCreds } from './login.js';
|
||||
|
||||
// 会话时长:面板 footer 显示本次脚本会话自加载起已运行多久
|
||||
const SESSION_START_AT = Date.now();
|
||||
export let statusEl = null;
|
||||
let statsEl = null;
|
||||
let footerEl = null;
|
||||
let cbBatch = null;
|
||||
let labelAuto = null;
|
||||
let labelBatch = null;
|
||||
let labelShort = null;
|
||||
let cbPreferShort = null;
|
||||
let cbAuto = null;
|
||||
let loginBox = null;
|
||||
export let loginUserEl = null;
|
||||
export let loginPassEl = null;
|
||||
export let loginRememberEl = null;
|
||||
export let loginAutoEl = null;
|
||||
let btnOne = null;
|
||||
let btnClearCreds = null;
|
||||
|
||||
// 面板里两个复选框行共用同一套 label 样式
|
||||
const LABEL_CSS = 'display:flex;align-items:center;gap:6px;cursor:pointer;margin-top:4px;';
|
||||
|
||||
function formatElapsed(ms) {
|
||||
const total = Math.max(0, Math.floor(ms / 1000));
|
||||
const h = Math.floor(total / 3600);
|
||||
const m = Math.floor((total % 3600) / 60);
|
||||
const s = total % 60;
|
||||
const p = function (n) { return n < 10 ? '0' + n : '' + n; };
|
||||
return h > 0 ? h + ':' + p(m) + ':' + p(s) : m + ':' + p(s);
|
||||
}
|
||||
|
||||
export function setStatus(text) {
|
||||
console.log(TAG, text);
|
||||
if (statusEl) statusEl.textContent = text;
|
||||
}
|
||||
|
||||
export function updatePanel() {
|
||||
if (cbBatch) cbBatch.checked = S.batchRunning;
|
||||
if (statsEl) {
|
||||
const limit = CFG.maxCourses > 0 ? CFG.maxCourses : '∞';
|
||||
let text = '本次 ' + S.completedThisRun + '/' + limit;
|
||||
const retryTitles = Object.keys(S.courseRetries || {}).length;
|
||||
if (retryTitles) text += ' · 待重试 ' + retryTitles;
|
||||
if (R.retryWaitUntil && Date.now() < R.retryWaitUntil) {
|
||||
text += ' · ' + Math.ceil((R.retryWaitUntil - Date.now()) / 1000) + 's 后重试';
|
||||
}
|
||||
text += (R.idlePassed ? ' · 验证 ' + R.idlePassed : '');
|
||||
statsEl.textContent = text;
|
||||
}
|
||||
if (footerEl) {
|
||||
footerEl.textContent = '会话时长 ' + formatElapsed(Date.now() - SESSION_START_AT);
|
||||
}
|
||||
if (cbAuto) cbAuto.checked = state.autoPlayEnabled;
|
||||
if (cbPreferShort) cbPreferShort.checked = state.preferShortCourses;
|
||||
|
||||
const onLogin = isLoginPage();
|
||||
if (loginBox) loginBox.style.display = onLogin ? 'block' : 'none';
|
||||
if (labelAuto) labelAuto.style.display = onLogin ? 'none' : 'flex';
|
||||
if (labelBatch) labelBatch.style.display = onLogin ? 'none' : 'flex';
|
||||
if (labelShort) labelShort.style.display = onLogin ? 'none' : 'flex';
|
||||
if (statsEl) statsEl.style.display = onLogin ? 'none' : 'block';
|
||||
if (btnOne) {
|
||||
// 「停止刷课」只在播放页出现;列表页等位置始终显示「一键刷课」
|
||||
const onCourse = route() === 'course' && !!S.activeCourse;
|
||||
btnOne.textContent = onLogin
|
||||
? '一键登录并刷课'
|
||||
: (onCourse && S.batchRunning ? '停止刷课' : '一键刷课');
|
||||
btnOne.title = onCourse && S.batchRunning ? '停止列表刷课' : '开始 / 继续列表刷课';
|
||||
}
|
||||
}
|
||||
|
||||
export function buildPanel() {
|
||||
if (window.top !== window.self) return;
|
||||
if (document.getElementById(PANEL_ID)) return;
|
||||
|
||||
const box = document.createElement('div');
|
||||
box.id = PANEL_ID;
|
||||
box.style.cssText = [
|
||||
'position:fixed', 'right:16px', 'bottom:16px', 'z-index:2147483647',
|
||||
'background:rgba(24,24,28,.88)', 'color:#eee', 'padding:10px 12px',
|
||||
'border-radius:8px', 'box-shadow:0 4px 16px rgba(0,0,0,.35)',
|
||||
'font:12px/1.5 system-ui,-apple-system,"Microsoft YaHei",sans-serif',
|
||||
'user-select:none', 'max-width:280px', 'min-width:220px',
|
||||
].join(';');
|
||||
|
||||
const title = document.createElement('div');
|
||||
title.style.cssText = 'display:flex;align-items:baseline;gap:6px;margin-bottom:6px;';
|
||||
|
||||
const titleText = document.createElement('span');
|
||||
titleText.textContent = '云学堂助手';
|
||||
titleText.style.cssText = 'font-weight:600;';
|
||||
|
||||
const titleVer = document.createElement('span');
|
||||
titleVer.id = 'yun-xue-tang-version';
|
||||
titleVer.textContent = 'v' + VERSION;
|
||||
titleVer.title = '脚本版本 v' + VERSION;
|
||||
titleVer.style.cssText = 'font-weight:400;font-size:10px;color:#8ee6c0;opacity:.85;';
|
||||
|
||||
title.appendChild(titleText);
|
||||
title.appendChild(titleVer);
|
||||
|
||||
btnOne = document.createElement('button');
|
||||
btnOne.type = 'button';
|
||||
btnOne.id = 'yun-xue-tang-oneclick';
|
||||
btnOne.textContent = '一键刷课';
|
||||
btnOne.style.cssText = [
|
||||
'width:100%', 'margin:2px 0 6px', 'padding:5px 8px', 'cursor:pointer',
|
||||
'background:#2f7d5b', 'color:#fff', 'border:1px solid #3a9a70',
|
||||
'border-radius:5px', 'font-size:12px', 'font-weight:600',
|
||||
].join(';');
|
||||
btnOne.addEventListener('click', function () {
|
||||
if (isLoginPage()) {
|
||||
doLoginAndStart();
|
||||
return;
|
||||
}
|
||||
// 只有播放页的按钮才是「停止」;列表页/门户页点它一律是开始/继续,避免误停
|
||||
if (route() === 'course' && S.activeCourse && S.batchRunning) {
|
||||
S.batchRunning = false;
|
||||
saveRunState();
|
||||
setStatus('列表刷课已暂停');
|
||||
} else {
|
||||
startBatch();
|
||||
}
|
||||
updatePanel();
|
||||
});
|
||||
|
||||
loginBox = document.createElement('div');
|
||||
loginBox.id = 'yun-xue-tang-login-box';
|
||||
loginBox.style.cssText = 'display:none;margin-bottom:6px;';
|
||||
|
||||
const mkInput = function (id, type, ph) {
|
||||
const el = document.createElement('input');
|
||||
el.id = id;
|
||||
el.type = type;
|
||||
el.placeholder = ph;
|
||||
el.autocomplete = type === 'password' ? 'off' : 'username';
|
||||
el.style.cssText = [
|
||||
'width:100%', 'box-sizing:border-box', 'margin:0 0 4px', 'padding:4px 6px',
|
||||
'background:#2a2a30', 'color:#eee', 'border:1px solid #555',
|
||||
'border-radius:4px', 'font-size:12px', 'user-select:text',
|
||||
].join(';');
|
||||
return el;
|
||||
};
|
||||
loginUserEl = mkInput('yun-xue-tang-login-user', 'text', '员工邮箱/账号');
|
||||
loginPassEl = mkInput('yun-xue-tang-login-pass', 'password', '密码');
|
||||
|
||||
const mkCheck = function (id, text) {
|
||||
const label = document.createElement('label');
|
||||
label.style.cssText = 'display:inline-flex;align-items:center;gap:4px;cursor:pointer;margin-right:10px;';
|
||||
const cb = document.createElement('input');
|
||||
cb.type = 'checkbox';
|
||||
cb.id = id;
|
||||
label.appendChild(cb);
|
||||
label.appendChild(document.createTextNode(text));
|
||||
return { label: label, cb: cb };
|
||||
};
|
||||
const rem = mkCheck('yun-xue-tang-login-remember', '记住密码');
|
||||
loginRememberEl = rem.cb;
|
||||
const auto = mkCheck('yun-xue-tang-login-auto', '自动登录');
|
||||
loginAutoEl = auto.cb;
|
||||
loginRememberEl.addEventListener('change', function () {
|
||||
if (!loginRememberEl.checked) clearSavedCreds();
|
||||
});
|
||||
|
||||
const remRow = document.createElement('div');
|
||||
remRow.style.cssText = 'margin:2px 0 4px;font-size:11px;color:#bbb;';
|
||||
remRow.appendChild(rem.label);
|
||||
remRow.appendChild(auto.label);
|
||||
|
||||
btnClearCreds = document.createElement('button');
|
||||
btnClearCreds.type = 'button';
|
||||
btnClearCreds.textContent = '清除密码';
|
||||
btnClearCreds.style.cssText = [
|
||||
'padding:1px 6px', 'cursor:pointer', 'background:#444', 'color:#eee',
|
||||
'border:1px solid #666', 'border-radius:4px', 'font-size:10px',
|
||||
].join(';');
|
||||
btnClearCreds.addEventListener('click', function () {
|
||||
clearSavedCreds();
|
||||
if (loginPassEl) loginPassEl.value = '';
|
||||
if (loginUserEl) loginUserEl.value = '';
|
||||
setStatus('已清除保存的密码');
|
||||
});
|
||||
|
||||
const loginHint = document.createElement('div');
|
||||
loginHint.textContent = '密码仅存本机(base64 混淆,非加密),公用电脑请勿勾选记住';
|
||||
loginHint.style.cssText = 'color:#d9a441;font-size:10px;line-height:1.35;margin-top:2px;';
|
||||
|
||||
loginBox.appendChild(loginUserEl);
|
||||
loginBox.appendChild(loginPassEl);
|
||||
loginBox.appendChild(remRow);
|
||||
loginBox.appendChild(btnClearCreds);
|
||||
loginBox.appendChild(loginHint);
|
||||
|
||||
labelAuto = document.createElement('label');
|
||||
labelAuto.style.cssText = 'display:flex;align-items:center;gap:6px;cursor:pointer;';
|
||||
cbAuto = document.createElement('input');
|
||||
cbAuto.type = 'checkbox';
|
||||
cbAuto.id = 'yun-xue-tang-auto-enabled';
|
||||
cbAuto.checked = state.autoPlayEnabled;
|
||||
cbAuto.addEventListener('change', function () {
|
||||
state.autoPlayEnabled = cbAuto.checked;
|
||||
try { localStorage.setItem(LS_ENABLED, cbAuto.checked ? '1' : '0'); } catch (e) {}
|
||||
setStatus(cbAuto.checked ? '自动连播已开启' : '自动连播已关闭');
|
||||
});
|
||||
labelAuto.appendChild(cbAuto);
|
||||
labelAuto.appendChild(document.createTextNode('当前课程自动连播'));
|
||||
|
||||
labelBatch = document.createElement('label');
|
||||
labelBatch.style.cssText = LABEL_CSS;
|
||||
cbBatch = document.createElement('input');
|
||||
cbBatch.type = 'checkbox';
|
||||
cbBatch.id = 'yun-xue-tang-batch-enabled';
|
||||
cbBatch.checked = S.batchRunning;
|
||||
cbBatch.addEventListener('change', function () {
|
||||
if (cbBatch.checked) {
|
||||
startBatch();
|
||||
} else {
|
||||
S.batchRunning = false;
|
||||
saveRunState();
|
||||
setStatus('列表刷课已暂停');
|
||||
}
|
||||
updatePanel();
|
||||
});
|
||||
labelBatch.appendChild(cbBatch);
|
||||
labelBatch.appendChild(document.createTextNode('课程列表自动刷课'));
|
||||
|
||||
labelShort = document.createElement('label');
|
||||
labelShort.style.cssText = LABEL_CSS;
|
||||
cbPreferShort = document.createElement('input');
|
||||
cbPreferShort.type = 'checkbox';
|
||||
cbPreferShort.id = 'yun-xue-tang-prefer-short';
|
||||
cbPreferShort.checked = state.preferShortCourses;
|
||||
cbPreferShort.title = '按课程总时长从短到长选课';
|
||||
cbPreferShort.addEventListener('change', function () {
|
||||
state.preferShortCourses = cbPreferShort.checked;
|
||||
try { localStorage.setItem(LS_PREFER_SHORT, state.preferShortCourses ? '1' : '0'); } catch (e) {}
|
||||
if (!state.preferShortCourses) {
|
||||
R.shortCatalog = null;
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = 0;
|
||||
try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) {}
|
||||
setStatus('已关闭短课程优先,按列表顺序选课');
|
||||
} else {
|
||||
R.shortCatalogFailedAt = 0;
|
||||
setStatus('已开启短课程优先:时长正序');
|
||||
}
|
||||
updatePanel();
|
||||
});
|
||||
labelShort.appendChild(cbPreferShort);
|
||||
labelShort.appendChild(document.createTextNode('优先短课程(时长正序)'));
|
||||
|
||||
statusEl = document.createElement('div');
|
||||
statusEl.id = 'yun-xue-tang-status';
|
||||
statusEl.textContent = '待机';
|
||||
statusEl.style.cssText = 'margin-top:6px;color:#8ee6c0;word-break:break-all;';
|
||||
|
||||
statsEl = document.createElement('div');
|
||||
statsEl.id = 'yun-xue-tang-stats';
|
||||
statsEl.style.cssText = 'margin-top:2px;color:#aaa;';
|
||||
|
||||
const hint = document.createElement('div');
|
||||
hint.textContent = '真实播放计时 · 保持窗口可见';
|
||||
hint.style.cssText = 'margin-top:6px;color:#777;font-size:11px;';
|
||||
|
||||
const footer = document.createElement('div');
|
||||
footer.id = 'yun-xue-tang-session-duration';
|
||||
footer.textContent = '会话时长 ' + formatElapsed(0);
|
||||
footer.style.cssText = 'margin-top:4px;color:#8ee6c0;font-size:11px;';
|
||||
footerEl = footer;
|
||||
|
||||
box.appendChild(title);
|
||||
box.appendChild(loginBox);
|
||||
box.appendChild(btnOne);
|
||||
box.appendChild(labelAuto);
|
||||
box.appendChild(labelBatch);
|
||||
box.appendChild(labelShort);
|
||||
box.appendChild(statusEl);
|
||||
box.appendChild(statsEl);
|
||||
box.appendChild(hint);
|
||||
box.appendChild(footer);
|
||||
document.documentElement.appendChild(box);
|
||||
}
|
||||
|
||||
export function ensurePanel() {
|
||||
if (window.top !== window.self) return;
|
||||
if (!document.getElementById(PANEL_ID)) buildPanel();
|
||||
updatePanel();
|
||||
}
|
||||
+604
@@ -0,0 +1,604 @@
|
||||
// ======== 播放器 ========
|
||||
import { CFG, TAG } from './config.js';
|
||||
import { R, S, state } from './state.js';
|
||||
import { norm, textOf, truncate, isVisible, findVisibleButton, collectDocuments } from './utils.js';
|
||||
import { onElement } from './lifecycle.js';
|
||||
import { setStatus, updatePanel } from './panel.js';
|
||||
import { failCurrent } from './complete.js';
|
||||
|
||||
export function applyMute(v) {
|
||||
if (!CFG.mute) return;
|
||||
try {
|
||||
if (!v.muted) v.muted = true;
|
||||
v.defaultMuted = true;
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function playVideo(v) {
|
||||
if (!v) return;
|
||||
if (state.autoPlayEnabled || S.batchRunning) {
|
||||
try {
|
||||
const p = v.play();
|
||||
if (p && typeof p.catch === 'function') p.catch(() => {});
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
}
|
||||
|
||||
export function hookVideo(v) {
|
||||
if (!v) return;
|
||||
if (v.getAttribute && v.getAttribute('data-yun-xue-tang-hooked') === '1') return;
|
||||
if (R.hooked.has(v)) return;
|
||||
R.hooked.add(v);
|
||||
try { v.setAttribute('data-yun-xue-tang-hooked', '1'); } catch (e) {}
|
||||
|
||||
applyMute(v);
|
||||
|
||||
onElement(v, 'play', function () {
|
||||
applyMute(v);
|
||||
R.lastProgressAt = Date.now();
|
||||
});
|
||||
onElement(v, 'ended', function () {
|
||||
R.lastProgressAt = Date.now();
|
||||
});
|
||||
onElement(v, 'timeupdate', function () {
|
||||
R.lastProgressAt = Date.now();
|
||||
});
|
||||
}
|
||||
|
||||
export function hookAllVideos() {
|
||||
for (const doc of collectDocuments()) {
|
||||
let vids;
|
||||
try {
|
||||
vids = doc.querySelectorAll('video, audio');
|
||||
} catch (e) {
|
||||
continue;
|
||||
}
|
||||
for (const v of vids) hookVideo(v);
|
||||
}
|
||||
}
|
||||
|
||||
export function findPlayableVideo() {
|
||||
const vids = [...document.querySelectorAll('video, audio')].filter(function (v) {
|
||||
return v.duration > 0 || v.currentSrc;
|
||||
});
|
||||
return vids.find(function (v) { return !v.paused; }) ||
|
||||
vids.find(function (v) { return isVisible(v) && v.duration > 0; }) ||
|
||||
vids.find(function (v) { return v.duration > 0; }) ||
|
||||
vids[0] || null;
|
||||
}
|
||||
|
||||
export function ensurePlaying(v) {
|
||||
if (!v) return;
|
||||
applyMute(v);
|
||||
if (S.activeCourse) {
|
||||
try {
|
||||
if (Math.abs(v.playbackRate - 1) > 0.01) v.playbackRate = 1;
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
if (!v.paused) return;
|
||||
// 已播完就交给「进度/切节」逻辑处理。
|
||||
// 平台在切到下一节后会自动挂出「还需 5分钟…」,那是下一节的时长,
|
||||
// 不能据此把已结束的视频拉回开头重播。
|
||||
if (v.ended) return;
|
||||
playVideo(v);
|
||||
}
|
||||
|
||||
// 平台完成状态有三种真实文案:
|
||||
// 多课时课程:已完成 2/3
|
||||
// 单视频/音频:已完成 0% -> 已完成 67%
|
||||
// 全部学完: 已完成学习 (此时进度条和倒计时都会消失)
|
||||
// 旧实现只认 x/y,课程真正学完后汇总变成「已完成学习」→ 永远不判完成,
|
||||
// 结果就是停在课程页、不回列表、也不进入下一门。
|
||||
export function readSummary() {
|
||||
const el = document.querySelector('[class*="course-summary"]');
|
||||
if (!el) return null;
|
||||
const t = textOf(el);
|
||||
|
||||
const m = t.match(/已完成(\d+)\/(\d+)/);
|
||||
if (m) {
|
||||
const x = Number(m[1]);
|
||||
const y = Number(m[2]);
|
||||
return {
|
||||
x: x, y: y, percent: y > 0 ? Math.round((x / y) * 100) : 0,
|
||||
complete: y > 0 && x >= y, kind: 'ratio', text: t,
|
||||
};
|
||||
}
|
||||
|
||||
const pct = t.match(/已完成(\d+)%/);
|
||||
if (pct) {
|
||||
const x = Number(pct[1]);
|
||||
return { x: x, y: 100, percent: x, complete: x >= 100, kind: 'percent', text: t };
|
||||
}
|
||||
|
||||
if (/已完成学习|学习完成|已完成本课程|已学完/.test(t)) {
|
||||
return { x: 100, y: 100, percent: 100, complete: true, kind: 'done', text: t };
|
||||
}
|
||||
|
||||
// 兜底:个别页面没有文案,只有进度条
|
||||
const bar = el.querySelector('[role="progressbar"]');
|
||||
if (bar) {
|
||||
const now = Number(bar.getAttribute('aria-valuenow'));
|
||||
const max = Number(bar.getAttribute('aria-valuemax')) || 100;
|
||||
if (Number.isFinite(now)) {
|
||||
return {
|
||||
x: now, y: max, percent: Math.round((now / max) * 100),
|
||||
complete: now >= max, kind: 'percent', text: t,
|
||||
};
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
export function readCountdown() {
|
||||
const el = document.querySelector('.yxtulcdsdk-course-player__countdown');
|
||||
if (!el) return null;
|
||||
const t = textOf(el);
|
||||
// 平台文案可能是「还需 2小时 7分钟 59秒」,也可能只剩「还需 5分钟」
|
||||
const m = t.match(/还需(?:(\d+)小时)?(?:(\d+)分钟)?(?:(\d+)秒)?/);
|
||||
if (m && (m[1] || m[2] || m[3])) {
|
||||
return Number(m[1] || 0) * 3600 + Number(m[2] || 0) * 60 + Number(m[3] || 0);
|
||||
}
|
||||
if (/已完成|学习完成|已学完/.test(t)) return 0;
|
||||
return null;
|
||||
}
|
||||
|
||||
export function readActiveLessonKey() {
|
||||
const active = document.querySelector('.yxtulcdsdk-catalog .liactive');
|
||||
if (!active) return '';
|
||||
const li = active.closest('li');
|
||||
return norm(li ? li.innerText : active.innerText);
|
||||
}
|
||||
|
||||
// 目录里「章」节点也带 .hand 且包含子 ul;只取真正的课时 li
|
||||
export function lessonItems() {
|
||||
return [...document.querySelectorAll('.yxtulcdsdk-catalog ul > li')]
|
||||
.filter(function (li) { return !li.querySelector('ul'); });
|
||||
}
|
||||
|
||||
export function findNextLessonElement() {
|
||||
const activeLi = lessonActiveLi();
|
||||
if (!activeLi) return null;
|
||||
const lis = lessonItems();
|
||||
const idx = lis.indexOf(activeLi);
|
||||
if (idx < 0 || idx + 1 >= lis.length) return null;
|
||||
// 返回 li 本身:真正的点击目标由 clickLesson 选择。以前返回内部 .hand,
|
||||
// 在真实目录里那是 <svg>,没有 click(),next.click() 会抛异常 → 切节失效。
|
||||
return lis[idx + 1];
|
||||
}
|
||||
|
||||
export function isLessonCompleted(li) {
|
||||
try {
|
||||
// 1) 状态文案:目录里的标签可能在标题前(「已学完 第1节」),也可能在标题后,
|
||||
// 不能只认结尾,否则一个都识别不出来 → 每次都退回第一节
|
||||
const text = textOf(li);
|
||||
if (/已学完|已完成/.test(text)) return true;
|
||||
|
||||
// 2) 语义属性/类名(平台改版时比 svg 路径稳定)
|
||||
const hint = [
|
||||
li.getAttribute('aria-label') || '',
|
||||
li.getAttribute('title') || '',
|
||||
String(li.className || ''),
|
||||
].join(' ');
|
||||
if (/已学完|已完成|finished|completed|is-done/i.test(hint)) return true;
|
||||
|
||||
// 3) 完成态图标:平台用一个起点 M10 2.75 的实心圆 + 对勾
|
||||
const ds = [...li.querySelectorAll('svg path')]
|
||||
.map(function (p) { return String(p.getAttribute('d') || ''); });
|
||||
return ds.some(function (d) {
|
||||
return d.replace(/,/g, ' ').indexOf('M10 2.75') >= 0;
|
||||
});
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function findFirstIncompleteLessonElement() {
|
||||
for (const li of lessonItems()) {
|
||||
if (!isLessonCompleted(li)) return li;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 暂停页面上所有媒体:平台会在课程完成后把播放器重置到 0 秒,不暂停就会又从头播一遍。
|
||||
// 逐个元素 try,单个元素 busy/已卸下时不影响其余视频。
|
||||
export function pauseAllMedia() {
|
||||
try {
|
||||
document.querySelectorAll('video, audio').forEach(function (x) {
|
||||
try { x.pause(); } catch (e) {}
|
||||
});
|
||||
} catch (e) {}
|
||||
}
|
||||
|
||||
// ---- 课时切换(对齐起点 / 纠偏时使用,带多种点击方式与校验) ----
|
||||
export function lessonActiveLi() {
|
||||
const el = document.querySelector('.yxtulcdsdk-catalog .liactive');
|
||||
return el ? el.closest('li') : null;
|
||||
}
|
||||
|
||||
// 浏览器里有布局信息;jsdom 之类的无布局环境下返回 false,避免误判“隐藏”
|
||||
export function layoutAvailable() {
|
||||
try {
|
||||
const r = document.body.getBoundingClientRect();
|
||||
return r.width > 0 && r.height > 0;
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
// 目录诊断快照:起点纠正失败时打到控制台,便于定位平台为什么不响应点击
|
||||
export function dumpCatalog() {
|
||||
return lessonItems().map(function (li, i) {
|
||||
return {
|
||||
i: i + 1,
|
||||
text: truncate(textOf(li), 36),
|
||||
active: li.classList.contains('liactive') || !!li.querySelector('.liactive'),
|
||||
done: isLessonCompleted(li),
|
||||
cls: String(li.className || '').slice(0, 48),
|
||||
};
|
||||
});
|
||||
}
|
||||
|
||||
export function fireMouse(el, type) {
|
||||
try {
|
||||
el.dispatchEvent(new MouseEvent(type, {
|
||||
bubbles: true, cancelable: true, view: window, button: 0,
|
||||
}));
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function firePointer(el, type) {
|
||||
try {
|
||||
el.dispatchEvent(new PointerEvent(type, {
|
||||
bubbles: true, cancelable: true, pointerId: 1, pointerType: 'mouse', isPrimary: true,
|
||||
}));
|
||||
} catch (e) { fireMouse(el, type.replace('pointer', 'mouse')); }
|
||||
}
|
||||
|
||||
// 目录里的展开箭头、课时状态图标都是 <svg>,而 SVGSVGElement 并没有
|
||||
// HTMLElement 的 click() 方法:直接 el.click() 会抛 TypeError 并被静默吞掉,
|
||||
// 等于“点了但什么都没发生”。任何节点都统一走这里,必要时派发鼠标事件。
|
||||
export function clickNode(el) {
|
||||
if (!el) return false;
|
||||
try {
|
||||
if (typeof el.click === 'function') {
|
||||
el.click();
|
||||
return true;
|
||||
}
|
||||
} catch (e) { /* 落到下面的事件派发 */ }
|
||||
fireMouse(el, 'click');
|
||||
return true;
|
||||
}
|
||||
|
||||
// 有些点击逻辑挂在 mousedown/pointerup 上,补一整套鼠标事件序列
|
||||
export function fireClickSequence(el) {
|
||||
if (!el) return;
|
||||
firePointer(el, 'pointerdown');
|
||||
fireMouse(el, 'mousedown');
|
||||
firePointer(el, 'pointerup');
|
||||
fireMouse(el, 'mouseup');
|
||||
clickNode(el);
|
||||
}
|
||||
|
||||
// 课时的点击句柄可能挂在标题 span、行容器、li 或右侧状态图标任意一层,
|
||||
// 这里按「由内向外」返回候选节点:点最内层标题时事件会依次冒泡到行容器和 li,
|
||||
// 能覆盖这三种常见写法;状态图标(svg)放最后作兜底。
|
||||
export function lessonClickNodes(li) {
|
||||
const title = li.querySelector('.item') ||
|
||||
li.querySelector('.yxtf-tooltip') ||
|
||||
li.querySelector('span');
|
||||
const row = li.querySelector('[class*="flex-space-between"]') || li.querySelector('div');
|
||||
const svg = li.querySelector('svg');
|
||||
return [title, row, li, svg].filter(Boolean);
|
||||
}
|
||||
|
||||
// 点击第 attempt 次切换课时,逐次换目标与事件方式:
|
||||
// 1) 标题 span 2) 标题 + 行容器 3) 完整鼠标序列(标题) 4) 行容器 + 课时自带按钮
|
||||
// 5) li 6) 状态图标 …… 避免前两次点偏后就直接放弃
|
||||
export function clickLesson(li, attempt) {
|
||||
if (!li) return;
|
||||
const nodes = lessonClickNodes(li);
|
||||
if (!nodes.length) return;
|
||||
const title = nodes[0];
|
||||
const row = nodes[1] && nodes[1] !== li ? nodes[1] : null;
|
||||
const svg = li.querySelector('svg');
|
||||
|
||||
if (attempt <= 2) {
|
||||
clickNode(title);
|
||||
if (attempt === 2 && row) clickNode(row);
|
||||
return;
|
||||
}
|
||||
|
||||
if (attempt >= 4) {
|
||||
const startBtn = [...li.querySelectorAll('button, [role="button"], span, div')]
|
||||
.find(function (el) {
|
||||
return el.children.length <= 1 && /^(开始学习|继续学习)$/.test(textOf(el));
|
||||
});
|
||||
if (startBtn) clickNode(startBtn);
|
||||
}
|
||||
|
||||
fireClickSequence(title);
|
||||
const targets = [title, row, li, svg].filter(Boolean);
|
||||
const target = targets[(attempt - 3) % targets.length];
|
||||
if (target && target !== title) fireClickSequence(target);
|
||||
}
|
||||
|
||||
// 平台切课时可能弹「确认切换/退出当前学习」,自动点掉。
|
||||
// 先只在弹层里找,避免误点页面上的其它同名按钮。
|
||||
export function confirmLessonDialog() {
|
||||
const pat = /^(确定|确认|是|切换|确定切换|继续切换|继续学习|继续观看|知道了)$/;
|
||||
const boxes = [...document.querySelectorAll(
|
||||
'.yxt-dialog__wrapper, [class*="dialog"], [class*="modal"], [role="dialog"]'
|
||||
)].filter(isVisible);
|
||||
let buttons = [];
|
||||
for (const box of boxes) {
|
||||
buttons = buttons.concat([...box.querySelectorAll('button, [role="button"]')]);
|
||||
}
|
||||
if (!buttons.length) {
|
||||
buttons = [...document.querySelectorAll('button, [role="button"]')];
|
||||
}
|
||||
for (const el of buttons) {
|
||||
if (!isVisible(el)) continue;
|
||||
if (pat.test(textOf(el))) {
|
||||
clickNode(el);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
export function findNextButton() {
|
||||
const els = [...document.querySelectorAll(
|
||||
'[class*="kng-operate"] div, [class*="kng-operate"] span, [class*="kng-operate"] button'
|
||||
)];
|
||||
for (const el of els) {
|
||||
if (textOf(el) === '下一个' && isVisible(el)) return el;
|
||||
}
|
||||
const generic = [...document.querySelectorAll('div, span, button, a')];
|
||||
for (const el of generic) {
|
||||
if (el.children.length <= 1 && textOf(el) === '下一个' && isVisible(el)) return el;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 目录里的考试课时(.tag-type 文案为「考试」)。考试不再跳过,而是自动进考试空卷交卷,
|
||||
// 所以单独提供 finder 给课程页调用。
|
||||
export function examLessonElements() {
|
||||
return lessonItems().filter(function (li) {
|
||||
const tag = li.querySelector('.tag-type');
|
||||
return !!tag && /考试/.test(textOf(tag));
|
||||
});
|
||||
}
|
||||
|
||||
// 第一个还没完成的考试课时
|
||||
export function findPendingExamLesson() {
|
||||
return examLessonElements().find(function (li) { return !isLessonCompleted(li); }) || null;
|
||||
}
|
||||
|
||||
// 课程是否包含「答题/测验/问卷」类章节(这类仍需人工,考试已改为自动交卷)
|
||||
export function courseHasQuizLesson() {
|
||||
// 没有标签课时,some() 本身就返回 false,不必先判 length
|
||||
return [...document.querySelectorAll('.yxtulcdsdk-catalog ul > li .tag-type')]
|
||||
.some(function (t) { return /答题|测验|问卷/.test(textOf(t)); });
|
||||
}
|
||||
|
||||
export function detectQuiz() {
|
||||
// 「开始考试/继续考试」由 exam.js 单独接管(自动空卷交卷),这里只留需要人工的答题类
|
||||
const pat = /^(开始答题|继续答题|提交答案|提交试卷)$/;
|
||||
for (const doc of collectDocuments()) {
|
||||
let els;
|
||||
try {
|
||||
els = doc.querySelectorAll('button, [role="button"], a');
|
||||
} catch (e) {
|
||||
continue;
|
||||
}
|
||||
for (const el of els) {
|
||||
if (pat.test(textOf(el)) && isVisible(el)) return true;
|
||||
}
|
||||
}
|
||||
const dialogs = [...document.querySelectorAll('.yxt-dialog__wrapper, [class*="dialog"]')];
|
||||
for (const d of dialogs) {
|
||||
if (!isVisible(d)) continue;
|
||||
const t = textOf(d);
|
||||
if (/开始答题|提交试卷/.test(t)) return true;
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
// 防挂机验证:平台每 10 分钟(kngConf/cheat.maxMin)弹一次,
|
||||
// 文案「已触发防挂机验证,请点击“继续学习”,否则学习将被停止」,120 秒内不点就停止计时。
|
||||
export function findAntiIdleDialog() {
|
||||
const pat = /防挂机|不要走开|学习将被停止|请点击.?继续学习/;
|
||||
let best = null;
|
||||
let bestLen = Infinity;
|
||||
for (const doc of collectDocuments()) {
|
||||
let cands;
|
||||
try {
|
||||
// 只认 dialog/modal,别把 [class*="popup"] 之类的外层容器算进来:
|
||||
// 平台会把 <body class="yxt-popup-parent--hidden"> 整个页面套进去,误判成弹窗。
|
||||
cands = doc.querySelectorAll('[class*="dialog"], [class*="modal"], [role="dialog"]');
|
||||
} catch (e) {
|
||||
continue;
|
||||
}
|
||||
for (const el of cands) {
|
||||
if (!isVisible(el)) continue;
|
||||
const t = textOf(el);
|
||||
if (t.length > 400) continue; // 包住整页的外层容器直接排除
|
||||
if (!pat.test(t)) continue;
|
||||
// 取文案最短的那层(即最内层弹窗),避免选到大 wrapper
|
||||
if (t.length < bestLen) { best = el; bestLen = t.length; }
|
||||
}
|
||||
}
|
||||
return best;
|
||||
}
|
||||
|
||||
export function findAntiIdleButton(dialog) {
|
||||
if (!dialog) return null;
|
||||
const want = /^(继续学习|我知道了|继续观看)$/;
|
||||
const pick = function (sel) {
|
||||
return [...dialog.querySelectorAll(sel)].find(function (el) {
|
||||
return want.test(textOf(el)) && isVisible(el);
|
||||
}) || null;
|
||||
};
|
||||
// 必须优先点真正的 <button>:平台的点击回调绑在 button 上,
|
||||
// 点文案相同的外层 div(如 <div class="mt24">)不会有任何反应。
|
||||
const el = pick('button') || pick('[role="button"]') || pick('a') || pick('div') || pick('span');
|
||||
if (!el) return findVisibleButton(/^(继续学习)$/);
|
||||
if (el.tagName !== 'BUTTON') {
|
||||
const inner = el.querySelector('button');
|
||||
if (inner) return inner;
|
||||
}
|
||||
return el;
|
||||
}
|
||||
|
||||
// 弹层里是滑块/拼图时脚本过不了,需要人工
|
||||
export function antiIdleNeedsHuman(dialog) {
|
||||
if (!dialog) return false;
|
||||
try {
|
||||
const cands = dialog.querySelectorAll(
|
||||
'input[type="range"], [class*="slider"], [class*="captcha"], [class*="drag-verify"], [class*="verify-slider"]'
|
||||
);
|
||||
for (const el of cands) if (isVisible(el)) return true;
|
||||
return false;
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function handleAntiIdle() {
|
||||
const dialog = findAntiIdleDialog();
|
||||
if (!dialog) return false;
|
||||
|
||||
// 先找按钮:只要弹窗里有「继续学习」就直接点,不要因为页面里别处有 canvas 就误判成滑块
|
||||
const btn = findAntiIdleButton(dialog);
|
||||
if (!btn) {
|
||||
if (antiIdleNeedsHuman(dialog)) {
|
||||
setStatus('防挂机验证需要人工完成(滑块/拼图),本课稍后重试');
|
||||
failCurrent('防挂机验证需要人工完成(滑块/拼图)');
|
||||
} else {
|
||||
setStatus('检测到防挂机验证,未找到「继续学习」按钮');
|
||||
}
|
||||
return true;
|
||||
}
|
||||
if (Date.now() - R.lastIdleClickAt < 2500) return true;
|
||||
|
||||
// 同一个弹层最多点 10 次,防止平台异常不关闭时无限点击
|
||||
const dialogText = truncate(textOf(dialog), 40);
|
||||
const sameDialog = R.idleDialogText === dialogText;
|
||||
if (sameDialog && R.idleDialogClicks >= 10) {
|
||||
if (!R.idleGaveUp) {
|
||||
R.idleGaveUp = true;
|
||||
console.warn(TAG, '防挂机验证弹层点了 10 次仍未关闭,停止点击,等待人工处理',
|
||||
String(dialog.outerHTML || '').slice(0, 800));
|
||||
setStatus('防挂机验证未能通过,等待人工处理');
|
||||
}
|
||||
return true;
|
||||
}
|
||||
R.idleDialogText = dialogText;
|
||||
R.idleDialogClicks = sameDialog ? R.idleDialogClicks + 1 : 1;
|
||||
R.idleGaveUp = false;
|
||||
|
||||
R.lastIdleClickAt = Date.now();
|
||||
R.idlePassed++;
|
||||
try { btn.click(); } catch (e) { /* ignore */ }
|
||||
console.log(TAG, '防挂机验证:已点击「继续学习」(第', R.idlePassed, '次)');
|
||||
setStatus('已通过防挂机验证(第 ' + R.idlePassed + ' 次)');
|
||||
updatePanel();
|
||||
return true;
|
||||
}
|
||||
|
||||
export function courseTitle() {
|
||||
return String(document.title || '')
|
||||
.replace(/\s*-\s*[^-]*(云课堂|云学堂)\s*$/, '')
|
||||
.trim();
|
||||
}
|
||||
|
||||
// 对齐起点:把当前课时切到「第一个未学完的课时」。
|
||||
// 返回 true = 本 tick 已处理(正在切换 / 等待确认),调用方应直接 return;
|
||||
// 返回 false = 无需对齐或已对齐,可以继续播放逻辑。
|
||||
// 成功与否以目录高亮为准(连续两个 tick 都在目标课时才算数),
|
||||
// 避免面板声称已切换、实际仍停在平台上次的位置。
|
||||
export function alignToFirstIncomplete() {
|
||||
if (!CFG.alignToFirstIncomplete || R.initialLessonChecked) return false;
|
||||
|
||||
const lis = lessonItems();
|
||||
if (!lis.length) return false; // 目录还没渲染,等下一轮
|
||||
|
||||
if (!R.phaseSince) R.phaseSince = Date.now();
|
||||
if (Date.now() - R.phaseSince < 1500) return true; // 等平台恢复完上次位置再纠正
|
||||
|
||||
const activeLi = lessonActiveLi();
|
||||
const activeIdx = activeLi ? lis.indexOf(activeLi) : -1;
|
||||
const targetLi = findFirstIncompleteLessonElement();
|
||||
const targetIdx = targetLi ? lis.indexOf(targetLi) : -1;
|
||||
|
||||
if (targetIdx < 0) {
|
||||
// 所有课时都已完成,整门课是否结束交给 summary 判断
|
||||
R.initialLessonChecked = true;
|
||||
return false;
|
||||
}
|
||||
|
||||
if (targetIdx === activeIdx) {
|
||||
// 连续两次确认已在目标课时,才算对齐成功
|
||||
R.alignStable++;
|
||||
if (R.alignStable < 2) return true;
|
||||
R.initialLessonChecked = true;
|
||||
R.lastLessonKey = readActiveLessonKey();
|
||||
console.log(TAG, '起点已对齐:第', targetIdx + 1, '节', truncate(textOf(targetLi), 24));
|
||||
setStatus('从第 ' + (targetIdx + 1) + ' 节开始:' + truncate(textOf(targetLi), 18));
|
||||
return false;
|
||||
}
|
||||
|
||||
R.alignStable = 0;
|
||||
|
||||
if (R.alignTries >= 8) {
|
||||
R.initialLessonChecked = true;
|
||||
R.alignFailed = true;
|
||||
setStatus('未能切换到第 ' + (targetIdx + 1) + ' 节,按当前位置继续');
|
||||
console.warn(TAG, '起点对齐失败:点击课时后平台未切换,目录快照:', dumpCatalog());
|
||||
return false;
|
||||
}
|
||||
R.alignTries++;
|
||||
|
||||
// 章节折叠时子课时不可点,先展开所属章节。
|
||||
// 展开箭头通常是 <svg>,必须用 clickNode 派发事件(svg 没有 click() 方法)。
|
||||
if (layoutAvailable() && !isVisible(targetLi)) {
|
||||
let ul = targetLi.parentElement;
|
||||
while (ul && ul.tagName !== 'UL') ul = ul.parentElement;
|
||||
const collapsed = ul && getComputedStyle(ul).display === 'none';
|
||||
const chapterLi = ul && ul.parentElement ? ul.parentElement.closest('li') : null;
|
||||
if (collapsed && chapterLi && R.alignTries <= 3) {
|
||||
setStatus('展开章节:' + truncate(textOf(chapterLi), 20));
|
||||
clickNode(chapterLi.querySelector('.hand') || chapterLi);
|
||||
return true;
|
||||
}
|
||||
}
|
||||
|
||||
// 切课时平台可能弹确认框,先点掉(第 1 次不查,避免误点页面上的其他「确定」)
|
||||
if (R.alignTries > 1 && confirmLessonDialog()) {
|
||||
setStatus('已确认切换提示,继续…');
|
||||
return true;
|
||||
}
|
||||
|
||||
console.log(TAG, '对齐起点:第', activeIdx >= 0 ? (activeIdx + 1) : '?', '节 → 第', targetIdx + 1, '节',
|
||||
'(第 ' + R.alignTries + ' 次)');
|
||||
setStatus('正在切换到第 ' + (targetIdx + 1) + ' 节…' +
|
||||
(R.alignTries > 1 ? '(第 ' + R.alignTries + ' 次)' : ''));
|
||||
clickLesson(targetLi, R.alignTries);
|
||||
return true;
|
||||
}
|
||||
|
||||
// 手动模式没有 S.activeCourse,用课程标题判断是否换了一门课,换课时重新对齐
|
||||
export function syncManualCourse() {
|
||||
const key = courseTitle() || location.href;
|
||||
if (R.manualCourseKey === key) return true;
|
||||
R.manualCourseKey = key;
|
||||
R.initialLessonChecked = false;
|
||||
R.phaseSince = 0;
|
||||
R.alignTries = 0;
|
||||
R.alignStable = 0;
|
||||
R.alignFailed = false;
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.waitStart = 0;
|
||||
return true;
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
// ======== 路由 ========
|
||||
import { R, S, saveRunState } from './state.js';
|
||||
|
||||
// 平台不同内容类型进入的播放页不同:
|
||||
// 多课时课程 #/course/play?kngId=… 单个视频 #/video/play?kngId=…
|
||||
// 单个音频 #/audio/play?kngId=… 单个课件 #/ppt/play?kngId=…
|
||||
// 以前只认 #/course/play,其它类型整页逻辑都不会跑(不自动播放、也不判完成)。
|
||||
// #/scan 是点开课程后的过渡页,也按课程页处理。
|
||||
export function route() {
|
||||
const h = location.hash || '';
|
||||
if (h.indexOf('#/list') === 0) return 'list';
|
||||
if (h.indexOf('#/scan') === 0) return 'course';
|
||||
if (/^#\/[a-z0-9_-]+\/play(?:[?/]|$)/i.test(h)) return 'course';
|
||||
return 'other';
|
||||
}
|
||||
|
||||
// 单媒体播放页(没有多课时目录):完成判定看进度百分比/「已完成学习」,
|
||||
// 不需要找下一节。
|
||||
export function mediaPage() {
|
||||
return /^#\/(?:video|audio|ppt|document|article)\/play(?:[?/]|$)/i.test(location.hash || '');
|
||||
}
|
||||
|
||||
// 回列表页。
|
||||
// catalogUrl 决定「刷的是哪个目录」——它同时也是短课程队列的缓存键来源,
|
||||
// 用错目录会把队列建在另一批课程上,所以这里优先用它而不是裸的 /kng/#/list。
|
||||
export function goToList(force) {
|
||||
if (!force && Date.now() - R.lastGoListAt < 5000) return;
|
||||
R.lastGoListAt = Date.now();
|
||||
const url = S.catalogUrl || location.origin + '/kng/#/list';
|
||||
if (route() === 'list') {
|
||||
S.awaitingListReturn = true;
|
||||
saveRunState();
|
||||
return;
|
||||
}
|
||||
try {
|
||||
location.href = url;
|
||||
} catch (e) {
|
||||
location.hash = '#/list';
|
||||
}
|
||||
}
|
||||
+287
@@ -0,0 +1,287 @@
|
||||
// ======== 状态 ========
|
||||
//
|
||||
// 状态分三层,持久化位置按「这条信息跨会话是否还成立」来分:
|
||||
//
|
||||
// 用户偏好(localStorage) —— state / targetCatalogUrl:跨会话、跨标签页都成立
|
||||
// 本次运行状态(sessionStorage)—— S:整页跳转要活,换标签页/重启浏览器即作废
|
||||
// 纯内存(R) —— 运行时计数器、节流时间戳:丢了自愈
|
||||
//
|
||||
// 关键约定:S.batchRunning(是否正在刷课)属于「用户/运行器的授权意图」,
|
||||
// 只活在本标签页内。这样浏览器重启、运行器重建标签页之后都必然是待机状态,
|
||||
// 必须由 runner/session.mjs 或面板显式重新开跑,不会出现「还没登录就开始刷课」。
|
||||
import {
|
||||
CFG, LS_ENABLED, LS_PREFER_SHORT, LS_TARGET_CATALOG_URL,
|
||||
SS_RUN_STATE, SS_SHORT_CATALOG, LEGACY_LS_BATCH,
|
||||
} from './config.js';
|
||||
|
||||
// ======== 用户偏好(localStorage) ========
|
||||
export const state = {
|
||||
autoPlayEnabled: true, // 当前课程自动连播(自己点开的课)
|
||||
preferShortCourses: CFG.preferShortCourses, // 列表刷课时优先后时长更短的课程(正序)
|
||||
};
|
||||
try {
|
||||
state.autoPlayEnabled = localStorage.getItem(LS_ENABLED) !== '0';
|
||||
} catch (e) { /* ignore */ }
|
||||
try {
|
||||
const v = localStorage.getItem(LS_PREFER_SHORT);
|
||||
if (v === '0' || v === '1') state.preferShortCourses = v === '1';
|
||||
} catch (e) { /* ignore */ }
|
||||
|
||||
// ======== 本次运行状态(sessionStorage) ========
|
||||
export const PHASE_ENTERING = 'entering';
|
||||
export const PHASE_LEARNING = 'learning';
|
||||
export const PHASE_IDLE = 'idle';
|
||||
const VALID_PHASES = new Set([PHASE_IDLE, PHASE_ENTERING, PHASE_LEARNING]);
|
||||
|
||||
export function defaultRunState() {
|
||||
return {
|
||||
// ---- 运行意图 ----
|
||||
batchRunning: false, // 列表刷课是否在跑(只在本标签页内有效)
|
||||
batchFinished: false, // 本轮已停止(达上限 / 重试用尽 / 无课可学)
|
||||
completedThisRun: 0, // 本轮已完成门数
|
||||
|
||||
// ---- 选课范围 ----
|
||||
// 目标目录 URL:决定「刷哪个学院/目录」的课,也是短课程队列的缓存键来源。
|
||||
// 值同时镜像到 localStorage(LS_TARGET_CATALOG_URL),所以跨会话仍然有效。
|
||||
catalogUrl: '', // 例:https://kfmic.yunxuetang.cn/kng/#/list?cid=…
|
||||
listPage: 1, // 列表页码(短课程队列不可用时是唯一的页码来源)
|
||||
|
||||
// ---- 当前课程 ----
|
||||
activeCourse: null, // { title, id, startedAt }
|
||||
coursePhase: PHASE_IDLE, // idle | entering | learning
|
||||
awaitingListReturn: false,// 刚学完/失败,正在回列表途中
|
||||
|
||||
// ---- 本轮记录 ----
|
||||
completedTitles: {}, // 课程名 -> 完成时间戳(防平台记账延迟时重进同一门)
|
||||
courseRetries: {}, // 课程名 -> { n, reason, at }(未完成重试次数)
|
||||
examEmptySubmits: {}, // 课程 id -> 空卷交卷次数(防死循环)
|
||||
};
|
||||
}
|
||||
|
||||
export const S = defaultRunState();
|
||||
|
||||
function asMap(v) {
|
||||
return v && typeof v === 'object' && !Array.isArray(v) ? v : {};
|
||||
}
|
||||
|
||||
function restoreFrom(obj) {
|
||||
if (!obj || typeof obj !== 'object') return null;
|
||||
const out = defaultRunState();
|
||||
|
||||
// ---- 运行意图:只有「同一个标签页」内的整页跳转才走到这里,可以整体接续 ----
|
||||
out.batchRunning = obj.batchRunning === true;
|
||||
out.batchFinished = obj.batchFinished === true;
|
||||
const done = Number(obj.completedThisRun);
|
||||
out.completedThisRun = Number.isFinite(done) && done >= 0 ? Math.floor(done) : 0;
|
||||
|
||||
// ---- 选课范围 ----
|
||||
out.catalogUrl = typeof obj.catalogUrl === 'string' ? obj.catalogUrl : '';
|
||||
const page = Number(obj.listPage);
|
||||
out.listPage = Number.isFinite(page) && page >= 1 ? Math.floor(page) : 1;
|
||||
|
||||
// ---- 当前课程 ----
|
||||
// learning 阶段:说明是同一标签页内的整页跳转(sessionStorage 跨跳转存活、跨标签页不存活),
|
||||
// 所以「多年前开始学的课」也是真实的,必须接续,不能用时间戳判过期。
|
||||
// entering 阶段:「正在进课」超过 15 秒就会被 failCurrent,若是重启/长时间挂起后
|
||||
// 恢复一个很旧的 startedAt,只会让 course.js 的进课宽限期立刻判过期,把正常加载
|
||||
// 误判成「课程不一致」—— 所以只有这一段才用 staleCourseMs 守门。
|
||||
const cur = obj.activeCourse;
|
||||
const startedAt = cur && Number(cur.startedAt);
|
||||
const visiblePhase = VALID_PHASES.has(obj.coursePhase) ? obj.coursePhase : PHASE_ENTERING;
|
||||
if (cur && cur.title && Number.isFinite(startedAt)) {
|
||||
const stale = Date.now() - startedAt > CFG.staleCourseMs;
|
||||
const keep = visiblePhase === PHASE_LEARNING || !stale;
|
||||
out.activeCourse = keep
|
||||
? { title: String(cur.title), id: String(cur.id || ''), startedAt }
|
||||
: null;
|
||||
out.coursePhase = keep ? visiblePhase : PHASE_IDLE;
|
||||
} else {
|
||||
out.activeCourse = null;
|
||||
out.coursePhase = PHASE_IDLE;
|
||||
}
|
||||
// 「正在回列表途中」不依赖当前课程:completeCurrent / failCurrent 会先清课程
|
||||
// 再跳回列表,若把它一起丢掉,新页面就不知道需要恢复页码。
|
||||
out.awaitingListReturn = obj.awaitingListReturn === true;
|
||||
|
||||
// ---- 本轮记录 ----
|
||||
out.completedTitles = asMap(obj.completedTitles);
|
||||
out.courseRetries = asMap(obj.courseRetries);
|
||||
out.examEmptySubmits = asMap(obj.examEmptySubmits);
|
||||
return out;
|
||||
}
|
||||
|
||||
// 旧版 localStorage 里的整块状态(yun-xue-tang-batch-v2):只挑「进度」迁移,
|
||||
// 运行意图、当前课程一律不接续。迁移完即删除,避免旧数据一直复活。
|
||||
function migrateLegacy() {
|
||||
let raw = null;
|
||||
try { raw = localStorage.getItem(LEGACY_LS_BATCH); } catch (e) { return; }
|
||||
if (!raw) return;
|
||||
try {
|
||||
const old = JSON.parse(raw);
|
||||
if (old && typeof old === 'object') {
|
||||
const done = asMap(old.done);
|
||||
// 清掉一眼过期的完成记录(超过 DONE 有效期的不再迁移)
|
||||
for (const k of Object.keys(done)) {
|
||||
const at = Number(done[k]);
|
||||
if (!Number.isFinite(at) || Date.now() - at > CFG.staleCourseMs) delete done[k];
|
||||
}
|
||||
S.completedTitles = done;
|
||||
S.courseRetries = asMap(old.retries);
|
||||
S.examEmptySubmits = asMap(old.examTried);
|
||||
const page = Number(old.listPage);
|
||||
if (Number.isFinite(page) && page >= 1) S.listPage = Math.floor(page);
|
||||
const url = typeof old.listUrl === 'string' ? old.listUrl : '';
|
||||
if (url) setTargetCatalogUrl(url, { silent: true });
|
||||
}
|
||||
console.log('[云学堂助手] 已迁移旧版本进度记录(不再恢复旧的运行状态)');
|
||||
} catch (e) { /* ignore */ }
|
||||
try { localStorage.removeItem(LEGACY_LS_BATCH); } catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
(function restore() {
|
||||
let restored = null;
|
||||
try {
|
||||
const raw = sessionStorage.getItem(SS_RUN_STATE);
|
||||
if (raw) restored = restoreFrom(JSON.parse(raw));
|
||||
} catch (e) { /* ignore */ }
|
||||
if (restored) Object.assign(S, restored);
|
||||
// 目标目录是偏好:localStorage 里的值优先,会话里没有就沿用会话内的
|
||||
S.catalogUrl = readTargetCatalogUrl() || S.catalogUrl;
|
||||
migrateLegacy();
|
||||
})();
|
||||
|
||||
// 上次写盘的快照:内容没变就不重复序列化+写入
|
||||
let lastWritten = '';
|
||||
|
||||
export function saveRunState() {
|
||||
try {
|
||||
const text = JSON.stringify(S);
|
||||
if (text === lastWritten) return;
|
||||
lastWritten = text;
|
||||
sessionStorage.setItem(SS_RUN_STATE, text);
|
||||
} catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
// 收尾/退出前强制落盘(内容没变也会写,防止 lastWritten 与实际不同步)
|
||||
export function flushRunState() {
|
||||
lastWritten = '';
|
||||
saveRunState();
|
||||
}
|
||||
|
||||
// ======== 目标目录 URL(偏好,localStorage + 会话镜像) ========
|
||||
export function readTargetCatalogUrl() {
|
||||
try { return localStorage.getItem(LS_TARGET_CATALOG_URL) || ''; } catch (e) { return ''; }
|
||||
}
|
||||
|
||||
export function setTargetCatalogUrl(url, opt) {
|
||||
const next = String(url || '');
|
||||
if (!next) return;
|
||||
const changed = S.catalogUrl !== next;
|
||||
S.catalogUrl = next;
|
||||
try { localStorage.setItem(LS_TARGET_CATALOG_URL, next); } catch (e) { /* ignore */ }
|
||||
if (changed && !(opt && opt.silent)) saveRunState();
|
||||
}
|
||||
|
||||
// ======== 运行时状态(纯内存,不持久化) ========
|
||||
export const R = {
|
||||
hooked: new WeakSet(),
|
||||
lastCardClickAt: 0,
|
||||
entryRetries: 0, // 点卡片后仍停在列表时,重试进入课程的次数
|
||||
lastPageJumpAt: 0,
|
||||
pageChangeAt: 0,
|
||||
pageChangeSig: '',
|
||||
listWithCurrentSince: 0,
|
||||
lastGoListAt: 0,
|
||||
lastStartClickAt: 0,
|
||||
lastAdvanceAt: 0,
|
||||
manualAdvanceAt: 0,
|
||||
lastLessonKey: '',
|
||||
doneLatchKey: '', // 本节已播完(倒计时归零/video.ended),防止平台把视频拉回开头重播
|
||||
lastSummary: null,
|
||||
lastCountdown: null,
|
||||
lastProgressAt: Date.now(),
|
||||
waitStart: 0,
|
||||
waitSummaryX: -1,
|
||||
waitLessonKey: '',
|
||||
quizChecked: false,
|
||||
// 考试(空卷交卷)自动处理状态
|
||||
examPhase: '', // '' | preview | paper | result
|
||||
examActionAt: 0, // 上次考试页内点击时间
|
||||
examStarts: 0, // 本形态点了多少次「开始考试」
|
||||
examSubmits: 0, // 本形态点了多少次「提交考试」
|
||||
examConfirms: 0, // 本形态点了多少次交卷确认「确定」
|
||||
examPaperAt: 0, // 进入答卷页的时间(等题目渲染)
|
||||
examLeaving: false, // 已交卷,正在返回课程页
|
||||
examLessonAt: 0, // 上次点「考试节」的时间(防抖)
|
||||
examLessonTries: 0, // 本次进考试节已点次数
|
||||
examLessonKey: '', // examLessonTries 所属课程(换课重置,同课重进保留)
|
||||
initialLessonChecked: false,
|
||||
phaseSince: 0,
|
||||
alignTries: 0,
|
||||
alignStable: 0,
|
||||
alignFailed: false,
|
||||
manualCourseKey: '',
|
||||
lastIdleClickAt: 0,
|
||||
idlePassed: 0,
|
||||
idleDialogText: '',
|
||||
idleDialogClicks: 0,
|
||||
idleGaveUp: false,
|
||||
pageRestoreAttempts: 0,
|
||||
retryWaitUntil: 0, // 重试退避的结束时间(未到点不进课)
|
||||
retryTitle: '', // 正在等待重试的课程名(面板提示用)
|
||||
loginFilled: false,
|
||||
loginSubmittingAt: 0,
|
||||
loginAutoTried: false,
|
||||
loginBoundUser: null,
|
||||
loginBoundPwd: null,
|
||||
// 短课程优先:课程时长队列(只在当前标签页会话内缓存)
|
||||
shortCatalog: null,
|
||||
shortCatalogLoading: false,
|
||||
shortCatalogFailedAt: 0,
|
||||
shortFetchStartedAt: 0,
|
||||
shortJumpAt: 0,
|
||||
shortNoVmSince: 0,
|
||||
shortWarnedAt: 0,
|
||||
retryStatusSec: -1, // 「等待重试」提示上次写出的剩余秒数(只在变化时刷状态)
|
||||
};
|
||||
|
||||
// 丢掉时长队列缓存:下一次选课会重新调列表接口,拿平台实时的
|
||||
// 未学完/已完成状态,而不是用本地旧快照。
|
||||
// 放在 state.js 而不是 list.js,是为了避开 complete.js <-> list.js 的循环引用。
|
||||
export function invalidateShortCatalog() {
|
||||
R.shortCatalog = null;
|
||||
R.shortCatalogLoading = false;
|
||||
R.shortCatalogFailedAt = 0;
|
||||
R.shortNoVmSince = 0;
|
||||
try { sessionStorage.removeItem(SS_SHORT_CATALOG); } catch (e) { /* ignore */ }
|
||||
}
|
||||
|
||||
export function resetCourseRuntime() {
|
||||
R.lastLessonKey = '';
|
||||
R.doneLatchKey = '';
|
||||
R.lastSummary = null;
|
||||
R.lastCountdown = null;
|
||||
R.lastProgressAt = Date.now();
|
||||
R.waitStart = 0;
|
||||
R.waitSummaryX = -1;
|
||||
R.waitLessonKey = '';
|
||||
R.quizChecked = false;
|
||||
R.examPhase = '';
|
||||
R.examActionAt = 0;
|
||||
R.examStarts = 0;
|
||||
R.examSubmits = 0;
|
||||
R.examConfirms = 0;
|
||||
R.examPaperAt = 0;
|
||||
R.examLeaving = false;
|
||||
// 注意:examLessonAt / examLessonTries 不在这里清。交卷后 backToCourse() 会重进同一门课,
|
||||
// 若清掉冷却就会立即重复点考试节,形成循环。它们在下一次 init() 进入新课时自然重置。
|
||||
R.initialLessonChecked = false;
|
||||
R.phaseSince = 0;
|
||||
R.alignTries = 0;
|
||||
R.alignStable = 0;
|
||||
R.alignFailed = false;
|
||||
R.manualCourseKey = '';
|
||||
R.lastAdvanceAt = 0;
|
||||
R.pageRestoreAttempts = 0;
|
||||
R.entryRetries = 0;
|
||||
}
|
||||
@@ -0,0 +1,78 @@
|
||||
// ======== 基础工具 ========
|
||||
export const norm = (s) => String(s || '').replace(/\s/g, '');
|
||||
export const truncate = (s, n) => (s.length > n ? s.slice(0, n) + '…' : s);
|
||||
|
||||
export function textOf(el) {
|
||||
try {
|
||||
return norm(el.innerText || el.textContent || '');
|
||||
} catch (e) {
|
||||
return '';
|
||||
}
|
||||
}
|
||||
|
||||
export function isVisible(el) {
|
||||
try {
|
||||
const win = (el.ownerDocument && el.ownerDocument.defaultView) || window;
|
||||
const r = el.getBoundingClientRect();
|
||||
if (r.width === 0 || r.height === 0) return false;
|
||||
const cs = win.getComputedStyle(el);
|
||||
return cs.display !== 'none' && cs.visibility !== 'hidden' && Number(cs.opacity) > 0;
|
||||
} catch (e) {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
export function findVisibleButton(re) {
|
||||
const els = document.querySelectorAll('button, [role="button"], a');
|
||||
for (const el of els) {
|
||||
if (re.test(textOf(el)) && isVisible(el)) return el;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 平台的「开始学习/继续学习」多数是 <button>,但个别页面把点击句柄放在
|
||||
// 文案 span 或外层 div 上。按由外到内找不到时,再找最内层的纯文字节点,
|
||||
// 点击会冒泡到真正的句柄。只认可见且没有兄弟文字干扰的最内层节点。
|
||||
export function findVisibleClickable(re) {
|
||||
const btn = findVisibleButton(re);
|
||||
if (btn && !btn.disabled) return btn;
|
||||
const els = document.querySelectorAll('div, span');
|
||||
for (const el of els) {
|
||||
if (el.children.length > 0) continue;
|
||||
if (!isVisible(el) || !re.test(textOf(el))) continue;
|
||||
if (el.closest && el.closest('button[disabled]')) continue;
|
||||
return el;
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
// 从播放页 URL 里取课程 id:进课过渡页(#/scan)和真正的播放页
|
||||
// (#/course/play、#/video/play…)都带 kngId。
|
||||
export function courseIdFromUrl() {
|
||||
const m = String(location.hash || '').match(/[?&]kngId=([^&]+)/);
|
||||
if (!m) return '';
|
||||
try { return decodeURIComponent(m[1]); } catch (e) { return m[1]; }
|
||||
}
|
||||
|
||||
// 课程标题的「占位文案」:SPA 切换时页面标题会短暂变成这些通用词。
|
||||
// 用它区分「真的课程名」和「还没加载出来的兜底文案」,避免把兜底文案
|
||||
// 当成课程名写进 done/failed 记录(否则下次会重复进入同一门课)。
|
||||
const GENERIC_TITLE_RE = /^(loading|加载中|在线课堂|云课堂|云学堂|江丰云课堂|课程详情|课程|首页|我的学习)$/i;
|
||||
|
||||
export function isGenericCourseTitle(t) {
|
||||
return !norm(t) || GENERIC_TITLE_RE.test(norm(t));
|
||||
}
|
||||
|
||||
export function collectDocuments(win, out) {
|
||||
win = win || window;
|
||||
out = out || [];
|
||||
try {
|
||||
if (win.document) out.push(win.document);
|
||||
} catch (e) { /* 跨域 */ }
|
||||
try {
|
||||
for (let i = 0; i < win.frames.length; i++) {
|
||||
collectDocuments(win.frames[i], out);
|
||||
}
|
||||
} catch (e) { /* 跨域 */ }
|
||||
return out;
|
||||
}
|
||||
File diff suppressed because it is too large.
Load diff
Reference in new issue
Block a user