docformat-gui

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

一键修复 Word 文档格式，让排版不再头疼。

官方网站 · Skills GitHub · 在线版本 · 立即下载 · 核心能力 · 使用方法 · 常见问题 · Agent Skill · English

🌐 公文格式处理工具网页版已上线

无需安装、无需登录，打开浏览器即可处理 .docx 文档。文档只在当前浏览器中处理，不会上传到服务器；首次加载必要组件后，当前页面可在断网状态下继续使用。

产品入口

• 官网：gongwengeshizhushou.com — 汇总开源版本、Skills 产品及最新产品信息。
• Skills GitHub：KaguraNanaga/document-format-skills — 查看并获取公文格式处理 Skills，直接在通用 Agent 里进行使用。
• 在线版本：web.gongwengeshizhushou.com — 桌面端无法安装，希望随时随地使用？直接在浏览器中使用在线工具。

项目简介

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

特点：

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

v1.8.8.5 更新：

• 🛠️ 设置窗口修复 — 拖拽运行库加载失败时清理残留窗口，保证自定义设置正常显示和保存
• ℹ️ 关于窗口更新 — 加入专业版、Word / WPS 插件版介绍和官网入口，支持滚动阅读
• 📦 已发布功能保留 — 保留 v1.8.8.4 的通用排版、样例学习、自动编号和新版界面，并合入后续修复

v1.8.8.3 更新：

• 🛠️ 小问题修复 — 修复了一些小 Bug 和小问题，优化使用体验

v1.8.8.4 更新：

• 📐 通用文档排版 — 可自定义段落类型和本地匹配规则，支持章、条、语录等非公文结构
• 📄 从样例学习样式 — 仅在本机读取 .docx 的页面、字体、缩进和行距，不复制正文内容
• 1️⃣ 自动编号规范化 — 将可解析的 Word 自动编号固化为可见文字，避免标题识别和重复编号问题
• 📊 表格与页面增强 — 支持表格引导段保护、单元格四边边距、文字自动适应、纸张尺寸和横竖方向
• 📋 文本转 Word — 可粘贴纯文本或 Markdown 生成 .docx
• 🖥️ 界面适配 — 更新现代控件、高 DPI 缩放和窗口自适应布局

v1.8.8 更新：

• 📄 页码设置优化 — 支持四种页码样式、居中或奇偶页外侧位置，并可安全替换已有页码而不覆盖正常页脚内容
• 🈶 中文换行规则 — 为正文、表格和页眉页脚启用中文禁则，避免标点出现在新行行首
• 🔤 标题字体细分 — 一级至四级标题均可分别设置中文字体与英文/数字字体
• 🖼️ 图片与附件保护 — 保留内嵌图片和媒体节点；独立“附件/附件1”等标记另起页并保持后续标题格式

使用许可

您当前使用的是免费开源版（GitHub）。从 v1.8.8.3 起，本版本依据 PolyForm Noncommercial License 1.0.0 提供，仅限个人和非商业用途免费使用；未经许可，不得销售、收费分发或用于其他商业目的。

核心能力

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

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 环境，下载即用，真正的绿色免配置。
14. 🧩 通用段落规则：自定义段落类型、字体、缩进、行距和本地正则匹配规则，规则在本机确定性执行。
15. 📄 样例样式学习：从排版正确的 .docx 中提取可复用样式参数，并在保存前预览确认。
16. 📐 页面与单元格增强：自定义纸张尺寸和横竖方向，并细化单元格边距和文字适应选项。

下载安装

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_amd64.AppImage   # ARM64 用户替换为 docformat_linux_aarch64.AppImage
./docformat_linux_amd64.AppImage

如果双击无反应，请在文件管理器中右键 → 属性 → 勾选"允许作为程序执行"。部分系统缺少 FUSE 时，可运行 ./docformat_linux_amd64.AppImage --appimage-extract-and-run，或改用源码运行方式。

方式二：源码运行（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
• 邮件联系: [email protected]

数据安全

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

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

使用许可

从 v1.8.8.3 起，本项目采用 PolyForm Noncommercial License 1.0.0：个人和非商业用途可以免费使用、修改和按许可证要求分发；其他商业用途需要另行取得授权。

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

_{Made with ❤️ by KaguraNanaga}