新增:机械原理第4章「机械的平衡」笔记;笔记目录改为「分包」结构

一、新增 笔记/05-机械的平衡/知识点-机械的平衡.md(考纲 ⑩)
- 来源 补充资源/机械原理PPT/04 机械的平衡.ppt(olefile 抽 33 页)
- 八节:目的与内容(F=mrω²、危害三条、刚性转子判据、两大分支)/
  刚性转子平衡计算(静平衡 d/b≥5 质径积矢量式 + 双面分解;动平衡
  d/b<5 ∑F=0 且 ∑M=0、双基面两次静平衡;静↔动对比表)/ 平衡实验
  (三架对比 + 强迫振动 Z=μmr、标准转子标定 μ、相位差 α)/
  许用不平衡量与平衡精度([e]、[mr]、A=[e]ω/1000、等级 G4000~G0.4)/
  平面机构平衡(F=-ma_s=0→质心静止;完全平衡 vs 部分平衡)/ 要点回顾
  + 9 条易错 / 考纲对齐
- 按约定不配图

二、笔记目录重构为「包」结构
- 01 齿轮机构及其设计 / 02 轮系及其设计 / 03 其他常用机构 /
  04 机器的运转和调速 / 05 机械的平衡 / 06 机械零件设计基础
- 每包自带:知识点 + 背诵版 + 练习(题目卷/答案卷)+ images/
- 顶层 背诵版/ 目录取消,背诵版并入各包;images/ 按包拆分
- 绘图脚本移到 笔记/_配图脚本/,OUT 改为自动指向各包 images/
- 新增 笔记/00-总索引.md(包清单 + 考纲全景对照 + 待办)
- 文件名全部保持原样,Obsidian 双链与图片相对路径零改动

