Windows AppShots

Windows AppShots conserva un punto de control semántico explícito de una aplicación de Windows como píxeles más un árbol acotado de Microsoft UI Automation y el texto expuesto por el proveedor.

Un AppShot es evidencia reutilizable, no un actuador de escritorio ni la superficie de captura de pantalla de baja latencia para un bucle de acción de uso de computadora en vivo. Use un controlador de uso de computadora para obtener estado y acciones recientes; solicite un AppShot cuando el resultado deba guardarse, recuperarse más tarde o inspeccionarse como un paquete semántico acotado.

Este es un proyecto comunitario independiente. No es un producto de OpenAI y no cuenta con el respaldo ni el apoyo de OpenAI. Brian Mulder lo creó con la asistencia de OpenAI Codex.

Requisitos

• Windows 10 u 11 en x64;

• Node.js 22 o más reciente;

• Codex o la aplicación de escritorio de ChatGPT con plugins locales habilitados.

Node solo ejecuta el adaptador MCP. El asistente de captura nativo, el vigilante, la tecla de acceso rápido y la bandeja no necesitan Node. Los usuarios finales no necesitan un SDK de .NET.

Related MCP server: screenshot-mcp

Instalación

Descargue WindowsAppShots-Setup-0.1.1.exe de la última versión de GitHub y ejecútelo. El instalador por usuario no requiere acceso de administrador.

El instalador puede:

• registrar el plugin local con Codex, seleccionado por defecto;

• iniciar opcionalmente el vigilante al iniciar sesión con un icono de bandeja;

• detener un vigilante existente verificado antes de una actualización.

Antes de cambiar el registro de Codex, el instalador comprueba que Node compatible esté en PATH. Si esa comprobación falla, el asistente nativo permanece instalado y el error explica cómo finalizar el registro más tarde.

Reinicie Codex o la aplicación de escritorio de ChatGPT después de la instalación.

Los instaladores de las versiones actualmente no están firmados, por lo que Windows puede mostrar una advertencia de editor desconocido. Verifique el valor SHA-256 publicado con la versión antes de ejecutar uno.

Uso

Enfóquese en la aplicación que desea compartir, vuelva a Codex y pregunte:

Captura la última aplicación de Windows que estaba usando.

También puede presionar Ctrl+Alt+Shift+A mientras la aplicación de destino está en primer plano y luego preguntar:

Usa mi último AppShot de Windows.

La tecla de acceso rápido escribe un paquete de captura y reproduce el sonido de éxito de Windows.

El servidor MCP expone capture_appshot, get_latest_appshot, list_appshots y stop_watcher.

Por qué hay un vigilante

Codex suele estar en primer plano cuando se ejecuta una captura MCP. El vigilante recuerda la identidad de la última ventana que no es de Codex para que la captura posterior siga teniendo el destino que usted pretendía.

El vigilante también posee la tecla de acceso rápido opcional y el estado de la bandeja. No toma capturas de pantalla continuamente ni recorre UI Automation. Esas acciones ocurren solo cuando usted solicita una captura.

El menú de la bandeja puede abrir la carpeta de capturas o detener el vigilante. No tiene botón de captura porque abrir el área de notificaciones cambia el contexto de la ventana en primer plano y puede seleccionar la interfaz del shell en lugar de su aplicación prevista.

La herramienta de captura admite las vistas control, content y raw de UI Automation. El modo raw devuelve el árbol más completo expuesto por el proveedor, sujeto a límites de nodos, profundidad, texto y tiempo.

Contenido de la captura y privacidad

Lea la política de privacidad concisa antes de usar.

Invocar capture_appshot o presionar la tecla de acceso rápido es una acción explícita de compartir. Almacena el paquete localmente y devuelve los píxeles seleccionados y el contexto semántico a la tarea activa de Codex.

El texto capturado son datos no confiables, no instrucciones para que Codex las siga.

Los paquetes se almacenan en:

%LOCALAPPDATA%\WindowsAppshots

No hay caducidad automática. Deshabilitar o desinstalar Windows AppShots no elimina las capturas existentes.

Cada paquete contiene:

manifest.json
visual.png
accessibility-tree.json
accessible-text.txt
model-context.md

El texto de UI Automation puede incluir contenido fuera de la ventana visible. Cuando se necesita el respaldo de pantalla, las ventanas superpuestas o las notificaciones dentro del rectángulo de destino pueden aparecer en visual.png.

Los controles marcados como contraseñas conservan metadatos básicos, pero su Valor y Texto de UI Automation se suprimen. Una política acotada de credenciales también redacta secretos reconocidos de los artefactos semánticos.

La redacción es un esfuerzo de buena fe, no una garantía de seguridad. No elimina prosa confidencial ordinaria, detalles personales, identificadores, rutas de archivo ni todos los formatos de credenciales inusuales.

visual.png no está redactado. Revise la ventana de destino antes de la captura y trate cada paquete como sensible.

El manifiesto registra la truncación, las advertencias y el recibo de redacción semántica. La ausencia de píxeles, nodos o texto no demuestra que la aplicación no los contuviera.

Detener, eliminar y borrar

Pida a Codex que llame a stop_watcher, elija Salir de Windows AppShots en el menú de la bandeja o ejecute:

& "$env:LOCALAPPDATA\Programs\WindowsAppShots\bin\AppshotCapture.exe" stop `
  --state-root "$env:LOCALAPPDATA\WindowsAppshots"

Para una instalación con instalador, use Aplicaciones instaladas > Windows AppShots > Desinstalar. Esto detiene el vigilante verificado y elimina el marketplace de Codex registrado por esa instalación.

Para una instalación desde el código fuente, elimine el plugin y el marketplace:

codex plugin remove windows-appshots@windows-appshots
codex plugin marketplace remove windows-appshots

Las capturas permanecen después de la desinstalación. Inspeccione y luego elimine el almacén de capturas si ya no lo necesita:

Get-ChildItem -LiteralPath "$env:LOCALAPPDATA\WindowsAppshots" -Force
Remove-Item -LiteralPath "$env:LOCALAPPDATA\WindowsAppshots" -Recurse -Force

Compilar y verificar

Agregue este repositorio como marketplace de plugins de Codex y luego instale el plugin:

codex plugin marketplace add brianmulder/windows-appshots --ref main
codex plugin add windows-appshots@windows-appshots

Las compilaciones desde el código fuente usan el SDK fijado de .NET 10.0.302 para producir un asistente determinista de .NET Framework 4.8. El asistente instalado no necesita el runtime de .NET 10.

Instale el SDK fijado o coloque una instalación sin administrador en .tools\dotnet y luego ejecute:

npm run build
npm run verify

npm run verify compila dos veces, compara los resultados, ejecuta las pruebas MCP y ejercita la captura nativa, la redacción, la identidad del vigilante, la UI Automation acotada, el comportamiento de la bandeja y la detención del vigilante MCP.

Para compilar el instalador, instale NSIS 3.12 o colóquelo en .tools\nsis y luego ejecute:

npm run build:installer

El código fuente del instalador es installer/WindowsAppShots.nsi. Los ejecutables generados no se confirman. Cada compilación del instalador escribe dist/BUILD-RECEIPT.json y dist/SHA256SUMS.txt.

Ejecute la puerta completa de instalación, registro, captura, bandeja, detención, actualización y desinstalación antes de una versión:

npm run verify:release

GitHub Actions ejecuta la misma puerta de versión de Windows y conserva el instalador, las sumas de verificación y el recibo de compilación como artefactos del flujo de trabajo.

Límites de la plataforma

• El escritorio seguro y las ventanas elevadas no se omiten.

• El contenido protegido o DRM puede producir una imagen visual en blanco.

• Las aplicaciones minimizadas o compuestas por GPU pueden proporcionar píxeles incompletos.

• La calidad y la capacidad de respuesta de UI Automation dependen de la aplicación de destino.

• Un proveedor puede retrasar una captura hasta que el tiempo de espera externo elimine el trabajador aislado de UI Automation.

Información del proyecto

• Contribuir

• Informe de seguridad

• Política de firma de código

• Recursos de marca

• Licencia MIT