docx-clean-styles — Word 样式清理
触发条件
当用户提到以下任一意图时触发:
- "清理Word样式" / "删除多余样式" / "简化样式列表"
- "样式面板太乱" / "不相关的文字样式删掉"
- "把 XXX.docx 里没用的样式去掉"
- 指定一个 .docx 文件或文件夹,要求"只保留正文和标题"
使用方式
直接运行内置脚本,一键完成解压→分析→清理→打包全流程。
清理单个文件
python scripts/clean_styles.py "D:/path/to/document.docx"
清理文件夹下所有 .docx
python scripts/clean_styles.py "D:/path/to/folder/"
清理多个文件
python scripts/clean_styles.py "D:/a.docx" "D:/b.docx" "D:/c.docx"
保留策略
脚本默认保留以下样式,其余全部删除:
| 类别 | 保留内容 |
|---|---|
| 正文 | Normal、Default Paragraph Font、标题字符 |
| 标题 | heading 1-5(段落+字符样式) |
| 表格 | Normal Table、Table Grid、网格型1、表格2.0 |
| 列表 | No List |
| 超链接 | Hyperlink、FollowedHyperlink |
| 页眉页脚 | header/footer 段落和字符样式 |
| 文档实际使用 | 自动扫描 document.xml 中所有在用样式 |
删除内容
- heading 6-9 + 对应字符样式
- TOC1-TOC9(目录样式)
- 批注/批注主题/annotation 全套
- font5-font12(字体残留样式)
- xl65-xl79(Excel 导入残留)
- Title、Subtitle、表单、列表段落等未使用样式
注意事项
- 脚本依赖 docx 插件的
unpack.py和pack.py,如果路径变化需更新脚本顶部常量 - 操作直接覆盖原文件,建议先备份
- 保留策略如需调整(如只保留标题1-3),修改脚本中
BASE_KEEP_IDS集合即可