screenshot-tool

# Screenshot Tool - 网页 & 文档截图工具

支持网页截图和文档转高清图片，保留原始样式。

## 功能

| 功能 | 说明 |
|------|------|
| **网页截图** | 使用 headless 浏览器截图，支持整页、单页 |
| **文档转图** | PPT/Word/Excel/PDF 转 300 DPI 高清图片 |
| **高清输出** | 4000×2250 像素，适合打印和展示 |

## 依赖安装

### 必需依赖

| 依赖 | 用途 | 安装命令 |
|------|------|---------|
| **agent-browser** | 网页截图 | `npm install -g agent-browser && agent-browser install` |
| **LibreOffice** | 文档转 PDF | `sudo apt-get install -y libreoffice-impress libreoffice-writer libreoffice-calc` |
| **poppler-utils** | PDF 处理 | `sudo apt-get install -y poppler-utils` |
| **Python 库** | PDF 转图片 | `pip3 install pdf2image pillow` |

### 安装步骤

```bash
# 1. 安装 agent-browser（网页截图必需）
npm install -g agent-browser
agent-browser install
agent-browser install --with-deps  # 如需要系统依赖

# 2. 安装 LibreOffice（文档转换必需）
sudo apt-get install -y libreoffice-impress libreoffice-writer libreoffice-calc

# 3. 安装 poppler-utils（PDF 处理必需）
sudo apt-get install -y poppler-utils

# 4. 安装 Python 依赖
pip3 install pdf2image pillow

# 5. 安装中文字体（可选，用于中文文档）
sudo apt-get install -y fonts-wqy-zenhei fonts-wqy-microhei fonts-noto-cjk
```

### 验证安装

```bash
# 验证 agent-browser
agent-browser --version

# 验证 LibreOffice
libreoffice --version

# 验证 poppler
which pdftoppm pdfinfo
```

## 使用方法

### 1. 网页截图

```bash
# 截图单个网页
python3 skills/screenshot-tool/scripts/web_screenshot.py --url "https://example.com" --output page.png

# 截图并滚动（长页面）
python3 skills/screenshot-tool/scripts/web_screenshot.py --url "https://example.com" --full-page --output page.png
```

### 2. 文档转图片

```bash
# PPT/Word/Excel/PDF 转图片
python3 skills/screenshot-tool/scripts/doc_screenshot.py --input file.pptx --output-dir ./images

# 指定 DPI（默认 300）
python3 skills/screenshot-tool/scripts/doc_screenshot.py --input file.pdf --dpi 200 --output-dir ./images
```

### 3. 使用 agent-browser 截图

```bash
# 打开网页
agent-browser open "https://example.com" --timeout 60000

# 截图
agent-browser screenshot output.png --full

# 关闭浏览器
agent-browser close
```

## 支持的格式

### 文档格式
| 格式 | 扩展名 | 状态 |
|------|--------|------|
| PowerPoint | .pptx, .ppt | ✅ 支持 |
| Word | .docx, .doc | ✅ 支持 |
| Excel | .xlsx, .xls | ✅ 支持 |
| PDF | .pdf | ✅ 支持 |
| OpenDocument | .odp, .odt, .ods | ✅ 支持 |

### 网页截图
| 方式 | 说明 | 依赖 |
|------|------|------|
| agent-browser | 使用 headless Chrome | **agent-browser** |
| OpenClaw browser | 内置浏览器工具 | OpenClaw 内置 |

## 输出规格

| 参数 | 默认值 | 说明 |
|------|--------|------|
| DPI | 300 | 分辨率 |
| 格式 | PNG | 图片格式 |
| 尺寸 | 4000×2250 | 16:9 比例 |

## 示例

### 示例1：网页截图
```bash
# 截图京东首页
python3 skills/screenshot-tool/scripts/web_screenshot.py \
  --url "https://www.jd.com" \
  --output jd_homepage.png \
  --wait 5
```

### 示例2：PPT 转图片
```bash
# 转换整个 PPT
python3 skills/screenshot-tool/scripts/doc_screenshot.py \
  --input presentation.pptx \
  --output-dir ./slides \
  --dpi 300
```

### 示例3：PDF 转图片
```bash
# 转换 PDF 前5页
python3 skills/screenshot-tool/scripts/doc_screenshot.py \
  --input document.pdf \
  --output-dir ./pages \
  --first-page 1 \
  --last-page 5
```

## 流程说明

### 文档转图片流程
```
PPT/Word/Excel → LibreOffice → PDF → pdf2image → PNG (300 DPI)
                                         ↑
                                    依赖: poppler-utils
```

### 网页截图流程
```
URL → agent-browser (headless Chrome) → Screenshot → PNG
              ↑
        依赖: agent-browser CLI
```

## 故障排除

### LibreOffice 转换失败
```bash
# 检查 LibreOffice 安装
libreoffice --version

# 手动转换测试
libreoffice --headless --convert-to pdf file.pptx
```

### pdf2image 错误
```bash
# 检查 poppler 安装
which pdftoppm pdfinfo

# 重新安装
sudo apt-get install -y poppler-utils
```

### 中文字体显示问题
```bash
# 安装中文字体
sudo apt-get install -y fonts-wqy-zenhei fonts-wqy-microhei fonts-noto-cjk
```

## 文件结构

```
skills/screenshot-tool/
├── SKILL.md              # 本文件
├── scripts/
│   ├── web_screenshot.py    # 网页截图脚本
│   └── doc_screenshot.py    # 文档转图片脚本
└── README.md             # 详细说明
```

## License

MIT