shortcuts_run

macOS

Zweck

Führt einen der macOS-Kurzbefehle des Nutzers über Name oder Kennung aus: so automatisieren Mac-Nutzer bereits HomeKit, Fokus-Modi und Aktionen von Drittanbieter-Apps, die der Katalog nicht abdeckt. Es führt die EIGENEN Aktionen des Kurzbefehls mit dessen eigenen Berechtigungen aus, nicht eine abgeschottete Teilmenge: genau wie ein Klick auf Ausführen in der Kurzbefehle-App. Das ist ein Schreibvorgang: Der erste Aufruf (confirm=false) liefert eine Vorschau mit dem Namen des Kurzbefehls, seiner Kennung und seinem Ordner, ohne etwas auszuführen; mit confirm=true wird er tatsächlich ausgeführt. Ein Name, der auf mehr als einen Kurzbefehl passt, wird mit beiden Kennungen abgelehnt: Rufen Sie erneut mit einer davon auf, raten Sie nie. Ein Kurzbefehl, der auf einen Dialog wartet oder lange läuft, wird nach einem begrenzten Timeout mit einer klaren Meldung gestoppt, statt diesen Aufruf zu blockieren.

Erforderliche Eingaben

• name_or_identifier

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert einen ausdrücklichen Bestätigungsparameter. Prüfen Sie die Vorschau und autorisieren Sie den echten Vorgang gemäß Plattformvertrag.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "confirm": {
      "description": "Must be true to actually run the shortcut. Without it, returns a preview.",
      "type": "boolean"
    },
    "input_text": {
      "description": "Optional text input for the shortcut, passed via a temp file — omit if the shortcut takes no input.",
      "type": "string"
    },
    "name_or_identifier": {
      "description": "Shortcut name or identifier, from shortcuts_list. An ambiguous name is refused — pass the identifier instead.",
      "type": "string"
    }
  },
  "required": [
    "name_or_identifier"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für shortcuts_run. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "confirm": false,
  "name_or_identifier": "Demo morning brief"
}