english-nativization-engine 1.0.0__tar.gz

english_nativization_engine-1.0.0/.env.example

@@ -0,0 +1,22 @@
+# 英语母语化引擎 - 环境变量配置
+# 复制此文件为 .env 并填入你的 API Key
+
+# ── API 配置 ──
+# DeepSeek API (推荐，国内可用，便宜)
+ENE_API_KEY=sk-your-deepseek-api-key-here
+ENE_API_BASE=https://api.deepseek.com
+ENE_MODEL=deepseek-chat
+
+# 或者使用 OpenAI API
+# ENE_API_KEY=sk-your-openai-api-key
+# ENE_API_BASE=https://api.openai.com/v1
+# ENE_MODEL=gpt-4o-mini
+
+# 或者使用任何兼容 OpenAI 接口的服务
+# ENE_API_KEY=your-key
+# ENE_API_BASE=https://your-api-endpoint.com/v1
+# ENE_MODEL=your-model-name
+
+# ── 可选配置 ──
+# 数据存储目录（默认 ~/.english-nativization/）
+# ENE_DATA_DIR=/custom/path/to/data

english_nativization_engine-1.0.0/.gitignore

@@ -0,0 +1,37 @@
+# Python
+__pycache__/
+*.py[cod]
+*.so
+*.egg-info/
+dist/
+build/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+!.env.example
+
+# User data (never commit learner data!)
+~/.english-nativization/
+*.prof
+
+# npm
+node_modules/
+npm-debug.log*
+package-lock.json

english_nativization_engine-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RendRadar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

english_nativization_engine-1.0.0/PKG-INFO

@@ -0,0 +1,155 @@
+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

english_nativization_engine-1.0.0/README.md

@@ -0,0 +1,132 @@
+# 🧠 英语母语化引擎 (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

english_nativization_engine-1.0.0/claude-code-skill/README.md

@@ -0,0 +1,42 @@
+# English Nativization Engine — Claude Code Skill
+
+> 🧠 基于克拉申"i+1可理解性输入"理论的系统性英语习得技能
+
+## 安装
+
+```bash
+# 在你的 Claude Code 项目中
+npm install @rendradar/claude-code-english-nativization
+```
+
+安装后，Claude Code 会自动发现此技能。
+
+## 使用
+
+**自动触发**（包含关键词时自动激活）：
+- "我想学英语"、"背单词没用"、"想读外刊"
+- 贴一段英文 + "看不懂"
+
+**手动调用**：
+```
+/english-nativization-engine
+```
+
+## 功能
+
+| 功能 | 说明 |
+|------|------|
+| 🎯 精准定级 | 3段文本 + 1个写作题 → CEFR等级 |
+| 📖 i+1输入 | 自动生成刚好比你水平难一点的阅读 |
+| 🔽 降维改写 | 把《经济学人》C1文章改成B1可读版 ⭐ |
+| ✍️ 强制输出 | 造句/复述/关联 + 三明治反馈 |
+| 📅 智能复习 | SM-2算法间隔重复 |
+
+## 更多
+
+- CLI 工具：`pip install english-nativization-engine`（不依赖 Claude Code）
+- 完整文档：https://github.com/rendradar/english-nativization-engine
+
+## License
+
+MIT

english_nativization_engine-1.0.0/claude-code-skill/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@rendradar/claude-code-english-nativization",
+  "version": "1.0.0",
+  "description": "基于克拉申i+1理论的英语母语化引擎 — Claude Code 技能包。精准定级、降维改写、强制输出、智能复习。",
+  "keywords": [
+    "claude-code",
+    "claude-code-skill",
+    "english",
+    "language-learning",
+    "esl",
+    "reading",
+    "i+1",
+    "krashen"
+  ],
+  "author": "RendRadar Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/rendradar/english-nativization-engine"
+  },
+  "homepage": "https://github.com/rendradar/english-nativization-engine#readme",
+  "files": [
+    "skills/",
+    "README.md"
+  ]
+}