Guida - Diagnostica hardware di Windows

1. Posizionamento delle competenze

windows-hardware-doctor è una skill di diagnostica hardware e gestione della sicurezza per PC Windows. Consente all'agente di gestire i seguenti problemi utilizzando un approccio basato su "raccolta di prove, valutazione e modifica":

• Inventario hardware e rapido controllo dello stato di salute;
• Dispositivo anomalo, punto esclamativo giallo, problema del driver;
• CPU, memoria, scheda grafica, arresti anomali, blocchi e schermate nere;
• HDD, SSD, NVMe, SMART, eventi del disco e rischi relativi ai dati;
• Analisi dello spazio su disco, pianificazione dei backup e organizzazione delle attività di pulizia;
• Problemi relativi a USB, periferiche, interfacce, alimentazione e connessioni fisiche;
• Fornire raccomandazioni accurate per l'ispezione fisica dopo aver completato la certificazione del software.

Non si tratta di uno strumento che risolve i problemi con un solo clic. Il suo valore fondamentale è quello di aiutare l'agente a raccogliere prove verificabili, determinare il livello di rischio, distinguere tra fatti e speculazioni e attendere l'approvazione esplicita dell'utente prima di qualsiasi operazione che possa modificare il sistema o i dati.

2. Panoramica delle funzionalità dell'agente

3. Metodi di lavoro principali

L'agente deve seguire il seguente ciclo chiuso:

1. Chiedere informazioni sui sintomi, il momento di insorgenza, la frequenza di comparsa, le recenti modifiche al software e all'hardware e se i dati sono a rischio.
2. Stabilire le baseline hardware e degli eventi utilizzando metodi nativi di sola lettura.
3. Caricare i dati diagnostici corrispondenti in base al tipo di problema, anziché inserire tutte le informazioni nel contesto contemporaneamente.
4. Verificare simultaneamente lo stato del dispositivo, i driver, le risorse, l'affidabilità dell'archiviazione e gli eventi critici di sistema.
5. Classificare le conclusioni come "confermate, probabili, possibili, non ancora verificate".
6. Raccomandare il passo successivo più piccolo e reversibile; le operazioni distruttive o irreversibili dovrebbero essere collocate per ultime.
7. Dopo aver ottenuto l'approvazione e implementato le modifiche, riesaminare e segnalare le differenze prima e dopo.

Questo processo può ridurre le interpretazioni errate di un singolo segnale. Ad esempio:

Un elevato utilizzo della CPU indica solo un carico di corrente elevato e non significa automaticamente che la CPU sia danneggiata;
L'evento 41 dimostra solo che si è verificato uno spegnimento anomalo, ma non dimostra che la causa principale sia l'alimentatore;

• La visualizzazione dello stato "Integro" da parte di SMART non esclude di per sé problemi al disco;
• Un campo temperatura vuoto indica che Windows non ha rilevato alcun sensore, ma non significa che la temperatura sia normale;
• Una data di rilascio del driver obsoleta da sola non è sufficiente a dimostrare la necessità di un aggiornamento del driver.

4. Strumenti integrati e output effettivo

4.1 Get-HardwareAudit.ps1

Questo script genera risultati di audit hardware in formato JSON, con campi chiave tra cui:

• Meta: Ora di raccolta, versione di Windows, se viene eseguito come amministratore, intervallo temporale dell'evento;
• Verdetto: Decisione rapida;
• Attenzione: segnali a cui è necessario prestare attenzione;
• MissingSections: moduli mancanti a causa di permessi o interfacce non disponibili;
• CPU, MemorySummary, MemoryModules, GPU;
• Unità disco, Dischi fisici, Volumi;
• Dispositivi problematici, Driver non firmati o incompleti;
• Batteria, Eventi di sistema rilevanti, Limitazioni.

Per impostazione predefinita, nasconde il numero di serie/codice articolo del modulo di memoria, l'ID PnP della GPU e del disco e il numero di serie del disco. L'opzione -IncludeIdentifiers deve essere utilizzata solo quando è assolutamente necessario un riconoscimento preciso del dispositivo.

Lo script potrebbe attualmente restituire:

