Screenshot Analyzer
Analyze screenshots for error diagnosis or operation tutorial generation.
Modes
- Analyze: Detect errors, identify causes, suggest solutions
- Tutorial: Generate step-by-step operation guides with annotations
Usage
# Error analysis (default)
python scripts/analyze.py "{screenshot}" --mode analyze
# Tutorial generation
python scripts/analyze.py "{screenshot}" --mode tutorial
Parameters
| Parameter | Required | Default | Description |
|---|---|---|---|
| screenshot | Yes | - | Path to screenshot |
| --mode, -m | No | analyze | Mode: analyze or tutorial |
| --output, -o | No | auto | Output HTML path |
| --no-annotate | No | false | Skip annotation generation |
Output
Analyze Mode
- Screen description
- Error detection (message, type, location)
- Root cause analysis
- Solution suggestions (NextStep)
Tutorial Mode
- Screen overview
- Numbered operation steps
- Annotated screenshots per step
- Tips and warnings
Examples
# Analyze error screenshot
python scripts/analyze.py "error_console.png"
# Generate tutorial
python scripts/analyze.py "settings_menu.png" --mode tutorial
# Specify output
python scripts/analyze.py "login.png" --mode tutorial --output "docs/login_guide.html"
# Skip annotations
python scripts/analyze.py "error.png" --no-annotate
Requirements
- GEMINI_API_KEY or GOOGLE_API_KEY in environment
- Python packages: google-genai, Pillow, python-dotenv