Asistente - Diagnóstico de hardware de Windows

1. Posicionamiento de habilidades

windows-hardware-doctor es una herramienta de diagnóstico y gestión de seguridad de hardware para PC con Windows. Permite al agente abordar los siguientes problemas mediante un enfoque de "recopilación de pruebas, análisis y modificación":

• Inventario de hardware y revisión rápida de su estado;
• Dispositivo anómalo, signo de exclamación amarillo, problema del controlador;
• Problemas con la CPU, la memoria, la tarjeta gráfica, bloqueos, cuelgues y pantallas negras;
• HDD, SSD, NVMe, SMART, eventos de disco y riesgos de datos;
• Análisis del espacio en disco, planificación de copias de seguridad y organización de candidatos para la limpieza;
• Problemas con USB, periféricos, interfaces, fuente de alimentación y conexiones físicas;
• Proporcionar recomendaciones detalladas para la inspección física tras completar la certificación del software.

No se trata de una herramienta de solución instantánea. Su principal función es ayudar al agente a recopilar pruebas verificables, determinar el nivel de riesgo, distinguir entre hechos y especulaciones, y esperar la aprobación explícita del usuario antes de cualquier operación que pueda modificar el sistema o los datos.

2. Descripción general de las capacidades del agente

3. Métodos de trabajo principales

El agente debe seguir el siguiente bucle cerrado:

1. Pregunte sobre los síntomas, el momento de aparición, la frecuencia de ocurrencia, los cambios recientes de software y hardware, y si los datos están en riesgo.
2. Establezca parámetros de referencia para el hardware y los eventos utilizando métodos nativos de solo lectura.
3. Cargue los datos de diagnóstico correspondientes según el tipo de problema, en lugar de introducir toda la información en el contexto a la vez.
4. Compruebe simultáneamente el estado del dispositivo, los controladores, los recursos, la fiabilidad del almacenamiento y los eventos críticos del sistema.
5. Clasifique las conclusiones como "confirmadas, probables, posibles, aún no probadas".
6. Recomiende el siguiente paso más pequeño y reversible; las operaciones destructivas o irreversibles deben colocarse al final.
7. Tras obtener la aprobación e implementar los cambios, vuelva a examinar e informe sobre las diferencias antes y después.

Este proceso puede reducir la mala interpretación de una sola señal. Por ejemplo:

Un alto uso de la CPU solo indica una carga de corriente elevada y no significa automáticamente que la CPU esté dañada;
El evento 41 solo demuestra que se produjo un apagado anormal, pero no demuestra que la causa principal sea la fuente de alimentación;

• El hecho de que SMART muestre "Saludable" no descarta por sí solo los problemas de disco;
• Un campo de temperatura vacío indica que Windows no ha expuesto ningún sensor, pero no significa que la temperatura sea normal;
• El hecho de que el controlador tenga una fecha antigua no basta para demostrar que necesita actualizarse.

4. Herramientas integradas y resultados reales

4.1 Get-HardwareAudit.ps1

Este script genera resultados de auditoría de hardware en formato JSON, con campos clave que incluyen:

• Meta: Hora de recopilación, versión de Windows, si se ejecuta como administrador, intervalo de tiempo del evento;
• Veredicto: Decisión rápida;
• Atención: Señales a las que hay que prestar atención;
• MissingSections: Módulos que faltan debido a permisos o interfaces no disponibles;
• CPU, Resumen de memoria, Módulos de memoria, GPU;
• Unidades de disco, Discos físicos, Volúmenes;
• ProblemDevices, UnsignedOrIncompleteDrivers;
• Batería, Eventos relevantes del sistema, Limitaciones.

Por defecto, oculta el número de serie/número de pieza del módulo de memoria, el ID PnP de la GPU y del disco, y el número de serie del disco. La opción -IncludeIdentifiers solo debe utilizarse cuando sea absolutamente necesario que coincida exactamente con el dispositivo.

El script puede devolver actualmente:

• HEALTHY_NO_OBVIOUS_FAULTS: No se encontraron fallos evidentes en la instantánea;
• ATENCIÓN: Se ha detectado una señal que requiere atención;
• INCOMPLETO: Algunas fuentes de datos no están disponibles, por lo que no se puede extraer una conclusión completa sobre el estado de salud a partir de esta información.

