nonebot-plugin-htmlrender 0.5.0__tar.gz → 0.6.0__tar.gz

{nonebot_plugin_htmlrender-0.5.0 → nonebot_plugin_htmlrender-0.6.0}/.github/workflows/publish.yml

@@ -43,8 +43,13 @@ jobs:
       - name: Build Package
         run: uv build
 
+      - uses: actions/upload-artifact@v4
+        with:
+          name: artifact
+          path: dist/ # or path/to/artifact
+
       - name: pypi-publish
-        uses: pypa/gh-action-pypi-publish@v1.11.0
+        uses: pypa/gh-action-pypi-publish@v1.12.3
 
       # - name: Publish Package to PyPI
       #   run: uv publish

{nonebot_plugin_htmlrender-0.5.0 → nonebot_plugin_htmlrender-0.6.0}/.gitignore

@@ -127,3 +127,6 @@ dmypy.json
 # Pyre type checker
 .pyre/
 .pdm-python
+
+# pycharm project settings
+.idea/

nonebot_plugin_htmlrender-0.6.0/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+default_install_hook_types: [pre-commit]
+ci:
+  autofix_commit_msg: ":rotating_light: auto fix by pre-commit hooks"
+  autofix_prs: true
+  autoupdate_branch: main
+  autoupdate_schedule: monthly
+  autoupdate_commit_msg: ":arrow_up: auto update by pre-commit hooks"
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.8.2
+    hooks:
+      - id: ruff
+        args: [--fix]
+        stages: [pre-commit]
+      - id: ruff-format
+        stages: [pre-commit]

