chore: adjust wording in instruction and use lowercase for releases

Author: Mtrya

.github/workflows/release.yml

@@ -70,25 +70,25 @@ jobs:
     - name: Create portable package (Linux)
       if: matrix.os == 'ubuntu-latest'
       run: |
-        mkdir -p dist/Echo-Portable
-        cp dist/Echo dist/Echo-Portable/
-        chmod +x dist/Echo dist/Echo-Portable/Echo
-        cp README.md dist/Echo-Portable/ 2>/dev/null || true
+        mkdir -p dist/echo-portable
+        cp dist/echo dist/echo-portable/
+        chmod +x dist/echo dist/echo-portable/echo
+        cp README.md dist/echo-portable/ 2>/dev/null || true
 
     - name: Create portable package (Windows)
       if: matrix.os == 'windows-latest'
       run: |
-        mkdir -p dist/Echo-Portable
-        copy dist\Echo.exe dist\Echo-Portable\
-        copy README.md dist\Echo-Portable\ 2>nul || echo README.md not found
+        mkdir -p dist/echo-portable
+        copy dist\echo.exe dist\echo-portable\
+        copy README.md dist\echo-portable\ 2>nul || echo README.md not found
 
     - name: Upload artifacts
       uses: actions/upload-artifact@v4
       with:
         name: build-${{ matrix.os }}
         path: |
