Metadata-Version: 2.4
Name: english-nativization-engine
Version: 1.0.0
Summary: 基于克拉申i+1理论的系统性英语习得引擎——精准定级、降维改写、强制输出、智能复习
Project-URL: Homepage, https://github.com/rendradar/english-nativization-engine
Project-URL: Repository, https://github.com/rendradar/english-nativization-engine
Author: RendRadar Team
License: MIT
License-File: LICENSE
Keywords: cli,english,esl,language-learning,reading
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Education
Requires-Python: >=3.10
Requires-Dist: openai>=1.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: rich>=13.0
Requires-Dist: typer>=0.15
Description-Content-Type: text/markdown

# 🧠 英语母语化引擎 (English Nativization Engine)

> 基于克拉申"i+1 可理解性输入"理论的系统性英语习得工具

不背单词，不刷题——通过精准定级、个性化 i+1 阅读、降维改写、强制输出和智能复习，帮助学习者在 6-12 个月内从"背单词"切换到"无障碍阅读"。

---

## 📦 两种使用方式

| 方式 | 安装 | 适用人群 |
|------|------|---------|
| 🖥️ **CLI 工具** | `pip install english-nativization-engine` | 任何有 Python 的人 |
| 🤖 **Claude Code 技能** | `npm install @rendradar/claude-code-english-nativization` | Claude Code 用户 |

---

## 🖥️ CLI 快速开始

```bash
# 1. 安装
pip install english-nativization-engine

# 2. 配置 API Key（免费注册: https://platform.deepseek.com）
ene config --key YOUR_DEEPSEEK_API_KEY

# 3. 开始学习
ene start
```

### 命令

| 命令 | 说明 |
|------|------|
| `ene start` | 🚀 完整学习会话（定级→阅读→输出→复习） |
| `ene read` | 📖 生成今日 i+1 阅读材料 |
| `ene demote -t "原文"` | 🔽 降维改写 |
| `ene review` | 📅 复习到期词汇 |
| `ene report` | 📊 学习进度报告 |
| `ene config --key KEY` | ⚙️ 配置 API |

---

## 🤖 Claude Code 技能

```bash
npm install @rendradar/claude-code-english-nativization
```

安装后在 Claude Code 中自动激活。触发词：`我想学英语`、`背单词没用`、`这段看不懂`。

或手动调用：`/english-nativization-engine`

---

## ⭐ 核心功能

### 降维改写
把《经济学人》C1 文章改写成 B1 可读版，保留核心观点。

**原文 (C1):**
> The epistemological tension between empirical observation and theoretical deduction has perennially underpinned scientific discourse...

**降维版 (B1):**
> How do we know if a scientific idea is correct? There are two main approaches...

### 三明治反馈
不是说"错了"，而是：**亮点 → 可优化 → 示范 → 已记录**

### 4 步流水线

```
精准定级 → i+1 输入 → 强制输出 → 智能复习
```

---

## ⚙️ 配置

支持任何 OpenAI 兼容 API：

| 提供商 | Base URL |
|--------|----------|
| DeepSeek（推荐，国内可用） | `https://api.deepseek.com/v1` |
| OpenAI | `https://api.openai.com/v1` |
| Ollama（本地） | `http://localhost:11434/v1` |

---

## 📁 项目结构

```
english-nativization-engine/
├── ene/                  # Python CLI 源码
│   ├── cli.py            # Typer 入口 (6 个子命令)
│   ├── diagnostic.py     # 精准定级
│   ├── input_engine.py   # i+1 生成 + 降维改写
│   ├── output_engine.py  # 三明治反馈
│   ├── review.py         # SM-2 间隔复习
│   ├── prompts.py        # LLM 提示词模板
│   ├── storage.py        # JSON 持久化
│   └── engine.py         # API 调用层
├── claude-code-skill/    # Claude Code npm 包
│   ├── package.json
│   └── skills/
│       └── english-nativization-engine/
│           ├── SKILL.md  # 595 行完整技能指令
│           └── assets/   # 定级文本 + 降维示例
├── pyproject.toml
├── LICENSE (MIT)
└── README.md
```

---

## 🔧 开发

```bash
# CLI 开发模式
git clone https://github.com/rendradar/english-nativization-engine
cd english-nativization-engine
pip install -e .

# Claude Code 技能本地测试
cp -r claude-code-skill/skills/ .claude/skills/
```

---

## License

MIT © 2026 RendRadar
