---
title: "Document Generator Agent"
type: source
tags: []
date: 2026-04-29
---

## Source File
- [[Agent/agency-agents/specialized/specialized-document-generator.md]]

## Summary（用中文描述）
- 核心主题：程序化生成专业文档（PDF/PPTX/DOCX/XLSX）的 AI Agent 个性化定义
- 问题域：企业级文档自动化生成——如何通过代码工具而非 GUI 工具批量生成品牌一致的格式化文档
- 方法/机制：Python（reportlab/weasyprint/python-pptx/openpyxl/python-docx）和 Node.js（puppeteer/pdf-lib/pptxgenjs/exceljs/docx）双技术栈；HTML+CSS→PDF 复杂布局；模板驱动品牌一致性；数据驱动文档生成
- 结论/价值：文档生成 Agent 应使用文档样式而非硬编码字体/尺寸；可复用模板函数而非一次性脚本；无障碍设计（alt text、标题层级、标签化 PDF）内置于架构

## Key Claims（用中文描述）
- Document Generator Agent 使用代码工具而非 GUI 工具生成专业文档，覆盖 PDF/演示文稿/电子表格/Word 四大格式
- PDF 生成优先 HTML+CSS→PDF 路径处理复杂布局，直接生成用于数据报告
- 演示文稿采用模板化方法确保品牌一致性，支持数据驱动幻灯片生成
- 电子表格生成强调结构化数据、公式、图表和透视分析就绪布局
- Word 文档基于样式模板，支持页眉/页脚、目录和一致性格式
- 五条核心规则：使用文档样式而非硬编码、品牌一致性、数据驱动、无障碍设计、可复用模板

## Key Quotes
> "Use proper styles — Never hardcode fonts/sizes; use document styles and themes" — 核心设计原则：依赖文档样式系统而非硬编码格式
> "Accessible — Add alt text, proper heading hierarchy, tagged PDFs when possible" — 无障碍设计是默认要求而非后期添加
> "Reusable templates — Build template functions, not one-off scripts" — 模板函数设计理念

## Key Concepts
- [[Code-Based Document Generation]]：通过编程库而非 GUI 工具生成文档，支持批量自动化
- [[Document Styles]]：文档样式系统（styles/themes）vs 硬编码格式，前者保证一致性和可维护性
- [[HTML-to-PDF Conversion]]：使用 WeasyPrint/Puppeteer 将 HTML+CSS 渲染为 PDF，适合复杂布局
- [[Template-Driven Generation]]：基于模板的文档生成确保品牌一致性
- [[Data-Driven Documents]]：接受结构化数据输入，生成动态文档内容

## Key Entities
- [[The Agency]] Specialized 部门：Document Generator Agent 所属组织
- [[ReportLab]]：Python PDF 生成库
- [[WeasyPrint]]：Python HTML+CSS→PDF 工具
- [[python-pptx]]：Python PPTX 生成库
- [[pptxgenjs]]：Node.js 演示文稿生成库
- [[openpyxl]] / [[xlsxwriter]]：Python XLSX 生成库
- [[python-docx]]：Python DOCX 生成库

## Connections
- [[design-visual-storyteller]] ← depends_on ← [[specialized-document-generator]]（Visual Storyteller 输出的视觉内容可嵌入 Document Generator 生成的报告中）
- [[specialized-document-generator]] ← extends ← [[report-distribution-agent]]（Document Generator 生成报告 → Distribution Agent 负责分发）
- [[sales-proposal-strategist]] ← depends_on ← [[specialized-document-generator]]（销售提案策略师依赖文档生成器输出专业提案文档）

## Contradictions
- 与 [[latex-paper-writing]] 冲突：
  - 冲突点：LaTeX 适合学术论文（精确排版、数学公式），Document Generator 适合商业文档（品牌模板、数据驱动报表）
  - 当前观点：商业文档生成优先使用 python-docx/pptxgenjs/openpyxl 等办公软件原生格式，易于非技术用户编辑
  - 对方观点：学术/技术文档优先使用 LaTeX，保证跨平台排版一致性和数学公式渲染质量
  - 协调方案：按文档类型分工——商业报告（财务/提案/合规）→ Document Generator；学术论文/技术规范 → LaTeX Pipeline