简诗DOCX构建器

核心能力与工作流

处理 .docx 文件时，常规的文本替换往往难以应对复杂的排版修改。当任务涉及调整段落样式、合并多个模板、或为多章节文档设置不同的页眉页脚时，直接生成或修改底层 XML 极易导致文件损坏。
该技能基于 OpenXML SDK 与 .NET 框架，提供双路径操作方案：

• CLI 快速通道：适合结构单一的文档生成与占位符填充，支持 --toc、--margins 等参数快速构建基础报告或信函。
• C# 脚本直写：应对多分节布局、复杂表格、页眉页脚插入等结构级修改时，直接编写 C# 代码调用 SDK。内置的 Samples/*.cs 目录提供了经 SDK 版本验证的可编译模式。在编写代码前，需优先查阅对应的示例文件与参考文档。

所有修改操作均遵循“预览 -> 分析 -> 编辑 -> 校验”的流程，避免直接读取原始 XML 带来的错误。

工程实践与关键规则

为了保证文件的有效性，技能内置了严格的校验管线：

• 强校验机制：每次写入后建议运行 XSD 校验。若 XSD 失败，系统会自动尝试修复；若仍不通过，则回退至业务规则检查与最终预览。
• 元素顺序规范：OpenXML 对元素顺序有严格要求。例如 w:p 必须遵循 pPr -> runs 的顺序，w:body 的 sectPr 必须是最后一个子元素。
• 样式与格式：定义标题样式时必须包含 OutlineLevel，否则 Word 的导航窗格和目录将无法识别。复制内容时需清理内联格式，避免污染模板样式。

适用边界与注意点

该技能聚焦于本地文档的生成与格式化，不包含自动安装依赖、修改系统权限或执行外部下载内容的操作。

• 多模板合并：合并多个模板文件时，需将所有样式合并至一个 styles.xml，而文档结构由包含分节符的模板决定。严禁插入空段落作为填充或分隔符，应使用分节符属性（w:sectPr）来实现视觉隔离。
• 页眉页脚处理：针对包含 10 个以上分节的文档（如中文学位论文），必须保留模板原有的页眉页脚 XML。严禁从零重建或添加模板中不存在的格式，确保罗马数字页码与阿拉伯数字页码的正确分节。