@rookiestar/eng-lang-tutor 1.0.8 → 1.0.10

package/SKILL.md

@@ -275,11 +275,43 @@ The bot recognizes these natural language commands:
 Step 1: LLM generates keypoint JSON
 Step 2: ⛔ EXECUTE THIS BASH COMMAND (do NOT skip):
         python3 scripts/state_manager.py save_daily --content-type keypoint --content '<ESCAPED_JSON>'
+        (This auto-generates audio and saves to audio/YYYY-MM-DD/keypoint_full.mp3)
 Step 3: ⛔ EXECUTE THIS BASH COMMAND (do NOT skip):
         python3 scripts/state_manager.py record_view
-Step 4: Display formatted content to user
+Step 4: Send audio file via message tool (if audio exists):
+        - Read keypoint.json and check if audio.composed field exists
+        - If exists, send audio file using message tool with media parameter
+        - Audio path: ~/.openclaw/state/eng-lang-tutor/{audio.composed}
+Step 5: Display formatted content to user
 ```
 
+### Audio File Sending (After Keypoint Save)
+
+When keypoint is saved, audio is auto-generated. Send it to user:
+
+```
+1. Check keypoint.json for audio field:
+   cat ~/.openclaw/state/eng-lang-tutor/daily/YYYY-MM-DD/keypoint.json | grep -o '"audio":{[^}]*}'
+
+2. If audio exists, send via message tool:
+   {
+     "action": "send",
+     "media": "~/.openclaw/state/eng-lang-tutor/audio/YYYY-MM-DD/keypoint_full.mp3",
+     "caption": "🔊 今日知识点语音版"
+   }
+
+3. Audio file info is stored in keypoint.json:
+   {
+     "audio": {
+       "composed": "audio/2026-02-23/keypoint_full.mp3",
+       "duration_seconds": 37.7,
+       "generated_at": "2026-02-23T02:20:14"
+     }
+   }
+```
+
+**IMPORTANT:** Always send audio file BEFORE displaying text content, so user receives audio first.
+
 ### After Quiz Generation (MANDATORY)
 ```
 Step 1: LLM generates quiz JSON

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rookiestar/eng-lang-tutor",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "English language tutor skill for OpenClaw - Learn authentic American English expressions with gamification",
   "keywords": [
     "english",

package/scripts/state_manager.py

@@ -324,19 +324,7 @@ class StateManager:
                         'duration_seconds': audio_result.get('duration_seconds'),
                         'generated_at': datetime.now().isoformat()
                     }
-                    # Inject [AUDIO:...] tag for Gateway to send voice message
-                    audio_tag = f"[AUDIO:{audio_path}]"
-                    if 'display' in content:
-                        if isinstance(content['display'], dict):
-                            # Add audio tag to footer if display is an object
-                            footer = content['display'].get('footer', '')
-                            if audio_tag not in footer:
-                                content['display']['footer'] = f"{audio_tag}\n{footer}" if footer else audio_tag
-                        elif isinstance(content['display'], str):
-                            # Append to display if it's a string
-                            if audio_tag not in content['display']:
-                                content['display'] = f"{audio_tag}\n\n{content['display']}"
-                    # Re-save with audio info and display update
+                    # Re-save with audio info
                     with open(file_path, 'w', encoding='utf-8') as f:
                         json.dump(content, f, ensure_ascii=False, indent=2)
             except Exception as e:
@@ -407,19 +395,6 @@ class StateManager:
                     'generated_at': datetime.now().isoformat()
                 }
 
-                # Inject [AUDIO:...] tag for Gateway to send voice message
-                audio_tag = f"[AUDIO:{audio_path}]"
-                if 'display' in keypoint:
-                    if isinstance(keypoint['display'], dict):
-                        # Add audio tag to footer if display is an object
-                        footer = keypoint['display'].get('footer', '')
-                        if audio_tag not in footer:
-                            keypoint['display']['footer'] = f"{audio_tag}\n{footer}" if footer else audio_tag
-                    elif isinstance(keypoint['display'], str):
-                        # Append to display if it's a string
-                        if audio_tag not in keypoint['display']:
-                            keypoint['display'] = f"{audio_tag}\n\n{keypoint['display']}"
-
                 # Save updated keypoint
                 daily_path = self.get_daily_dir(target_date)
                 file_path = daily_path / "keypoint.json"