微小团队只需守住结构合法性、可访问性底线、跨端兼容性锚点三类必卡点；pre-commit仅校验暂存区HTML文件，CI检查构建产物dist/，VS Code实时标红并提供带模板的修复建议。
微小团队不需要复杂规则，只要守住三类必卡点：结构合法性、可访问性底线、跨端兼容性锚点。其他全是干扰项。
pre-commit 钩子只扫本次修改的 HTML 文件
全量扫描 src/ 下所有 .html 会拖慢提交，新人直接关掉 husky。必须只检查 git status 中标记为 modified / added 的 HTML 文件。
- 用
git diff --cached --name-only --diff-filter=ACM 提取暂存区里的 HTML 路径
- 配合
html-validate（不是 htmlhint）执行：npx html-validate --config .htmlvalidate.json $STAGED_FILES
- 配置里只开三条 error 级规则：
"require-title"、"require-alt-attribute"、"no-duplicate-id"
- 避免用
--fix 自动修复——它可能重排属性顺序，引发无意义 diff；只做 --check 阻断
CI 流水线中验证构建产物而非源码
源码没问题，不代表 dist/ 里没被插件吃掉
html-ppt-to-pdf
将使用 `` 约定的 HTML 幻灯片转换为高保真、矢量文本 PDF（使用 Playwright + Chromium 原生 PDF 功能）。
下载
或删掉 <meta charset>。W3C Validator 只能扫静态文件，而真实问题出在构建链路末端。
<ul>
<li>在 GitHub Actions 的 deploy 步骤前加：<code>npm run build && npx html-validate dist/**/*.html</code>
</li>
<li>重点检查：<code>strings.Contains(htmlBody, "<title>")</title></code>、<code>strings.Contains(htmlBody, 'charset="utf-8"')</code>、<code>!strings.Contains(htmlBody, "style=")</code>
</li>
<li>不要用 jsdom 或 cheerio——冷启动延迟高、内存占用大；<code>htmlq</code> 更轻：<code>htmlq 'head title' dist/index.html</code> 就够</li>
<li>若检测失败，返回 HTTP 500 并附带行号快照，不合并 PR</li>
</ul>
<h3>VS Code 编辑器内实时标红 + 修复建议</h3>
<p>非前端成员（如运营改 landing page）不会看 CLI 报错，必须让错误出现在保存瞬间，且带上下文修复指引。</p>
<p><span>立即学习</span>“<a href="https://pan.quark.cn/s/cb6835dc7db1" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">前端免费学习笔记（深入）</a>”；</p>
<ul>
<li>VS Code settings.json 中启用：<code>"html.validate.scripts": true</code>、<code>"html.suggest.html5": true</code>
</li>
<li>安装 HTMLHint 插件，但配置仅启用：<code>"tag-pair": true</code>、<code>"attr-value-double-quotes": true</code>、<code>"id-class-value": "dash"</code>
</li>
<li>错误提示不能只写“Missing alt”，要定位到具体节点并给模板：<code><img src="logo.svg"> → <img src="logo.svg" alt="公司 logo"></code>
</li>
<li>禁用全局 Prettier 配置：<code>"prettier.resolveGlobalModules": false</code>，防止本地格式化覆盖项目规则</li>
</ul>
<p>最容易被忽略的是动态渲染场景：React 的 <code>dangerouslySetInnerHTML</code> 或服务端模板注入的内容，不会出现在源码里，却会污染最终 DOM。红牌检查必须在 hydration 完成后执行，否则 <code>aria-label</code> 缺失这类问题永远漏检。</p>
