HACS ora è integrato — e il mio lavoro a mano invisibile

Se aggiorni Home Assistant alla 2026.11, succede una cosa che non ti chiede nulla: HACS diventa parte del nucleo. Non devi installarlo, non puoi rifiutarlo, e se non l’hai mai voluto, adesso ce l’hai lo stesso.

Da me l’aggiornamento è passato il 6 novembre alle 21:32. La voce di configurazione marketplace era semplicemente lì:

marketplace/info ->
  version:     2026.11.0
  categories:  integration, theme, plugin, template
  stage:       running

Secondo le note di rilascio l’installer di HACS finisce esattamente con questa versione. Chi aveva HACS viene migrato. Chi non ne aveva — come la mia istanza di Kapfenberg — lo riceve in omaggio.

Ecco cosa cambia davvero. Compresa la cosa che mi è quasi costata una falsa segnalazione di bug.

Tre case, tre posizioni diverse

L’aggiornamento colpisce le mie tre istanze in modo diverso, perché le ho gestite in modo diverso:

Luogo	Prassi finora
Kapfenberg	HACS evitato di proposito. Ciò che non era incorporato veniva scaricato come archivio di rilascio da GitHub e scompattato a mano.
Merano	HACS in uso per tre integrazioni — telecamere, dispositivi Meross, Xiaomi.
Vienna	HACS per esattamente un’integrazione, una misura di velocità.

Per mesi la documentazione di Kapfenberg ha portato la riga «finora HACS non serve per niente». Avevo persino rifiutato una volta una dipendenza da HACS perché si trattava solo di una dimensione di carattere — una dipendenza permanente per una dimensione di carattere è un cattivo scambio.

Quella decisione ora è priva di oggetto. Non sbagliata col senno di poi, solo archiviata.

Cosa si rompe subito

I template che puntano a HACS. Chi usa integration_entities('hacs') d’ora in poi scrive integration_entities('marketplace'). Da me non compare né l’uno né l’altro, ma chi ha una scheda riepilogativa delle estensioni installate guardi lì per prima cosa.

I percorsi documentati verso gli add-on. La 2026.11 ha rinominato gli add-on in «app». Il pannello ora è app, non hassio. Ogni guida in rete che citi un percorso del tipo /hassio/addon/<nome>/config da allora finisce in un 404 — e sono tante.

La parte che mi ha sorpreso

Installato a mano significa: invisibile.

L’indice del Marketplace contiene 6.194 progetti. Prima del mio primo download, in tutto quell’elenco nessuna singola voce risultava «installata» — benché sette cartelle stessero sotto custom_components/ e funzionassero perfettamente.

Il Marketplace conosce solo ciò che ha messo lì lui. Quello che hai copiato dentro a mano per lui non esiste.

In pratica significa che il download non è un aggiornamento ma una nuova installazione sopra quella esistente. Da me è andata liscia — voce di configurazione e chiave memorizzata intatte:

versione manifest:     1.2.1      config_flow: true
voce configurazione:   loaded     source: user
installato:            sì         versione: v1.2.1
telecamere: 10         sensori di età immagine: 8, nessuno senza valore

Ma chi guarda per la prima volta e legge «non installato» mentre l’integrazione funziona visibilmente fa bene a esitare.

Il vero guadagno non è il nuovo numero di versione, ma che gli aggiornamenti ora arrivano da soli. Per tre mesi ho tirato dentro a mano gli aggiornamenti di quest’unica integrazione. Finisce qui.

La falsa pista, e come è venuta fuori

Ora la parte che stavo per segnalare a un progetto.

Prima del download l’indice diceva config_flow: false, mentre il manifest installato della stessa integrazione riportava config_flow: true. Sembrava un riscontro vero: se l’indice dice false, dopo il download l’interfaccia potrebbe non offrire alcun pulsante per aggiungere. La segnalazione era già scritta.

Poi la controprova su tutto l’indice:

	Voci	di cui config_flow: true
Integrazioni, non installate	4.981	0
Integrazioni, installate	1	1

Zero su 4.981. Il campo è semplicemente vuoto finché non è installato nulla — viene riempito dal manifest locale, non dall’indice. Nessun riscontro, solo lo stato normale.

Sarebbe bastato un solo valore di confronto per vederlo prima. È la stessa lezione della mia caccia alle telecamere: un’osservazione non è uno schema. Prima di segnalare qualcosa, guarda com’è fatto il caso normale.

Cosa il Marketplace non sa fare

Elenca solo integrazioni, non add-on. Chi gestisce un add-on di accompagnamento continua a mantenerlo a mano tramite la sorgente dell’add-on. Da me l’integrazione sta alla 1.2.1 e il suo add-on resta alla 1.2.0 — ed è giusto così, perché secondo le note di rilascio è cambiata solo l’integrazione.

È un punto che genera confusione: due cose con lo stesso nome e lo stesso numero di versione, ma solo una delle due ora viene rifornita automaticamente.

Cosa ti consiglio

1. Cerca 'hacs' nei tuoi template. È l’unica modifica che restituisce silenziosamente valori sbagliati invece di dare errore.
2. Non aspettarti di ritrovare il tuo lavoro a mano. Le integrazioni installate manualmente risultano «non installate». Scaricarci sopra da me ha funzionato, ma fai prima un backup.
3. Controlla nelle guide i percorsi /hassio/ prima di seguirle. Gli add-on adesso sono app.
4. Rallegrati della parte giusta. Il guadagno non è il numero di versione, ma una cosa in meno da tirare dentro a mano.

E quindi?

A Kapfenberg ho argomentato a lungo perché non volessi HACS: una dipendenza permanente in più per cose che posso anche scompattare a mano una volta. Quella posizione ora è archiviata, senza che io abbia deciso nulla.

Non è né un bene né un male, ma è degno di nota: un’astensione consapevole tenuta per mesi è stata annullata da un aggiornamento di routine. Chi vuole tenere snella la propria installazione non lo decide più a questo punto.

Il mio verdetto pratico: il passaggio non ha rotto nulla e mi toglie lavoro manuale ricorrente. Ma mostra che «non installo niente di cui non abbia bisogno» alla lunga non è una strategia — è uno stato intermedio.