AgentSkillsCN

ha-entity-architecture

分层 Home Assistant 自定义实体架构——CoordinatorEntity 基础、平台/类别基础、仅注册表平台文件、翻译支持命名、稳定 ID 和选项重新加载连接。

SKILL.md
--- frontmatter
name: ha-entity-architecture
description: Layered Home Assistant custom entity architecture—CoordinatorEntity bases, platform/category bases, registry-only platform files, translation-backed naming, stable IDs, and options reload wiring.
license: Complete terms in LICENSE.txt

HA Entity Architecture

Use when organizing entities for a custom component.

Quick start

  • •Create shared base (CoordinatorEntity) for device_info/availability/data helpers.
  • •Add platform bases (sensor/binary_sensor/etc.) and optional category bases.
  • •Keep platform files as registries; concrete entities live in grouped modules.
  • •Set _attr_has_entity_name=True and _attr_translation_key for localization; avoid hardcoded names.
  • •Register options update listener to reload on change.

References