html监控必须结合性能分析，仅知“解析完”无意义；需用performanceobserver捕获longtask、打标测量、处理spa路由、识别结构异常、优化解析器配置、监控内存泄漏及流式解析隐患，并对齐三层时间轴。
HTML 监控本身不强制依赖性能分析，但脱离性能分析的 HTML 监控基本无效——你只能知道“解析完了”，却不知道“为什么慢”“卡在哪”“谁拖垮了首屏”。
HTML 解析监控必须绑定 PerformanceObserver
只监听 gumbo_parse() 或 htmlparser2.parse() 的函数耗时，会漏掉关键瓶颈：比如 DOM 构建阻塞、内存分配抖动、或嵌套过深导致的递归栈溢出。真实瓶颈往往不在 parser 主循环，而在后续树操作或事件触发阶段。
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。
- 用
PerformanceObserver订阅longtask类型，捕获主线程连续执行 >50ms 的任务，这是比 FPS 更可靠的卡顿信号 - 对每个解析任务打标记：
performance.mark('parse-start')和performance.mark('parse-end')，再用performance.measure()关联，避免被 JS 执行干扰时间计算 - 单页应用中，
navigation类型记录只在首次加载有效；后续路由需手动触发performance.navigation().type === 1模拟判断，否则 FCP/LCP 无法归因
HTML 内容结构异常会直接污染性能指标
一个未闭合的 <table> 标签会让 Gumbo 或 <a style="color:#f60; text-decoration:underline;" title="html" href="https://m.php.cn/zt/15763.html" target="_blank">html</a>parser2 进入容错重排模式，解析时间可能翻倍，但错误日志里只报 <code>ERROR_TAG_MISMATCH，不体现性能代价。
- 在调用
gumbo_parse()前，先用正则粗筛高危结构：/<table>]*>.*?/is 不匹配但含大量 <code><tr>，大概率存在嵌套断裂 <li>对 <code>htmlparser2，启用xmlMode: false+recognizeSelfClosing: true可减少容错消耗，但需确认输入不含 XML 命名空间 - 节点深度超过 32 层时，Gumbo 的
output->root遍历会显著变慢——这不是 bug，是 C 递归栈的物理限制，监控时应单独采集gumbo_get_document_depth(output) - 每次解析后检查
output->errors.length，非零值说明解析器中途 fallback 到容错路径，该次解析的内存行为不可信 - 用
mallinfo()（Linux）或malloc_size()（macOS）在gumbo_parse()前后采样，比单纯计数更早发现碎片化趋势 - 流式解析（如
htmlparser2.WritableStream）中，ontext回调若引用了外部大对象（如完整 HTML 字符串），会造成隐式内存驻留，需用WeakRef或手动清空缓存
内存泄漏监控不能只看 malloc/free 次数
gumbo_destroy_output() 必须调用，但即使调用了，如果传入了错误的 &kGumboDefaultOptions 地址，仍会导致部分 Vector 内存未释放——这类泄漏在 valgrind 中表现为 “still reachable”，不会报 error，但长期运行后 RSS 持续上涨。
真正难的是把 HTML 结构问题、C 层内存行为、JS 主线程调度这三层监控对齐到同一时间轴——多数人只做其中一层，结果看到 FCP 延迟，却查不到是 parser 卡住、还是 document.write() 在等网络、还是 React hydration 正在遍历一个 2000 节点的错误 DOM 树。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
