快速开始¶

安装¶

uv add "entari-plugin-htmlrender[playwright]>=0.1.0,<0.2"
uv run playwright install chromium

Python 要求为 >=3.10,<4.0。core 不携带浏览器或 native backend；也可按需选择takumi、pillow、skia、filehost、sentry、prometheus extra。

Entari 配置¶

plugins:
  htmlrender:
    provider: playwright
    startup: probe
    provider_config:
      engine: chromium

插件短名是 htmlrender。provider 等字段直接位于这个映射内，没有额外 wrapper。probe 在 Launart preparing 阶段启动并探测 Provider；warmup 只启动，若只需要模板到 HTML、资源或 graphics，可令 provider: null 且保持 startup: off。

调用¶

from entari_plugin_htmlrender import RasterOptions, RenderedImage
from entari_plugin_htmlrender.entari import HtmlRenderService

async def render_help(service: HtmlRenderService) -> RenderedImage:
    return await service.renderer.rasterize_markdown(
        "# Hello, Entari\n\nRendered by htmlrender.",
        raster=RasterOptions(width=720),
    )

让 Entari DI 把 HtmlRenderService 传给 handler。可复用业务函数最好进一步收窄为HtmlRenderer 等 caller contract。返回的 RenderedImage 可通过 bytes(image)交给消息层；业务代码不需要解析 runtime 或驱动 service 生命周期。

模板与本地资源必须位于 resources.local_access.allowed_paths 中。下一步可阅读渲染内容、模板与资源与 Runtime API。