paperfit-cli 1.0.0

package/scripts/space_util_fixers.py

@@ -0,0 +1,773 @@
+#!/usr/bin/env python3
+"""
+Space Utilization Fixers Module
+
+处理 Category A：空间利用缺陷
+- A1: 孤行/寡行 (Widow/Orphan Lines)
+- A2: 末页大面积留白 (Excessive Trailing Whitespace)
+- A3: 页数预算违反 (Page Budget Violation)
+- A4: 双栏末页左右栏高度不齐 (Unbalanced Column Heights)
+
+该模块被 code-surgeon-agent 或 semantic-polish-agent 调用，执行对 .tex 源码的精确修改。
+所有修复遵循最小修改原则，优先排版控制，最后才考虑语义改写。
+"""
+
+import re
+from pathlib import Path
+from dataclasses import dataclass, field
+from typing import List, Dict, Optional, Tuple, Any
+
+
+# ============================================================
+# 数据结构定义
+# ============================================================
+
+@dataclass
+class FixResult:
+    """修复结果"""
+    defect_id: str
+    object_name: str
+    action: str
+    before: str
+    after: str
+    page: int = 0
+    line_number: Optional[int] = None
+    success: bool = False
+
+
+@dataclass
+class SpaceUtilFixReport:
+    """修复报告"""
+    status: str  # success | partial | failed
+    modified_files: List[str] = field(default_factory=list)
+    changes: List[FixResult] = field(default_factory=list)
+    unresolved: List[str] = field(default_factory=list)
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            "skill": "space-util-fixer",
+            "status": self.status,
+            "modified_files": self.modified_files,
+            "changes": [
+                {
+                    "defect_id": c.defect_id,
+                    "object": c.object_name,
+                    "action": c.action,
+                    "before": c.before,
+                    "after": c.after,
+                    "page": c.page,
+                    "line_number": c.line_number,
+                    "success": c.success,
+                }
+                for c in self.changes
+            ],
+            "unresolved": self.unresolved,
+        }
+
+
+# ============================================================
+# A1：孤行/寡行修复
+# ============================================================
+
+def fix_widow_orphan(
+    tex_content: str,
+    paragraph_start_line: Optional[int] = None,
+    paragraph_text: Optional[str] = None,
+) -> Tuple[str, Optional[FixResult]]:
+    """
+    修复孤行/寡行问题
+
+    策略优先级:
+    1. 段落级收紧 (\looseness=-1)
+    2. 段落级扩张 (\looseness=1)
+    3. 调整段落间胶水 (\emergencystretch)
+    4. 全局调整 widow/orphan 惩罚
+
+    Args:
+        tex_content: .tex 文件内容
+        paragraph_start_line: 段落起始行号 (用于定位)
+        paragraph_text: 段落文本 (用于精确定位)
+
+    Returns:
+        (修改后的内容，修复结果)
+    """
+    # 策略 1: 使用 \looseness=-1 收缩段落
+    if paragraph_text:
+        # 精确定位段落
+        # 清理文本中的特殊字符用于匹配
+        escaped_text = re.escape(paragraph_text[:50])  # 取前 50 字符定位
+        pattern = r'(?<!\\looseness=[-0-9]+\s)(\n|\A)\s*(' + escaped_text + r'[^\n]*\n(?:[^\n]*\n)*?)(?=\n\n|\Z)'
+        match = re.search(pattern, tex_content, re.MULTILINE)
+
+        if match:
+            paragraph_full = match.group(0)
+            # 用花括号包裹并添加 \looseness=-1
+            wrapped = f"{{\\looseness=-1 {paragraph_full.strip()}}}"
+            modified_content = tex_content.replace(paragraph_full, wrapped, 1)
+
+            return modified_content, FixResult(
+                defect_id="A1",
+                object_name=f"第 {paragraph_start_line} 行段落",
+                action="添加 \\looseness=-1 以收缩段落消除孤行",
+                before=paragraph_text[:40] + "..." if len(paragraph_text) > 40 else paragraph_text,
+                after=f"{{\\looseness=-1 {paragraph_text[:40]}...}}",
+                line_number=paragraph_start_line,
+                success=True,
+            )
+
+    # 策略 2: 如果无法精确定位，尝试在导言区添加全局设置
+    return add_widow_orphan_penalty(tex_content)
+
+
+def add_widow_orphan_penalty(
+    tex_content: str,
+) -> Tuple[str, Optional[FixResult]]:
+    """
+    在导言区添加全局 widow/orphan 惩罚设置
+    """
+    # 检查是否已有设置
+    if '\\widowpenalty' in tex_content and '\\clubpenalty' in tex_content:
+        return tex_content, None
+
+    # 在 \begin{document} 前添加
+    match = re.search(r'\\begin\{document\}', tex_content)
+    if match:
+        insert_pos = match.start()
+        penalties = (
+            "\\widowpenalty=10000\n"
+            "\\clubpenalty=10000\n"
+            "\\displaywidowpenalty=10000\n"
+        )
+        modified_content = tex_content[:insert_pos] + penalties + tex_content[insert_pos:]
+
+        return modified_content, FixResult(
+            defect_id="A1",
+            object_name="导言区",
+            action="添加全局 widow/orphan 惩罚设置",
+            before="\\begin{document}",
+            after="\\widowpenalty=10000\n\\clubpenalty=10000\n...\\begin{document}",
+            success=True,
+        )
+
+    return tex_content, None
+
+
+def fix_paragraph_looseness(
+    tex_content: str,
+    paragraph_start: int,
+    looseness_value: int = -1,
+) -> Tuple[str, Optional[FixResult]]:
+    """
+    为特定段落设置 \looseness 值
+
+    Args:
+        tex_content: .tex 文件内容
+        paragraph_start: 段落起始位置 (字符索引)
+        looseness_value: \looseness 值 (-1 收缩，1 扩张)
+
+    Returns:
+        (修改后的内容，修复结果)
+    """
+    # 找到段落结束 (下一个空行或文件结束)
+    paragraph_end = tex_content.find('\n\n', paragraph_start)
+    if paragraph_end == -1:
+        paragraph_end = len(tex_content)
+
+    paragraph_text = tex_content[paragraph_start:paragraph_end]
+
+    # 添加 \looseness
+    wrapped = f"{{\\looseness={looseness_value} {paragraph_text.strip()}}}"
+    modified_content = tex_content[:paragraph_start] + wrapped + tex_content[paragraph_end:]
+
+    return modified_content, FixResult(
+        defect_id="A1",
+        object_name=f"段落 (行 {paragraph_start})",
+        action=f"添加 \\looseness={looseness_value}",
+        before=paragraph_text[:40] + "..." if len(paragraph_text) > 40 else paragraph_text,
+        after=f"{{\\looseness={looseness_value} ...}}",
+        success=True,
+    )
+
+
+# ============================================================
+# A2：末页大面积留白修复
+# ============================================================
+
+def fix_trailing_whitespace(
+    tex_content: str,
+    last_page_number: int,
+    whitespace_ratio: float,
+) -> Tuple[str, Optional[FixResult]]:
+    """
+    修复末页大面积留白问题
+
+    策略优先级:
+    1. 前移浮动体
+    2. 调整局部垂直间距
+    3. 建议语义扩写 (返回 unresolved)
+
+    Args:
+        tex_content: .tex 文件内容
+        last_page_number: 最后一页页码
+        whitespace_ratio: 空白区域比例
+
+    Returns:
+        (修改后的内容，修复结果)
+    """
+    if whitespace_ratio < 0.2:
+        # 空白比例在可接受范围内
+        return tex_content, None
+
+    # 策略 1: 尝试前移浮动体
+    # 查找最后几个 figure/table 环境，尝试调整其位置参数
+    float_pattern = r'\\begin\{(figure|table)\}(\[[^\]]*\])?'
+    matches = list(re.finditer(float_pattern, tex_content))
+
+    if matches:
+        # 找到最后一个浮动体
+        last_float = matches[-1]
+        float_type = last_float.group(1)
+        pos_param = last_float.group(2) if last_float.group(2) else ""
+
+        # 尝试改为 [ht] 使其前移
+        if pos_param != "[ht]":
+            new_param = "[ht]"
+            if pos_param:
+                modified_content = tex_content[:last_float.start(2)] + new_param + tex_content[last_float.end(2):]
+            else:
+                insert_pos = last_float.end()
+                modified_content = tex_content[:insert_pos] + new_param + tex_content[insert_pos:]
+
+            return modified_content, FixResult(
+                defect_id="A2",
+                object_name=f"末页{float_type}",
+                action=f"将浮动体位置改为 {new_param} 以填充空白",
+                before=f"\\begin{{{float_type}}}{pos_param}",
+                after=f"\\begin{{{float_type}}}{new_param}",
+                page=last_page_number,
+                success=True,
+            )
+
+    # 策略 2: 调整最后一节前的间距
+    last_section = tex_content.rfind('\\section')
+    if last_section != -1:
+        # 在 \section 前添加 \vspace
+        modified_content = tex_content[:last_section] + "\\vspace{-0.3em}\n" + tex_content[last_section:]
+
+        return modified_content, FixResult(
+            defect_id="A2",
+            object_name="最后一节",
+            action="在最后一节前添加 \\vspace{-0.3em} 压缩间距",
+            before="\\section{...}",
+            after="\\vspace{-0.3em}\n\\section{...}",
+            page=last_page_number,
+            success=True,
+        )
+
+    # 策略 3: 无法自动修复，需要语义扩写
+    return tex_content, None
+
+
+# ============================================================
+# A3：页数预算修复
+# ============================================================
+
+def fix_page_budget_excess(
+    tex_content: str,
+    current_pages: int,
+    target_pages: int,
+) -> Tuple[str, List[FixResult]]:
+    """
+    修复超页问题 (实际页数 > 目标页数)
+
+    策略优先级:
+    1. 压缩浮动体
+    2. 缩减垂直间距
+    3. 建议精炼文字 (语义级)
+    4. 压缩参考文献
+    5. 微调页边距 (谨慎)
+
+    Args:
+        tex_content: .tex 文件内容
+        current_pages: 当前页数
+        target_pages: 目标页数
+
+    Returns:
+        (修改后的内容，修复结果列表)
+    """
+    pages_to_reduce = current_pages - target_pages
+    if pages_to_reduce <= 0:
+        return tex_content, []
+
+    changes = []
+
+    # 策略 1: 压缩图片宽度 (从 \linewidth 改为 0.95\linewidth)
+    include_graphics_pattern = r'\\includegraphics(\[[^\]]*\])?\{[^}]+\}'
+    matches = list(re.finditer(include_graphics_pattern, tex_content))
+
+    for match in matches[:pages_to_reduce + 1]:  # 压缩几个图
+        graphic_cmd = match.group(0)
+        if r'\linewidth' in graphic_cmd or r'\textwidth' in graphic_cmd:
+            # 替换为 0.95\linewidth
+            new_graphic = graphic_cmd.replace(
+                r'\linewidth', r'0.95\linewidth'
+            ).replace(
+                r'\textwidth', r'0.95\textwidth'
+            )
+            tex_content = tex_content.replace(graphic_cmd, new_graphic, 1)
+            changes.append(FixResult(
+                defect_id="A3",
+                object_name="图片",
+                action="压缩图片宽度至 0.95\\linewidth",
+                before=graphic_cmd[:30] + "...",
+                after=new_graphic[:30] + "...",
+                success=True,
+            ))
+
+    # 策略 2: 检查是否有冗余的 \vspace 或空行
+    # 移除过大的 \vspace
+    vspace_pattern = r'\\vspace\{[0-9.]+(em|pt|cm)\}'
+    large_vspace = re.search(vspace_pattern, tex_content)
+    if large_vspace:
+        vspace_val = large_vspace.group(0)
+        # 缩小 \vspace
+        num_match = re.search(r'[0-9.]+', vspace_val)
+        if num_match:
+            old_val = float(num_match.group(0))
+            new_val = old_val * 0.8
+            new_vspace = vspace_val.replace(str(old_val), str(new_val))
+            tex_content = tex_content.replace(vspace_val, new_vspace, 1)
+            changes.append(FixResult(
+                defect_id="A3",
+                object_name="垂直间距",
+                action=f"压缩 \\vspace 从 {old_val} 到 {new_val}",
+                before=vspace_val,
+                after=new_vspace,
+                success=True,
+            ))
+
+    # 策略 3: 建议压缩参考文献样式
+    if '\\bibliographystyle{' in tex_content:
+        style_match = re.search(r'\\bibliographystyle\{([^}]+)\}', tex_content)
+        if style_match and style_match.group(1) not in ['abbrv', 'unsrt', 'plain']:
+            changes.append(FixResult(
+                defect_id="A3",
+                object_name="参考文献样式",
+                action="建议改用 abbrv 样式压缩参考文献",
+                before=f"\\bibliographystyle{{{style_match.group(1)}}}",
+                after="\\bibliographystyle{abbrv}",
+                success=False,  # 需要人工确认
+            ))
+
+    return tex_content, changes
+
+
+def fix_page_budget_deficit(
+    tex_content: str,
+    current_pages: int,
+    target_pages: int,
+) -> Tuple[str, List[FixResult]]:
+    """
+    修复缺页问题 (实际页数 < 目标页数)
+
+    策略优先级:
+    1. 检查浮动体堆积
+    2. 建议扩写结论/讨论 (语义级)
+    3. 增加附录
+    4. 微调图片尺寸
+    5. 增加分页点
+
+    Args:
+        tex_content: .tex 文件内容
+        current_pages: 当前页数
+        target_pages: 目标页数
+
+    Returns:
+        (修改后的内容，修复结果列表)
+    """
+    pages_to_add = target_pages - current_pages
+    if pages_to_add <= 0:
+        return tex_content, []
+
+    changes = []
+
+    # 策略 1: 解除浮动体限制 (移除 [H] 或过度限制的参数)
+    float_pattern = r'\\begin\{(figure|table)\}\[H\]'
+    restricted_floats = re.finditer(float_pattern, tex_content)
+
+    for match in restricted_floats:
+        float_type = match.group(1)
+        old_cmd = f"\\begin{{{float_type}}}[H]"
+        new_cmd = f"\\begin{{{float_type}}}[htbp]"
+        tex_content = tex_content.replace(old_cmd, new_cmd, 1)
+        changes.append(FixResult(
+            defect_id="A3",
+            object_name=float_type,
+            action="移除 [H] 限制，允许浮动体自然放置",
+            before=old_cmd,
+            after=new_cmd,
+            success=True,
+        ))
+
+    # 策略 2: 放大图片尺寸
+    include_graphics_pattern = r'\\includegraphics\[width=([0-9.]+)\\(linewidth|textwidth)\]'
+    matches = list(re.finditer(include_graphics_pattern, tex_content))
+
+    for match in matches[:pages_to_add]:
+        current_ratio = float(match.group(1))
+        if current_ratio < 1.0:
+            new_ratio = min(1.0, current_ratio + 0.1)
+            old_cmd = match.group(0)
+            new_cmd = old_cmd.replace(
+                f'{current_ratio}\\', f'{new_ratio}\\'
+            )
+            tex_content = tex_content.replace(old_cmd, new_cmd, 1)
+            changes.append(FixResult(
+                defect_id="A3",
+                object_name="图片",
+                action=f"放大图片宽度从 {current_ratio} 到 {new_ratio}",
+                before=old_cmd,
+                after=new_cmd,
+                success=True,
+            ))
+
+    return tex_content, changes
+
+
+# ============================================================
+# A4：双栏末页左右栏高度不齐
+# ============================================================
+
+def fix_unbalanced_columns(
+    tex_content: str,
+    height_difference: float,  # 栏高差 (比例)
+) -> Tuple[str, Optional[FixResult]]:
+    """
+    修复双栏末页左右栏高度不齐问题
+
+    策略优先级:
+    1. 使用 \balance 或 flushend 宏包
+    2. 手动平衡
+    3. 微调最后一段断行
+    4. 调整浮动体位置
+
+    Args:
+        tex_content: .tex 文件内容
+        height_difference: 栏高差比例
+
+    Returns:
+        (修改后的内容，修复结果)
+    """
+    if height_difference < 0.1:
+        # 高度差在可接受范围内 (约 2 行以内)
+        return tex_content, None
+
+    # 策略 1: 添加 flushend 宏包
+    if '\\usepackage{flushend}' not in tex_content:
+        match = re.search(r'\\begin\{document\}', tex_content)
+        if match:
+            insert_pos = match.start()
+            modified_content = tex_content[:insert_pos] + "\\usepackage{flushend}\n" + tex_content[insert_pos:]
+
+            return modified_content, FixResult(
+                defect_id="A4",
+                object_name="导言区",
+                action="添加 flushend 宏包自动平衡末页两栏",
+                before="\\begin{document}",
+                after="\\usepackage{flushend}\n\\begin{document}",
+                success=True,
+            )
+
+    # 策略 2: 在文末添加 \balance
+    if '\\balance' not in tex_content:
+        # 在 \end{document} 前添加
+        match = re.search(r'\\end\{document\}', tex_content)
+        if match:
+            insert_pos = match.start()
+            modified_content = tex_content[:insert_pos] + "\\balance\n" + tex_content[insert_pos:]
+
+            return modified_content, FixResult(
+                defect_id="A4",
+                object_name="文末",
+                action="添加 \\balance 命令平衡两栏",
+                before="\\end{document}",
+                after="\\balance\n\\end{document}",
+                success=True,
+            )
+
+    return tex_content, None
+
+
+def add_balance_package(
+    tex_content: str,
+) -> Tuple[str, Optional[FixResult]]:
+    """
+    添加 balance 宏包支持
+    """
+    if '\\usepackage{balance}' in tex_content:
+        return tex_content, None
+
+    match = re.search(r'\\begin\{document\}', tex_content)
+    if match:
+        insert_pos = match.start()
+        modified_content = tex_content[:insert_pos] + "\\usepackage{balance}\n" + tex_content[insert_pos:]
+
+        return modified_content, FixResult(
+            defect_id="A4",
+            object_name="导言区",
+            action="添加 balance 宏包",
+            before="\\begin{document}",
+            after="\\usepackage{balance}\n\\begin{document}",
+            success=True,
+        )
+
+    return tex_content, None
+
+
+# ============================================================
+# 主修复函数
+# ============================================================
+
+def fix_space_util_defects(
+    tex_file_path: str,
+    defects: List[Dict[str, Any]],
+    target_pages: Optional[int] = None,
+    template_type: str = "single_column",
+) -> SpaceUtilFixReport:
+    """
+    修复所有 Category A 缺陷
+
+    Args:
+        tex_file_path: .tex 文件路径
+        defects: 缺陷列表，每个缺陷包含:
+            - defect_id: A1, A2, A3, A4
+            - page: 页码
+            - object: 对象名称
+            - description: 描述
+            - whitespace_ratio: 空白比例 (A2)
+            - current_pages: 当前页数 (A3)
+            - height_difference: 栏高差 (A4)
+        target_pages: 目标页数 (A3 需要)
+        template_type: 模板类型 ("single_column" | "double_column")
+
+    Returns:
+        SpaceUtilFixReport: 修复报告
+    """
+    tex_path = Path(tex_file_path)
+    if not tex_path.exists():
+        return SpaceUtilFixReport(
+            status="failed",
+            unresolved=[f"文件不存在：{tex_file_path}"]
+        )
+
+    try:
+        tex_content = tex_path.read_text(encoding='utf-8')
+    except (OSError, UnicodeDecodeError) as e:
+        return SpaceUtilFixReport(
+            status="failed",
+            unresolved=[f"无法读取文件 {tex_file_path}: {e}"]
+        )
+    modified_files = set()
+    changes = []
+    unresolved = []
+
+    for defect in defects:
+        defect_id = defect.get("defect_id", "")
+        page = defect.get("page", 0)
+        object_name = defect.get("object", "")
+        description = defect.get("description", "")
+
+        new_content = tex_content
+        fix_result = None
+        additional_changes = []
+
+        if defect_id == "A1":
+            # 孤行/寡行
+            new_content, fix_result = fix_widow_orphan(
+                tex_content,
+                paragraph_start_line=defect.get("line_number"),
+                paragraph_text=description,
+            )
+            # 如果具体段落修复失败，尝试全局设置
+            if not fix_result:
+                new_content, fix_result = add_widow_orphan_penalty(tex_content)
+
+        elif defect_id == "A2":
+            # 末页留白
+            whitespace_ratio = defect.get("whitespace_ratio", 0)
+            new_content, fix_result = fix_trailing_whitespace(
+                tex_content,
+                last_page_number=page,
+                whitespace_ratio=whitespace_ratio,
+            )
+            if not fix_result:
+                unresolved.append(
+                    f"A2 (末页): 需要语义扩写结论或讨论部分以填充空白"
+                )
+
+        elif defect_id == "A3":
+            # 页数预算
+            current_pages = defect.get("current_pages", 0)
+            if target_pages is None:
+                unresolved.append(f"A3: 需要用户提供目标页数")
+                continue
+
+            if current_pages > target_pages:
+                # 超页
+                new_content, additional_changes = fix_page_budget_excess(
+                    tex_content,
+                    current_pages=current_pages,
+                    target_pages=target_pages,
+                )
+                changes.extend(additional_changes)
+                if additional_changes:
+                    fix_result = additional_changes[0]
+                else:
+                    unresolved.append(
+                        f"A3: 需要精炼文字或压缩参考文献 (当前{current_pages}页，目标{target_pages}页)"
+                    )
+            else:
+                # 缺页
+                new_content, additional_changes = fix_page_budget_deficit(
+                    tex_content,
+                    current_pages=current_pages,
+                    target_pages=target_pages,
+                )
+                changes.extend(additional_changes)
+                if additional_changes:
+                    fix_result = additional_changes[0]
+                else:
+                    unresolved.append(
+                        f"A3: 需要扩写结论或增加附录 (当前{current_pages}页，目标{target_pages}页)"
+                    )
+
+        elif defect_id == "A4":
+            # 双栏末页不齐
+            if template_type != "double_column":
+                unresolved.append(f"A4: 仅适用于双栏模板")
+                continue
+
+            height_difference = defect.get("height_difference", 0)
+            new_content, fix_result = fix_unbalanced_columns(
+                tex_content,
+                height_difference=height_difference,
+            )
+
+            # 如果需要，添加 balance 宏包
+            if fix_result and '\\usepackage{balance}' not in tex_content:
+                new_content, _ = add_balance_package(new_content)
+
+        # 检查修复是否成功
+        if new_content != tex_content:
+            tex_content = new_content
+            if fix_result:
+                fix_result.page = page
+                fix_result.line_number = defect.get("line_number")
+                if fix_result not in changes:
+                    changes.append(fix_result)
+            modified_files.add(str(tex_path))
+        elif not fix_result and not additional_changes:
+            unresolved.append(
+                f"{defect_id} ({object_name or '未知对象'}): 无法自动修复，可能需要人工调整"
+            )
+
+    # 写入修改后的内容
+    if modified_files:
+        try:
+            tex_path.write_text(tex_content, encoding='utf-8')
+        except OSError as e:
+            unresolved.append(f"无法写入文件 {tex_path}: {e}")
+            return SpaceUtilFixReport(
+                status="failed",
+                modified_files=list(modified_files),
+                changes=changes,
+                unresolved=unresolved,
+            )
+
+    status = "success" if not unresolved else ("partial" if changes else "failed")
+
+    return SpaceUtilFixReport(
+        status=status,
+        modified_files=list(modified_files),
+        changes=changes,
+        unresolved=unresolved,
+    )
+
+
+# ============================================================
+# CLI 入口
+# ============================================================
+
+def main():
+    """命令行接口"""
+    import argparse
+    import json
+
+    parser = argparse.ArgumentParser(
+        description="Fix Category A space utilization defects in LaTeX documents"
+    )
+    parser.add_argument(
+        "tex_file",
+        help="Path to .tex file"
+    )
+    parser.add_argument(
+        "--defects",
+        type=str,
+        help="JSON string or file path containing defect list"
+    )
+    parser.add_argument(
+        "--target-pages",
+        type=int,
+        help="Target page count (for A3)"
+    )
+    parser.add_argument(
+        "--template",
+        type=str,
+        default="single_column",
+        choices=["single_column", "double_column"],
+        help="Template type"
+    )
+    parser.add_argument(
+        "--json",
+        "-j",
+        action="store_true",
+        help="Output JSON report"
+    )
+
+    args = parser.parse_args()
+
+    # 解析缺陷列表
+    defects = []
+    if args.defects:
+        if Path(args.defects).exists():
+            with open(args.defects, 'r', encoding='utf-8') as f:
+                defects = json.load(f)
+        else:
+            defects = json.loads(args.defects)
+
+    # 执行修复
+    report = fix_space_util_defects(
+        args.tex_file,
+        defects,
+        target_pages=args.target_pages,
+        template_type=args.template,
+    )
+
+    if args.json:
+        print(json.dumps(report.to_dict(), indent=2, ensure_ascii=False))
+    else:
+        print(f"\nSpace Utilization Fix Report")
+        print("=" * 50)
+        print(f"Status: {report.status}")
+        print(f"Modified files: {report.modified_files}")
+        print(f"Changes: {len(report.changes)}")
+        for change in report.changes:
+            print(f"  - [{change.defect_id}] {change.object_name}: {change.action}")
+        if report.unresolved:
+            print(f"\nUnresolved: {len(report.unresolved)}")
+            for u in report.unresolved:
+                print(f"  - {u}")
+
+
+if __name__ == "__main__":
+    main()