Files
MathNotesVersion2/基于考研的学习/数学一/知识点构建/00-背诵版重构-交接文档.md
T
Yimu 41e3eec439 新增背诵版重构交接文档(供接手 agent 使用)
- 00-背诵版重构-交接文档.md:11740 字符,12 节
- 任务清单:剩余 16 篇逐篇给出母本 tex 路径与行数、配套 exercise、真题章节与题数分值
- 三段式逐字规格 + 角标判定规则 + 双通过路径(A 占比≥20% / B 张宇条数≥知识点数)
- 跨讲取源先例(线代内积取第5讲、公共解取第4讲)
- 真题库三个坑:chapter_id 是纯数字、answer 大面积为空须自算、ch2 横跨 02/03、ch4 归 07
- 血泪清单 7 类:试错痕迹(5次)、换数字不改答案(2次)、公式被判链接、
  --scope 静默失效、Write/Bash 的 /tmp 分裂、旧版事实错误(4处已发现)
- 交付流程 10 步命令序列 + 验收红线 12 条 + 建议顺序
- README 顶部加「重构进行中」入口
2026-11-23 00:04:31 +08:00

350 lines
20 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.
---
title: 背诵版 v2 重构 · 交接文档
date: 2026-11-23
status: 进行中(4/20 完成)
---
# 背诵版 v2 重构 · 交接文档
给接手的 agent 看。**动手前请把本文档读完,尤其第 8、9、10 节——那些是已经踩过的坑,重复踩会被用户直接发现。**
---
## 1. 任务是什么
用户原话(2026-11-22):
> 现在背诵版可能需要全面重构了,我所有内容都学完了,课认为没有知识点不会的情况,但是很多题型忘记如何解答了,有时候第一时间无法检索到对应的知识点,但是我一旦重新看两眼,立刻就会了,但是遗忘的有点多。
> 效果不咋地,还是按我的思路来,重构背诵版,要求:§1 映射与函数 每一小结知识点后跟上对应习题,也就是说习题粒度要对齐到知识点。然后每一节知识点做补充,知识点应该包含教材知识点和扩展知识点,教材知识点是教材的原版复述,扩展知识点包含除此之外的全部,比如二级结论,考点,题型,先重构01。这个可能会导致文件比较重,这是允许的。
一句话:**把「考点清单 + 纯题干」的旧结构,改成「读一段 → 立刻做一题 → 确认会了」的三段式。** 用户的病灶是"看一眼就会,但检索不到",所以顺序是**读→做→确认**,不是"查"。曾试过做「题型卡」被明确否决,不要自创替代形态。
---
## 2. 已完成的 4 篇(不要重做,只当样板参照)
| 文件 | 字符 | 知识点 | 题数 | 扩展条目 | 〔张宇〕 | 〔补〕 | 通过路径 |
|---|---|---|---|---|---|---|---|
| `01-背诵版-高等数学-函数与极限.md` | 33339 | 27 | 49 | 76 | 40 | 36 | A(52.6%) |
| `10-背诵版-线性代数-第1讲-行列式.md` | 18549 | 12 | 26 | 49 | 23 | 26 | A(46.9%) |
| `11-背诵版-线性代数-第2讲-矩阵.md` | 43903 | 22 | 57 | 73 | 24 | 49 | A(32.9%) |
| `12-背诵版-线性代数-第3讲-向量.md` | 44457 | 14 | 48 | 90 | 16 | 74 | B(16≥14) |
**格式样板首选 `12`**(最近完成、题材与线代后三讲最近);**题量与密度的基准看 `11`**。
---
## 3. 待重构的 16 篇
### 3.1 线代 3 篇(建议先做,同一个母本体系,手感连贯)
| 序号 | 文件 | 旧版字符 | 母本 knowledge | 行数 | 配套 exercise | 真题章 | 题数/总分 |
|---|---|---|---|---|---|---|---|
| 13 | `13-背诵版-线性代数-第4讲-线性方程组.md` | 16724 | `linear-algebra/knowledge/4-linear-equations-system` | 604 | `exercise/4-linear-equations-system`(175 行) | ch12 | 7 / 39 |
| 14 | `14-背诵版-线性代数-第5讲-特征值与特征向量.md` | 14256 | `linear-algebra/knowledge/5-similar` | 367 | `exercise/5-similar`(481 行) | ch13 | 11 / 83 |
| 15 | `15-背诵版-线性代数-第6讲-二次型.md` | 13071 | `linear-algebra/knowledge/6-quadratic-form` | 317 | `exercise/6-quadratic-form`(398 行) | ch14 | 10 / 80 |
### 3.2 高数 8 篇(用户说"高数记得比较好",优先级低于线代)
| 序号 | 文件 | 旧版字符 | 母本 knowledge | 行数 | 配套 exercise | 真题章 | 题数/总分 |
|---|---|---|---|---|---|---|---|
| 02 | `02-背诵版-高等数学-导数与微分.md` | 9734 | `advanced-math/knowledge/2-derivatives-and-differential` | 616 | `exercise/3-differentiation-of-functions-of-single-variable` | ch2 | 24 / 160 |
| 03 | `03-背诵版-高等数学-导数的应用.md` | 12198 | `advanced-math/knowledge/3-applications-of-derivatives` | 644 | 同上(`exercise/3`) | ch2 | 同上 |
| 04 | `04-背诵版-高等数学-一元积分.md` | 20550 | `advanced-math/knowledge/4-indefinite-integral-and-definite-integral` | 845 | `exercise/4-integal-of-functions-of-single-variable`(**目录名拼错,照原样引用**,1478 行) | ch3 | 16 / 100 |
| 05 | `05-背诵版-高等数学-向量代数与空间解析几何.md` | 6352 | `advanced-math/knowledge/5-vector-algebra-and-space-analytic-geometry` | 347 | `exercise/5-vector-algebra-and-space-analytic-geometry`(**仅 80 行**) | 无专属 | — |
| 06 | `06-背诵版-高等数学-多元函数微分学.md` | 10593 | `advanced-math/knowledge/6-differential-calculus-of-multivariate-functions` | 368 | `exercise/6-differential-calculus-of-multivariate-functions` | ch5 | 20 / 137 |
| 07 | `07-背诵版-高等数学-多元函数积分学.md` | 17477 | `advanced-math/knowledge/7-integral-calculus-of-multivariate-functions` | 823 | `exercise/7-integral-calculus-of-multivariate-functions` | ch6 + ch4 | 25 / 206 |
| 08 | `08-背诵版-高等数学-无穷级数.md` | 13400 | `advanced-math/knowledge/8-infinite-series` | 578 | `exercise/8-infinite-series`(232 行) | ch7 | 15 / 87 |
| 09 | `09-背诵版-高等数学-微分方程.md` | 9584 | `advanced-math/knowledge/9-differential-equation` | 373 | `exercise/9-differential-equation` | ch8 | 12 / 81 |
**注意两点**:
- `ch2` 的 24 题同时覆盖导数微分(02)与导数应用(03),重构时要**按 `knowledge_point` 字段分派**,别两篇都收同一批题。
- `ch4` 只有 1 题(2021·第二类曲面积分),归 **07 多元积分**,不是独立章。**05 向量代数在十年真题里没有专属命题**,它只作为切平面、曲面积分的工具出现——所以 05 的习题主要靠 `exercise/5`(只有 80 行)和张宇例题,别硬凑真题。
### 3.3 概率论 5 篇
| 序号 | 文件 | 旧版字符 | 母本 knowledge | 行数 | 配套 exercise | 真题章 | 题数/总分 |
|---|---|---|---|---|---|---|---|
| 16 | `16-背诵版-概率论-第1-2讲-随机事件与一维随机变量.md` | 16710 | `probability-theory-and-mathematical-statistics/knowledge/1-random-events-and-probability`(299 行)+ `knowledge/2-random-variables-and-distribution`(**一维部分**) | 299 + 772 | `exercise/1`(114 行)、`exercise/2`(507 行) | ch15 + ch16 | 14 / 63 |
| 17 | `17-背诵版-概率论-第3讲-多维随机变量及其分布.md` | 17962 | `knowledge/2-random-variables-and-distribution` 的**多维部分**(与 16 共用同一份 tex) | 772 中后段 | `exercise/2` | ch17 | 11 / 105 |
| 18 | `18-背诵版-概率论-第4讲-数字特征.md` | 13557 | `knowledge/3-digital-features` | 267 | `exercise/3`(189 行) | ch18 | 7 / 32 |
| 19 | `19-背诵版-概率论-第5讲-大数定律与中心极限定理.md` | 12464 | `knowledge/4-law-of-large-numbers-and-central-limit-theorem` | 179 | `exercise/4`(**仅 41 行**) | ch19 | 3 / 14 |
| 20 | `20-背诵版-概率论-第6讲-数理统计.md` | 23510 | `knowledge/5-mathematical-statistics` | 512 | `exercise/5`(299 行) | ch20 + ch21 + ch22 | 15 / 116 |
**概率三处特殊**:
- **16 与 17 共用一份 tex**(`knowledge/2` 772 行含一维与多维)。切分点:一维→16,二维及条件分布/独立性/函数分布→17。两篇都要在节首写清「本文取该 tex 的哪一段」。
- 19 的 exercise 只有 41 行,**必须靠 `kaoyan_math1.db` 的 ch19(3 题)+ 自出题补足**,参考占比走 B 路径。
- 20 要吃掉 ch20(抽样分布 χ²/F)、ch21(参数估计)、ch22(假设检验)三章 15 题 116 分,是全概率最重一篇。
---
## 4. 三段式规格(逐字对齐,不许自由发挥)
### 4.1 文件骨架
```
--- frontmatter:科目 / 讲次 / 来源 / date ---
# 标题
> **来源**:母本 tex 路径 | exercise | 真题库 chN
> **结构**:每个知识点三段——教材(原版复述)+ 扩展(二级结论/考点/题型/陷阱)+ 习题(紧贴本知识点,给答案与关键一步)
> **用法**:顺读一遍建立骨架,之后只看习题——做不出再回上看教材段
> **题号**:全书连续编号,共 N 题。标「真题」的是……,标「张宇例」的是……,无标的是自出
## 0. 本讲骨架
(一句话概括 / 真题地位 / 依赖链 / 做题主干 / 考点树表)
## 1. 节标题
### 1.1 知识点名
**教材**
**扩展**
**习题 1.1**
### 1.2 …
## 2. …
## 附录:真题目录 / 回查入口
```
### 4.2 每个知识点的三段
```markdown
### 2.1 七条判定定理
**教材**
- **定理一(谁多余)**:……原文复述,拆成松散列表,长条拆句。
**扩展**
- **七条的记忆骨架**:……〔补〕。
- **定理二的"唯一"从哪来**:……〔张宇〕。
**习题 2.1**
> **题 5**(★★☆)题干……标「真题 2021·6」或「张宇例」或不标。
**答案**:结果 + 关键一步(两三行)。**关键一步是……**。
```
### 4.3 硬性约束
1. **`###` 只能用于知识点标题**。校验器按 `###` 个数算"知识点个数",附录/真题目录用 `##`,否则角标 B 路径会被稀释。
2. **题号全书连续**(题 1 到题 N),不按节重置。题后跟 `(★★☆)` 难度,`> **题 N**` 用引用块。
3. **答案写在题后同段**(`**答案**:…`),不另设解析章。答案粒度=**结果 + 关键一步**,不写完整过程(用户默认此粒度;若用户提出要完整过程,01 会涨到 4.5 万字符,届时先问清再动)。
4. **教材段不许写"教材原文"四个字**。母本是张宇三十讲 LaTeX 整理稿,frontmatter 与回查入口一律写「张宇三十讲整理稿」,例题标「张宇例」不标「教材例」。
5. **单文件可超 1.3 万字符**(用户明确允许)。已完成的 11、12 都是 4.4 万。
---
## 5. 来源角标规则(**最容易出事故的一节**)
### 5.1 判定
| 角标 | 含义 |
|---|---|
| `〔张宇〕` | 该条**主体**能在母本 tex 原文找到对应表述或例题 |
| `〔补〕` | tex 里没有,是我补的:通用知识、真题归纳、反例、陷阱、操作流程、取舍判断 |
**混血条目一律标〔补〕**——只要掺了加工内容就算补。宁可多标补,不可冒称张宇。〔补〕的语义是「这句要你自己判断对错」。
**绝对禁止**:扩展段出现无角标条目;出现「张宇强调」「书上说」这类无出处转述。
### 5.2 校验(交付前必跑)
```bash
python .workbuddy/tools/check_source_tags.py # 全目录
python .workbuddy/tools/check_source_tags.py --file 13-xxx.md # 单篇
```
通过条件两条取其一:
- **A**:〔张宇〕占比 ≥ 20%(厚 tex 篇走这条)
- **B**:〔张宇〕条数 ≥ 知识点个数(薄 tex 篇走这条,比比例更严——逼每个点都回原文)
**若 A、B 都不满足,说明你没真读 tex 就动笔了,不许调低阈值,回去重读。**
### 5.3 跨讲取源(线代特有,重要)
线代 6 讲不是每讲自给自足,缺的内容去别的讲取,**并在节首写「来源提示」说明 tex 边界**:
- 内积、施密特正交化、正交矩阵 → `5-similar/similar.tex` 正交段(第 3 讲已用)
- 公共解、同解 → `4-linear-equations-system.tex`(第 3 讲已用)
- `3-vector/vector.tex` 本身只有 149 行,撑不起线性空间那套
**tex 真没有的内容(长度、夹角、规范正交基、子空间和与交、维数公式、直和)必须全标〔补〕**,不许因为"这是线代常识"就记到张宇账上。第 2 讲曾把三角分块求逆、零因子解释、`r(A^T)=r(A)` 三条误标〔张宇〕,回查 matrix.tex 根本没有,已改〔补〕。
---
## 6. 真题库用法
```python
# 路径
试卷/Kaoyan-Math1-Papers/papers/近十年真题题库/kaoyan_math1.db
# 表 question,字段:question_id, exam_year, question_no, question_type,
# score, subject, chapter_id, knowledge_block, knowledge_point, stem, answer, note, source_file
```
三个必须知道的坑:
1. **`chapter_id` 存的是纯数字 `'13'`,不是 `'ch13'`**。写 `where chapter_id='9'` 查不到,要用 `cast(chapter_id as int)` 或直接写数字。
2. **`answer` 字段大面积为空**,尤其线代与概率。**答案必须自己算,并用 sympy 复核,不许凭印象写。** 第 3 讲 8 道真题答案全是自算的。
3. **`ch2` 的题横跨导数微分与导数应用**,`ch4` 只有 1 题且属多元积分——别按章号想当然映射到讲次。
章节映射(已核对):
```
ch1 函数极限→01 ch2 导数+中值+应用→02/03 ch3 一元积分→04
ch5 多元微分→06 ch6 多元积分→07(+ch4) ch7 级数→08 ch8 微分方程→09
ch9 行列式→10 ch10 矩阵→11 ch11 向量→12
ch12 方程组→13 ch13 特征值→14 ch14 二次型→15
ch15+ch16→16 ch17→17 ch18→18
ch19→19 ch20+ch21+ch22→20
```
**05 向量代数无专属真题。**
---
## 7. 排版硬规则(Gitea 云端 Goldmark,和本地 KaTeX 不一样)
1. 行内 `$…$` 收尾 `$` 后**必须紧跟半角空格**;紧贴中文或全角标点 → 整对不渲染,源码全摊在正文(这就是用户报的"排版全缩在一起")。
2. `$$` 块级公式开头与收尾必须**独占一行**。**空位横线 `______` 绝不能进数学模式**(KaTeX 抛 `Expected group after '_'`)。
3. 加粗 `**…**` 前是标点、后紧贴汉字 → 不生效。两种死法都不能写:一是加粗以公式收尾(收尾 `**` 紧贴公式的 `$`),二是往加粗内侧塞空格(星号会外露)。唯一解法是**改句式**——把公式挪到 `**` 外面,或让加粗以汉字收尾。
4. **标题里禁止出现 `$`**(锚点会漂)。
5. front matter 不过 markdown,里面只写纯文字。
6. **表格里的数学式禁止裸 `|`**,一律 `\vert`。
7. 链接用相对路径 Markdown,不用 `[[ ]]`。
---
## 8. 已踩过的坑(血泪清单,逐条都是实际返工)
### 8.1 答案里的「试错痕迹」——已犯 5 次
答案段落里出现「?不,正解」「再乘提出的 2?」「(A)其实成立……故(A)错」「注意这里取错了」这类推导残留。
**根因**:把草稿当答案写。**铁律:先算完再落笔,答案必须一次成文。** 已在中值定理(4 处)、第 1 讲行列式(3 处)、第 2 讲矩阵(4 处)三次成批返工。
### 8.2 「换数字不改答案」——已犯 2 次
- 旧版第 1 讲题 18 题干被换成另一个矩阵,答案仍照抄原题的 24,真值是 **−2**。
- 旧版 01 题 36 答案写 −2,解析本身是 −1。
**铁律:改题干就必须重算答案;所有数值答案最后统一跑一遍 sympy。**
### 8.3 公式里的 `[...](...)` 被当成 Markdown 链接
`[x+(n-1)a]` 后面紧跟 `(x-a)^{n-1}` 这种写法(方括号接圆括号),会让 `check_md_links` 报「文件 x-a 不存在」。改圆括号,或在两者之间插 `\,` 断开。
### 8.4 `fix_gitea_math --scope=` 传单文件静默失效
会去扫全库并报无关文件。**单文件处理必须直接调函数**:
```python
import sys; sys.path.insert(0, r'D:/考研/第二代数学笔记/.workbuddy/tools/md2pdf')
import fix_gitea_math as F
n2, ins = F.fix_text(txt) # 返回 (新文本, 插入处数)
fm, fi = F.fix_frontmatter(n2) # 返回 (新文本, 修改处数)
```
`--apply` 会重写整个 scope,先 `git add`。
### 8.5 Write 的 `/tmp` 与 Bash 的 `/tmp` 不是同一目录
Write 写 `/tmp/x.md` 落到 `D:/tmp`;Bash 的 `/tmp` 落到 `%LOCALAPPDATA%/Temp`。**分片写作后合并必须用 `D:/tmp/x.md` 全路径 cat**,否则报"文件不存在"。
### 8.6 分片写作是必须的
4 万字符级的篇目一次写完会掉质量。**按 §0—§3 / §4—§6 分 2—3 片写到 `D:/tmp/xxx_p1.md`,再 cat 合并**,然后统一跑校验。
### 8.7 旧版存在事实错误,不要照抄
- 01 曾把 `e^{1/x}` 在 0 处判为「跳跃」——一侧趋于 +∞ 不算极限存在,正确是**第二类无穷间断点**。
- `vector.tex` 第 55 行 `k\alpha=[ka_1,ka_2,\cdots,ka_3]`,末项应为 `ka_n`(tex 自身笔误)。
- 方程组 tex 第 147 行坐标变换推导方向写反(结论 `x=Cy` 对,中间步骤错)。
- `exercise/3` 等价例题 $a=0$ 时写「r(A)=2」,实算 |A|=1,r(A)=3。
**凡"最容易错"类断言,落笔前必须自己先验一遍。** 发现 tex 错误要在文中标〔补〕并写明,不许默默改掉。
---
## 9. 交付流程(照着跑,一步都别省)
```bash
# 0. 写之前:整篇读完母本 tex,不许按目录猜内容
# 1. 分片写到 D:/tmp/xxx_p1..p3.md,cat 合并到目标文件
cat "D:/tmp/xxx_p1.md" "D:/tmp/xxx_p2.md" "D:/tmp/xxx_p3.md" > "13-背诵版-....md"
# 2. 结构统计:字符 / 知识点 / 题数 / 三段齐全
grep -c '^### ' 文件; grep -cE '^> \*\*题 [0-9]+\*\*' 文件
grep -c '^\*\*教材\*\*' 文件; grep -c '^\*\*扩展\*\*' 文件; grep -c '^\*\*习题' 文件
# 三者必须相等,等于知识点数
# 3. 修公式空格(单文件,调函数,别用 --scope)
python D:/tmp/chkNN.py # 见 8.4 的写法;跑两遍确认幂等归零
# 4. 查加粗违规(内侧空格 / 以公式收尾),命中就改句式
# 5. 角标校验
python .workbuddy/tools/check_source_tags.py --file "基于考研的学习/数学一/知识点构建/13-xxx.md"
# 6. 链接与锚点
python .workbuddy/tools/md2pdf/check_md_links.py "基于考研的学习/数学一/知识点构建"
# 7. 更新 README 进度表对应行:题量、状态(✅ 已出,注明知识点数与题数)
# 8. 提交 + 推送(代理端口每轮都变,用环境变量)
git add "基于考研的学习/数学一/知识点构建/13-xxx.md" "基于考研的学习/数学一/知识点构建/README.md"
git commit -F - <<'EOF'
线代第4讲线性方程组重构为三段式(v2)
...
EOF
git -c http.proxy="$https_proxy" -c https.proxy="$https_proxy" push origin main
# 9. 抓真实网页核验渲染(最关键的一步,链接全绿≠网页能渲染)
python .workbuddy/tools/md2pdf/verify_gitea_math.py "基于考研的学习/数学一/知识点构建/13-xxx.md"
# 通过标准:行内公式数百处,残留的美元符号计数为 0
# 10. 写日志到 .workbuddy/memory/YYYY-MM-DD.md,更新 MEMORY.md 的进度行
```
`git -c http.proxy=...` 的 `-c` **必须放在子命令前**。
---
## 10. 验收红线(自检清单)
一篇做完,以下全绿才算完成:
- [ ] `###` 数 = 教材段数 = 扩展段数 = 习题段数,且都等于知识点数
- [ ] 题号从 1 连续到 N,无跳号无重号
- [ ] 每道数值题答案都用 sympy 验过(尤其真题、含参题、递推题)
- [ ] 答案里没有任何试错痕迹("?不""其实""注意这里错了")
- [ ] 扩展段每条都有〔张宇〕或〔补〕
- [ ] `check_source_tags` 通过 A 或 B
- [ ] `fix_text` 幂等归零(连跑两次都是 0)
- [ ] 标题含 `$` = 0;加粗以公式收尾 = 0;加粗内侧空格 = 0
- [ ] `check_md_links` 0 异常
- [ ] `verify_gitea_math` 残留 `$` = 0
- [ ] README 进度表该行已更新
- [ ] 日志已追加,MEMORY 进度已更新
---
## 11. 给用户汇报时的注意
- **如实说明来源**。用户专门问过"教材和扩展是你自己想的还是参考了参考仓库"——他会追问,且会抽查。别把「我的判断」说成「书上的」。
- **发现旧版错误要单独列出来讲**,用户很在意这个(已发现 4 处)。
- **不要报喜不报忧**。占比低就是低,走 B 路径就说明走的是 B,别粉饰。
- 汇报里给出「下一步建议 + 一句可选的确认问题」,不要长篇铺垫。
---
## 12. 建议顺序
1. **13 方程组**(604 行 tex,16724 字符,ch12 仅 7 题但都是硬题)——承接第 3 讲手感的自然续篇
2. **14 特征值**(367 行,ch13 有 11 题 83 分,含实对称正交对角化)
3. **15 二次型**(317 行,ch14 有 10 题 80 分,与 14 强耦合——建议 14、15 连着做)
4. 然后高数:**04 一元积分**(20550 字符最重、exercise 1478 行素材最足)→ 07 多元积分 → 08 级数 → 06 → 02/03 → 09 → 05
5. 最后概率:**17 多维**(105 分最重)→ 20 统计(116 分但跨三章)→ 16 → 18 → 19
理由:线代体系连贯、tex 稠密、真题分值集中;高数用户自认记得牢,可后置;概率 17、20 是分值重心。