Files
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

51 lines
3.8 KiB
Markdown
Raw Permalink 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.
---
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 项是旧快照)。
**2026-11-04 用户明确:这次允许,下不为例。** 因此本文件不拆——拆会打断「15 个考点文件」的编号体系。脚本里用 `SIZE_EXEMPT` 记了这条豁免,输出走 `EXEMPT:` 而不是 `WARN:`,同时记下豁免时的字数:**以后再涨一样会报 WARN**。
约定收紧的部分:**新增文件一律不得超 1.3 万字符**。真要再加内容,就按第 4 讲的做法把覆盖对照与相邻讲接口拆成 `01b`,`§0.x` 编号保持不动。