Files
MathNotesVersion2/.workbuddy/tools/vector-audit/README.md
T
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

3.8 KiB
Raw Blame History

tags, 日期
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 条警告) 生成物

怎么跑

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 编号保持不动。