Word-Formatter-Pro：Word 文档智能排版工具 #

Word-Formatter-Pro 是什么？ #

Word-Formatter-Pro（中文名：Word文档智能排版工具）是一款面向公文、报告和常规 Word 文档的桌面排版应用程序，可将格式混乱的 Word/WPS 文档、纯文本或 Markdown 内容一键转换为规范、统一的 .docx 文档，实现排版工作自动化。

它的核心价值在于把"人肉调格式"这件事交给程序完成：内置默认参数参考常用公文排版规范，涵盖页边距、页码、字体、字号、行距、标题层级等设置，添加文件或文件夹后点击"开始排版"即可生成成品。工具适用于政府机关、企事业单位的公文起草与归档、批量文档整理、Markdown/TXT 稿件转 Word 等场景，同时提供命令行接口与 Agent Skill，方便在自动化流程中复用。项目基于 MIT 协议开源，在 GitHub 上已获得 840 Star 与 87 Fork。

Word-Formatter-Pro 有哪些亮点特色？ #

• 基于公文标准的内置排版规范：默认参数参考常用公文排版规范，包含页边距、页码、字体、字号、行距、标题层级等设置，开箱即可产出符合规范的专业文档，无需逐项手工调校。

• 智能标题识别体系：可自动识别文档开头连续居中、字体字号一致的主标题，并将主标题下方字体字号不同的居中段落识别为副标题；同时自动识别"一、""（一）""1.""(1)"等四级层级标题，分别套用对应格式与大纲级别。当二级标题与正文同处一段（如"（一）标题。正文…"）时，还能在同一段落内为标题和正文分别应用格式。

• 多格式输入与批量处理：支持 .docx、.txt、.md 三种格式直接处理，并可按环境处理 .doc/.wps 旧格式；支持添加单个文件、多个文件或整个文件夹，也可从文件管理器直接拖拽文件/文件夹到列表，适合大批量文档统一整理。

• 安全副本处理，不动原始文件：原始文件不会被直接修改，程序会在系统临时目录中的安全副本或转换后的 .docx 上执行排版，临时文件使用带进程 ID 和随机后缀的命名方式，降低重名覆盖风险。

• 保留强调格式并保护嵌入对象：统一字体字号时会尽量保留原有的加粗、斜体、下划线、字体颜色等格式；包含图片、图形或嵌入对象的段落不会破坏对象本身，只对文字做必要处理，并避免修改可能导致图片显示不全的行距等段落属性。

• 细粒度可配置参数：页面设置、标题与正文样式、段落缩进修复、数字和字母字体、TXT/MD 空行处理、符号标准化、表格内容自动调整与表格智能对齐等均可单独开关；未启用的开关会让对应细项自动置灰，避免误解当前生效范围。配置方案支持加载、保存、保存为默认和恢复内置默认。

• 命令行 CLI 与 Agent Skill 复用：排版核心、默认配置、GUI、CLI 与内置测试拆分为独立文件，wfp_cli.py 支持单文件、多文件、重复 -i、位置参数与目录批量处理，目录输入默认递归并保留原输出结构；skills/doc-format 为自包含 Skill，可单独安装运行。

• 跨平台与后台线程化：提供 Windows、macOS（Apple Silicon）、Kylin/UOS Linux 成品程序；排版任务在后台线程执行，批量处理期间仍可滚动日志、调整窗口，任务进行中关闭窗口会询问确认。

免费下载 Word-Formatter-Pro #

以下为官方提供的各平台安装包（版本 v2.7.7），点击链接即可下载。

提示：官方也提供 GitHub Releases / Gitee Releases 下载渠道，如需最新版本可前往项目发布页获取。

Word-Formatter-Pro 如何使用？ #

Word-Formatter-Pro 提供四种使用方式，普通办公用户推荐直接使用成品程序（方式一）。

方式一：直接运行程序（推荐） #

1. 下载程序：按照上表或项目 Releases 页面，下载与你的系统匹配的成品程序——Windows 用 .exe，Kylin/Linux/UOS 用 .AppImage，macOS Apple Silicon 用 macOS-arm64.app.zip。
2. 启动程序：Windows 下双击 .exe 即可；macOS 解压 .zip 后双击 .app；Kylin/Linux 下先赋予执行权限再运行：

