WPS 办公文档生成器

问题从哪来

用 python-docx、openpyxl、python-pptx 写 Office 文件时，分栏、图文环绕、WordArt、合并/底纹表格、目录与页码 往往只能「堆 OOXML」，换行和分页与 WPS/Word 界面不一致。表格公式、列宽自适应、幻灯片 16:9 母版同样容易「看起来不对」。

技能如何工作

WPSComposer 通过 COM 驱动 WPS Office（Writer / Spreadsheets / Presentation），ProgID 链会在 WPS 不可用时回退到 Microsoft Office。布局由客户端引擎计算，输出与 GUI 所见一致，而不是手写 OOXML 猜排版。

• Markdown 入口：generate("report.md", format="docx", preset="academic") 等一行调用；底层 md_parser.py 解析为 StructuredDocument，再经格式渲染器交给 Composer。
• 细粒度编排：WriterComposer / SheetComposer / SlideComposer 支持分栏、浮动文本框、公式、幻灯片尺寸与标题页；可对已打开文档先 inspect 再按 element id 做 partial patch。
• 设计与版式：design_presets（academic、consultant、business 等）、layout_templates、幻灯片 quality_checks；PdfComposer 用 pypdf/pdfplumber 做合并、拆分、旋转、水印与抽文本（跨平台）。

适用边界

运行环境需 Windows，且安装 WPS 或 MS Office；Python 侧需 pywin32。PDF 原生排版验证可在开发时单独导出，但不应把 PDF 当作每次生成的默认交付物。对话式改稿时，省略 patch 字段表示保留原属性不变，具体 grammar 见技能内 references/api.md。