课程课件自动整编备考助手

概述

本 Skill 实现从原始课件到期末复习资料的完整自动化流程。输入多份 PDF/Word 课件与课堂笔记，输出一份排版规范的 Word 复习文档，包含：

• 精简背诵提纲（按章节组织、标题层级分明）
• 配套选择题练习题（自动根据知识点生成、附带答案）

触发条件

当用户消息包含以下任一关键词组合时触发本 Skill：

• "课件整编" / "整编课件"
• "期末整理备考资料" / "期末复习资料整理"
• "考点提炼" / "提炼考点"
• "整理复习提纲" / "整理期末重点"
• "课程资料整理" / "课程复习"

完整工作流

工作流总览

用户输入 & 文件导入  →  Step1: 文档预处理  →  Step2: 考点提取  →  Step3: 提纲与出题  →  Step4: Word输出

Step 1: 文档预处理与导入

目标：接收用户上传的文件，完成清洗和标准化。

操作步骤：

1. 接收文件：提示用户提供需要处理的文件路径（PDF课件、PPT导出的PDF、Word课堂笔记）。支持以下格式：

   • .pdf — 课件PDF、PPT导出PDF
   • .docx / .doc — Word课堂笔记

2. 运行预处理脚本：

   python scripts/main_pipeline.py --step preprocess --input <文件目录或文件列表>
   

   该脚本自动调用 pdf_processor.py 和 docx_processor.py 完成：

   • 过滤空白页（内容占比 < 5% 的页面）
   • 去除水印文字层
   • 剔除广告页和无关配图
   • 检测并移除重复页面（基于文本相似度 > 95%）
   • 统一编码和文本提取

3. 输出：每份文件生成对应的清洗后 .txt 临时文件，存放于临时工作目录。

容错处理：

• 文件损坏 → 弹窗提示 ⚠️ 文件 [文件名] 已损坏，已跳过该文件，继续处理其余文件
• 格式不兼容 → 弹窗提示 ⚠️ 文件 [文件名] 不支持该格式，已跳过
• 读取超时（30秒超时） → 弹窗提示 ⚠️ 文件 [文件名] 读取超时，已跳过，继续

Step 2: 分章节考点提取

目标：对每份清洗后的文档按章节解析，提取核心考点。

操作步骤：

1. 运行考点提取脚本：

   python scripts/main_pipeline.py --step extract --input <预处理后的txt目录>
   

2. 提取规则（由 content_extractor.py 执行）：

   • 章节识别：通过正则匹配 第X章、Chapter X、§、数字编号标题等模式
   • 核心概念：提取章节首段定义性语句、加粗/标题化术语
   • 专业定义：识别 "XX是指"、"定义"、"XX指的是"、"所谓XX" 等模式
   • 公式：识别 LaTeX 公式、行内公式、编号公式
   • 简答题考点：识别 "特点"、"分类"、"原因"、"意义"、"作用"、"区别"、"联系" 等考点信号词
   • 剔除冗余：移除过渡句、举例详述、故事性叙述、重复解释

3. 输出：JSON 格式的考点结构化数据，按章节分组。

Step 3: 提纲生成与配套出题

目标：将考点转化为背诵提纲，并自动生成选择题。

操作步骤：

1. 运行提纲生成脚本：

   python scripts/main_pipeline.py --step generate --input <考点JSON文件>
   

2. 提纲生成规则（由 outline_builder.py 执行）：

   • 每个考点浓缩为 1-3 句核心表述
   • 公式单独列出并编号
   • 定义类考点使用 "术语：定义内容" 格式
   • 按原章节顺序排列，保持层级结构

3. 选择题生成规则（由 exam_generator.py 执行）：

   • 每个章节至少生成 3 道单选题
   • 题型：4选1 单项选择题
   • 干扰项策略：同类概念混淆、常见误区、相近数值
   • 每题附带正确答案标注
   • 输出格式：

     【第X章 章节名】
     1. 题目内容？
        A. 选项一  B. 选项二  C. 选项三  D. 选项四
        答案：X
     

Step 4: Word 文档合并排版

目标：将提纲和习题合并为一篇标准 Word 文档。

操作步骤：

1. 运行文档生成脚本：

   python scripts/main_pipeline.py --step output --input <提纲与习题数据> --output <输出文件名.docx>
   

2. 排版规则（由 outline_builder.py 执行）：

   • 文档标题：一级标题，居中，黑体 18pt
   • 章节标题：二级标题（Heading 2），黑体 16pt
   • 考点子标题：三级标题（Heading 3），黑体 14pt
   • 正文：宋体 12pt，1.5 倍行距
   • 公式：独立段落，居中对齐，Consolas 字体
   • 选择题：选项字母加粗，宋体 12pt
   • 答案部分：红色字体标注

3. 文档结构：

   封面/标题页
   ├── 第一部分：背诵提纲
   │   ├── 第1章 XXX
   │   │   ├── 1.1 核心概念
   │   │   ├── 1.2 重点定义
   │   │   ├── 1.3 公式汇总
   │   │   └── 1.4 简答题考点
   │   ├── 第2章 XXX
   │   └── ...
   └── 第二部分：配套练习题
       ├── 第1章 选择题
       ├── 第2章 选择题
       └── ...
       └── 参考答案
   

错误处理统一规范

所有错误均遵循"弹窗提示 + 跳过继续"原则，绝不中断整个工作流：

资源文件

scripts/ — 可执行处理脚本

references/ — 参考文档

使用示例对话：

用户："帮我把这些课件整编成期末复习资料"（附带文件路径）

助手：按照 Step 1→4 依次执行，每步反馈进度。最终输出 Word 文件路径并使用 present_files 展示。