# Add to your Claude Code skills
git clone https://github.com/KaguraNanaga/docformat-guiGuides for using documentation skills like docformat-gui.
Last scanned: 5/25/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-05-25T08:22:27.549Z",
"semgrepRan": false,
"npmAuditRan": true,
"pipAuditRan": false
}No comments yet. Be the first to share your thoughts!
Top skills in this category by stars
这是一个专为解决 Word 文档格式混乱问题而设计的极简工具。它采用了现代化的纸质感 UI 设计，能够智能识别文档中的标点、排版和字体问题，并可以根据国家标准（GB/T 9704-2012）进行一键自动化修复。
特点：
v1.8.1 更新：
# / ## / ### 标题、**加粗**、列表、引用和代码块，兼容 ##标题 这种省略空格的中文 Markdown 写法.doc/.docx/.wps 文档批量处理2.xxx / 3.xxx 被误识别为正文或三级标题的问题，并按规范应用附件悬挂缩进v1.7.2 更新：
2026.04.20 等点分日期被误识别为三级标题并加粗的问题tkinterdnd2 加入默认依赖，输入框 placeholder 文案根据可用性动态切换v1.7.1 更新：
v1.7.0 更新：
v1.6.0 更新：
更早版本：
.doc / .wps 格式支持；表格自动调整；自定义格式配置；开箱即用打包本工具不仅仅是简单的格式刷，它能深度识别并修复以下常见痛点：
.doc 和 .wps 格式的输入与输出，无需手动转换，兼容 WPS 及 Microsoft Office 生态。注意：
- 支持
.docx、.doc及.wps格式文档。
注意：
- 需要 Windows 7 SP1 或更高版本
- 需要安装 Microsoft Office 或 WPS Office 才能处理
.doc/.wps格式- 推荐使用
.docx格式以获得最佳兼容性- 如果双击后闪退，请安装 Visual C++ Redistributable 2015-2022
安装步骤：
.dmg 文件，弹出安装窗口首次打开（重要⚠️）：
由于本应用未经过 Apple 公证签名，macOS 会阻止首次打开。请按以下步骤操作：
如果右键打开仍然被阻止（提示"无法验证开发者"），请尝试：
- 打开 系统设置 → 隐私与安全性
- 向下滚动，在「安全性」区域找到被阻止的应用提示
- 点击 「仍要打开」 按钮
- 输入系统密码确认，即可正常使用
注意：
- macOS 版本仅支持
.docx文件；.doc/.wps需要先转换为.docx。- 公文字体（仿宋_GB2312、黑体等）macOS 不自带，建议提前安装对应字体以获得最佳效果。未安装时工具会自动回退到 macOS 系统字体。
⚠️ 目前为测试版本，欢迎在 Issues 反馈问题（请注明系统名称和版本）
第一步：查询当前架构，在终端运行：
uname -m
| 输出结果 | 适用硬件 | 下载链接 |
|---|---|---|
| x86_64 | Intel / AMD / 兆芯 / 海光 | docformat_linux |
| aarch64 | 飞腾 / 鲲鹏 / 树莓派 | docformat_linux_arm64 |
第二步：赋予执行权限并运行
chmod +x docformat_linux # ARM64 用户替换为 docformat_linux_arm64
./docformat_linux
如果双击无反应，请在文件管理器中右键 → 属性 → 勾选"允许作为程序执行"
适合 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 通常自带）：
Q：macOS 上提示"已损坏，无法打开"怎么办？ A：在终端中执行以下命令移除隔离属性，然后重新打开：
xattr -cr /Applications/docformat_macos.app
Q：Windows 7 上运行闪退或报错怎么办？ A：请确保：
_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，欢迎联系我：
🔒 本工具所有操作均在本地完成，不会上传任何文档内容到服务器或云端。无网络通信、无数据收集、无遥测追踪。源代码完全开放，欢迎审查。
详见 数据安全与免责声明。
本项目基于 MIT 许可证 开源，欢迎开发者共同完善。
第三方依赖许可证信息详见 THIRD_PARTY_LICENSES.md。