Un artículo de XDA de la semana pasada contaba una casa inteligente que se desmoronó en una noche. El propietario ordenó los nombres de sus dispositivos, presionó guardar, y cada automatización que hacía referencia a los IDs antiguos se quedó en silencio. Las luces dejaron de reaccionar al movimiento. La rutina matinal omitió la mitad de sus pasos. El panel de control se llenó de signos de exclamación rojos. Nada en Home Assistant les advirtió antes del cambio; nada lo revirtió después.
Esa historia es suficientemente común como para que el nombrado de entidades de Home Assistant merezca su propio conjunto de herramientas, no solo un renombramiento de tarde lluviosa. Las siete aplicaciones de escritorio a continuación cubren lo que necesitas antes de tocar un solo ID: refactorizaciones en seco, linting de YAML, búsqueda entre archivos, alias que mantienen el nombre amigable separado de la clave de máquina, flujos de renombramiento de Zigbee y Z-Wave que se sincronizan con las entidades, y control de versiones para que los errores sean reversibles en segundos.
Qué buscar en una configuración de nomenclatura de entidades
- Refactorización en seco. Un renombramiento debe previsualizar cada automatización, script, escena, panel de control y referencia de plano antes de confirmar nada.
- Linting de YAML. Una indentación rota o un
entity_id:colgante debe fallar en tu editor, no en tu rutina matinal. - Búsqueda de ID de entidades en automatizaciones, scripts y escenas. Un atajo para encontrar cada lugar donde aparece
light.living_room_lamp, incluyendo dentro de plantillas. - Soporte de alias. Los nombres amigables deben ser libres de cambiar sin tocar el ID de entidad subyacente en el que dependen las automatizaciones.
- Renombramiento de dispositivos Zigbee y Z-Wave que se sincroniza con las entidades. Renombrar un dispositivo en la UI de ZHA o Z-Wave JS debe propagarse a cada entidad que expone ese dispositivo, no dejar huérfanos.
- Configuración controlada por versión. Git o equivalente para que un refactorización mala esté a un
git revertde la curación.
Comparación rápida
| Aplicación | Lo mejor para | Maneja referencias de renombramiento | Costo |
|---|---|---|---|
| Home Assistant | El diálogo de renombramiento principal | Sí, nativo | Gratuito |
| Studio Code Server | Edición y búsqueda de YAML | Sí, mediante búsqueda en archivos | Gratuito |
| HACS | Instalando el resto de esta lista | No, requisito previo | Gratuito |
| ESPHome | Hardware DIY, fuente única de verdad | Sí, en tiempo de compilación | Gratuito |
| Node-RED | Automatizaciones visuales complejas | Parcial, por flujo | Gratuito |
| Automation Editor | Edición de automatización única en UI | Sí, nativo | Gratuito |
| Custom Brand Icons | Auditoría visual de convenciones de nomenclatura | No, captura desviaciones visualmente | Gratuito |
Las aplicaciones
1. Home Assistant
Descargar: Home Assistant
Comienza aquí, porque el núcleo mejoró mucho en esto. Desde la versión 2023.4, el diálogo de configuración de entidades incluye una herramienta “Entity ID rename” que busca automatizaciones, scripts, escenas, paneles de control y planos para referencias al ID antiguo y ofrece actualizarlos en un solo paso. Se ejecuta como una vista previa primero, listando cada coincidencia con su archivo y línea, y solo se confirma cuando se verifica.
Esa vista previa es la red de seguridad más útil en la pila. Atrapa referencias plantillas dentro de Jinja que una búsqueda de texto plano pasaría por alto, e identifica casos donde un ID aparece dentro de un ancla YAML o un archivo de paquete que la UI de otro modo no tocaría. Cuando no puede resolver una referencia automáticamente (un ID de entidad construido en tiempo de ejecución a partir de una variable, por ejemplo), lo dice en lugar de pasar silenciosamente.
El problema: solo conoce las fuentes que puede ver. Las integraciones personalizadas que almacenan IDs de entidades en sus propios archivos JSON, o flujos de NodeRED guardados fuera de .storage, necesitan un segundo paso con las herramientas más abajo en esta lista.
2. Studio Code Server
Descargar: Studio Code Server
El complemento instalado por HACS que pone un VS Code completo en una pestaña de navegador, apuntado directamente a /config. El linting de YAML está habilitado por defecto, la extensión de Home Assistant viene preinstalada, y Ctrl+Shift+F hace una búsqueda en todo el proyecto que respeta .gitignore.
Para nomenclatura de entidades, aquí es donde ocurre la auditoría del segundo paso. Después de que se ejecute el diálogo de renombramiento principal, abre Studio Code Server, busca el ID antiguo y confirma que hay cero coincidencias. Si alguno regresa, generalmente están en archivos que el diálogo no puede inspeccionar: definiciones de comandos shell, URLs de sensores REST, o sensores de plantilla construidos con state_attr(). Corrígelos allí, confirma, recarga.
El autocompletado merece su propia mención. Escribe entity_id: y sugiere el registro en vivo, por lo que los errores tipográficos nunca sobreviven al tiempo de ejecución. Renombra un dispositivo mañana y las sugerencias se actualizarán en el próximo recargo.
3. HACS (Home Assistant Community Store)
Descargar: HACS
No es una herramienta de nomenclatura, sino un requisito previo. HACS es el gestor de paquetes de la comunidad que instala Studio Code Server, Custom Brand Icons y varias integraciones de calidad de vida que hacen posible el resto del flujo de trabajo. La configuración es única: habilita el modo avanzado en tu perfil, coloca la integración HACS a través de un comando shell, reinicia y añade la integración.
Dos hábitos que vale la pena adoptar una vez que HACS está en su lugar. Primero, fija versiones en lugar de seguir main en cualquier cosa que toque entidades, porque un cambio incompatible sorpresa durante un refactorización de renombramiento es el peor momento posible. Segundo, usa la vista de registro de cambios integrada de HACS antes de cada actualización. A menudo es el único lugar donde se señala el comportamiento de cambio de renombramiento con anticipación.
4. ESPHome
Descargar: ESPHome
Para cualquier cosa en hardware ESP32 o ESP8266, ESPHome es la capa de nomenclatura. Establece name: living-room-lamp una vez en el YAML del dispositivo y cada entidad que se flashea a esa placa (light.living_room_lamp, sensor.living_room_lamp_temperature, lo que sea) obtiene un ID coincidente. Cambia el campo name:, reflashea, y Home Assistant verá los nuevos IDs en el próximo arranque.
Esa única fuente de verdad es lo que evita el tipo de desviación que describió el artículo de XDA. El patrón antiguo era: renombra el dispositivo en Home Assistant, renómbralo de nuevo en ESPHome, espera que ambos lados estén de acuerdo. El patrón actual es: renómbralo en ESPHome, deja que Home Assistant siga. Es un área de superficie más pequeña para mantener consistencia, y los archivos .yaml controlados por versión significan que cada renombramiento es una diferencia en un repositorio.
Combínalo con el diálogo de renombramiento principal para el cambio inicial. ESPHome crea los nuevos IDs en el primer arranque; el diálogo rescribe las referencias a los antiguos. Dos pasos, sin huérfanos.
5. Node-RED
Descargar: Node-RED
Cuando las automatizaciones superan veinte o treinta y el editor de YAML comienza a sentirse estrecho, el editor de flujo visual de Node-RED es el paso siguiente habitual. Los IDs de entidades se convierten en ciudadanos de primera clase en el lienzo: cada nodo que toca uno lo muestra en la etiqueta, y la barra lateral tiene una búsqueda de registro en vivo para que los IDs mal escritos sean imposibles de guardar.
Para nomenclatura de entidades específicamente, la búsqueda por flujo de Node-RED es la herramienta. Abre un flujo, presiona Ctrl+F, escribe el ID antiguo, y cada nodo que lo referencia se ilumina. Renombra en lote a través de los paneles de configuración de nodos, desplega, hecho. Los flujos se exportan como JSON, así que viven felices en el mismo repositorio git que el resto de la configuración.
La compensación: Node-RED se ejecuta junto al propio motor de automatización de Home Assistant en lugar de reemplazarlo, así que un renombramiento de ID de entidad ahora debe aplicarse en dos lugares. Mantén una lista de control.
6. Automation Editor (integrado)
Descargar: Automation Editor (se envía con Home Assistant)
El editor de UI estándar a menudo se subestima. Para ediciones de automatización única, trata los IDs de entidades como referencias buscables: cambia el selector de entidad del disparador y los campos de condición y acción correspondientes se actualizan en el mismo guardado. Sin edición manual de YAML, sin riesgo de una coma extraviada.
Donde gana su lugar en esta lista es el mensaje “Rename” que aparece cuando cambias un dispositivo o entidad que la automatización referencia. Ofrece la misma vista previa de actualización-referencias-en-toda-la-configuración que hace el diálogo principal, limitado a la automatización que tienes abierta. Para el caso común, edita una automatización, nota que la entidad vinculada obtuvo un ID más amigable, acepta el renombramiento, guarda y continúa.
Para cualquier cosa que abarque múltiples automatizaciones, usa el diálogo de renombramiento principal en su lugar. Este es para cambios de archivo único quirúrgicos.
7. Custom Brand Icons
Descargar: Custom Brand Icons
El que es diferente, y el que se paga a sí mismo más rápido. Custom Brand Icons es una integración HACS que te permite adjuntar iconos de proveedor y producto a entidades por patrón. Dale a cada entidad light.living_* el mismo icono de lámpara, cada sensor.*_battery el mismo icono de batería, cada switch.plug_* el mismo icono de enchufe.
El beneficio de refactorización de nomenclatura es visual. Abre el panel de control después de un renombramiento y cualquier entidad que cayó fuera del patrón (un error tipográfico, un alias obsoleto, un dispositivo que fue renombrado pero no el ayudante vinculado) muestra el icono de respaldo predeterminado en lugar del icono de familia. Un renombramiento incorrecto aparece como un valor atípico visual antes de aparecer como una automatización rota.
Establece los patrones una vez contra tu convención de nomenclatura, guárdalos en configuration.yaml, y cada renombramiento futuro o coincide con el patrón o se anuncia a sí mismo.
Cómo elegir la pila correcta
La capa base, para cada configuración: Home Assistant más HACS más Studio Code Server más git. Esa combinación te da el diálogo de renombramiento principal, la búsqueda del segundo paso, el canal de paquetes de la comunidad para cualquier cosa más, y el botón deshacer.
Añade ESPHome si alguna de tus entidades proviene de hardware DIY. Mueve la fuente de verdad para esos nombres fuera de la UI de Home Assistant y hacia YAML controlado por versión, y elimina una clase completa de errores de desviación.
Añade Node-RED si tienes más de varias docenas de automatizaciones o si alguna abarca más de tres o cuatro pasos. El editor visual es más fácil de auditar en escala, y la búsqueda por flujo es cómo atrapas IDs huérfanos en flujos complejos.
Añade Custom Brand Icons temprano en lugar de tarde. Configurar los patrones antes de un renombramiento significa que el panel de control se convierte en una herramienta de detección de cambios, no solo una pantalla.
El Automation Editor siempre está disponible y vale la pena usarlo para ediciones de archivo único. No es un reemplazo para el diálogo de renombramiento principal cuando un cambio toca múltiples automatizaciones, pero es el camino más rápido para la limpieza cotidiana.
Preguntas frecuentes
¿Renombrar una entidad en Home Assistant actualiza automáticamente cada automatización que la usa?
Desde la versión 2023.4, el diálogo de renombramiento de ID de entidad busca automatizaciones, scripts, escenas, paneles de control y planos para referencias y ofrece actualizarlos en un solo paso. Muestra una vista previa primero. No puede ver referencias dentro de integraciones personalizadas que almacenan IDs en sus propios archivos o dentro de flujos de Node-RED, así que una búsqueda del segundo paso en Studio Code Server sigue siendo digna de ejecutar después de cada renombramiento.
¿Cuál es la diferencia entre el nombre amigable y el ID de entidad?
El ID de entidad (light.living_room_lamp) es la clave de máquina que las automatizaciones, scripts y plantillas usan para dirigirse a la entidad. El nombre amigable (“Living room lamp”) es la etiqueta que aparece en paneles de control, asistentes de voz y notificaciones. Cambia el nombre amigable libremente; el ID de entidad permanece estable y ninguna automatización se rompe. Cambia el ID de entidad solo a través del diálogo de renombramiento para que las referencias se actualicen.
¿Deben renombrarse los dispositivos desde la UI de integración o desde la configuración de entidad?
Renombra el dispositivo desde la UI de integración (ZHA, Z-Wave JS, ESPHome, etc.) cuando el objetivo es cambiar cada entidad que expone ese dispositivo a la vez. Renombra la entidad individual cuando solo una de las entidades del dispositivo necesita un ID diferente. Ambos flujos ahora activan la misma vista previa de actualización de referencias, así que la red de seguridad es la misma de cualquier forma.
¿Cómo auditas una configuración de Home Assistant en busca de errores tipográficos de ID de entidad antes de que causen interrupciones?
Studio Code Server con la extensión de Home Assistant es la auditoría más rápida. Abre una búsqueda en todo el proyecto para entity_id: y escanea cualquier cosa que no autocomplete contra el registro en vivo. Para una comprobación con script, hassio ha check (el equivalente CLI del validador de configuración integrado) marcará referencias a entidades que no existen, y un git diff después de cada cambio hace que la revisión sea un hábito de un comando.
¿Es seguro renombrar entidades en una instancia de Home Assistant en producción?
Más seguro de lo que solía ser, si el renombramiento pasa a través del diálogo de configuración de entidades o el mensaje vinculado del editor de automatización. Haz una copia de seguridad primero desde la UI, haz el renombramiento durante una ventana tranquila, y recarga la integración afectada o reinicia Home Assistant después del cambio. Si algo se ve mal, el repositorio git que el resto de esta pila te anima a mantener es la forma más rápida de volver al estado anterior.
