用途
docx-design-agent 是一个运行在 macOS 上的 Word 文档设计智能体。它的定位不是单纯的 python-docx 代码生成器，而是以“视觉艺术家”的方式处理 Word 文档：每个设计决策都应体现构图、节奏、视觉和谐与打磨感，目标是让文档看起来像专业平面设计师的作品，而非脚本自动生成。
主要能力
- 双引擎架构：python-docx（基于文件）负责批量创建、段落、run、表格、图片、样式、页眉页脚、节、页面设置以及通过 lxml 实现的复杂格式；AppleScript IPC（实时编辑）负责文本编辑、字体更改、查找替换、字段更新（目录、交叉引用、页码）、PDF 导出、打印设置与视图控制。黄金法则是“用 python-docx 构建，用 AppleScript 收尾”。
- 12 种预设设计风格：包括 STYLE-01 战略咨询、STYLE-02 高管编辑、STYLE-03 创意简报、STYLE-04 俏皮/卡哇伊、STYLE-05 企业现代（默认）、STYLE-06 大胆叙事、STYLE-07 温暖有机、STYLE-08 杂志编辑、STYLE-09 技术文档、STYLE-10 仪表盘报告、STYLE-11 作品集/画廊、STYLE-12 复古。若均不匹配，可即时生成自定义风格。
- AI 图像生成：可为封面与章节插图生成高清图片，需用户确认后逐张顺序生成（禁止并行）。
- 强制审计：每个新建或重设计文档在交付前必须通过 10 项检查（页面设置、字体合规、表格完整性、标题层级、页面流、图片完整性、颜色/填充完整性、间距一致性、风格合规、文档结构），最多迭代 5 轮直至干净。
- 19 条关键规则：涵盖字号下限（正文最低 10pt，脚注/题注 9pt，表格单元格最低 9pt）、显式页边距、XML 特殊字符转义、禁止用 emoji 作项目符号、装饰性元素、表格列宽计算、图片不变形等。
使用方式
文档路径存储在环境变量 DOCX_PATH 中，每个 Python 脚本必须读取 os.environ['DOCX_PATH']。首次使用前需安装依赖：
python3 -m pip install python-docx lxml Pillow --quiet
新建文档时，智能体会先询问风格选择与是否需要 AI 生成图片，等待用户回复后再继续。复杂文档按“每次工具调用构建一个章节”的方式增量构建，构建完成后运行强制审计与修复循环，再用 AppleScript 在 Word 中打开、更新字段、视觉验证、实时微调并保存（可选导出 PDF）。编辑现有文档时，小改动走 AppleScript 实时编辑，大改版走 python-docx 重建。
适用场景
适用于在 macOS 上创建或编辑需要专业设计品质的 Word 文档，例如咨询报告、高管摘要、创意简报、产品提案、技术文档、KPI 报告、作品集、活动手册等。
限制
该技能面向 macOS，依赖 AppleScript 与 Word 应用；实时编辑与收尾功能需要 Word 处于打开状态。图片生成依赖外部技能（baoyu-danger-gemini-web），且必须顺序生成。具体收费、价格与平台支持范围暂未提供。