5.8 KiB
5.8 KiB
项目长期约定 · 第二代数学笔记
一、路径与目录
- 🔴 只认
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 不同)
- 行内
$…$收尾$后必须紧跟半角空白;紧贴中文或全角标点 → 整对不渲染。开头$左邻若是 ASCII 字母数字或. ! ? , : ;也不渲染。 $$块级公式的开头与收尾必须独占一行;单行$$…$$成对是合法的。空位横线______绝不能写进数学模式(KaTeX 抛Expected group after '_',整块失败),公式块只放表达式本体。**加粗**:收尾**前是标点、后紧贴汉字 → 不生效。绝不能写$…$**(两头都死),只能改写句式让**以汉字收尾。- front matter 不过 markdown,里面只写纯文字(
+就写+)。 - 跨文件锚点必须手写
#user-content-前缀,同文件不用。锚点算法:小写化,保留字母数字汉字下划线,空格→-,其余标点全删(|、·、:、$都删)。 - 清单要挂题锚点时用标题不用表格(表格行没有 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注释必须独占行首(行尾注释会静默失效)。