hass-config-flow

用途：在 NixOS 主机的 Home Assistant 上通过 REST API 完成集成添加、实体查询、配置流管理与 API 令牌创建等操作。NixOS 的 extraComponents 已打包集成代码，但仅支持配置流的集成（如 Spotify、Matter、HomeKit Controller、Cast）仍需 REST API 或 UI 完成设置。\n\n主要能力：优先使用已安装在 NUC 上的 hass-cli 做实体列表、服务调用、设备/区域管理及事件监听；使用 curl 处理配置流、应用凭据等 hass-cli 未覆盖的场景。\n\n必要用法：先获取令牌，hass-cli 需设置 export HASS_SERVER=http://localhost:8123 和 export HASS_TOKEN=<token>；常用命令如 hass-cli state list 'light.'、hass-cli service call homeassistant.toggle --arguments entity_id=light.office。curl 请求发送到 http://127.0.0.1:8123，带 Authorization: Bearer $TOKEN。启动配置流示例：POST /api/config/config_entries/flow，体为 {"handler": "spotify"}。OAuth 集成需先 POST /api/config/application_credentials 注册凭据。令牌可由 /var/lib/hass/.storage/auth 生成 JWT，或在 UI 的 Profile → Security → Long-Lived Access Tokens 创建；验证：curl -s -H "Authorization: Bearer $TOKEN" http://127.0.0.1:8123/api/ 应返回 {"message":"API running."}。\n\n限制：hass-cli info 在当前 HA 上因端点弃用而失效，其余命令可用；API 仅本机可达，HTTPS 经 Tailscale serve；scripts/ 下脚本不在 NUC 上，需通过 SSH 内联执行；具体集成细节见 references 中文件。其他未提供信息暂未说明。