Word文档智能排版工具 (Word-Formatter-Pro)

Word-Formatter-Pro 是一款面向公文、报告和常规 Word 文档的桌面排版工具。它可以将格式混乱的 Word/WPS 文档、纯文本或 Markdown 内容转换为规范、统一的 .docx 文档，适合批量处理和日常办公排版。

主要功能

• 基于公文标准
  ：内置默认参数参考常用公文排版规范，包含页边距、页码、字体、字号、行距、标题层级等设置。
• 一键式排版
  ：添加文件、文件夹或直接粘贴文本后，点击“开始排版”即可生成处理后的 Word 文档。
• 安全副本处理
  ：原始文件不会被直接修改，程序会在系统临时目录中的安全副本或转换后的 .docx 上执行排版，临时文件使用带进程 ID 和随机后缀的命名方式，降低重名覆盖风险。

智能识别与处理

• 主标题与副标题识别
  ：自动识别文档开头连续居中、字体字号一致的主标题；主标题下方字体字号不同的居中段落会识别为副标题。TXT/MD 文本会将首个非层级标题段落作为题目。
• 四级标题识别
  ：自动识别“一、”、“（一）”、“1.”、“(1)”等常见层级标题，并分别应用对应格式和大纲级别。
• 二级标题段内格式化
  ：当二级标题与正文在同一段落时，例如 （一）标题。正文...，程序会在同一段落内为标题和正文分别应用格式。
• 图表标题定位
  ：自动查找图片或表格上方/下方最近的、居中的“图...”或“表...”标题，并套用图形标题或表格标题格式。
• 附件格式化
  ：可识别“附件”、“附件1”、“附件：”等附件标识，自动设置段前分页，并继续识别附件自身的主标题和副标题；当附件标识后没有附件标题/副标题时，不会跳过紧随其后的正文段落。
• 保留原有强调格式
  ：统一字体字号时，会尽量保留原有的加粗、斜体、下划线、字体颜色等格式。
• 图片和嵌入对象保护
  ：包含图片、图形或嵌入对象的段落不会破坏对象本身，只对段落中的文字进行必要格式处理，并避免修改可能导致图片显示不全的行距等段落属性。
• 特殊内容保护
  ：清理段首空白时，会避免删除包含域代码、书签、批注引用等特殊内容的 run。

文档格式兼容

• 批量处理
  ：支持添加单个文件、多个文件或整个文件夹，也支持从文件管理器拖拽文件/文件夹到列表。
• 多格式输入
  ：支持 .docx、.txt、.md，并可按环境处理 .doc/.wps。Windows 下优先使用 WPS/Word COM；macOS/Kylin/Linux 下会尝试调用 LibreOffice soffice 转换旧格式，未安装 LibreOffice 时会跳过 .doc/.wps，继续处理其他文件。
• 直接输入文本
  ：可在软件中直接粘贴文本并生成排版后的 Word 文档，直接文本默认使用 A4 纸张。
• Markdown 清理
  ：处理 .md 文件时，会自动清理标题标记、粗体/斜体标记、链接、图片语法、引用、分隔线等 Markdown 标记；数字编号（如 1.、1.2.3）按源文档保留，不再自动递增重排。
• 空行整理
  ：TXT/MD 文件支持三种空行处理方式：不改动任何空行；删除单个空行并将连续多个空行合并为一个空行；保留单个空行并将连续多个空行合并为一个空行。默认使用“删除单个空行，多个空行保留至1个空行”。
• 修订和自动编号预处理
  ：仅 Windows 且可用 WPS/Word COM 时，会尝试接受修订并将自动编号转换为文本；macOS/Kylin/Linux 等非 Windows 环境固定跳过该步骤。
• 大文件夹拖入保护
  ：添加或拖入包含超过 1000 个文件的文件夹时，会先弹出确认提示，避免误拖深层目录导致长时间扫描。

CLI、Skill 与可维护性

