ez-ui 是面向 Home Assistant 的网页界面访问工具，主要用于可视化验证、仪表盘检查和基于浏览器的测试。
用途：当用户要求检查仪表盘、验证界面状态或进行浏览器端测试时使用。
访问方式：本地访问 Home Assistant UI 的地址为 http://<HA_HOST>:8123；在 ez-ha 插件容器内部使用 http://homeassistant:8123。插件内会自动设置 HA_URL 环境变量。
认证：API 请求使用 HA_TOKEN（插件内自动设置）。浏览器访问需先运行 browser-login（见 scripts/browser-login.mjs）完成会话认证，命令为 browser-login（使用插件配置中的 HA_BROWSER_USER / HA_BROWSER_PASS）或 browser-login <user> <pass>。会话保存在 /data/browser-profile/state.json，可由 Playwright 通过 storageState 加载。建议为智能体创建不带 2FA 的专用 HA 用户。
浏览器测试：browser-login 底层使用 Playwright。Playwright 通过基于角色的选择器自动穿透 shadow DOM，比手动遍历更可靠。可用 npx playwright screenshot http://homeassistant:8123/lovelace/0 dashboard.png 截图，或在 Node.js 脚本中启动 chromium 并加载 storageState 后访问页面截图。
常用 UI 路径：/lovelace/ 默认仪表盘；/config/ 设置与配置面板；/config/automation/ 自动化编辑器；/config/script/ 脚本编辑器；/config/scene/ 场景编辑器；/developer-tools/ 开发者工具（服务、状态、模板）；/developer-tools/state 实体状态浏览；/developer-tools/service 服务调用测试；/developer-tools/template Jinja2 模板测试；/history/ 历史图表；/logbook/ 日志；/map/ 地图视图。
限制：资料未提供更多功能、收费或平台支持信息。