 voidandClaude Sonnet 4.6
|
f41fc72fe2
|
fix: 移除课程门数上限,避免与每日积分目标冲突
maxCourses 按整门课计数,而积分按课时计;只剩考试的课会白占名额,
曾出现 5 门用光但今日视频积分只拿到 1/3 就停止的情况。现在只由
今日积分完成、没有可学内容或 budgetMinutes 决定收尾。
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
2026-11-02 19:36:57 +08:00 |
|
 voidandClaude Sonnet 4.6
|
0eb4c40629
|
feat: 每日积分模式与 Bark 完成提醒
- 按课时类型计分:文档 1 / 视频 3 / 音频 2 / 微课 2,每次 3 分,单日封顶 24 分;满额换类,无内容即停
- 积分计数落 localStorage,跨刷新/重启保留、跨天清零;面板与无头 TUI 都显示今日积分
- 运行器自己收尾时通过 Bark 推送今日积分、完成门数、用时和结束原因;手动停止与 --check 不推送
- 新增 --points-mode / --bark-* 参数及对应 YUN_XUE_TANG_* 环境变量
- 补充 points / notify 离线回归测试与 OpenSpec 配置
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
|
2026-11-01 22:19:52 +08:00 |
|
void
|
17217dbeb1
|
feat: 考试结果页去重与跳课,构建镜像脚本支持国内换源
考试:
- 新增 src/exam-plan.js(纯函数)判定结果页处置:只有本页确实点过
「提交考试/确定交卷」才算一次空卷交卷,平台恢复的旧结果页先回
「考试说明页」重进,不再在结果页和课程页之间空转
- 重试也不会好的确定性失败(交卷次数到上限、说明页无「开始考试」、
答卷页无「提交考试」、结果页反复回退)改为本轮跳过该课继续下一门,
记录在 S.skippedCourses(sessionStorage),不会停下整轮刷课
- 新一轮开跑时清空 skippedCourses / examEmptySubmits,人工处理后可重试
- 补 dev/tests/exam-test.mjs(npm run test:exam,5 条用例)
构建:
- 新增 scripts/build-docker.mjs/.cmd/.sh(npm run docker:build):
国内换源、按包版本打标签、构建后自检、--dry-run
- Dockerfile 增加 APT_MIRROR / NPM_REGISTRY 构建参数,
docker-compose.yml 透传三个 build args,.env.example 补说明
|
2026-10-29 21:31:45 +08:00 |
|
void
|
b588b1042f
|
feat: 无头运行器 Docker 镜像
把 runner/ 打包成可直接部署的容器镜像,Linux 服务器 / 群晖 / 云主机上
不用再手动装 Node 与浏览器。
- Dockerfile:node:22-bookworm-slim + 官方 google-chrome-stable。
刻意不用发行版 chromium —— 它不带 H.264/AAC 专有编解码器,课程视频会
一直停在 0 秒;同时满足 preflight.mjs 对 Node 22+ 的硬性要求。
构建期完成 npm ci + npm run build,并实跑一次 headless 验证浏览器可用;
CHROME_DEB_URL 构建参数供国内换镜像源。
- docker/entrypoint.sh:建 profile / 日志目录;首参为 sh/node 等时直接 exec
便于排查;无参数且无凭据时降级成 --check,避免容器无意义重启空转。
- docker-compose.yml:挂载 ./.run-profile 与 ./run-logs,shm_size 512m,
init: true,日志轮转。restart 用 on-failure:3 而非 always —— 运行器刷完课
会以 0 正常退出,always 会造成「刷完 → 重启 → 再刷完」的热循环。
- .dockerignore:排除 node_modules / .run-profile / run-logs / .env,
凭据不进镜像层。
- .env.example:账号模板;.gitignore 加 !.env.example 白名单。
- .gitattributes:*.sh / Dockerfile / docker-compose.yml 强制 LF —— 带 CRLF
时 shebang 会变成 "/bin/sh\r",容器启动直接 exec format error。
- scripts/check.mjs:静态检查扩展到容器入口,跑 sh -n 并对 CRLF 报错
(Windows 无 sh 时只校验行尾)。29 个文件全绿。
- README:新增「容器(Docker)」小节,含 build / 自检 / run / compose 流程
与 8 条注意事项(卷权限、/dev/shm、沙箱、验证码、时区、退出码与重启策略)。
|
2026-10-26 22:02:08 +08:00 |
|
void
|
65bf63ea6a
|
feat: v2.9.0 终端实时面板,学习时长与学分统计
新增 runner/tui.mjs(~470 行):前台运行时自动开一块实时面板,
框线布局显示状态 / 课程 / 学时 / 课时 / 视频进度条 / 进度 / 最近日志。
- 学习统计 runner/study.mjs:只累计视频真在播的时长(暂停、重试退避、
页面加载都不计),学分按课程去重(重试 / 刷新不重复计)
- 页面侧新增 credit 快照:平台只把本门学分写在倒计时文案里,
学完文案就消失,所以边播边记
- log.mjs 增加 setConsoleSink:面板接管终端那一路,日志文件仍是纯文本
- 面板里按 q 等价 Ctrl+C,走 stop.request 同一条优雅收尾路径
- 尺寸自适应:宽度跟随终端(不封顶 120 列),无 resize 事件的平台
靠定时刷新发现尺寸变化;变窄时按旧帧在新宽度下的折行数回退光标,
折完超过窗口高就整屏重置;宽度 / 高度不足按重要性丢字段
- 非 TTY(重定向 / 管道 / 计划任务 / --check)自动降级为逐行日志,
不写 ANSI 控制字符;--no-tui / YUN_XUE_TANG_TUI=0 可手动关闭,
--no-color / NO_COLOR 关颜色
- 监控轮询从 2000ms 调到 1000ms,与面板刷新对齐
- supervisor 收尾时先收面板再逐行打退出日志,并汇总本次学习时长 / 学分
- check.mjs 增加裸 CR 检查:脚本里的 config\runner 曾被写成裸 CR,
变成 config<CR>unner 导致找不到配置文件
自测:npm run test:tui(渲染 / 列宽 / 极端尺寸)、npm run test:study(假时钟口径)
|
2026-10-26 21:49:13 +08:00 |
|
void
|
c1e883d67f
|
refactor: 重组目录结构,脚本收进 scripts/,配置独立成 config/
根目录原来平铺了构建脚本、运行器配置、两个 .cmd 启动器和一份中文名的
实跑报告,四类东西混在一起,新人分不清哪个是源码、哪个是产物。这次按
职责分层重排:
- 构建与检查脚本收进 scripts/:build.mjs、check.mjs
- 一键启动器收进 scripts/:start-headless.cmd、start-dev.cmd
- 运行器配置独立成 config/runner.config.mjs(日常调参不用重新 build)
- 真机测试收进 dev/tests/:real-cdp / real-test / real-e2e / real-run
- 运行报告改成 ASCII 名并移入 docs/reports/run-report-v203.md
- v2.0.x 时期的 7 份原始抓取片段归档到 docs/archive/v2.0-snapshots/,
docs/evidence/ 只留当前版本的有效证据
- 测试每次重新生成的 3 张截图(e2e-01-after-login、e2e-02-playing、
real-chrome-login)移出仓库并加入 .gitignore,改写到 .run-tmp/screenshots/;
docs/screenshots/ 只保留手工挑选的 5 张展示图
路径修正:build.mjs 的 ROOT 上跳一级;dev/tests/ 四个脚本 ROOT 上跳两级、
对 runner/browser.mjs 的引用改 ../../;runner/config.mjs 默认配置文件路径改
config/runner.config.mjs;两个 .cmd 的 cd 改为仓库根、start-dev.cmd 指向
dev/serve.mjs;package.json 全部 npm scripts 同步;README、dev/README、证据
文件与源码注释里的路径一并更新。
顺带修掉测试里硬编码的 v2.7.0 断言:版本号改为从 package.json 读取。
验证:npm run build(104798 字节 / 102.3 KB)、npm run check(24/24)、
npm run test:real:headless(24/24 通过)。
|
2026-10-25 23:21:59 +08:00 |
|
void
|
ae117222df
|
feat: v2.8.0 无头运行器、考试自动交卷、改为退避重试不跳课
新增无头运行能力,解决 Linux 无图形化服务器上无法常驻的问题;同时改掉
"遇到考试课/无进展课就跳过"的策略,改为在同门课上退避重试。
- runner/:自己起无头 Chromium,用 CDP 把构建产物注入页面主世界(等价
@grant none),不装插件、不需要桌面环境或 Xvfb;含浏览器探测与启动参数、
持久化 profile、陈旧 SingletonLock 清理、优雅退出、日志轮转、启动预检
- runner.config.mjs / start-headless.cmd:通用配置 + Windows 一键入口;
凭据只走 YUN_XUE_TANG_USR / YUN_XUE_TANG_PWD 环境变量
- src/exam.js:含考试章节的课程自动进考试 → 开始/继续 → 空卷提交 → 确定,
交卷后靠平台记账推进课程;maxExamTries 限制同门课交卷次数,防不记账时死循环
- 去掉跳过与黑名单:没学完就退避重试(30s 起翻倍,最长 5 分钟),
同门课超过 maxCourseRetries 次才停整轮并提示,替代原 maxConsecutiveFailures
- 每完成一门都重新拉列表接口取平台实时状态再选下一门,避免用陈旧队列
- 学习进度改存 sessionStorage(yun-xue-tang-run-state-v3),整页跳转/刷新可续;
运行开关不跨会话,浏览器重启后必须显式开跑
- dev/:新增 real-cdp / real-run / real-test / real-e2e 实跑脚本与 check.mjs
统一静态检查(JS 22 + 批处理 2),替代逐文件 node --check
- docs/evidence/headless-linux-evidence.txt + 实跑截图,README 补无头部署章节
|
2026-10-25 23:04:40 +08:00 |
|
void
|
8193326b70
|
refactor: 拆分 src/ 模块并接入 esbuild 构建
把单文件脚本拆成 src/ 下 13 个 ES 模块,用 esbuild 打回同名 .user.js,
产物文件名不变,dev/ 热加载链路无需改动。
- build.mjs:esbuild 打包(--watch / --minify),版本号只从 package.json
读取,同时替换 meta.js 的 @version 与 config.js 的 VERSION
- 统一版本号来源,消除 package.json / meta.js / config.js 三处手写
- 补回 'use strict'(esbuild IIFE 默认不带,属真实行为回归)
- 清理重复实现:pauseAllMedia、listData、shortQuery、drain、clearPending、
cbAuto 模块级引用、共用 cssText
- 去掉搬代码时残留的 IIFE 缩进、死字段、二次兜底默认值、过期注释
- README / dev/README 同步构建流程与目录结构
行为无变化,仅 src/config.js 的 CFG 改成构建期注入版本号。
|
2026-10-24 22:45:27 +08:00 |
|
void
|
8200bfa0c5
|
feat: v2.7.0 单视频课程自动播放、学完自动转下一门,并加入短课程优先
脚本 v2.5.1 → v2.7.0 的三批改动合并提交:
- 起点对齐(v2.5.2):进课后先对齐到「第一个未学完的课时」,再顺序往下学;
切换成功以目录高亮为准,失败如实提示「未能切换」
- 优先短课程(v2.6.0):批量按列表接口的 studyHours 正序跨页选课,先学短课;
接口不可用时依次降级为「当前页时长正序」「原列表顺序」;面板可随时关闭,
开关存 localStorage(yt-prefer-short),队列缓存放在 sessionStorage
- 多播放页识别(v2.7.0):除 #/course/play 外,识别 #/video/play、#/audio/play、
#/ppt/play、#/document/play、#/article/play 与过渡页 #/scan,
单视频/音频课程同样自动点「开始学习」,不再停在 entering
- 完成判定(v2.7.0):readSummary() 同时解析「已完成 x/y」「已完成 N%」
「已完成学习」,并支持 progressbar 的 aria-valuenow 兜底;整门课完成即回列表
选下一门,不再停在已完成页把视频从头重播
- 稳定性:新增 entryGraceMs(30s)避免慢加载被误判为课程不一致;
startClickCooldownMs 从 15s 缩短到 3s,未起播可及时补点
- 文档:README 补充新能力、配置项与存储键;运行报告标注 v2.7.0;
新增 align-start / short-course / completion-next 三份实跑证据与面板截图
|
2026-10-22 23:04:40 +08:00 |
|
void
|
7d6493bca5
|
chore: 初始化仓库并清理项目
- 新增 .gitignore / .gitattributes:忽略 .run-tmp、依赖与系统/编辑器文件,统一换行符
- 删除 .run-tmp(约 460 MB 浏览器配置目录与一次性调试脚本),
将实跑报告引用的日志与截图移入 docs/evidence、docs/screenshots
- 新增根 README(安装、配置、开发、隐私与已知限制)与 package.json(npm run dev / check)
- 整理 courseTick 步骤编号,移除未使用的 CFG.resumeOnPause / CFG.nextDelayMs
- 修正热加载器描述与实跑报告中的旧文件名、失效的 .run-tmp 链接
|
2026-10-20 22:53:24 +08:00 |
|