chmod +x Word-Formatter-Pro.v2.7.7.UOS-V20.x86_64.AppImage
./Word-Formatter-Pro.v2.7.7.UOS-V20.x86_64.AppImage

3. 添加待处理内容：在界面左侧添加单个文件、多个文件或整个文件夹，也可以直接把文件/文件夹从文件管理器拖拽到列表；如果是临时内容，可直接在软件中粘贴文本（直接输入的文本默认使用 A4 纸张）。
4. 调整排版参数（可选）：在界面右侧可滚动参数区设置页边距、页码、字体字号、行距、缩进、空行处理、表格格式等；也可加载/保存配置方案。
5. 点击"开始排版"：任务在后台线程执行，左侧进度条与日志区会实时显示处理进度。排版结果输出为规范统一的 .docx 文件，原始文件不会被修改。

方式二：从源码运行 #

git clone https://github.com/cwyalpha/Word-Formatter-Pro.git
cd Word-Formatter-Pro
python -m pip install -U pip
pip install -r requirements.txt
python wfp.py

方式三：命令行 CLI 使用 #

wfp_cli.py 支持单文件、多文件、重复 -i、位置参数和目录批量处理；目录输入默认递归，输出目录会保留原结构。CLI 会自动读取当前目录的 wfp_config.json，也支持 --config、--config-json、--set key=value 以及常用便利开关覆盖配置；在非 Windows 环境可借助 --soffice 手动指定 LibreOffice 的 soffice 路径。

方式四：作为 Agent Skill 安装和使用 #

skills/doc-format 是自包含 Skill，其 scripts 目录包含完整 CLI、核心逻辑、默认配置和测试代码，单独安装 doc-format 文件夹后即可运行。

可选依赖说明 #

• .docx / .txt / .md 可直接处理，无需额外依赖。
• Windows 下如需完整处理 .doc/.wps、接受修订并把自动编号转换为文本，请确保已安装 Microsoft Office 或 WPS Office。
• macOS / Kylin / Linux 下不会调用 WPS/Word，也不会执行自动编号转文本；如需处理 .doc/.wps 旧格式，请安装 LibreOffice：

# macOS
brew install --cask libreoffice

# Kylin / Linux
sudo apt-get update
sudo apt-get install libreoffice libreoffice-writer

未安装 LibreOffice 时，旧格式文件会被记录为跳过，程序继续处理其他文件。

Word-Formatter-Pro 的常见问题？ #

Q1：Word-Formatter-Pro 支持哪些输入格式？

原生支持 .docx、.txt、.md 三种格式，并可在相应环境下处理 .doc/.wps 旧格式。Windows 下优先使用 WPS/Word COM 进行转换；macOS/Kylin/Linux 下会尝试调用 LibreOffice 的 soffice，未安装 LibreOffice 时会跳过旧格式文件，继续处理其他文件。

Q2：排版会修改我的原始文档吗？

不会。程序采用安全副本处理机制，原始文件不会被直接修改，排版在系统临时目录中的安全副本或转换后的 .docx 上执行，临时文件使用带进程 ID 和随机后缀的命名方式，降低重名覆盖风险。

Q3：处理 .doc/.wps 文件时提示跳过怎么办？

这通常是因为当前系统未安装可用的转换组件。Windows 下请安装 Microsoft Office 或 WPS Office；macOS/Kylin/Linux 下请安装 LibreOffice 并确保 soffice 可用，也可用 CLI 的 --soffice 参数手动指定路径。

Q4：能不能一次性处理整个文件夹的文档？

可以。支持添加单个文件、多个文件或整个文件夹，也支持从文件管理器拖拽。为避免误拖深层目录导致长时间扫描，当添加或拖入包含超过 1000 个文件的文件夹时，程序会先弹出确认提示。

Q5：排版参数不符合单位内部规范，可以自定义吗？

可以。页面设置、标题与正文样式、字体字号行距、段落缩进、数字和字母字体、空行处理、符号标准化、表格格式与对齐等参数均可单独配置，并支持加载配置、保存配置、保存为默认配置和恢复内置默认配置。

