feat(export): 优化表格列宽计算和单元格渲染逻辑

从 block metadata 提取列宽
实现动态表格宽度计算
归一化列宽处理
重构单元格迭代逻辑
简化合并单元格处理
添加列宽分配的点数归一化
改进单元格定位逻辑
更新合并映射跟踪

app/services/export_service.py

@@ -1019,7 +1019,10 @@ def _render_table_block(doc: Document, block: dict, style_map: dict):
         return
     
     # 使用 col_widths 确定真实列数（而不是第一行的单元格数）
-    col_widths = table_data.get('col_widths', [])
+    # 注意: col_widths 应该从 metadata 中获取, 而不是 content
+    metadata = block.get('metadata', {})
+    col_widths = metadata.get('col_widths', [])
+
     if col_widths:
         num_cols = len(col_widths)
     else:
@@ -1058,10 +1061,47 @@ def _render_table_block(doc: Document, block: dict, style_map: dict):
         table.alignment = WD_TABLE_ALIGNMENT.RIGHT
     
     # 设置列宽
+    # 注意: col_widths 中存储的是百分比值(如 [50, 50] 表示两列各占50%)
+    # 需要根据表格总宽度计算实际列宽(磅值)
     if col_widths:
-        for col_idx, width in enumerate(col_widths):
+        # 获取表格总宽度设置
+        table_width = metadata.get('table_width', 100)
+        table_width_unit = metadata.get('table_width_unit', 'percent')
+        
+        # 计算表格实际宽度(磅)
+        if table_width_unit == 'percent':
+            # 百分比模式:基于页面可用宽度计算
+            # 假设 A4 纸张,页面宽度约 595磅(21cm),左右边距各约71磅(2.5cm)
+            # 可用宽度 = 595 - 71 - 71 = 453 磅
+            page_available_width_pt = 453.0  # 可以从 style_data 中的 page_setup 获取更精确的值
+            actual_table_width_pt = page_available_width_pt * (table_width / 100.0)
+        elif table_width_unit == 'cm':
+            # 厘米转磅: 1cm = 28.35磅
+            actual_table_width_pt = table_width * 28.35
+        elif table_width_unit == 'inch':
+            # 英寸转磅: 1inch = 72磅
+            actual_table_width_pt = table_width * 72.0
+        else:
+            # 默认使用百分比模式
+            page_available_width_pt = 453.0
+            actual_table_width_pt = page_available_width_pt * (table_width / 100.0)
+        
+        # 计算列宽百分比总和，用于归一化
+        col_widths_sum = sum(col_widths)
+        
+        # 根据百分比计算每列的实际宽度并设置
+        # 注意：为了避免因百分比总和不为100而导致的问题，我们基于实际总和进行归一化
+        for col_idx, width_percent in enumerate(col_widths):
             if col_idx < len(table.columns):
-                table.columns[col_idx].width = Pt(width)
+                # 归一化：基于实际的百分比总和计算每列占表格宽度的比例
+                # 例如：如果7列各14%，总和98%，则每列实际占 14/98 的表格宽度
+                if col_widths_sum > 0:
+                    col_width_pt = actual_table_width_pt * (width_percent / col_widths_sum)
+                else:
+                    # 如果总和为0，平均分配
+                    col_width_pt = actual_table_width_pt / len(col_widths)
+                
+                table.columns[col_idx].width = Pt(col_width_pt)
     
     # 填充内容并处理合并单元格
     merge_map = {}  # {(row, col): (end_row, end_col)} 记录合并区域
@@ -1075,58 +1115,49 @@ def _render_table_block(doc: Document, block: dict, style_map: dict):
         
         cells_data = row_data.get('cells', [])
         
-        # 构建一个映射：col_index -> cell_data
-        cells_by_col = {}
-        for cell_data in cells_data:
-            col_idx = cell_data.get('col_index', None)
-            if col_idx is not None:
-                cells_by_col[col_idx] = cell_data
-        
-        # 遍历所有列
-        for col_idx in range(num_cols):
-            # 检查这个位置是否被占用（被上方的合并单元格占用）
-            if occupied.get((r_idx, col_idx), False):
-                continue  # 跳过被占用的位置
-            
-            # 检查是否有数据要填充到这个位置
-            if col_idx not in cells_by_col:
-                continue  # 这个位置没有数据
+        # 遍历单元格数据
+        # 注意：单元格在 cells 数组中的索引就是它的列索引（col_idx）
+        col_offset = 0  # 当前应该填充到哪一列
+        for cell_idx, cell_data in enumerate(cells_data):
+            # 跳过被上方合并单元格占用的列
+            while occupied.get((r_idx, col_offset), False):
+                col_offset += 1
+                if col_offset >= num_cols:
+                    break
             
-            cell_data = cells_by_col[col_idx]
+            if col_offset >= num_cols:
+                break  # 超出列数，停止处理
             
-            # 跳过被合并的单元格（rowspan=0 表示这个单元格被上面的单元格合并了）
+            # 跳过被合并的单元格（rowspan=0 或 colspan=0 表示这个单元格被合并了）
             rowspan = cell_data.get('rowspan', 1)
-            if rowspan == 0:
-                continue
-            
             colspan = cell_data.get('colspan', 1)
             
-            # 确保不越界
-            if col_idx >= num_cols:
+            if rowspan == 0 or colspan == 0:
+                # 这个单元格已被合并，跳过
                 continue
             
             # 获取起始单元格
-            start_cell = table.rows[r_idx].cells[col_idx]
+            start_cell = table.rows[r_idx].cells[col_offset]
             
             # 处理合并单元格
             if colspan > 1 or rowspan > 1:
                 # 计算结束位置
-                end_col = min(col_idx + colspan - 1, num_cols - 1)
+                end_col = min(col_offset + colspan - 1, num_cols - 1)
                 end_row = min(r_idx + rowspan - 1, num_rows - 1)
                 
                 # 合并单元格
-                if end_col > col_idx or end_row > r_idx:
+                if end_col > col_offset or end_row > r_idx:
                     try:
                         end_cell = table.rows[end_row].cells[end_col]
                         start_cell.merge(end_cell)
-                        merge_map[(r_idx, col_idx)] = (end_row, end_col)
+                        merge_map[(r_idx, col_offset)] = (end_row, end_col)
                         
                         # 标记被合并的单元格位置为已占用
                         for merge_r in range(r_idx, end_row + 1):
-                            for merge_c in range(col_idx, end_col + 1):
-                                if merge_r != r_idx or merge_c != col_idx:  # 不标记起始单元格
+                            for merge_c in range(col_offset, end_col + 1):
+                                if merge_r != r_idx or merge_c != col_offset:  # 不标记起始单元格
                                     occupied[(merge_r, merge_c)] = True
-                    except Exception:
+                    except Exception as e:
                         pass  # 合并失败，继续
             
             # 设置单元格宽度（如果有）
@@ -1191,7 +1222,9 @@ def _render_table_block(doc: Document, block: dict, style_map: dict):
                 run = para.add_run(str(cell_text))
                 # 应用单元格 run 级样式
                 _apply_run_style(run, cell_style)
-
+            
+            # 移动到下一列位置（考虑colspan）
+            col_offset += colspan
 
 def _render_image_block(doc: Document, block: dict, style_map: dict = None):
     """渲染图片块（支持 Base64 Data URL 和 Word 样式）"""