# 项目长期约定 · 第二代数学笔记 ## 分层与目录 - 工作区根:`D:/考研/第二代数学笔记` - 复习产出主线:`基于考研的学习/数学一/` - `每日小练/` —— 每日 10 题复盘(一轮 25 份) - `在学练习/<专题>-文件夹/` —— **正在学的章节**,采用「README + 01-考点手册 + 02-试题 + 03-解析 + 04-答疑笔记 + PDF/」多文件结构(用户 2026-10-13 确认) - 答疑按**题号增量追加**到 `04-答疑笔记.md` - 讲次 ↔ 真题库章节映射:**第3讲 多维随机变量 ↔ ch17**;**第5讲 大数定律与中心极限定理 ↔ ch19**;**第6讲 数理统计 ↔ ch20(基本概念)+ ch21(参数估计)+ ch22(假设检验)**。新讲次按「视频讲次 ↔ DB 章节」对应关系挂靠 - **线性代数(2026-10-18 起)**:第2讲 矩阵 ↔ ch10(11 题 71 分,**不出习题**)、第3讲 向量 ↔ ch11(8 题 44 分)、第4讲 线性方程组 ↔ ch12(7 题 39 分)、第5讲 特征值 ↔ ch13(11 题 83 分)、第6讲 二次型 ↔ ch14(10 题 80 分);第1讲 行列式 ↔ ch9(3 题 13 分)。参考仓库 `linear-algebra/{knowledge,exercise}/{1..6}-*` 与六章一一对应 - **高等数学(2026-10-26 起)**:目录命名 `高等数学-<章名>`(**不带讲次号**,避免与视频课讲次冲突);首个为 `高等数学-无穷级数` ↔ ch7(近十年 15 题 87 分:幂级数 8 题 48 / 傅里叶 3 题 15 / 判敛 4 题 24)。参考仓库 `advanced-math/{knowledge,exercise}/8-infinite-series/`。**张宇 1000 题高数止于第 15 章微分方程,没有级数章节**,故该讲全部原创、题首不标骨架 - 考点/试题**同一知识点只归属其"正统"讲次**(如切比雪夫不等式属第 5 讲,不在第 3 讲展开,仅留一行交叉链接) - **考点手册的覆盖面 = 大纲要求 ∪ 真题考过 ∪ 参考仓库涉及**,不能只写"真题考过的"(例:第6讲「两个正态总体的均值差/方差比区间估计与假设检验」大纲明确要求、十年未考,仍须写全,标注为"高性价比冷门") - **盘点超 1.3 万字符时**:把「覆盖对照(大纲 vs 真题 vs 参考仓库)」+「相邻讲接口」拆成 `01b-覆盖对照与接口.md`,`01` 只留知识地图;**§0.x 编号保持不变**(README 与关联行会引用「盘点 §0.4」)。第4讲即按此拆(01 由 14038 → 12976) - **题源标注规则(2026-10-25 起)**:题目改自张宇题的在题首标 `【张宇 4-xx 骨架】`,原创题在文件头「组织原则」里写明哪些题是原创、为什么不套骨架(如张宇第 4 章无几何/矩阵方程题);不许把原创题也写成"骨架取自张宇" - **前置概念缺口规则(2026-10-26 起)**:某个点的题若用到**后面点/讲才讲的概念**(例:线代第 5 讲点 1 的题要求"讨论可对角化",而几何重数在 §2.3、判据在 §3.2),必须**在本点补一节「够用版摘要」**(定义 + 判据 + 算法 + 常见坑,不展开推导),并交叉链接到正统章节;同时在正统章节留一句"本点已给够用版"。**成稿后要反向扫一遍:每道题需要的前置知识是否都在本点或更早**——这是用户反馈"知识点没讲、题却要用,导致不会做"的根因 - **机械扫法**:按 `## 题目` 把点文件切成「知识点段 / 题目段」,检查题目段出现的术语(谱分解、叉乘、惯性、伴随、施密特、二项式、正交补、行和…)是否在知识点段出现;脚本抓八成,剩两成靠通读。**改题目标签后要手数覆盖对照表的「点 N,X 题」**——`gen_crosslinks` 只重排 §0.4 与回查表,手写表不动 - 真题库:`试卷/Kaoyan-Math1-Papers/papers/近十年真题题库/kaoyan_math1.db`(2016–2025,225 题,表 `question`) - 参考仓库:`参考仓库/Math/`(`.tex`,已在 .gitignore 忽略,不入库) ## 用户偏好 - 数学内容**必须准确渲染公式**;Markdown 用 `$…$` / `$$…$$`。 - **写 `.md` 时,行内公式 `$…$` 的收尾 `$` 后面必须紧跟半角空格**,再写中文或全角标点(云端 Gitea 的硬性要求,见工具链)。例:`若 $X_n\to X$ ,则…` - **多行 `$$…$$` 块的开头与收尾 `$$` 必须独占一行**(Gitea 硬性要求)。 - 标题/正文里 `**加粗**` 的收尾 `**` 后若是汉字,补一个半角空格(避免 CommonMark flank 规则导致星号外露)。 - **绝对不要写 `$…$**`(加粗以公式收尾)**:Gitea 要求收尾 `$` 后是空白,补空格又会破坏 `**` 的 right-flanking,**两头都死**,只能改写句式——把公式挪出加粗,或在公式后补一个汉字再收 `**`(例:`**因式分解凑出 $XY=E$ 的形式**`)。同理避免 `$…$"`(半角引号)与 `$…$)`,改用空格或去掉引号。 - 题目要求**难度分层**(A 基础 / B 中等 / C 拔高),题量可比小练多。 - 出题**防过拟合**:数字/区域原创,只对齐考法;要标「真题骨架」锚点。 - 讲解要**从零拆解 + 指出易错点**,并配图(show_widget 用 SVG)。 - **不再生成 PDF**(2026-10-23 起)。讲义只出 Markdown,在网页端或 App 里看;`md2pdf.js` 工具链保留但不主动调用。 - **讲义结构:知识点盘点 + 以题带点分册**。每讲 = `README` + `01-知识点盘点` + 每个考点一个分册 + 速查卡。盘点只做「定义/定理/判据/公式」的高密度地图,不展开例题;题目全部嵌在点分册里,绝不退回「考点册 + 试题册 + 解析册」三件套。 - **单个 md 不超过 1.3 万字符(约 6000 汉字),超了就拆文件**。一个文件塞太多内容会逼着压缩,压缩就丢细节(第3讲 1.8 万字符塞 7 个点的教训)。 - **文件间用相对路径 Markdown 链接做双向链接**(`[点 2](03-点2-秩与极大无关组.md)`),不用 `[[ ]]`:Gitea 会渲染成可点路径,Obsidian 也能进反链面板。 - **双向链接做到「题级」**(用户 2026-10-23 要求):不止点末一张表,**每道题末尾都要有一行 `> **关联** · 盘点 … | 上游 … | 下游 … | 速查 …`**,四向都指向具体题目的锚点;盘点/速查里的反向索引(§0.4「章节 ↔ 题目」、速查「回查」)由同一份映射**反向生成**,保证对称不漏。 - **Gitea 锚点规则(两条方向相反,极易踩)**:标题 id $=$ `user-content-` $+$ 小写化(保留字母数字汉字与下划线,空格→`-`,**其余标点全删**,`·` 两侧空格 → 两个 `-`) - **同文件**写 `#问题-2--变换后的向量组` —— Gitea 渲染时**自动**补 `user-content-` - **跨文件**写 `03-xxx.md#user-content-问题-1--…` —— Gitea **不补**,必须手写前缀 - **标题里禁止出现 `$...$`**(2026-10-24 定):公式会让锚点漂移、Gitea 渲染文本与源码不一致,锚点算不出来。标题一律写纯文字(`### 题 4 · 4.1:乘积矩阵的正定性`) - 校验:`python .workbuddy/tools/md2pdf/check_md_links.py <目录>`(查目标文件与锚点是否存在) - **`gen_crosslinks.py`**(2026-10-24 建):单一数据源 = 题目标题 `### 题 N · X.Y:短标题(★★☆)`,幂等生成 ①每题关联行 ②盘点 `` 之间的 §0.4 表 ③速查卡 `` 之间的回查表。`--check` 只统计。**速查卡里同一个 `` 只能挂在一个小节**(后写覆盖前写) ## 工具链(本项目自建,可复用) - **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 路线 - **Gitea 网页端公式渲染的硬规则**(云端 `app.zhantiandoudi.cn` 走 Gitea 自己的 Goldmark 扩展,**与本地 md2pdf 的 KaTeX 链路不同**,本地正常不代表网页正常) - 行内 `$...$`:收尾 `$` 的后一个字符必须是**半角空白**(空格/换行);紧贴中文或全角标点 → 整对 `$` 不渲染。开头 `$` 的左邻若是 ASCII 字母/数字或 `. ! ? , ; :` 也不渲染 - 多行 `$$...$$`:同一行上 `$$` 后面若还有内容,整个块被拒绝(Gitea `block_parser.Open()` 的 `idx=-1` 分支缺陷) - `**加粗**`:收尾 `**` 前是标点、后紧贴汉字 → 不生效(CommonMark right-flanking),星号外露 - **front matter(`---` 包住的信息块)不过 markdown**(2026-10-26 发现):Gitea 把 `key: value` 渲染成表格,里面的 `$+$`、反引号会**原样露出**。信息块里只写纯文字(`+` 就写 `+`)。此问题本地 md 预览与 PDF 都看不出来,**只有抓网页才暴露** - 一键检测/修复:`python .workbuddy/tools/md2pdf/fix_gitea_math.py --check|--apply [--scope=目录]`(已含 front matter 规则) - 网页核验(抓页面数残留 `$`):`python .workbuddy/tools/md2pdf/verify_gitea_math.py [仓库相对路径…]`,**交付前对新写文件跑一遍**,本地 0 处不代表网页 0 处 - 批量重生成概率论 PDF:`bash .workbuddy/tools/md2pdf/rebuild_prob_pdfs.sh` - 上述三类修复 KaTeX 输出不变(会 trim),故 PDF 可不必重生成 ## 云仓库 - `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=-`)→ 删除项人工确认