重写项目README:更新目录结构、文章精读包标准、选词红线与交付验证规范

This commit is contained in:
2026-10-04 14:10:32 +08:00
parent cb68f75d09
commit 24b03f02bf
+127 -105
View File
@@ -10,7 +10,7 @@
| 模块 | 内容范围 | | 模块 | 内容范围 |
|------|----------| |------|----------|
| 词汇 | 考研核心词汇、真题生词、词根词缀、易混词辨析、熟词僻义 | | 词汇 | 考研核心词汇、真题生词、词根词缀、易混词辨析、熟词僻义、专题词汇、文章精读词汇 |
| 语法 | 语法专题、长难句拆解、句子成分分析 | | 语法 | 语法专题、长难句拆解、句子成分分析 |
| 翻译 | 英译汉练习、真题翻译、翻译技巧 | | 翻译 | 英译汉练习、真题翻译、翻译技巧 |
| 写作 | 作文模板、范文积累、好词好句、批改记录 | | 写作 | 作文模板、范文积累、好词好句、批改记录 |
@@ -20,55 +20,53 @@
- 考研学生,报考中国矿业大学(北京),专业课为 803 机械原理与机械设计。 - 考研学生,报考中国矿业大学(北京),专业课为 803 机械原理与机械设计。
- 英语学习服务于考研英语备考,词汇、语法、翻译、写作均以**考研英语(英语一/英语二)真题语境**为优先素材。 - 英语学习服务于考研英语备考,词汇、语法、翻译、写作均以**考研英语(英语一/英语二)真题语境**为优先素材。
- 笔记最终服务于复习回顾,要求:结构清晰、可检索、可复习。 - 笔记最终服务于复习回顾,要求:结构清晰、可检索、可复习。
- 需要配图时,一律写 `【图:图名】` 占位,由用户自行插入图片,**不得**直接引用网络图片地址。
## 3. 目录结构 ## 3. 目录结构(当前真实状态)
建议(后续 AI 新建笔记时按此组织):
``` ```
D:\考研\英语\ D:\考研\英语\英语词汇\
├── README.md ← 本文件 ├── README.md ← 本文件(操作说明书)
├── 欢迎.md ← 库首页
├── 大模型文章分析必看.md ← 卫报精读的教师 Prompt 与选词红线(权威规范之一)
├── 词汇短文_2026-09-15.md ← 词汇短文样例(库根)
├── .obsidian\ ← Obsidian 配置(app.json 排序为 alphabetical,配合数字前缀)
├── 词汇\ ├── 词汇\
│ ├── 单词表.md ← 词汇索引(Obsidian 双向链接,点击跳转到词条) │ ├── 单词表.md ← 专题词汇索引(Obsidian 双向链接,点击跳转词条)
│ ├── 法律政治专题\ │ ├── 法律政治专题\
│ │ ├── 遵纪守法.md │ │ ├── 遵纪守法.md (10 词)
│ │ ├── 政治体制.md │ │ ├── 政治体制.md (10 词)
│ │ ├── 国家治理.md │ │ ├── 国家治理.md (30 词)
│ │ ├── 国际关系.md │ │ ├── 国际关系.md (10 词)
│ │ └── 军事法律.md │ │ └── 军事法律.md (10 词)
│ ├── 核心词汇.md ├── 词汇全表\ ← 由脚本从 kao_yan_3.db 批量生成的全表(第01组–第38组,每组 100 词)
│ ├── 真题生词.md ├── 文章词汇分析\ ← 卫报文章精读包(01–18 数字前缀 + 1 个早期单文件)
│ └── 易混词辨析.md │ ├── 01-密苏里选区重划\
├── 语法\ │ ├── 02-美加贸易战\
│ ├── 长难句分析.md │ ├── ...(详见第 8 节清单)
│ └── 语法专题.md │ └── AfD选举大胜·政治新闻词汇精读.md ← 早期单文件格式,保留未动
├── 翻译\ └── 情景单词记忆\ ← 考研词汇短文(kaoyan-vocab-story 流程,按批次建子文件夹)
│ ├── 真题翻译.md ├── 第一组\ 第二组\ 第三组\ (每批:4 篇短文 + 总表)
│ └── 翻译练习.md ├── kao_yan_3.db (词汇数据库 + 提取进度 extract_state.json)
└── 写作\ └── 生成脚本(generate_full_vocab.py 等)
├── 作文模板.md
├── 范文积累.md
└── 批改记录.md
``` ```
> 目录结构可按实际学习进度调整,但模块划分(词汇/语法/翻译/写作)保持稳定。
## 4. 笔记规范(必须遵守) ## 4. 笔记规范(必须遵守)
1. **格式**:一律使用 Markdown(.md),文件名用中文,语义清晰。 1. **格式**:一律使用 Markdown(.md),文件名用中文,语义清晰。
2. **标题层级**:`#` 一级标题 = 文件名/主题,`##` 二级标题 = 大节,`###` 三级标题 = 小节。 2. **标题层级**:`#` 一级标题 = 文件名/主题,`##` 二级标题 = 大节,`###` 三级标题 = 小节。
3. **配图**:需要配图时,用占位符 `【图:图名】` 代替,由用户自行插入图片,**不要**直接引用网络图片地址。 3. **配图**:用占位符 `【图:图名】` 代替,由用户自行插入图片,**不要**直接引用网络图片地址。
4. **例句与来源**:摘录真题句子时,标注年份和题型来源(如"2020 阅读 Text 2"),方便回查。 4. **例句与来源**:摘录真题句子时,标注年份和题型来源(如"2020 阅读 Text 2"),方便回查。
5. **表格**:表格**前后必须留空行**(GFM 规范,否则渲染失败显示为源码);表头行/分隔行/数据行均以 `|` 开头和结尾,分隔行格式 `|---|---|---|`;渲染效果在 Obsidian 阅读视图查看。 5. **表格**:表格**前后必须留空行**(GFM 规范,否则渲染失败显示为源码);表头行/分隔行/数据行均以 `|` 开头和结尾,分隔行格式 `|---|---|---|`;渲染效果在 Obsidian 阅读视图查看。
6. **生词记录**:词汇条目**严格按第 5 节「词汇笔记标准(固定模板)」书写**,板块、顺序、格式固定,不得删减或自行更改板块名。 6. **生词记录**:词汇条目**严格按第 5 节「词汇笔记标准(固定模板)」书写**,板块、顺序、格式固定,不得删减或自行更改板块名。
7. **词形变化**:每个词汇条目用**表格**列出该词全家族词形(名词/动词/形容词/副词),每行含:词形、词性、含义、搭配示例;表格后另起一段写**⚠️跳变重点**——重点讲解含义跳变的词形,如 security(安全→证券)、civil(民事的→civilian 平民)、ethic(单数准则→复数伦理学)、monarch(人)→monarchy(制度)这类"名词和形容词/单复数含义差很多"的情况,并给出防误译提示。 7. **词形变化**:每个词汇条目用**表格**列出该词全家族词形(名词/动词/形容词/副词),每行含:词形、词性、含义、搭配示例;表格后另起一段写 **⚠️跳变重点**——重点讲解含义跳变的词形,如 security(安全→证券)、civil(民事的→civilian 平民)、ethic(单数准则→复数伦理学)、monarch(人)→monarchy(制度)这类"名词和形容词/单复数含义差很多"的情况,并给出防误译提示。**禁止"点一下"式带过——每个词形都要讲清含义。**
8. **长难句**:语法/长难句笔记建议含:原句、来源、句子结构拆解(主干/从句/修饰)、译文、生词。 8. **长难句**:语法/长难句笔记建议含:原句、来源、句子结构拆解(主干/从句/修饰)、译文、生词。
9. **写作笔记**:模板类笔记注明适用题型(大作文/小作文、图画/图表/书信等)。 9. **写作笔记**:模板类笔记注明适用题型(大作文/小作文、图画/图表/书信等)。
10. **复习友好**:重点内容可用 Obsidian 的 `[[双向链接]]`、`#标签` 组织,便于回顾检索。 10. **复习友好**:重点内容可用 Obsidian 的 `[[双向链接]]`、`#标签` 组织,便于回顾检索。
## 5. 词汇笔记标准(固定模板) ## 5. 词汇笔记标准(固定模板)
**适用于 `词汇\` 下所有词汇笔记文件(含专题子文件夹)。这是唯一标准,以后一律按此书写,不得降级为简化版。** **适用于 `词汇\` 下所有词汇笔记文件(含专题子文件夹)与 `文章词汇分析\` 各包的 `词汇.md`。这是唯一标准,以后一律按此书写,不得降级为简化版。**
### 文件头 ### 文件头
@@ -93,69 +91,8 @@ D:\考研\英语\
### 文末固定两块 ### 文末固定两块
- **近义词辨析总表**:本单元全部辨析组一句话汇总 - **近义词辨析总表**:本单元全部辨析组一句话汇总(表格:组别|词|一句话差异)
- **单元串联记忆**:全部单词串成一段情景故事 + **必背短语清单** - **单元串联记忆**:全部单词串成一段情景故事 + **必背短语清单**(一行全角竖线 ` | ` 分隔)
### 模板骨架(照此书写)
```markdown
# 主题名
> 主题:所属专题
---
## 单词 /音标/
**词性**:...
**词源故事(时代背景)**
...(2–4 句,讲词源 + 时代背景 + 同根词)
**核心含义**
- ...:...
- ...:...
**情景例句**
- 【场景】...(英文例句 + 中文释义)
**词形变化(全家族)**
| 词形 | 词性 | 含义 | 搭配示例 |
|---|---|---|---|
| ... | ... | ... | ... |
⚠️ 跳变重点:...(含义跳变 + 防误译提示)
**使用惯例**
- ...(文化习惯 / 固定用法 / 行业惯例)
**近义词辨析**:...
| 词 | 核心差异 | 典型搭配 |
|---|---|---|
| ... | ... | ... |
> 对比句:...
**考研重点**:...
**记忆点**:...
---
## 近义词辨析总表
| 组别 | 词 | 一句话差异 |
|---|---|---|
| ... | ... | ... |
## 单元串联记忆
...(情景故事)
**必背短语清单**:...
```
### 质量红线 ### 质量红线
@@ -164,21 +101,106 @@ D:\考研\英语\
- 表格前后必须留空行(见第 4 节第 5 条)。 - 表格前后必须留空行(见第 4 节第 5 条)。
- 例句英文优先用考研/学习/生活语境,方便代入记忆。 - 例句英文优先用考研/学习/生活语境,方便代入记忆。
## 6. 给 AI 的操作约定 ## 6. 文章精读包标准(`文章词汇分析\`)
**每篇卫报文章一个文件夹,文件夹内固定四文件,用 `[[双向链接]]` 互链:**
| 文件 | 内容 |
|---|---|
| README.md | 文章信息(标题/来源/作者/主题表)+ 学习路线("先读 → 再背 → 最后抄写"三段式)+ 与词汇库的关联(跨包互链)+ 阅读提示 |
| 文章解读.md | 文章背景速览一段 → 一、背景导入(Article Snapshot 6 行表 + Background 分点)→ 二、核心问题六问 → 三、逐段精读 → 四、Knowledge ↔ English → 五、结构地图 |
| 词汇.md | 18 个高价值词条(按第 5 节模板)+ 文末三件套 |
| 笔记本抄写版.md | 自测式七节(供用户誊抄到纸质笔记本) |
### 文章解读.md 格式规范(以 08/17 包为样板)
1. **A. Original 必须是英文原文**,B. What is happening 才是中文翻译——**不得把 A 写成中文**。
2. 逐段精读每组固定 **A–H 八环节**:A. Original(英文)/ B. What is happening(中文翻译)/ C. Context & Knowledge / D. Logic / E. Important Sentences(英文+关键词释义+中文)/ F. Vocabulary(`[[包名/词汇#词条 /音标/\|词汇·词条]]` 链接)/ G. Collocations / H. Reading Trap。
3. 二、核心问题固定**六问**:What is the problem / Why does it matter / Who is affected / What are the competing views / What is the evidence / What is the author's position。
4. 五、文章结构与思想地图用 `text` 代码块画全文逻辑主线。
### 笔记本抄写版.md 七节(新版,以 16–18 包为样板)
> 设计理念:抄写本质是"为主动回忆设计的自测工作纸"(生成效应 + 期望难度 + 便携复习)——排版一列英文一列中文,复习时遮挡任意一列做双向自测。
一、文章一句话(抄完即掌握全文)→ 二、核心词汇·自测表(两栏英中,18 词含必背搭配)→ 三、必背短语·语境版(20 条带原文半句)→ 四、金句·挖空背诵(6 句,答案括注)→ 五、关键事实·记忆点(证据链/人物/数字)→ 六、写作借鉴(一句话)→ 七、自测清单(勾选)。
### 文章词汇选词红线(每篇必守)
- 每篇精选 **16–18 个**高价值词;**剔除**基础词(如 transparent / unchecked)、一眼可猜的派生词(如 evaluator)、以及与 `词汇\` 专题已收录词、与其他文章包已收录词**重复**的词(如 safeguard、coordinate、grievance、opaque、blockade)。
- **优先**选熟词僻义(precipitate / echo / acute)、词族扩展词(outrun→outweigh、unilateral→bilateral→multilateral)、考研高频抽象词、可作多义词考点的词(mortar 研钵/砂浆/迫击炮)。
- 每包选词前用脚本扫描全库零重复;文章词汇**不并入** `词汇\单词表.md`(沿用先例,独立成文件)。
### 交付前验证三步(每包必跑,PowerShell 脚本)
1. **表格空行检查**:四文件所有以 `|` 开头的数据行,其前后相邻行若为非空行且非 `|` 行,即违规——0 问题。
2. **词条计数**:`^## [^#]` 宽松计数 = 20(18 词 + 文末 2 大节)。
3. **解读→词汇链接缺失 = 0**:链接 heading 须与词汇.md 内 `## 词 /音标/` 行精确相等(`\|` 还原为 `|`、尾斜杠 TrimEnd('\'))。
### 文件夹排序约定
- 文章文件夹统一 **数字前缀**(01-、02-…),Obsidian 默认名称排序(app.json `fileSortOrder: alphabetical`)下即学习顺序。
- **未来新包按序接 19-…**,不得跳号或改用其他排序方案(byCreatedTime 方案已被用户否决)。
## 7. 给 AI 的操作约定
- 用户要求"写笔记/整理词汇/分析句子"时,产物落在本文件夹对应模块下,格式遵循上述规范。 - 用户要求"写笔记/整理词汇/分析句子"时,产物落在本文件夹对应模块下,格式遵循上述规范。
- 用户要求配图时,写 `【图:图名】` 占位,不要自行生成或插入图片。 - 用户要求配图时,写 `【图:图名】` 占位,不要自行生成或插入图片。
- 用户发来词汇清单时,默认按第 5 节模板创建/追加词汇笔记,无需再确认格式。 - 用户发来词汇清单时,默认按第 5 节模板创建/追加词汇笔记,无需再确认格式;每完成一批,**必须同步更新 `词汇\单词表.md`**(分组表 + 字母序速查,链接格式 `[[笔记名#词条标题\|显示名]]`,表格内管道符用 `\|` 转义,词条标题须与笔记内 `## 标题` 完全一致含音标)。
- **文章分析统一用文件夹组织**:`文章词汇分析\<文章名>\` 文件夹内包含四个文件——`README.md`(文章信息+学习路线入口)、`文章解读.md`(背景导入/核心问题/逐段精读/Knowledge↔English/结构地图)、`词汇.md`(高价值词条,按第 5 节模板书写+近义词辨析总表+单元串联记忆)、`笔记本抄写版.md`(手抄浓缩版:文章一句话/核心词汇表/必背短语/金句/关键事实/写作借鉴,供用户誊抄到纸质笔记本);不用单文件堆叠,文件之间用 `[[双向链接]]` 互链,README 学习路线固定为"先读 → 再背 → 最后抄写"三段式。 - 用户发来卫报文章时,默认按第 6 节标准建四文件精读包,交付前跑三步验证,交付时一次 `present_files` 四文件 + 配 HTML/SVG 信息图(已连续 18 包成惯例)。
- **文章词汇选词标准(质量红线,每篇必守)**:每篇精选 **16–18 个**高价值词;**剔除**基础词(如 transparent / unchecked)、一眼可猜的派生词(如 evaluator)、以及与 `词汇\` 专题已收录词重复的词(如 safeguard、coordinate);**优先**选熟词僻义(precipitate / echo / acute)、词族扩展词(outrun→outweigh、unilateral→bilateral→multilateral)、考研高频抽象词;词条仍按第 5 节模板书写。文章词汇**不并入** `词汇\单词表.md`(沿用先例,独立成文件)。 - 修改已有笔记前,先读取原文件,保留用户原有内容与表述,只做被要求的改动;不确定放哪个模块时,先问用户,不要擅自新建顶层文件夹。
- **每完成一批词汇笔记,必须同步更新 `词汇\单词表.md`**:新增单词按专题加入分组表,并加入字母序速查表;链接格式 `[[笔记名#词条标题\|显示名]]`(表格内管道符用 `\|` 转义),词条标题须与笔记内 `## 标题` 完全一致(含音标)。
- 不确定放哪个模块时,先问用户,不要擅自新建顶层文件夹。
- 修改已有笔记前,先读取原文件,保留用户原有内容与表述,只做被要求的改动。
- 涉及具体日期(如"今天""本周")的任务,先调用工具换算成具体日期再落笔。 - 涉及具体日期(如"今天""本周")的任务,先调用工具换算成具体日期再落笔。
- 本库用 Git 管理(remote: app.zhantiandoudi.cn),完成一批工作后用户可能要求"推送到云"——先 `git status` 确认改动,再 add/commit/push;认证失败时提示用户自行在终端执行 `git push origin main`(Git Credential Manager 弹窗登录)。
## 7. 其他 ## 8. 当前已有内容(截至 2026-10)
- 当前已有内容:`词汇\法律政治专题\遵纪守法.md`(10 词)、`词汇\法律政治专题\政治体制.md`(10 词)、`词汇\法律政治专题\国家治理.md`(30 词)、`词汇\法律政治专题\国际关系.md`(10 词)、`词汇\法律政治专题\军事法律.md`(10 词),均按第 5 节标准书写;`词汇\单词表.md` 收录全部 70 词索引。 ### 专题词汇(`词汇\法律政治专题\`,共 70 词)
- 文章分析:`文章词汇分析\AfD选举大胜·政治新闻词汇精读.md`(单文件,早期格式,保留未动);文件夹格式共 5 个:`密苏里选区重划\`(12 词)、`美加贸易战\`(12 词)、`德国AfD种族清洗之争\`(12 词)、`特朗普5000美元承诺\`(12 词 + 笔记本抄写版)、`Anthropic呼吁AI减速\`(18 词 + 笔记本抄写版,科技主题首个)。文件夹内互链使用带路径链接 `[[文章文件夹名/文件#词条标题|显示名]]`,避免与同名文件歧义;跨文件夹关联用 `[[文章文件夹名/README|显示名]]` 指向入口文件。
- 词汇按主题组织:同主题词汇放同一文件(如"遵纪守法""政治体制"),后续批次若同主题继续追加或另建文件,文件名用中文主题名。 | 文件 | 词数 | 批次来源 |
- 其余目录结构待实际使用中逐步建立。 |---|---|---|
| 遵纪守法.md | 10 | equal / secure / safeguard / shield / ethic / virtue / thrift / diligent / strive / contribute |
| 政治体制.md | 10 | sovereign / regime / federal / monarch / privilege / democratic / democracy / represent / representative / civil |
| 国家治理.md | 30 | reign 等 ×3 批(含 autonomy、pioneer 等) |
| 国际关系.md | 10 | domestic / alien / migrate / immigrant / emigrate / settle / diplomatic / affair / harmony / status |
| 军事法律.md | 10 | military / rank / command / mission / strategy / tactic / hostile / alarm / alert / chaos |
索引:`词汇\单词表.md`(分组表 + 字母序速查,100% 链接验证)。
### 词汇全表(`词汇全表\`)
由脚本 `generate_full_vocab.py` 从 `kao_yan_3.db` 批量生成,第01组–第38组,每组 100 词(序号/单词/词性/例句 四列),覆盖数据库全量词汇。
### 文章精读包(`文章词汇分析\`,01–18 前缀 + 早期单文件)
| 包 | 主题 | 词数 |
|---|---|---|
| 01-密苏里选区重划 | 选区重划司法战 | 12 |
| 02-美加贸易战 | 美加关税升级 | 12 |
| 03-德国AfD种族清洗之争 | 德极右党州选大胜 | 12 |
| 04-特朗普5000美元承诺 | 中期选举竞选承诺 | 12 |
| 05-Anthropic呼吁AI减速 | AI 安全减速呼吁 | 18 |
| 06-瑞典大选 | 瑞典大选胶着 | 18 |
| 07-亲人类峰会AI之争 | 中美 AI 治理分歧 | 18 |
| 08-帕特农神庙光学错觉 | 建筑迷思考据(解读格式样板) | 18 |
| 09-OpenAI披露AI异常行为 | AI 异常行为披露 | 18 |
| 10-跑者腹泻 | 运动肠胃科普 | 18 |
| 11-特朗普AI部队 | AI 部队与治理 | 18 |
| 12-精神疾病死亡率差距 | 健康不平等数据 | 18 |
| 13-德国州选CDU灾难 | 德州选双败 | 18 |
| 14-赌场机密泄密 | 离岸博彩监管漏洞 | 18 |
| 15-美伊霍尔木兹危机 | 霍尔木兹海峡冲突 | 18 |
| 16-巴西大选民主对决 | 巴西大选民主之争 | 18 |
| 17-AI与医权统治 | 词源考据与 AI 幻觉 | 18 |
| 18-法国学生抗议 | 法国教育危机与抗议 | 18 |
另:`AfD选举大胜·政治新闻词汇精读.md`(早期单文件格式,保留未动)。
### 情景单词记忆(`情景单词记忆\`,kaoyan-vocab-story 流程)
第一组/第二组/第三组子文件夹,每批从 `kao_yan_3.db` 顺序提取 100 词(进度持久化于 `extract_state.json`),生成 4 篇英文短文 + 词汇总表;短文输出到 `情景单词记忆\` 按批次建子文件夹,不放脚本目录。
### 其他
- `大模型文章分析必看.md`:卫报精读教师 Prompt(角色/任务/选词红线/结构地图三步收尾),与本文档第 6 节互为权威。
- `词汇短文_2026-09-15.md`:库根词汇短文样例。
- `欢迎.md`:库首页。