docformat-gui

by KaguraNanagaVerified

公文格式自动处理工具(可本地运行)

756
Stars
76
Forks
Python
Language
8/23/2026
Added
View on GitHubDownload ZIP

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillTip is an informational directory and does not control or maintain the underlying repository. Any security checks displayed are automated and limited in scope. Review the source code before installing.

Read the Terms of Service

Installation

Add to your Claude Code skills directory:

# Add to your Claude Code skills
git clone https://github.com/KaguraNanaga/docformat-gui

Getting Started

Guides for using skills like docformat-gui.

Security Report

Verified

Last scanned: —

{
  "status": "PASSED",
  "issues": []
}

README.md

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

公文格式助手横幅

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

立即下载 · 核心能力 · 使用方法 · 常见问题 · English

Platform License Language


项目简介

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

特点:

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

v1.8.8.3 更新:

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

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 环境,下载即用,真正的绿色免配置。

下载安装

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. 按芯片下载对应版本:

  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
输出结果适用硬件下载链接
x86_64Intel / AMD / 兆芯 / 海光docformat_linux_amd64.AppImage
aarch64飞腾 / 鲲鹏 / 树莓派docformat_linux_aarch64.AppImage

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

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,欢迎联系我:


数据安全

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

详见 数据安全与免责声明


使用许可

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

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

Made with ❤️ by KaguraNanaga

Frequently Asked Questions

What is docformat-gui?

docformat-gui is an open-source documentation skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by KaguraNanaga. 公文格式自动处理工具(可本地运行). It has 756 GitHub stars.

Is docformat-gui safe to use?

Yes. docformat-gui passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install docformat-gui?

Clone the repository with "git clone https://github.com/KaguraNanaga/docformat-gui" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is docformat-gui written in?

docformat-gui is primarily written in Python. It is open-source under KaguraNanaga on GitHub, so you can review or fork the full source.

Are there alternatives to docformat-gui?

Yes. SkillsLLM lists many other Documentation skills you can browse and compare side by side. Open the Documentation category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh docformat-gui against similar tools.

Comments (0)

No comments yet. Be the first to share your thoughts!

Developers Also Liked

Based on votes and bookmarks from developers who liked this skill

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI Agentsai-agentsanthropicclaude-code
View details
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI Agentsai-agentsbrainstorming
View details

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP Serversapisai-tools
View details

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI Agentsai-agentsanthropicclaude-code
View details

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI Agentsclaude-codeai-tools
View details
docformat-gui — AI Skill for Claude Code | SkillTip