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

## 概述

本插件现已支持生成 PDF 格式的群聊分析报告，提供更专业的报告输出格式。PDF 引擎已迁移至 Playwright，提供更好的兼容性。

## 功能特性

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

## 安装依赖

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

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

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

```
/安装PDF
```

此命令会自动：
- 检查 playwright 是否已安装
- 如未安装，自动安装 playwright 库
- 检查是否需要下载 Chromium 浏览器（已配置自定义路径则跳过）
- 测试 PDF 功能是否正常

### 方式二：手动安装

```bash
pip install playwright
playwright install chromium
```

## 使用方法

### 1. 设置输出格式

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

```
/设置格式 pdf
```

### 2. 生成 PDF 报告

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

```
/群分析
```

### 3. 高级配置：自定义浏览器路径

如果您希望使用系统中已有的 Chrome 或 Edge，或者在特定的路径下运行浏览器，可以在配置中设置 `browser_path`：

```json
{
  "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 生成过程