• HEALTHY_NO_OBVIOUS_FAULTS: Nell'istantanea non sono stati rilevati guasti evidenti;
• ATTENZIONE: È stato rilevato un segnale che richiede attenzione;
• INCOMPLETO: Alcune fonti di dati non sono disponibili, pertanto non è possibile trarre conclusioni complete sullo stato di salute da queste informazioni.

Le regole automatiche per ATTENTION attualmente coprono: anomalie PnP, dischi fisici non integri, spazio libero sul volume inferiore al 10% ed eventi WHEA/disco/controller di archiviazione parziale.

4.2 Get-LargeFiles.ps1

Questo script cerca ricorsivamente i file solo all'interno delle directory esistenti specificate esplicitamente dall'utente e supporta:

• Dimensione minima del file, predefinita 500 MB;
• Restituisce il numero di elementi, il valore predefinito è i primi 50, il massimo è 1000;
• Dimensione del file di output, ora dell'ultima modifica e percorso completo;
• Elenca solo i file candidati, senza eliminarli, spostarli o comprimerli.

5. Esempio di input e output

L'output seguente è un risultato di esempio coerente con l'attuale progettazione della Skill, utilizzato per dimostrare come dovrebbe essere espresso l'Agent; i dati specifici possono variare a seconda del computer.

Esempio 1: Blocco casuale, eseguire prima un controllo di sola lettura

Esempio di input

Il mio computer desktop con Windows 11 si blocca in modo casuale ultimamente. Per favore, controlla rapidamente CPU, memoria, scheda grafica, disco e qualsiasi altro dispositivo malfunzionante. Non modificare ancora alcuna impostazione.

Esempio di output

[Controllo hardware host Windows] ATTENZIONE

- Confermato: si sono verificati 3 arresti anomali negli ultimi 7 giorni; non sono stati rilevati dispositivi PnP anomali; l'unità C ha ancora l'8,4% di spazio libero.
- Più probabilmente: uno spazio insufficiente sul disco di sistema potrebbe aggravare il rallentamento, ma l'evento 41 di per sé non può dimostrare che sia la causa principale del blocco.
- Possibili cause: ripristino del driver della scheda grafica, instabilità della memoria o timeout di archiviazione. Al momento non ci sono prove sufficienti.
- Impatto: esiste il rischio di instabilità del sistema e di errori di aggiornamento; finora non è stata rilevata alcuna corruzione dei dati direttamente verificabile.
- Intervieni immediatamente: salva prima i lavori importanti ed evita di eseguire più stress test contemporaneamente.
- Diagnosi successiva: Controllare gli eventi Display, WHEA, disk/stornvme e BugCheck per 10 minuti prima e dopo il blocco.
- Nessuna operazione di scrittura eseguita.

Esempio 2: Punto esclamativo giallo in Gestione dispositivi

Esempio di input

In Gestione dispositivi è presente un punto esclamativo giallo. Aiutatemi a trovare il dispositivo e a riparare il driver.

Esempio di output

È stato rilevato un dispositivo anomalo: controller USB, codice di errore PnP 28, che indica che al momento non è installato alcun driver disponibile.

Dati attuali:
- Stato del dispositivo: Errore
- Codice problema: 28
- Driver corrente: nessuna versione valida trovata
- ID hardware preciso: già raccolto localmente, non divulgato pubblicamente nei messaggi per impostazione predefinita.

Si consiglia di utilizzare il driver firmato presente sulla pagina di supporto ufficiale dell'OEM/OEM, verificando il numero di modello, la versione di Windows e l'ID hardware corretti.
L'installazione del driver modificherà il sistema. Prima di procedere, ti mostrerò il codice sorgente, la versione, la firma, il piano di ripristino e i potenziali rischi di interruzione della connessione USB, e attenderò la tua approvazione per l'operazione specifica su questo dispositivo.

Esempio 3: L'unità D è quasi piena, esegui prima il backup e poi pulisci

Esempio di input

Il mio disco D è quasi pieno. Per favore, aiutatemi a trovare i file di grandi dimensioni, a creare dei backup e poi a ripulire il disco, ma vi prego di non cancellarli direttamente.

Esempio di output

L'analisi dello spazio di sola lettura per D:\ è stata completata e nessun file è stato eliminato.

