HTML 渲染预算

July 26, 2026 · View on GitHub

render.html 由 composition 统一实施,适用于 render_htmlrender_textrender_markdownrender_templaterasterize_html。限制位于 Provider executor 外层,因此切换 Playwright、HTMLKit 或 Takumi 不会改变拒绝语义。

路径默认值说明
render.html.max_source_bytes67108864单次 PreparedHtml 的 HTML、stylesheet 与 asset 总字节上限
render.html.max_pixels16777216编码结果的物理像素上限;显式高度请求也会在进入 Provider 前校验
render.html.max_output_bytes67108864编码图片的字节上限
render.html.max_device_pixel_ratio4.0允许的最大设备像素比
render.html.max_auto_height16384height=None 时允许的最大内容驱动 CSS 高度
render.html.max_concurrency2当前 composition 内所有 HTML Provider executor 共享的并发槽

输入大小、设备像素比和显式宽高的物理像素数会在取得并发槽及调用 Provider之前校验。内容驱动高度只有 Provider 完成布局后才能确定,因此其高度、总物理像素与编码字节数作为统一的输出后置条件校验;并发限制仍会约束这类请求同时占用的运行时资源。

Provider 专属 capability 不经过 neutral HTML executor,仍由各 capability 自己的契约与 Provider 配置约束。