用途：在包含静态 HTML 文件、生成的前端产物或独立模板（如 wwwroot/、dist/ 等目录）的 .NET 仓库中，建立一条聚焦的 HTMLHint 命令行检查门禁，用于 HTML 结构检查、无效属性检测和基础 DOM 质量校验。
主要能力：通过 HTMLHint 对静态 HTML 做正确性与轻量策略检查；可针对源文件、构建产物或已部署 URL 运行；支持在 package.json 中添加窄范围脚本，例如 htmlhint "dist//*.html" 或 htmlhint "wwwroot//*.html"；支持 .htmlhintrc 配置与规则覆盖。
使用方式：先确认目标类型（静态源文件、dist/ 等构建输出、或可访问 URL）；优先仓库本地安装与提交配置，命令为 npm install --save-dev htmlhint；可用 rg --files -g 'package.json' -g '.htmlhintrc*' -g '.html' 与 rg -n '"htmlhint"' --glob 'package.json' . 检测现状；验证命令如 npx htmlhint "dist/**/.html" 或 npx htmlhint https://example.com；将可重复命令写入 AGENTS.md 与 package.json。
适用场景：需要独立于 JS、CSS 和整站运行时审计的窄 HTML 门禁；部署前检查生成的 HTML；对已渲染或已发布输出做结构校验。
限制：不适用于含服务端指令的原始 .cshtml 或 .razor 源码，应改为检查渲染或发布后的输出；不负责 JavaScript/TypeScript 检查（交由 dotnet-eslint），也不覆盖运行时性能、可访问性、SEO 或响应头（交由 dotnet-webhint）。URL 检查可能因认证、SPA 路由或环境漂移而失败；Razor、Blazor 等模板语法会造成解析噪声，属于目标选择问题。大量琐碎属性警告通常说明配置来自其他技术栈，需按仓库实际 HTML 约定调整。若仓库 HTML 主要为服务端渲染模板，应返回 status: not_applicable。