fix(pdf): 迁移为 playwright

Author: SXP-Simon

PDF_功能说明.md

@@ -2,18 +2,18 @@
 
 ## 概述
 
-本插件现已支持生成 PDF 格式的群聊分析报告，提供更专业的报告输出格式。
+本插件现已支持生成 PDF 格式的群聊分析报告，提供更专业的报告输出格式。PDF 引擎已迁移至 Playwright，提供更好的兼容性。
 
 ## 功能特性
 
 - 📄 **PDF 报告生成**: 将群聊分析结果导出为精美的 PDF 文档
 - 🎨 **专业排版**: 针对 PDF 打印优化的样式设计
 - 📊 **完整内容**: 包含所有分析数据（统计信息、话题分析、用户称号、群聊金句）
-- 🔧 **灵活配置**: 可自定义输出目录和文件名格式
+- 🔧 **灵活配置**: 可自定义输出目录、文件名格式以及**自定义浏览器路径**
 
 ## 安装依赖
 
-使用 PDF 功能前，需要安装 pyppeteer 库。有以下几种安装方式：
+使用 PDF 功能前，需要安装 playwright 库。有以下几种安装方式：
 
 ### 方式一：使用命令安装（推荐）
 
@@ -23,22 +23,19 @@
 /安装PDF
 ```
 
-提示： 首次使用命令安装，最后出现提示告诉你需要重启生效，是对的，需要重启 astrbot，而不是热重载插件。
-
 此命令会自动：
-- 检查 pyppeteer 是否已安装
-- 如未安装，自动安装 pyppeteer 库
-- 下载 Chromium 浏览器
+- 检查 playwright 是否已安装
+- 如未安装，自动安装 playwright 库
+- 检查是否需要下载 Chromium 浏览器（已配置自定义路径则跳过）
 - 测试 PDF 功能是否正常
 
 ### 方式二：手动安装
 
 ```bash
-pip install pyppeteer==1.0.2
+pip install playwright
+playwright install chromium
 ```
 
-首次使用时，pyppeteer 还需要下载 Chromium 浏览器，请确保网络连接正常。
-
 ## 使用方法
 
 ### 1. 设置输出格式
@@ -49,106 +46,45 @@ pip install pyppeteer==1.0.2
 /设置格式 pdf
 ```
 
-支持的格式：
-- `image` - 图片格式（默认）
-- `text` - 文本格式  
-- `pdf` - PDF 格式
-
 ### 2. 生成 PDF 报告
 
 设置为 PDF 格式后，使用常规的分析命令：
 
 ```
 /群分析
-/群分析 3  # 分析近3天的数据
-```
-
-### 3. 查看当前设置
-
 ```
-/设置格式  # 不带参数，查看当前格式设置
-/分析设置 status  # 查看完整的插件状态
-```
-
-## PDF 报告内容
-
-生成的 PDF 报告包含以下部分：
-
-1. **报告标题和日期**
-2. **基础统计数据**
-   - 消息总数
-   - 参与人数  
-   - 总字符数
-   - 表情数量
-   - 最活跃时段
-
-3. **热门话题分析**
-   - 话题名称
-   - 主要参与者
-   - 详细描述
-
-4. **群友称号**
-   - 用户昵称
-   - 获得称号
-   - MBTI 类型
-   - 获得理由
 
-5. **群聊金句**
-   - 精选的有趣发言
-   - 发言人
-   - 选择理由
+### 3. 高级配置：自定义浏览器路径
 
-## 故障排除
-
-pyppeteer 版本要为稳定版的 1.0.2。
-
-### 1. pyppeteer 安装失败
-
-```bash
-# 使用国内镜像安装
-pip install pyppeteer -i https://pypi.tuna.tsinghua.edu.cn/simple/
-```
+如果您希望使用系统中已有的 Chrome 或 Edge，或者在特定的路径下运行浏览器，可以在配置中设置 `browser_path`：
 
