适用场景

当主要交付物为 Microsoft Word 文档或 .docx 文件时使用，尤其在涉及修订痕迹、批注、页眉页脚、编号、域字段、表格、模板或跨平台兼容性等关键需求时。

核心规则

1. 将 DOCX 视为 OOXML，而非纯文本

• .docx 文件本质上是一个包含多个 XML 部件的 ZIP 包，因此文档结构与可见文本同等重要。
• 关键部件通常包括 word/document.xml、styles.xml、numbering.xml、页眉/页脚文件及关系（relationship）文件。
• 文本可能被拆分至多个 run 节点中；切勿假设一个单词或一句话必然完整存在于单个 XML 节点内。
• 应有意识地区分不同工作流：结构化提取适用于快速阅读，样式驱动生成适用于新建文件，而具备 OOXML 意识的编辑则适用于处理已有且结构敏感的文档。
• 若任务以阅读、提取或审阅为主，建议优先采用保结构的读取路径，再决定是否深入 OOXML 层面操作。
• 进行深度编辑时，应检查 ZIP 包内部布局，而非仅依赖渲染后的视觉输出。
• 即使格式相同，「阅读」、「生成」与「保留已审阅文档完整性」仍是三项截然不同的任务。
• 旧版 .doc 输入文件通常需先完成转换，方可安全应用现代 .docx 的各项假设。

2. 有意识地保留样式与直接格式化

• 优先使用命名样式（named styles），而非直接格式化（direct formatting），以保障文档长期可编辑性。
• 样式具有层级结构：段落样式、字符样式与直接格式化三者行为互不相同。
• 移除直接格式化通常比叠加更多行内格式更安全。
• 编辑已有文件时，应扩展当前样式体系，而非另行构建一套平行样式系统。
• 跨文档复制内容可能静默引入外部样式、主题设置及编号定义。

3. 列表与编号自成独立系统

• 项目符号与编号由 Word 的编号定义（numbering definitions）控制，而非粘贴所得的 Unicode 字符。
• abstractNum、num 及段落编号属性均影响行为，因此编号重启逻辑极少仅为“视觉层面”生效。
• 缩进与编号相关但不等价；即使缩进显示正常，列表仍可能出现编号中断。
• 某列表在某一编辑器中看似正确，但若底层编号状态异常，则后续可能在其他上下文中自动重启、扁平化或重编号。

4. 页面布局由节（section）控制

• 页边距、纸张方向、页眉页脚及页码均为节级（section-level）行为。
• 同一文档内，首页与奇偶页页眉可分别定义，因此仅修复一处页眉未必解决全文档问题。
• 请显式设定纸张尺寸，因 A4 与 US Letter 默认值差异将影响分页及表格宽度。
• 布局变更应使用分节符（section break），手动空行或孤立分页符易导致排版漂移（drift）。
• 页眉页脚中的媒体资源依赖部件专属的关系定义，盲目复用 ID 常导致图片或链接失效。
• 表格、分页符与页眉常联动漂移，因此布局修复应视为整篇文档级操作，而非局部美化调整。
• 表格几何尺寸取决于页面宽度、页边距及固定列宽；所谓“大致合适”的表格修改，常在 Google Docs 或 LibreOffice 中后续失效。

5. 修订痕迹、批注与域字段需精确编辑

• 启用修订模式后，所见文本并非文档全部内容。
• 插入、删除与批注均携带元数据，可能在粗心编辑中意外残留。
• 已删除文本可能仍存在于 XML 中，尽管其不再显示于界面。
• 若编辑过程中移动文本却未保留周边结构，批注锚点（comment anchors）与审阅范围（review ranges）可能失效。
• 批注标记与审阅包装器（review wrappers）的行为不同于行内格式，随意移动文本易导致其孤立或错位。
• 批注、脚注、书签及关联媒体资源可能分布于独立部件中，而不仅位于主文档正文内。
• 目录、页码、日期、交叉引用及邮件合并占位符均属域字段（fields）。
• 请谨慎编辑域源，且须知缓存显示值将在刷新前持续滞后。
• 超链接、书签与引用若因 ID 或关系匹配失效，即会中断。
• 书签、脚注、批注范围与交叉引用均依赖稳定锚点，即便可见文本表面未改动。
• 文档外观虽无异常，仍可能隐含陈旧域输出，待刷新后呈现不同结果。
• 在审阅工作流中，应尽量执行最小化替换，避免整段重写。
• 在开启修订模式的工作流中，仅变更部分应呈现修订状态；大范围重写将造成审阅噪音，并破坏原始格式上下文。
• 针对法律、学术或商业审阅文档，默认应采用审阅式编辑（review-style edits），而非全段重写——除非用户明确要求重写。

6. 交付前验证往返兼容性

• 复杂文档在 Word、LibreOffice、Google Docs 及各类转换工具间易发生偏移。
• 表格、页眉页脚、嵌入字体及复制样式是排版漂移的常见诱因。
• 请将 .docm 视为含宏文件，风险更高；将 .doc 视为遗留输入，通常需先行转换。
• 当排版至关重要时，显式设定表格宽度比自动适配（auto-fit）或百分比式宽度更可靠——后者在不同编辑器中解释方式各异。
• 一份通过纯文本校验的文档，仍可能在收件人打开后出现分页错乱、表格宽度异常或域刷新失败等问题。

常见陷阱

• 复制粘贴可能导入非预期的样式与编号定义。
• 页眉页脚中的图片依赖部件专属关系，盲目复用 ID 将导致其失效。
• 以空段落实现间距会使模板脆弱；间距应通过段落设置控制。
• 外观整洁的导出文件仍可能隐藏未解决的修订、批注或陈旧域值。
• 仅凭肉眼“重置”列表编号通常失败，因编号状态独立于段落文本之外。
• 一个可见短语可能跨越多个 run、书签、修订标签或域边界。
• 为修改单一条款而替换整段，常损害审阅质量、书签、批注或邻近行内格式。
• 从段落或列表项中删除全部可见文本，仍可能残留空段落标记、空项目符号或不稳定编号。
• 表格自动适配及类百分比宽度在 Word 中看似正常，却仍可能在 Google Docs 或 LibreOffice 中发生漂移。
• 即使 Word 显示完美，LibreOffice 与 Google Docs 仍可能偏移复杂表格、节行为及嵌入字体。
• 兼容模式可能静默限制新特性支持，或改变分页行为。
• 单次纸张尺寸或页边距默认值变更，可能波及表格、页眉、目录（TOC）及交叉引用。
• 修订工作流在界面上看似已全部接受，但残留元数据、批注或域缓存仍可能导致文件后续不稳定。
• 目录条目、脚注与交叉引用在刷新前看似正常，一旦收件人更新域，即暴露锚点断裂问题。

相关技能

若用户确认，可通过 clawhub install 安装：

• documents —— 通用文档处理与格式转换。
• brief —— 简明商务写作与结构化摘要。
• article —— 长文起草与编辑结构组织。

反馈

• 若本指南有用：clawhub star word-docx
• 保持更新：clawhub sync