Document Format GUI (公文格式处理工具)

项目简介

这是一个专为解决 Word 文档格式混乱问题而设计的极简工具。它采用了现代化的纸质感 UI 设计，能够智能识别文档中的标点、排版和字体问题，并可以根据国家标准（GB/T 9704-2012）进行一键自动化修复。

特点：

• 🎯 极简操作 — 即使是电脑小白也能上手即用
• 🔒 安全离线 — 纯本地运行，数据不联网，保障公文安全
• 📋 标准规范 — 严格遵循党政机关公文格式标准

v1.8.7 更新：

• 🖱️ 拖拽兼容增强 — GitHub 发布版会打包拖拽运行库；拖拽组件初始化失败时自动降级为点击选择文件，并在日志里说明原因
• ✅ 复选框渲染修复 — 主界面和自定义模式开关改为自绘样式，避免部分 Windows 主题下系统复选框显示异常
• 🍎 macOS 安装体验 — DMG 内置 Applications（应用程序） 拖拽入口；发布包支持 Developer ID 签名，补齐公证密钥后会自动进行 Apple 公证
• 🎨 品牌展示更新 — 新增应用图标、GitHub 横幅图和新版界面截图
• 📏 页码设置回归测试 — 补充页码样式、奇偶页位置、已有页码替换和非页码页脚保护测试
• 🔤 macOS 公文字体别名 — 优先识别手动安装的 仿宋_GB32312 / 楷体_GB32312 等兼容字体

核心能力

本工具不仅仅是简单的格式刷，它能深度识别并修复以下常见痛点：

1. 🔣 符号标准化：自动检测并修复括号、引号、逗号、句号、分号等全角半角混用问题，一律调整为中文规范符号。
2. 📏 页边距校准：强制统一页边距设置，符合公文版心要求。
3. 🔤 字体智能适配：智能识别小标题与正文层级，自动匹配对应的字体（如黑体、仿宋）和字号。
4. 📝 缩进自动补全：扫描全文，为缺失首行缩进的段落自动添加标准的 2 字符缩进。
5. 📐 行距统一规范：识别文档中不统一的行距设置，一键调整为标准行距（如 28 磅）。
6. 1️⃣ 序号风格修正：自动清洗混乱的序号格式，统一风格（例如将混用的"1、"和"1."统一规范化）。
7. 🎨 视觉背景调整：支持调整页面背景颜色，提供更舒适的编辑阅读体验。
8. 🧹 字体样式清洗：深度清理文档中不规范的字体颜色、粗细、下划线及斜体，还原清爽版面。
9. 📂 .DOC / .WPS 兼容：完整支持 .doc 和 .wps 格式的输入与输出，无需手动转换，兼容 WPS 及 Microsoft Office 生态。
10. 📊 表格自动调整：智能识别文档中的表格，自动调整列宽、行高及单元格格式。默认保留原始对齐方式，自定义模式下可开启按内容类型智能对齐（数字靠右、短文本居中等）。
11. ⚙️ 自定义格式配置：支持用户自定义页边距、行距、字体字号等格式参数，满足不同排版需求。
12. 🅱️ 灵活加粗控制：标题、各级标题、正文等均可独立设置加粗，高级设置中可逐元素精细控制。
13. 📦 开箱即用：内置 pywin32 组件，无需额外安装 Python 环境，下载即用，真正的绿色免配置。

下载安装

Windows 10/11 用户

1. 点击下载：Document_Format_GUI.exe
2. 下载后双击即可运行，无需安装 Python，绿色纯净。

注意：

• 支持 .docx、.doc 及 .wps 格式文档。

Windows 7/8 用户

1. 点击下载：Document_Format_GUI_Win7.exe
2. 下载后双击即可运行，无需安装 Python。

注意：

• 需要 Windows 7 SP1 或更高版本
• 需要安装 Microsoft Office 或 WPS Office 才能处理 .doc / .wps 格式
• 推荐使用 .docx 格式以获得最佳兼容性
• 如果双击后闪退，请安装 Visual C++ Redistributable 2015-2022

macOS 用户

1. 按芯片下载对应版本：

   • Intel 芯片（x86_64）：Document_Format_GUI_Intel.dmg
   • Apple Silicon（M1 / M2 / M3 / M4）：Document_Format_GUI_Apple_Silicon.dmg

2. 安装步骤：

   1. 双击下载的 .dmg 文件，弹出安装窗口
   2. 将窗口中的应用图标拖拽到 Applications（应用程序） 文件夹入口中
   3. 关闭安装窗口，弹出（推出）DMG 磁盘映像

3. 打开应用：

   发布包支持 Developer ID 签名；如果仓库已配置完整 Apple 公证密钥，构建时会自动完成公证。当前如果尚未配置公证密码，首次打开仍可能需要在「隐私与安全性」里手动放行。

   1. 双击应用，在弹出的提示框点 「完成」
   2. 打开 系统设置 → 隐私与安全性
   3. 向下滚动，在「安全性」区域找到"已阻止 XXX 以保护你的 Mac"的提示
   4. 点击 「仍要打开」，输入系统密码确认即可
   5. 之后再次使用直接双击，无需重复

   注意：macOS Sequoia(15) 起已取消"右键→打开"的绕过方式，只能走上面系统设置里的「仍要打开」。