Q6：没有图形界面，能在自动化流程里调用吗？

可以。项目提供 wfp_cli.py 命令行工具，支持单文件、多文件、重复 -i、位置参数和目录批量处理，目录输入默认递归并保留原输出结构；此外还提供自包含的 skills/doc-format Agent Skill，可单独安装后在自动化流程中复用。

Word-Formatter-Pro 如何安装？ #

Windows #

1. 下载 Word-Formatter-Pro.v2.7.7.exe。
2. 双击运行，无需安装向导，程序即可直接使用。
3. 如需完整处理 .doc/.wps、接受修订并把自动编号转为文本，请先安装 Microsoft Office 或 WPS Office，并安装 pywin32 依赖。

macOS（Apple Silicon） #

1. 下载 Word-Formatter-Pro.v2.7.7.macOS-arm64.app.zip。
2. 解压 .zip 得到 .app，双击打开。
3. 由于应用未签名，首次运行如遇系统拦截，请前往"系统设置 > 隐私与安全性"中允许打开。
4. 如需处理 .doc/.wps 旧格式，执行 brew install --cask libreoffice 安装 LibreOffice。

Linux / 统信 UOS / 麒麟 Kylin #

1. 按架构下载对应的 .AppImage（x86_64 或 aarch64）。
2. 赋予执行权限并运行：

chmod +x Word-Formatter-Pro.v2.7.7.UOS-V20.x86_64.AppImage
./Word-Formatter-Pro.v2.7.7.UOS-V20.x86_64.AppImage

3. 如需处理 .doc/.wps 旧格式，请安装 LibreOffice：

sudo apt-get update
sudo apt-get install libreoffice libreoffice-writer

从源码安装 #

1. 安装 Python 3.x（在 Kylin 上已验证目标为 Python 3.12 venv 环境）。
2. 克隆仓库并安装依赖：

git clone https://github.com/cwyalpha/Word-Formatter-Pro.git
cd Word-Formatter-Pro
python -m pip install -U pip
pip install -r requirements.txt

3. 运行 python wfp.py 启动图形界面，或使用 python wfp_cli.py 调用命令行。
4. 如需自行打包发布，可运行 packaging/build_release.py（例如 macOS Apple Silicon：python3 packaging/build_release.py macos）。注意 PyInstaller 不支持跨系统交叉打包，请在目标系统上执行对应命令。

安装自检 #

安装完成后可运行内置单元测试确认环境正常：

python wfp.py --test
# 或
python wfp_cli.py test

Word-Formatter-Pro 如何卸载？ #

Word-Formatter-Pro 以绿色便携形式分发（Windows 为独立 .exe，Linux 为 .AppImage，macOS 为 .app），因此卸载过程非常简单。

Windows #

1. 如果程序正在运行，先关闭程序窗口。
2. 直接删除 Word-Formatter-Pro.v2.7.7.exe 文件即可。
3. 如果曾通过"控制面板 > 程序和功能"进行过安装（部分分发方式可能提供安装包），则在该列表中选中 Word-Formatter-Pro 并点击"卸载"。
4. 如需彻底清理，可删除用户目录下保存的自定义配置文件（如 wfp_config.json）。

macOS #

1. 退出正在运行的 Word-Formatter-Pro。
2. 打开"访达 > 应用程序"，将 Word-Formatter-Pro.app 拖入废纸篓，或右键选择"移到废纸篓"。
3. 清空废纸篓完成卸载。
4. 如曾保存自定义配置文件，可一并删除对应的 wfp_config.json。

Linux / 统信 UOS / 麒麟 Kylin #

1. 结束正在运行的程序进程。
2. 删除对应的 .AppImage 文件即可，例如：

rm Word-Formatter-Pro.v2.7.7.UOS-V20.x86_64.AppImage

3. 如曾为程序创建桌面快捷方式或菜单项，请一并删除对应的 .desktop 文件。
4. 清理保存的自定义配置文件（wfp_config.json）与临时目录中可能残留的排版临时文件。

从源码安装的卸载 #

从源码运行的情况下，直接删除克隆的项目目录即可；若在虚拟环境中安装过依赖，删除对应 venv 目录即可完成清理，不会影响系统全局的 Python 环境。