Files

51 lines
5.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.
# 项目长期约定 · 第二代数学笔记
## 一、路径与目录
- **🔴 只认 `D:/考研/第二代数学笔记`。** `D:/Development/创意/考研数学AI学习商业化平台/docs/原始项目参考/第二代数学笔记` 是同名旧快照(停在 2026-11-04),**2026-11-08 用户明令弃用**:禁止读、写、比对。动手前先确认路径前缀。
- 复习产出主线在 `基于考研的学习/数学一/`:
- `在学练习/<专题>-文件夹/` —— **知识点带题**结构:`README` + `01-知识点盘点` + 每点一分册(`02`—`NN`,知识点在前、题目紧随)+ `速查卡`。已建:无穷级数(42 题)、中值定理(49 题)。不退回「考点册 + 试题册 + 解析册」三件套(仅线代第 2—5 讲仍是旧结构)。
- `专项突破/<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 章,**无概率、无级数、无曲线曲面积分**)。
## 二、用户偏好(硬约束)
- 单文件 **≤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`。
## 三、Gitea 网页渲染的六条硬规则(云端 Goldmark,和本地 KaTeX 不同)
1. 行内 `$…$` 收尾 `$` 后必须紧跟**半角空白**;紧贴中文或全角标点 → 整对不渲染。开头 `$` 左邻若是 ASCII 字母数字或 `. ! ? , : ;` 也不渲染。
2. `$$` **块级**公式的开头与收尾必须独占一行;单行 `$$…$$` 成对是合法的。**空位横线 `______` 绝不能写进数学模式**(KaTeX 抛 `Expected group after '_'`,整块失败),公式块只放表达式本体。
3. `**加粗**`:收尾 `**` 前是标点、后紧贴汉字 → 不生效。**绝不能写 `$…$**`**(两头都死),只能改写句式让 `**` 以汉字收尾。
4. front matter 不过 markdown,里面只写纯文字(`+` 就写 `+`)。
5. 跨文件锚点必须手写 `#user-content-` 前缀,同文件不用。锚点算法:小写化,保留字母数字汉字下划线,空格→`-`,**其余标点全删**(`|`、`·`、`:`、`$` 都删)。
6. 清单要挂题锚点时**用标题不用表格**(表格行没有 heading id)。
## 四、工具链(`.workbuddy/tools/md2pdf/`)
- **交付前三个校验器必须都跑**:`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` 注释必须独占行首(行尾注释会静默失效)。