特性
- 统一的
render_html、render_text、render_markdown、render_templateAPI Application/Renderer组合边界与可发现的渲染 Provider- Playwright 浏览器、Takumi 原生与实验性 HTMLKit Provider
- 与引擎无关的 Preparation、资源服务和
PreparedHtml RenderedImage/RenderedHtml类型化产物- Playwright、Takumi、Pillow 与 Skia 通过
app.extensions的静态属性直接补全；Playwright/Takumi 还可租借保留上游类型的原生对象 - 有界资源缓存、严格本地路径策略和可选观测集成
安装
本体默认不安装任何位图渲染后端，只提供 Preparation 与模板到 HTML。按需选择一个 HTML 后端（Provider）：
uv add "nonebot-plugin-htmlrender[playwright]>=0.8.0,<0.9"
# 或
uv add "nonebot-plugin-htmlrender[takumi]>=0.8.0,<0.9"
# 或（实验性、asyncio-only）
uv add "nonebot-plugin-htmlrender[htmlkit]>=0.8.0,<0.9"
Pillow/Skia 是独立的 RasterScene Capability，不属于 HTML 后端。按需增加pillow、skia、sentry、prometheus；内置 filehost transport 可选增加filehost extra，以使用 py-machineid 派生默认请求头守卫值。all 会安装全部可选能力。
uv add "nonebot-plugin-htmlrender[playwright,filehost,prometheus]>=0.8.0,<0.9"
快速开始
render:
provider: playwright
startup: warmup
resources:
local_access:
allowed_paths: [templates]
from nonebot import require
require("nonebot_plugin_htmlrender")
from nonebot_plugin_htmlrender import render_markdown, render_template
async def demo() -> tuple[bytes, bytes]:
markdown = await render_markdown("# Hello\n\n**NoneBot**", width=720)
card = await render_template(
"templates",
"card.html",
variables={"name": "nonebot"},
width=480,
)
return bytes(markdown), bytes(card)
render_* 返回类型化产物；交给消息适配器时显式使用bytes(artifact)，需要 MIME 类型时读取 artifact.media_type。
文档
开发
make prepare
make check
make docs-build
make test-local
make build-artifacts
远程浏览器联调使用 make remote-smoke-build；常规变更可复用镜像执行make remote-smoke。
许可
项目使用 MIT License。启用 Takumi、HTMLKit 或其他第三方 Provider 前，请同时检查其依赖与分发许可；HTMLKit rc5 的 native core 为 LGPL-3.0-or-later。
Release files for nonebot-plugin-htmlrender 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nonebot_plugin_htmlrender-0.8.1.tar.gz | 3.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_htmlrender-0.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 4.2 MB
Release files / nonebot_plugin_htmlrender-0.8.1.tar.gz
| Download URL | nonebot_plugin_htmlrender-0.8.1.tar.gz |
|---|---|
| Size | 3.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
314c75357d8843573d337e0cf698f747eef551b4ffcdc624588eaf13ac22b3a5
|
|
BLAKE2b-256 checksum How to use checksums |
b05023c063924aba438cc426fffb443d8079060a38c5707435eb75d088069972
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 30, 2026.
Transparency logRelease files / nonebot_plugin_htmlrender-0.8.1-py3-none-any.whl
| Download URL | nonebot_plugin_htmlrender-0.8.1-py3-none-any.whl |
|---|---|
| Size | 1.3 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
ebf503834c9b0c6e397a1c0a172c4b71dbce2b4e8dad7c8b893b92c04b9193e8
|
|
BLAKE2b-256 checksum How to use checksums |
fde4050e5ea0ffbc05667d0cd5e0afc93d80571723d1da842a10aeb46a53b363
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 30, 2026.
Transparency log
