SystemLens

Dale a ChatGPT visibilidad confiable del PC con Windows que está solucionando—y verifica qué cambió después.

SystemLens es un compañero de diagnóstico de Windows de código abierto y solo lectura y una arquitectura MCP de Quod. Recopila evidencia de sistema acotada, la normaliza en esquemas estables y admite un flujo de trabajo repetible de diagnosticar → inspeccionar → verificar.

Estado del proyecto: 0.3.0-showcase es una versión Showcase/demo de código primero. La demo local determinista está lista para ejecutarse; actualmente no se opera un servicio de plugin de producción alojado. SystemLens no está creado, respaldado, certificado ni avalado por OpenAI.

Por qué existe SystemLens

La resolución de problemas ordinaria es especulativa: describes un síntoma, pruebas una sugerencia y esperas que el estado relevante haya cambiado. SystemLens convierte ese ciclo en un enfoque basado primero en la evidencia:

1. Inspecciona un conjunto acotado de categorías de diagnóstico de Windows.

2. Guarda una línea base normalizada de corta duración.

3. Deja que el usuario realice el cambio recomendado.

4. Inspecciona las mismas categorías de nuevo.

5. Devuelve deltas deterministas sin afirmar que la correlación demuestre causalidad.

El fixture insignia comienza con poco espacio libre en C:, Discord habilitado al inicio, un controlador de pantalla más antiguo con un código de problema y reinicios de pantalla repetidos. El estado posterior tiene más espacio libre, Discord deshabilitado al inicio, un controlador cambiado y ningún reinicio de pantalla nuevo.

Related MCP server: Windows Forensics MCP Server

Prueba la demo determinista

La demo es sintética, saneada y claramente etiquetada. Usa el cargador de fixtures real, el almacén de instantáneas y la lógica de comparación; no contacta con una máquina, un backend alojado ni con OpenAI API.

Requisitos previos: Node.js 24 y pnpm 11.

git clone https://github.com/Quod-cmd/SystemLens.git
cd SystemLens
pnpm install --frozen-lockfile
pnpm demo

El resultado JSON contiene el estado anterior, la instantánea creada, el estado posterior y la evidencia de verificación estructurada. Consulta la guía de la demo para conocer los puntos de prueba esperados.

Arquitectura

La demo de código abierto se ejecuta localmente a partir de fixtures deterministas. La arquitectura más completa demuestra cómo un backend MCP podría conectar ChatGPT con un companion de Windows a través de un canal de dispositivo saliente seguro. Ese servicio alojado no se opera intencionalmente para esta versión.

• Companion (companion/) — Recopiladores de solo lectura en C#/.NET, saneamiento local, estado de capacidad explícito, almacenamiento de credenciales DPAPI para un futuro despliegue emparejado.

• Servidor MCP (server/) — TypeScript, Express, SDK de MCP TypeScript, esquemas estrictos, límite de servidor de recursos OAuth, comprobaciones de propiedad del dispositivo, instantáneas y lógica de comparación.

• Widget de evidencia (web/) — Interfaz de usuario MCP en React/Vite para evidencia acotada de instantáneas y comparaciones.

• Fixtures (tests/fixtures/) — únicamente escenarios de diagnóstico deterministas e inventados.

Lee la arquitectura detallada, los contratos de herramientas y el modelo de amenazas.

Categorías de diagnóstico

SystemLens define recopiladores acotados para:

• Resumen de Windows, CPU, memoria, GPU, tiempo de actividad y plan de energía

• capacidad de volumen fijo, espacio libre, sistema de archivos y metadatos de salud disponibles

• nombres de procesos y resúmenes acotados de CPU/memoria—nunca líneas de comandos

• estado de aplicaciones de inicio

• versiones de controladores, fechas, estado y códigos de problema

• bloqueos agrupados y saneados y eventos de Windows permitidos

• estado de servicio exacto o predefinido

• estado minimizado de adaptador, puerta de enlace, DNS y alcance de internet

• metadatos USB adjuntos sin números de serie

• búsquedas acotadas de software instalado

• disponibilidad segura de temperatura informada por el SO, incluidos estados no admitidos explícitos

Límite de seguridad de solo lectura

SystemLens es un plano de evidencia, no un plano de administración remota.