Principali candidati:
1. D:\VMs\dev-machine.vhdx — 82,4 GB — Confermare se la macchina virtuale è ancora in uso.
2. D:\Downloads\archive.iso — 6,1 GB — Può essere spostato su un'unità di backup dopo aver verificato la fonte.
3. D:\BuildCache\old-cache.bin — 3,7 GB — Si consiglia di pulirlo utilizzando l'applicazione corrispondente.

Raccomandazione per il backup: Innanzitutto, copiate i dati insostituibili su un disco separato e funzionante e verificate il numero di file, la dimensione totale, gli hash rappresentativi e l'apertura dei file critici. Successivamente, potrò generare un elenco preciso delle operazioni di pulizia, una stima dello spazio liberato e i metodi di ripristino, che attenderò la vostra approvazione elemento per elemento.

Esempio 4: Sospetto che l'SSD stia per guastarsi

Esempio di input

Il mio computer si blocca durante la lettura dei file e l'SSD a volte scompare. Potresti provare a eseguire `chkdsk /f` per risolvere il problema?

Esempio di output

Non è consigliabile eseguire prima chkdsk /f. La scomparsa del disco e il blocco dell'I/O possono indicare un guasto del supporto o del controller, e il tentativo di riparare le scritture aumenterà il rischio.

Ordine consigliato:
1. Interrompere le operazioni di pulizia, benchmarking, deframmentazione e scansione completa del disco.
2. Conferma in sola lettura dei dischi fisici, dei volumi associati, dei contatori SMART/di affidabilità e degli eventi di archiviazione.
3. Dai la priorità alla copia dei dati insostituibili su un altro dispositivo funzionante e verifica il backup.
4. Dopo aver garantito la sicurezza dei dati, eseguire riparazioni o diagnosi del fornitore sul clone/immagine.

Finora non è stata eseguita alcuna operazione di scrittura.

Esempio 5: Risultati incompleti a causa di autorizzazioni limitate

Esempio di input

Perché il controllo hardware risulta INCOMPLETO? Il mio computer è guasto?

Esempio di output

No. INCOMPLETO indica che uno o più provider di dati di Windows non sono disponibili nella sessione corrente, ad esempio a causa di autorizzazioni limitate, registri eventi inaccessibili o interfacce di archiviazione che non espongono i dati.

Ciò non equivale a un problema di salute o a un guasto hardware. Innanzitutto, controlla le sezioni mancanti; se necessario, spiegherò quali dati possono essere integrati elevando i privilegi e rieseguirò la procedura dopo aver ottenuto l'approvazione. Quando il campo del sensore o SMART è vuoto, può essere solo contrassegnato come "non disponibile".

6. Casi d'uso consigliati

• Inventario hardware di sola lettura prima di acquistare nuovi computer, computer usati o effettuare riparazioni;
• Windows si blocca in modo casuale, si riavvia, mostra schermate blu, schermate nere o subisce un improvviso calo di prestazioni;
• Gestione dispositivi visualizza un dispositivo sconosciuto, un punto esclamativo giallo o il codice 10/28/43/45;
• Il disco rigido esterno, la porta USB, la scheda grafica o altri dispositivi non vengono riconosciuti;
• L'SSD/HDD rallenta, si disconnette o presenta errori di I/O o suoni insoliti;
• Spazio insufficiente sul disco di sistema o sul disco dati; è necessario individuare il problema e quindi risolverlo.
• Valutazione dei rischi e delle procedure di ripristino prima dell'aggiornamento, del ripristino e della disinstallazione dei driver;
• Anomalia nel riconoscimento della capacità di memoria, sospetto errore di memoria o pressione sulle risorse;
• È necessario sviluppare un piano di backup, migrazione, sostituzione del disco o verifica del ripristino;
  Prima di smontare o sostituire componenti, escludere problemi relativi a software, cavi, porte e driver.

7. Compiti inadatti o impossibili da completare da soli

