3.9 KiB
3.9 KiB
title, type, tags, date
| title | type | tags | date |
|---|---|---|---|
| Document Generator Agent | source | 2026-04-29 |
Source File
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