Las reglas automáticas para ATTENTION actualmente cubren: anomalías PnP, discos físicos en mal estado, espacio libre en el volumen inferior al 10 % y eventos WHEA/disco/controlador de almacenamiento parcial.

4.2 Get-LargeFiles.ps1

Este script busca recursivamente archivos solo dentro de los directorios existentes especificados explícitamente por el usuario y admite:

• Tamaño mínimo del archivo, por defecto 500 MB;
• Devuelve el número de elementos; por defecto son los primeros 50 y el máximo es 1000.
• Tamaño del archivo de salida, fecha de última modificación y ruta completa;
• Mostrar únicamente los archivos candidatos, sin eliminarlos, moverlos ni comprimirlos.

5. Ejemplo de entrada y salida

El siguiente resultado es una muestra coherente con el diseño actual de la habilidad, utilizada para demostrar cómo debe representarse el agente; los datos específicos pueden variar según el ordenador.

Ejemplo 1: Congelación aleatoria, realizar primero una comprobación de solo lectura.

Ejemplo de entrada

Mi ordenador de sobremesa con Windows 11 se congela aleatoriamente últimamente. Por favor, revise rápidamente la CPU, la memoria, la tarjeta gráfica, el disco duro y cualquier otro dispositivo que pueda estar fallando. No cambie ninguna configuración todavía.

Ejemplo de salida

[Comprobación de hardware del host de Windows] ATENCIÓN

- Confirmado: Se produjeron 3 apagados anormales en los últimos 7 días; no se encontraron dispositivos PnP anormales; la unidad C tiene un 8,4 % de espacio restante.
- Lo más probable es que la falta de espacio en el disco del sistema pueda agravar el retraso, pero el Evento 41 en sí mismo no puede probar que sea la causa principal del bloqueo.
- Posibles causas: reinicio del controlador de la tarjeta gráfica, inestabilidad de la memoria o tiempo de espera del almacenamiento. Actualmente no hay pruebas suficientes.
- Impacto: Existe riesgo de inestabilidad del sistema y fallos en la actualización; hasta el momento no se ha detectado ninguna corrupción de datos directamente verificable.
- Tome medidas inmediatas: guarde primero el trabajo importante y evite ejecutar varias pruebas de estrés al mismo tiempo.
- Siguiente diagnóstico: Compruebe los eventos Display, WHEA, disk/stornvme y BugCheck durante 10 minutos antes y después del bloqueo.
- No se realizaron operaciones de escritura.

Ejemplo 2: Signo de exclamación amarillo en el Administrador de dispositivos

Ejemplo de entrada

Aparecía un signo de exclamación amarillo en el Administrador de dispositivos. Ayúdenme a encontrar el dispositivo y a solucionar el problema del controlador.

Ejemplo de salida

Se ha detectado un dispositivo anómalo: controlador USB, código de problema PnP 28, lo que indica que actualmente no hay ningún controlador disponible instalado.

Evidencia actual:
- Estado del dispositivo: Error
- Código del problema: 28
- Controlador actual: No se encontró ninguna versión válida.
- Identificador de hardware preciso: Ya se recopila localmente, no se divulga públicamente en los mensajes por defecto.

Se recomienda utilizar el controlador firmado que se encuentra en la página de soporte oficial del fabricante (OEM/OEM) y que coincida con el número de modelo, la versión de Windows y la identificación del hardware.
La instalación del controlador modificará el sistema. Antes de continuar, le mostraré el código fuente, la versión, la firma, el plan de reversión y los posibles riesgos de interrupción del USB, y esperaré su aprobación para la operación específica en este dispositivo.

Ejemplo 3: La unidad D está casi llena, primero haga una copia de seguridad y luego limpie.

Ejemplo de entrada

Mi disco D está casi lleno. Por favor, ayúdenme a encontrar archivos grandes, crear copias de seguridad y luego limpiarlo, pero no los borren directamente.

Ejemplo de salida

