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

20 KiB
Raw Blame History

title, date, status
title date status
背诵版 v2 重构 · 交接文档 2026-11-23 进行中(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 每个知识点的三段

### 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 校验(交付前必跑)

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. 真题库用法

# 路径
试卷/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= 传单文件静默失效

会去扫全库并报无关文件。单文件处理必须直接调函数:

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. 交付流程(照着跑,一步都别省)

# 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 是分值重心。