-          dist/Echo*
-          dist/Echo-Portable/**
+          dist/echo*
+          dist/echo-portable/**
         retention-days: 1
 
   release:

CLAUDE.md

@@ -10,7 +10,7 @@ Simple, straightforward exam simulation platform for 10-year-old Chinese student
 - **Subjects**: English + Math (mixed exams)
 - **Timeline**: Full implementation in 2 weeks
 - **Scope**: Simple, focused, no unnecessary complexity
-- **Deployment**: Local development → Windows .exe via PyInstaller
+- **Deployment**: Local development → Windows echo.exe via PyInstaller
 - **Motivation**: A friend of the user asks me to develop this for his kid.
 
 ## Tech Stack
@@ -206,6 +206,8 @@ echo/
 │   ├── main.py              # FastAPI app with all endpoints
 │   ├── models.py            # Pydantic models for data validation
 │   ├── omni_client.py       # Unified LLM client for all AI processing
+│   ├── config.py            # Configuration management with AppData support
+│   ├── paths.py             # Centralized path management for cross-platform
 │   ├── file_conversion.py   # File processing and exam creation
 │   └── exam_logic.py        # Session management and state tracking
 ├── frontend/                # ✅ COMPLETED
@@ -222,6 +224,7 @@ echo/
 │       │   ├── QuickResponse.vue  # Quick response questions
 │       │   ├── ReadAloud.vue      # Read aloud practice
 │       │   ├── Results.vue        # Exam results display
+│       │   ├── Settings.vue       # Settings management
 │       │   └── Translation.vue    # Translation questions
 │       ├── App.vue          # Main application component
 │       ├── main.js          # Application entry point
@@ -234,6 +237,8 @@ echo/
 ├── audio_cache/             # Generated audio files cache
 │   ├── student_answers/     # Student audio recordings by session
 │   └── tts/                 # Text-to-speech cache
+├── build.py                 # PyInstaller build script
+├── launch.py                # Application launcher
 ├── .env                     # Environment variables
 ├── .gitignore               # Git ignore rules
 ├── .python-version          # Python version specification
@@ -250,3 +255,11 @@ echo/
 - Don't ever return mock data. If there's an error, let it expose naturally instead of pretending that everything is working all right.
 - Always check API_DOCUMENTATION.md when implementing frontend services.
 - try-except blocks are **FORBIDDEN**.
+
+## todos
+
+- complete README.md
+- update frontend/API_DOCUMENTATION.md
+- enhance file-conversion prompt with examples
+- user-friendly guide for fresh start
+- wording

backend/file_conversion.py

@@ -176,8 +176,8 @@ def _generate_yaml_content(self, original_filenames: List[str], questions: List[
                         "tts": "For read aloud questions, you should read displayed English sentences aloud"
                     },
                     "multiple_choice": {
-                        "text": "For multiple choice questions, read the question carefully and choose the best answer from A, B, C or D.",
-                        "tts": "For multiple choice questions, read the question carefully and choose the best answer from A, B, C or D"
+                        "text": "For multiple choice questions, read the question carefully and choose the best answer from A, B, C and D.",
+                        "tts": "For multiple choice questions, read the question carefully and choose the best answer from A, B, C and D"
                     },
                     "quick_response": {
                         "text": "For quick response questions, you will hear a question and respond by speaking. Listen carefully and answer clearly.",

build.py

@@ -121,7 +121,7 @@ def build_executable():
         return False
 
     # Check if executable was created
-    executable_path = dist_dir / "Echo.exe" if os.name == 'nt' else dist_dir / "Echo"
+    executable_path = dist_dir / "echo.exe" if os.name == 'nt' else dist_dir / "echo"
     if not executable_path.exists():
         print("❌ Executable not created")
         return False
@@ -134,7 +134,7 @@ def create_portable_package():
     print("\nCreating portable package...")
 
     dist_dir = Path("dist")
-    portable_dir = dist_dir / "Echo-Portable"
+    portable_dir = dist_dir / "echo-portable"
 
     # Clean previous portable package
     if portable_dir.exists():
@@ -143,7 +143,7 @@ def create_portable_package():
     portable_dir.mkdir(parents=True)
 
     # Copy executable
-    executable_name = "Echo.exe" if os.name == 'nt' else "Echo"
+    executable_name = "echo.exe" if os.name == 'nt' else "echo"
     executable_path = dist_dir / executable_name
     shutil.copy2(executable_path, portable_dir / executable_name)
 
@@ -155,11 +155,11 @@ def create_portable_package():
 
     # Create a simple batch file for Windows
     if os.name == 'nt':
-        batch_file = portable_dir / "Start Echo.bat"
+        batch_file = portable_dir / "Start echo.bat"
         with open(batch_file, 'w') as f:
             f.write('@echo off\n')
-            f.write('echo Starting Echo...\n')
-            f.write('start "" "%~dp0Echo.exe"\n')
+            f.write('echo Starting echo...\n')
+            f.write('start "" "%~dp0echo.exe"\n')
 
     print(f"✅ Portable package created: {portable_dir}")
     return True
@@ -193,8 +193,8 @@ def main():
     print("🎉 Build completed successfully!")
     print("="*50)
     print("Output files:")
-    print("  • Executable: dist/Echo.exe")
-    print("  • Portable package: dist/Echo-Portable/")
+    print("  • Executable: dist/echo.exe" if os.name == 'nt' else "  • Executable: dist/echo")
+    print("  • Portable package: dist/echo-Portable/")
     print("\nTo test the application:")
     print("  1. Run the executable directly")
     print("  2. Or extract the portable package and run from there")

echo.spec

@@ -79,7 +79,7 @@ exe = EXE(
     a.zipfiles,
     a.datas,
     [],
-    name='Echo',
+    name='echo',
     debug=False,
     bootloader_ignore_signals=False,
     strip=False,

exams/exam-2098.yaml

@@ -8,8 +8,8 @@ exam:
       tts: "For read aloud questions, you should read displayed English sentences aloud"
 
     multiple_choice:
-      text: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C or D."
-      tts: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C or D"
+      text: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C and D."
+      tts: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C and D"
 
     quick_response:
       text: "For quick response questions, you will hear a question and respond by speaking. Listen carefully and answer clearly."

exams/exam-2099.yaml

@@ -8,8 +8,8 @@ exam:
       tts: "For read aloud questions, you should read displayed English sentences aloud"
 
     multiple_choice:
-      text: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C or D."
-      tts: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C or D"
+      text: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C and D."
+      tts: "For multiple choice questions, read the question carefully and choose the best answer from A, B, C and D"
 
     quick_response:
       text: "For quick response questions, you will hear a question and respond by speaking. Listen carefully and answer clearly."