astrbot_plugin_qq_group_daily_analysis/PDF_功能说明.md

QQ群日常分析插件 - PDF 功能说明

概述

本插件现已支持生成 PDF 格式的群聊分析报告，提供更专业的报告输出格式。

功能特性

• 📄 PDF 报告生成: 将群聊分析结果导出为精美的 PDF 文档
• 🎨 专业排版: 针对 PDF 打印优化的样式设计
• 📊 完整内容: 包含所有分析数据（统计信息、话题分析、用户称号、群聊金句）
• 🔧 灵活配置: 可自定义输出目录和文件名格式

安装依赖

使用 PDF 功能前，需要安装 pyppeteer 库。有以下几种安装方式：

方式一：使用命令安装（推荐）

在群聊中直接使用安装命令：

/安装PDF

此命令会自动：

• 检查 pyppeteer 是否已安装
• 如未安装，自动安装 pyppeteer 库
• 下载 Chromium 浏览器
• 测试 PDF 功能是否正常

方式二：手动安装

pip install pyppeteer==1.0.2

首次使用时，pyppeteer 还需要下载 Chromium 浏览器，请确保网络连接正常。

使用方法

1. 设置输出格式

使用新增的 /设置格式 命令来切换输出格式：

/设置格式 pdf

支持的格式：

• image - 图片格式（默认）
• text - 文本格式
• pdf - PDF 格式

2. 生成 PDF 报告

设置为 PDF 格式后，使用常规的分析命令：

/群分析
/群分析 3  # 分析近3天的数据

3. 查看当前设置

/设置格式  # 不带参数，查看当前格式设置
/分析设置 status  # 查看完整的插件状态

配置选项

在 config.json 中可以配置以下 PDF 相关选项：

{
  "output_format": "pdf",
  "pdf_output_dir": "reports",
  "pdf_filename_format": "群聊分析报告_{group_id}_{date}.pdf"
}

配置说明

• output_format: 输出格式，可选 "image"、"text"、"pdf"
• pdf_output_dir: PDF 文件保存目录
• pdf_filename_format: PDF 文件名格式，支持以下占位符：
  • {group_id}: 群组ID
  • {date}: 日期（YYYYMMDD 格式）

PDF 报告内容

生成的 PDF 报告包含以下部分：

1. 报告标题和日期

2. 基础统计数据

   • 消息总数
   • 参与人数
   • 总字符数
   • 表情数量
   • 最活跃时段

3. 热门话题分析

   • 话题名称
   • 主要参与者
   • 详细描述

4. 群友称号

   • 用户昵称
   • 获得称号
   • MBTI 类型
   • 获得理由

5. 群聊金句

   • 精选的有趣发言
   • 发言人
   • 选择理由

故障排除

pyppeteer 版本要为稳定版的 1.0.2。

1. pyppeteer 安装失败

# 使用国内镜像安装
pip install pyppeteer -i https://pypi.tuna.tsinghua.edu.cn/simple/

2. Chromium 下载失败

# 手动下载 Chromium
python -m pyppeteer.install

3. PDF 生成失败

• 检查系统内存是否充足
• 确保有足够的磁盘空间
• 检查输出目录权限

4. 中文字体显示问题

PDF 使用系统默认字体，如果中文显示异常，请确保系统安装了中文字体。

性能说明

• PDF 生成比图片格式稍慢，通常需要 3-10 秒
• 首次使用时需要启动浏览器，可能需要更长时间
• 建议在服务器资源充足时使用

更新日志

v1.1.0

• ✨ 新增 PDF 报告生成功能
• ✨ 新增 /设置格式 命令
• 🎨 优化 PDF 样式和排版
• 📝 完善配置选项和文档

技术实现

PDF 生成基于以下技术：

• pyppeteer: 无头浏览器控制
• HTML/CSS: 报告模板和样式
• 异步处理: 非阻塞的 PDF 生成过程

注意事项

1. PDF 功能需要额外的系统资源，建议在配置较好的服务器上使用
2. 生成的 PDF 文件会保存在指定目录中，注意定期清理
3. 如果遇到权限问题，请检查输出目录的写入权限