用途：辅助 Home Assistant（HA）开发，涵盖自动化、仪表盘（桌面+移动）、通过 MCP 接入 AI 智能体以及自定义集成，遵循 2024–2026 最佳实践，始终使用现代语法，移动优先、家庭友好、本地优先。
主要能力与要点：
- 现代语法：使用 triggers:/actions:/action:，避免 service:/platform: 等旧写法。
- 本地优先：尽量用 Ollama + home-llm 替代云端 LLM。
- MCP 优先：通过官方 MCP Server（/api/mcp）连接 AI 智能体；仅“已暴露”实体才会成为 MCP 工具；Cursor 等 stdio 客户端需 mcp-proxy 桥接，官方 HA MCP 仅支持 Streamable HTTP。
- UI 走 HACS：自定义卡片与主题通过 HACS 安装，而非手动。
- 常见陷阱：Blueprint 的 !input 需先暴露为 variables 才能在模板中使用；Bubble Card 弹窗必须放在视图 YAML 最后；运动灯自动化用 restart 模式；传感器模板需加 unavailable/unknown 守卫；card-mod 用 $ 穿透 Shadow DOM；存在检测用 person + zone。
- 版本门槛：MCP 需 2025.2+，Sections 仪表盘需 2024.3+，AI Tasks 需 2025.8+，需确认用户 HA 版本。
使用方式：按任务查阅参考文档——MCP 与 AI 集成见 reference/mcp.md，自动化与模板见 reference/automations.md，仪表盘见 reference/dashboards.md，自定义集成见 reference/integrations.md，辅助实体与运维见 reference/helpers-and-ops.md。连接 AI 智能体示例：claude mcp add --transport http --url https://<your-ha>/api/mcp home-assistant。
适用场景：家庭自动化、跨设备仪表盘、AI 语音/智能体接入、自定义集成开发。
限制：资料未提供具体收费、价格、平台支持范围与效果数据；部分功能受 HA 版本限制。