» DOCX 读取与媒体 » DOCX 结构化生成 » Word 受控编辑
无 Office/WPS 依赖的 WordprocessingML 读取、媒体导出、受控编辑与结构化 DOCX 生成。
读取支持 docx/docm/dotx/dotm 的 Transitional/Strict 核心命名空间，不执行宏。
write 便捷转发 builder；受控编辑请按需导入 fsys.openXml.docx.editor；仅生成时可独立导入 builder，避免加载读取器。
不做排版渲染、公式/域更新、XSD 或完整 MC 校验。
平铺复制媒体原始字节，默认 overwrite=false；maxMedia 限制成功导出个数，跳过不计数。
返回 outputDir,files,skipped，可有 truncated；失败返回 null,err,partial。
逐文件校验/临时提交，重名预检，保护源文档；不是整批事务，不执行或转码资源。
按包关系读取核心/扩展属性；缺少属性关系合法返回基础 path 字段。
损坏、缺失目标或外部属性关系返回 null,err；不假装为空属性成功。
验证 Word 主部件后返回 ZIP 元信息数组，含真实目录项。
pattern 为可选 aardio 模式串；options 支持通用包限额。
列出 word/media/ 及主部件同级 media/ 下的全部文件（含子目录/未引用项）。
字段 partName,name,ext,size,compressedSize,contentType；不扫描任意位置的全部关系资源，不读媒体内容。
返回对象:openXmlWordDocumentObject
读取普通文本、段落、物理单元格表格和文档属性，返回普通表；自动关闭包。失败 null,err。
includeText/includeParagraphs/includeTables/includeProperties 默认 true，includeMedia 默认 false。
includeHeaders/includeFooters/includeFootnotes/includeEndnotes/includeComments 默认 false。
keepEmptyParagraphs 默认 true，trim/trimText 默认 false；paragraphSeparator 默认 CRLF，cellParagraphSeparator 默认 LF。
maxParagraphs/maxTables/maxRows/maxColumns/maxTextBytes/maxMedia 为非负整数；0 表示不取，省略不截取。内容截取会设置 truncated 和 warnings，不替代包层安全限额。
仅返回段落数组；成功第三返回值为 warnings，失败 null,err。
选项同 read，不读属性/媒体。不要将附加返回值直接传给只接受单值的函数。
仅返回表格数组，成功第三返回值为 warnings。
不将物理合并单元格展开成矩形网格；不生成字段对象（技能包兼容层提供 rowsToTable）。
结构化生成 .docx，便捷转发 fsys.openXml.docx.builder.write。
document={blocks=[...];numbering=[...]}；默认不覆盖，成功返回完整路径,null,report，失败 null,err。
不是已有文档的保真重建；已有普通正文和未合并矩形表格可按需导入 fsys.openXml.docx.editor 受控编辑，复杂编辑继续使用 Office/WPS COM。
从包关系定位的核心/扩展属性；日期保留保存的字符串。页数等是保存的元数据，不重新计算。
由包关系定位的主部件名。
includeMedia=true 时的目录媒体清单；字段同 listMedia。
本次保留的段落个数；不是分页或全文统计。
数组项含 index,text,source,partName，可含 storyId,styleId,outlineLevel。
styleId 是保存的样式 ID；outlineLevel 是保存的 0 基值，不解析样式继承。
源文件完整路径。
正文及请求的附属部件数组：source,partName,relationshipId。
页眉/页脚按正文节属性首次引用顺序去重追加，不展开到各页；脚注/尾注/批注随后按部件内顺序追加。
本次返回表格的个数。
数组项含 index,rows,rowCount,columnCount,source,partName,depth，可含 storyId。
rows 为物理单元格二维文本数组，不展开合并格；嵌套表单独列出，外层单元格含其文本。
按段落顺序合并的文本（包括表格内段落），不是页面排版还原。
includeParagraphs=false 不影响文本读取；includeText=false 时不返回此字段。
是否因内容选择限额丢弃了部分输出；包/XML 安全限额超限则失败而非截取。
code,message,partName 数组：内容截取、基础修订/域处理及未支持内容。不是完整遗漏清单。