docs: 记录超字数的存量豁免与「下不为例」约定

- MEMORY.md 排版约定下补:01-知识点盘点.md(17335) 与 09-点8-曲线积分.md(17689)
  获一次性豁免、不拆,但再涨即违规;新文件一律不得超 1.3 万
- vector-audit 校验器加 SIZE_EXEMPT:豁免文件走 EXEMPT 而非 WARN,
  同时记下豁免时字数,超过该值仍旧报 WARN
- README 的「一条待处理」改写为「一条已豁免」,写明理由与收紧规则
This commit is contained in:
2026-11-04 09:20:46 +08:00
parent 6efe0b86cd
commit 39408c3e7f
5 changed files with 34 additions and 6 deletions
+5 -1
View File
@@ -85,4 +85,8 @@
- `参考仓库/zhangyu-1000-plus/` 路径不存在(实际是 `参考仓库/张宇1000题-notes/`),大题十年考点系列里约 30 条引用全死。是否批量改,待定。
- 该系列 56 处「加粗以空格/公式收尾」的存量问题(02、03、04、05、07、08、10、12、13、14、15、16、17 都有),只清了 09 一个文件。
- 两个超 1.3 万字符的文件待拆:`线性代数-第3讲-向量/01-知识点盘点.md`(17335)、`大题十年考点/09-点8-曲线积分.md`(17689)。
- **两个超 1.3 万字符的文件已获豁免,不拆**(用户 2026-11-04 原话:**「这次允许超过字数限制,下不为例」**):
- `线性代数-第3讲-向量/01-知识点盘点.md` 17335
- `大题十年考点/09-点8-曲线积分.md` 17689
两者不拆的理由相同:拆会打断「15 个考点文件」的编号体系。豁免只覆盖**现在的字数**——再往这两个文件加内容导致上涨,仍按违规处理。已落到三处:`MEMORY.md` 的排版约定下、`vector-audit/README.md` 的「一条已豁免」、校验器里的 `SIZE_EXEMPT`(输出走 `EXEMPT:` 而非 `WARN:`,且记下豁免时字数,涨了照样报 WARN)。**新文件一律不得超限。**
+2
View File
@@ -42,6 +42,8 @@
- **不再生成 PDF**(2026-10-23 起)。讲义只出 Markdown,在网页端或 App 里看;`md2pdf.js` 工具链保留但不主动调用。
- **讲义结构:知识点盘点 + 以题带点分册**。每讲 = `README` + `01-知识点盘点` + 每个考点一个分册 + 速查卡。盘点只做「定义/定理/判据/公式」的高密度地图,不展开例题;题目全部嵌在点分册里,绝不退回「考点册 + 试题册 + 解析册」三件套。
- **单个 md 不超过 1.3 万字符(约 6000 汉字),超了就拆文件**。一个文件塞太多内容会逼着压缩,压缩就丢细节(第3讲 1.8 万字符塞 7 个点的教训)。
- **唯一的存量豁免(2026-11-04 用户批准,原话「这次允许超过字数限制,下不为例」)**:`线性代数-第3讲-向量/01-知识点盘点.md`(17335)与 `大题十年考点/09-点8-曲线积分.md`(17689)。两个都**不拆**——拆会打断「15 个考点文件」的编号体系。豁免仅限这两处现状:**再往这两个文件里加内容导致字数上涨,一样算违规**;`vector-audit/check_vector_learning.py` 的 `SIZE_EXEMPT` 记了豁免字数,涨了即报 WARN
- **例外到此为止**:新写的文件一律不得超 1.3 万,交付前先数;超了就当场拆(`01b` / `03a-03b` 两种拆法都已在用)
- **文件间用相对路径 Markdown 链接做双向链接**(`[点 2](03-点2-秩与极大无关组.md)`),不用 `[[ ]]`:Gitea 会渲染成可点路径,Obsidian 也能进反链面板。
- **双向链接做到「题级」**(用户 2026-10-23 要求):不止点末一张表,**每道题末尾都要有一行 `> **关联** · 盘点 … | 上游 … | 下游 … | 速查 …`**,四向都指向具体题目的锚点;盘点/速查里的反向索引(§0.4「章节 ↔ 题目」、速查「回查」)由同一份映射**反向生成**,保证对称不漏。
- **Gitea 锚点规则(两条方向相反,极易踩)**:标题 id $=$ `user-content-` $+$ 小写化(保留字母数字汉字与下划线,空格→`-`,**其余标点全删**,`·` 两侧空格 → 两个 `-`)
+6 -2
View File
@@ -41,6 +41,10 @@ cd "D:/考研/第二代数学笔记"
- `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`。目前只记录,未动。
`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` 编号保持不动。
@@ -13,6 +13,11 @@ ROOT = Path(__file__).resolve().parents[3]
CHAPTER = ROOT / '基于考研的学习/数学一/在学练习/线性代数-第3讲-向量'
checks = []
warns = []
exempt = []
# 已获豁免的超限文件(2026-11-04 用户批准,仅此一次)。只放这一条,
# 新增的豁免必须单独获得同意;数值写着「不得再涨」,涨了仍会照实打印。
SIZE_EXEMPT = {'01-知识点盘点.md': 17335}
def check(name, value):
assert value, name
@@ -170,8 +175,17 @@ for file in sorted(CHAPTER.glob('*.md')):
check('structure summaries '+file.name, text.count('<summary>') == text.count('</summary>') == text.count('<details>'))
# 字符数上限是项目约定(单文件 ≤ 1.3 万字符)。超限只记警告:它不影响
# 数值与链接的正确性,若直接 assert 会让后面几百项检查全部不执行。
# 2026-11-04 用户明确豁免本讲 01-知识点盘点.md 一次(拆分会打断 15 个考点的
# 编号体系),但**只豁免这一个文件、只此一次**:新文件一律不得超。
if len(text) > 13000:
warns.append('file size %s: %d 字符 > 13000' % (file.name, len(text)))
msg = 'file size %s: %d 字符 > 13000' % (file.name, len(text))
cap = SIZE_EXEMPT.get(file.name)
if cap is None:
warns.append(msg)
elif len(text) > cap:
warns.append(msg + '(豁免时 %d,现又上涨)' % cap)
else:
exempt.append(msg + '(豁免上限 %d)' % cap)
check('structure no replacement chars '+file.name, '\ufffd' not in text)
check('structure math dollar parity '+file.name, text.count('$') % 2 == 0)
for target in re.findall(r'\]\(([^)]+)\)', text):
@@ -180,9 +194,12 @@ for file in sorted(CHAPTER.glob('*.md')):
report = {'passed': len(checks), 'arithmetic': 'fractions.Fraction',
'scope': 'Numerical examples, parameter branches, link and Markdown structure; abstract proofs manually reviewed',
'exempt': exempt,
'warnings': warns,
'checks': checks}
(Path(__file__).resolve().parent / 'vector_learning_checks.json').write_text(json.dumps(report, ensure_ascii=False, indent=2)+'\n', encoding='utf-8')
print(f'PASS: {len(checks)} exact numerical and structural checks')
for w in exempt:
print('EXEMPT:', w)
for w in warns:
print('WARN:', w)
@@ -2,9 +2,10 @@
"passed": 298,
"arithmetic": "fractions.Fraction",
"scope": "Numerical examples, parameter branches, link and Markdown structure; abstract proofs manually reviewed",
"warnings": [
"file size 01-知识点盘点.md: 17335 字符 > 13000"
"exempt": [
"file size 01-知识点盘点.md: 17335 字符 > 13000(豁免上限 17335)"
],
"warnings": [],
"checks": [
"1.1 target",
"1.1 impossible target",