# 2026-10-14 工作日志 ## 推送上云(git push → app.zhantiandoudi.cn/Yimu/MathNotesVersion2) **背景**:用户指令"推送上云"。工作区 `D:/考研/第二代数学笔记` 是 git 仓库,远程 `origin = https://app.zhantiandoudi.cn/Yimu/MathNotesVersion2.git`(Gitea 类自建,凭证经 Windows Git Credential Manager 已缓存)。 ### 推送前的关键排查 1. **本地落后云端 1 个提交**:本地 main=`a3e3773`(init),云端 main=`0c199f6`("02数列极限加练与错题复盘")。属快进关系,需先变基。 2. **🔴 发现 `.gitignore` 规则全部失效**:原文件把注释写在**行尾**(如 `**/solutions/ # 历年答案 PDF`),而 gitignore 的 `#` **必须独占行首**,行尾 `#` 会被当作模式的一部分 → `solutions/`、`papers/images/`、`papers/*.md`、`papers/数学二/` 四条排除规则**均未生效**。实测待推送体积 **259MB**(含试卷 205MB 图片/PDF + 参考仓库 54MB 嵌套仓库);修复后降至 **160KB**。已改为行首注释,并新增忽略 `参考仓库/`(内含嵌套 `.git`,无法作为普通文件推送)。 3. **9 个笔记被本地删除**:`数学一/知识点/` 下 8 个 + `以题带点/2023-17-微分方程建模.md`。但 `总览.md` 里仍标 ✓,判断可能非本意 → **已向用户确认,用户选择"保持删除并同步"**。 4. **README.md 双方都改**:云端改"进度"段(02 数列极限 2026-10-04 / 03–14),本地改(02 加强版双链 + 04–14 + 新增复习手册节)。**冲突解决**:保留本地更完整版本,并修正云端 `03–14` 与上方 03 行重复的问题为 `04–14`。 ### 执行过程 1. 修复 `.gitignore`(行首注释 + 新增 `参考仓库/`)。 2. `git add -A` → 暂存 10 新增 / 9 删除 / 3 修改(确认参考仓库与试卷图片未被暂存)。 3. `git commit`(66c0956)→ `git rebase origin/main` → 仅 README.md 冲突 → 手工合并 → `git rebase --continue`(新提交 **82f15e1**)。 4. `git push origin main` → `0c199f6..82f15e1` ✓。 ### 结果 - 云端与本地 main 均为 **`82f15e1`**,`git status -sb` 无 ahead/behind,**已同步**。 - 本次推送内容:概率论第3讲四件套(README + 01考点手册 + 02试题 + 03解析 + 04答疑笔记)、每日小练 02-数列 系列 4 个文件、`.workbuddy/memory/2026-10-13.md`、README/总览/.gitignore 更新。 - 云端原有文件保留:`每日小练/02-数列极限.md`、`02-数列极限-加练.md`、`知识点/数列极限-方法复盘.md`。 ### ⚠️ 待用户决定的遗留问题 `每日小练/` 现在**存在两套并列的"02"**(并行会话/多机造成): - 本地线:`02-数列.md`(2026-10-12 初版)+ `02-数列-加强版.md` + `02-数列-知识点复习.md` + `02-数列-质量审计.md` - 云端线:`02-数列极限.md`(2026-10-04)+ `02-数列极限-加练.md` 且 `总览.md` 中 `知识点/`、`以题带点/` 节点仍标 ✓,但实际已随本次删除移除 —— **总览与磁盘不一致,待同步**。 ### 可复用的经验 - `.gitignore` 注释必须独占一行;行尾注释会静默失效,务必用 `git ls-files --others --exclude-standard` + `du --files0-from=-` 实测待推送体积。 - 该仓库推送前固定检查:①`git fetch` 看是否落后 ②`git rev-list --left-right --count origin/main...main` ③待推送体积 ④缺失(D)/新增(A)清单(尤其**删除项**要人工确认)。 - `du -ch | tail -1` 配 `xargs` 会因分批而给出错误总计,须用 `du -ch --files0-from=-`。 --- ## 概率论第3讲 → 平板书写版 PDF(新建 md2pdf 工具链) **需求**:把「在学练习/概率论-第3讲-多维随机变量及其分布」转成适合平板上手写的 PDF,要求**公式精确渲染**、**每题留半页/整页答题**。 **环境约束**:本机**无 pandoc、无 LaTeX(xelatex 等)**;有 Edge(Chromium 内核)、托管 Node v22、npm 可达。 → 选定渲染链:**Markdown → 公式保护占位 → markdown-it → KaTeX 服务端渲染 → 内联字体 CSS → puppeteer-core 驱动 Edge 无头打印**。 ### 新增工具(可复用,非一次性脚本) - `D:/考研/第二代数学笔记/.workbuddy/tools/md2pdf/md2pdf.js` —— 主转换器 - `--mode plain`:普通版(考点手册/解析/答疑) - `--mode answer`:答题版,按 `**N.**` 切题,逐题注入 `.q-space` 留白(A 组 88mm / B·C 组 178mm,含浅色虚框 + 横向书写格) - 关键实现:`$…$`、`$$…$$` 先替换成 `\uE000n\uE001` 占位符再走 markdown(**解决表格单元格内含 `|` 的公式被拆表问题**);KaTeX CSS 只保留 woff2 并 base64 内联(离线可渲染,约 800KB/份);页脚用 puppeteer `footerTemplate` 加「标题 + 页码/总页数」。 - `D:/考研/第二代数学笔记/.workbuddy/tools/md2pdf/shot.js` —— 把 HTML 按像素区间截图,用于**视觉验收公式/表格/留白**。 - 依赖装在托管工作区 `C:/Users/Wang Ling/.workbuddy/binaries/node/workspace`(katex 0.19、markdown-it、puppeteer-core),**未污染用户环境**。 ### 产物(`在学练习/概率论-第3讲-多维随机变量及其分布/PDF/`) | 文件 | 页数 | |---|---| | 概率论第3讲-试题-答题版.pdf | 17(1 封面页 + A 组 3 页 + B 组 8 页 + C 组 5 页) | | 概率论第3讲-考点手册.pdf | 10 | | 概率论第3讲-解析.pdf | 7 | | 概率论第3讲-答疑笔记.pdf | 9 | **验收**:截图抽查首页(表格+行内公式)、B 组页、C 组页(`cases` 独立公式居中)、考点手册页(二维正态长公式、blockquote),公式与表格均正确、无溢出。 **同步**:`README.md` 新增「五、平板书写版(PDF)」节(含重新生成命令);`总览.md` 目录树补 `04-答疑笔记.md` 与 `PDF/` 四个文件;`.gitignore` 追加忽略 `.workbuddy/tools/md2pdf/build/`(HTML 中间产物体积大)。 **待确认**:留白尺寸(A 半页 / B·C 整页)如不合用,改 `pageCss()` 里 `.q-space.half|.full` 的高度重跑即可;PDF 尚未 push,等用户确认后随下次提交上云。