{nonebot_plugin_htmlrender-0.5.0 → nonebot_plugin_htmlrender-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.3
+Metadata-Version: 2.4
 Name: nonebot-plugin-htmlrender
-Version: 0.5.0
+Version: 0.6.0
 Summary: 通过浏览器渲染图片
 Project-URL: Homepage, https://github.com/kexue-z/nonebot-plugin-htmlrender
 Project-URL: Bug Tracker, https://github.com/kexue-z/nonebot-plugin-htmlrender/issues
@@ -26,6 +26,7 @@ License: MIT License
         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
+License-File: LICENSE
 Requires-Python: <4.0,>=3.9
 Requires-Dist: aiofiles>=0.8.0
 Requires-Dist: jinja2>=3.0.3
@@ -55,6 +56,7 @@ Description-Content-Type: text/markdown
 
 ```py
 from nonebot import require
+
 require("nonebot_plugin_htmlrender")
 # 注意顺序，先require再 from ... import ...
 # 注意顺序，先require再 from ... import ...
@@ -72,32 +74,44 @@ from nonebot_plugin_htmlrender import (
 
 # 配置
 
+## .env 配置项说明
+
 ```ini
-# 默认情况 可不写
+# Playwright 浏览器引擎类型
+# 可不填，默认为 "chromium"
 htmlrender_browser = "chromium"
-# 使用 firefox
-htmlrender_browser = "firefox"
 
-# 下载 playwright 代理地址 可不写
+# Playwright 浏览器下载地址
+# 可选，用于自定义浏览器下载源
 htmlrender_download_host = ""
 
-# 浏览器自定代理地址 可不写
-htmlrender_proxy_host = "http://127.0.0.1:7890"
+# Playwright 浏览器下载代理
+# 可选，用于配置下载浏览器时的代理
+htmlrender_download_proxy = ""
+
+# Playwright 浏览器代理地址
+# 可选，用于配置浏览器访问时的代理
+# 示例: htmlrender_proxy_host = "http://127.0.0.1:7890"
+
+# Playwright 浏览器代理绕过地址
+# 可选，指定不使用代理的地址
+htmlrender_proxy_host_bypass = ""
 
-# 浏览器 channel 支持以下
-# "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
-# "msedge", "msedge-beta", "msedge-dev", "msedge-canary"
-# 手动编辑可以直接使用系统自带浏览器而不用重新下载 chromium
-# 可不写
+# Playwright 浏览器通道
+# 可选，支持以下值:
+# - Chrome: "chrome", "chrome-beta", "chrome-dev", "chrome-canary"
+# - Edge: "msedge", "msedge-beta", "msedge-dev", "msedge-canary"
+# 配置后可直接使用系统浏览器，无需下载 Chromium
 htmlrender_browser_channel = ""
 
-# 浏览器执行文件路径 可不写
+# Playwright 浏览器可执行文件路径
+# 可选，用于指定浏览器程序位置
 htmlrender_browser_executable_path = ""
 
-# 使用 cdp 连接现有浏览器
-# 使用方法，自行启动浏览，在启动浏览器时添加参数 --remote-debugging-port=1234
-# 可不写
-htmlrender_connect_over_cdp = "http://127.0.0.1:1234"
+# CDP 远程调试地址
+# 可选，用于连接已运行的浏览器实例
+# 使用时需要在启动浏览器时添加参数 --remote-debugging-port=端口号
+htmlrender_connect_over_cdp = "http://127.0.0.1:9222"
 ```
 
 ## markdown 转 图片
@@ -106,8 +120,8 @@ htmlrender_connect_over_cdp = "http://127.0.0.1:1234"
 - 支持绝大部分 md 语法
 - 代码高亮
 - latex 数学公式 （感谢@[MeetWq](https://github.com/MeetWq)）
-  - 使用 `$$...$$` 来输入独立公式
-  - 使用 `$...$` 来输入行内公式
+    - 使用 `$$...$$` 来输入独立公式
+    - 使用 `$...$` 来输入行内公式
 - 图片需要使用外部连接并使用`html`格式 否则文末会超出截图范围
 - 图片可使用 md 语法 路径可为 `绝对路径`(建议), 或 `相对于template_path` 的路径
 
@@ -165,10 +179,11 @@ LC_ALL zh_CN.UTF-8
 ### CentOS 使用 `yum`
 
 - ~~小心 CentOS~~
-- 参考[CentOS Dockerfile](https://github.com/kumaraditya303/playwright-centos/blob/master/Dockerfile)
+-
+参考[CentOS Dockerfile](https://github.com/kumaraditya303/playwright-centos/blob/master/Dockerfile)
 - 添加中文字体库
 - ~~最佳解决办法~~
-  - 使用 Docker 然后用 Python 镜像 按照上面 Ubuntu 的写 `dockerfile`
+    - 使用 Docker 然后用 Python 镜像 按照上面 Ubuntu 的写 `dockerfile`
 
 下面这个依赖运行一下 也许就可以用了
 

{nonebot_plugin_htmlrender-0.5.0 → nonebot_plugin_htmlrender-0.6.0}/README.md

@@ -16,6 +16,7 @@
 
 ```py
 from nonebot import require
+
 require("nonebot_plugin_htmlrender")
 # 注意顺序，先require再 from ... import ...
 # 注意顺序，先require再 from ... import ...
@@ -33,32 +34,44 @@ from nonebot_plugin_htmlrender import (
 
 # 配置
 
+## .env 配置项说明
+
 ```ini
-# 默认情况 可不写
+# Playwright 浏览器引擎类型
+# 可不填，默认为 "chromium"
 htmlrender_browser = "chromium"
-# 使用 firefox
-htmlrender_browser = "firefox"
 
-# 下载 playwright 代理地址 可不写
+# Playwright 浏览器下载地址
+# 可选，用于自定义浏览器下载源
 htmlrender_download_host = ""
 
-# 浏览器自定代理地址 可不写
-htmlrender_proxy_host = "http://127.0.0.1:7890"
+# Playwright 浏览器下载代理
+# 可选，用于配置下载浏览器时的代理
+htmlrender_download_proxy = ""
+
+# Playwright 浏览器代理地址
+# 可选，用于配置浏览器访问时的代理
+# 示例: htmlrender_proxy_host = "http://127.0.0.1:7890"
+
+# Playwright 浏览器代理绕过地址
+# 可选，指定不使用代理的地址
+htmlrender_proxy_host_bypass = ""
 
-# 浏览器 channel 支持以下
-# "chrome", "chrome-beta", "chrome-dev", "chrome-canary",
-# "msedge", "msedge-beta", "msedge-dev", "msedge-canary"
-# 手动编辑可以直接使用系统自带浏览器而不用重新下载 chromium
-# 可不写
+# Playwright 浏览器通道
+# 可选，支持以下值:
+# - Chrome: "chrome", "chrome-beta", "chrome-dev", "chrome-canary"
+# - Edge: "msedge", "msedge-beta", "msedge-dev", "msedge-canary"
+# 配置后可直接使用系统浏览器，无需下载 Chromium
 htmlrender_browser_channel = ""
 
-# 浏览器执行文件路径 可不写
+# Playwright 浏览器可执行文件路径
+# 可选，用于指定浏览器程序位置
 htmlrender_browser_executable_path = ""
 
-# 使用 cdp 连接现有浏览器
-# 使用方法，自行启动浏览，在启动浏览器时添加参数 --remote-debugging-port=1234
-# 可不写
-htmlrender_connect_over_cdp = "http://127.0.0.1:1234"
+# CDP 远程调试地址
+# 可选，用于连接已运行的浏览器实例
+# 使用时需要在启动浏览器时添加参数 --remote-debugging-port=端口号
+htmlrender_connect_over_cdp = "http://127.0.0.1:9222"
 ```
 
 ## markdown 转 图片
@@ -67,8 +80,8 @@ htmlrender_connect_over_cdp = "http://127.0.0.1:1234"
 - 支持绝大部分 md 语法
 - 代码高亮
 - latex 数学公式 （感谢@[MeetWq](https://github.com/MeetWq)）
-  - 使用 `$$...$$` 来输入独立公式
-  - 使用 `$...$` 来输入行内公式
+    - 使用 `$$...$$` 来输入独立公式
+    - 使用 `$...$` 来输入行内公式
 - 图片需要使用外部连接并使用`html`格式 否则文末会超出截图范围
 - 图片可使用 md 语法 路径可为 `绝对路径`(建议), 或 `相对于template_path` 的路径
 
@@ -126,10 +139,11 @@ LC_ALL zh_CN.UTF-8
 ### CentOS 使用 `yum`
 
 - ~~小心 CentOS~~
-- 参考[CentOS Dockerfile](https://github.com/kumaraditya303/playwright-centos/blob/master/Dockerfile)
+-
+参考[CentOS Dockerfile](https://github.com/kumaraditya303/playwright-centos/blob/master/Dockerfile)
 - 添加中文字体库
 - ~~最佳解决办法~~
-  - 使用 Docker 然后用 Python 镜像 按照上面 Ubuntu 的写 `dockerfile`
+    - 使用 Docker 然后用 Python 镜像 按照上面 Ubuntu 的写 `dockerfile`
 
 下面这个依赖运行一下 也许就可以用了
 

{nonebot_plugin_htmlrender-0.5.0 → nonebot_plugin_htmlrender-0.6.0}/example/plugins/render/__init__.py

@@ -1,22 +1,24 @@
 from nonebot import require
+
 require("nonebot_plugin_htmlrender")
 # 注意顺序，先require再 from ... import ...
 # 注意顺序，先require再 from ... import ...
 # 注意顺序，先require再 from ... import ...
-from nonebot_plugin_htmlrender import (
-    text_to_pic,
-    md_to_pic,
-    template_to_pic,
-    get_new_page,
-)
+import io
+
 # 注意顺序，先require再 from ... import ...
 # 注意顺序，先require再 from ... import ...
 # 注意顺序，先require再 from ... import ...
-
 from nonebot import on_command
 from nonebot.adapters.onebot.v11 import Bot, MessageEvent, MessageSegment
 from PIL import Image
-import io
+
+from nonebot_plugin_htmlrender import (
+    get_new_page,
+    md_to_pic,
+    template_to_pic,
+    text_to_pic,
+)
 
 from .utils import count_to_color
 
@@ -109,7 +111,7 @@ async def _():
         pages={
             "viewport": {"width": 600, "height": 300},
             "base_url": f"file://{template_path}",
-        }
+        },
     )
 
     a = Image.open(io.BytesIO(pic))
@@ -124,7 +126,7 @@ md2pic = on_command("md2pic")
 
 @md2pic.handle()
 async def _md2pic(bot: Bot, event: MessageEvent):
-    from pathlib import Path
+    # from pathlib import Path
 
     # 如果是直接获取消息内容 需要 unescape
     from nonebot.adapters.onebot.v11 import unescape

{nonebot_plugin_htmlrender-0.5.0 → nonebot_plugin_htmlrender-0.6.0}/example/plugins/render/utils.py

@@ -1,12 +1,13 @@
 from nonebot.log import logger
 
+
 def count_to_color(count: str) -> str:
-    logger.debug(f"Filtering count: {count}") 
-    if count == '1':
+    logger.debug(f"Filtering count: {count}")
+    if count == "1":
         return "#facc15"
-    elif count == '2':
+    elif count == "2":
         return "#f87171"
-    elif count == '3':
+    elif count == "3":
         return "#c084fc"
     else:
-        return "#60a5fa"
+        return "#60a5fa"

nonebot_plugin_htmlrender-0.6.0/nonebot_plugin_htmlrender/__init__.py

@@ -0,0 +1,55 @@
+import nonebot
+from nonebot.log import logger
+from nonebot.plugin import PluginMetadata
+
+from nonebot_plugin_htmlrender.browser import get_browser as get_browser
+from nonebot_plugin_htmlrender.browser import get_new_page as get_new_page
+from nonebot_plugin_htmlrender.browser import init_browser as init_browser
+from nonebot_plugin_htmlrender.browser import shutdown_browser as shutdown_browser
+from nonebot_plugin_htmlrender.browser import start_browser as start_browser
+from nonebot_plugin_htmlrender.config import Config
+from nonebot_plugin_htmlrender.data_source import capture_element as capture_element
+from nonebot_plugin_htmlrender.data_source import html_to_pic as html_to_pic
+from nonebot_plugin_htmlrender.data_source import md_to_pic as md_to_pic
+from nonebot_plugin_htmlrender.data_source import template_to_html as template_to_html
+from nonebot_plugin_htmlrender.data_source import template_to_pic as template_to_pic
+from nonebot_plugin_htmlrender.data_source import text_to_pic as text_to_pic
+
+__plugin_meta__ = PluginMetadata(
+    name="nonebot-plugin-htmlrender",
+    description="通过浏览器渲染图片",
+    usage="",
+    type="library",
+    config=Config,
+    homepage="https://github.com/kexue-z/nonebot-plugin-htmlrender",
+    extra={},
+)
+
+driver = nonebot.get_driver()
+
+
+@driver.on_startup
+async def init(**kwargs):
+    logger.info("htmlrender启动中...")
+    await init_browser(**kwargs)
+    logger.info("htmlrender已启动.")
+
+
+@driver.on_shutdown
+async def shutdown():
+    logger.info("htmlrender关闭中...")
+    await shutdown_browser()
+    logger.info("htmlrender已关闭.")
+
+
+__all__ = [
+    "capture_element",
+    "get_new_page",
+    "html_to_pic",
+    "md_to_pic",
+    "shutdown_browser",
+    "start_browser",
+    "template_to_html",
+    "template_to_pic",
+    "text_to_pic",
+]

nonebot_plugin_htmlrender-0.6.0/nonebot_plugin_htmlrender/browser.py

@@ -0,0 +1,169 @@
+from collections.abc import AsyncIterator
+from contextlib import asynccontextmanager
+from typing import Optional
+
+from nonebot.log import logger
+from playwright.async_api import (
+    Browser,
+    BrowserType,
+    Error,
+    Page,
+    Playwright,
+    async_playwright,
+)
+
+from nonebot_plugin_htmlrender.config import BrowserEngineType, plugin_config
+from nonebot_plugin_htmlrender.install import install_browser
+from nonebot_plugin_htmlrender.utils import proxy_settings, suppress_and_log
+
+_browser: Optional[Browser] = None
+_playwright: Optional[Playwright] = None
+
+
+async def _launch(browser_type: BrowserEngineType, **kwargs) -> Browser:
+    """
+    启动浏览器实例。
+
+    Args:
+        browser_type (BrowserEngineType): 浏览器类型。
+        **kwargs: 传递给`playwright.launch`的关键字参数。
+
+    Returns:
+        Browser: 启动的浏览器实例。
+    """
+    _browser_cls: BrowserType = getattr(_playwright, browser_type)
+    logger.opt(colors=True).debug(
+        f"<cyan>{browser_type.capitalize()}</cyan> launching with kwargs: {kwargs}"
+    )
+    logger.opt(colors=True).debug(
+        f"Looking for Browser in path: <blue>{_browser_cls.executable_path}</blue>"
+    )
+    return await _browser_cls.launch(**kwargs)
+
+
+async def init_browser(**kwargs) -> Browser:
+    """
+    初始化浏览器实例。
+
+    Args:
+        **kwargs: 传递给`playwright.launch`的关键字参数。
+
+    Returns:
+        Browser: 浏览器实例。
+
+    Raises:
+        RuntimeError: 如果浏览器无法启动或安装失败。
+    """
+    try:
+        return await start_browser(**kwargs)
+    except (Error, Exception) as e:
+        if "Executable doesn't exist" not in str(e):
+            raise RuntimeError("无法启动浏览器实例") from e
+        try:
+            if await install_browser():
+                return await start_browser(**kwargs)
+            else:
+                raise RuntimeError("无法启动浏览器实例且尝试安装失败") from e
+        except Exception as e:
+            raise RuntimeError("无法启动浏览器实例") from e
+
+
+@asynccontextmanager
+async def get_new_page(device_scale_factor: float = 2, **kwargs) -> AsyncIterator[Page]:
+    """
+    获取一个新的页面的上下文管理器。
+
+    Args:
+        device_scale_factor (float): 设备缩放因子。
+        **kwargs: 传递给`browser.new_context`的关键字参数。
+
+    Yields:
+        Page: 页面对象。
+    """
+    ctx = await get_browser()
+    page = await ctx.new_page(device_scale_factor=device_scale_factor, **kwargs)
+    try:
+        yield page
+    finally:
+        await page.close()
+
+
+async def get_browser(**kwargs) -> Browser:
+    """
+    获取浏览器实例。
+
+    Args:
+        **kwargs: 传递给`playwright.launch`的关键字参数。
+
+    Returns:
+        Browser: 浏览器实例。
+    """
+    if _browser and _browser.is_connected():
+        return _browser
+
+    return await init_browser(**kwargs)
+
+
+async def _connect_via_cdp(**kwargs) -> Browser:
+    """
+    通过 CDP 连接 Chromium 浏览器。
+
+    Args:
+        **kwargs: 传递给`chromium.connect_over_cdp`的关键字参数。
+
+    Returns:
+        Browser: 通过 CDP 连接的浏览器实例。
+
+    Raises:
+        RuntimeError: 如果 Playwright 未初始化。
+    """
+    kwargs["endpoint_url"] = plugin_config.htmlrender_connect_over_cdp
+    logger.info(
+        f"正在使用 CDP 连接 Chromium({plugin_config.htmlrender_connect_over_cdp})"
+    )
+    if _playwright is not None:
+        return await _playwright.chromium.connect_over_cdp(**kwargs)
+    else:
+        raise RuntimeError("Playwright 未初始化")
+
+
+async def start_browser(**kwargs) -> Browser:
+    """
+    启动 Playwright 浏览器实例。
+
+    Args:
+        **kwargs: 传递给`playwright.launch`的关键字参数。
+
+    Returns:
+        Browser: 启动的浏览器实例。
+    """
+    global _browser, _playwright
+    _playwright = await async_playwright().start()
+
+    if (
+        plugin_config.htmlrender_browser == "chromium"
+        and plugin_config.htmlrender_connect_over_cdp
+    ):
+        return await _connect_via_cdp(**kwargs)
+
+    if plugin_config.htmlrender_browser_channel:
+        kwargs["channel"] = plugin_config.htmlrender_browser_channel
+
+    if plugin_config.htmlrender_proxy_host:
+        kwargs["proxy"] = proxy_settings(plugin_config.htmlrender_proxy_host)
+
+    if plugin_config.htmlrender_browser_executable_path:
+        kwargs["executable_path"] = plugin_config.htmlrender_browser_executable_path
+
+    _browser = await _launch(plugin_config.htmlrender_browser, **kwargs)
+    return _browser
+
+
+async def shutdown_browser() -> None:
+    """关闭浏览器和 Playwright 实例。"""
+    if _browser:
+        with suppress_and_log():
+            await _browser.close()
+    if _playwright:
+        with suppress_and_log():
+            await _playwright.stop()

nonebot_plugin_htmlrender-0.6.0/nonebot_plugin_htmlrender/config.py

@@ -0,0 +1,80 @@
+from collections.abc import Generator
+from typing import Any, Callable, ClassVar, Optional
+
+from nonebot import get_driver, get_plugin_config
+from nonebot.compat import custom_validation
+from pydantic import BaseModel, Field
+
+from nonebot_plugin_htmlrender.consts import BROWSER_CHANNEL_TYPES, BROWSER_ENGINE_TYPES
+
+
+@custom_validation
+class BrowserEngineType(str):
+    """Playwright浏览器引擎类型，支持的值由 BROWSER_ENGINE_TYPES 定义。"""
+
+    ALLOWED_VALUES: ClassVar = BROWSER_ENGINE_TYPES
+
+    @classmethod
+    def __get_validators__(cls) -> Generator[Callable[..., Any], None, None]:
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any) -> str:
+        if value not in cls.ALLOWED_VALUES:
+            raise ValueError(
+                f"Invalid browser type: {value!r}, must be one of {cls.ALLOWED_VALUES}"
+            )
+        return value
+
+
+@custom_validation
+class BrowserChannelType(str):
+    """Playwright浏览器通道类型，支持的值由 BROWSER_CHANNEL_TYPES 定义。"""
+
+    ALLOWED_VALUES: ClassVar = BROWSER_CHANNEL_TYPES
+
+    @classmethod
+    def __get_validators__(cls) -> Generator[Callable[..., Any], None, None]:
+        yield cls.validate
+
+    @classmethod
+    def validate(cls, value: Any) -> str:
+        if value not in cls.ALLOWED_VALUES:
+            raise ValueError(
+                f"Invalid channel: {value!r}, must be one of {cls.ALLOWED_VALUES}"
+            )
+        return value
+
+
+class Config(BaseModel):
+    """插件配置类。"""
+
+    htmlrender_browser: BrowserEngineType = Field(
+        default="chromium",
+        description="Playwright浏览器引擎类型，默认值为 'chromium'。",
+    )
+    htmlrender_download_host: Optional[str] = Field(
+        default=None, description="下载Playwright浏览器时的主机地址。"
+    )
+    htmlrender_download_proxy: Optional[str] = Field(
+        default=None, description="下载Playwright浏览器时的代理设置。"
+    )
+    htmlrender_proxy_host: Optional[str] = Field(
+        default=None, description="Playwright浏览器使用的代理主机地址。"
+    )
+    htmlrender_proxy_host_bypass: Optional[str] = Field(
+        default=None, description="Playwright浏览器代理的绕过地址。"
+    )
+    htmlrender_browser_channel: Optional[BrowserChannelType] = Field(
+        default=None, description="Playwright浏览器通道类型。"
+    )
+    htmlrender_browser_executable_path: Optional[str] = Field(
+        default=None, description="Playwright浏览器可执行文件的路径。"
+    )
+    htmlrender_connect_over_cdp: Optional[str] = Field(
+        default=None, description="通过 CDP 连接Playwright浏览器的端点地址。"
+    )
+
+
+global_config = get_driver().config
+plugin_config = get_plugin_config(Config)

nonebot_plugin_htmlrender-0.6.0/nonebot_plugin_htmlrender/consts.py

@@ -0,0 +1,38 @@
+from dataclasses import dataclass
+import os
+import sys
+
+
+@dataclass(frozen=True)
+class MirrorSource:
+    name: str
+    url: str
+    priority: int
+
+
+# consts
+PLUGINS_GROUP = "nonebot_plugin_htmlrender"
+SCRIPTS_GROUP = "nonebot_plugin_htmlrender_scripts"
+REQUIRES_PYTHON = (3, 9)
+# SHELL = os.getenv("SHELL", "")
+WINDOWS = sys.platform.startswith("win") or (sys.platform == "cli" and os.name == "nt")
+# MINGW = sysconfig.get_platform().startswith("mingw")
+# MACOS = sys.platform == "darwin"
+MIRRORS = [
+    MirrorSource("官方", "https://playwright.azureedge.net", 1),
+    MirrorSource("淘宝", "https://registry.npmmirror.com/-/binary/playwright", 2),
+]
+BROWSER_ENGINE_TYPES = ["chromium", "firefox", "webkit"]
+BROWSER_CHANNEL_TYPES = [
+    "chromium",
+    "chrome",
+    "chrome-beta",
+    "chrome-dev",
+    "chrome-canary",
+    "msedge",
+    "msedge-beta",
+    "msedge-dev",
+    "msedge-canary",
+    "firefox",
+    "webkit",
+]