Krümel Branko
83df9de035
12 Monate Crumbforest-Wachstum, sortiert nach Waldlogik. Struktur: - 454 Dokumente in 7 organischen Ebenen - Lichtung → Waldrand → Waldmitte → Wurzeln → Krone → Unterholz → Samen - INDEX.md für jede Ebene (eigene Stimme) - WALDKARTE.md (Master-Navigation) - crumbcodex.md (Das Versprechen zwischen Krümel & Bits) - lichtung/willkommen.md (Nullfeld-Einstieg für Kinder) Philosophie: - Waldlogik statt Ordnerlogik - Tiefe, Licht, Wurzeln - wie ein echter Wald - Schutz für Krümel, Tiefe für Gräber, Poesie für Atmende Repos verbunden: - OZM-Keks-Handbuch-v1 (Das Wissen) - Crumb-Core-v.1 (Das Herz) - 194.164.194.191 - crumbmissions (Das Spiel) Wuuuhuuuuu! 🦉✨
155 lines
4.7 KiB
Markdown
155 lines
4.7 KiB
Markdown
# 🌲 Crumbforest Terminal Session Log – Snake, Dumbo & Friends (2025-06-04/05)
|
||
|
||
## 🎯 Ziel der Session
|
||
|
||
Wiederherstellung und Erweiterung der kindgerechten Terminal-Charaktere (SnakePy, DumboSQL, ASCIIMonster, Bugsy) innerhalb des Crumbforest-Terminals unter Nutzung von OpenRouter-APIs und Bash-Skripten. Fokus auf systematische Logging-Protokolle, Wiederherstellung nach Fehlern und eine konsistente kindgerechte Ausdrucksweise.
|
||
|
||
---
|
||
|
||
## 🐍 SnakePy (Python Interpreter für Kinder)
|
||
|
||
### ✅ Erreichte Ziele
|
||
|
||
* **Systemprompt** erfolgreich über `snake_history.json` gesetzt:
|
||
|
||
```json
|
||
{
|
||
"role": "system",
|
||
"content": "Du bist SnakePy – eine Python-Schlange, die einfache Begriffe aus Python für Kinder erklärt. Du antwortest präzise, in einfachen Worten, mit einem Beispiel. Vermeide Gegenfragen oder abweichende Themen. Immer genau auf die gestellte Frage antworten."
|
||
}
|
||
```
|
||
* Antworten beinhalten kindgerechte Metaphern + konkrete Codebeispiele:
|
||
|
||
* **Variable:** Kleiderschrank
|
||
* **INT:** ganze Zahlen
|
||
* **Schleife:** sich wiederholende Handlung, Beispiel mit `range(5)`
|
||
* Reset-Skript `reset_history_snake.sh` löscht `snake_history.json` + `snake_response.json`
|
||
* Token-Log wird zuverlässig unter `token_log.json` gespeichert
|
||
|
||
### 🐛 Vorherige Bugs
|
||
|
||
* Modellantworten drifteten thematisch ab (Fokus auf „Was ist Python?“ statt auf Kernbegriff)
|
||
* Kein systematischer Reset der `.json` Files vor neuen Fragen → keine Modell-Kohärenz
|
||
|
||
### 📦 Status: **stabil & produktiv**
|
||
|
||
---
|
||
|
||
## 🐘 DumboSQL (SQL-Interpreter für Kinder)
|
||
|
||
### 📋 Aktueller Zustand
|
||
|
||
* Antworten noch im klassischen Format ohne Systemprompt-Zuweisung
|
||
* Beispielhafte Erklärung eines `JOIN`-Statements (gut verständlich):
|
||
|
||
```sql
|
||
SELECT Bestellungen.BestellNr, Produkte.Produktname, Bestellungen.Menge
|
||
FROM Bestellungen
|
||
JOIN Produkte ON Bestellungen.ProduktID = Produkte.ProduktID
|
||
```
|
||
|
||
### 🔧 ToDo
|
||
|
||
* Migration auf das neue Modellformat mit `dumbo_history.json` + Systemrolle:
|
||
|
||
```json
|
||
{
|
||
"role": "system",
|
||
"content": "Du bist DumboSQL – ein freundlicher Elefant, der SQL kindgerecht erklärt. Verwende einfache Begriffe, klare Struktur und konkrete Datenbankbeispiele. Vermeide Gegenfragen, konzentriere dich auf die Anfrage."
|
||
}
|
||
```
|
||
* Umbau von `dumbo_hardened.sh` → `dumbo_hardened_with_api.sh`
|
||
* Token-Log-Integration testen + Reset-Skript für `dumbo_history.json` + `dumbo_response.json`
|
||
|
||
---
|
||
|
||
## 🔤 ASCIIMonster (ASCII Generator)
|
||
|
||
### ✅ Setup & Funktionen
|
||
|
||
* ASCII-Ausgabe (Fallback mit `figlet`) funktioniert:
|
||
|
||
```bash
|
||
./ascii_fallback.sh branko
|
||
```
|
||
* Antwortverhalten wurde angepasst auf dekorative Erklärungen (freundlich, versponnen)
|
||
* Token-Logging aktiviert
|
||
* Reset-Skript `ascii_reset_history.sh` im Einsatz
|
||
|
||
### ⚠️ Bugphase
|
||
|
||
* Zwischenzeitlich viele Textantworten ohne ASCII → Modellwahl oder Prompt-Störung
|
||
* Lösung: Modell reset + systematischer Prompt
|
||
|
||
---
|
||
|
||
## 🧠 Bugsy (Fehlererklärer für Terminalausgaben)
|
||
|
||
### ⚠️ Zwischenstand
|
||
|
||
* Modell antwortet unregelmäßig
|
||
* Teilweise keine `response.json` Datei erzeugt → Ursache: leere Antwort oder Verbindungsproblem
|
||
* `bugsy_hardened_with_api.sh` vorhanden, aber Log-Parser meldete `usage`-Fehler
|
||
|
||
### 🛠️ Nächste Schritte
|
||
|
||
* Sicherstellung, dass `bugsy_response.json` immer geschrieben wird
|
||
* `log_tokens.sh` überarbeiten für Arrays statt Objekte
|
||
|
||
---
|
||
|
||
## 📊 Gemeinsame Logik & Bash-Erweiterungen
|
||
|
||
### 🔁 Reset-Skripte
|
||
|
||
Für alle Rollen angelegt:
|
||
|
||
* `reset_history_snake.sh`
|
||
* `ascii_reset_history.sh`
|
||
* (geplant) `reset_history_dumbo.sh`
|
||
* (optional) `reset_history_bugsy.sh`
|
||
|
||
### 📁 JSON-Dateien
|
||
|
||
* `snake_history.json`, `dumbo_history.json`, `ascii_history.json`, `bugsy_history.json`
|
||
* `*_response.json`
|
||
* Zentraler Token-Log: `token_log.json`
|
||
|
||
### 📡 OpenRouter-POST-Logik (Ausschnitt)
|
||
|
||
```bash
|
||
curl -s https://openrouter.ai/api/v1/chat/completions \
|
||
-H "Authorization: Bearer $API_KEY" \
|
||
-H "Content-Type: application/json" \
|
||
-d @- <<EOF > "$TMP_RESPONSE"
|
||
{
|
||
"model": "$MODEL",
|
||
"messages": $(cat "$HISTORY_FILE"),
|
||
"temperature": 0.7
|
||
}
|
||
EOF
|
||
```
|
||
|
||
---
|
||
|
||
## 🧁 Fazit & Reflexion
|
||
|
||
> „Snake ist wieder sweet. Dumbo wartet auf sein Update. ASCII tanzt. Bugsy grummelt. Aber das Terminal lebt.“
|
||
|
||
Diese Session war ein Paradebeispiel für das Zusammenspiel von kindgerechter Didaktik, API-Integration und systematischem Debugging. Der Crumbforest Terminal lernt laufen – mit Tieren, Tokens und ganz viel 💚.
|
||
|
||
---
|
||
|
||
## 🧩 Ausblick
|
||
|
||
* [ ] DumboSQL in neues Format überführen
|
||
* [ ] Funktionsübersicht auf `/kruemel/rollen` visualisieren
|
||
* [ ] PDF-Export `lernmodul_snakepy.md`
|
||
* [ ] Bash-CLI: `kruemel_start.sh` mit Rollenauswahl-Menü
|
||
|
||
---
|
||
|
||
*Session: 2025-06-04 13:00 – 2025-06-05 00:15*
|
||
|
||
\#KruemelCrew #SnakePy #CrumbforestTerminal #OpenRouterKinderCoding
|