nonebot-plugin-cardimg 0.1.0__tar.gz

nonebot_plugin_cardimg-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 youlanan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+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.

nonebot_plugin_cardimg-0.1.0/PKG-INFO

@@ -0,0 +1,345 @@
+Metadata-Version: 2.4
+Name: nonebot_plugin_cardimg
+Version: 0.1.0
+Summary: 文本转图片工具，基于 nonebot_plugin_htmlkit 预制了方便扩展的渲染模板
+Project-URL: homepage, https://github.com/youlanan/nonebot-plugin-cardimg
+Project-URL: Repository, https://github.com/youlanan/nonebot_plugin_cardimg.git
+Project-URL: Documentation, https://github.com/youlanan/nonebot_plugin_cardimg#readme
+Author-email: youlanan <ylanan@foxmail.com>
+License: MIT
+License-File: LICENSE
+Requires-Python: <4.0,>=3.10
+Requires-Dist: nonebot-plugin-htmlkit>=0.1.0
+Requires-Dist: nonebot2>=2.4.3
+Requires-Dist: pydantic>=2.0.0
+Description-Content-Type: text/markdown
+
+<!-- markdownlint-disable MD031 MD033 MD036 MD041 -->
+
+<div align="center">
+
+<a href="https://v2.nonebot.dev/store">
+  <img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo">
+</a>
+
+<p>
+  <img src="https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/template/plugin.svg" alt="NoneBotPluginText">
+</p>
+
+# nonebot-plugin-cardimg
+
+_✨ 基于 nonebot_plugin_htmlkit 渲染的文本转图片模板插件 ✨_
+
+<img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
+<a href="https://github.com/astral-sh/uv">
+  <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
+</a>
+<a href="https://pydantic.dev">
+  <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/template/pyd-v1-or-v2.json" alt="Pydantic Version 1 Or 2" >
+</a>
+<a href="./LICENSE">
+  <img src="https://img.shields.io/github/license/youlanan/nonebot-plugin-cardimg.svg" alt="license">
+</a>
+<a href="https://pypi.python.org/pypi/nonebot_plugin_cardimg">
+  <img src="https://img.shields.io/pypi/v/nonebot_plugin_cardimg.svg" alt="pypi">
+</a>
+
+<br />
+
+</div>
+
+## 📖 介绍
+
+nonebot-plugin-cardimg 是一个基于 nonebot_plugin_htmlkit 的模板化图片渲染插件，为 NoneBot2 插件开发者提供简单易用的文本图片生成功能。
+
+### 核心特性
+
+- **多种预设模板**：提供 7 种精美模板，覆盖常见使用场景
+- **昼夜模式**：部分模板支持自动/手动切换昼夜主题
+- **随机配色**：部分模板支持随机颜色主题
+- **灵活配置**：支持全局配置和模板特定参数
+- **资源缓存**：内置文件和资源缓存机制，提升性能
+- **易于扩展**：基于抽象基类，方便添加自定义模板
+
+### 可用模板
+
+| 模板名称 | 描述 | 特性 |
+| :--- | :--- | :--- |
+| `minote` | 小米便签风格 | 背景图+边框+四角装饰 |
+| `simple` | 简约风格 | 纯色背景，支持昼夜模式 |
+| `ncm_zhusha` | 网易云朱砂样式 | 红色背景+白色标题框 |
+| `ncm_card` | 网易云热评卡片 | 音乐评论卡片样式 |
+| `bili` | 哔哩哔哩壁纸 | 支持昼夜模式 |
+| `help` | 帮助文档 | 支持随机颜色主题和昼夜模式 |
+| `table` | 表格展示 | 支持随机颜色主题和昼夜模式 |
+
+## 🖼️ 演示效果
+
+<details>
+<summary>点击展开查看各模板渲染效果</summary>
+
+### 小米便签 (minote)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/minote-demo.png" width="400">
+
+### 简约风格 (simple)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/simple-demo.png" width="400">
+
+### 网易云朱砂 (ncm_zhusha)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/ncm-zhusha-demo.png" width="400">
+
+### 网易云热评卡片 (ncm_card)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/ncm-card-demo.png" width="400">
+
+### 哔哩哔哩壁纸 (bili)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/bili-demo.png" width="400">
+
+### 帮助文档 (help)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/help-demo.png" width="400">
+
+### 表格展示 (table)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/table-demo.png" width="400">
+
+</details>
+
+##  安装
+
+以下提到的方法 任选**其一** 即可
+
+<details open>
+<summary>[推荐] 使用 nb-cli 安装</summary>
+
+在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
+
+```bash
+nb plugin install nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>使用包管理器安装</summary>
+
+在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
+
+<details>
+<summary>pip</summary>
+
+```bash
+pip install nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>pdm</summary>
+
+```bash
+pdm add nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>poetry</summary>
+
+```bash
+poetry add nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>conda</summary>
+
+```bash
+conda install nonebot_plugin_cardimg
+```
+
+</details>
+
+打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分的 `plugins` 项里追加写入
+
+```toml
+[tool.nonebot]
+plugins = [
+    # ...
+    "nonebot_plugin_cardimg"
+]
+```
+
+</details>
+
+## ⚙️ 配置
+
+在 nonebot2 项目的 `.env` 文件中添加下表中的配置
+
+| 配置项 | 必填 | 默认值 | 说明 |
+| :--- | :---: | :---: | :--- |
+| `cardimg_use_global_config` | 否 | `False` | 是否使用全局配置作为兜底 |
+| `cardimg_image_format` | 否 | `png` | 全局图片格式：png 或 jpeg |
+| `cardimg_jpeg_quality` | 否 | `85` | 全局 JPEG 质量：1-100 |
+
+## 🎉 使用
+
+### 基础用法
+
+```python
+from nonebot import require
+require("nonebot_plugin_cardimg")
+from nonebot_plugin_cardimg import render
+
+# 渲染小米便签模板
+img_bytes = await render(
+    'minote',
+    title='标题',
+    content='这是正文内容',
+    footer='页脚'
+)
+
+# 渲染简约模板（自动昼夜模式）
+img_bytes = await render(
+    'simple',
+    title='简约标题',
+    content='简约内容'
+)
+
+# 渲染帮助文档
+img_bytes = await render(
+    'help',
+    title='帮助文档',
+    items={
+        '命令1': '这是命令1的说明',
+        '命令2': '这是命令2的说明'
+    },
+    footer='更多帮助请访问...'
+)
+
+# 渲染表格
+img_bytes = await render(
+    'table',
+    title='排行榜',
+    tip='数据更新时间：2026-02-10',
+    columns=['排名', '用户', '分数'],
+    data=[
+        ['1', '用户A', '100'],
+        ['2', '用户B', '95'],
+        ['3', '用户C', '90']
+    ]
+)
+```
+
+### 高级用法
+
+#### 指定渲染参数
+
+```python
+img_bytes = await render(
+    'simple',
+    title='标题',
+    content='内容',
+    htmlkit_params={
+        'max_width': 800,
+        'image_format': 'jpeg',
+        'jpeg_quality': 90
+    }
+)
+```
+
+#### 手动控制昼夜模式
+
+```python
+# 强制使用夜间模式
+img_bytes = await render(
+    'simple',
+    title='标题',
+    content='内容',
+    night_mode=True
+)
+
+# 强制使用白天模式
+img_bytes = await render(
+    'simple',
+    title='标题',
+    content='内容',
+    night_mode=False
+)
+```
+
+#### 获取可用模板列表
+
+```python
+from nonebot_plugin_cardimg import list_templates
+
+templates = list_templates()
+print(templates)  # ['minote', 'simple', 'ncm_zhusha', 'ncm_card', 'bili', 'help', 'table']
+```
+
+### 接口方法参考
+
+#### `render(template, title="", content="", footer="", htmlkit_params=None, **kwargs)`
+
+渲染模板为图片
+
+**参数：**
+- `template` (str): 模板名称
+- `title` (str, optional): 标题
+- `content` (str, optional): 正文内容
+- `footer` (str, optional): 页脚
+- `htmlkit_params` (dict, optional): htmlkit 渲染参数
+- `**kwargs`: 模板特定参数
+###### 其中：`template` 是必填项，其他参数根据不同模板需求填写；`htmlkit_params` 是 htmlkit 插件的渲染方法参数，可用来自定义调整渲染尺寸、格式等内容。
+
+**返回：**
+- `bytes`: 图片字节数据
+
+**模板特定参数：**
+- `simple`/`bili`/`help`/`table`: `night_mode` (bool, optional) - 是否使用夜间模式
+- `help`: `items` (dict) - 帮助项字典
+- `table`: `columns` (list) - 表头列表, `data` (list[list]) - 表格数据, `tip` (str) - 提示文本
+
+## 📝 开发
+
+### 添加自定义模板
+
+```python
+from pathlib import Path
+from nonebot_plugin_cardimg import BaseTemplate
+
+
+class MyTemplate(BaseTemplate):
+    def __init__(self):
+        super().__init__("my_template", Path(__file__).parent / "templates")
+
+    async def render(self, **kwargs) -> bytes:
+        options = kwargs.pop("_render_options", self.get_render_options())
+        templates = {
+            "title": kwargs.get("title", ""),
+            "content": kwargs.get("content", ""),
+        }
+        return await self.to_pic_template("template.html", templates=templates, **options)
+```
+
+## 📞 联系
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/qrcode.png" width="200" alt="QQ群">
+
+</div>
+
+- 由于技术力和时间有限，本插件可能存在问题和不足，字体自定义以及图片压缩相关问题未能很好解决，欢迎优化或指正(๑˃̵ᴗ˂̵)₊♡ 
+- 由于技术力和时间有限，本项目的描述和代码排版由AI辅助完成，如有意外的错漏混淆欢迎反馈和指正(๑˃̵ᴗ˂̵)₊♡♡ 
+- 如有问题或建议，欢迎提交 Issue 或 Pull Request。
+
+## 💡 鸣谢
+
+- [nonebot-plugin-htmlkit](https://github.com/nonebot/plugin-htmlkit) - HTML 转图片核心库
+- [nonebot-plugin-txt2img](https://github.com/mobyw/nonebot-plugin-txt2img) - 模板样式参考
+- [nonebot-plugin-zxui](https://github.com/HibiKier/nonebot-plugin-zxui) - 模板样式参考
+- [nonebot-plugin-template](https://github.com/lgc-NB2Dev/nonebot-plugin-template) - 插件模板
+
+## 📝 更新日志
+
+### v0.1.0 (2026-02-10)
+
+- 初始版本发布（仅在 Docker 环境下测试通过，暂未解决默认字体替换问题）

nonebot_plugin_cardimg-0.1.0/README.md

@@ -0,0 +1,329 @@
+<!-- markdownlint-disable MD031 MD033 MD036 MD041 -->
+
+<div align="center">
+
+<a href="https://v2.nonebot.dev/store">
+  <img src="https://raw.githubusercontent.com/A-kirami/nonebot-plugin-template/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo">
+</a>
+
+<p>
+  <img src="https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/template/plugin.svg" alt="NoneBotPluginText">
+</p>
+
+# nonebot-plugin-cardimg
+
+_✨ 基于 nonebot_plugin_htmlkit 渲染的文本转图片模板插件 ✨_
+
+<img src="https://img.shields.io/badge/python-3.10+-blue.svg" alt="python">
+<a href="https://github.com/astral-sh/uv">
+  <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json" alt="uv">
+</a>
+<a href="https://pydantic.dev">
+  <img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/lgc-NB2Dev/readme/main/template/pyd-v1-or-v2.json" alt="Pydantic Version 1 Or 2" >
+</a>
+<a href="./LICENSE">
+  <img src="https://img.shields.io/github/license/youlanan/nonebot-plugin-cardimg.svg" alt="license">
+</a>
+<a href="https://pypi.python.org/pypi/nonebot_plugin_cardimg">
+  <img src="https://img.shields.io/pypi/v/nonebot_plugin_cardimg.svg" alt="pypi">
+</a>
+
+<br />
+
+</div>
+
+## 📖 介绍
+
+nonebot-plugin-cardimg 是一个基于 nonebot_plugin_htmlkit 的模板化图片渲染插件，为 NoneBot2 插件开发者提供简单易用的文本图片生成功能。
+
+### 核心特性
+
+- **多种预设模板**：提供 7 种精美模板，覆盖常见使用场景
+- **昼夜模式**：部分模板支持自动/手动切换昼夜主题
+- **随机配色**：部分模板支持随机颜色主题
+- **灵活配置**：支持全局配置和模板特定参数
+- **资源缓存**：内置文件和资源缓存机制，提升性能
+- **易于扩展**：基于抽象基类，方便添加自定义模板
+
+### 可用模板
+
+| 模板名称 | 描述 | 特性 |
+| :--- | :--- | :--- |
+| `minote` | 小米便签风格 | 背景图+边框+四角装饰 |
+| `simple` | 简约风格 | 纯色背景，支持昼夜模式 |
+| `ncm_zhusha` | 网易云朱砂样式 | 红色背景+白色标题框 |
+| `ncm_card` | 网易云热评卡片 | 音乐评论卡片样式 |
+| `bili` | 哔哩哔哩壁纸 | 支持昼夜模式 |
+| `help` | 帮助文档 | 支持随机颜色主题和昼夜模式 |
+| `table` | 表格展示 | 支持随机颜色主题和昼夜模式 |
+
+## 🖼️ 演示效果
+
+<details>
+<summary>点击展开查看各模板渲染效果</summary>
+
+### 小米便签 (minote)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/minote-demo.png" width="400">
+
+### 简约风格 (simple)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/simple-demo.png" width="400">
+
+### 网易云朱砂 (ncm_zhusha)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/ncm-zhusha-demo.png" width="400">
+
+### 网易云热评卡片 (ncm_card)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/ncm-card-demo.png" width="400">
+
+### 哔哩哔哩壁纸 (bili)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/bili-demo.png" width="400">
+
+### 帮助文档 (help)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/help-demo.png" width="400">
+
+### 表格展示 (table)
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/table-demo.png" width="400">
+
+</details>
+
+##  安装
+
+以下提到的方法 任选**其一** 即可
+
+<details open>
+<summary>[推荐] 使用 nb-cli 安装</summary>
+
+在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装
+
+```bash
+nb plugin install nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>使用包管理器安装</summary>
+
+在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令
+
+<details>
+<summary>pip</summary>
+
+```bash
+pip install nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>pdm</summary>
+
+```bash
+pdm add nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>poetry</summary>
+
+```bash
+poetry add nonebot_plugin_cardimg
+```
+
+</details>
+
+<details>
+<summary>conda</summary>
+
+```bash
+conda install nonebot_plugin_cardimg
+```
+
+</details>
+
+打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分的 `plugins` 项里追加写入
+
+```toml
+[tool.nonebot]
+plugins = [
+    # ...
+    "nonebot_plugin_cardimg"
+]
+```
+
+</details>
+
+## ⚙️ 配置
+
+在 nonebot2 项目的 `.env` 文件中添加下表中的配置
+
+| 配置项 | 必填 | 默认值 | 说明 |
+| :--- | :---: | :---: | :--- |
+| `cardimg_use_global_config` | 否 | `False` | 是否使用全局配置作为兜底 |
+| `cardimg_image_format` | 否 | `png` | 全局图片格式：png 或 jpeg |
+| `cardimg_jpeg_quality` | 否 | `85` | 全局 JPEG 质量：1-100 |
+
+## 🎉 使用
+
+### 基础用法
+
+```python
+from nonebot import require
+require("nonebot_plugin_cardimg")
+from nonebot_plugin_cardimg import render
+
+# 渲染小米便签模板
+img_bytes = await render(
+    'minote',
+    title='标题',
+    content='这是正文内容',
+    footer='页脚'
+)
+
+# 渲染简约模板（自动昼夜模式）
+img_bytes = await render(
+    'simple',
+    title='简约标题',
+    content='简约内容'
+)
+
+# 渲染帮助文档
+img_bytes = await render(
+    'help',
+    title='帮助文档',
+    items={
+        '命令1': '这是命令1的说明',
+        '命令2': '这是命令2的说明'
+    },
+    footer='更多帮助请访问...'
+)
+
+# 渲染表格
+img_bytes = await render(
+    'table',
+    title='排行榜',
+    tip='数据更新时间：2026-02-10',
+    columns=['排名', '用户', '分数'],
+    data=[
+        ['1', '用户A', '100'],
+        ['2', '用户B', '95'],
+        ['3', '用户C', '90']
+    ]
+)
+```
+
+### 高级用法
+
+#### 指定渲染参数
+
+```python
+img_bytes = await render(
+    'simple',
+    title='标题',
+    content='内容',
+    htmlkit_params={
+        'max_width': 800,
+        'image_format': 'jpeg',
+        'jpeg_quality': 90
+    }
+)
+```
+
+#### 手动控制昼夜模式
+
+```python
+# 强制使用夜间模式
+img_bytes = await render(
+    'simple',
+    title='标题',
+    content='内容',
+    night_mode=True
+)
+
+# 强制使用白天模式
+img_bytes = await render(
+    'simple',
+    title='标题',
+    content='内容',
+    night_mode=False
+)
+```
+
+#### 获取可用模板列表
+
+```python
+from nonebot_plugin_cardimg import list_templates
+
+templates = list_templates()
+print(templates)  # ['minote', 'simple', 'ncm_zhusha', 'ncm_card', 'bili', 'help', 'table']
+```
+
+### 接口方法参考
+
+#### `render(template, title="", content="", footer="", htmlkit_params=None, **kwargs)`
+
+渲染模板为图片
+
+**参数：**
+- `template` (str): 模板名称
+- `title` (str, optional): 标题
+- `content` (str, optional): 正文内容
+- `footer` (str, optional): 页脚
+- `htmlkit_params` (dict, optional): htmlkit 渲染参数
+- `**kwargs`: 模板特定参数
+###### 其中：`template` 是必填项，其他参数根据不同模板需求填写；`htmlkit_params` 是 htmlkit 插件的渲染方法参数，可用来自定义调整渲染尺寸、格式等内容。
+
+**返回：**
+- `bytes`: 图片字节数据
+
+**模板特定参数：**
+- `simple`/`bili`/`help`/`table`: `night_mode` (bool, optional) - 是否使用夜间模式
+- `help`: `items` (dict) - 帮助项字典
+- `table`: `columns` (list) - 表头列表, `data` (list[list]) - 表格数据, `tip` (str) - 提示文本
+
+## 📝 开发
+
+### 添加自定义模板
+
+```python
+from pathlib import Path
+from nonebot_plugin_cardimg import BaseTemplate
+
+
+class MyTemplate(BaseTemplate):
+    def __init__(self):
+        super().__init__("my_template", Path(__file__).parent / "templates")
+
+    async def render(self, **kwargs) -> bytes:
+        options = kwargs.pop("_render_options", self.get_render_options())
+        templates = {
+            "title": kwargs.get("title", ""),
+            "content": kwargs.get("content", ""),
+        }
+        return await self.to_pic_template("template.html", templates=templates, **options)
+```
+
+## 📞 联系
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/youlanan/nonebot-plugin-cardimg/main/docs/qrcode.png" width="200" alt="QQ群">
+
+</div>
+
+- 由于技术力和时间有限，本插件可能存在问题和不足，字体自定义以及图片压缩相关问题未能很好解决，欢迎优化或指正(๑˃̵ᴗ˂̵)₊♡ 
+- 由于技术力和时间有限，本项目的描述和代码排版由AI辅助完成，如有意外的错漏混淆欢迎反馈和指正(๑˃̵ᴗ˂̵)₊♡♡ 
+- 如有问题或建议，欢迎提交 Issue 或 Pull Request。
+
+## 💡 鸣谢
+
+- [nonebot-plugin-htmlkit](https://github.com/nonebot/plugin-htmlkit) - HTML 转图片核心库
+- [nonebot-plugin-txt2img](https://github.com/mobyw/nonebot-plugin-txt2img) - 模板样式参考
+- [nonebot-plugin-zxui](https://github.com/HibiKier/nonebot-plugin-zxui) - 模板样式参考
+- [nonebot-plugin-template](https://github.com/lgc-NB2Dev/nonebot-plugin-template) - 插件模板
+
+## 📝 更新日志
+
+### v0.1.0 (2026-02-10)
+
+- 初始版本发布（仅在 Docker 环境下测试通过，暂未解决默认字体替换问题）