gauto-report-pdflisted
Install: claude install-skill adiready/geo-auto-export
# GEO 报告 PDF 生成器(中国汽车出口版)
把一份报告 Markdown 渲染成**可直接发给客户或领导的 PDF**:
带深蓝封面、评分色阶表格、严重度分节、自动分页脚注。
## 与上游的区别(重要)
上游 `geo-report-pdf` 依赖 **pandoc + macOS Chrome 硬路径**。
本版**不依赖 pandoc**,改为零依赖链路:
```
报告 Markdown ──(markdown 库)──▶ HTML ──(Playwright Chromium 的 page.pdf)──▶ PDF
```
渲染引擎优先用 **Playwright 内置 Chromium**;若不可用,自动回退到**系统 Chrome/Edge 无头模式**。
Windows / macOS / Linux 通用。
## 前置依赖
只需 Python 库(本机托管 venv 已具备):
- `markdown`(Markdown → HTML)
- `playwright`(Chromium 渲染;内核已随环境安装)
> 无需 pandoc、无需 wkhtmltopdf、无需 ReportLab。
## 使用步骤
### 第 1 步:确认报告 Markdown 存在
默认对象是 `/gauto report` 产出的 `GEO-CLIENT-REPORT.md`(也接受 `GEO-AUDIT-REPORT.md` 或任意结构化报告)。
若不存在,先让用户跑 `/gauto report <url>`,或指定已有的报告文件路径。
### 第 2 步:运行脚本
```bash
PY="C:/Users/Administrator/.workbuddy/binaries/python/envs/default/Scripts/python.exe"
SKILL="C:/Users/Administrator/.workbuddy/skills/geo-auto-export"
"$PY" "$SKILL/scripts/report_pdf.py" GEO-CLIENT-REPORT.md -o GEO-CLIENT-REPORT.pdf
```
**封面元数据**:脚本会先自动从报告 Markdown 抓取(中英兼容),再用命令行参数覆盖。
| 字段 | 报告里的常见写法 | 覆盖参数 |
|---|---|---|
| 品牌名 | `**品牌:** 示例好车` / 首个 H1 | `--brand` |
| 域名 | `**域名:** xx.com` | `--domain` |
| GEO 分 | `## GEO 就绪分:58/100 —— 中等` | `--score` |
| 档位标签 | 同上行破折号后的中文 | `--label` |
| 审计日期 | `**审计日期:** 2026-09-16` | `--date` |
| 业务类型 | `**业务类型:** …` | `--business-type` |
| 目标市场 | `**目标市场:** …` | `--locations` |
| 平台 | `**平台:** …` | `--platform` |
示例(覆盖封面):
```bash
"$PY" "$SKILL/scripts/report_pdf.py" GEO-CLIENT-REPORT.md \
--brand "广东好车控股" --domain "china