@rookiestar/eng-lang-tutor 1.2.2 → 1.2.5

package/README.md

@@ -84,6 +84,21 @@ openclaw skills list
 openclaw skills info eng-lang-tutor
 ```
 
+### 卸载
+
+```bash
+# 卸载 npm 包并清除所有数据（包括状态和媒体文件）
+npm uninstall -g @rookiestar/eng-lang-tutor && rm -rf ~/.openclaw/state/eng-lang-tutor ~/.openclaw/media/eng-lang-tutor
+```
+
+**如需保留学习数据，仅卸载软件：**
+
+```bash
+npm uninstall -g @rookiestar/eng-lang-tutor
+```
+
+> 注意：`~/.openclaw/state/eng-lang-tutor/` 存储学习进度、XP、连胜等数据；`~/.openclaw/media/eng-lang-tutor/` 存储生成的音频文件。
+
 **重启 Gateway：**
 
 ```bash
@@ -277,6 +292,7 @@ eng-lang-tutor/
 │   ├── cli/                    # 命令行模块
 │   │   ├── cli.py              # CLI 入口点
 │   │   └── command_parser.py   # 用户命令解析
+│   ├── setup.py                # 依赖安装脚本 (npm bin)
 │   ├── scheduling/             # 调度模块
 │   │   └── cron_push.py        # 定时内容推送
 │   ├── utils/                  # 工具模块

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rookiestar/eng-lang-tutor",
-  "version": "1.2.2",
+  "version": "1.2.5",
   "description": "地道美式英语导师 - OpenClaw Skill for learning authentic American English",
   "main": "scripts/cli/cli.py",
   "bin": {
@@ -29,11 +29,13 @@
   },
   "homepage": "https://github.com/rookiestar/Skills/tree/main/eng-lang-tutor#readme",
   "files": [
-    "**/*",
-    "!tests/**",
-    "!**/*.pyc",
-    "!**/__pycache__/**",
-    "!.DS_Store"
+    "scripts/",
+    "templates/",
+    "examples/",
+    "references/",
+    "SKILL.md",
+    "README.md",
+    "requirements.txt"
   ],
   "engines": {
     "node": ">=14.0.0"

package/scripts/audio/composer.py

@@ -87,9 +87,9 @@ class AudioComposer:
         lead_in_silence: float = 1.0,   # 引导语后留白
         section_silence: float = 2.0,   # 内容后留白（段落间隔）
         dialogue_silence: float = 0.5,  # 对话行之间留白
-        narrator_voice: str = "henry",  # 旁白音色（男声）
-        voice_a: str = "mary",          # 对话 A 音色（女声）
-        voice_b: str = "henry",         # 对话 B 音色（男声，沉稳）
+        narrator_voice: str = None,     # 旁白音色（None 时使用 TTS provider 默认值）
+        voice_a: str = None,            # 对话 A 音色（None 时使用 TTS provider 默认值）
+        voice_b: str = None,            # 对话 B 音色（None 时使用 TTS provider 默认值）
         speed: float = 0.9              # 语速
     ) -> CompositionResult:
         """
@@ -110,6 +110,11 @@ class AudioComposer:
             CompositionResult: 合成结果
         """
         try:
+            # 使用 TTS provider 的默认音色（自动适配 Edge-TTS 或讯飞）
+            narrator_voice = narrator_voice or self.tts.get_voice_by_role("narrator")
+            voice_a = voice_a or self.tts.get_voice_by_role("dialogue_a")
+            voice_b = voice_b or self.tts.get_voice_by_role("dialogue_b")
+
             output_path = Path(output_path)
             output_path.parent.mkdir(parents=True, exist_ok=True)
 
@@ -213,7 +218,7 @@ class AudioComposer:
                             if not text:
                                 continue
 
