Was macht xiao?
Steuere einen Xiaomi Roboter-Staubsauger X20+ über die xiao CLI. Agenten-tauglich: AGENTS.md, llms.txt, SKILL.md, --json Ausgabe, kanonische Exit-Codes.
Übersicht
dacrypt/xiao ist ein CLI-Tool und eine Skill zur Steuerung des Xiaomi Roboter-Staubsaugers X20+. Es wurde entwickelt, um sowohl für menschliche Benutzer als auch für KI-Agenten einfach und zuverlässig zu sein. Der Skill bietet vollständige und konsistente Ausgaben (--json), standardisierte Exit-Codes und umfassende Dokumentation, die Agenten als Kontext bereitgestellt werden kann.
Funktionen
- Reinigung starten/stoppen
- Zur Ladestation zurückkehren
- Saugleistung anpassen
- Gerätestatus abfragen (Akku, Fehler, Karte)
- Zone / Raumreinigung (sofern vom Roboter unterstützt)
- --json Ausgabe für maschinenlesbare Ergebnisse
- Kanonische Exit-Codes: 0 = Erfolg, 1 = allgemeiner Fehler, 2 = Roboter nicht erreichbar, 3 = ungültige Option
Installation
# Installiere das neueste Release
pip install dacrypt-xiao
# Oder baue aus dem Quellcode
git clone https://github.com/dacrypt/xiao.git
cd xiao
pip install -e .
Schnellstart
- Stelle sicher, dass der Roboter mit demselben Netzwerk verbunden ist.
- Führe
xiao discoveraus, um den Roboter zu finden. - Führe
xiao statusaus, um den aktuellen Zustand zu prüfen. - Starte eine Reinigung mit
xiao start. - Schicke den Roboter zurück mit
xiao dock.
Agenten-Kontext
Für KI-Agenten stehen folgende Dateien zur Verfügung:
- AGENTS.md: Beschreibung der Agentenintegration
- llms.txt: Kompakte Zusammenfassung für LLMs
- SKILL.md: Diese Skill-Dokumentation
Kommandos
| Befehl | Beschreibung |
|---|---|
xiao discover | Suche nach Robotern im Netzwerk |
xiao status | Status des Roboters anzeigen |
xiao start | Reinigung starten |
xiao stop | Reinigung stoppen |
xiao dock | Roboter zur Ladestation schicken |
xiao fan <level> | Saugleistung setzen (0-100) |
xiao zones <json> | Zonenreinigung starten |
Exit-Codes
| Code | Bedeutung |
|---|---|
| 0 | Erfolg |
| 1 | Allgemeiner Fehler |
| 2 | Roboter nicht erreichbar |
| 3 | Ungültige Option / Parameterfehler |
Beispiele
# Status in JSON abrufen
xiao status --json
# Reinigung starten und Roboter zurückholen
xiao start && sleep 120 && xiao dock
# Saugleistung auf Maximum setzen
xiao fan 100