| /device help | Troubleshoot a problem |

| /device manual | Get manual/documentation |

| /device warranty | Show warranty status |

| /device maintenance | Show maintenance schedule |

| /device remove | Remove a device |

Natural Language

The skill understands natural queries:

• "Mein Geschirrspüler zeigt E24"
• "Waschmaschine macht komische Geräusche"
• "Wo ist die Anleitung für den Thermomix?"
• "Wann läuft die Garantie vom TV aus?"

Device Categories

| Category | Examples |

|----------|----------|

| kitchen | Geschirrspüler, Kühlschrank, Backofen, Thermomix |

| laundry | Waschmaschine, Trockner |

| electronics | TV, Router, NAS, Computer |

| climate | Heizung, Klimaanlage, Luftreiniger |

| smart-home | Hue, Homematic, Sensoren |

| software | Apps, Betriebssysteme, Lizenzen |

| other | Alles andere |

Handler Commands

handler.sh status $WORKSPACE                     # Overview
handler.sh list [category] $WORKSPACE            # List devices
handler.sh add <json> $WORKSPACE                 # Add device
handler.sh info <device-id> $WORKSPACE           # Device details
handler.sh error <device-id> <code> $WORKSPACE   # Error lookup
handler.sh troubleshoot <device-id> <problem> $WS # Get help
handler.sh manual <device-id> $WORKSPACE         # Manual link
handler.sh warranty $WORKSPACE                   # Warranty overview
handler.sh maintenance $WORKSPACE                # Maintenance due
handler.sh update <device-id> <json> $WORKSPACE  # Update device
handler.sh remove <device-id> $WORKSPACE         # Remove device
handler.sh search <query> $WORKSPACE             # Search devices
handler.sh log <device-id> <note> $WORKSPACE     # Add maintenance log

Data Structure

Device Entry

{
  "id": "dishwasher-1",
  "name": "Geschirrspüler",
  "nickname": "Spüli",
  "category": "kitchen",
  "manufacturer": "Siemens",
  "model": "SN658X06TE",
  "serialNumber": "ABC123456",
  "purchaseDate": "2022-03-15",
  "purchasePrice": 899,
  "warranty": {
    "expires": "2025-03-15",
    "type": "manufacturer",
    "notes": "3 Jahre Siemens"
  },
  "manualUrl": "https://...",
  "supportUrl": "https://...",
  "location": "Küche",
  "notes": "Salz alle 2 Monate nachfüllen",
  "maintenance": [
    {"task": "Filter reinigen", "interval": "monthly", "lastDone": "2026-01-01"}
  ],
  "errorHistory": [],
  "addedAt": "2024-01-01"
}

Error Code Lookup

The skill searches for error codes using:

1. Built-in database for common manufacturers
2. Web search for specific model + error code
3. Manual extraction if manual URL is stored

Common Error Code Patterns

| Manufacturer | Pattern | Example |

|--------------|---------|---------|

| Siemens/Bosch | E + number | E24, E15 |

| Miele | F + number | F11, F53 |

| AEG | E + number | E10, E20 |

| Samsung | Letters + numbers | UE, OE, LE |

| LG | Letters | OE, IE, PE |

Example Session

User: Ich habe einen neuen Geschirrspüler

Bot: 🔧 Neues Gerät hinzufügen:
     
     Welche Infos hast du?
     • Hersteller?
     • Modell?
     • Seriennummer? (optional)
     • Kaufdatum?

User: Siemens SN658X06TE, gekauft am 15.3.2022

Bot: ✅ Gespeichert!
     
     📦 Geschirrspüler (Siemens SN658X06TE)
     📅 Gekauft: 15.03.2022
     🛡️ Garantie: bis 15.03.2025 (ABGELAUFEN)
     📄 Anleitung: [Link gefunden]
     
     Spitzname vergeben? (z.B. "Spüli")

User: Mein Geschirrspüler zeigt E24

Bot: 🔧 Siemens SN658X06TE — Fehler E24
     
     ⚠️ Bedeutung: Abpumpproblem
     Das Wasser wird nicht richtig abgepumpt.
     
     🔨 Lösung:
     1. Gerät ausschalten
     2. Sieb am Boden prüfen und reinigen
     3. Abflussschlauch auf Knicke prüfen
     4. Siphon-Anschluss kontrollieren
     5. Gerät neu starten
     
     📄 Details: Anleitung S. 45
     
     [Problem gelöst] [Weitere Hilfe]

Data Files

Stored in $WORKSPACE/memory/device-assistant/:

| File | Purpose |

|------|---------|

| devices.json | All registered devices |

| error-history.json | Past errors and solutions |

| maintenance-log.json | Maintenance history |

| error-codes/ | Cached error code info |

Warranty Alerts

The skill can remind you before warranties expire:

⚠️ Garantie-Warnung:

Diese Geräte laufen bald ab:
• TV Samsung (noch 30 Tage)
• Waschmaschine (noch 45 Tage)

Tipp: Jetzt prüfen ob alles funktioniert!

Requirements

• jq (JSON processing)
• curl (web lookups)
• Internet for error code search