-                            # A = henry (男声), B = catherine (女声)
+                            # A = EricNeural (男声), B = JennyNeural (女声)
                             voice = voice_a if speaker.upper() == "A" else voice_b
 
                             segment = self._synthesize_segment(

package/scripts/core/state_manager.py

@@ -810,5 +810,8 @@ class StateManager:
 
 # CLI interface - delegated to cli.py for better code organization
 if __name__ == "__main__":
-    from cli import main
+    try:
+        from ..cli.cli import main
+    except ImportError:
+        from scripts.cli.cli import main
     main()

package/scripts/release.py

@@ -0,0 +1,255 @@
+#!/usr/bin/env python3
+"""
+Release Script - Manages file visibility across local repo, remote repo, and npm package.
+
+This script handles three layers:
+1. Local repo - All tracked files (managed by .gitignore)
+2. Remote repo - Public files only
+3. npm package - Minimal user-facing files
+
+Usage:
+    python3 scripts/release.py --check        # Show file distribution
+    python3 scripts/release.py --sync-remote  # Sync to remote (dry-run)
+    python3 scripts/release.py --npm-pack     # Create npm tarball
+"""
+
+import argparse
+import subprocess
+import json
+from pathlib import Path
+from typing import Set
+
+# Files/directories to EXCLUDE from remote repo (not publicly visible)
+REMOTE_EXCLUDE = {
+    "tests/",
+    "package.json",
+    "package-lock.json",
+    "bin/",
+    "scripts/setup.py",
+    ".gitignore",
+    ".gitattributes",
+    ".npmignore",
+    "*.egg-info/",
+    ".pytest_cache/",
+    "__pycache__/",
+    ".coverage",
+    "htmlcov/",
+    ".tox/",
+    ".nox/",
+    ".claude/",
+    "*.pyc",
+    "*.pyo",
+    "*.tgz",
+}
+
+# Files/directories to EXCLUDE from npm package (in addition to REMOTE_EXCLUDE)
+# npm package should be minimal - only what users need to run
+NPM_EXCLUDE = REMOTE_EXCLUDE | {
+    "CLAUDE.md",           # Development guide for Claude AI
+    "docs/",               # Internal documentation
+    "examples/",           # Sample files (not needed for runtime)
+    "references/",         # Reference materials
+    "*.md",                # All markdown except README.md
+}
+
+# Files that MUST be included in npm package
+NPM_INCLUDE = {
+    "README.md",           # Keep README for npm display
+    "package.json",        # Required for npm
+    "requirements.txt",    # Python dependencies
+    "scripts/",            # All scripts (excluding setup.py)
+    "templates/",          # Prompt templates
+    "SKILL.md",           # Skill documentation
+}
+
+
+def get_tracked_files() -> Set[str]:
+    """Get all files tracked by git."""
+    result = subprocess.run(
+        ["git", "ls-files"],
+        capture_output=True,
+        text=True,
+        cwd=Path(__file__).parent.parent
+    )
+    return set(result.stdout.strip().split("\n"))
+
+
+def should_exclude(path: str, exclude_patterns: Set[str]) -> bool:
+    """Check if a path should be excluded based on patterns."""
+    for pattern in exclude_patterns:
+        if pattern.endswith("/"):
+            if path.startswith(pattern) or "/" + pattern in path:
+                return True
+        elif pattern.startswith("*."):
+            if path.endswith(pattern[1:]):
+                return True
+        else:
+            if path == pattern or path.startswith(pattern + "/"):
+                return True
+    return False
+
+
+def categorize_files():
+    """Categorize files into local, remote, and npm groups."""
+    tracked = get_tracked_files()
+
+    local_only = set()
+    remote_files = set()
+    npm_files = set()
+
+    for file in tracked:
+        # Skip empty strings
+        if not file:
+            continue
+
+        # Check if in remote exclude list
+        if should_exclude(file, REMOTE_EXCLUDE):
+            local_only.add(file)
+        else:
+            remote_files.add(file)
+
+        # Check if should be in npm package
+        if should_exclude(file, NPM_EXCLUDE):
+            # Check if explicitly included
+            included = False
+            for inc_pattern in NPM_INCLUDE:
+                if inc_pattern.endswith("/"):
+                    if file.startswith(inc_pattern):
+                        included = True
+                        break
+                elif file == inc_pattern:
+                    included = True
+                    break
+
+            if included:
+                npm_files.add(file)
+        else:
+            npm_files.add(file)
+
+    return local_only, remote_files, npm_files
+
+
+def show_distribution():
+    """Show file distribution across three layers."""
+    local_only, remote_files, npm_files = categorize_files()
+
+    print("=" * 60)
+    print("FILE DISTRIBUTION ACROSS THREE LAYERS")
+    print("=" * 60)
+
+    print(f"\n📦 LOCAL REPO ONLY ({len(local_only)} files)")
+    print("-" * 40)
+    for f in sorted(local_only):
+        print(f"  {f}")
+
+    print(f"\n🌐 REMOTE REPO (public, {len(remote_files)} files)")
+    print("-" * 40)
+    for f in sorted(remote_files):
+        print(f"  {f}")
+
+    print(f"\n📦 NPM PACKAGE ({len(npm_files)} files)")
+    print("-" * 40)
+    for f in sorted(npm_files):
+        print(f"  {f}")
+
+    print("\n" + "=" * 60)
+    print(f"SUMMARY: Local={len(local_only) + len(remote_files)} | Remote={len(remote_files)} | npm={len(npm_files)}")
+    print("=" * 60)
+
+
+def create_gitattributes():
+    """Create .gitattributes with export-ignore for local-only files."""
+    eng_lang_tutor_dir = Path(__file__).parent.parent
+    gitattributes_path = eng_lang_tutor_dir / ".gitattributes"
+
+    # Patterns to exclude from git archive (remote export)
+    export_ignore_patterns = [
+        "tests/",
+        ".pytest_cache/",
+        "*.pyc",
+        "*.pyo",
+        ".coverage",
+        "htmlcov/",
+        ".tox/",
+        ".nox/",
+        ".claude/",
+        "*.egg-info/",
+        "*.tgz",
+    ]
+
+    content = "# Files to exclude from git archive export\n"
+    content += "# These files are tracked locally but not exported to remote archives\n\n"
+
+    for pattern in export_ignore_patterns:
+        content += f"{pattern} export-ignore\n"
+
+    gitattributes_path.write_text(content)
+    print(f"✓ Created {gitattributes_path}")
+    print("\nNote: This affects 'git archive' only.")
+    print("For selective push to remote, consider using a separate public branch.")
+
+
+def npm_pack():
+    """Create npm tarball with proper file filtering."""
+    eng_lang_tutor_dir = Path(__file__).parent.parent
+
+    # Update package.json files field for npm
+    package_json_path = eng_lang_tutor_dir / "package.json"
+
+    with open(package_json_path) as f:
+        package = json.load(f)
+
+    # Set files field to include only what we want
+    package["files"] = [
+        "scripts/",
+        "templates/",
+        "SKILL.md",
+        "README.md",
+        "requirements.txt",
+    ]
+
+    # Remove tests from npm package
+    if "!tests/**" in package.get("files", []):
+        pass  # Already excluded
+
+    print("npm pack would include:")
+    print(json.dumps(package.get("files", []), indent=2))
+
+    print("\nRun the following to create npm package:")
+    print(f"  cd {eng_lang_tutor_dir} && npm pack")
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="Manage file visibility across local repo, remote repo, and npm package"
+    )
+    parser.add_argument(
+        "--check",
+        action="store_true",
+        help="Show file distribution across three layers"
+    )
+    parser.add_argument(
+        "--create-gitattributes",
+        action="store_true",
+        help="Create .gitattributes with export-ignore rules"
+    )
+    parser.add_argument(
+        "--npm-pack",
+        action="store_true",
+        help="Show npm pack configuration"
+    )
+
+    args = parser.parse_args()
+
+    if args.check:
+        show_distribution()
+    elif args.create_gitattributes:
+        create_gitattributes()
+    elif args.npm_pack:
+        npm_pack()
+    else:
+        parser.print_help()
+
+
+if __name__ == "__main__":
+    main()

