list_windows
Scherm, vensters en interface · macOS · Windows
Effect: lezen. Status: voorwaardelijk beschikbaar.
‘Voorwaardelijke beschikbaarheid’ betekent dat het hulpmiddel kan afhangen van versie, platform, machtigingen, account of configuratie. Het is niet in elke installatie actief.
macOS
Doel
Toont zichtbare vensters van elke app met window_id, bundel-ID en naam van de eigenaar-app, titel, grenzen (globale ruimte, oorsprong linksboven, punten), display_id (de CGDirectDisplayID — komt overeen met list_displays, zodat je kunt bepalen op welk scherm een venster staat) en is_focused. Voor vensterTITELS is toestemming voor Schermopname vereist — zonder die toestemming retourneert dit een expliciete fout permission_required in plaats van een resultaat zonder titel. Optioneel filter app_bundle_id — houd er rekening mee dat Electron-achtige apps hun vensters vaak vanuit een HELPER-proces met een andere bundel-ID beheren, waardoor een filter leeg kan terugkomen terwijl de app duidelijk op het scherm staat. on_screen_only staat STANDAARD OP TRUE en sluit geminimaliseerde, verborgen vensters en vensters in andere Spaces uit; geef false door om ze wel te zien. Wanneer het resultaat leeg is, retourneert deze tool een `note` waarin staat welk filter het leeg maakte en wat je in plaats daarvan moet doorgeven — lees dit in plaats van te concluderen dat de app geen vensters heeft. window_id is gedurende de sessie stabiel voor latere targeting.
Vereiste invoer
Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.
Machtigingen en bevestiging
Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.
- Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.
Canoniek technisch schema in het Engels — 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"
}Documentatievoorbeeld
Documentatievoorbeeld voor list_windows. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.
{}Windows
Doel
Toont de geopende vensters op deze computer: venster-ID, eigenaar-app (naam van uitvoerbaar bestand), pid, titel, grenzen {x,y,w,h} en scherm-ID. Alleen Windows (gebruikt de Win32-venster-API). Filter op app met app_bundle_id (op Windows een overeenkomst op een deel van de naam van het uitvoerbare bestand).
Vereiste invoer
Het schema van dit platform vermeldt geen vereiste invoer. Optionele selectors of uitvoeringsvereisten kunnen nog steeds gelden.
Machtigingen en bevestiging
Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.
- Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.
Canoniek technisch schema in het Engels — 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"
}Documentatievoorbeeld
Documentatievoorbeeld voor list_windows. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.
{}