list_windows
Bildschirm, Fenster und Oberfläche · macOS · Windows
Wirkung: Lesen. Status: bedingt verfügbar.
„Bedingte Verfügbarkeit“ bedeutet, dass das Werkzeug von Version, Plattform, Berechtigungen, Konto oder Konfiguration abhängen kann. Es ist nicht in jeder Installation aktiv.
macOS
Zweck
Listet Bildschirmfenster jeder App mit window_id auf, mit App-Bundle-ID + Name, Titel, Grenzen (globaler Raum, oben links, Punkte), display_id (die CGDirectDisplayID – entspricht list_displays, sodass Sie nachschlagen können, auf welcher Anzeige sich ein Fenster befindet) und is_focused. Für das Fenster TITLES ist die Berechtigung zur Bildschirmaufzeichnung erforderlich. Ohne diese Berechtigung wird ein expliziter permission_required-Fehler zurückgegeben und kein Ergebnis ohne Titel. Optionaler app_bundle_id-Filter – note, dass Apps im Electron-Stil ihre Fenster oft von einem HELPER-Prozess mit einer anderen Bundle-ID besitzen, sodass ein Filter leer zurückkommen kann, während die App deutlich auf dem Bildschirm angezeigt wird. on_screen_only DEFAULTS bis TRUE und schließt minimierte, versteckte und andere Space-Fenster aus; Geben Sie „false“ ein, um sie zu sehen. Wenn das Ergebnis leer ist, gibt dieses Tool ein „note“ zurück, das erklärt, welcher Filter es geleert hat und was stattdessen übergeben werden soll – lesen Sie es, anstatt zu dem Schluss zu kommen, dass die App keine Fenster hat. window_id ist innerhalb der Sitzung für späteres Targeting stabil.
Erforderliche Eingaben
Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.
Berechtigungen und Bestätigung
Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.
- 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.
Kanonisches technisches Schema auf Englisch — macOS
{
"properties": {
"app_bundle_id": {
"description": "Only return windows owned by this app bundle id.",
"type": "string"
},
"on_screen_only": {
"description": "Only on-screen windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für list_windows. 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.
{}Windows
Zweck
Listet the offene windows auf this Machine auf: window ID, owning App (exe Name), PID, Titel, Grenzen {x,y,w,h} und display-ID. Windows-only (verwendet the Win32 windowing API). Filtern Sie die by-App with app_bundle_id (ein exe-Name-Teilstring match auf Windows).
Erforderliche Eingaben
Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.
Berechtigungen und Bestätigung
Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.
- 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.
Kanonisches technisches Schema auf Englisch — Windows
{
"properties": {
"app_bundle_id": {
"description": "Filter to windows owned by this app. On Windows, a case-insensitive substring of the exe name (e.g. 'chrome').",
"type": "string"
},
"on_screen_only": {
"description": "Only return visible, non-empty-title windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Dokumentationsbeispiel
Dokumentationsbeispiel für list_windows. 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.
{}