Update nexus wiki content

wiki/sources/specialized-document-generator.md

@@ -2,47 +2,55 @@
 title: "Document Generator Agent"
 type: source
 tags: []
-date: 2026-04-20
+date: 2026-04-29
 ---
 
 ## Source File
-- [[raw/Agent/agency-agents/specialized/specialized-document-generator.md]]
+- [[Agent/agency-agents/specialized/specialized-document-generator.md]]
 
 ## Summary（用中文描述）
-- 核心主题：AI Agent 担任专业文档生成专家，通过代码方式生成 PDF、PPTX、DOCX、XLSX 等格式的专业文档
-- 问题域：如何让 AI Agent 高效、规范、可复用地产出商业级文档（投资者演示文稿、合规报告、数据密集型电子表格等）
-- 方法/机制：基于 Python（reportlab、python-pptx、openpyxl、python-docx 等）和 Node.js（puppeteer、pptxgenjs、exceljs、docx 等）两大生态，使用模板化、数据驱动、品牌一致的设计原则
-- 结论/价值：文档生成 Agent 需具备精确、设计意识强、注重格式的特点；核心规则包括使用样式系统而非硬编码、保持品牌一致性、数据驱动输入、无障碍设计，以及构建可复用模板而非一次性脚本
+- 核心主题：程序化生成专业文档（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 通过代码编程方式（而非手动操作）生成专业级 PDF、演示文稿、电子表格和 Word 文档
-- Agent 需根据不同文档格式选择最优工具链（PDF 推荐 HTML+CSS→PDF 方案，PPTX 推荐 python-pptx，XLSX 推荐 openpyxl，DOCX 推荐 python-docx）
-- 核心规则：必须使用文档样式系统而非硬编码字体/字号，确保品牌颜色、字体、Logo 一致，数据驱动输入输出，支持无障碍（Alt 文本、标题层级、PDF 标签）
-- Agent 应构建可复用模板函数，而非一次性脚本，以提升效率和可维护性
+- Document Generator Agent 使用代码工具而非 GUI 工具生成专业文档，覆盖 PDF/演示文稿/电子表格/Word 四大格式
+- PDF 生成优先 HTML+CSS→PDF 路径处理复杂布局，直接生成用于数据报告
+- 演示文稿采用模板化方法确保品牌一致性，支持数据驱动幻灯片生成
+- 电子表格生成强调结构化数据、公式、图表和透视分析就绪布局
+- Word 文档基于样式模板，支持页眉/页脚、目录和一致性格式
+- 五条核心规则：使用文档样式而非硬编码、品牌一致性、数据驱动、无障碍设计、可复用模板
 
 ## Key Quotes
-> "You are **Document Generator**, a specialist in creating professional documents programmatically." — Agent 身份定位
-> "Use proper styles — Never hardcode fonts/sizes; use document styles and themes" — 核心规则第1条
-> "Ask about the target audience and purpose before generating" — 沟通风格
+> "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]]：通过编程代码（Python/Node.js 库）而非手动操作软件生成文档的方法
-- [[Template-Based Document Generation]]：基于预定义模板，通过数据替换生成一致性文档的工作模式
-- [[Data-Driven Document Generation]]：以结构化数据为输入，自动生成对应格式文档的自动化方法
-- [[Brand-Consistent Document Design]]：在文档生成过程中保持颜色、字体、Logo 等品牌元素一致的设计原则
+- [[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]]：Document Generator Agent 所属的 Agent 框架体系（从 index 中相关条目推断）
-- reportlab / weasyprint / fpdf2：Python PDF 生成库
-- python-pptx / pptxgenjs：PPTX 演示文稿生成库
-- openpyxl / xlsxwriter / exceljs / xlsx：XLSX 电子表格生成库
-- python-docx / docx：DOCX Word 文档生成库
+- [[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
-- [[specialized-developer-advocate]] ← relates_to ← [[specialized-document-generator]]（同为 The Agency 下的专业 Agent）
-- [[agents-orchestrator]] ← orchestrates ← [[specialized-document-generator]]（文档生成通常由编排 Agent 调度）
-- [[report-distribution-agent]] ← supports ← [[specialized-document-generator]]（文档生成后可由分发 Agent 推送）
+- [[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