Shangxpss · Shangxpss · Apr 6, 2026
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1 @@
+Nothing needs to be added to .gitignore since only a README.md file was modified and no build artifacts, dependencies, or temporary files were detected in the changes.
diff --git a/README.md b/README.md
@@ -1,5 +1,154 @@
-# EnglishTutor
+# EnglishTutor 📚
 
-https://app.diagrams.net/
+A comprehensive English learning and teaching resource repository focused on Chinese Gaokao (College Entrance Examination) English preparation.
 
-https://excalidraw.com/
+## 📖 Project Overview
+
+This project serves as a complete English tutoring system with structured materials covering:
+
+- **Grammar System** - Complete grammar framework with detailed explanations
+- **Exam Analysis** - In-depth analysis of past Gaokao English exams (2015-2024)
+- **Vocabulary Building** - Organized vocabulary lists by exam year and type
+- **Reading Skills** - Techniques for reading comprehension and test-taking strategies
+- **Literature & Oral Practice** - Supplementary materials for language immersion
+
+## 🗂️ Directory Structure
+
+```
+EnglishTutor/
+├── grammar/              # Grammar knowledge system
+│   ├── WholeGraphy.md    # Core grammar framework (noun+verb+noun structure)
+│   └── specify/          # Detailed grammar topics
+│       ├── noun.md       # Noun clauses and non-finite verbs
+│       ├── adverbial.md  # Adverbial clauses
+│       ├── adjective.md  # Adjective usage
+│       ├── appositive.md # Appositive structures
+│       └── noninfinite.md# Non-finite verb forms
+│
+├── analyse/              # Gaokao exam paper analysis (2015-2024)
+│   ├── 2015NewStandardOne.md
+│   ├── ...
+│   └── 2024NewStandardTwo.md  # Latest exam analyses with detailed breakdowns
+│
+├── paper/                # PDF files of original exam papers (2008-2024)
+│   ├── 2008 年高考英语试卷（全国Ⅰ卷）（空白卷）.pdf
+│   └── ... (60+ exam papers)
+│
+├── skill/                # Test-taking skills and strategies
+│   └── blank/
+│       ├── skill.drawio      # Visual skill maps
+│       └── MindDraw.excalidraw
+│
+├── class/                # Classroom materials
+│   ├── common.md         # Introduction lecture (teaching philosophy & methods)
+│   └── firstClass.docx   # First lesson materials
+│
+├── literature/           # Reading materials
+│   ├── oral.md           # Oral English practice
+│   └── PrideAndPrejuce.md # Classic literature adaptation
+│
+├── killSkill/            # Problem-solving techniques
+│   ├── blank.md
+│   └── question.ts       # Question processing utilities
+│
+├── vocabulary.ts         # Vocabulary database organized by exam year
+└── README.md             # This file
+```
+
+## 🎯 Key Features
+
+### 1. **Systematic Grammar Teaching**
+- Based on "noun + verb + noun" core sentence structure
+- Logical approach to grammar (80% can be understood through logic, not memorization)
+- Comprehensive coverage: clauses, participles, complements, adverbials
+
+### 2. **Complete Exam Paper Analysis**
+- **24 exam papers analyzed** from 2015-2024
+- Covers all major exam types:
+  - New Standard (新课标Ⅰ/Ⅱ卷)
+  - National Papers (全国甲/乙卷)
+  - New Gaokao (新高考Ⅰ/Ⅱ卷)
+- Each analysis includes:
+  - Full text with key phrases highlighted
+  - Question-by-question breakdown
+  - Answering strategies and reasoning
+
+### 3. **Teaching Philosophy**
+From the introduction lecture (`class/common.md`):
+- **Team-based learning**: Teacher and students work together toward score improvement
+- **Three core goals**: Improve scores, improve scores, improve scores
+- **Reading ability is fundamental**: True comprehension comes from vocabulary + grammar
+- **No shortcuts**: Rejects "magic techniques" that only work on specific questions
+- **Logical grammar learning**: Understanding > Memorization
+
+### 4. **Skill Development Focus**
+- **Listening**: Keyword recognition, avoiding traps
+- **Reading**: Comprehension + key point identification + test techniques + values
+- **Cloze tests**: Reading ability + clue finding
+- **Seven-out-of-five**: Reading ability + logical connections
+- **Grammar fill-in**: Reading ability + word transformation
+- **Writing**: Reading ability (continuation writing) + imitation (templates)
+
+## 📊 Statistics
+
+| Category | Count | Description |
+|----------|-------|-------------|
+| Exam Analyses | 24 | Years 2015-2024 |
+| Exam Papers (PDF) | 60+ | Years 2008-2024 |
+| Grammar Topics | 6 | Core + specialized |
+| Vocabulary Lists | Organized by year | TypeScript interface |
+
+## 🛠️ Tools & Resources
+
+- **Diagrams**: Created with [diagrams.net](https://app.diagrams.net/) and [Excalidraw](https://excalidraw.com/)
+- **Visual Maps**: Skill mind maps in `.drawio` and `.excalidraw` formats
+- **Code Utilities**: TypeScript files for vocabulary and question processing
+
+## 📝 Sample Content
+
+### Grammar Example (from `WholeGraphy.md`)
+```markdown
+# noun + verb + noun
+
+## noun dependent clause
+### subject dependent clause
+**What worked on a veterinarian** seemed likely to work on his patients.
+
+### appositive clause
+> Farber, **a graduate of Colorado State University**, started out as 
+> a more conventional veterinarian.
+```
+
+### Exam Analysis Example (from `2024NewStandardOne.md`)
+- Full passage text with **bolded key phrases**
+- Question analysis with reasoning
+- Distractor elimination strategies
+- Author's intent identification
+
+## 🎓 Target Audience
+
+- High school students preparing for Gaokao English
+- English teachers seeking structured teaching materials
+- Self-learners wanting systematic grammar understanding
+- Anyone aiming to improve English reading comprehension
+
+## 💡 Teaching Highlights
+
+> "让子弹飞看过吗... 来鹅城就三件事，公平，公平，还是公平... 文章和电影其实本质是一样的，载体不一样... 就是把重要的事情变着花样的说三遍。"
+> 
+> — Using movie references to explain main idea questions in reading comprehension
+
+> "治大国如烹小鲜，我们学英语如烹小鲜"
+> 
+> — Comparing English learning to cooking: words are ingredients, grammar is the recipe
+
+## 🔗 Quick Links
+
+- [Grammar Framework](./grammar/WholeGraphy.md)
+- [Latest Exam Analysis (2024)](./analyse/2024NewStandardOne.md)
+- [Introduction Lecture](./class/common.md)
+- [Vocabulary Database](./vocabulary.ts)
+
+---
+
+**Note**: This repository contains educational materials primarily in Chinese with English examples, designed for the Chinese education context.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Nothing needs to be added to .gitignore since only a README.md file was modified and no build artifacts, dependencies, or temporary files were detected in the changes.