LaTeX 中文複習資料生成器（通用版）
一鍵操作：任何課程教材 → 6 至 12 份 PDF（摘要、練習、3 至 5 份試卷 + 答案）。
輸出檔案
生成 2 + 2N 個檔案：2 個基礎檔案 + 每份試卷各一個試卷檔與答案檔。預設 N = 5（12 個檔案：A--C 加上 D 提高卷與 E 挑戰卷）；小型課程（≤3 章）N = 2（6 個檔案）；若使用者時間有限或要求少一點，N = 3（8 個檔案）。
| 檔案 | 用途 |
|---|---|
知識點彙總.tex | 每章詳細複習筆記 |
章節練習.tex | 練習題，答案以 notebox 內嵌呈現 |
模擬卷A.tex / _答案.tex | 基礎篇——僅含題目 / 解題與評分標準 |
模擬卷B.tex / _答案.tex | 核心章節 |
模擬卷C.tex / _答案.tex | 跨章節綜合 |
模擬卷D.tex / _答案.tex | 提高卷（5 卷組的預設輸出） |
模擬卷E.tex / _答案.tex | 挑戰卷（5 卷組的預設輸出） |
以 N 份試卷進行章節劃分（最大化覆蓋，無重疊）：
- A：前三分之一——基礎
- B：中間三分之一——核心
- C：最後三分之一 + 跨章節綜合
- D/E（可選）：不新增章節。它們以更高難度重新測試相同範圍（參見 §3.6）。
對於小型課程（≤3 章）：改為 2 份試卷（A：第 1-2 章，B：第 2-3 章，允許重疊）。
每份試卷使用步驟 0 中提取的格式。僅在沒有任何資訊時才使用備用格式：20 題單選（×1 分）+ 10 題多選（×2 分）+ 10 題判斷（×1 分）+ 5 題問答/計算（×10 分）= 100 分，120 分鐘。保持前三份試卷的題目主題不重複：出現在試卷 A 的主題不應在 B 或 C 中出現。D/E 可以重新探討主題，但必須改變角度並提高認知層級。
關鍵規則：
模擬卷*.tex= 僅含題目 + 草稿空間。絕對不能將答案放在試卷檔案中。模擬卷*_答案.tex= 包含評分標準的獨立答案檔案。- 如上所示使用中文檔名。對於純英文課程，則改用英文檔名：
chapter_summary.tex、chapter_exercises.tex、mock_exam_A...E.tex、mock_exam_A...E_answers.tex。
使用時機
- 使用者要求生成「複習資料」、「考點總結」、「模擬卷」、「練習題」
- 使用者提供課程教材（PDF/PPT/DOCX）並希望得到 PDF 輸出
- 任何課程類型，任何語言混合（中文、英文、雙語）
跳過時機：僅有 1-2 頁教材；使用者只需要單一檔案；純英文且無中日韓文字。
步驟 0：提取考試情報（在開始撰寫任何內容之前）
最大的失敗模式是生成一份與真實考試不符的通用試卷。請先提取並寫下此表格；在摘要的第一頁與交付的 README 中放入一段「考試簡報」。
| 項目 | 從何處取得 | 範例 |
|---|---|---|
| 日期 / 時長 | 課程大綱、最後一次課堂錄音 | [日期], [時長] |
| 題型與配分 | 課堂錄音、課程大綱 | [例如] 20 題單選×1 分 + 4 題簡答×10 分 + 2 題論述×20 分 |
| 範圍內 / 外 | 老師的明確陳述 | 第 1--6 章；第 7 章排除 |
| 權威來源 | 老師的規則 | 教科書 / PPT / 兩者 / 歷屆試題 |
| 重點 / 權重 | 課堂錄音、重複出現的主題 | 第 3 章 = 核心；後面章節僅需基礎 |
| 術語變體 | 教科書 vs 投影片 | 教科書「術語 A」= 投影片「術語 B」 |
| 允許的輔助工具 | 課程大綱 | 閉卷考試 |
規則：
- 切勿在沒有其他資訊的情況下預設使用 20 題單選 + 10 題多選 + 10 題判斷 + 5 題問答。該格式是備用方案，不是預設值。
- 如果考試沒有選擇題，不要憑空發明選擇題。如果考試有一個 30 分的案例題，則試卷應圍繞案例題設計。
- 如果有課堂錄音，請先轉錄。最後一次課堂錄音幾乎總是包含格式、範圍和重點。
- 排除的內容也是考試內容：「第 7 章不在範圍內」必須出現在第一頁。
0.1 情報庫存：可取得的資訊因課程而異
不同的課程會提供不同數量的資訊。記錄你所處的層級，切勿默默地將假設升級為事實。
| 可用教材 | 可提取的資訊 | 其餘部分的處理方式 |
|---|---|---|
| 完整錄音 / 逐字稿 | 格式、範圍、排除內容、重點、術語 | 最佳情況——將其引用為考試簡報 |
| 課程大綱 / 教學大綱 | 章節、權重、有時包含格式 | 依據大綱建構結構；重點仍未知 |
| 歷屆試題（過去 3--5 年） | 題型、風格、重複主題 | 從中推斷格式；標明「根據歷屆試題推斷」 |
| 僅有投影片 | 主題、術語、「重點/考點」標記 | 範圍 = 投影片內容；考試可能以 PPT 為基礎——請詢問 |
| 僅有教科書 | 章節結構與深度 | 假設完整覆蓋，無格式資訊 |
| 無任何資料 | — | 詢問使用者（格式和範圍是兩個值得問的問題）；如果無法詢問，請在第一頁陳述假設 |
權威來源規則：寫下考試遵循的是 教科書 / PPT / 兩者 / 歷屆試題 中的哪一個。如果未知，請在產生前詢問。不要假設教科書勝出——許多課程是依據投影片出題的。
0.2 術語處理取決於權威來源
| 權威來源 | 使用哪個術語 |
|---|---|
| 教科書 | 以教科書術語為主，第一次使用時在括號中附上投影片術語 |
| PPT | 以投影片術語為主，第一次使用時在括號中附上教科書術語 |
| 兩者 / 混合 | 使用在考試題幹或歷屆試題中出現的術語；在「術語對照」框中列出兩者 |
| 未知 | 使用教師教材中出現頻率最高的術語，並標記 |
始終添加一行：僅當老師確實說過「兩種表述均有效」時才加入該行；否則不要發明寬容。
0.3 在生成前詢問（格式 + 個人化）
永遠不要在假設的基礎上開始撰寫。如果教材沒有回答以下問題，請詢問使用者——一次問完，不要逐個詢問。
必須知道（阻擋性問題）：
- 題型與分值：選擇/簡答/計算/證明/畫圖/編程/案例各幾道、多少分、多長時間。
- 考試範圍與排除章節。
- 命題依據：教材 / PPT / 兩者 / 往年題。
個人化（詢問一次，之後套用）： 4. 還剩幾天、每天能投入幾小時（決定資料厚度與套數）。 5. 哪幾章最弱（加權：多出題、多解釋、多對比）。 6. 目標分數（及格線 / 中上 / 衝高分 → 決定深度與是否加挑戰題）。 7. 想要幾套卷（預設 5：A–C + D 提高 + E 挑戰；時間緊可只要 3 套，或 2 套）。 8. 答案要多細（只給答案 / 給步驟 / 給評分點 + 易錯點）。 9. 是否需要 OCR 掃描教材、是否需要雙語。
若使用者未回答則使用預設值（將其印在第一頁，以便使用者更正）：
- 預設 5 套（A–C + D 提高 + E 挑戰）；時間緊才降到 3 套；答案給評分點 + 關鍵步驟；不 OCR；中文。
- 範圍 = 所提供材料覆蓋的章節；命題依據 = 材料中出現最多的那套，並標註「未確認」。
如何詢問：貼上一張緊湊的卡片（模板在 references/exam-blueprint.md §1），一次最多問 6 個問題。如果使用者說「你看著辦」，陳述預設值並繼續。
步驟 1：閱讀所有教材
PDF — 始終優先使用 pdftotext（Read 工具會錯誤地將許多未加密的 PDF 報告為「密碼保護」）：
pdftotext -layout "file.pdf" - 2>/dev/null | head -N # N = 需要的頁數
# 特定頁面：pdftotext -layout -f 1 -l 30 "file.pdf" -
僅當 pdftotext 產生亂碼輸出時：才改用 Read 作為備用。如果兩者都失敗，則使用 python -c "import PyPDF2; ..." 嘗試提取。
DOCX/PPTX — 使用 Python 的 zipfile + xml.etree.ElementTree（模板請見參考資料）。始終使用 glob.glob() 以避免 Windows 中文路徑錯誤。
掃描的教科書（無文字層）— OCR 管道：
- 檢查：
pdftotext -f 1 -l 3 book.pdf -無輸出 → 表示這是掃描的 PDF。 - 使用 GPU OCR（透過
rapidocr_onnxruntime+onnxruntime-gpu，設定use_cuda: true的 PaddleOCR 模型）：在 RTX 4070 上約 1.5 秒/頁（200 dpi）；CPU 約 30 秒/頁，因此 GPU 很重要。 - 從掃描的目錄（OCR 前約 10 頁）或 PDF 書籤取得章節頁碼範圍：
PDF 頁碼 = 印刷頁碼 + 偏移量。 - 逐章進行 OCR，每章一個
chN.txt文件，每頁前面加上【第 N 頁】以便後續引用。 - 跳過老師明確排除的章節——不要浪費 GPU 時間在它們身上。
- 告知使用者 OCR 錯誤率（約 3%），且數字/標點符號必須與紙本書籍核對。
課堂錄音：先轉錄（使用 whisper / funasr / 提供的逐字稿）。最後一次課堂錄音通常會陳述考試格式、範圍、排除內容和重點——這是步驟 0 的輸入，不是可選的背景資訊。
閱讀後，提取並記錄：
- 章節數量、結構、哪些章節有/沒有教材
- 課程名稱、教師、教科書、考試格式、評分比重（來自課程大綱/第 0 章）
- 教師的重點：「重點」/「考點」標籤、重複出現的主題、歷屆試題主題列表
- 語言：全中文 / 全英文 / 雙語 → 決定輸出語言
- 任何使用者提供的優先級列表或限制（目標分數、學習時間）
步驟 2：偵測課程類型
教材中的訊號：
公式、推導、「證明」、希臘字母、需要計算的數字 → 量化型（數學/物理/投資/金融）
程式碼、架構、電路、協定、「設計/實現」 → 工程型
事件、日期、概念、政策、法律條文、意識形態 → 質化型（人文/社會科學）
官方文件、「精神/意義/新時代」、價值判斷、時政 → 思政型（思政/政治理論）
公式與案例混合（管理、金融、法學） → 混合型
模板：
- 量化型：背景 → 核心模型 → 假設 → 推導 → 性質 → 測試 → 常見錯誤
- 工程型：原理 → 架構/設計 → 關鍵機制 → 公式/計算 → 範例 → 取捨 → 常見錯誤
- 質化型（人文）：背景 → 核心概念 → 框架 → 關鍵論點 → 比較 → 意義 → 常見混淆
- 思政型（思政）：背景與定位 → 核心概念/原文表述 → 邏輯框架（為什麼/是什麼/怎麼做）→ 聯繫實際 → 常見表述錯誤
- 混合型（管理/法學/醫學）：概念 → 框架 → 案例應用 → 決策規則 → 常見錯誤
選擇合適的模板。對於混合型課程，可依章節而異。請參閱 references/course-types.md 取得各類型的題庫（評分邏輯、作答空間、致命錯誤）。
2.1 試卷設計因課程類型而異
一份適用於管理的試卷對於思政和工程課程來說會失敗。在撰寫題目之前，請設定好這些參數。
| 課程類型 | 典型題型 | 作答空間 | 評分邏輯 | 致命錯誤 |
|---|---|---|---|---|
| 工程型 | 選擇、填空、簡答、計算、畫圖、設計、程式 | 計算 8--12 cm；畫圖半頁（給座標/網格）；程式碼 20--30 行 | 步驟分：公式→代入→結果→單位；程式碼看正確性/邊界/複雜度 | 只寫結果無過程；單位/量綱錯；程式碼只過範例 |
| 人文型 | 名詞解釋、簡答、材料分析、論述 | 名詞 4 cm；簡答 8 cm；論述 1.5 頁 | 觀點 + 論據 + 結構 + 表達；允許多元答案但要論證 | 只羅列不論證；無文本/史料證據；時代錯置 |
| 思政型（思政） | 單選、多選、判斷、簡答、材料分析、論述 | 簡答 8--10 cm；材料分析 12--15 cm；論述整頁 | 踩點給分，關鍵詞必須是官方表述；多選按「少選得部分分、錯選不得分」 | 口語化、自由發揮、引用錯、觀點偏差；用舊表述 |
| 量化型 | 選擇、填空、計算、證明 | 計算 8--10 cm；證明 10--12 cm | 步驟分 + 結果分；有效數字/近似條件 | 跳步；條件寫錯；結論與假設不符 |
| 混合型（管理/法學/醫學） | 選擇、簡答、案例分析、論述 | 每小問 3--4 cm；論述整頁 | 框架 + 案例事實 + 結論；法學按「結論—依據—涵攝」 | 只背理論不結合案例；結論無依據 |
類型特定規則：
- 工程型：在前面提供公式表/常數表；答案中要求寫單位；為圖形保留網格空間；說明是否允許使用計算機。
- 人文型：答案檔案給出「要點 + 可接受的其他觀點」，而非單一標準答案；在課程涉及之處引用原文。
- 思政型：每個答案都必須緊扣教科書/官方文件的措辭；添加一個「表述對照」框（口語說法 → 規範說法）；切勿編造政策引文；檢查過去 12 個月內最新的會議精神/時政；將任何不確定的引文標記為「以教材原文為準」。
- 量化型：陳述假設和顯著性水準；答案顯示完整的推導鏈。
步驟 3：根據優先權重規劃內容
章節優先級邏輯（使用第一個適用的）： 0. 使用者說某章節較弱（「我第 4 章最虛」）→ 權重最高：更多題目、更多解釋、更多比較。
- 使用者明確表示「第 X 章最重要」或提供了優先主題列表 → 權重較高
- 教師教材將主題標記為「重點」/「考點」→ 依此加權
- 歷屆試題集中在某些章節 → 依此加權
- 預設：所有章節權重相等
在步驟 0.3 之後應用個人化：
- 時間預算：≤3 天 → 摘要 + 1–2 套；≥1 週 → 摘要 + 練習 + 3–5 套。
- 目標分數：及格 → 重點與基礎；高分 → 添加比較、邊緣情況、挑戰題。
- 答案詳細程度：「僅給要點」/「給步驟」/「評分標準 + 常見錯誤」（預設：評分標準 + 關鍵步驟）。
- 較弱章節：每個較弱章節多添加一個示範例題和一個練習題。
每章最低要求：
- 摘要：至少 150 行，至少 5 個小節，至少 1 個比較表/時間軸，包含 [CORE]/[KEY]/[NOTE] 標籤
- 練習：至少 10 題（4-5 題單選，2-3 題多選，2-3 題填空，2 題簡答，1 題論述）。答案放在
notebox中。 - 試卷：使用步驟 0 的格式和 §2.1 中的類型特定表格（20+10+10+5 / 100 分 / 120 分鐘的結構僅是備用方案）
- 試卷答案：獨立的檔案，包含每個題目的明確分數細項的評分標準
缺失的章節：從其他教材重建。如果無任何可用資訊，請在輸出中標記，並針對該主題使用標準教科書知識。
語言輸出：與考試語言相符。如果考試是英文 → 英文題目 + 雙語解釋。如果考試是中文 → 全部使用中文。讓來源教材決定這一點。
術語對齊：應用 §0.2 中的表格——主要術語取決於考試是依據教科書、PPT、兩者還是歷屆試題。在首次使用時將另一個名稱放在括號中，切勿默默地混用它們。
步驟 3.5：設計試卷（作答空間、案例、分頁）
3.5.1 作答空間（強制）
一份沒有寫作空間的模擬考試只是一個題目列表，而不是一份試卷。每個需要書寫的題目後面都必須有空白空間，其大小應符合預期的答案長度。
| 題型 | 空白空間 | LaTeX |
|---|---|---|
| 單選 / 判斷 | 無（選項內聯） | — |
| 填空 | 每個空格 0.8--1.2 cm | \vspace{1cm} |
| 名詞解釋 | 3 cm | \vspace{3cm} |
| 簡答 (10 分) | 3--4 cm | \vspace{3.2cm} |
| 計算 | 8--12 cm | \vspace{10cm} |
| 證明 / 推導 | 10--12 cm | \vspace{11cm} |
| 畫圖 / 設計 | 半頁，帶網格或邊框 | \vspace{12cm} + 網格 |
| 程式 | 20--30 行 + 複雜度說明 | \vspace{14cm} |
| 論述 (25 分) | 9--12 cm，或一整頁 | \vspace{10cm} |
| 案例分析 (30 分, 3 小問) | 每個小問後面 3--4 cm | \vspace{3.2cm} ×3 |
規則：
- 將
\vspace{...}緊接在它所屬的小問之後，切勿放在該小問的結尾之後。
...
[其餘內容依此類推……]