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、沙箱、验证码、时区、退出码与重启策略)。
This commit is contained in:
void committed 2026-10-26 22:02:08 +08:00
1 parent 65bf63ea6a
commit b588b1042f
9 files changed
+319 -4

No files matched your search

+26
View File
@@ -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
+4
View File
@@ -0,0 +1,4 @@
# 复制成 .env 后填自己的账号密码(.env 已在 .gitignore 里,不会入库)
# 凭据只认这两个变量,不能写进 config/runner.config.mjs
YUN_XUE_TANG_USR=
YUN_XUE_TANG_PWD=
+5
View File
@@ -5,6 +5,11 @@
*.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
+2
View File
@@ -23,5 +23,7 @@ desktop.ini
# ---- 本地私有配置(不要提交账号信息) ----
.env
.env.*
# 模板要入库:只有它不含真实凭据
!.env.example
# 个人临时覆盖用的运行器配置(仓库里的 config/runner.config.mjs 保持通用)
runner.local.mjs
+97
View File
@@ -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 []
+64
View File
@@ -74,6 +74,7 @@ Tampermonkey 用户脚本。支持多课时课程与单视频/音频课程;含
| 环境 | 说明 |
| --- | --- |
| Linux 服务器 | 机房机器、云主机、容器;root 运行、`/dev/shm` 只有 64MB 都自动适配 |
| Docker 容器 | 自带官方 Chrome 与 Node 22,镜像内已完成构建;见下方「容器(Docker)」 |
| Windows 桌面 | 后台挂着跑;关掉控制台窗口或 `Ctrl+C` 都能让它收尾 |
| Windows 服务器核心版 / 无桌面 | 无交互桌面也能跑(Chromium 无头不需要窗口站) |
| Windows 服务 / 计划任务 Session 0 | 会检测到 `SESSIONNAME=Services` 强制无头,`headless: false` 被忽略 |
@@ -300,6 +301,63 @@ export default {
| 计划任务里一起床就退出 | 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`。
@@ -323,6 +381,11 @@ Windows 下也可以直接双击 [`scripts/start-dev.cmd`](scripts/start-dev.cmd
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 头 + 用法注释
@@ -361,6 +424,7 @@ runner/ 无头运行器(Linux / Windows,无图形
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 里的薄加载器
+54
View File
@@ -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"
+39
View File
@@ -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 "$@"
+28 -4
View File
@@ -19,7 +19,7 @@ import { fileURLToPath } from 'node:url';
const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
/** 要遍历的目录(JS 与 bat 一起收;scripts/ 也在里面,含本文件自己) */
const DIRS = ['runner', 'dev', 'scripts', 'config'];
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']);
@@ -29,7 +29,7 @@ function walk(dir, out = []) {
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$/i.test(ent.name)) {
} else if (/\.m?js$|\.cmd$|\.bat$|\.sh$/i.test(ent.name)) {
out.push(p);
}
}
@@ -38,11 +38,13 @@ function walk(dir, 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);
}
}
@@ -110,10 +112,32 @@ for (const file of cmdTargets.sort()) {
}
}
const total = jsTargets.length + cmdTargets.length;
// ---- 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 + ')');
+ '(JS ' + jsTargets.length + ' · 批处理 ' + cmdTargets.length
+ ' · 容器入口 ' + shTargets.length + (hasSh ? '' : '(当前环境无 sh,仅校验行尾)') + ')');