pc-optim

/pc-optim — diagnostic read-only PC Windows

Tâche typique : « mon C:\ se remplit, je veux savoir ce qui pèse et quoi cleaner sans rien casser ». Sortie : un rapport markdown pc-optim-YYYY-MM-DD.md dans le cwd + JSON intermédiaires dans ./pc-optim-out/.

Read-only strict. Zéro Set-, New-, Remove-, Add-. Aucune modif registre / policy / service / système de fichiers en dehors du dossier de sortie.

1. Quand utiliser

• •Diagnostic trimestriel d'hygiène disque
• •Avant grosse install (jeu AAA, nouveau modèle IA local, VM Hyper-V)
• •Suspicion lenteur / disque presque plein
• •Audit DNS / VPN / ports après installation d'un nouveau soft réseau
• •Vérification rapide état Defender + firewall avant déplacement de la machine
• •Inventaire applications pour préparer une migration de PC

Pas pour :

• •Nettoyage effectif → utiliser les outils que tu possèdes déjà (SpaceSniffer, CCleaner, WingetUI, Windows Memory Cleaner) ou les 3 commandes natives Windows (ms-settings:storagesense, cleanmgr, cleanmgr /sageset:1 + /sagerun:1) listées en fin de rapport section Réflexes manuels Windows. Le rapport te dit où aller, pas quoi supprimer à ta place
• •Profiling perf CPU/GPU temps réel → HWMonitor / Task Manager
• •Scan antivirus → Windows Defender (Sécurité Windows → Analyse rapide)
• •Dépannage Windows Update → cleanmgr + DISM/SFC (cf. article hub Julienweb)

2. Pattern technique

Windows = pas de du -sh ni df -h natifs lisibles. Solution : PowerShell `.ps1` lancés en read-only via wrapper Bash, sortie JSON pivot, assemblage final via template Markdown.

pc-optim.sh (Bash MSYS / Git-Bash)
  ├─ powershell.exe -NoProfile -ExecutionPolicy Bypass -File scan_disk_usage.ps1     > _scan_disk_usage.json
  ├─ powershell.exe ... scan_ai_models.ps1                                            > _scan_ai_models.json
  ├─ powershell.exe ... scan_dev_caches.ps1                                           > _scan_dev_caches.json
  ├─ powershell.exe ... scan_duplicates.ps1                                           > _scan_duplicates.json
  ├─ powershell.exe ... scan_apps_installed.ps1                                       > _scan_apps_installed.json
  ├─ powershell.exe ... scan_network_security.ps1                                     > _scan_network_security.json
  └─ powershell.exe ... _build_report.ps1 -InputDir pc-optim-out/ -Out pc-optim-*.md

-ExecutionPolicy Bypass est per-process (pas Set-ExecutionPolicy). Aucune persistance, aucune modif registre.

3. Pipeline 6 scans + assemblage

