机械原理前四章重写为在学练习模式(20-23:盘点+点文件+速查卡+旧版快照);新增803真正的考点大纲与重写规范;同步14-16章修改
This commit is contained in:
@@ -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()
|
||||
}
|
||||
@@ -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])
|
||||
@@ -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()
|
||||
@@ -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 章轴承摩擦有接口,写接口表时注明)。
|
||||
Reference in New Issue
Block a user