三、修复全库渲染 bug:加粗以公式结尾时失效
- `**$x$ **` 中 `**` 前是空白,CommonMark 不认其为闭合符 → 加粗失效
- 新增 .workbuddy/fix_bold_math.py(按 ** 成对解析)修掉 107 处
This commit is contained in:
2026-10-18 18:48:03 +08:00
parent ee8ef9456e
commit 39469c5b50
50 changed files with 715 additions and 196 deletions
+44 -38
View File
@@ -61,29 +61,34 @@
├── 欢迎.md ← Obsidian 默认文件(可删)
├── 考试大纲/
│ └── 803_机械原理与机械设计_考试大纲.pdf
├── 知识库/
├── 知识库/ ← 课件源(310M,.gitignore 已排除,不推送)
│ ├── {3}--资源/ ← 天大配套课件(以「机械设计」各章为主)
│ └── 补充资源/
│ └── 机械原理PPT/ ← 「机械原理」全套课件 00~11(与考纲逐章对应)
├── 笔记/ ← 全部笔记产物
│ ├── 知识点-齿轮(知识库整合).md
│ ├── 知识点-轮系(齿轮系及其设计).md
│ ├── 知识点-其他常用机构.md
│ ├── 知识点-机器的运转和调速.md
│ ├── 知识点-机械零件设计基础.md
│ ├── 考纲-课件覆盖对照.md
│ ├── 练习-齿轮-题目卷.md
│ ├── 练习-齿轮-答案卷.md
│ └── images/ ← 配图(PNG)+ 绘图脚本
│ ├── gen_figures.py (齿轮配图:fig01 ~ fig12)
│ ├── gen_figures_geartrain.py (轮系配图:figG01 ~ figG11)
│ └── gen_figures_mechanisms.py (其他常用机构配图:figM01 ~ figM09)
└── 背诵版/ ← ★ 速记版:只留要背的(定义/公式/数字/结论/辨析)
├── 00-总索引.md (目录 + 用法 + 覆盖情况)
├── 齿轮-背诵版.md
└── 轮系-背诵版.md
└── 笔记/
├── 00-总索引.md ★ 从这里进(包清单 + 考纲全景对照)
├── 考纲-课件覆盖对照.md 考纲 ↔ 课件 逐条核对、缺口登记
├── _配图脚本/ 程序化配图脚本(matplotlib 几何作图)
│ ├── gen_figures.py 齿轮 fig01~fig12(被后两个复用)
│ ├── gen_figures_geartrain.py 轮系 figG01~figG11
│ └── gen_figures_mechanisms.py 其他常用机构 figM01~figM09
│
├── 01-齿轮机构及其设计/ ← 一个章节 = 一个「包」
│ ├── 知识点-齿轮(知识库整合).md
│ ├── 齿轮-背诵版.md
│ ├── 练习-齿轮-题目卷.md
│ ├── 练习-齿轮-答案卷.md
│ └── images/ (fig01~fig12)
├── 02-轮系及其设计/ (知识点 + 背诵版 + images/figG01~11)
├── 03-其他常用机构/ (知识点 + images/figM01~09)
├── 04-机器的运转和调速/ (知识点,按约定无图)
├── 05-机械的平衡/ (知识点,按约定无图)
└── 06-机械零件设计基础/ (知识点,按约定无图)
```
**包内四类文件**:`知识点-XXX.md`(学懂)|`XXX-背诵版.md`(速记)|`练习-XXX-题目卷.md` + `练习-XXX-答案卷.md`(自测)。配图放包内 `images/`,笔记内以相对路径 `images/figXX_*.png` 引用。
**编号规则**:`01`、`02`… 按整理顺序排,新章接末尾,旧编号不变;考纲顺序对照见 `笔记/00-总索引.md`。
---
## 四、知识库资源说明
@@ -138,12 +143,12 @@
1. **字幕 → 笔记**:`.srt` 去时间轴 → 分段 → 提取正文 → 纠正同音错字 → 结构化整理。
2. **课件 → 笔记**:
- `.pdf` → PyMuPDF(`page.get_text("text")`)抽文本;
- `.pdf` → PyMuPDF(`page.get_text("text")`)抽文本;**若文本层公式丢失**(公式是嵌入的 OLE 对象,常见于机械设计各章),改用 `page.get_pixmap(dpi=125)` 逐页渲染成 PNG 再读图;
- `.pptx` → 用 `tencent-pptx` skill 或 python-pptx 逐页导出文本框内容;
- `.ppt`(老式二进制)→ **先转 `.pptx`** 再抽。
3. **配图(按需,非必要不加)**:确需配图时,用 `笔记/images/` 下的脚本**程序化生成**(matplotlib/numpy 几何精确作图,**禁止 AI 扩散式生图**),300 dpi,图片以相对路径嵌入笔记。**默认不配图**,仅当明确要求时才加。
- `.ppt`(老式 OLE2 二进制)→ **无需转 pptx**,直接用 `.workbuddy/extract_ppt.py <输入.ppt> [输出.txt]`(olefile 读 `PowerPoint Document` 流 → 递归遍历 `0x03EE` Slide 容器 → 取 `0x0FA0/0x0FA8` 文本原子)。
3. **配图(按需,非必要不加)**:确需配图时,用 `笔记/_配图脚本/` 下的脚本**程序化生成**(matplotlib/numpy 几何精确作图,**禁止 AI 扩散式生图**),300 dpi;脚本会**自动把图写进对应包的 `images/`**。**默认不配图**,仅当明确要求时才加。
4. **出题**:按 **判断题 + 简答/分析题 + 计算题** 三类,**题目卷与答案卷分离**为两份文件。
5. **背诵版**:知识点笔记写完后,另出 `背诵版/XXX-背诵版.md` —— **只留要背的**(定义 / 公式 / 关键数字 / 结论 / 易错辨析),**无推导、无配图、纯文字**,便于手机随时翻阅。统一结构:`〇、必背数字` → 正文 → `辨析/易错速查`。
5. **背诵版**:知识点笔记写完后,另出**包内**的 `XXX-背诵版.md` —— **只留要背的**(定义 / 公式 / 关键数字 / 结论 / 易错辨析),**无推导、无配图、纯文字**,便于手机随时翻阅。统一结构:`〇、必背数字` → 正文 → `辨析/易错速查`。
### 环境与工具
@@ -156,28 +161,29 @@
## 六、复习进度
| 模块 | 知识点笔记 | 配图 | 练习(题目/答案) | 背诵版 | 状态 |
|---|---|---|---|---|---|
| 机械原理·齿轮机构(第八章) | ✅ | ✅ 12 张 | ✅ | ✅ | **已完成** |
| 机械设计·齿轮传动(第18章) | ✅(并入"知识库整合"一份) | ✅ | ✅ | ✅ | **已完成** |
| 机械原理·轮系(齿轮系及其设计) | ✅ | ✅ 11 张 | ⬜ | ✅ | 知识点+背诵版完成,练习待做 |
| 机械原理·其他常用机构(第9章) | ✅ | ✅ 9 张 | ⬜ | ⬜ | 知识点完成,练习/背诵版待做 |
| 机械原理·机器的运转和调速(第10章) | ✅ | —(按约定不配图) | ⬜ | ⬜ | 知识点完成,练习/背诵版待做 |
| 机械原理·其余章节 | ⬜ | ⬜ | ⬜ | ⬜ | 未开始(课件已备:补充资源 01~06、11) |
| 机械设计·机械零件设计基础(第13章) | ✅ | —(按约定不配图) | ⬜ | ⬜ | 知识点完成,练习/背诵版待做 |
| 机械设计·第 14~26 章 | ⬜ | ⬜ | ⬜ | ⬜ | 未开始(课件已备:蜗杆传动等) |
| 编号 | 模块 | 知识点 | 背诵版 | 练习(题目/答案) | 配图 | 状态 |
|:--:|---|:--:|:--:|:--:|:--:|---|
| **01** | 机械原理·齿轮机构(+机械设计 第18章 齿轮传动) | ✅ | ✅ | ✅ | 12 张 | **已完成** |
| **02** | 机械原理·轮系(齿轮系及其设计) | ✅ | ✅ | ⬜ | 11 张 | 练习待做 |
| **03** | 机械原理·其他常用机构 | ✅ | ⬜ | ⬜ | 9 张 | 背诵版 / 练习待做 |
| **04** | 机械原理·机器的运转和调速 | ✅ | ⬜ | ⬜ | —(按约定不配图) | 背诵版 / 练习待做 |
| **05** | 机械原理·机械的平衡 | ✅ | ⬜ | ⬜ | —(按约定不配图) | 背诵版 / 练习待做 |
| **06** | 机械设计·机械零件设计基础(第13章) | ✅ | ⬜ | ⬜ | —(按约定不配图) | 背诵版 / 练习待做 |
| — | 机械原理 ①~⑤(结构分析 / 运动分析 / 力分析 / 连杆 / 凸轮) | ⬜ | ⬜ | ⬜ | ⬜ | 未开始(课件 01~03、05、06 已备) |
| — | 机械设计 第 14~26 章(连接 / 传动 / 轴 / 轴承 / 联轴器 / 弹簧) | ⬜ | ⬜ | ⬜ | ⬜ | 未开始(课件已备) |
> **说明**:齿轮部分(机械原理第八章 + 机械设计第18章)合并整理为 `笔记/知识点-齿轮(知识库整合).md`(含 12 张程序化配图);轮系为 `笔记/知识点-轮系(齿轮系及其设计).md`(含 11 张程序化配图);其他常用机构为 `笔记/知识点-其他常用机构.md`(含 9 张程序化配图)。齿轮、轮系的速记版见 `背诵版/`。
> **覆盖率**:机械原理 10 项已整理 **5 项**(⑥齿轮、⑦轮系、⑧其他常用机构、⑨运转调速、⑩平衡);机械设计 8 项已整理 **1 项覆盖前两条**((1) 计算准则 + (2) 疲劳/摩擦磨损润滑)。
>
> **配图原则(2026-10-16 起)**:**非必要不加图**——只有明确要求时才配图。第 10 章「机器的运转和调速」、机械设计第 13 章「机械零件设计基础」即按此原则,**纯文字 + 表格**。
> **配图原则(2026-10-16 起)**:**非必要不加图** —— 只有明确要求时才配图。第 04、05、06 包即按此原则,**纯文字 + 表格**。
---
## 七、命名与格式约定
- 知识点笔记:`知识点-XXX.md`
- **包(章节文件夹)**:`01-XXX/`、`02-XXX/`…(按整理顺序编号,见 `笔记/00-总索引.md`)
- 知识点笔记:`知识点-XXX.md`(放在所属包内)
- 练习:`练习-XXX-题目卷.md` + `练习-XXX-答案卷.md`(**答案与题目必须分离**)
- 背诵版:`背诵版/XXX-背诵版.md`(+ `背诵版/00-总索引.md` 总目录)
- 图片(**按需生成,非必要不加**):`笔记/images/figNN_描述.png`(齿轮)/ `figGNN_描述.png`(轮系)/ `figMNN_描述.png`(其他常用机构),脚本自包含、可一键重生成
- 背诵版:`XXX-背诵版.md`(放在所属包内,不再单设顶层目录)
- 图片(**按需生成,非必要不加**):包内 `images/figNN_描述.png`(齿轮)/ `figGNN_描述.png`(轮系)/ `figMNN_描述.png`(其他常用机构),脚本在 `笔记/_配图脚本/`,一键重生成会自动写入对应包
- 公式(云端 Gitea 渲染):**行内 `$…$` 的闭合 `$` 后必须紧跟一个 ASCII 空格**(后接中文标点时尤其要注意),行间公式独立成行用 `$$…$$`。新增/改动笔记后跑一次 `.workbuddy/check_math.py` 自检
- 本库为 Obsidian 仓库,笔记间可用 `[[双链]]` 互联
- 本库为 Obsidian 仓库,笔记间可用 `[[…]]` 双链互联(**文件名必须全局唯一**,移动文件夹不影响链接)