mirror of
https://github.com/Nezumi-2711/astrbot_plugin_qq_group_daily_analysis.git
synced 2026-09-22 05:31:52 +00:00
SXP-Simon
d03b3d5b42
- 修复 'NoneType' 报错 (Fix #125): 引入插件终止标志位并完善任务生命周期清理逻辑。 - 强化资源清理：重载时主动取消并等待所有运行中的异步任务（包括手动分析、自动调度和依赖安装），移除危险的属性置空操作，彻底消除重载时的属性访问竞态。
2.4 KiB
2.4 KiB
群日常分析插件 - PDF 功能说明
概述
本插件现已支持生成 PDF 格式的群聊分析报告，提供更专业的报告输出格式。PDF 引擎已迁移至 Playwright，提供更好的兼容性。
功能特性
- 📄 PDF 报告生成: 将群聊分析结果导出为精美的 PDF 文档
- 🎨 专业排版: 针对 PDF 打印优化的样式设计
- 📊 完整内容: 包含所有分析数据（统计信息、话题分析、用户称号、群聊金句）
- 🔧 灵活配置: 可自定义输出目录、文件名格式以及自定义浏览器路径
安装依赖
使用 PDF 功能前，需要安装 playwright 库。有以下几种安装方式：
方式一：使用命令安装（推荐）
在群聊中直接使用安装命令：
/安装PDF
此命令会自动：
- 检查 playwright 是否已安装
- 如未安装，自动安装 playwright 库
- 检查是否需要下载 Chromium 浏览器（已配置自定义路径则跳过）
- 测试 PDF 功能是否正常
方式二：手动安装
pip install playwright
playwright install chromium
使用方法
1. 设置输出格式
使用新增的 /设置格式 命令来切换输出格式：
/设置格式 pdf
2. 生成 PDF 报告
设置为 PDF 格式后，使用常规的分析命令：
/群分析
3. 高级配置：自定义浏览器路径
如果您希望使用系统中已有的 Chrome 或 Edge，或者在特定的路径下运行浏览器，可以在配置中设置 browser_path：
{
"browser_path": "C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"
}
故障排除
1. Playwright 安装失败
请确保您的系统网络能够访问官网下载浏览器内核。如果是在受限环境下，建议使用系统的 Chrome/Edge 并配置 browser_path。
2. PDF 生成失败
- 检查
browser_path是否正确且可执行。 - 确保系统安装了必要的字体。
更新日志
v1.2.0
- 🚀 Playwright 迁移: 替换了不稳定的 pyppeteer。
- 🛠️ 自定义浏览器: 支持手动指定 Chrome/Edge 路径。
- ⚡ 安装优化: 自动检测系统浏览器并减少不必要的下载。
技术实现
PDF 生成基于以下技术：
- Playwright: 现代无头浏览器控制
- HTML/CSS: 报告模板和样式
- 异步处理: 非阻塞的 PDF 生成过程