feat(在学练习): 概率论第5讲(大数定律与CLT)+第6讲(数理统计) 整套;第3讲中高难度卷;md2pdf 工具链

新增
- 在学练习/概率论-第5讲-大数定律与中心极限定理/:README + 01考点手册 + 02试题(16题) + 03解析 + PDF×3
- 在学练习/概率论-第6讲-数理统计/:README + 01考点手册 + 02试题(18题) + 03解析 + PDF×3
- 在学练习/概率论-第3讲.../05-试题-中高难度.md、06-解析-中高难度.md + 平板版 PDF×6(四件套 + 中高难度)
- .workbuddy/tools/md2pdf/:md2pdf.js(Markdown→KaTeX→Edge 无头打印 A4,含 answer 留白模式)、shot.js(渲染验收截图)
- .workbuddy/memory/:2026-10-14.md、2026-10-16.md、MEMORY.md

更新
- .gitignore:新增忽略 md2pdf/build/(HTML 内联字体,体积大)
- 总览.md:目录树同步(第5/6讲、第3讲中高难度卷、PDF 清单)
- 第3讲 01-考点手册/02-试题/README:中高难度卷接入与索引回填

说明:PDF 为 KaTeX 矢量公式渲染的平板书写版(试题逐题留白),由 md2pdf.js 从 .md 可重建。
This commit is contained in:
2026-10-16 14:17:28 +08:00
parent 82f15e18d9
commit 31fe3da11f
31 changed files with 3114 additions and 7 deletions
+72
View File
@@ -0,0 +1,72 @@
# 2026-10-14 工作日志
## 推送上云(git push → app.zhantiandoudi.cn/Yimu/MathNotesVersion2)
**背景**:用户指令"推送上云"。工作区 `D:/考研/第二代数学笔记` 是 git 仓库,远程 `origin = https://app.zhantiandoudi.cn/Yimu/MathNotesVersion2.git`(Gitea 类自建,凭证经 Windows Git Credential Manager 已缓存)。
### 推送前的关键排查
1. **本地落后云端 1 个提交**:本地 main=`a3e3773`(init),云端 main=`0c199f6`("02数列极限加练与错题复盘")。属快进关系,需先变基。
2. **🔴 发现 `.gitignore` 规则全部失效**:原文件把注释写在**行尾**(如 `**/solutions/ # 历年答案 PDF`),而 gitignore 的 `#` **必须独占行首**,行尾 `#` 会被当作模式的一部分 → `solutions/`、`papers/images/`、`papers/*.md`、`papers/数学二/` 四条排除规则**均未生效**。实测待推送体积 **259MB**(含试卷 205MB 图片/PDF + 参考仓库 54MB 嵌套仓库);修复后降至 **160KB**。已改为行首注释,并新增忽略 `参考仓库/`(内含嵌套 `.git`,无法作为普通文件推送)。
3. **9 个笔记被本地删除**:`数学一/知识点/` 下 8 个 + `以题带点/2023-17-微分方程建模.md`。但 `总览.md` 里仍标 ✓,判断可能非本意 → **已向用户确认,用户选择"保持删除并同步"**。
4. **README.md 双方都改**:云端改"进度"段(02 数列极限 2026-10-04 / 03–14),本地改(02 加强版双链 + 04–14 + 新增复习手册节)。**冲突解决**:保留本地更完整版本,并修正云端 `03–14` 与上方 03 行重复的问题为 `04–14`。
### 执行过程
1. 修复 `.gitignore`(行首注释 + 新增 `参考仓库/`)。
2. `git add -A` → 暂存 10 新增 / 9 删除 / 3 修改(确认参考仓库与试卷图片未被暂存)。
3. `git commit`(66c0956)→ `git rebase origin/main` → 仅 README.md 冲突 → 手工合并 → `git rebase --continue`(新提交 **82f15e1**)。
4. `git push origin main` → `0c199f6..82f15e1` ✓。
### 结果
- 云端与本地 main 均为 **`82f15e1`**,`git status -sb` 无 ahead/behind,**已同步**。
- 本次推送内容:概率论第3讲四件套(README + 01考点手册 + 02试题 + 03解析 + 04答疑笔记)、每日小练 02-数列 系列 4 个文件、`.workbuddy/memory/2026-10-13.md`、README/总览/.gitignore 更新。
- 云端原有文件保留:`每日小练/02-数列极限.md`、`02-数列极限-加练.md`、`知识点/数列极限-方法复盘.md`。
### ⚠️ 待用户决定的遗留问题
`每日小练/` 现在**存在两套并列的"02"**(并行会话/多机造成):
- 本地线:`02-数列.md`(2026-10-12 初版)+ `02-数列-加强版.md` + `02-数列-知识点复习.md` + `02-数列-质量审计.md`
- 云端线:`02-数列极限.md`(2026-10-04)+ `02-数列极限-加练.md`
且 `总览.md` 中 `知识点/`、`以题带点/` 节点仍标 ✓,但实际已随本次删除移除 —— **总览与磁盘不一致,待同步**。
### 可复用的经验
- `.gitignore` 注释必须独占一行;行尾注释会静默失效,务必用 `git ls-files --others --exclude-standard` + `du --files0-from=-` 实测待推送体积。
- 该仓库推送前固定检查:①`git fetch` 看是否落后 ②`git rev-list --left-right --count origin/main...main` ③待推送体积 ④缺失(D)/新增(A)清单(尤其**删除项**要人工确认)。
- `du -ch | tail -1` 配 `xargs` 会因分批而给出错误总计,须用 `du -ch --files0-from=-`。
---
## 概率论第3讲 → 平板书写版 PDF(新建 md2pdf 工具链)
**需求**:把「在学练习/概率论-第3讲-多维随机变量及其分布」转成适合平板上手写的 PDF,要求**公式精确渲染**、**每题留半页/整页答题**。
**环境约束**:本机**无 pandoc、无 LaTeX(xelatex 等)**;有 Edge(Chromium 内核)、托管 Node v22、npm 可达。
→ 选定渲染链:**Markdown → 公式保护占位 → markdown-it → KaTeX 服务端渲染 → 内联字体 CSS → puppeteer-core 驱动 Edge 无头打印**。
### 新增工具(可复用,非一次性脚本)
- `D:/考研/第二代数学笔记/.workbuddy/tools/md2pdf/md2pdf.js` —— 主转换器
- `--mode plain`:普通版(考点手册/解析/答疑)
- `--mode answer`:答题版,按 `**N.**` 切题,逐题注入 `.q-space` 留白(A 组 88mm / B·C 组 178mm,含浅色虚框 + 横向书写格)
- 关键实现:`$…$`、`$$…$$` 先替换成 `\uE000n\uE001` 占位符再走 markdown(**解决表格单元格内含 `|` 的公式被拆表问题**);KaTeX CSS 只保留 woff2 并 base64 内联(离线可渲染,约 800KB/份);页脚用 puppeteer `footerTemplate` 加「标题 + 页码/总页数」。
- `D:/考研/第二代数学笔记/.workbuddy/tools/md2pdf/shot.js` —— 把 HTML 按像素区间截图,用于**视觉验收公式/表格/留白**。
- 依赖装在托管工作区 `C:/Users/Wang Ling/.workbuddy/binaries/node/workspace`(katex 0.19、markdown-it、puppeteer-core),**未污染用户环境**。
### 产物(`在学练习/概率论-第3讲-多维随机变量及其分布/PDF/`)
| 文件 | 页数 |
|---|---|
| 概率论第3讲-试题-答题版.pdf | 17(1 封面页 + A 组 3 页 + B 组 8 页 + C 组 5 页) |
| 概率论第3讲-考点手册.pdf | 10 |
| 概率论第3讲-解析.pdf | 7 |
| 概率论第3讲-答疑笔记.pdf | 9 |
**验收**:截图抽查首页(表格+行内公式)、B 组页、C 组页(`cases` 独立公式居中)、考点手册页(二维正态长公式、blockquote),公式与表格均正确、无溢出。
**同步**:`README.md` 新增「五、平板书写版(PDF)」节(含重新生成命令);`总览.md` 目录树补 `04-答疑笔记.md` 与 `PDF/` 四个文件;`.gitignore` 追加忽略 `.workbuddy/tools/md2pdf/build/`(HTML 中间产物体积大)。
**待确认**:留白尺寸(A 半页 / B·C 整页)如不合用,改 `pageCss()` 里 `.q-space.half|.full` 的高度重跑即可;PDF 尚未 push,等用户确认后随下次提交上云。
+131
View File
@@ -0,0 +1,131 @@
# 2026-10-16 工作日志
## 概率论第3讲 · 新增「中高难度卷」(12 题)
**需求**:为本章再出一份试题,**只出中高难度题**(不含基础题)。
### 命题依据(先把真题基本面摸清)
- 查询 `kaoyan_math1.db` 第 17 章:十年 **11 题**(2016·22、2017·22、2018·22、2019·8、2019·22、2020·22、2021·22、2022·10、2023·22、2024·9、2025·22),其中 9 道 11–12 分解答题 + 2 道选填。
- 对照既有 `02-试题`(19 题)的覆盖表,发现 **5 个空档**:①离散型二维函数分布;②正态差 |X−Y|(2019·8 只被"顺带提到");③条件期望;④一般二维函数的联合分布(雅可比 + 支撑集形状);⑤2025·22 式应用建模。
- 新卷**对准这 5 个空档 + 同考法换数字**,并刻意避开 02-试题 已用的结构(均匀域离散化、条件均匀、混合正态、圆域 X²+Y²、雅可比比值)。
### 产出
- `05-试题-中高难度.md` —— **12 题(B 中等 7 / C 拔高 5)**,题号 1–12 独立成卷。
- B:离散表格 Z=X+Y、正态差(锚 2019·8)、条件密度+条件期望(f=24xy on x+y<1,锚 2024·9)、商分布(U(0,1)/E(1),锚 2021·22)、半圆均匀+面积比、离散×连续乘积(锚 2019·22)、二维正态线性组合。
- C:雅可比一一变换(U=X+Y, V=X−Y,**菱形支撑集**)、顺序统计量 (min,max)、卷积分段(U(0,1)+E(1))、条件分布→相关系数(Y|X=x~U(x,2x),ρ=3√(3/31))、串联/并联寿命应用建模(锚 2025·22)。
- `06-解析-中高难度.md` —— 逐题含答案/思路/易错点,末尾附「与既有 19 题分工表」「真题覆盖表」「新填 5 缺口」,并诚实列出仍未覆盖的 2 个方向。
- PDF:`PDF/概率论第3讲-试题-中高难度-答题版.pdf`(13 页:1 封面 + 12 题各 1 页整页留白)、`PDF/概率论第3讲-解析-中高难度.pdf`(9 页)。复用 `.workbuddy/tools/md2pdf` 工具链,截图抽查公式与留白均正常。
**同步**:`README.md` 文件表补 05/06、PDF 表补两行;`总览.md` 目录树补 05/06 与两份新 PDF。
### 关键数值(复核过,可复用)
- f=24xy on {x>0,y>0,x+y<1}:c=24,f_X=12x(1−x)²,f_{Y|X}=2y/(1−x)²,E(Y|X=x)=2(1−x)/3,E(Y)=2/5。
- X~U(0,1), Y~E(1), Z=Y/X:f_Z(z)=[1−(1+z)e^{−z}]/z²,z>0。
- X,Y iid U(0,1),U=X+Y,V=X−Y:|J|=1/2,支撑集为菱形(顶点 (0,0),(1,1),(2,0),(1,−1)),f_UV≡1/2。
- X,Y iid U(0,1) 的 (min,max) 联合密度 = 2(0<u<v<1),E(min)=1/3,E(max)=2/3。
- 两个 Exp(λ) 串联 E=1/(2λ)、并联 E=3/(2λ)(用 max+min=X+Y 的期望恒等式)。
### 待办
- 本卷 PDF 与上次的四份 PDF **均未推送**;`每日小练` 两套并列的 02 与 `总览` 不一致问题也仍未处理。
---
## 概率论第3讲 · 补「切比雪夫不等式与大数定律」专题(8 题)
**需求**:用户问"有没有切比雪夫不等式的题,没有就加入"。
**核查结论**:原四件套 + 中高难度卷里**都没有**切比雪夫题(`01-考点手册.md` 原只有第 251 行一句带过)。真题库里有锚点:**2022·9**(单选 5 分,ch19「大数定律(切比雪夫不等式)」,题干 `X_i iid, E(X_1^k)=μ_k k=1..4`,答案 $\frac{\mu_4-\mu_2^2}{n\varepsilon^2}$)。同章未覆盖:2020·8(CLT)、2025·9(泊松近似)。
### 产出
- 新增 `07-试题-切比雪夫不等式.md`(8 题,45 分钟,不含答案)+ `08-解析-切比雪夫不等式.md`(详解 + 命题质量报告)。
- A 基础 3:直接套(含对立事件方向)、二项 B(100,.5) 估计 P{40<X<60}、Laplace 密度先求矩(E=0, D=2)。
- B 中等 3:**2022·9 骨架**(换 Y=X²,D(X²)=μ_4−μ_2²,界 $\frac{\mu_4-\mu_2^2}{n\varepsilon^2}$)、反解样本量(n≥320)、单位正方形均匀上 X+Y(D=1/6,界 ≤2/3,精确 1/4)。
- C 拔高 2:**切比雪夫大数定律证明**(两两不相关⟹方差可加⟹D\bar X≤C/n)、X,Y iid U(0,1) 的 Z=XY(D=7/144,界 ≤7/9,精确 $\frac12-\frac12\ln2\approx0.153$)。
- `01-考点手册.md`:把 §6 那句带过扩成新的 **§8 扩展专题:切比雪夫不等式与大数定律**(公式+由来+常用变形表+使用三步+陷阱表+三大数定律对照表),原速查卡顺延为 **§9**(9.1 速记十一条 / 9.2 高频陷阱),末尾 callout 补指向 07/08。
- PDF:`PDF/概率论第3讲-试题-切比雪夫-答题版.pdf`(7 页)、`PDF/概率论第3讲-解析-切比雪夫.pdf`(7 页)。截图抽查公式与留白正常。
- 同步 `README.md`(文件表 + PDF 表)、`总览.md`(目录树 + PDF 列表)。
### 关键数值(复核过)
- Laplace f=½e^{−|x|}:EX=0,E(X²)=Γ(3)=2⟹DX=2;P{|X|≥3}≤2/9≈0.222,精确 e^{−3}≈0.0498。
- 单位正方形均匀:X,Y iid U(0,1),D(X+Y)=1/6;P{|X+Y−1|≥½}≤2/3,精确 1/4。
- Z=XY(独立 U(0,1)):EZ=1/4,EZ²=1/9,DZ=7/144;界 ≤7/9,精确 ½−½ln2。
- 反解样本量:1−16/n≥0.95 ⟹ n≥320。
### 待办(更新)
- 三批 PDF(原始四份 + 中高难度两份 + 切比雪夫两份,共 8 份)**均未推送**;`每日小练` 两套并列的 02 与 `总览` 不一致问题仍待处理。
---
## 概率论第5讲 · 新建「大数定律与中心极限定理」整章(笔记 + 题目)
**用户决定**:不单独做切比雪夫题,直接进入下一章(第 5 讲)——切比雪夫本就属这一讲,并入即可。
### 结构调整(重要)
- **撤销**第 3 讲里刚做的「单独切比雪夫」:删除 `07-试题-切比雪夫不等式.md`、`08-解析-切比雪夫不等式.md` 及其两份 PDF 与 build HTML;把 `01-考点手册.md` 的 §6 那条恢复成一句(只留指向第 5 讲的链接),删除临时插入的 §8 扩展专题,速查卡回滚为 §8(8.1 十句速记 / 8.2 高频陷阱);`README.md`、`总览.md` 的相关行一并回滚。**第 3 讲现只有 01–06 + PDF。**
- **新建** `在学练习/概率论-第5讲-大数定律与中心极限定理/`(README + 01 考点手册 + 02 试题 + 03 解析 + PDF/),沿用第 3 讲的多文件约定。
### 命题依据
- 真题库 **第 19 章**近十年**仅 3 题**(2020·8 中心极限 4 分、2022·9 切比雪夫 5 分、2025·9 泊松近似 5 分),全部单选、每 4–5 年一轮。
- 参考仓库:`probability-theory-and-mathematical-statistics/knowledge/4-...tex`(179 行,依概率收敛 / 三大数定律 / 列维-林德伯格 + 棣莫弗-拉普拉斯,含 4 例题)+ `knowledge/3 §切比雪夫不等式`;`exercise/4` 是空壳。
### 产出
- `01-考点手册.md`(307 行):§1 依概率收敛(含"$X_n=\frac1n$ 概率 $1-\frac1n$、$=n$ 概率 $\frac1n$"反例)、§2 切比雪夫不等式(由来/变形/三步/陷阱)、§3 三大数定律(切比雪夫/伯努利/辛钦 + 条件对照表 + 2 例题)、§4 两中心极限定理(标准化四步模板)、§5 **正态近似 vs 泊松近似判别**、§6 十年真题落点地图、§7 速查卡。
- `02-试题.md`:**16 题**(A 基础 6 / B 中等 6 / C 拔高 4),不含答案。
- `03-解析.md`:16 题详解 + 命题质量报告(16 个考点全覆盖、真题 3/3 覆盖)。
- PDF:`PDF/概率论第5讲-试题-答题版.pdf`(14 页)、`-解析.pdf`(9 页)、`-考点手册.pdf`(8 页)。
### 关键数值(复核过)
- 2022·9 骨架:$Y_i=X_i^2$,$DY_i=E X^4-(EX^2)^2=\mu_4-\mu_2^2$,界 $\frac{\mu_4-\mu_2^2}{n\varepsilon^2}$。
- B1 版:$EX^2=1,EX^4=5$ ⟹ $DY=4$,界 $4/(n\varepsilon^2)$。
- 反解样本量:$1-9/n\ge0.9\Rightarrow n\ge90$;中心极限反解 $n$:$n_{\min}=102$。
- 装箱(均值 10、标准差 0.5、载重 1000、$\Phi(2)=0.977$):最多 **99** 件。
- 泊松近似 $B(300,0.01)$:$\lambda=3$,$P\{T\le1\}=4e^{-3}$。
- 切比雪夫 + 协方差($DX=DY=1,\rho=\frac12$):$D(X-Y)=1$,界 $\frac1{16}$。
- 条件辨析($X_n\sim E(n)$):$D(aX_n)$ 依次 $n^{-4},n^{-2},1,n^{2}$ ⟹ **D** 不服从(方差无界)。
### 待办
- **所有 PDF(第 3 讲 6 份 + 第 5 讲 3 份,共 9 份)均未推送**;`每日小练` 两套并列 02 与 `总览` 不一致仍待处理。
- 第 4 讲(数字特征)尚未建文件夹——第 5 讲的切比雪夫/中心极限都依赖它,若回头补第 4 讲可与之互链。
---
## 概率论第6讲 · 新建「数理统计」整章(考点 + 18 题 + 解析)
**用户决定**:继续下一章(第 6 讲,视频 8 个文件:总体与样本 / 统计量及其分布 / 点估计 / 区间估计 / 假设检验 / 两类错误)。
### 命题依据
- 真题库对应 **第 20 章(数理统计的基本概念)2 题 9 分 · 第 21 章(参数估计)10 题 93 分 · 第 22 章(假设检验)3 题 14 分**,合计 **15 题、116 分**。**参数估计标注「热门」,十年 10 题解答题(11–12 分)几乎年年一题。**
- 参考仓库:`probability-theory-and-mathematical-statistics/knowledge/5-mathematical-statistics`(512 行,含三大分布 + 正态总体抽样分布 + 矩估计/MLE + 无偏有效一致 + 四大置信区间 + 六大检验 + 两类错误)、`exercise/5`(299 行,4 类例题)。
### 产出
- 新建 `在学练习/概率论-第6讲-数理统计/`(README + 01 考点手册 + 02 试题 + 03 解析 + PDF/)。
- `01-考点手册.md`:§0 定位地图 / §1 总体与样本 / §2 统计量及其分布(三大抽样分布 + **正态总体四条 + 两总体三条** + 顺序统计量)/ §3 参数的点估计(矩估计、MLE 含**不可微取边界**、无偏/有效/一致 + **MSE**)/ §4 区间估计(**四大置信区间表** + 单侧 + 对称性技巧)/ §5 假设检验(**六大检验拒绝域表** + 与区间估计的对偶)/ §6 两类错误 / §7 十年真题落点地图 / §8 速查卡十二条 + 陷阱表。
- `02-试题.md`:**18 题**(A 基础 6 / B 中等 8 / C 拔高 4),不含答案。锚定 13 道真题,标「真题骨架」10 题。
- `03-解析.md`:18 题详解(答案/思路/易错点)+ 命题质量报告(覆盖表 13 ✅ / 2 ◐、难度用时、5 条未覆盖方向)。
- PDF:`概率论第6讲-试题-答题版.pdf`(17 页)、`-解析.pdf`(13 页)、`-考点手册.pdf`(16 页)。截图抽查公式/表格/留白均正常。
### 关键结论与数值(复核过,可复用)
- **ch20**:2017·8 答案是 **B**($2(X_n-X_1)^2$ 等于 $16\chi^2(1)$,不是 $\chi^2$);2023·9 两总体方差 $\sigma^2$ 与 $3\sigma^2$ ⟹ $\frac{3S_1^2}{S_2^2}\sim F(m-1,n-1)$(**系数 = 方差比**)。
- **ch21**:2016·14 对称性——**上限+下限 = $2\bar X$**(→下限 8.2);2016·23 $\hat a=\frac{3n+1}{3n}$(n=3 时 $\frac{10}{9}$);2018·23 Laplace MLE $\hat\lambda=\frac1n\sum|X_i|$,$E=\lambda$、$D=\lambda^2/n$;2019·23 $A=\sqrt{2/\pi}$、$\hat{\sigma^2}=\frac1n\sum(X_i-\mu)^2$;2020·23 Weibull $\hat\theta=[\frac1n\sum t_i^m]^{1/m}$(**仅 m=1 有无记忆性**);2022·22 $\hat\lambda=\frac{\sum X_i+\sum Y_j}{n+2m}$、$D\hat\lambda=\frac{\lambda}{n+2m}$(**分母权重 = 样本量 × 参数倍数**);2023·10 $a=\frac{\sqrt\pi}{2}$($E|X_1-X_2|=\frac{2\sigma}{\sqrt\pi}$);2024·22 $U(0,\theta)$ 的 $X_{(n)}$:无偏 $c=\frac{n+1}{n}$、**最小 MSE $c=\frac{n+2}{n+1}$(更小,且此时有偏)**。
- **ch22**:2018·8 答案 **D**(**小 α 拒绝⟹大 α 必拒绝;大 α 接受⟹小 α 必接受**);2021·10 $\beta=1-\Phi(1)$;2025·10 拒绝域 $\bar X\ge\mu_0+Z_\alpha\frac{\sigma}{\sqrt n}$($\sigma^2=2$ 时 $\sigma=\sqrt2$)。
- 自编数值:B13 泊松两样本 $(15+24)/(5+8)=39/13=3$;B9 双侧 $[11.32,13.28]$、单侧上限 $13.1225$、t 区间 $[11.2345,13.3655]$;B10 $c=2.8225$;B11 $\alpha=1-\Phi(5/3)$;C18 $c=0.98$、$\beta\approx\Phi(-0.04)\approx0.484$;B12 三估计量方差 $\sigma^2/3,\ 7\sigma^2/18,\ \sigma^2/2$ ⟹ $\hat\theta_1$ 最有效。
### 待办(更新)
- **所有 PDF(第 3 讲 6 份 + 第 5 讲 3 份 + 第 6 讲 3 份,共 12 份)均未推送**;`每日小练` 两套并列 02 与 `总览` 不一致仍待处理。
- 第 4 讲(数字特征)仍未建文件夹;第 6 讲的区间估计/假设检验反复用到它,建议补。
+36
View File
@@ -0,0 +1,36 @@
# 项目长期约定 · 第二代数学笔记
## 分层与目录
- 工作区根:`D:/考研/第二代数学笔记`
- 复习产出主线:`基于考研的学习/数学一/`
- `每日小练/` —— 每日 10 题复盘(一轮 25 份)
- `在学练习/<专题>-文件夹/` —— **正在学的章节**,采用「README + 01-考点手册 + 02-试题 + 03-解析 + 04-答疑笔记 + PDF/」多文件结构(用户 2026-10-13 确认)
- 答疑按**题号增量追加**到 `04-答疑笔记.md`
- 讲次 ↔ 真题库章节映射:**第3讲 多维随机变量 ↔ ch17**;**第5讲 大数定律与中心极限定理 ↔ ch19**;**第6讲 数理统计 ↔ ch20(基本概念)+ ch21(参数估计)+ ch22(假设检验)**。新讲次按「视频讲次 ↔ DB 章节」对应关系挂靠
- 考点/试题**同一知识点只归属其"正统"讲次**(如切比雪夫不等式属第 5 讲,不在第 3 讲展开,仅留一行交叉链接)
- 真题库:`试卷/Kaoyan-Math1-Papers/papers/近十年真题题库/kaoyan_math1.db`(2016–2025,225 题,表 `question`)
- 参考仓库:`参考仓库/Math/`(`.tex`,已在 .gitignore 忽略,不入库)
## 用户偏好
- 数学内容**必须准确渲染公式**;Markdown 用 `$…$` / `$$…$$`。
- 题目要求**难度分层**(A 基础 / B 中等 / C 拔高),题量可比小练多。
- 出题**防过拟合**:数字/区域原创,只对齐考法;要标「真题骨架」锚点。
- 讲解要**从零拆解 + 指出易错点**,并配图(show_widget 用 SVG)。
- 需要**平板书写版 PDF**(触控笔批注,按题留白)。
## 工具链(本项目自建,可复用)
- **md2pdf**:`D:/考研/第二代数学笔记/.workbuddy/tools/md2pdf/md2pdf.js`
- 渲染链:Markdown → 公式占位 → markdown-it → KaTeX 服务端渲染 → Edge(puppeteer-core) 无头打印 A4
- `--mode answer` 生成答题版(逐题留白:A 组 88mm、B/C 组 178mm)
- `shot.js` 用于 HTML 视觉验收截图
- 依赖装在托管 node 工作区:`C:/Users/Wang Ling/.workbuddy/binaries/node/workspace`
- 本机**无 pandoc / 无 LaTeX**,勿尝试 xelatex 路线
## 云仓库
- `origin = https://app.zhantiandoudi.cn/Yimu/MathNotesVersion2.git`(main 分支)
- **`.gitignore` 注释必须独占行首**(行尾注释会静默失效,曾导致 259MB 误入待推送)
- 推送前固定检查:`git fetch` → `git rev-list --left-right --count origin/main...main` → 待推送体积(`du -ch --files0-from=-`)→ 删除项人工确认
+259
View File
@@ -0,0 +1,259 @@
#!/usr/bin/env node
'use strict';
/**
* md2pdf.js —— 把 Obsidian 风格 Markdown(含 $..$ / $$..$$ 公式)转成适合打印/平板书写的 PDF
*
* 依赖(安装在托管 node 工作区): katex / markdown-it / puppeteer-core
* 渲染链: 公式保护 -> markdown-it -> KaTeX(服务端) -> 内联字体 CSS -> Edge(Chromium) 无头打印
*
* 用法:
* node md2pdf.js --in a.md --out a.pdf --title "标题" [--mode plain|answer] [--subtitle "..."]
*/
const fs = require('fs');
const path = require('path');
const NODE_WS = 'C:/Users/Wang Ling/.workbuddy/binaries/node/workspace';
const NM = path.join(NODE_WS, 'node_modules');
const MarkdownIt = require(path.join(NM, 'markdown-it'));
const katex = require(path.join(NM, 'katex'));
const puppeteer = require(path.join(NM, 'puppeteer-core'));
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe';
/* ------------------------------ 参数解析 ------------------------------ */
function parseArgs(argv) {
const a = {};
for (let i = 2; i < argv.length; i++) {
const k = argv[i];
if (k.startsWith('--')) a[k.slice(2)] = (argv[i + 1] && !argv[i + 1].startsWith('--')) ? argv[++i] : true;
}
return a;
}
const ARGS = parseArgs(process.argv);
if (!ARGS.in || !ARGS.out) { console.error('缺少 --in / --out'); process.exit(1); }
const MODE = ARGS.mode === 'answer' ? 'answer' : 'plain';
/* ------------------------------ KaTeX CSS(内联字体) ------------------------------ */
function buildKatexCss() {
const cssPath = path.join(NM, 'katex/dist/katex.min.css');
const fontsDir = path.join(NM, 'katex/dist/fonts');
let css = fs.readFileSync(cssPath, 'utf8');
// 去掉 woff / ttf 备选,只保留 woff2(Chromium 全支持),减小体积
css = css.replace(/,\s*url\(fonts\/[^)]+\.woff\)\s*format\('woff'\)/g, '');
css = css.replace(/,\s*url\(fonts\/[^)]+\.ttf\)\s*format\('truetype'\)/g, '');
const cache = {};
css = css.replace(/url\(fonts\/([^)]+?)\)/g, (m, file) => {
const base = file.replace(/\.(woff2|woff|ttf)$/, '');
const f = path.join(fontsDir, base + '.woff2');
if (!fs.existsSync(f)) return m;
if (!cache[base]) cache[base] = 'data:font/woff2;base64,' + fs.readFileSync(f).toString('base64');
return `url(${cache[base]})`;
});
return css;
}
/* ------------------------------ 公式保护 / 渲染 ------------------------------ */
const PUA_S = '\uE000';
const PUA_E = '\uE001';
function renderTex(tex, display) {
try {
return katex.renderToString(tex.trim(), {
displayMode: !!display, throwOnError: false, strict: false, trust: false,
macros: { '\\d': '\\mathrm{d}' }
});
} catch (e) {
return `<span class="tex-err" title="${String(e.message).replace(/"/g, '&quot;')}">${tex}</span>`;
}
}
/** 把 $..$ / $$..$$ 换成占位符,返回 {text, store} */
function protectMath(src) {
const store = [];
let out = '';
let i = 0;
const push = (tex, display) => {
const id = store.length;
store.push(renderTex(tex, display));
return PUA_S + id + PUA_E;
};
while (i < src.length) {
const c = src[i];
if (c === '\\' && src[i + 1] === '$') { out += '\\$'; i += 2; continue; }
if (c === '$' && src[i + 1] === '$') {
const end = src.indexOf('$$', i + 2);
if (end !== -1) { out += push(src.slice(i + 2, end), true); i = end + 2; continue; }
}
if (c === '$') {
let j = i + 1, close = -1;
while (j < src.length && src[j] !== '\n') {
if (src[j] === '\\') { j += 2; continue; }
if (src[j] === '$') { close = j; break; }
j++;
}
if (close !== -1 && close > i + 1) { out += push(src.slice(i + 1, close), false); i = close + 1; continue; }
}
out += c; i++;
}
return { text: out, store };
}
function restoreMath(html, store) {
return html.replace(new RegExp(PUA_S + '(\\d+)' + PUA_E, 'g'), (m, id) => store[+id] || '');
}
/* ------------------------------ Markdown 预处理 ------------------------------ */
function stripFrontmatter(md) {
const m = md.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/);
return m ? md.slice(m[0].length) : md;
}
/** Obsidian 双链 [[x|y]] / [[x]] -> 纯文本 */
function unlinkWikilinks(s) {
return s.replace(/\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/g, (m, a, b) => (b || a));
}
/* ------------------------------ HTML 模板 ------------------------------ */
function pageCss() {
return `
@page { size: A4; }
* { box-sizing: border-box; }
html, body { margin: 0; padding: 0; }
body {
font-family: "Microsoft YaHei", "PingFang SC", "Hiragino Sans GB", "Segoe UI Emoji", "Segoe UI Symbol", sans-serif;
font-size: 11.4pt; line-height: 1.78; color: #14181f;
-webkit-print-color-adjust: exact; print-color-adjust: exact;
}
.doc > *:first-child { margin-top: 0; }
h1 { font-size: 17pt; line-height: 1.4; margin: 0 0 3mm; letter-spacing: .3px; }
h2 { font-size: 13.6pt; margin: 7mm 0 3mm; padding-bottom: 1.6mm; border-bottom: 1.6px solid #2b4a7d; color: #17325c; break-after: avoid; page-break-after: avoid; }
h3 { font-size: 12.2pt; margin: 5mm 0 2mm; color: #1f3763; break-after: avoid; page-break-after: avoid; }
h4 { font-size: 11.6pt; margin: 4mm 0 1.5mm; color: #2b4368; break-after: avoid; page-break-after: avoid; }
p { margin: 1.6mm 0; }
ul, ol { margin: 1.6mm 0; padding-left: 6.5mm; }
li { margin: .9mm 0; }
blockquote { margin: 2.4mm 0; padding: 1.6mm 3.2mm; border-left: 3px solid #9fb6d6; background: #f3f6fb; color: #24313f; border-radius: 0 3px 3px 0; }
blockquote p { margin: .8mm 0; }
hr { border: none; border-top: 1px solid #d5dde8; margin: 4.5mm 0; }
table { border-collapse: collapse; width: 100%; margin: 2.6mm 0; font-size: 10.4pt; break-inside: avoid; page-break-inside: avoid; }
th, td { border: 1px solid #c2cddd; padding: 1.3mm 2.2mm; text-align: left; vertical-align: top; }
th { background: #eaf0f8; font-weight: 700; color: #17325c; }
code { font-family: Consolas, "Courier New", monospace; font-size: .92em; background: #eef2f7; padding: 0 1px; border-radius: 2px; }
pre { background: #f5f7fa; border: 1px solid #dde4ee; border-radius: 4px; padding: 2.4mm; font-size: 9.6pt; overflow-x: auto; break-inside: avoid; }
strong { color: #0f1720; }
img { max-width: 100%; }
/* 公式 */
.katex { font-size: 1.04em; }
.katex-display { margin: 2.4mm 0 !important; overflow-x: auto; overflow-y: hidden; padding: 1px 0; }
.katex-display > .katex { white-space: normal; }
.tex-err { color: #b00020; background: #ffe9ec; padding: 0 2px; }
/* 答题版 */
.q { break-inside: avoid; page-break-inside: avoid; margin: 0 0 5mm; }
.q-stem { }
.q-space { border: 1px dashed #b9c6d8; border-radius: 6px; margin-top: 3.4mm; background: repeating-linear-gradient(to bottom, #fff 0, #fff 9.4mm, #eef3f9 9.4mm, #eef3f9 9.5mm); }
.q-space.half { height: 88mm; }
.q-space.full { height: 178mm; }
.q-tag { display: inline-block; font-size: 8.2pt; color: #7c8aa0; border: 1px solid #cfd8e5; border-radius: 999px; padding: 0 2mm; margin-left: 2mm; vertical-align: 1px; }
.group-head { margin-top: 6mm; }
`;
}
function htmlShell(title, body) {
return `<!DOCTYPE html>
<html lang="zh-CN"><head><meta charset="utf-8"><title>${title.replace(/</g, '&lt;')}</title>
<style>${buildKatexCss()}</style>
<style>${pageCss()}</style>
</head><body><main class="doc">${body}</main></body></html>`;
}
/* ------------------------------ 渲染器 ------------------------------ */
function makeMd() {
return new MarkdownIt({ html: true, breaks: true, linkify: false, typographer: false });
}
function mdToHtml(md, store) {
const mdit = makeMd();
return restoreMath(mdit.render(md), store);
}
/* 试题答题版:按题切分,逐题留白 */
function buildAnswerBody(rawMd) {
const lines = unlinkWikilinks(stripFrontmatter(rawMd)).split(/\r?\n/);
const blocks = []; // {type:'md'|'q', group, num, text}
let buf = [];
let group = { level: 2, title: '' };
let cur = null;
const flushMd = () => { if (buf.join('\n').trim()) blocks.push({ type: 'md', text: buf.join('\n') }); buf = []; };
const flushQ = () => { if (cur) { cur.text = cur.text.join('\n').trim(); blocks.push(cur); cur = null; } };
for (const line of lines) {
const gh = line.match(/^##\s+(.*)$/);
const qh = line.match(/^\*\*(\d+)\.\*\*\s*(.*)$/);
if (gh) { flushQ(); flushMd(); group = { level: 2, title: gh[1] }; buf.push(line); continue; }
if (qh) { flushQ(); flushMd(); cur = { type: 'q', group: group.title, num: +qh[1], text: [line] }; continue; }
if (cur) cur.text.push(line); else buf.push(line);
}
flushQ(); flushMd();
// 组名里含 C/拔高 或 B/中等 -> 整页留白;A/基础 -> 半页
const spaceOf = (g) => (/C\s*组|拔高|★★★/.test(g) ? 'full' : /B\s*组|中等|★★☆/.test(g) ? 'full' : 'half');
const out = [];
for (const b of blocks) {
const { text, store } = protectMath(b.text);
if (b.type === 'md') { out.push(mdToHtml(text, store)); continue; }
const html = mdToHtml(text, store);
const sp = spaceOf(b.group);
out.push(
`<section class="q">${html}` +
`<div class="q-space ${sp}"></div></section>`
);
}
return out.join('\n');
}
/* 普通版 */
function buildPlainBody(rawMd) {
const { text, store } = protectMath(unlinkWikilinks(stripFrontmatter(rawMd)));
return mdToHtml(text, store);
}
/* ------------------------------ 主流程 ------------------------------ */
(async () => {
const inPath = path.resolve(ARGS.in);
const outPath = path.resolve(ARGS.out);
const raw = fs.readFileSync(inPath, 'utf8');
const title = ARGS.title || path.basename(inPath, '.md');
const body = MODE === 'answer' ? buildAnswerBody(raw) : buildPlainBody(raw);
const html = htmlShell(title, body);
const buildDir = path.join(__dirname, 'build');
fs.mkdirSync(buildDir, { recursive: true });
fs.mkdirSync(path.dirname(outPath), { recursive: true });
const tmpHtml = path.join(buildDir, path.basename(outPath).replace(/\.pdf$/i, '.html'));
fs.writeFileSync(tmpHtml, html, 'utf8');
const footer = `<div style="width:100%;font-size:8pt;color:#98a4b5;padding:0 12mm;font-family:'Microsoft YaHei',sans-serif;display:flex;justify-content:space-between;">
<span>${(ARGS.subtitle || title).replace(/</g, '&lt;')}</span>
<span><span class="pageNumber"></span> / <span class="totalPages"></span></span></div>`;
const browser = await puppeteer.launch({
executablePath: EDGE,
headless: 'new',
args: ['--no-sandbox', '--disable-gpu', '--allow-file-access-from-files', '--font-render-hinting=none'],
});
try {
const page = await browser.newPage();
await page.goto('file:///' + tmpHtml.replace(/\\/g, '/'), { waitUntil: 'load', timeout: 120000 });
await page.emulateMediaType('print');
await page.pdf({
path: outPath, format: 'A4', printBackground: true, preferCSSPageSize: true,
displayHeaderFooter: true, headerTemplate: '<div></div>', footerTemplate: footer,
margin: { top: '12mm', bottom: '14mm', left: '13mm', right: '13mm' },
});
const st = fs.statSync(outPath);
console.log(`OK ${path.basename(outPath)} ${(st.size / 1024).toFixed(0)} KB [mode=${MODE}]`);
} finally {
await browser.close();
}
})().catch(e => { console.error('FAIL:', e); process.exit(1); });
+21
View File
@@ -0,0 +1,21 @@
'use strict';
const path = require('path');
const fs = require('fs');
const NM = 'C:/Users/Wang Ling/.workbuddy/binaries/node/workspace/node_modules';
const puppeteer = require(path.join(NM, 'puppeteer-core'));
const EDGE = 'C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe';
(async () => {
const html = process.argv[2];
const outPng = process.argv[3];
const startPx = parseInt(process.argv[4] || '0', 10);
const heightPx = parseInt(process.argv[5] || '1123', 10);
const browser = await puppeteer.launch({ executablePath: EDGE, headless: 'new', args: ['--no-sandbox', '--allow-file-access-from-files'] });
const page = await browser.newPage();
await page.setViewport({ width: 794, height: 1123, deviceScaleFactor: 1.6 });
await page.goto('file:///' + path.resolve(html).replace(/\\/g, '/'), { waitUntil: 'load', timeout: 120000 });
const total = await page.evaluate(() => document.body.scrollHeight);
await page.screenshot({ path: outPng, clip: { x: 0, y: startPx, width: 794, height: Math.min(heightPx, total - startPx) } });
console.log('html height px =', total, ' -> screenshot', outPng);
await browser.close();
})().catch(e => { console.error(e); process.exit(1); });