feat(export): 优化 Word 文档样式一致性和空段落格式处理

- 在注入样式后清除 python-docx 样式缓存，确保新样式生效
- 新增 Normal 样式间距校验，修复段落间距不一致问题
- 实现 _fix_normal_style_spacing() 函数，根据样式数据修正 Normal 样式的段后间距
- 处理多种 Normal 样式 ID 变体（styleId "1"、"Normal"、"normal"）
- 优化空段落字体提取逻辑，优先从 XML 直接格式化属性读取而非样式默认值
- 从段落 pPr/rPr XML 元素提取字体属性后再回退到样式定义
- 优先使用 eastAsia 字体属性以改善中文字符渲染效果
- 改进 word_parser 以处理空段落格式的边界情况

app/services/export_service.py

@@ -94,6 +94,16 @@ def inject_styles_from_json(doc: Document, style_data: dict) -> None:
     
     # 注入编号格式定义
     inject_numbering_from_json(doc, style_data)
+    
+    # 强制清除 python-docx 的样式缓存，确保后续使用的是新注入的样式
+    # 这一步很重要，因为 python-docx 会缓存样式对象
+    try:
+        # 清除样式字典缓存，强制重新从 XML 读取
+        if hasattr(doc.styles, '_element'):
+            # 触发样式重新加载
+            doc.styles._element = styles_element
+    except Exception:
+        pass
 
 
 def inject_numbering_from_json(doc: Document, style_data: dict) -> None:
@@ -279,6 +289,10 @@ def blocks_to_docx_bytes(blocks: list[dict], style_map: dict, style_data: dict)
     doc = Document()
     inject_styles_from_json(doc, style_data)
     
+    # 验证并修正 Normal 样式的段后间距
+    # 这是为了确保样式正确应用，避免 python-docx 的默认值覆盖
+    _fix_normal_style_spacing(doc, style_data)
+    
     # 检查 blocks 中是否有常用的字体和字号，用于修改 Normal 样式
     # 这样可以确保空行在 Word 中显示正确的字体
     _update_normal_style_if_needed(doc, blocks)
@@ -305,6 +319,94 @@ def blocks_to_docx_bytes(blocks: list[dict], style_map: dict, style_data: dict)
     return docx_bytes
 
 
