Files
MathNotesVersion2/.workbuddy/memory/MEMORY.md
T

5.8 KiB
Raw Blame History

项目长期约定 · 第二代数学笔记

一、路径与目录

  • 🔴 只认 D:/考研/第二代数学笔记。 D:/Development/创意/考研数学AI学习商业化平台/docs/原始项目参考/第二代数学笔记 是同名旧快照(停在 2026-11-04),2026-11-08 用户明令弃用:禁止读、写、比对。动手前先确认路径前缀。
  • 复习产出主线在 基于考研的学习/数学一/:
    • 在学练习/<专题>-文件夹/ —— 知识点带题结构:README + 01-知识点盘点 + 每点一分册(02—NN,知识点在前、题目紧随)+ 速查卡。不退回「考点册 + 试题册 + 解析册」三件套(仅线代第 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 注释必须独占行首(行尾注释会静默失效)。