应使用Docker做远程HTML质量校验，因其能统一Node.js/Python版本、避免CI环境工具缺失、兼容Vue/React等现代框架语法，确保校验结果可复现、可审计；推荐tidy或html-validate工具，并通过RUN链串联实现失败中断构建。
为什么不用本地校验，而要用 Docker 做远程 HTML 质量校验
本地跑 htmlhint 或 tidy 看似简单，但实际在团队协作中会暴露三个硬伤：不同成员 Node.js / Python 版本不一致导致规则启用差异；CI 机器上缺失全局 CLI 工具或配置文件路径错位；HTML 模板混用 Vue/React 的 JSX 或 Svelte 语法时，标准校验器直接报错或漏检。Docker 把校验环境“钉死”在镜像里，所有节点执行同一套二进制、同一组规则、同一份配置，结果可复现、可审计。
选哪个工具？htmlhint vs. tidy vs. custom validator
别直接抄网上教程装 htmlhint —— 它对现代前端框架的模板支持弱，且默认规则集松散。真正适合远程统一校验的是：tidy（稳定、支持 HTML5、能输出 JSON）或轻量封装的 html-validate（支持自定义插件、兼容 ESLint 生态）。tidy 更适合纯静态站点或 CMS 输出校验；html-validate 更适合 Vue/React 项目，但需额外安装 @html-validate/vue 插件。
-
tidy：用apt install -y tidy安装，命令简洁：tidy -q -e -asxhtml index.html -
html-validate：需npm install -g html-validate，规则靠.htmlvalidate.json控制，支持--output-format json - 避免用
validator.nu的在线服务 —— 远程校验必须离线运行，不能依赖外网 API
Dockerfile 中如何嵌入 HTML 校验并让失败中断构建
关键不是“能跑”，而是“跑不过就停”。把校验写进 RUN 链，且用 && 串连，任何一条失败整个构建终止：
RUN apt-get update && \
apt-get install -y tidy && \
find ./src -name "*.html" -exec tidy -q -e {} \; && \
echo "✅ HTML syntax OK"
注意三点：
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
立即学习“前端免费学习笔记（深入）”；
- 不要用
|| true吞掉错误 —— 这会让失败静默通过 -
find路径要匹配你项目结构，比如 Vue 项目通常是./public或./dist - 如果用
html-validate，务必在COPY之后再安装和运行，否则找不到.htmlvalidate.json
怎么让校验结果可被 CI 提取和展示
远程校验的价值在于反馈闭环。只打印终端日志没用，得生成机器可读报告：
- 对
tidy：加-f /tmp/tidy-report.txt输出错误列表，再用cat /tmp/tidy-report.txt供 CI 解析 - 对
html-validate：用--output-file /tmp/report.json --output-format json，CI 可直接用 jq 提取 error count - 别把报告写进最终镜像 —— 用多阶段构建，在 builder 阶段生成报告，copy 到 host 后清理，保持 runtime 镜像干净
最易被忽略的是校验范围边界：HTML 文件可能藏在 templates/、email/、docs/ 多个目录，find 不写全路径就会漏检；另外，Webpack/Vite 构建产物里的 HTML（如 dist/index.html）必须在校验前已存在，否则 find 找不到任何文件，校验就形同虚设。
