新增背诵版重构交接文档(供接手 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 顶部加「重构进行中」入口
This commit is contained in:
2026-11-23 00:04:31 +08:00
parent 8836cdc347
commit 41e3eec439
2 changed files with 351 additions and 0 deletions
@@ -0,0 +1,349 @@
---
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 是分值重心。
@@ -11,6 +11,8 @@ tags: [数学一, 知识点构建, 背诵版, README, MOC]
> 本专栏只做一件事:**把「在学练习」做成背诵版**——**考点完整呈现**,**题目只列出、不解**。考点与题目均对齐「参考仓库」。
>
> **编号规则(2026-10-27 整理)**:01–09 高等数学(按章序)、10–15 线性代数(按讲序)、16–20 概率论(按讲序),组内与参考仓库章/讲一一对应。
>
> **重构进行中**:本专栏正从「考点清单 + 纯题干」升级为「教材 + 扩展 + 习题」三段式,已完成 4 篇(01、10、11、12),剩余 16 篇的完整规格、参考源定位、踩坑清单与交付流程见同目录的 `00-背诵版重构-交接文档.md`。接手重构请先读它。
## 一、为什么要有这个专栏