• Non è possibile dimostrare che l'hardware sia perfettamente funzionante basandosi su una sola istantanea;
• L'interfaccia nativa di Windows in genere non è in grado di leggere completamente la tensione dell'alimentatore, la velocità della ventola, la temperatura dei moduli DIMM o tutti i sensori della GPU/NVMe;
• Non è possibile stabilire se un driver è scaduto basandosi esclusivamente sulla sua data;
• Un guasto all'alimentatore non può essere determinato esclusivamente in base all'evento Kernel-Power 41;
• Non può sostituire la diagnostica offline del produttore, il test della memoria del disco di avvio, l'oscilloscopio o la riparazione fisica;
• Gli aggiornamenti del BIOS/firmware, le modifiche dei driver, la riparazione del disco, la formattazione, il partizionamento, la cancellazione, il riavvio o lo smontaggio non devono essere eseguiti automaticamente;
• Non ci assumiamo alcuna responsabilità per la diagnostica hardware di macOS o Linux.

8. Confini di sicurezza e privacy

Le seguenti operazioni devono essere eseguite previa autorizzazione esplicita, dopo aver dimostrato l'obiettivo specifico, l'impatto, il metodo di ripristino e lo stato del backup:

• Installare, aggiornare, ripristinare o disinstallare i driver;
• Abilitare/disabilitare il dispositivo, modificare i servizi o il registro di sistema;
• Aggiornamento del BIOS/firmware;
• chkdsk /f, chkdsk /r;
• Partizionamento, formattazione, clonazione e sovrascrittura, cancellazione sicura, modifiche BitLocker;
• Elimina gli elementi di pulizia e sovrascrivi i backup;
• Riavviare, spegnere, eseguire test di stress continui o smontare fisicamente il dispositivo.

I driver devono essere scaricati esclusivamente da Windows Update, dal sito Web ufficiale del sistema/OEM o dal sito Web ufficiale del produttore del dispositivo. Sono vietati i siti di aggregazione di driver di terze parti e gli strumenti di "aggiornamento automatico dei driver".

Sebbene lo script predefinito nasconda molti identificatori hardware, il file JSON potrebbe comunque contenere nomi di computer, etichette di volume, nomi di dispositivi/modelli e frammenti di messaggi di evento; i risultati relativi a file di grandi dimensioni includeranno il percorso locale completo. È necessario un secondo livello di anonimizzazione dei dati prima di inviare il report a sistemi esterni.

9. Domande frequenti

D1: HEALTHY_NO_OBVIOUS_FAULTS indica che l'hardware è completamente normale?

No. Indica solo che non sono stati rilevati guasti evidenti nei dati disponibili. Potrebbero comunque sussistere problemi intermittenti, sensori non esposti, guasti sotto carico e problemi fisici.

D2: Perché i campi relativi a temperatura, livello di usura o SMART sono vuoti?

Una causa comune è che il driver di Windows o l'hardware non espongano i dati all'interfaccia nativa. La conclusione corretta è "dati non disponibili", non "normale".

D3: Sono necessari i privilegi di amministratore?

L'inventario di base potrebbe non essere necessario, ma alcuni registri eventi, contatori di affidabilità dell'archiviazione e interfacce di sistema richiedono privilegi più elevati. Le competenze richieste prevedono la spiegazione dello scopo e dell'impatto dell'innalzamento dei privilegi prima di ottenere l'approvazione.

D4: È possibile aggiornare automaticamente tutti i driver?

No. Innanzitutto, identifica il dispositivo esatto e il codice problematico, annota il driver corrente, quindi confronta il pacchetto specifico con le fonti ufficiali e stabilisci un percorso di ripristino per ogni singolo dispositivo.

D5: Il codice 43 indica sempre un guasto hardware?

Non necessariamente. Indica che il dispositivo ha segnalato un errore e sono necessari ulteriori controlli sull'alimentazione, l'interfaccia, il firmware, i driver, l'avvio a freddo e i risultati dei test effettuati da un'altra porta o da un altro computer.

D6: Il disco SMART risulta integro, perché è comunque necessario controllarlo?

Lo stato SMART potrebbe non includere tutti gli attributi del fornitore o non esporre tutti i contatori di affidabilità. Deve inoltre essere correlato con guasti del disco, blocchi, errori di I/O, ripristini del controller, eventi NTFS e diagnostica del fornitore.

D7: Le scansioni di file di grandi dimensioni elimineranno automaticamente i file?

No. Lo script si limita a elencare i file. L'agente deve classificare i candidati, stimare lo spazio necessario, descrivere il metodo di ripristino e richiedere nuovamente l'approvazione per l'elenco corretto.

