284 lines
9.7 KiB
Markdown
284 lines
9.7 KiB
Markdown
# 🌲 Crumbforest Missions - CF_Zero_V1
|
|
|
|
Ein interaktives Bash-Lern-System mit 17 KI-gestützten Waldwächtern für spielerisches Command-Line-Training und Roboter-Projekte.
|
|
|
|
**"Was kostet die Frage eines Kindes?"** - Transparentes Token-Tracking nach dem Crumb Codex: Fragen stärken Krümel & Wurzel.
|
|
|
|
## 🚀 Quick Start
|
|
|
|
```bash
|
|
# Mission Selector starten
|
|
./crumb-mission-selector.sh
|
|
|
|
# Einzelne Mission ausführen
|
|
bash missions/basics/fridolin.sh
|
|
|
|
# Robots Mission (neu!)
|
|
bash missions/robots/mond_maschine.sh
|
|
```
|
|
|
|
## 🤖 Robots-Kategorie ⭐ NEU!
|
|
|
|
Drei komplette Missionen zum Roboter-Bauen mit der ganzen Crew:
|
|
|
|
### 🔋 LiPo Power Academy
|
|
"Power braucht Respekt, nicht Angst"
|
|
- 8 Phasen: Grundlagen → Sicherheit → Power-Verteilung
|
|
- Lerne alles über LiPo-Batterien für Roboter-Projekte
|
|
- 6 Waldwächter: CapaciTobi, CrabbyRust, Schnecki, Schraubbär, DumboSQL, Vektor
|
|
- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html)
|
|
- ⚠️ **Sicherheitshinweis:** Lern- und Simulationskonzept. Arbeiten mit echten LiPo-Akkus nur unter Aufsicht erfahrener Erwachsener.
|
|
|
|
### 🌈 Regenbogen-Zählmaschine
|
|
"Etwas bauen was noch keiner gebaut hat - sonst muss man es ja nur reparieren!"
|
|
- 7 Phasen: Vision → Hardware → Code → Art
|
|
- Baue einen Farb-Event-Counter mit Sensor, Code & Visualisierung
|
|
- 13 Waldwächter: Die komplette Crew!
|
|
- Hardware + Software + Creative Coding
|
|
|
|
### 🌙 Mond Maschine - Rainbow Predictor
|
|
"Vorhersagen heißt verstehen - Die Natur durch Code begreifen"
|
|
- 8 Phasen: Computer Vision → ML → Astronomie
|
|
- Predict when rainbows appear using moon phases & weather data
|
|
- 13 Waldwächter: Computer Vision, APIs, ML Light
|
|
- OpenCV + Weather APIs + Astronomical calculations
|
|
- Bonus: Learn about Lunar Rainbows! 🌙🌈
|
|
|
|
### ☀️ Solar Wasserkocher
|
|
"Physik ist der Algorithmus der Natur"
|
|
- 6 Phasen: Energie → Schleifen → Optimierung
|
|
- Simuliere einen solargetriebenen Wasserkocher mit Physik-Engine
|
|
- 3 Waldwächter: CapaciTobi, Schnecki, FunkFox
|
|
- Lerne: Variablen, While-Loops und Energie-Management ($E = c \cdot m \cdot \Delta T$)
|
|
|
|
## 📚 Features
|
|
|
|
- **Interaktive Lernmissionen** - Von Basics bis Advanced & Robots
|
|
- **17 Waldwächter** - KI-Assistenten mit Persönlichkeit (siehe unten)
|
|
- **Das Dreieck** - DumboSQL, FunkFox, Taichi Taube (didaktisches Modell, nicht technisches Modul)
|
|
- **Metadata-driven** - Neue Missionen ohne Code-Änderungen hinzufügen
|
|
- **Token-Tracking** - Transparent: "Was kostet die Frage eines Kindes?"
|
|
- **Crew Memory** - Log-basiertes Gedächtnis (dateibasiert, nachvollziehbar, kein autonomes Agentensystem)
|
|
- **Logs im Repo** - Strukturiert in `logs/{character}/`
|
|
|
|
## 🌲 Die 17 Waldwächter
|
|
|
|
### 🔺 Das Dreieck (Foundation)
|
|
- **🐘 DumboSQL** - Der nie vergessende Elefant (SQL & Daten)
|
|
- **🦊 FunkFox** - Der Bash Rapper (Terminal-Flow mit Beat)
|
|
- **🕊️ Taichi Taube** - Die Balance-Bringerin (Spirale & Ordnung)
|
|
|
|
### 🔧 Hardware-Team
|
|
- **🐿️ CapaciTobi** - Kondensator-Experte (Elektronik & Power)
|
|
- **🐌 Schnecki** - Verkabelungs-Guru (langsam & präzise)
|
|
- **🐻 Schraubbär** - Mechanik-Meister (schweres Gerät)
|
|
|
|
### 💻 Code-Team
|
|
- **🐍 SnakePy** - Python-Guide (mehrere Wege zeigen)
|
|
- **🧓 PepperPHP** - Structure Mentor (MVC wie ein Rezept)
|
|
- **🦀 CrabbyRust** - Security Guardian (Memory-safe)
|
|
- **🕷️ Spider** - Network Feeler (APIs & Verbindungen)
|
|
|
|
### 🎨 UI-Team
|
|
- **✂️ Schnippsi** - CSS & Styling (alles schick machen)
|
|
- **📄 Templatus** - Template-Master (HTML-Struktur)
|
|
- **👾 ASCII-Monster** - Terminal Artist (ASCII-Art)
|
|
|
|
### 🧭 System-Team
|
|
- **🦉 Maya-Eule** - Weise Eule mit Gedächtnis (Meta-Wissen)
|
|
- **🔧 Deepbit** - Bash-Erklärer (deep diving)
|
|
- **🐛 Bugsy** - Debugging-Helfer (Fehler-Detektiv)
|
|
- **🧭 Vektor** - Point-to-Point Guide (Navigation)
|
|
|
|
## 🦊 Verfügbare Missionen
|
|
|
|
### 📚 Basics
|
|
- **Fridolin** - Navigation (`pwd`, `ls`, `cd`)
|
|
- **Balu** - Dateien erstellen (`mkdir`, `touch`, `echo`)
|
|
- **Noko** - Dateien lesen (`cat`, `head`, `tail`, `grep`)
|
|
|
|
### 🚀 Advanced
|
|
- **DNS Deep Dive** - DNS-Tools (`dig`, `nslookup`, `host`)
|
|
- **SSH Security** - SSH-Verbindungen und Keys
|
|
|
|
### 🏆 Challenges
|
|
- **Stage Builder** - Komplexe Bash-Herausforderungen
|
|
|
|
### 🤖 Robots ⭐ NEU!
|
|
- **🔋 LiPo Power Academy** - Batterie-Wissen für Roboter
|
|
- **🌈 Regenbogen-Zählmaschine** - Farb-Event-Counter
|
|
- **🌙 Mond Maschine** - Rainbow Predictor mit Computer Vision
|
|
- **☀️ Solar Wasserkocher** - Physik-Simulation & Schleifen-Logik
|
|
|
|
## 🤖 Waldwächter nutzen
|
|
|
|
```bash
|
|
# Source die Library
|
|
source lib/waldwaechter.sh
|
|
|
|
# Frag einen Waldwächter
|
|
mayaeule "Was ist wichtiger - das Ziel oder der Weg?"
|
|
funkfox "Erkläre mir Pipes im Flow!"
|
|
dumbosql "Wie strukturiere ich eine Datenbank?"
|
|
snakepy "Zeig mir 3 Wege, um eine Liste zu sortieren"
|
|
|
|
# Alle verfügbar:
|
|
# mayaeule, deepbit, bugsy, schnippsi, templatus
|
|
# tobi, schraubaer, schnecki
|
|
# dumbosql, funkfox, taichitaube
|
|
# snakepy, pepperphp, crabbyrust
|
|
# spider, vektor, asciimonster
|
|
```
|
|
|
|
## 📊 Token-Tracking & Logs
|
|
|
|
**Philosophie:** "Was kostet die Frage eines Kindes?"
|
|
|
|
- Token-Verbrauch wird transparent angezeigt
|
|
- Logs landen in `logs/{character}/`
|
|
- Crew Memory: Waldwächter lesen andere Logs
|
|
- Mission Logs: `logs/missions/*.json`
|
|
|
|
```bash
|
|
# Logs checken
|
|
ls logs/
|
|
ls logs/mayaeule/
|
|
cat logs/missions/mond_maschine_*.json
|
|
```
|
|
|
|
Typische Kosten (Richtwerte, modellabhängig):
|
|
- Einzelne Frage: ~200-800 tokens (~$0.0002-0.0008)
|
|
- Komplette Mission: ~5,000-7,000 tokens (~$0.005-0.007)
|
|
- **Richtwert: Unter 1 Cent pro Mission** 💚
|
|
- Token-Anzeige dient der transparenten Nachvollziehbarkeit, nicht der Abrechnung
|
|
|
|
## 📖 Dokumentation
|
|
|
|
- **[CLAUDE.md](CLAUDE.md)** - Vollständige Architektur & Entwickler-Docs
|
|
- **[KEKSHANDBUCH_ZERO_v0.0.md](KEKSHANDBUCH_ZERO_v0.0.md)** - User Manual mit allen 17 Waldwächtern
|
|
|
|
## 🌍 Philosophien
|
|
|
|
**"Das Dreieck"** - DumboSQL, FunkFox, Taichi Taube
|
|
- Struktur, Flow & Balance
|
|
- Die Grundlage für komplexe Projekte
|
|
|
|
**"Power braucht Respekt, nicht Angst"** - LiPo Power Academy
|
|
- Sicherheit durch Wissen
|
|
- 7 goldene Regeln für LiPo-Batterien
|
|
|
|
**"Etwas bauen was noch keiner gebaut hat"** - Regenbogen-Zählmaschine
|
|
- Kreativität statt Reparatur
|
|
- Inspiriert durch Kinderfragen
|
|
|
|
**"Vorhersagen heißt verstehen"** - Mond Maschine
|
|
- Die Natur durch Code begreifen
|
|
- Computer Vision + Machine Learning + Astronomie
|
|
|
|
**"Was kostet die Frage eines Kindes?"**
|
|
- Token-Tracking für Transparenz
|
|
- Machen statt Lernen - Fragen stärken die Wurzel
|
|
|
|
**"Ein Elefant vergisst nie"** - DumboSQL
|
|
- Crew Memory über Projekt-Grenzen
|
|
- Persistente Konversations-Historie
|
|
|
|
**"wir ja nie fertig"** 🌱
|
|
- Der Wald wächst mit jeder Idee
|
|
- Community-driven Education
|
|
|
|
## 🏗️ Projekt-Struktur
|
|
|
|
```
|
|
CF_Zero_V1/
|
|
├── crumb-mission-selector.sh # Hauptmenü
|
|
├── lib/
|
|
│ └── waldwaechter.sh # 17 Waldwächter als Functions
|
|
├── crumbforest_roles/ # 17 Character Scripts
|
|
├── missions/
|
|
│ ├── basics/ # Einsteiger
|
|
│ ├── advanced/ # Fortgeschrittene
|
|
│ ├── challenges/ # Herausforderungen
|
|
│ └── robots/ # 🤖 NEU! 3 Robot-Missionen
|
|
├── logs/ # 🌲 Projekt-basierte Logs
|
|
│ ├── {character}/ # Pro Waldwächter
|
|
│ └── missions/ # Mission Logs
|
|
├── CLAUDE.md # Projekt-Dokumentation
|
|
├── KEKSHANDBUCH_ZERO_v0.0.md # User Manual
|
|
└── README.md # Diese Datei
|
|
```
|
|
|
|
## 🔧 Setup
|
|
|
|
```bash
|
|
# .env erstellen mit API Key
|
|
echo "OPENROUTER_API_KEY=your-key-here" > .env
|
|
|
|
# Mission Selector starten
|
|
./crumb-mission-selector.sh
|
|
|
|
# Oder direkt eine Mission
|
|
bash missions/robots/mond_maschine.sh
|
|
```
|
|
|
|
## 🎯 Use Cases
|
|
|
|
- **Terminal lernen** - Interaktive Bash-Basics
|
|
- **Roboter bauen** - Hardware + Software Projekte
|
|
- **Computer Vision** - OpenCV mit SnakePy lernen
|
|
- **Datenbanken** - SQL mit DumboSQL verstehen
|
|
- **APIs integrieren** - Spider zeigt den Weg
|
|
- **Kreativ coden** - Projekte die Spaß machen!
|
|
|
|
## 🌟 Besonderheiten
|
|
|
|
- **Alle Waldwächter haben Persönlichkeit** - FunkFox rappt, Maya-Eule philosophiert
|
|
- **Inter-Character Communication** - Waldwächter lesen andere Logs
|
|
- **Metadata-driven** - Missions als .sh + .meta.json
|
|
- **Token-Transparenz** - Kosten werden angezeigt
|
|
- **Community-driven** - Missionen entstehen aus User-Ideen
|
|
- **Raspberry Pi kompatibel** - Grundsystem auf Pi Zero, Robot- & Vision-Missionen benötigen Pi 4+ oder Desktop
|
|
|
|
## 📦 Requirements
|
|
|
|
- Bash 3.2+ (macOS default, Bash 4+ empfohlen für volle Features)
|
|
- curl, jq
|
|
- OpenRouter API Key
|
|
- Optional: Python 3 für Robot-Missionen (opencv-python, numpy, ephem)
|
|
- Mond Maschine (Computer Vision): Pi 4+ oder Desktop empfohlen
|
|
|
|
## 🚀 Next Steps
|
|
|
|
1. Mission Selector starten: `./crumb-mission-selector.sh`
|
|
2. Eine Robot-Mission ausprobieren
|
|
3. Eigene Mission-Idee einreichen
|
|
4. Den Wald wachsen lassen! 🌱
|
|
|
|
## 🔗 Links
|
|
|
|
- [LiPo 6S Charger Simulator](https://194-164-194-191.sslip.io/crumbblocks/lipo_6s_charger_sim_safe_v7.html)
|
|
- [Rainbow Counter Demo](https://194-164-194-191.sslip.io/crumbblocks/rainbow_counter.html)
|
|
|
|
---
|
|
|
|
### 🎨 Crumbblocks & UI ⭐ NEU!
|
|
- **Dein Zeichen im Wald** - Designe ein UI-Element im Browser
|
|
- **Bridge-Technology** - Sende Daten via Clipboard vom Browser ins Terminal
|
|
- **Smart Evaluation** - Die Crew erkennt automatisch, was du gebaut hast!
|
|
|
|
## 🏷️ Version
|
|
|
|
**v0.0-RC3-crumbblocks**
|
|
- Crumbblocks Integration (Browser <-> Terminal)
|
|
- Neue UI Mission "Dein Zeichen im Wald"
|
|
- Smart Routing für Evaluations-Skripte
|
|
- macOS Pfad-Fixes für Waldwächter
|
|
- 3 Robot-Missionen
|
|
- 17 Waldwächter komplett
|
|
|
|
---
|
|
|
|
*Erstellt mit 💚 im Crumbforest*
|
|
|
|
**"Der Wald ist nie fertig - er wächst mit jeder Idee!"** 🌲🌱
|