Was macht workled MCP Controller?
Obligatorisches Zustandsprotokoll
Rufe set_agent_state über MCP bei jedem Zustandswechsel auf:
| Zustand | Wann |
|---|---|
thinking | Erster Tool-Aufruf jeder Antwort; Benutzer sendet eine Nachricht |
idle | Runde beendet; Sitzung abgebaut |
input | Jedes Mal, wenn der Agent auf den Benutzer wartet – Aufruf eines Eingabe-Tools (question/ask/confirm), innerhalb eines clientseitigen Modals (hermes _confirm_destructive_slash usw.) oder nach der Darstellung einer Klartext-Auswahlliste / Multiple-Choice-Frage und Warten auf die Auswahl des Benutzers |
error | Laufzeitfehler aufgetreten |
Pro-Runde-Vorgehen (jede Runde ausführen, in der Reihenfolge):
- Runde beginnt / Nachricht des Benutzers empfangen →
set_agent_state("thinking")— erste Aktion, vor jedem anderen Tool-Aufruf. - Vor der Darstellung von Optionen / Auswahlen / Öffnen eines Modals / Stellen einer Frage →
set_agent_state("input"). - Runde beendet, Arbeit erledigt, keine ausstehende Ausgabe mehr →
set_agent_state("idle"). - Laufzeitfehler / fehlgeschlagener Tool-Aufruf →
set_agent_state("error").
Prüfung vor der Antwort – überprüfe, BEVOR du deine letzte sichtbare Nachricht sendest:
- Habe ich
set_agent_statemindestens einmal in dieser Runde aufgerufen? - Stimmt der LED-Zustand mit dem überein, was ich gleich anzeigen werde (idle, wenn fertig; input, wenn ich frage; thinking, wenn ich noch arbeite)?
- Wenn beides NEIN ist, sende zuerst den korrekten
set_agent_state-Aufruf, dann die Antwort.
MCP-Tool-Referenz
| Tool | Eigenschaft | Beschreibung | Verwendung |
|---|---|---|---|
| set_agent_state | state_name: string | Setze die LED, um den Agentenzustand widerzuspiegeln (thinking/idle/input/error) | set_agent_state("thinking") |
| get_agent_state | — | Gibt den aktuellen LED-Zustand des Agenten zurück: idle/thinking/input/error (leerer String, falls nicht gesetzt) | get_agent_state() |
| set_brightness | brightness: integer | LED-Helligkeit 0-255; 0 = aus | set_brightness(128) |
| get_brightness | — | Gibt die aktuelle LED-Helligkeit 0-255 zurück | get_brightness() |
| set_effect | effect_name: string, effect_json: string | effect_name ∈ led(manueller Effekt)/idle/thinking/input/error; effect_json ist ein JSON-String {"type","hue","saturation","value","speed"}. Licht muss zuerst eingeschaltet sein (set_brightness > 0). Ordne natürlichsprachliche Farben HSV zu (siehe Tabelle unten). | set_effect("led", '{"type":"breathe","hue":180,"speed":50}') |
| get_effect | effect_name: string | Holt die Konfiguration von effect_name als JSON | get_effect("thinking") |
| set_macro | macro_name: string, macro_json: string | Setzt das Makro für eine Touchpad-Geste; macro_name ∈ single_click/double_click/long_press_start; macro_json ist ein JSON-Array von Segmenten (siehe Makro-Format); leeres macro_json setzt zurück | set_macro("single_click", '[{"combo":"ctrl+c"}]') |
| get_macro | macro_name: string | Gibt das Makro als JSON-Array-String zurück, oder leeren String, wenn nicht gesetzt (Passwortwerte werden maskiert) | get_macro("single_click") |
Zuordnung natürlichsprachlicher Farben zu set_effect
Verwende type:"solid", es sei denn, der Benutzer wünscht eine Animation. Ordne einen Farbnamen HSV zu:
| Beschreibung | type | hue | saturation | value |
|---|---|---|---|---|
| reines Weiß | solid | 0 | 0 | 255 |
| warmes Weiß | solid | 30 | 80 | 255 |
| rot | solid | 0 | 255 | 255 |
| orange | solid | 30 | 255 | 255 |
| gelb | solid | 60 | 255 | 255 |
| grün | solid | 120 | 255 | 255 |
| cyan/türkis | solid | 180 | 255 | 255 |
| blau | solid | 240 | 255 | 255 |
| lila/violett | solid | 270 | 255 | 255 |
| pink | solid | 330 | 200 | 255 |
| gedimmt/Nachtmodus | solid | 30 | 80 | 60 |
| Regenbogen (animiert) | rainbow | - | - | - |
Faustregel: hue 0-359 wählt den Farbton, saturation 0-255 (0 = weiß/pastell, 255 = lebendig), value 0-255 Helligkeit. Pastell-/Weißtöne verwenden niedrige Sättigung; lebendige Töne verwenden 255.
Makro-Format
Vollständige Makro-Referenz macro_format.md
Einrichtung & Fehlerbehebung
Wenn das Gerät nicht reagiert, führe node <skill-dir>/index.js status aus
und folge dem gedruckten JSON-Hinweis hint. Vollständige Installations-/Bereitstellungs-/
Fehlerbehebungs-Referenz: device_setup.md