El análisis del espacio de solo lectura para D:\ ha finalizado y no se ha eliminado ningún archivo.

Candidatos principales:
1. D:\VMs\dev-machine.vhdx — 82,4 GB — Por favor, confirme si la máquina virtual sigue en uso.
2. D:\Downloads\archive.iso — 6,1 GB — Se puede mover a una unidad de copia de seguridad después de verificar el origen.
3. D:\BuildCache\old-cache.bin — 3,7 GB — Se recomienda limpiarlo utilizando la aplicación correspondiente.

Recomendación de copia de seguridad: Primero, copie los datos irremplazables a un disco duro independiente y en buen estado, y verifique la cantidad de archivos, el tamaño total, los hashes representativos y la posibilidad de abrir los archivos críticos. Luego, podré generar una lista de limpieza precisa, el espacio liberado estimado y los métodos de recuperación, que esperaré su aprobación elemento por elemento.

Ejemplo 4: Sospecha de que la unidad SSD está a punto de fallar

Ejemplo de entrada

Mi ordenador se bloquea al leer archivos y, ocasionalmente, la unidad SSD desaparece. ¿Podrías intentar ejecutar `chkdsk /f` para solucionarlo?

Ejemplo de salida

No se recomienda ejecutar primero chkdsk /f. La desaparición del disco y el bloqueo de E/S pueden indicar un fallo en el medio o en el controlador, y tratar de reparar las escrituras aumentará el riesgo.

Orden sugerido:
1. Detenga la limpieza, las pruebas de rendimiento, la desfragmentación y el análisis completo del disco.
2. Confirmación de solo lectura de discos físicos, volúmenes asociados, contadores SMART/de confiabilidad y eventos de almacenamiento.
3. Priorice la copia de datos irremplazables a otro dispositivo en buen estado y verifique la copia de seguridad.
4. Tras garantizar la seguridad de los datos, realice reparaciones o diagnósticos del proveedor en el clon/imagen.

Hasta el momento no se ha realizado ninguna operación de escritura.

Ejemplo 5: Resultados incompletos debido a permisos restringidos

Ejemplo de entrada

¿Por qué la auditoría de hardware aparece como INCOMPLETA? ¿Está averiada mi computadora?

Ejemplo de salida

No. INCOMPLETO indica que uno o más proveedores de datos de Windows no están disponibles en la sesión actual, por ejemplo, debido a permisos restringidos, registros de eventos inaccesibles o interfaces de almacenamiento que no exponen datos.

Esto no equivale a un problema de salud o de hardware. Primero, revise las secciones faltantes; si es necesario, le explicaré qué datos se pueden complementar elevando los privilegios y volveré a ejecutar el proceso después de obtener la aprobación. Cuando el sensor o el campo SMART está vacío, solo se puede marcar como "no disponible".

6. Casos de uso recomendados

• Inventario de hardware de solo lectura antes de la compra de ordenadores nuevos, ordenadores usados o reparaciones;
• Windows se congela aleatoriamente, se reinicia, muestra pantallas azules o negras, o experimenta una caída repentina en el rendimiento;
• El Administrador de dispositivos muestra un dispositivo desconocido, un signo de exclamación amarillo o el código 10/28/43/45;
• El disco duro externo, la unidad USB, la tarjeta gráfica u otros dispositivos no son reconocidos;
• La unidad SSD/HDD se ralentiza, se desconecta o presenta errores de E/S o sonidos inusuales;
• Espacio insuficiente en el disco del sistema o en el disco de datos; debe localizar el problema y solucionarlo.
• Evaluaciones de riesgos y reversión antes de las actualizaciones, reversiones y desinstalaciones de controladores;
• Anomalía en el reconocimiento de la capacidad de memoria, posible error de memoria o presión sobre los recursos;
• Es necesario desarrollar un plan de copia de seguridad, migración, reemplazo de disco o verificación de recuperación;
  Antes de desmontar o reemplazar piezas, descarte problemas de software, cables, puertos y controladores.

7. Tareas que no son adecuadas o que no se pueden completar en solitario

