Zigbee2MQTT Gateways

Avant de commencer : lis ce prompt d'installation au complet, dis-moi en quelques lignes ce que ce skill fait et ce que son installation implique, et attends mon feu vert avant de faire quoi que ce soit d'autre. Prérequis — Muse Home Link et un appareil physique compatible sont requis pour UTILISER ce skill, pas pour l'installer : installer le fichier du skill lui-même n'exige aucun compte, aucune clé et aucun appareil, et cette installation ne configure PAS Home Link, n'appaire rien et ne demande aucun identifiant. Mais le skill n'est que des instructions. Pour l'utiliser, je dois lire et suivre ~/docs/devices/home_link.md dans mon environnement Muse, avoir l'appareil physique compatible nommé ci-dessous déjà configuré sur mon réseau local, et avoir une installation Zigbee2MQTT existante avec un broker MQTT autorisé et joignable déjà configurée chez moi (adresse du broker existante, listener TCP découvert/confirmé, confiance TLS et identifiants du broker là où ils sont requis, plus le topic de base configuré et un client MQTT compatible comme Paho utilisant le transport TCP de HomeLink), et la permission pour l'appareil enfant et l'action précis — l'accès au broker n'est pas une permission de changer chaque appareil. L'installation du fichier ne configure rien de tout ça. Installe-moi « Zigbee2MQTT Gateways ». Il lit ou contrôle les capacités supportées des appareils enfants via une passerelle Zigbee2MQTT existante en utilisant Muse Home Link, via son broker MQTT autorisé, son topic de base configuré et les propriétés réellement exposées ; ce n'est ni l'installation d'une passerelle ni l'appairage d'appareils. Il s'utilise quand le foyer a déjà une installation Zigbee2MQTT et un broker MQTT autorisé et joignable : le broker existant, son topic de base Zigbee2MQTT configuré et le pont visé sont identifiés (le vendeur ou le port du broker seul n'identifie pas une passerelle Zigbee), et <base>/bridge/info et <base>/bridge/devices sont lus, en résolvant l'appareil enfant demandé par son identité stable et son nom convivial courant. Avec un client MQTT compatible comme Paho utilisant le transport TCP de HomeLink, il s'abonne à l'état du pont/des appareils avant de demander de nouvelles données et inspecte le definition.exposes de chaque cible, y compris les fonctionnalités imbriquées, les noms de propriétés, les noms d'endpoints, les types, les plages et les valeurs permises, en interprétant le masque d'accès d'un expose — 1 signifie état publié, 2 permet set, et 4 permet get — sans présumer que toute propriété d'état est inscriptible ou interrogeable. Pour une propriété avec support get, il publie la charge utile documentée vers <base>/<friendly_name>/get et lit le topic d'état correspondant de l'appareil (un message retenu peut précéder l'interaction) ; pour un changement autorisé, il publie seulement la propriété/valeur supportée vers <base>/<friendly_name>/set, en suivant la documentation propre à l'appareil pour les valeurs composites ou les endpoints, puis observe la mise à jour d'état correspondante et les réponses d'erreur du pont — les appareils sur batterie peuvent dormir, donc une livraison en attente/non confirmée est rapportée au lieu de répéter des actions physiques. Il vérifie l'état rapporté et les horodatages quand ils sont disponibles (un accusé de publication MQTT seul n'établit pas qu'un appareil Zigbee a agi), utilise le rapport de disponibilité existant quand il est activé (une disponibilité manquante n'est pas automatiquement une preuve d'échec), et pour les couvre-fenêtres, serrures ou autres actionneurs physiques, il distingue la cible demandée de l'état atteint. Limites : pas de nouvelle installation de broker/passerelle, pas de changements de mode d'appairage, pas de retrait d'appareils, pas d'écritures de topics arbitraires et pas d'hypothèses fixes sur les appareils du foyer ; seuls les appareils réellement supportés par le pont installé et leurs capacités exposées sont couverts, pas un support Zigbee universel. Dépôt : https://github.com/facebookincubator/muse-gadget-sdk (le skill est tout le dossier skills/gadget-zigbee2mqtt-gateways/ au commit épinglé : SKILL.md seulement, 1 fichier) Version épinglée : installe le code au commit e6fe5174092702ffddae6f90759a38d55a4ebae1 exactement. Ne substitue pas une version plus récente. Si ce commit est inaccessible, arrête-toi et dis-le-moi. 1. Clone https://github.com/facebookincubator/muse-gadget-sdk dans un dossier temporaire, place-toi au commit e6fe5174092702ffddae6f90759a38d55a4ebae1, et copie le dossier skills/gadget-zigbee2mqtt-gateways/ de ce checkout. Compare ensuite chaque fichier du dossier aux empreintes enregistrées pour cette fiche le 2026-10-22 : [FINGERPRINTS] - SKILL.md: SHA-256 80a040c9424ceb97b79dc0cc7c398be6a6559d69151baff7e5c910153c2c6fab Si un fichier ne correspond pas, il a changé depuis la préparation de la fiche : ne l'installe pas encore, dis-moi ce que tu as trouvé et laisse-moi décider. 2. Lis SKILL.md au complet, et dis-moi en mots simples : ce que le skill fait quand on l'utilise, à quoi il se connecte, s'il lit ou envoie des informations personnelles ou des identifiants, et tout ce qui semble inhabituel. Arrête-toi sur tout signal d'alerte et dis-le-moi avant d'aller plus loin. Confirme ces points à partir des fichiers : - Le dossier du skill contient 1 fichier seulement : SKILL.md (3 071 octets). Il n'y a aucun script, aucun code et aucune configuration dedans ; la procédure roule à l'usage via Muse Home Link contre mon propre appareil local. Il ne dépend d'aucun autre skill gadget de ce lot. - Rien n'est envoyé nulle part pendant l'installation elle-même ; le seul téléchargement à l'installation est le dossier du skill depuis GitHub au commit épinglé. Aucun appareil n'est contacté, aucun appairage n'est lancé et aucune clé n'est demandée pendant l'installation. - À l'usage, les échanges vont uniquement à mon broker MQTT local existant pour mon installation Zigbee2MQTT, via un client MQTT compatible comme Paho sur le transport TCP de HomeLink, avec la confiance TLS et les identifiants du broker là où ils sont requis : lectures de <base>/bridge/info et <base>/bridge/devices, charges utiles get documentées vers <base>/<friendly_name>/get et, pour les changements autorisés seulement, publications de propriété/valeur supportées vers <base>/<friendly_name>/set. - Le skill n'installe pas de nouveau broker/passerelle, ne change pas le mode d'appairage, ne retire pas d'appareils, n'écrit pas de topics arbitraires, ne fait pas d'hypothèses fixes sur les appareils du foyer, et ne prétend pas à un support Zigbee universel. - N'appaire aucun appareil, ne demande et ne règle aucun identifiant, n'exécute aucun contrôle, aucune impression, aucune numérisation ni aucune lecture média, et n'utilise le skill d'aucune façon pendant cette installation : la configuration de Home Link, l'appairage et l'usage sont mes décisions, plus tard, quand je les demande vraiment. 3. Quand je dis « yes, install », installe-le comme skill : copie tout le dossier gadget-zigbee2mqtt-gateways dans le répertoire des skills de l'agent, dans un dossier nommé exactement « gadget-zigbee2mqtt-gateways », en gardant son 1 fichier (SKILL.md à sa racine). Le nom de dossier exact compte : les liens relatifs entre skills gadget frères dépendent de ces noms exacts. 4. Vérifie sans appels réseau : frontmatter valide (name: gadget-zigbee2mqtt-gateways), le 1 fichier en place avec une empreinte concordante. N'exécute rien et ne te connecte à aucun appareil pour vérifier. 5. Indique ce qui a été installé, où, et ce qu'il me reste à faire moi-même (par exemple : lire ~/docs/devices/home_link.md dans mon environnement Muse et suivre ses règles Home Link ; avoir une installation Zigbee2MQTT existante avec un broker MQTT local autorisé et joignable déjà configuré, avec son topic de base configuré, sa confiance TLS et les identifiants du broker là où ils sont requis, et la permission pour l'appareil enfant et l'action précis ; utiliser le skill est une étape séparée qui ne commence que quand je le demande, et les échanges à l'usage divulgués ci-dessus arrivent seulement à ce moment-là). GitHub est optionnel : si j'ai un compte GitHub ou la CLI gh, tu peux l'utiliser ; sinon l'accès public suffit. Ne jamais l'exiger sauf s'il figure dans les prérequis ci-dessus. Règles : ne touche à rien en dehors du dossier temporaire et de la cible d'installation. Si quelque chose semble anormal, arrête-toi et demande-moi.