package/.claude/settings.local.json

@@ -1,22 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(python3 -m pytest:*)",
-      "Bash(pytest:*)",
-      "Bash(find:*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(git push)",
-      "mcp__brave-search__brave_web_search",
-      "mcp__web-search-prime__webSearchPrime",
-      "mcp__zread__get_repo_structure",
-      "mcp__zread__read_file",
-      "mcp__zread__search_doc",
-      "mcp__web-reader__webReader",
-      "WebSearch",
-      "mcp__fetch__fetch",
-      "Bash(wc:*)",
-      "Bash(python3 -m py_compile:*)"
-    ]
-  }
-}

package/.gitignore

@@ -1,32 +0,0 @@
-# Python
-__pycache__/
-*.py[cod]
-*$py.class
-*.so
-.Python
-.venv/
-venv/
-ENV/
-
-# IDE
-.idea/
-.vscode/
-*.swp
-*.swo
-
-# OS
-.DS_Store
-Thumbs.db
-
-# Backups
-backups/
-*.bak
-
-# User data
-data/state.json
-data/logs/
-data/daily/
-
-# npm
-node_modules/
-*.tgz

package/CHANGELOG.md

@@ -1,42 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-## [1.0.1] - 2025-02-27
-
-### Changed
-- Version bump for npm publishing (1.0.0 was previously unpublished)
-
-## [1.0.0] - 2025-02-26
-
-Initial release.
-
-### Added
-
-**Core Features:**
-- Daily knowledge points with authentic American English expressions
-- Quiz system with 4 question types (multiple choice, Chinglish fix, fill blank, dialogue completion)
-- Duolingo-style gamification (XP, levels 1-20, streaks, badges, gems)
-- Error notebook for tracking and reviewing mistakes
-- 14-day content deduplication
-
-**CEFR Support:**
-- Complete CEFR level definitions (A1-C2) with Can-Do Statements
-- 12 sample JSON files covering all 6 CEFR levels
-- Content difficulty adjusted by user's CEFR level
-
-**Audio:**
-- TTS audio generation (Edge-TTS default, XunFei optional)
-- Async audio generation with background threading
-- Context manager pattern for reliable temp file cleanup
-
-**Configuration:**
-- 7-step onboarding flow
-- Initialization guard check before content generation
-- Centralized configuration constants
-- Prompt version control via `_meta.prompt_version` field
-
-**Documentation:**
-- SKILL.md, README.md, CLAUDE.md
-- OpenClaw deployment guide
-- Prompt templates (keypoint generation, quiz generation, etc.)

package/CLAUDE.md

