When to Use
当用户需要以下操作时使用：
- 合并多个Word文档（.docx）为一个
- 检查每个文档是否包含指定的板块/内容
- 统一多个文档的格式（字体、字号、行距等）
- 生成缺失板块的报告
- 收集作业、报告、论文等需要整合的场景
Core Functions
1. 合并文档
将多个.docx文档按指定顺序合并成一个。
调用方式：
from scripts.merge_and_check import merge_documents
# 基本用法
merge_documents(
input_files=["成员1.docx", "成员2.docx", "成员3.docx"],
output_file="合并结果.docx",
member_order=["张三", "李四", "王五"] # 可选
)
2. 检查板块完整性
检查每个文档是否包含指定的板块。
调用方式：
from scripts.merge_and_check import check_sections
result = check_sections(
files=["成员1.docx", "成员2.docx"],
required_sections=["作业内容介绍", "作业截图", "个人电子签"]
)
# 返回：{'member1.docx': ['作业截图'], 'member2.docx': []} # 缺失的板块
3. 统一格式
统一多个文档的字体、字号、行距等格式。
调用方式：
from scripts.merge_and_check import format_document
format_document(
input_file="input.docx",
output_file="output.docx",
font_config={
"chinese_font": "宋体", # 中文字体
"english_font": "Times New Roman", # 英文字体
"body_size": 12, # 正文字号（磅）
"title_size": 15, # 标题字号（磅）
"line_spacing": 1.5, # 行距倍数
"margin_top": 2.54, # 上边距（厘米）
"margin_bottom": 2.54, # 下边距
"margin_left": 3.17, # 左边距
"margin_right": 3.17 # 右边距
}
)
4. 一键执行完整流程
合并 + 检查 + 格式化 一起执行。
调用方式：
from scripts.merge_and_check import process_homework
result = process_homework(
input_folder=r"D:\作业文件夹",
output_file="整合结果.docx",
required_sections=["作业内容介绍", "作业截图", "个人电子签"],
member_order=["张三", "李四", "王五"],
font_config={
"chinese_font": "宋体",
"english_font": "Times New Roman",
"body_size": 12,
"line_spacing": 1.5
}
)
# 返回：{'success': True, 'missing_report': {...}, 'merged_file': '整合结果.docx'}
User Guidance
用户使用时请提供：
必须信息
- 要合并的文档 - 文件路径或所在文件夹
- 要检查的板块 - 如 ["作业内容介绍", "作业截图", "个人电子签"]
可选信息
- 成员顺序 - 如 ["张三", "李四", "王五"]，留空则按文件名排序
- 字体设置 - 如果需要统一格式
- 输出文件名 - 默认为 "整结果.docx"
用户指令示例
> "合并这个文件夹里的作业文档，检查每个人是否有作业内容介绍、作业截图和个人电子签"
> "把同学们的实验报告整合成一篇，按张三、李四、王五的顺序，字体改成小四宋体，行距1.5倍"
> "检查这篇论文是否包含摘要、引言、方法、结果、讨论、参考文献这几个部分"
Default Config
默认格式配置（如用户不指定则使用）：
DEFAULT_FONT_CONFIG = {
"chinese_font": "宋体",
"english_font": "Times New Roman",
"body_size": 12, # 小四
"title_size": 15, # 三号
"line_spacing": 1.5, # 1.5倍行距
"margin_top": 2.54, # 2.54cm = 1英寸
"margin_bottom": 2.54,
"margin_left": 3.17,
"margin_right": 3.17
}
Common Errors
- 文件找不到：确保文件路径正确，使用绝对路径
- 板块检测不准：有些文档可能用图片或表格代替文字，建议人工复核
- 格式不生效：某些特殊样式可能需要手动调整
Related Skills
word-docx- Word文档详细处理（当需要更精细的控制时使用）
