47 lines
3.5 KiB
Markdown
47 lines
3.5 KiB
Markdown
---
|
|||
|
|
tags: [工具, 线性代数, 第3讲, 向量, 校验]
|
||
|
|
日期: 2026-10-23 建, 2026-11-04 归档入 tools
|
||
|
|
---
|
||
|
|
|
||
|
|
# vector-audit · 第 3 讲「向量」的生产与校验脚本
|
||
|
|
|
||
|
|
这三个脚本是 2026-10-23 重写 `在学练习/线性代数-第3讲-向量/` 时留下的产物。**不是一次性废码**:`check_vector_learning.py` 的 180 项精确校验,是那一讲所有数值题、参数分支、链接与结构的回归网。以后改这一讲的任何一题,跑一遍就知道有没有改坏。
|
||
|
|
|
||
|
|
## 文件
|
||
|
|
|
||
|
|
| 文件 | 行数 | 做什么 | 安全 |
|
||
|
|
|---|---|---|---|
|
||
|
|
| `check_vector_learning.py` | 189 | **主校验器**。用 `fractions.Fraction` 精确验算全部数值例子与参数分支,同时检查 Markdown 结构与内部链接。结果写入同目录 `vector_learning_checks.json` | 只读笔记,只写 json |
|
||
|
|
| `check_vector_exam_sample.py` | 59 | 抽样校验点 1「线性相关与无关」考研试写篇的 12 组行列式与相关系数 | 只读 |
|
||
|
|
| `inspect_vector_exam_sample.py` | 10 | 打印真题库 `chapter_id=11`(向量)的全部题目,出题时对照用 | 只读 |
|
||
|
|
| `rewrite_vector_learning.py` | 1257 | 第 3 讲整章重写的**生成脚本**,`FILES` 字典里存了全部正文 | ⚠️ **会覆盖正式笔记** |
|
||
|
|
| `vector_learning_checks.json` | — | 最近一次校验结果(当前 298 项通过 + 1 条警告) | 生成物 |
|
||
|
|
|
||
|
|
## 怎么跑
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd "D:/考研/第二代数学笔记"
|
||
|
|
"$P" .workbuddy/tools/vector-audit/check_vector_learning.py # 应输出 PASS: 298 ...
|
||
|
|
"$P" .workbuddy/tools/vector-audit/inspect_vector_exam_sample.py # 打印 ch11 真题
|
||
|
|
```
|
||
|
|
|
||
|
|
`$P` 指 `C:/Users/Wang Ling/.workbuddy/binaries/python/envs/default/Scripts/python.exe`。三个脚本都用 `parents[3]` 定位项目根,从哪个目录调用都行。
|
||
|
|
|
||
|
|
## 两个注意点
|
||
|
|
|
||
|
|
1. **`rewrite_vector_learning.py` 是破坏性的**。它把 `FILES` 里的字符串直接 `write_text` 覆盖到讲次目录,跑一次就把线上那 15 个 md 全部替换成脚本内的版本。只在该讲需要**整章重生成**时用,且跑之前先 `git status` 确认工作区干净、跑完必 diff。
|
||
|
|
2. **`check_vector_learning.py` 的校验范围是「可以精确算的部分」**:数值例子、参数分支、链接、Markdown 结构。抽象证明的推导逻辑靠人读,脚本管不到——json 里的 `scope` 字段已写明这一点。
|
||
|
|
|
||
|
|
## 归档时改了什么
|
||
|
|
|
||
|
|
2026-11-04 从 `.workbuddy/` 根目录移入本目录,做了四处调整:
|
||
|
|
|
||
|
|
- 三个脚本的 `ROOT` 由 `parents[1]` 改为 `parents[3]`(深了两层目录)
|
||
|
|
- `check_vector_learning.py` 的 json 输出路径由项目根改为脚本同目录
|
||
|
|
- `inspect_vector_exam_sample.py` 原先用 cwd 相对的 `Path('试卷/...')`,改为 `ROOT` 拼接
|
||
|
|
- **字符数检查由断言降为警告**。原来 `assert len(text) <= 13000` 一旦超限就中断整个脚本,后面两百多项全不执行;改为记入 `warns`、末尾统一打印。改完跑出 **298 项通过**,其中唯一警告是 `01-知识点盘点.md` 已达 **17335 字符**(超 1.3 万上限)。
|
||
|
|
|
||
|
|
## 一条待处理
|
||
|
|
|
||
|
|
`01-知识点盘点.md` 17335 字符,超过项目「单文件 ≤ 1.3 万字符」的约定。这是 2026-10-23 21:55 重写时涨上去的(校验脚本 19:47 写好后没再跑,所以 json 里的 180 项是旧快照)。**要不要拆**取决于是否愿意打断「15 个点文件」的编号体系——参照《大题十年考点》的做法,可以把覆盖对照与相邻讲接口拆成 `01b`。目前只记录,未动。
|