（11338期）ha-integration-patterns – Home Assistant集成架构开发指南

Home Assistant集成架构开发指南 OpenClaw出品的Home Assistant集成开发指南，提供HACS组件架构、服务响应模式及存储最佳实践，助力开发者构建规范智能家居扩展。 使用说明 该技能为Home Assistant自定义集成开发提供全面的架构模式指导，核心聚焦于HACS（Home Assistant Community Store）组件开发的最佳实践。文档系统性地解决了HA服务开发中的关键技术决策，包括何时使用服务响应数据模式（Service Response Data） versus HTTP视图、如何正确使用存储API（Storage Helpers）避免内部私有API、以及完整的HACS集成目录结构规范。 核心用法上，开发者可将其作为技术参考手册，在构建自定义集成时查阅特定场景的实现模式。例如，通过supports_response参数实现带返回数据的服务调用，利用HomeAssistantView构建RESTful API端点，或使用Store辅助类进行配置持久化。文档特别强调"避免使用下划线前缀的内部API"这一关键架构约束，并提供从HA 2022.x到2025.x各版本Breaking Changes的迁移指南。 显著优点包括：内容经过实战验证（源自HA-OpenClaw Bridge项目经验），涵盖从基础架构到测试清单的完整开发闭环；提供明确的决策矩阵（如HTTP View vs Service选择对照表）；代码示例详实且包含正反面对比（正确 vs 错误用法）。作为纯文档型技能，无执行风险，适合安全地作为团队开发规范参考。 潜在局限性在于：内容高度依赖Home Assistant特定版本（特别是2023.7+的服务响应特性），随着HA快速迭代可能出现文档滞后；需要开发者具备Python异步编程和HA核心概念的基础知识；代码片段仅为示例，不能直接用于生产环境，需要根据实际情况调整错误处理和边界情况。 适合目标群体包括：计划开发HACS集成的Python开发者、需要为HA构建API桥接的物联网工程师、以及希望深入理解HA架构的高级用户。不适合无编程基础的普通HA用户。 使用风险主要集中在版本兼容性方面。由于HA版本更新频繁（特别是2025.x后的Conversation Agent变更），开发者需核对目标HA版本的API可用性。此外，文档中警示的"私有API使用"风险需要特别注意——如果开发者忽视警告使用内部API，可能导致集成在HA升级后失效。建议在实施前进行30-60分钟的官方文档交叉验证，确保与当前HA版本兼容。 原始说明 Home Assistant custom integration patterns and architectural decisions. Use when building HACS integrations, custom components, or API bridges for Home Assistant. Covers service response data, HTTP views, storage APIs, and integration architecture.