cheat-sheet

Cheatsheet 生成器

你做什么

把用户的学习资料（PDF/Word/Markdown/文本）压缩成一份双栏、小字、信息密度高的 Cheatsheet 文档（PDF 格式）。

核心原则：只保留干货，砍掉废话。

---

⚠️ 铁律：避免重复创建

生成 Cheatsheet 前，先扫描输出目录检查是否已有同主题文件：

• 已存在 → 问用户"已经有一份 [文件名] 了，覆盖 / 新建一份 / 跳过？" 等用户回复再动手
• 不存在 → 直接生成
• 绝不未经询问直接覆盖

---

工作流程

步骤 1：接收资料

用户提供学习资料文件，支持格式：

• .pdf — 调 PDF skill 的 process 路线提取文本
• .docx — 调 PDF skill 的 process 路线提取文本
• .md / .txt — 直接读取

提取文本命令：

# PDF 提取文本
python3 "$PDF_SCRIPTS/pdf.py" extract.text <file_path>

# Word 转 PDF 后提取（如需要）
python3 "$PDF_SCRIPTS/pdf.py" convert.office <file_path>

其中 $PDF_SCRIPTS 为 PDF skill 的 scripts 目录路径，需从 PDF skill 的 SKILL.md 位置推导。

如果用户没有提供文件而是直接贴了文本内容，跳过提取步骤，直接用文本。

---

步骤 2：选择风格

必须询问用户想要哪种风格（不要自己替用户选）：

向用户展示以下选项：

1. 📋 知识点速查卡 — 核心概念 + 定义 + 关键公式/要点，一眼扫到，适合考前突击
2. 🌳 思维导图式 — 按层级结构组织（大标题→子标题→要点），有大纲感，适合梳理体系
3. ❓ Q&A 式 — 把知识点变成"问题→答案"对，适合自测复习

用户选择后进入步骤 3。

---

步骤 3：LLM 提炼内容

根据用户选择的风格，构建不同的 prompt 让 LLM 从原文中提炼 cheatsheet 内容。

风格 1：知识点速查卡

提炼规则：

• 提取所有核心概念、定义、公式、关键数据
• 每个知识点用 术语：一句话解释 的格式
• 相关知识点分组，每组有小标题
• 重要公式/代码片段原样保留
• 砍掉所有举例、过渡句、背景铺垫

输出结构：

## [分组标题]
- **术语A**：一句话定义
- **术语B**：一句话定义
- 📐 公式：`公式内容`

## [分组标题]
...

风格 2：思维导图式

提炼规则：

• 提取文档的层级结构（章→节→要点）
• 每个节点用最简短的语言概括
• 最多 3 级深度（再深就塞不进一页了）
• 用缩进和符号表达层级关系

输出结构：

# 主题

## 一级分支
  ├─ 二级要点
  │   ├─ 细节 1
  │   └─ 细节 2
  └─ 二级要点
      └─ 细节

风格 3：Q&A 式

提炼规则：

• 把每个知识点转化成一个问题
• 答案控制在 1-3 句话
• 问题从基础到进阶排列
• 易混淆的概念出辨析题

输出结构：

## [主题分组]

**Q：什么是 XXX？**
A：一句话回答。

**Q：XXX 和 YYY 的区别？**
A：简短对比。

---

步骤 4：用户确认与调整

LLM 生成内容后，先以文本形式展示给用户，询问：

"内容整理好了，你看看有没有要调整的？比如：

• 某些部分要加重点标记？
• 某些内容要删掉或补充？
• 排版上有什么偏好？（比如字号再小一点、分区颜色区分等）"

用户确认"可以"后，进入步骤 5。 用户提出修改 → 调整内容 → 再次展示 → 等待确认。

---

步骤 5：生成 PDF

调用 PDF skill 的 Report 路线（ReportLab） 生成双栏 PDF。

排版规格（默认值）：

参数	默认值	说明
页面大小	A4	可按用户要求调整
栏数	双栏	默认双栏，用户可选单栏
正文字号	8pt	信息密度优先，可按用户要求调整
标题字号	10pt（一级）/ 9pt（二级）
行距	1.2	紧凑但可读
页边距	上下左右各 12mm	最大化内容区域
字体	中文用 UniSong/UniHei，英文用 Helvetica