+def _fix_normal_style_spacing(doc: Document, style_data: dict):
+    """验证并修正 Normal 样式的段后间距
+    
+    从 style_data 中读取 Normal 样式的段后间距定义，
+    确保文档中的 Normal 样式与之一致
+    
+    关键修复：python-docx 默认模板中 Normal 样式的 styleId 可能是 "Normal" 而不是 "1"，
+    需要同时检查这两种情况
+    """
+    try:
+        # 查找 Normal 样式的定义
+        normal_style_def = None
+        for style_entry in style_data.get("styles", []):
+            if style_entry.get("name") == "Normal" or style_entry.get("style_id") == "1":
+                normal_style_def = style_entry
+                break
+        
+        if not normal_style_def:
+            return
+        
+        # 从 full_xml_definition 中提取段后间距
+        xml_def = normal_style_def.get("full_xml_definition", {})
+        pPr = xml_def.get("@children", {}).get("{http://schemas.openxmlformats.org/wordprocessingml/2006/main}pPr", {})
+        spacing = pPr.get("@children", {}).get("{http://schemas.openxmlformats.org/wordprocessingml/2006/main}spacing", {})
+        spacing_attrib = spacing.get("@attrib", {})
+        
+        # 检查是否定义了段后间距
+        after_key = "{http://schemas.openxmlformats.org/wordprocessingml/2006/main}after"
+        has_after = after_key in spacing_attrib
+        after_value = spacing_attrib.get(after_key, "0")
+        
+        # 如果样式定义中没有 w:after 或者 w:after="0"，确保文档中所有 Normal 样式也是 0
+        if not has_after or after_value == "0":
+            styles_element = doc.styles.element
+            
+            # 需要修正的所有 Normal 样式 ID（python-docx 可能使用不同的 ID）
+            normal_style_ids = ["1", "Normal", "normal"]
+            
+            for style_id in normal_style_ids:
+                normal_elem = styles_element.find(
+                    f'.//{qn("w:style")}[@{qn("w:styleId")}="{style_id}"]'
+                )
+                
+                if normal_elem is not None:
+                    _apply_spacing_fix_to_style_elem(normal_elem)
+            
+            # 也尝试通过名称查找（可能有其他命名的 Normal 样式）
+            for style_elem in styles_element.findall(qn("w:style")):
+                name_elem = style_elem.find(qn("w:name"))
+                if name_elem is not None:
+                    name_val = name_elem.get(qn("w:val"))
+                    if name_val and name_val.lower() == "normal":
+                        _apply_spacing_fix_to_style_elem(style_elem)
+                
+    except Exception as e:
+        # 如果修正失败，不影响文档生成，只是可能保留默认的 10 磅间距
+        print(f"警告: 修正 Normal 样式段后间距失败: {e}")
+        pass
+
+
+def _apply_spacing_fix_to_style_elem(style_elem):
+    """对单个样式元素应用间距修复"""
+    try:
+        # 找到或创建 pPr 节点
+        pPr_elem = style_elem.find(qn("w:pPr"))
+        if pPr_elem is None:
+            pPr_elem = OxmlElement("w:pPr")
+            # 插入到第一个位置（在 name 之后）
+            name_elem = style_elem.find(qn("w:name"))
+            if name_elem is not None:
+                idx = list(style_elem).index(name_elem) + 1
+                style_elem.insert(idx, pPr_elem)
+            else:
+                style_elem.insert(0, pPr_elem)
+        
+        # 找到或创建 spacing 节点
+        spacing_elem = pPr_elem.find(qn("w:spacing"))
+        if spacing_elem is None:
+            spacing_elem = OxmlElement("w:spacing")
+            pPr_elem.append(spacing_elem)
+        
+        # 确保 w:after="0"（明确设置为 0，而不是依赖默认值）
+        spacing_elem.set(qn("w:after"), "0")
+        
+    except Exception:
+        pass
+
+
 def _update_normal_style_if_needed(doc: Document, blocks: list[dict]):
     """更新 Normal 样式以匹配 blocks 中最常用的字体
     

app/services/word_parser.py

@@ -569,17 +569,46 @@ def _extract_paragraph_format(para) -> dict:
             if all_same_color:
                 style['color'] = first_color
     else:
-        # 空段落（没有 runs）：从段落样式中提取默认字体和字号
-        style_font = _get_paragraph_style_font(para)
-        if style_font:
-            style['font_name'] = style_font
+        # 空段落（没有 runs）：先尝试从段落属性 XML 中提取直接格式化的字体和字号
+        pPr = para._element.find(qn('w:pPr'))
+        if pPr is not None:
+            rPr = pPr.find(qn('w:rPr'))
+            if rPr is not None:
+                # 从段落属性中提取字号（w:sz，单位是半磅）
+                sz = rPr.find(qn('w:sz'))
+                if sz is not None:
+                    size_val = sz.get(qn('w:val'))
+                    if size_val:
+                        try:
+                            style['font_size'] = int(size_val) / 2  # 转换为磅值
+                        except (ValueError, TypeError):
+                            pass
+                
+                # 从段落属性中提取字体
+                rFonts = rPr.find(qn('w:rFonts'))
+                if rFonts is not None:
+                    # 优先使用 eastAsia 字体（中文）
+                    eastAsia = rFonts.get(qn('w:eastAsia'))
+                    ascii_font = rFonts.get(qn('w:ascii'))
+                    # 如果有 eastAsia 字体就用，否则用 ascii
+                    if eastAsia:
+                        style['font_name'] = eastAsia
+                    elif ascii_font:
+                        style['font_name'] = ascii_font
         
-        # 尝试从段落样式中提取字号
-        try:
-            if hasattr(para.style, 'font') and para.style.font.size:
-                style['font_size'] = para.style.font.size.pt
-        except Exception:
-            pass
+        # 如果 XML 中没有找到，再从段落样式中提取默认字体和字号
+        if 'font_name' not in style:
+            style_font = _get_paragraph_style_font(para)
+            if style_font:
+                style['font_name'] = style_font
+        
+        if 'font_size' not in style:
+            # 尝试从段落样式中提取字号
+            try:
+                if hasattr(para.style, 'font') and para.style.font.size:
+                    style['font_size'] = para.style.font.size.pt
+            except Exception:
+                pass
     
     return style