注意：

• macOS 版本仅支持 .docx 文件；.doc/.wps 需要先转换为 .docx。
• 公文字体（仿宋_GB2312、黑体等）macOS 不自带，建议提前安装对应字体以获得最佳效果。未安装时工具会自动回退到 macOS 系统字体。
• 当前 macOS 打包版默认关闭文件拖拽入口，优先保证 Intel / Apple Silicon 两个版本都能稳定打开。选择文件、批量文件夹、粘贴文本生成 docx 等功能不受影响。

国产系统用户（麒麟 / 统信 UOS / 深度 / 中标麒麟 等）

⚠️ 目前为测试版本，欢迎在 Issues 反馈问题（请注明系统名称和版本）

方式一：下载预编译版本（推荐）

第一步：查询当前架构，在终端运行：

uname -m

第二步：赋予执行权限并运行

chmod +x docformat_linux          # ARM64 用户替换为 docformat_linux_arm64
./docformat_linux

如果双击无反应，请在文件管理器中右键 → 属性 → 勾选"允许作为程序执行"

方式二：源码运行（binary 报错时的备选）

适合 binary 无法运行的情况（如 GLIBC 版本不匹配、龙芯等其他架构）：

# 1. 下载源码（或从 Releases 下载源码压缩包）
git clone https://github.com/KaguraNanaga/docformat-gui.git
cd docformat-gui

# 2. 运行安装助手（自动检测环境、安装依赖、启动程序）
bash install.sh

注意：

• Linux 版本仅支持 .docx 文件；.doc/.wps 请先在 Windows 上另存为 .docx
• 龙芯（LoongArch）用户请使用方式二

使用方法

第一步：选择文件

点击界面上方的「输入」栏，选择你需要处理的 Word 文档。

第二步：选择模式

界面提供了三种处理模式，满足不同需求：

第三步：开始处理

点击中间醒目的 「开始处理」 按钮。

• 处理完成后，工具会自动在原文件旁边生成一个新的文件（文件名后缀为 _processed）。
• 你的原文件永远不会被覆盖或修改，请放心使用。

常见问题

Q：处理后的文档打开是乱码或字体不对？ A：公文格式依赖特定的字体。请确保你的电脑安装了以下字体（Windows 通常自带）：

• 仿宋_GB2312
• 黑体
• 楷体_GB2312

Q：macOS 上提示"已损坏，无法打开"怎么办？ A：正式发布版不应该出现这个问题。请确认下载的是最新 Release；如果你用的是自行打包版或未公证测试版，可以在终端中执行以下命令移除隔离属性后再打开（按你下载的版本二选一）：

# Intel 芯片
xattr -cr /Applications/docformat_macos_intel.app
# Apple Silicon（M 系列）
xattr -cr /Applications/docformat_macos_apple_silicon.app

Q：Windows 7 上运行闪退或报错怎么办？ A：请确保：

1. 已安装 Windows 7 SP1
2. 已安装 Visual C++ Redistributable 2015-2022
3. 下载的是 Win7 专用版本（文件名含 _win7）

Q：Linux 上提示 “Exec format error” 或无法执行？ A：通常是架构不匹配。请先运行 uname -m，然后下载对应的 x86_64 或 ARM64 版本。

Q：Linux 上提示 “GLIBC_2.xx not found” 或启动失败？ A：系统的 glibc 版本过低或不兼容。建议改用源码方式运行：bash install.sh。

Q：Linux 上提示缺少 tkinter 或无法创建窗口？ A：请先安装系统依赖（例如 sudo apt-get install -y python3-tk），然后再运行 bash install.sh。

Q：为什么提示「文件不存在」？ A：请检查文件名或文件夹路径中是否包含极其生僻的特殊字符。建议将文件放在桌面或纯英文路径下尝试。

Q：可以批量处理多个文件吗？ A：支持。点击输入框时可多选文件（按住 Ctrl 或 Shift），选择多个文件后输出框会自动切换为目录选择模式，处理完成后所有文件统一保存到指定目录，文件名自动添加 _processed 后缀。

Q：龙芯（LoongArch）能用吗？ A：目前没有 LoongArch 预编译版本。请使用源码方式运行：bash install.sh。

反馈与建议

如果这个工具帮到了你，或者你发现了 Bug，欢迎联系我：

• 提交 Issue: GitHub Issues
• 邮件联系: legacyofhourai@163.com

数据安全

🔒 本工具所有操作均在本地完成，不会上传任何文档内容到服务器或云端。无网络通信、无数据收集、无遥测追踪。源代码完全开放，欢迎审查。

详见 数据安全与免责声明。

开源许可

本项目基于 MIT 许可证 开源，欢迎开发者共同完善。

第三方依赖许可证信息详见 THIRD_PARTY_LICENSES.md。