机械原理前四章重写为在学练习模式(20-23:盘点+点文件+速查卡+旧版快照);新增803真正的考点大纲与重写规范;同步14-16章修改

This commit is contained in:
2026-10-28 22:39:30 +08:00
parent 224dd91a85
commit 08c43ddc10
66 changed files with 5099 additions and 14 deletions
+26
View File
@@ -0,0 +1,26 @@
param(
[Parameter(Mandatory=$true)][string]$Src,
[Parameter(Mandatory=$true)][string]$Out
)
# Convert .ppt (legacy) to .pptx via PowerPoint COM, then quit.
# Usage: powershell -File convert_ppt.ps1 -Src "D:\...\xxx.ppt" -Out "D:\...\xxx.pptx"
# Never modifies the source file (opened ReadOnly). Output format 24 = ppSaveAsOpenXMLPresentation.
$ErrorActionPreference = 'Stop'
$ppt = $null
$pres = $null
try {
$ppt = New-Object -ComObject PowerPoint.Application
$pres = $ppt.Presentations.Open($Src, $true, $false, $false)
$pres.SaveAs($Out, 24)
$pres.Close()
Write-Output ("OK: " + $Out)
} catch {
Write-Error ("Convert failed: " + $_.Exception.Message)
exit 1
} finally {
if ($null -ne $pres) { try { $pres.Close() } catch {} }
if ($null -ne $ppt) { try { $ppt.Quit() } catch {} }
if ($null -ne $pres) { try { [void][System.Runtime.InteropServices.Marshal]::ReleaseComObject($pres) } catch {} }
if ($null -ne $ppt) { try { [void][System.Runtime.InteropServices.Marshal]::ReleaseComObject($ppt) } catch {} }
[GC]::Collect(); [GC]::WaitForPendingFinalizers()
}
+44
View File
@@ -0,0 +1,44 @@
# -*- coding: utf-8 -*-
"""Extract all text (text frames + tables, incl. group shapes) from a .pptx into a UTF-8 txt.
Usage: python extract_pptx.py <input.pptx> <output.txt>
"""
import sys
from pptx import Presentation
from pptx.enum.shapes import MSO_SHAPE_TYPE
def iter_shapes(shapes):
for sh in shapes:
yield sh
if sh.shape_type == MSO_SHAPE_TYPE.GROUP:
try:
yield from iter_shapes(sh.shapes)
except Exception:
pass
def main(src, out):
prs = Presentation(src)
lines = []
for idx, slide in enumerate(prs.slides, 1):
lines.append("")
lines.append("===== SLIDE %d =====" % idx)
for sh in iter_shapes(slide.shapes):
if sh.has_text_frame:
txt = "\n".join(p.text for p in sh.text_frame.paragraphs if p.text and p.text.strip())
if txt.strip():
lines.append(txt)
try:
if sh.has_table and sh.has_table:
for row in sh.table.rows:
cells = [c.text.replace("\n", " ") for c in row.cells]
lines.append(" | ".join(cells))
except Exception:
pass
with open(out, "w", encoding="utf-8") as f:
f.write("\n".join(lines))
print("OK: %d lines -> %s" % (len(lines), out))
if __name__ == "__main__":
main(sys.argv[1], sys.argv[2])
+90
View File
@@ -0,0 +1,90 @@
# -*- coding: utf-8 -*-
"""Verify a rewritten chapter folder (机械原理 在学练习 pattern).
Checks (per chapter folder passed as argv[1]):
1. required files exist and are non-empty: README.md, 01-知识点盘点.md,
01b-覆盖对照与接口.md, 10-速查卡.md, plus >=4 点 files 02-xx..09-xx
2. no line contains "$$" mixed with other content on the same line
(block math must have $$ alone on its own line; inline math uses single $)
3. every 点 file carries at least one 考点频率 marker (★★★/★★☆/★☆☆/⭐)
4. every 点 file carries a 出处 marker (出处:)
5. Obsidian double links [[ ]] appear in README / 01 / 10 and point files
6. 01 file links to 点 files and 10; 点 files mention [[01-知识点盘点]] or [[10-速查卡]]
7. no 旧版-snapshot folder got new files (skip; informational)
Usage: python verify_chapter.py <chapter_dir>
Exit code 0 = all pass; 1 = issues found (printed).
"""
import re
import sys
from pathlib import Path
REQ = ["README.md", "01-知识点盘点.md", "01b-覆盖对照与接口.md", "10-速查卡.md"]
FREQ = re.compile(r"(★★★|★★☆|★☆☆|⭐|必考|大题|选择|简答|了解|不考)")
SRC = re.compile(r"出处[::]")
def main():
ch = Path(sys.argv[1])
if not ch.is_dir():
print("NOT A DIR:", ch)
sys.exit(1)
issues = []
mds = sorted(ch.glob("*.md"))
names = {p.name for p in mds}
# 1. required files
for r in REQ:
if r not in names:
issues.append("缺少必需文件: " + r)
points = [p for p in mds if re.match(r"^0[2-9]-点\d+-", p.name)]
if len(points) < 4:
issues.append("点文件不足 4 个: %d" % len(points))
# per-file checks
for p in mds:
text = p.read_text(encoding="utf-8")
if len(text.strip()) == 0:
issues.append("空文件: " + p.name)
continue
# 2. $$ must stand alone on its line (strip inline-code spans first,
# so prose like "use `$$` as block math" is not flagged)
for ln, line in enumerate(text.splitlines(), 1):
line_nocode = re.sub(r"`[^`]*`", "", line)
if "$$" in line_nocode:
stripped = line_nocode.strip()
if stripped != "$$":
issues.append("%s:%d 同行块公式: %s" % (p.name, ln, stripped[:40]))
# 3/4. 点 files need frequency + source
if re.match(r"^0[2-9]-点\d+-", p.name):
if not FREQ.search(text):
issues.append("%s 缺考点频率标注" % p.name)
if not SRC.search(text):
issues.append("%s 缺出处标注" % p.name)
if "【图:" not in text and "图" not in text[:2000]:
pass # 配图占位非强制每点
# 5/6. links
if p.name in ("README.md", "01-知识点盘点.md", "10-速查卡.md", "01b-覆盖对照与接口.md"):
if "[[" not in text:
issues.append("%s 无双链" % p.name)
# 01 must link to each 点 file basename
if "01-知识点盘点.md" in names:
t01 = (ch / "01-知识点盘点.md").read_text(encoding="utf-8")
for pt in points:
if pt.stem not in t01:
issues.append("01 未链接点文件: " + pt.name)
# README must list 点 files
if "README.md" in names:
tr = (ch / "README.md").read_text(encoding="utf-8")
for pt in points:
if pt.stem not in tr:
issues.append("README 未列出点文件: " + pt.name)
if issues:
print("ISSUES (%d):" % len(issues))
for i in issues:
print(" -", i)
sys.exit(1)
print("OK: %s | %d md files, %d 点 files" % (ch.name, len(mds), len(points)))
sys.exit(0)
if __name__ == "__main__":
main()
+118
View File
@@ -0,0 +1,118 @@
# 机械原理 · 在学练习重写规范(803 机械原理与机械设计)
> 日期:2026-10-28 | 状态:第 3 章种子章已按本规范完成,作为模式基准
> 模式来源:数学一「在学练习」《知识点带题写作规范》适配版;机械原理真题少、非刷题模式,故点文件**不照搬"自编题+解析三件套"**,改为「知识点全文 + 考点频率/考法标注 + 关键例题/真题指引」。
> 素材三源合一:**课件**(`知识库/课件/`)+**学长考点建议**(`知识库/学长考点建议/提取文本/`)+**考点大纲**(`考试大纲/803-真正的考点大纲.md`);旧版笔记(快照)为素材与例题指引对象。
---
## 1. 每章文件结构(一套)
| 文件 | 内容 |
|---|---|
| `README.md` | 章节定位、考点总览与考频分布、**考点频率体系说明(必写)**、文件清单、建议读法、版本记录 |
| `01-知识点盘点.md` | 全章知识点地图:§0.1 按考频排 / §0.2 按依赖链排(=文件编号顺序)/ §0.3 符号约定 / §0.4 知识点→点文件对照;正文各节为**知识点摘要**;§9 覆盖对照表 |
| `01b-覆盖对照与接口.md` | 考点大纲条目 vs 学长考法 vs 课件出处 vs 新笔记落点(处置)+ 与其他章的接口表 |
| `02`—`09` 各点文件 | 每个知识点:**全文**(课件来源,不缩写)+**考点频率/考法**+关键例题/真题指引 |
| `10-速查卡.md` | 必背结论分区速查 + 失分点 + 回查表 |
- 点文件编号 = **依赖链顺序**(同 README §0.2),不是考频顺序;每章 4~8 个点,编号落在 `02`—`09`。
- 旧版文件(`知识点-XX.md`、`XX-背诵版.md`、`练习-XX-题目卷.md`、`练习-XX-答案卷.md`)**整体移入子文件夹 `旧版-重写前快照/`**(Move-Item,不删除),新结构写在章节文件夹根下。
## 2. 点文件模板(机械原理版)
```markdown
---
tags: [机械原理, 803, <章名>, <点N>]
专题: 机械原理 第<X>章 · 点<N> <点名>
日期: 2026-10-28
状态: 在学练习(知识点全文 + 考点频率,共 <N> 个知识点)
关联笔记: ["[[README]]", "[[01-知识点盘点]]"]
---
# 点 <N> <点名>
> 考点频率:★★★(必考大题)|考法:……
> 依赖:<前置点>。盘点对应:§<X> 全节。
**组织原则**:每个知识点先列**全文**(课件来源,不缩写),再标**考点频率与考法**,最后给**关键例题/真题指引**。知识点内部条目按课件小节顺序展开。
## 知识点 X.Y <名称>(出处:课件《第X章 …》§X.Y | 学长考点建议·第X章 | 考点大纲·第X章)
**考点频率**:★★★(必考大题)|**考法**:……
**学长强调**:<学长/考点大纲强调的关键细节,原意保留>
- <知识点全文:定义、公式、判据、表格;不缩写;课件未展开处标〔教材补充〕>
---
## 关键例题 / 真题指引
| 指引 | 位置 |
|---|---|
| 课件例题 | 第X章 PPT §X.X「…」 |
| 教材例题 | 教材第X章 例X-X(标题) |
| 旧版练习卷 | `旧版-重写前快照/练习-XX-题目卷.md` 第X题 |
| 真题信息 | 学长考点建议提到的真题事实(如"26 考研考过齿轮高副低代") |
**铁律**:例题指引只写**真实存在的**出处(课件/旧版练习卷/学长明确提到的真题事实);**禁止编造**题号、数值、年份。
```
## 3. 考点频率体系(每章 README 必须说明本体系)
- 频率:**★★★**(必考大题)/ **★★☆**(重点,选择/简答/大题可能)/ **★☆☆**(了解)/**✖ 不考**。
- 考法标签:必考大题 / 大题 / 选择 / 简答 / 了解 / 不考。
- 写法:`**考点频率**:★★★(必考大题)|**考法**:大题第一问(复合铰链/局部自由度/虚约束点名)`。
- **学长强调的关键细节必须保留**(示例:第3章「复合铰链 = 含机架的 M 个构件,转动副数 m−1,与活动构件数 n 口径勿混」「二级杆组条件:两杆三低副,一内副两外副」「齿轮高副低代 26 考研考到」)。
- 频率依据:`考试大纲/803-真正的考点大纲.md` 对应章表格 + 学长 txt;与考点大纲冲突时以考点大纲「考法/权重」列为准并在 README 注明。
## 4. 知识点全文规则
1. **全文列出,不缩写、不"见旧版"**——知识点本体在点文件里可直接读。
2. 出处挂在**知识点标题下**,不逐段重复。
3. **严禁知识点取舍**:即使 ★☆☆ / ✖ 不考 的知识点也要列出名称与一句话结论(不考的点一句话带过即可,但不得消失)。
4. 公式一律 LaTeX:行内 `$...$`;**块级 `$$` 必须三行式独占行**(`$$` 单独一行开、单独一行闭)。**禁止**同行 `$$...$$`(Obsidian 实时预览不渲染)。
5. 配图一律用 **`【图:图名】`** 占位,不插入真实图片。
6. 单文件 ≤ 1.3 万字符,超出拆点(一个点拆成两个点或两个知识点小节)。
7. 数据可复算原则:旧版练习卷/课件例题中的数值可以引用并复算核对;自拟数值要自洽。
## 5. Obsidian 链接硬约束
- README ↔ 01 ↔ 点文件 ↔ 10 用 **Obsidian 双链 `[[文件名]]`** 互连(同目录直接 `[[01-知识点盘点]]`)。
- 01 §0.4「知识点与点文件对照」按**知识点粒度**做"知识点 → 点N"直达链接。
- 10-速查卡「回查」表:想查什么 → 对应点文件。
- 跨章引用写明章名:**第4章 运动分析 / 第5章 力分析 / 第6章 连杆机构**。
## 6. 素材来源与读取步骤(每章必做)
1. **课件**:定位 `知识库/课件/第X章 …/` 下的主 `.ppt`(忽略 `(1)` 副本)。转换+提取:
```powershell
powershell -File 'D:\考研\机械设计笔记\重写规范\tools\convert_ppt.ps1' -Src '<xxx.ppt>' -Out '<你的临时目录>\chX.pptx'
python 'D:\考研\机械设计笔记\重写规范\tools\extract_pptx.py' '<chX.pptx>' '<chX.txt>'
```
转换产物放自己的临时目录,**严禁改动原课件**。图表/公式密集页可参考 `知识库\{3}--资源\` 的 PDF 版。
2. **学长建议**:读 `知识库\学长考点建议\提取文本\<对应章>.txt`(口语化,提取要点)。
3. **考点大纲**:读 `考试大纲\803-真正的考点大纲.md` 对应章表格(考点-考法/权重-学长要点)。
4. **旧版**:读 `旧版-重写前快照\` 下的 `知识点-XX.md`(主体素材)与 `XX-背诵版.md`(考点浓缩);练习卷用于例题指引。
5. 三源交叉:课件给"有什么"、学长/大纲给"考什么、怎么考"、旧版给"已有整理"。**冲突时以课件+考点大纲为准**,在 01b 处置列注明。
## 7. 每章交付与验收
**验收(交付前必跑)**:`python 'D:\考研\机械设计笔记\重写规范\tools\verify_chapter.py' '<章节文件夹>'` → 输出 `OK`。检查项:必需文件齐全且非空、点文件 ≥4、无同行 `$$`、每个点文件有考点频率与出处、双链齐全、01 链接全部点文件、README 列出全部点文件。
**交付汇报**(每章):文件清单(绝对路径)+ 完成说明(知识点数、点文件数、快照已建)+ **仍存在的缺口**(如"课件第 X 节公式为图片无法提取,按教材表述")。
## 8. 本轮章节映射(2026-10-28 范围:前四章)
| 笔记文件夹 | 课件源 | 学长 txt | 拆分建议(可依课件实际调整) |
|---|---|---|---|
| `20-机构的组成和结构分析` | 第3章 | 机构组成和结构分析.txt | 已按 7 个点完成(见种子章,模式基准) |
| `21-平面机构的运动分析` | 第4章(4.1+4.2 两个 ppt) | 平面机构.txt | ①概述与方法概览 ②速度瞬心法 ③相对运动图解法(含影像原理)④哥氏加速度 ⑤复数极坐标表示法 ⑥整体运动分析法 |
| `22-平面机构的力分析` | 第5章(5.1+5.2 两个 ppt) | 平面结构力分析.txt | ①力分析概述(力的分类、惯性力/惯性力偶)②动态静力分析(图解法/解析法)③平衡力与平衡力矩直接解析确定 ④机械效率 ⑤移动副摩擦与自锁 ⑥转动副摩擦(摩擦圆、总反力位置判定=本章80%题)⑦机构自锁 |
| `23-平面连杆机构` | 第6章(6.1 全章 ppt) | 连杆机构.txt | ①类型特点应用 ②铰链四杆机构基本型式与演化 ③存在曲柄的条件 ④压力角/传动角/死点 ⑤急回特性与行程速比系数 K ⑥按行程速度变化系数的设计(必考画图)⑦刚体位移矩阵(了解) |
**考点总览(学长全局判断)**:机械原理大题集中在机构结构分析、运动分析、连杆(画图)、凸轮(画图)、轮系、机械系统动力学;前四章中第3章自由度为**大题第一问**、第4章瞬心法/图解法/复数法**考得多**、第5章以**选择为主**(转动副总反力位置判定占本章 80%)、第6章**必考画图**。
## 9. 与本仓库其他资料的接口
- 后续章节(24-凸轮、01-齿轮、02-轮系、03-其他、04-运转调速、05-平衡)暂缓,规范不变,第 2 轮直接复用。
- 机械设计部分(06~19)后续按同一模式重写,本章规范同步适用(第 5 章摩擦/效率与机械设计第 17 章带传动效率、第 21 章轴承摩擦有接口,写接口表时注明)。