公文自动排版工具：基于 LLM Agent 的党政机关公文排版助手 #
公文自动排版工具是什么？ #
公文自动排版工具（GovDocFormatter）是一款基于大模型（通义千问）与 Multi-Agent 架构的党政机关公文自动排版 Agent 工具。它支持上传 Word 文档或直接粘贴文本，自动识别标题、一至四级标题、正文、发文机关、日期等文档结构，并按照《党政机关公文格式》(GB/T 9704-2012) 国家标准进行排版，最终生成规范、可直接使用的 Word 文档。
对于需要频繁起草、修改公文的机关文秘和行政人员来说，手工调整字体、字号、缩进、行距往往耗时又容易出错。公文自动排版工具把这一过程交给 AI Agent 自动完成，用户只需提供原始文本，即可得到符合国标格式的成品公文，大幅降低排版门槛与重复劳动。目前项目仍处于初级阶段，正在持续优化中。
公文自动排版工具有哪些亮点特色？ #
- Multi-Agent 智能处理系统：内置 RouterAgent（行文规范性判断）、CleanerAgent（文本清洗）、MarkerAgent（结构标记）、ValidatorAgent（一致性校验）四个 Agent 协同工作，自动识别并处理不规范的输入文本。
- 一键套用国标格式：严格按照《党政机关公文格式》(GB/T 9704-2012) 自动应用字体、字号、缩进、行距与页边距，无需手动设置样式。
- 混合字体智能处理：中文使用规定字体（如方正小标宋简体、黑体、楷体_GB2312、仿宋_GB2312），英文和数字统一使用 Times New Roman，全文风格一致。
- 异常文本自动清洗：自动删除 Markdown、emoji 等非公文格式内容，并将各种异常括号统一转换为中文全角括号，规范标题编号层级。
- 双输入方式，灵活易用：既支持上传 .doc / .docx 文件（.doc 需 LibreOffice 自动转换），也支持直接粘贴公文文本，Web 界面支持拖拽上传。
- 即时下载排版结果：排版完成后可直接下载生成的 Word 文档，无需等待或额外导出步骤。
- 模型与 API Key 在线切换：可在界面右上角切换不同的通义千问模型，并在线修改 API Key，无需重启程序。
- 支持打包成 Windows EXE：可打包为免安装的 Windows 可执行程序，非技术用户无需配置 Python 环境即可直接运行。
免费下载公文自动排版工具 #
以下为官方提供的安装包，点击链接即可下载。
| 文件名 | 描述 | 大小 | 下载 |
|---|---|---|---|
| GovDocFormatter.zip | 公文自动排版工具打包版（解压即用） | 33.5 MB | 夸克网盘 |
也可前往项目 Releases 页面 获取最新发布包。
公文自动排版工具 如何使用？ #
公文自动排版工具提供直接使用打包版和开发模式运行两种方式，普通用户推荐前者。
方式一：直接使用打包版（推荐普通用户）
- 下载并解压：获取
GovDocFormatter.zip后解压，双击运行公文自动排版工具.exe。 - 首次配置：程序启动后会自动打开浏览器，首次使用需配置通义千问 API Key（获取地址：https://dashscope.console.aliyun.com/），并可选择使用的模型（默认 qwen-turbo）。
- 开始排版：配置完成后自动跳转到主界面，上传 Word 文档或粘贴文本，工具会自动识别结构并进行排版。
- 下载结果：排版完成后即时下载生成的 Word 文档。
- 随时调整：点击右上角 ⚙️ 按钮，可随时切换模型或修改 API Key。
方式二：开发模式运行（开发者/高级用户）
- 安装 Python 依赖：
pip install -r requirements.txt - （可选）安装 LibreOffice 以支持
.doc文件转换。 - 复制
.env.example为.env并填入DASHSCOPE_API_KEY。 - 启动服务：
python run.py - 访问前端页面
http://localhost:8000/static/index.html，API 文档位于http://localhost:8000/docs。
排版规范说明
- 标题：方正小标宋简体、二号、居中；
- 一级标题：黑体、三号、序号"一、"；二级标题：楷体_GB2312、三号、序号"（一）"；
- 三级标题：仿宋_GB2312（加粗）、三号、序号"1."；四级标题：仿宋_GB2312、三号、序号"（1）"；
- 正文：仿宋_GB2312、三号、首行缩进 2 字符、两端对齐；
- 页面：A4，页边距上 37mm、下 35mm、左 28mm、右 26mm，每页 22 行、每行 28 字，行距固定值 28 磅。
公文自动排版工具的常见问题？ #
使用公文自动排版工具需要付费吗？ 工具本身为开源免费项目，但排版依赖通义千问大模型，需要自行在阿里云百炼平台申请 API Key，API 调用可能产生相应费用，具体以阿里云计费规则为准。
支持哪些文件格式？
支持 .doc 和 .docx 两种 Word 格式。其中 .doc 格式需要安装 LibreOffice 进行自动转换，若仅使用 .docx 可跳过该步骤。
如何获取通义千问 API Key？
前往阿里云百炼控制台（https://dashscope.console.aliyun.com/）注册并创建 API Key，填入工具的配置页面或 .env 文件即可。
打包版和开发模式有什么区别？ 打包版为 Windows 免安装 EXE，适合不熟悉代码的普通用户；开发模式需要自行安装 Python 依赖，适合需要修改代码或进行二次开发的开发者。
可以切换不同的模型吗？ 可以。工具支持在界面右上角切换不同的通义千问模型，默认使用 qwen-turbo，并支持在线修改 API Key 而无需重启程序。
排版结果不准确怎么办？ Multi-Agent 架构会自动重试，多次重试仍失败才报错。若结果不理想，可检查输入文本是否过于混乱，或尝试更换模型后重新排版（参考社区常见反馈）。
公文自动排版工具如何安装？ #
Windows（打包版，推荐）
- 从 Releases 页面或网盘下载
GovDocFormatter.zip。 - 解压到任意目录，双击运行
公文自动排版工具.exe。 - 首次运行按提示配置 API Key 与模型即可，无需安装 Python 环境。
Windows / macOS / Linux（开发模式）
- 安装 Python，并执行
pip install -r requirements.txt。 - （可选）安装 LibreOffice 以支持
.doc转换：- Ubuntu/Debian/WSL：
sudo apt install -y libreoffice - CentOS/RHEL：
sudo yum install -y libreoffice - macOS：
brew install --cask libreoffice - Windows：
winget install TheDocumentFoundation.LibreOffice或choco install libreoffice
- Ubuntu/Debian/WSL：
- 复制
.env.example为.env，填入DASHSCOPE_API_KEY。 - 运行
python run.py，浏览器访问http://localhost:8000/static/index.html。
开发者打包成 EXE
在 Windows 环境下执行 build.bat 一键打包，脚本会自动清理构建文件、生成图标、执行 PyInstaller 打包并压缩成 ZIP。
公文自动排版工具如何卸载？ #
Windows（打包版）
- 关闭正在运行的公文自动排版工具程序。
- 直接删除解压得到的程序文件夹即可完成卸载。
- 如需彻底清理，请手动删除用户目录下的配置文件夹：
C:\Users\<用户名>\.公文排版工具\（内含config.json、uploads/、outputs/等残留数据）。
开发模式（Windows / macOS / Linux）
- 停止运行中的服务进程（
python run.py）。 - 删除项目目录，或移除虚拟环境及其依赖包。
- （可选）删除
.env配置文件及系统环境变量中的DASHSCOPE_API_KEY。 - 若不再需要
.doc转换功能，可卸载 LibreOffice。
提示：卸载前建议备份
outputs/目录中已排版完成的公文文档，避免误删。