@@ -1,275 +0,0 @@
-# SKILL: eng-lang-tutor
-
-## 1. 项目目标
-
-本项目主要为Agent添加「地道美式英语导师」的Skill，配合Agent所在环境的cron job实现定期的知识推送与测验。
-
-### 1.1. 学习目标
-
-- 以提升地道的美式英语常用口语表达为主，兼顾听力与书面表达（正式场合）。
-- 避免传统的Chinglish的硬翻式尴尬表达。
-- 融入轻量游戏化教学，覆盖影视、新闻、游戏、体育、职场、社交、生活等用户感兴趣的场景来提升用户的粘性。
-
-### 1.2. 语言范围
-
-- 以美式英语为主，包含俚语、口头语、缩写（gonna, gotta, kinda 等），能帮助用户区分「正式 vs 口语」。
-
-### 1.3. 技能维度
-
-- 涉及词汇/短语、固定搭配、场景句型等口语与书面语中的表达方式。
-
-## 2. 项目范围
-
-### 2.1. MVP版本功能清单
-
-#### 2.1.1 导师模式
-
-Agent结合难度与偏好的设置，以及用户的历史学习进度动态生成并调整个性化的教学大纲与教学内容：
-
-| 功能 | 描述 | 频次 | 对应脚本 |
-|-----|------|-----|---------|
-| **知识点** | 地道美式英语日常沟通素材，包含场景、可替换说法、Chinglish陷阱+修正 | 每天 | state_manager.py |
-| **Quiz** | 3道轻量测验：1多选+1Chinglish修正+1随机（填空/对话）| 每天 | scorer.py |
-| **错题本** | 记录错误答案，支持手动添加，便于针对性复习 | 实时 | state_manager.py |
-
-**Quiz 结构：**
-
-| 题型 | 描述 | XP值 | 每日Quiz |
-|-----|------|-----|---------|
-| multiple_choice | 四选一，测试表达识别 | 10 | 1 (必选) |
-| chinglish_fix | 识别并修正Chinglish表达 | 15 | 1 (必选) |
-| fill_blank | 填空，完成对话 | 12 | 0-1 (随机) |
-| dialogue_completion | 选择合适的对话回应 | 15 | 0-1 (随机) |
-
-- **每日Quiz**: 3题，约37 XP，答对2题即过关
-
-#### 2.1.2 状态管理
-
-保障整个教学过程可备份、可追溯、可回滚：
-
-| 组件 | 文件 | 用途 |
-|-----|------|-----|
-| 核心状态 | state.json | streak/xp/偏好/近期主题/错题本 |
-| 事件日志 | logs/events_YYYY-MM.jsonl | 追加式事件流水账 |
-| 每日内容 | daily/YYYY-MM-DD/*.json | 知识点/Quiz/用户答案 |
-
-#### 2.1.3 成就体系（Duolingo风格）
-
-**双等级体系说明：**
-- **能力等级 (CEFR)**：A1-C2，决定内容难度，与 App 无关的绝对语言能力
-- **活跃等级 (Level)**：1-20，衡量 App 使用深度，通过 XP 累积升级
-
-| 活跃等级 | 阶段 | XP 需求 |
-|---------|------|---------|
-| 1-5 | 启程者 (Starter) | 0-350 |
-| 6-10 | 行路人 (Traveler) | 550-2000 |
-| 11-15 | 探索者 (Explorer) | 2600-6000 |
-| 16-20 | 开拓者 (Pioneer) | 7200-15000 |
-
-| 组件 | 描述 |
-|-----|------|
-| **XP & 等级** | 1-20级，XP累积升级（启程者 → 行路人 → 探索者 → 开拓者） |
-| **连胜系统** | 连续学习天数，支持连胜冻结（50宝石） |
-| **徽章系统** | First Steps、Week Warrior、Month Master、Perfect 10、Vocab Hunter、Error Slayer |
-| **宝石系统** | 用于购买连胜冻结、提示等 |
-
-**徽章详情：**
-
-| 徽章 | 触发条件 | 宝石奖励 |
-|-----|---------|---------|
-| First Steps | 完成首次Quiz | 10 |
-| Week Warrior | 7天连胜 | 25 |
-| Month Master | 30天连胜 | 100 |
-| Perfect 10 | 10次完美Quiz | 50 |
-| Vocab Hunter | 学习100个表达 | 75 |
-| Error Slayer | 清除30个错题 | 30 |
-
-#### 2.1.4 系统配置
-
-| 配置项 | 描述 | 默认值 |
-|-------|------|-------|
-| CEFR等级 | A1-C2语言级别 | B1 |
-| 口语/书面比例 | 口语表达占比 | 70% |
-| 主题配比 | movies/news/gaming/sports/workplace/social/daily_life | 各主题权重 |
-| 导师风格 | humorous/rigorous/casual/professional | humorous |
-| 去重天数 | 避免重复内容的时间窗口 | 14天 |
-
-**配置常量：** 集中定义于 `scripts/core/constants.py`（宝石消耗、XP值、超时阈值等）
-
-### 2.2. MVP版本不做 / 延后
-
-- **周周练**：5道综合性场景练习，覆盖本周知识点，约62 XP，答对3题即过关。计划周日推送。
-- **语音模式**：支持tts便于用户跟读，支持asr便于导师对口语表达进行打分。
-
-### 2.3. 项目约束
-
-**核心原则：别问"怎么翻译"，先问"这个场景美国人会怎么说"，会让你立刻更像美国人。**
-
-#### 2.3.1 输出格式约束
-
-- **必须输出合法 JSON**（不要 markdown，不要代码块，不要多余文本）
-- 所有输出必须符合 `templates/` 目录下的 JSON Schema
-
-#### 2.3.2 内容质量约束
-
-- 语言风格：**地道美式**、轻松、可用、短句为主
-- 每条知识点必须包含：**场景、可替换说法、Chinglish 陷阱 + 修正**
-- 包含发音提示（gonna, gotta, wanna 等自然发音）
-- 提供文化背景和使用场景说明
-
-#### 2.3.3 去重策略（14天窗口）
-
-使用 `scripts/utils/dedup.py` 实现三层去重：
-
-| 层级 | 方法 | 描述 |
-|-----|------|-----|
-| 1 | topic_fingerprint | 主题指纹匹配 |
-| 2 | 表达重叠 | 相同短语超过50%视为重复 |
-| 3 | 词根匹配 | 核心词汇结构相似 |
-
-#### 2.3.4 反直译原则
-
-- 优先给"美国人会怎么说"，而不是"中文怎么翻英文"
-- 参考 `references/resources.md` 中的主题资源库
-- 使用 `references/prompt_templates.md` 中的LLM提示模板
-
-## 3. 技术栈与SKILL结构
-
-### 3.1. 技术栈与输出格式
-
-- 技术栈：Python 3.x
-- 触发方式：cron 触发 Agent 调用 Skill
-
-### 3.2. 目录结构
-
-```
-eng-lang-tutor/
-├── SKILL.md                    # 核心技能文档
-├── CLAUDE.md                   # 项目说明（本文件）
-├── scripts/
-│   ├── __init__.py             # 包入口，重导出核心类
-│   ├── core/
-│   │   ├── state_manager.py    # 状态持久化与事件日志
-│   │   ├── error_notebook.py   # 错题本管理
-│   │   ├── scorer.py           # 答案评估与XP计算
-│   │   ├── gamification.py     # 连胜/等级/徽章
-│   │   └── constants.py        # 共享常量和工具函数
-│   ├── cli/
-│   │   ├── cli.py              # CLI入口点
-│   │   └── command_parser.py   # 命令解析
-│   ├── audio/
-│   │   ├── tts/                # TTS引擎（Coqui/Azure/Edge）
-│   │   ├── composer.py         # 音频合成
-│   │   ├── converter.py        # 格式转换
-│   │   ├── feishu_voice.py     # 飞书语音发送
-│   │   └── utils.py            # 音频工具函数
-│   ├── scheduling/
-│   │   └── cron_push.py        # 定时推送
-│   └── utils/
-│       ├── dedup.py            # 14天去重逻辑
-│       └── helpers.py          # 通用工具函数
-├── templates/
-│   ├── state_schema.json       # 状态 JSON Schema
-│   ├── keypoint_schema.json    # 知识点 JSON Schema
-│   └── quiz_schema.json        # Quiz JSON Schema
-├── references/
-│   ├── resources.md            # 主题化英语学习资源库
-│   └── prompt_templates.md     # LLM Prompt 模板
-├── examples/                   # 示例文件（按 CEFR 级别命名）
-│   ├── sample_keypoint_*.json  # 知识点示例 (a1-c2)
-│   └── sample_quiz_*.json      # Quiz示例 (a1-c2)
-└── (数据存储在外部目录)
-    ~/.openclaw/state/eng-lang-tutor/   # 实际数据存储位置
-    ├── state.json              # 运行时状态
-    ├── logs/
-    │   └── events_YYYY-MM.jsonl
-    └── daily/
-        └── YYYY-MM-DD/
-            ├── keypoint.json
-            ├── quiz.json
-            └── user_answers.json
-
-    注: 可通过 OPENCLAW_STATE_DIR 环境变量自定义存储位置
-```
-
-## 4. 功能切片实现
-
-### 4.1 功能切片与脚本对应
-
-| 切片 | 对应脚本 | 输入 | 输出 |
-|-----|---------|------|-----|
-| 状态加载/保存 | core/state_manager.py | - | state.json |
-| 事件日志 | core/state_manager.py | event_type, data | events_YYYY-MM.jsonl |
-| 每日内容保存 | core/state_manager.py | content_type, content | daily/YYYY-MM-DD/*.json |
-| 答案评估 | core/scorer.py | quiz.json + user_answers | results + updated state |
-| XP计算 | core/scorer.py | correct_count, streak | XP with multiplier |
-| 连胜更新 | core/gamification.py | study_date | new_streak |
-| 等级更新 | core/gamification.py | XP | level |
-| 徽章检查 | core/gamification.py | progress | new_badges |
-| 去重检查 | utils/dedup.py | new_content, recent_content | is_duplicate |
-| 异步音频生成 | core/state_manager.py | keypoint.json | audio/*.mp3 |
-
-### 4.2 核心工作流
-
-#### 4.2.1 每日知识点生成
-
-```
-1. state_manager.load_state()
-2. dedup.get_excluded_topics(state)
-3. LLM生成知识点（使用prompt_templates.md）
-4. dedup.check_duplicate(new_content, recent_content)
-5. 验证JSON Schema
-6. state_manager.save_daily_content('keypoint', content)
-7. state_manager.append_event('keypoint_generated', {...})
-```
-
-#### 4.2.2 Quiz评估流程
-
-```
-1. state_manager.load_daily_content('quiz')
-2. 读取 user_answers.json
-3. scorer.evaluate_quiz(quiz, answers, state)
-4. gamification.update_streak(state, today)
-5. gamification.update_level(state)
-6. gamification.check_badges(state)
-7. state_manager.save_state(state)
-8. state_manager.append_event('quiz_completed', results)
-```
-
-## 5. 开发准则
-
-### 5.1 Skill文档规范
-
-- SKILL.md文档要详细但不能过长，聚焦核心步骤，细节可以放在代码示例里。建议**800-1500 tokens**。
-- Skills 必须包含可执行的步骤、代码示例、验证检查点。
-- 设计 Skills 时考虑复用性（模块化）。一个 Skill 解决一类问题，不是一次性的硬编码。
-
-### 5.2 确定性验证器
-
-每个任务都有**确定性验证器**（deterministic verifier）：这不是用 LLM 评判，而是程序化断言。
-
-| 验证项 | 验证方法 | 对应工具 |
-|-------|---------|---------|
-| JSON格式 | json.loads() | Python标准库 |
-| JSON Schema | schema validation | templates/*.json |
-| XP计算 | 公式验证 | scorer.py |
-| 连胜更新 | 日期比较 | gamification.py |
-| 去重检查 | 指纹/表达匹配 | dedup.py |
-
-### 5.3 聚焦核心路径
-
-不要过度工程化：比如应该聚焦 80% 场景的核心路径，而非覆盖尽可能多的edge cases。
-
-### 5.4 可复用资源
-
-| 资源 | 位置 | 用途 |
-|-----|------|-----|
-| skill-creator | github.com/anthropics/skills | 自动生成skill骨架 |
-| awesome-language-learning | github.com/Vuizur/awesome-language-learning | 语言学习工具集合 |
-| 主题资源库 | references/resources.md | 美剧/新闻/游戏/体育/职场/生活 |
-| LLM提示模板 | references/prompt_templates.md | 知识点/Quiz生成模板 |
-
-### 5.5 行动准则
-
-- 未经允许不得擅自执行git commit、push和publish等相关动作
-- 针对耗费较长时间做debug或者反复掉坑的情况，需要及时总结复盘，并将经验精炼到本文档中

package/bin/eng-lang-tutor.js

@@ -1,177 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * eng-lang-tutor CLI
- *
- * Commands:
- *   install   - Install the skill to ~/.openclaw/skills/eng-lang-tutor/
- *   uninstall - Remove the skill from ~/.openclaw/skills/eng-lang-tutor/
- */
-
-const path = require('path');
-const fs = require('fs');
-const os = require('os');
-
-const SKILL_NAME = 'eng-lang-tutor';
-const SKILLS_DIR = path.join(os.homedir(), '.openclaw', 'skills');
-const SKILL_TARGET = path.join(SKILLS_DIR, SKILL_NAME);
-
-// Get the package root directory (where package.json is)
-const PACKAGE_ROOT = path.resolve(__dirname, '..');
-
-function getSkillSourceDir() {
-  return PACKAGE_ROOT;
-}
-
-function install() {
-  console.log(`Installing ${SKILL_NAME} skill...`);
-
-  const sourceDir = getSkillSourceDir();
-
-  // Check if source directory exists
-  if (!fs.existsSync(sourceDir)) {
-    console.error(`Error: Source directory not found: ${sourceDir}`);
-    process.exit(1);
-  }
-
-  // Create skills directory if it doesn't exist
-  if (!fs.existsSync(SKILLS_DIR)) {
-    fs.mkdirSync(SKILLS_DIR, { recursive: true });
-    console.log(`Created skills directory: ${SKILLS_DIR}`);
-  }
-
-  // Remove existing installation if present
-  if (fs.existsSync(SKILL_TARGET)) {
-    console.log(`Removing existing installation at ${SKILL_TARGET}...`);
-    fs.rmSync(SKILL_TARGET, { recursive: true, force: true });
-  }
-
-  // Create target directory
-  fs.mkdirSync(SKILL_TARGET, { recursive: true });
-
-  // Files and directories to copy
-  const itemsToCopy = [
-    'scripts',
-    'templates',
-    'references',
-    'examples',
-    'docs',
-    'SKILL.md',
-    'CLAUDE.md',
-    'README.md',
-    'README_EN.md',
-    'requirements.txt'
-  ];
-
-  // Copy each item
-  for (const item of itemsToCopy) {
-    const sourcePath = path.join(sourceDir, item);
-    const targetPath = path.join(SKILL_TARGET, item);
-
-    if (!fs.existsSync(sourcePath)) {
-      console.log(`  Skipping ${item} (not found)`);
-      continue;
-    }
-
-    try {
-      if (fs.statSync(sourcePath).isDirectory()) {
-        copyDir(sourcePath, targetPath);
-      } else {
-        fs.copyFileSync(sourcePath, targetPath);
-      }
-      console.log(`  Copied ${item}`);
-    } catch (err) {
-      console.error(`  Error copying ${item}: ${err.message}`);
-    }
-  }
-
-  console.log(`\n✓ ${SKILL_NAME} installed to ${SKILL_TARGET}`);
-  console.log('\nNext steps:');
-  console.log('  1. Install Python dependencies:');
-  console.log(`     pip install -r ${SKILL_TARGET}/requirements.txt`);
-  console.log('  2. Restart your OpenClaw agent');
-  console.log('  3. Configure the skill through the onboarding flow');
-}
-
-function uninstall() {
-  console.log(`Uninstalling ${SKILL_NAME} skill...`);
-
-  if (!fs.existsSync(SKILL_TARGET)) {
-    console.log(`${SKILL_NAME} is not installed.`);
-    return;
-  }
-
-  try {
-    fs.rmSync(SKILL_TARGET, { recursive: true, force: true });
-    console.log(`✓ ${SKILL_NAME} removed from ${SKILL_TARGET}`);
-    console.log('\nNote: Your learning data is preserved at:');
-    console.log('  ~/.openclaw/state/eng-lang-tutor/');
-    console.log('\nTo completely remove all data, run:');
-    console.log('  rm -rf ~/.openclaw/state/eng-lang-tutor');
-  } catch (err) {
-    console.error(`Error uninstalling: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-function copyDir(src, dest) {
-  fs.mkdirSync(dest, { recursive: true });
-
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-function showHelp() {
-  console.log(`
-eng-lang-tutor - English Language Tutor Skill for OpenClaw
-
-Usage:
-  eng-lang-tutor <command>
-
-Commands:
-  install     Install the skill to ~/.openclaw/skills/eng-lang-tutor/
-  uninstall   Remove the skill (preserves learning data)
-  help        Show this help message
-
-Environment Variables:
-  OPENCLAW_STATE_DIR  Custom directory for learning data
-                      (default: ~/.openclaw/state/eng-lang-tutor)
-
-Examples:
-  eng-lang-tutor install
-  eng-lang-tutor uninstall
-`);
-}
-
-// Main
-const command = process.argv[2];
-
-switch (command) {
-  case 'install':
-    install();
-    break;
-  case 'uninstall':
-    uninstall();
-    break;
-  case 'help':
-  case '--help':
-  case '-h':
-    showHelp();
-    break;
-  default:
-    if (command) {
-      console.error(`Unknown command: ${command}`);
-    }
-    showHelp();
-    process.exit(command ? 1 : 0);
-}

package/docs/OPENCLAW_DEPLOYMENT.md

@@ -1,241 +0,0 @@
-# OpenClaw 部署指南
-
-本文档说明如何将 `eng-lang-tutor` skill 部署到 OpenClaw 服务器，并通过 Discord 等渠道使用。
-
-## 1. 前置条件
-
-- 一台已安装 OpenClaw 的服务器
-- OpenClaw Gateway 正在运行
-- 已配置好 Discord Bot（可选其他渠道）
-
-## 2. 部署步骤
-
-### 2.1 上传 Skill 到服务器
-
-**方式 A：使用 SCP 上传**
-
-```bash
-# 在本地机器上执行
-scp -r /path/to/eng-lang-tutor user@your-server:~/.openclaw/skills/
-```
-
-**方式 B：使用 Git Clone**
-
-```bash
-# 在服务器上执行
-cd ~/.openclaw/skills/
-git clone https://github.com/rookiestar/eng-lang-tutor.git
-```
-
-### 2.2 确认目录结构
-
-确保目录结构如下：
-
-```
-~/.openclaw/skills/eng-lang-tutor/
-├── SKILL.md              # 核心技能文件（必需）
-├── scripts/              # Python 脚本
-│   ├── core/             # 核心模块
-│   │   ├── state_manager.py
-│   │   ├── scorer.py
-│   │   ├── gamification.py
-│   │   ├── constants.py
-│   │   └── error_notebook.py
-│   ├── cli/              # 命令行模块
-│   ├── scheduling/       # 调度模块
-│   ├── utils/            # 工具模块
-│   └── audio/            # 音频模块
-├── templates/            # JSON Schema + Prompt 模板
-├── references/           # 参考资源
-├── examples/             # 示例文件（按 CEFR 级别）
-└── (数据存储在外部目录)
-    ~/.openclaw/state/eng-lang-tutor/  # 运行时数据（自动创建）
-```
-
-### 2.3 验证 Skill 加载
-
-```bash
-# 查看已加载的 skills
-openclaw skills list
-
-# 查看特定 skill 详情
-openclaw skills info eng-lang-tutor
-```
-
-## 3. 配置 Discord 渠道
-
-### 3.1 创建 Discord Bot
-
-1. 访问 [Discord Developer Portal](https://discord.com/developers/applications)
-2. 创建新应用，命名为你的 Bot
-3. 进入 Bot 页面，创建 Bot 并获取 Token
-4. 启用 Message Content Intent
-
-### 3.2 配置 OpenClaw
-
-```bash
-# 设置 Discord Token
-openclaw config set discord.token YOUR_BOT_TOKEN
-
-# 设置服务器 ID（可选）
-openclaw config set discord.guildId YOUR_SERVER_ID
-```
-
-### 3.3 邀请 Bot 到服务器
-
-1. 在 Discord Developer Portal 中，进入 OAuth2 > URL Generator
-2. 选择 `bot` 和 `applications.commands` scope
-3. 选择所需权限（Send Messages, Read Messages 等）
-4. 复制生成的邀请链接并在浏览器中打开
-5. 选择要添加 Bot 的服务器
-
-### 3.4 完成配对
-
-首次与 Bot 对话时，会收到配对码：
-
-```bash
-# 在服务器上执行配对
-openclaw pairing approve discord YOUR_PAIRING_CODE
-```
-
-## 4. 使用 Skill
-
-### 4.1 通过 Discord 使用
-
-在 Discord 中与 Bot 对话，触发英语学习功能：
-
-```
-# 触发今日知识点
-今天有什么英语知识点？
-
-# 触发 Quiz
-给我出个 Quiz
-
-# 查看学习进度
-我的学习进度怎么样？
-```
-
-### 4.2 设置定时推送（cron）
-
-```bash
-# 编辑 crontab
-crontab -e
-
-# 添加每日定时推送
-# 早上 6:45 推送知识点
-45 6 * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's keypoint." --mode now
-
-# 晚上 22:45 推送 Quiz
-45 22 * * * openclaw system event --text "Use eng-lang-tutor skill. Push today's quiz invitation." --mode now
-```
-
-## 5. 进阶配置
-
-### 5.1 配置用户偏好
-
-在 Discord 中与 Bot 对话设置：
-
-```
-设置我的 CEFR 等级为 B2
-我的导师风格设为严谨
-调整主题配比，增加职场内容的比例
-```
-
-### 5.2 配置环境变量
-
-在服务器上设置 API 密钥（如果使用外部 LLM）：
-
-```bash
-# 编辑 OpenClaw 配置
-openclaw config set model.provider anthropic
-openclaw config set model.api_key YOUR_API_KEY
-```
-
-### 5.3 数据持久化
-
-数据存储在 `~/.openclaw/state/eng-lang-tutor/` 目录，确保有正确的写入权限：
-
-```bash
-chmod -R 755 ~/.openclaw/state/eng-lang-tutor/
-```
-
-可通过环境变量 `OPENCLAW_STATE_DIR` 自定义数据目录。
-
-## 6. 故障排查
-
-### 6.1 Skill 未加载
-
-```bash
-# 检查 skill 目录
-ls -la ~/.openclaw/skills/eng-lang-tutor/
-
-# 检查 SKILL.md 是否存在
-cat ~/.openclaw/skills/eng-lang-tutor/SKILL.md
-
-# 重启 Gateway
-openclaw gateway restart
-```
-
-### 6.2 Discord 无响应
-
-```bash
-# 检查 Gateway 日志
-openclaw logs
-
-# 验证 Discord Token
-openclaw config get discord.token
-
-# 检查 Bot 状态
-openclaw doctor
-```
-
-### 6.3 Python 脚本错误
-
-```bash
-# 检查 Python 环境
-python3 --version
-
-# 安装依赖（如有需要）
-pip3 install -r ~/.openclaw/skills/eng-lang-tutor/requirements.txt
-
-# 手动测试脚本
-cd ~/.openclaw/skills/eng-lang-tutor/
-python3 -m scripts.cli.cli stats
-```
-
-## 7. 架构图
-
-```
-┌─────────────────────────────────────────────────────────┐
-│                      Discord                            │
-│                    (用户交互)                            │
-└─────────────────────────┬───────────────────────────────┘
-                          │
-                          ▼
-┌─────────────────────────────────────────────────────────┐
-│                 OpenClaw Gateway                        │
-│              (消息路由 + 会话管理)                        │
-└─────────────────────────┬───────────────────────────────┘
-                          │
-                          ▼
-┌─────────────────────────────────────────────────────────┐
-│               eng-lang-tutor Skill                      │
-│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐    │
-│  │ SKILL.md    │  │ scripts/    │  │ ~/.openclaw │    │
-│  │ (技能描述)   │  │ (Python代码) │  │ (状态存储)   │    │
-│  └─────────────┘  └─────────────┘  └─────────────┘    │
-└─────────────────────────────────────────────────────────┘
-                          │
-                          ▼
-┌─────────────────────────────────────────────────────────┐
-│                    LLM Provider                         │
-│              (Claude/GPT/Qwen 等)                       │
-└─────────────────────────────────────────────────────────┘
-```
-
-## 8. 参考链接
-
-- [OpenClaw 官方文档](https://docs.openclaw.ai)
-- [OpenClaw GitHub](https://github.com/openclaw/openclaw)
-- [Discord 开发者门户](https://discord.com/developers/applications)
-- [OpenClaw Skills 开发指南](https://docs.openclaw.ai/skills)