• No se puede demostrar que el hardware esté en perfecto estado basándose en una sola instantánea;
• La interfaz nativa de Windows normalmente no puede leer completamente el voltaje de la fuente de alimentación, la velocidad del ventilador, la temperatura de los módulos DIMM ni todos los sensores de la GPU/NVMe;
• No se puede determinar si un conductor ha caducado basándose únicamente en su fecha;
• El fallo de la fuente de alimentación no se puede determinar basándose únicamente en el evento Kernel-Power 41;
• No puede reemplazar los diagnósticos fuera de línea del fabricante, las pruebas de memoria del disco de arranque, el osciloscopio o la reparación física;
• Las actualizaciones de BIOS/firmware, los cambios de controladores, la reparación de discos, el formateo, el particionamiento, la eliminación, el reinicio o el desmontaje no deben realizarse automáticamente;
• No nos hacemos responsables del diagnóstico de hardware en macOS o Linux.

8. Límites de seguridad y privacidad

Las siguientes operaciones deben realizarse con aprobación explícita después de demostrar el objetivo específico, el impacto, el método de reversión y el estado de la copia de seguridad:

• Instalar, actualizar, revertir o desinstalar controladores;
• Habilitar/deshabilitar el dispositivo, modificar los servicios o el registro;
• Actualización de BIOS/firmware;
• chkdsk /f, chkdsk /r;
• Particionamiento, formateo, clonación y sobrescritura, borrado seguro, cambios en BitLocker;
• Eliminar elementos de limpieza y sobrescribir copias de seguridad;
• Reiniciar, apagar, realizar pruebas de estrés continuas o desmontar físicamente el dispositivo.

Los controladores solo deben obtenerse de Windows Update, del sitio web oficial del sistema/fabricante de equipos originales (OEM) o del sitio web oficial del fabricante del dispositivo. Se prohíben los sitios web de terceros que recopilan controladores y las herramientas de "actualización automática de controladores".

Aunque el script predeterminado oculta muchos identificadores de hardware, el JSON aún puede contener nombres de equipos, etiquetas de volumen, nombres de dispositivos/modelos y fragmentos de mensajes de eventos; los resultados de archivos grandes incluirán la ruta local completa. Se requiere una segunda capa de anonimización de datos antes de enviar el informe a sistemas externos.

9. Preguntas frecuentes

P1: ¿El mensaje HEALTHY_NO_OBVIOUS_FAULTS indica que el hardware es completamente normal?

No. Simplemente indica que no se detectaron fallos evidentes en los datos disponibles. Aún podrían existir problemas intermitentes, sensores no expuestos, fallos bajo carga y problemas físicos.

P2: ¿Por qué están vacíos los campos de temperatura, nivel de desgaste o SMART?

Una causa común es que el controlador de Windows o el hardware no expongan los datos a la interfaz nativa. La conclusión correcta es "datos no disponibles", no "normal".

P3: ¿Se requieren privilegios de administrador?

El inventario básico puede no ser necesario, pero algunos registros de eventos, contadores de confiabilidad de almacenamiento e interfaces del sistema requieren privilegios más elevados. Para obtener la aprobación, deberá explicar el propósito y el impacto de la elevación de privilegios.

P4: ¿Se pueden actualizar todos los controladores automáticamente?

No. Primero, identifique el dispositivo exacto y el código problemático, registre el controlador actual, luego busque el paquete específico en fuentes oficiales y establezca una ruta de reversión para cada dispositivo individual.

P5: ¿El código 43 siempre indica una falla de hardware?

No necesariamente. Indica que el dispositivo ha reportado una falla y que se necesitan más comprobaciones de la fuente de alimentación, la interfaz, el firmware, los controladores, el arranque en frío y los resultados de las pruebas desde otro puerto u otra computadora.

P6: El disco SMART muestra Saludable, ¿por qué sigue siendo necesario comprobarlo?

El estado SMART puede no incluir todos los atributos del proveedor ni mostrar los contadores de confiabilidad. Además, debe correlacionarse con fallas de disco, bloqueos, errores de E/S, reinicios del controlador, eventos NTFS y diagnósticos del proveedor.

P7: ¿Los escaneos de archivos grandes eliminarán automáticamente los archivos?