D8: Perché non vengono generati output durante la scansione di file di grandi dimensioni?

Lo script corrente potrebbe restituire un output vuoto anziché [] se nessun file soddisfa la soglia. Ciò di solito indica che non è stato trovato alcun file corrispondente e potrebbe anche richiedere la verifica del percorso, della soglia e dei permessi di accesso.

D9: Posso eseguire direttamente robocopy /MIR per effettuare un backup?

Non può essere eseguito direttamente. /MIR può eliminare i file in modo sincrono sul lato di destinazione. È necessario prima dimostrare la sorgente, la destinazione, la semantica di eliminazione e i risultati del drill-down, e ottenere un'approvazione esplicita.

D10: Dobbiamo continuare la diagnostica se l'hardware emette rumori anomali o fumo?

I test di routine non devono proseguire. Dare immediatamente la priorità alla sicurezza personale e dei dati, interrompere l'utilizzo e scollegare l'alimentazione in modo sicuro; non accendere l'alimentatore, le aree ad alta tensione del monitor o le batterie gonfie.

10. Effetti effettivi e risultati della revisione della versione attuale

Prestazioni verificate

Entrambi gli script PowerShell hanno superato l'analisi sintattica senza errori.

• Lo script di controllo hardware può restituire INCOMPLETE quando le autorizzazioni sono insufficienti e fornire MissingSections per evitare di interpretare erroneamente un errore di raccolta dati come corretto.
• Per impostazione predefinita, IdentifiersIncluded=false, il numero di serie principale e l'ID PnP sono nascosti.
• Gli script per file di grandi dimensioni richiedono rigorosamente percorsi espliciti ed eseguono solo operazioni di lettura e ordinamento, senza includere logiche di eliminazione.
• Tre casi di test integrati coprono tre percorsi principali: controllo completo della macchina in sola lettura, pre-approvazione della riparazione del driver e pulizia successiva al backup.

Nei test controllati, la sessione sandbox corrente non è riuscita ad accedere a più provider di dati hardware di Windows e lo script ha restituito "INCOMPLETE" anziché una conclusione hardware fittizia. Ciò conferma la sua progettazione basata su "dati mancanti espliciti", ma dimostra anche che l'effettiva efficacia diagnostica dipende da una normale sessione di Windows e dalle autorizzazioni appropriate.

Vantaggi del design

1. **Confini di sicurezza chiari: priorità di sola lettura, con soglie di approvazione chiare per driver, dischi, riavvii e disassemblaggio.
2. Forte consapevolezza delle prove: Vengono correlati segnali multipli e vengono forniti ripetuti promemoria per non confondere la correlazione con la causa principale.
3. Gestione corretta dell'archiviazione: Quando si sospetta che un disco sia difettoso, dare priorità alla protezione dei dati e opporsi esplicitamente all'esecuzione di scritture di ripristino.
4. Caricamento progressivo ragionevole: Il processo principale è conciso e i dettagli dei componenti, dei driver e della memoria sono separati in file di riferimento indipendenti.
5. Buone impostazioni predefinite per la privacy: Gli identificatori hardware sensibili sono nascosti per impostazione predefinita e abilitati solo quando necessario per una corrispondenza esatta.
6. Output adatto all'elaborazione automatizzata: i risultati dell'audit sono presentati in formato JSON strutturato, il che facilita l'aggregazione, il confronto e l'archiviazione dei dati degli agenti.

11. Riepilogo

Il punto di forza di windows-hardware-doctor non è la "riparazione automatica del computer", bensì la trasformazione della diagnostica hardware di Windows in un flusso di lavoro sicuro, interpretabile e verificabile. È particolarmente adatto a scenari che coinvolgono arresti anomali del sistema, malfunzionamenti dei driver, rischi legati allo storage e spazio su disco insufficiente, prevenendo efficacemente errori comuni ad alto rischio come l'aggiornamento indiscriminato dei driver, l'esecuzione di chkdsk /f su un disco sospettamente difettoso, la cancellazione diretta di file di grandi dimensioni o l'affidarsi esclusivamente all'Evento 41 per diagnosticare guasti all'alimentatore.