• 核心逻辑拆分
  ：排版核心、默认配置、GUI、CLI 和内置测试已拆分为独立文件，便于后续维护、命令行调用和 Skill 复用。
• 命令行处理
  ：wfp_cli.py 支持单文件、多文件、重复 -i、位置参数和目录批量处理；目录输入默认递归，输出目录会保留原结构。
• 配置覆盖能力
  ：CLI 会自动读取当前目录的 wfp_config.json，也支持 --config、--config-json、--set key=value 和常用便利开关覆盖配置。
• 跨平台旧格式转换
  ：GUI/CLI/Skill 可自动查找 LibreOffice soffice，用于在 macOS/Kylin/Linux 或 COM 不可用时将 .doc/.wps 转为 .docx；也可通过 CLI 的 --soffice 手动指定路径。未检测到 LibreOffice 时，旧格式文件会被记录为跳过。
• 自包含 Skill
  ：skills/doc-format 的 scripts 目录包含完整 CLI、核心逻辑、默认配置和测试代码，单独安装 doc-format 文件夹后也可运行。
• 内置单元测试
  ：可通过 python wfp.py --test、python wfp_cli.py test 或 Skill 中的 python scripts/wfp_cli.py test 运行内置测试。
• 正则预编译
  ：常用文本识别、Markdown 清理、标题判断、附件判断和表格数字判断的正则表达式已提升为模块级预编译常量，减少循环中的重复编译。

可配置排版参数

• 页面设置
  ：可设置上下左右页边距、页脚距、页码对齐方式和页码字体字号；可选择是否强制设置为 A4 纸张。
• 标题与正文样式
  ：可分别设置题目、副标题、一级标题、二级标题、正文/三四级标题的字体、字号和行距。
• 段落缩进修复
  ：正文和层级标题会统一清理残留的左缩进、悬挂缩进和固定首行缩进，再按规则设置标准首行缩进，避免出现缩进叠加。
• 字体选择增强
  ：所有字体下拉框会在内置推荐字体下方显示系统已安装字体，并用“── 已安装字体 ──”分隔；字体输入框仍支持手动输入未列出的字体名称。
• 数字和字母字体设置
  ：可勾选“自定义数字和字母字体”后单独选择西文/数字字体，默认值为 Times New Roman；未勾选时，数字和字母会跟随正文、标题等各自的字体设置。
• TXT/MD 空行处理
  ：可通过下拉框选择不改动空行、删除单个空行或保留单个空行，同时支持将连续多个空行压缩为一个空行。
• 符号标准化
  ：可启用实验性的符号标准化，保守修复中文语境中的中英文标点混用，包括逗号、句号、分号、冒号、问号、感叹号、括号、引号和省略号等。
• 表格内容自动调整
  ：可启用实验性的表格内容格式化，分别设置表头/表格字体，统一字号、行距、行高、宽度、边框，并可自动调整列宽；总开关未启用时，相关选项会保持显示当前值但置灰不可编辑。
• 表格智能对齐
  ：启用后，表头、序号列和短文本居中，数字靠右，长文本靠左；默认会保留单元格原始对齐方式。
• 依赖选项联动
  ：附件格式化、自定义数字和字母字体、表格自动调整等开关未启用时，对应细项会自动置灰，避免误解当前生效范围。
• 配置方案管理
  ：支持加载配置、保存配置、保存为默认配置和恢复内置默认配置。
• 界面布局优化
  ：左侧集中处理文件/文本输入、开始排版、进度条和日志；文件列表支持水平滚动，方便查看较长路径；右侧为可滚动参数区，配置按钮保持 2x2 布局。
• 后台线程化处理
  ：排版任务会在后台线程中执行，批量处理期间可继续滚动日志和调整窗口；任务进行中关闭窗口会询问确认，并尽量刷新剩余日志。

效果演示

Word 文件处理前后

TXT 文件处理前后