Total : 3-10 minutes (hors winget upgrade qui dépend du nombre d'apps à mettre à jour).

4. Catégories scannées

5. Heuristique doublons (nom + taille)

Pourquoi pas de hash MD5/SHA1 ?

• •Hash récursif sur un home Windows = 20-90 minutes selon volume. Hors scope d'un rapport de diagnostic.
• •Pour 99% des doublons utiles à dégager (ISO Windows téléchargée 3x, installeur Node v18 / v20, vidéo récupérée 2 fois), (Name, Length) exact suffit.
• •Pour certifier un doublon avant suppression, l'utilisateur lance dupeGuru ou AllDup sur le sous-dossier identifié — c'est l'outil dédié.

Le rapport remonte donc des candidats, pas des certitudes. Le risque (🟢/🟡/🔴) reflète cette incertitude.

6. Mapping findings → outils Julien

Fichier templates/tools-mapping.json — chaque catégorie / sous-catégorie pointe vers l'outil idéal déjà installé chez Julien :

Article hub de référence : D:/Google Drive/_WWW_/Julienweb.fr/content/articles-publies/2024-12-02_nettoyer-optimiser-et-mettre-a-jour-votre-windows-10-11.md.

7. Usage

# Diagnostic complet (3-10 min)
cd ~/diagnostics-pc/
bash ~/.claude/skills/pc-optim/pc-optim.sh

# Sortie :
#   ./pc-optim-out/_scan_*.json   (6 JSON + 6 logs)
#   ./pc-optim-2026-06-12.md      (rapport final)

Flags d'env (skip une phase, utile pour relancer un scan rapide après changement) :

SKIP_DUP=1 SKIP_NET=1 bash ~/.claude/skills/pc-optim/pc-optim.sh
# Scans       : SKIP_DISK, SKIP_AI, SKIP_DEV, SKIP_DUP, SKIP_APP, SKIP_NET
# Post-rapport : SKIP_PDF (export PDF), SKIP_UPGRADE (winget), SKIP_OPEN (Explorer)

Top N configurable par scan via PC_OPTIM_TOPN=100 (défaut : 50).

Sortie complète

./pc-optim-out/_scan_*.json    6 JSON read-only
./pc-optim-out/_*.log          warns / AccessDenied / timeouts
./pc-optim-out/_winget_upgrade.log  trace winget
./pc-optim-2026-06-12.md       rapport markdown
./pc-optim-2026-06-12.html     HTML intermédiaire (debug/print)
./pc-optim-2026-06-12.pdf      PDF A4 branded Julienweb

À la fin : Explorer s'ouvre automatiquement, fichier PDF présélectionné.

8. Pièges connus

• •ExecutionPolicy : ne jamais lancer Set-ExecutionPolicy. Le wrapper utilise -ExecutionPolicy Bypass per-process (scope éphémère). Voir howto-execution-policy.md.
• •Windows Defender real-time scan peut throttler Get-ChildItem -Recurse dans $env:TEMP et dans les conteneurs UWP AppData\Local\Packages\*\AC. Mitigation : -ErrorAction SilentlyContinue partout + skip d'un sous-dossier si son scan dépasse 90 s. Ne pas ajouter d'exclusion Defender permanente juste pour ce skill. Voir howto-defender-exclusions.md.
• •OneDrive / Google Drive Stream placeholders : fichiers FILE_ATTRIBUTE_RECALL_ON_DATA_ACCESS. Lire Length peut déclencher un téléchargement involontaire. Solution : filtrer Attributes -notmatch 'Offline|RecallOnOpen' avant agrégation taille.
• •AccessDenied sur C:\System Volume Information, C:\Windows\CSC, UWP AC containers : tous les Get-ChildItem utilisent -ErrorAction SilentlyContinue. Le compteur de dossiers skippés sort sur stderr (X dossiers skippés (AccessDenied)).
• •`Get-NetTCPConnection` vide si lancé depuis session non-interactive (SSH headless, scheduled task SYSTEM). Hors cas Julien mais documenté.
• •`winget list` : flag --accept-source-agreements obligatoire ; fallback registry-seul si winget absent ou trop lent. La détection « peu utilisée » via UserAssist échoue sur les apps lancées seulement via raccourci épinglé Start (limite Windows).
• •Durée scan doublons : limitée volontairement aux 5 dossiers utilisateur principaux (pas tout $env:USERPROFILE) sinon 5+ min sur des Documents volumineux.
• •Admin : non requis pour 90% des scans. Sans admin, certains OwningProcess n'exposent pas leur Path complet → le rapport affiche ? à la place. _Test-IsAdmin warn en stderr si non-admin, scan continue dégradé.

9. Forkability

Skill par nature mono-machine (le PC de Julien). Pas de snapshot local de fork par défaut.

Une variante utile : baseline mensuelle pour suivre l'évolution dans le temps.

# Run et archive avec timestamp dans un dossier dédié
cd ~/diagnostics-pc/baseline/
bash ~/.claude/skills/pc-optim/pc-optim.sh
# → pc-optim-2026-06-12.md gardé en historique
# → diff manuel mois suivant : comparer Top dossiers et gains potentiels

Pour porter le skill à Linux/macOS : remplacer les .ps1 par des .sh équivalents (du -ah, find -size +, systemctl list-units, ss -tln, resolvectl status). Le squelette template + tools-mapping.json + wrapper restent identiques. Adapter tools-mapping.json aux outils Unix (BleachBit, ncdu, fdupes, etc.).

10. Référence implémentation

• •Première run : 2026-06-12 sur un poste de test (laptop i7 de 2014, Win10 Pro, C:\ plein à 95.5 %) → 16.89 GB récupérables identifiés (dont 12.5 GB de modèles IA Ollama/LM Studio, 2.6 GB temp système, 0.96 GB caches dev). Run en quelques minutes, read-only confirmé. Piège observé : le scan disque peut traîner (>10 min) quand des dossiers Google Drive Stream / OneDrive sont présents (recall placeholders) — déjà documenté §8.
• •Article hub : Julienweb.fr/content/articles-publies/2024-12-02_nettoyer-optimiser-et-mettre-a-jour-votre-windows-10-11.md
• •Pattern source : ~/.claude/skills/scan-wp-db/ (read-only diagnostic forkable)
• •Pattern orchestration : ~/.claude/skills/audit-seo/ (helpers + JSON pivot + reprise)