No puede ejecutar PowerShell ni comandos arbitrarios, leer archivos arbitrarios, inspeccionar el historial del navegador o las credenciales, capturar pulsaciones de teclas o capturas de pantalla, terminar procesos, editar el Registro, reconfigurar servicios o redes, instalar software, actualizar controladores ni cambiar la configuración de Windows.

La recopilación es bajo demanda. Los resultados están validados por esquema y son acotados. Las rutas de perfil de usuario y los patrones de secretos comunes se sanean localmente. Los estados desconocidos, no admitidos, de acceso denegado y de tiempo de espera siguen siendo visibles en lugar de informarse como saludables. Consulta el mapa de privacidad/datos.

Ejecuta el proyecto completo localmente

La demo determinista y las pruebas de TypeScript son multiplataforma. La validación del companion y de los recopiladores en máquinas reales requiere Windows y .NET SDK 10.

pnpm install --frozen-lockfile
pnpm build
pnpm test
pnpm test:companion
pnpm validate
pnpm scan:public

Para iniciar el servidor de desarrollo respaldado por fixtures:

$env:APP_ENV = 'development'
$env:DEVICE_GATEWAY_MODE = 'fixture'
$env:FIXTURE_SCENARIO = 'flagship-before'
pnpm dev

Los identificadores de portador de desarrollo local son fixtures ficticios y son rechazados por el modo de producción. No se requiere ninguna clave de OpenAI API porque SystemLens implementa MCP y no invoca ninguna OpenAI model API en tiempo de ejecución.

Modo local en máquinas reales

El companion puede ejecutar su lista permitida fija de recopiladores de solo lectura directamente en un PC con Windows. Esa ruta de recopilación local no requiere Render, Auth0, OAuth de producción, un servidor MCP público ni una cuenta de OpenAI. La integración remota con ChatGPT requeriría además un backend y un servicio de autenticación operados por separado; esos son componentes arquitectónicos, no un producto alojado actualmente.

No distribuyas el ejecutable sin firmar como instalador convencional. Compila desde el código fuente para una evaluación local:

dotnet build SystemLens.sln -c Release
dotnet run --project companion/SystemLens.Companion -- collect system_overview

Validación

La puerta de lanzamiento compila el servidor y el widget, ejecuta las pruebas de backend/widget/companion, valida contratos, ejecuta la demo determinista, comprueba los límites de campos de Showcase, escanea credenciales y audita el árbol rastreado más el historial completo de Git. Los resultados exactos del lanzamiento público se registran en las notas de la versión.

Mapa del repositorio

companion/       Windows companion, collectors, normalization, transport, tests
server/          MCP/backend, fixture gateway, snapshots, demo, tests
web/             evidence widget and sanitized preview
tests/fixtures/  deterministic invented before/after data
assets/          public cover, architecture, and evidence media
docs/            architecture, demo, security, release, and historical launch audits
scripts/         validation, packaging, secret scanning, public-source audit

El trabajo anterior de producción del Plugin Directory se conserva como historial de ingeniería, pero esa vía de lanzamiento está diferida. La versión actual es la edición Showcase de código abierto; no promete un backend alojado, un instalador para consumidores ni disponibilidad en el Plugin Directory. Consulta el estado del proyecto y la nota sobre la vía diferida.

Contribuciones y seguridad

Consulta CONTRIBUTING.md para conocer el alcance de mantenimiento intencionalmente reducido y SECURITY.md para la notificación privada de vulnerabilidades. Nunca adjuntes telemetría real, credenciales ni datos personales del sistema a un problema público.

Construido con Codex

Codex se utilizó en la arquitectura, los recopiladores de Windows, los contratos MCP, el endurecimiento de seguridad, las pruebas automatizadas, el widget de evidencia, la documentación, la preparación de medios y la auditoría de lanzamiento. Las decisiones de diseño y el trabajo generado se verificaron de forma iterativa contra pruebas ejecutables, fixtures deterministas, límites de privacidad y validación de solo lectura en máquinas reales.

Licencia

SystemLens está disponible bajo la permisiva MIT License: un ajuste simple para una demo inspeccionable y una implementación de referencia reutilizable. Copyright © 2026 Quod.