No. El script solo muestra la lista de archivos. El agente debe categorizar los candidatos, estimar el espacio necesario, describir el método de recuperación y solicitar una nueva aprobación para la lista precisa.

P8: ¿Por qué no hay resultados al escanear archivos grandes?

El script actual puede devolver una salida vacía en lugar de [] si ningún archivo cumple con el umbral. Esto generalmente indica que no se encontró ningún archivo coincidente y también puede requerir verificar la ruta, el umbral y los permisos de acceso.

P9: ¿Puedo ejecutar directamente robocopy /MIR para realizar una copia de seguridad?

No se puede ejecutar directamente. /MIR puede eliminar archivos de forma síncrona en el lado de destino. Primero debe demostrar el origen, el destino, la semántica de eliminación y los resultados de la exploración, y obtener aprobación explícita.

P10: ¿Debemos continuar con el diagnóstico si el hardware hace ruidos anormales o emite humo?

Las pruebas rutinarias no deben continuar. Priorice de inmediato la seguridad personal y de los datos, deje de usar el dispositivo y desconecte la alimentación de forma segura; no encienda la fuente de alimentación, las zonas de alto voltaje del monitor ni las baterías hinchadas.

10. Efecto real y resultados de la revisión de la versión actual

Rendimiento verificado

Ambos scripts de PowerShell superaron el análisis sintáctico sin errores.

• El script de auditoría de hardware puede devolver INCOMPLETE cuando los permisos son insuficientes y proporcionar MissingSections para evitar interpretar erróneamente un fallo en la recopilación de datos como si el sistema estuviera funcionando correctamente.
• Por defecto, si IdentifiersIncluded=false, el número de serie principal y el ID PnP están ocultos.
• Los scripts para archivos grandes requieren estrictamente rutas explícitas y solo realizan lectura y ordenación, sin incluir lógica de eliminación.
• Tres casos de prueba integrados cubren tres rutas principales: verificación completa de la máquina en modo de solo lectura, preaprobación de reparación de controladores y copia de seguridad posterior a la limpieza.

En las pruebas controladas, la sesión actual del entorno aislado no pudo acceder a varios proveedores de datos de hardware de Windows, y el script devolvió INCOMPLETE en lugar de una conclusión ficticia sobre el hardware. Esto verifica su diseño de "datos faltantes explícitos", pero también demuestra que la efectividad real del diagnóstico depende de una sesión normal de Windows y de los permisos adecuados.

Ventajas del diseño

1. **Límites de seguridad claros: Prioridad de solo lectura, con umbrales de aprobación claros para controladores, discos, reinicios y desmontaje.
2. Fuerte conocimiento de la evidencia: Múltiples señales están correlacionadas y se dan recordatorios repetidos para no confundir la correlación con la causa raíz.
3. Gestión adecuada del almacenamiento: Cuando se sospecha que un disco está defectuoso, priorice la protección de datos y opóngase explícitamente a ejecutar escrituras de reparación en primer lugar.
4. Carga progresiva razonable: El proceso principal es conciso y los detalles de los componentes, controladores y almacenamiento se separan en archivos de referencia independientes.
5. Configuración predeterminada de privacidad adecuada: Los identificadores de hardware sensibles están ocultos de forma predeterminada y solo se habilitan cuando es necesario para una coincidencia exacta.
6. Resultados aptos para el procesamiento automatizado: Los resultados de la auditoría se presentan en formato JSON estructurado, lo que facilita la agregación, comparación y archivo por parte de los agentes.

11. Resumen

La principal ventaja de windows-hardware-doctor no reside en la "reparación automática de ordenadores", sino en transformar el diagnóstico de hardware de Windows en un flujo de trabajo seguro, interpretable y verificable. Resulta especialmente útil en situaciones que implican fallos del sistema, mal funcionamiento de los controladores, riesgos de almacenamiento y poco espacio en disco, previniendo eficazmente errores comunes de alto riesgo como actualizar controladores sin criterio, ejecutar chkdsk /f en un disco supuestamente defectuoso, eliminar directamente archivos grandes o confiar únicamente en el Evento 41 para diagnosticar fallos en la fuente de alimentación.