Files
MathNotesVersion2/.workbuddy/memory/MEMORY.md
T
Yimu 39408c3e7f docs: 记录超字数的存量豁免与「下不为例」约定
- MEMORY.md 排版约定下补:01-知识点盘点.md(17335) 与 09-点8-曲线积分.md(17689)
  获一次性豁免、不拆,但再涨即违规;新文件一律不得超 1.3 万
- vector-audit 校验器加 SIZE_EXEMPT:豁免文件走 EXEMPT 而非 WARN,
  同时记下豁免时字数,超过该值仍旧报 WARN
- README 的「一条待处理」改写为「一条已豁免」,写明理由与收紧规则
2026-11-04 09:20:46 +08:00

80 lines
13 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 项目长期约定 · 第二代数学笔记
## 分层与目录
- 工作区根:`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 忽略,不入库)
- **模拟卷**:`基于考研的学习/数学一/模拟卷/<第N次模拟-数学一>/`,结构与在学练习不同(用户 2026-10-27 定):
- **试卷与知识点分文件**,四个部分:`01-模拟卷`(只有题目)、`02a/02b-答案与解析`(客观题 / 解答题分册,各含"怎么想—解—归因")、`03~05-考点手册`(按科目分册,条目编号 `H01/L01/P01`)、`06-考点预测与分布`(十年统计 + 逐题来源 + 命题规律 + 本卷空缺)
- **每题末尾一行** `> **考点** · [H01 名称](03-考点手册-高等数学.md#user-content-h01-…)`,跨文件锚点必须手写 `user-content-` 前缀;手册条目标题用 `## H01 名称`,编号要算进锚点
- **预测按"题位"不按"知识点重要性"**:卷面 **2021 起**锁死(10 选 5 分 / 6 填 5 分 / 17 题 10 分 / 18—22 各 12 分,高数 86 + 线代 32 + 概率 32),所以预测对象是"哪个位置该换什么"。**注意是 2021 不是 2022**——2021 年已是 10 选 6 填 6 解,卷一/卷二 06 都写错过
- **多卷之间要写"互补表"**:同一个题位各卷走的是哪条路、哪章被谁覆盖,否则读单卷会误以为"这题位只能这么出"。卷三补卷二空掉的二次型与参数估计,三卷合起来 22 章走遍
- **张宇 1000 题库的实际范围**:高数 15 章 + 线代 6 章(`参考仓库/张宇1000题-notes/`),不是"只有第 1 章"。别把"张宇骨架"一栏全填"无"
- **必须写"本卷空缺"**:列出未覆盖的章 + 十年分值 + 补法,比假装全覆盖有用
- **出完要查答案分布**:单选连续 3 个以上同字母、或某字母 0 次,都要重排选项
- 含参题**设条件前先解一遍**,出现两组解就补条件(本次第 21 题加 `b<0`)
- 张宇 1000 题**没有级数、没有曲线曲面积分、没有概率**,这三块只能以真题为参照,题首不标"张宇骨架"
## 用户偏好
- 数学内容**必须准确渲染公式**;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 个点的教训)。
- **唯一的存量豁免(2026-11-04 用户批准,原话「这次允许超过字数限制,下不为例」)**:`线性代数-第3讲-向量/01-知识点盘点.md`(17335)与 `大题十年考点/09-点8-曲线积分.md`(17689)。两个都**不拆**——拆会打断「15 个考点文件」的编号体系。豁免仅限这两处现状:**再往这两个文件里加内容导致字数上涨,一样算违规**;`vector-audit/check_vector_learning.py` 的 `SIZE_EXEMPT` 记了豁免字数,涨了即报 WARN
- **例外到此为止**:新写的文件一律不得超 1.3 万,交付前先数;超了就当场拆(`01b` / `03a-03b` 两种拆法都已在用)
- **文件间用相对路径 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:短标题(★★☆)`,幂等生成 ①每题关联行 ②盘点 `<!-- AUTO:KP -->` 之间的 §0.4 表 ③速查卡 `<!-- AUTO:回查 -->` 之间的回查表。`--check` 只统计。**速查卡里同一个 `<!-- KP: x.y -->` 只能挂在一个小节**(后写覆盖前写)
## 工具链(本项目自建,可复用)
- **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 都看不出来,**只有抓网页才暴露**
- **空位横线绝不能写进 `$$…$$` 内部**(2026-10-31 用户报错):`______` 在数学模式里等于连续空下标,KaTeX 抛 `Expected group after '_'`,**整块**渲染失败。写法固定为「公式块只放表达式本体,`的值为 ______ 。` 回到正文」。检测器:`fix_gitea_math.py` 的 `scan_math_underscore()`(只提示不自动改,改法取决于题意)
- 一键检测/修复:`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=-`)→ 删除项人工确认