2026-10-16 14:17:28 +08:00
|
|
|
|
# 项目长期约定 · 第二代数学笔记
|
|
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
## 一、路径与目录
|
2026-10-16 14:17:28 +08:00
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
- **🔴 只认 `D:/考研/第二代数学笔记`。** `D:/Development/创意/考研数学AI学习商业化平台/docs/原始项目参考/第二代数学笔记` 是同名旧快照(停在 2026-11-04),**2026-11-08 用户明令弃用**:禁止读、写、比对。动手前先确认路径前缀。
|
|
|
|
|
|
- 复习产出主线在 `基于考研的学习/数学一/`:
|
2026-11-18 11:55:58 +08:00
|
|
|
|
- `在学练习/<专题>-文件夹/` —— **知识点带题**结构:`README` + `01-知识点盘点` + 每点一分册(`02`—`NN`,知识点在前、题目紧随)+ `速查卡`。已建:无穷级数(42 题)、中值定理(49 题)。不退回「考点册 + 试题册 + 解析册」三件套(仅线代第 2—5 讲仍是旧结构)。
|
2026-11-11 14:00:05 +08:00
|
|
|
|
- `专项突破/<NN>-<名称>/` —— 章节型(01—03、10)用 `01-考点地图` + `02-试题` + `03a/03b/03c-解析`;工具型(04—09)用 `01-判定卡与速查` + `02-试题` + `03-解析`。每份都要有 `04-答疑笔记` 与 `README`。
|
|
|
|
|
|
- `模拟卷/<第N次模拟-数学一>/` —— `01-模拟卷`(只有题)+ `02a/02b-答案与解析` + `03~05-考点手册`(H01/L01/P01)+ `06-考点预测与分布`。
|
|
|
|
|
|
- `每日小练/做题本.md` 记小练与章节练习的错;`冲刺错题本/` 只记真题、模拟卷、专项、限时训练的错(七段,含「二刷」)。
|
|
|
|
|
|
- 真题库:`试卷/Kaoyan-Math1-Papers/papers/近十年真题题库/kaoyan_math1.db`(2016—2025,225 题,表 `question`)。**`chapter_id` 存的是纯数字 `'17'`,不是 `'ch17'`。**
|
|
|
|
|
|
- 参考仓库:`参考仓库/Math/`(张宇基础三十讲 + 李永乐 660 的 tex 笔记)、`参考仓库/张宇1000题-notes/`(高数 15 章 + 线代 6 章,**无概率、无级数、无曲线曲面积分**)。
|
2026-10-16 14:17:28 +08:00
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
## 二、用户偏好(硬约束)
|
2026-10-16 14:17:28 +08:00
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
- 单文件 **≤1.3 万字符**,超了就拆(`01b`、`03a/03b/c`、`08/08b/08c` 三种拆法都已在用)。唯一存量豁免:线代第3讲 `01-知识点盘点`(17335)与 `大题十年考点/09-点8-曲线积分`(17689),再涨即违规。
|
|
|
|
|
|
- 题目难度分层 A/B/C;**专项突破里 A 组必设限时**;**出题要对齐真题与张宇难度,不许一步套公式**(2026-11-11 用户因"太简单"要求整组重做)。题源要标 `【真题 20xx-xx 骨架】` / `【张宇 30 讲 · … 骨架】`,原创题不假标骨架。
|
|
|
|
|
|
- 出题防过拟合:换数字、换区域,只对齐考法。含参题设条件前先解一遍。
|
|
|
|
|
|
- **不再生成 PDF**(2026-10-23 起),只出 Markdown。
|
|
|
|
|
|
- 双向链接用相对路径 Markdown(不用 `[[ ]]`),做到题级:每题末 `> **关联** · 盘点 … | 上游 … | 下游 … | 速查 …`。
|
|
|
|
|
|
- **标题里禁止出现 `$…$`**(锚点会漂)。
|
|
|
|
|
|
- **表格里的数学式禁止裸 `|`**,一律 `\vert`。
|
|
|
|
|
|
- 改动后三处索引同步:`专项突破/README.md`、`解题工具清单.md`、`总览.md`。
|
2026-10-16 14:17:28 +08:00
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
## 三、Gitea 网页渲染的六条硬规则(云端 Goldmark,和本地 KaTeX 不同)
|
2026-10-16 14:17:28 +08:00
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
1. 行内 `$…$` 收尾 `$` 后必须紧跟**半角空白**;紧贴中文或全角标点 → 整对不渲染。开头 `$` 左邻若是 ASCII 字母数字或 `. ! ? , : ;` 也不渲染。
|
|
|
|
|
|
2. `$$` **块级**公式的开头与收尾必须独占一行;单行 `$$…$$` 成对是合法的。**空位横线 `______` 绝不能写进数学模式**(KaTeX 抛 `Expected group after '_'`,整块失败),公式块只放表达式本体。
|
|
|
|
|
|
3. `**加粗**`:收尾 `**` 前是标点、后紧贴汉字 → 不生效。**绝不能写 `$…$**`**(两头都死),只能改写句式让 `**` 以汉字收尾。
|
|
|
|
|
|
4. front matter 不过 markdown,里面只写纯文字(`+` 就写 `+`)。
|
|
|
|
|
|
5. 跨文件锚点必须手写 `#user-content-` 前缀,同文件不用。锚点算法:小写化,保留字母数字汉字下划线,空格→`-`,**其余标点全删**(`|`、`·`、`:`、`$` 都删)。
|
|
|
|
|
|
6. 清单要挂题锚点时**用标题不用表格**(表格行没有 heading id)。
|
2026-10-16 14:17:28 +08:00
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
## 四、工具链(`.workbuddy/tools/md2pdf/`)
|
2026-10-16 14:17:28 +08:00
|
|
|
|
|
2026-11-11 14:00:05 +08:00
|
|
|
|
- **交付前三个校验器必须都跑**:`check_md_links.py <目录>`(链接与锚点,**只扫单层不递归**)→ `fix_gitea_math.py --check`(公式空格、加粗、front matter)→ `verify_gitea_math.py <仓库相对路径…>`(抓真实网页数残留 `$`)。**链接全绿 ≠ 网页能渲染。**
|
|
|
|
|
|
- `fix_gitea_math --apply` **会重写整个 scope**,先 `git add`;`--scope=` 只能传仓库相对路径(绝对路径静默失效);它**不修**「加粗以公式收尾」。
|
|
|
|
|
|
- 重构某讲后必须全局搜旧文件名:`grep -rn "<讲目录>/0" --include=*.md .`,否则下游死链发现不了。
|
|
|
|
|
|
- `verify_gitea_math` 会把行内代码里的字面 `$…$` 误报,README 里别把公式写进反引号。
|
|
|
|
|
|
- bash 双引号内的反引号会触发命令替换;含反引号或多行文本改用 Write 一个临时 `.py`。
|
|
|
|
|
|
- `gen_crosslinks.py`:单一数据源是题目标题 `### 题 N · X.Y:短标题`,幂等生成关联行 / §0.4 表 / 速查回查表。点文件匹配 `^\d{2}[a-z]?-点`,题号从文件名取。
|
|
|
|
|
|
- Python:`C:/Users/Wang Ling/.workbuddy/binaries/python/envs/default/Scripts/python.exe`(跑仓库脚本);`C:/Python314/python.exe`(**带 sympy**,所有数值必须验算)。
|
|
|
|
|
|
- 本机无 pandoc / 无 LaTeX。`md2pdf.js` 保留但不主动调用。
|
|
|
|
|
|
|
|
|
|
|
|
## 五、云仓库
|
|
|
|
|
|
|
|
|
|
|
|
- `origin = https://app.zhantiandoudi.cn/Yimu/MathNotesVersion2.git`(main)。
|
|
|
|
|
|
- **代理端口每轮都变**(7897→55184→61286→62633→61742),一律 `git -c http.proxy="$https_proxy" -c https.proxy="$https_proxy" push`,`-c` 必须放在子命令**前**。
|
|
|
|
|
|
- 推送前检查:`git status --short`(确认不含 `.workbuddy/tmp` 等临时物)→ 提交 → push → `git rev-list --left-right --count origin/main...main` 归零。
|
|
|
|
|
|
- `.gitignore` 注释必须独占行首(行尾注释会静默失效)。
|