-### 2. Chromium 下载失败
-
-```bash
-# 手动下载 Chromium
-python -m pyppeteer.install
+```json
+{
+  "browser_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
+}
 ```
 
-### 3. PDF 生成失败
-
-- 检查系统内存是否充足
-- 确保有足够的磁盘空间
-- 检查输出目录权限
+## 故障排除
 
-### 4. 中文字体显示问题
+### 1. Playwright 安装失败
 
-PDF 使用系统默认字体，如果中文显示异常，请确保系统安装了中文字体。
+请确保您的系统网络能够访问官网下载浏览器内核。如果是在受限环境下，建议使用系统的 Chrome/Edge 并配置 `browser_path`。
 
-## 性能说明
+### 2. PDF 生成失败
 
-- PDF 生成比图片格式稍慢，通常需要 3-10 秒
-- 首次使用时需要启动浏览器，可能需要更长时间
-- 建议在服务器资源充足时使用
+- 检查 `browser_path` 是否正确且可执行。
+- 确保系统安装了必要的字体。
 
 ## 更新日志
 
-### v1.1.0
-- ✨ 新增 PDF 报告生成功能
-- ✨ 新增 `/设置格式` 命令
-- 🎨 优化 PDF 样式和排版
-- 📝 完善配置选项和文档
+### v1.2.0
+- 🚀 **Playwright 迁移**: 替换了不稳定的 pyppeteer。
+- 🛠️ **自定义浏览器**: 支持手动指定 Chrome/Edge 路径。
+- ⚡ **安装优化**: 自动检测系统浏览器并减少不必要的下载。
 
 ## 技术实现
 
 PDF 生成基于以下技术：
-- **pyppeteer**: 无头浏览器控制
+- **Playwright**: 现代无头浏览器控制
 - **HTML/CSS**: 报告模板和样式
 - **异步处理**: 非阻塞的 PDF 生成过程
-
-## 注意事项
-
-1. PDF 功能需要额外的系统资源，建议在配置较好的服务器上使用
-2. 生成的 PDF 文件会保存在指定目录中，注意定期清理
-3. 如果遇到权限问题，请检查输出目录的写入权限

_conf_schema.json

@@ -185,6 +185,12 @@
         "default": "data/plugins/astrbot_plugin_qq_group_daily_analysis/reports",
         "hint": "PDF报告文件的保存目录"
     },
+    "browser_path": {
+        "type": "string",
+        "description": "自定义浏览器路径",
+        "default": "",
+        "hint": "要填写的话请你清楚自己在干什么。自定义浏览器的可执行文件路径（如 Chrome 或 Edge 的 .exe 文件）。提示：如果是在网页后台设置，则直接输入普通路径即可（如 C:\\Program Files\\...）；如果是手动编辑 config.json 文件，请务必使用双反斜杠 '\\\\' 分隔路径。"
+    },
     "pdf_filename_format": {
         "type": "string",
         "description": "PDF文件名格式",

main.py

@@ -275,9 +275,9 @@ async def analyze_group_daily(
                         f"[AstrBot QQ群日常分析总结插件] ⚠️ 图片报告生成失败，以下是文本版本：\n\n{text_report}"
                     )
             elif output_format == "pdf":
-                if not self.config_manager.pyppeteer_available:
+                if not self.config_manager.playwright_available:
                     yield event.plain_result(
-                        "❌ PDF 功能不可用，请使用 /安装PDF 命令安装 pyppeteer==1.0.2"
+                        "❌ PDF 功能不可用，请使用 /安装PDF 命令安装依赖"
                     )
                     return
 
@@ -342,8 +342,8 @@ async def set_output_format(
             current_format = self.config_manager.get_output_format()
             pdf_status = (
                 "✅"
-                if self.config_manager.pyppeteer_available
-                else "❌ (需安装 pyppeteer)"
+                if self.config_manager.playwright_available
+                else "❌ (需安装 Playwright)"
             )
             yield event.plain_result(f"""📊 当前输出格式: {current_format}
 
@@ -360,10 +360,8 @@ async def set_output_format(
             yield event.plain_result("❌ 无效的格式类型，支持: image, text, pdf")
             return
 
-        if format_type == "pdf" and not self.config_manager.pyppeteer_available:
-            yield event.plain_result(
-                "❌ PDF 格式不可用，请使用 /安装PDF 命令安装 pyppeteer==1.0.2"
-            )
+        if format_type == "pdf" and not self.config_manager.playwright_available:
+            yield event.plain_result("❌ PDF 格式不可用，请使用 /安装PDF 命令安装依赖")
             return
 
         self.config_manager.set_output_format(format_type)
@@ -540,14 +538,10 @@ async def install_pdf_deps(self, event: AiocqhttpMessageEvent):
         yield event.plain_result("🔄 开始安装 PDF 功能依赖，请稍候...")
 
         try:
-            # 安装 pyppeteer
-            result = await PDFInstaller.install_pyppeteer(self.config_manager)
+            # 安装 playwright (内部已包含浏览器内核安装逻辑)
+            result = await PDFInstaller.install_playwright(self.config_manager)
             yield event.plain_result(result)
 
-            # 提供系统依赖安装指导
-            system_deps_result = await PDFInstaller.install_system_deps()
-            yield event.plain_result(system_deps_result)
-
         except Exception as e:
             logger.error(f"安装 PDF 依赖失败: {e}", exc_info=True)
             yield event.plain_result(f"❌ 安装过程中出现错误: {str(e)}")

requirements.txt

@@ -1 +1 @@
-pyppeteer==1.0.2
+playwright>=1.40.0

scripts/mock_pdf_gen.py

@@ -60,9 +60,12 @@ def get_max_golden_quotes(self):
         return 5
 
     @property
-    def pyppeteer_available(self):
+    def playwright_available(self):
         return True
 
+    def get_browser_path(self):
+        return ""
+
 
 # ==========================================
 # 3. Main Execution