hauser

Hauser 是一个自托管的、以房间为中心的 Home Assistant 仪表板，专为墙面平板、平板电脑和手机设计。它定位为家庭成员的平静日常界面，而 Home Assistant 仍作为操作员和管理员界面。该项目处于首个公开技术测试版（AGPL 许可的业余项目），可通过 Docker Compose 或作为 Home Assistant 应用安装。 主要功能包括： - **房间**：气候、灯光、场景、存在和窗户状态，每个都以三种照明状态展示，并跟随实际灯光。 - **房间图像**：向导可从手机照片生成自定义插图，使用 OpenAI（付费，可选）、Cloudflare Workers AI（免费层）或手动绘制。 - **Home Assistant 集成**：通过官方客户端的 WebSocket，乐观命令带协调、重连处理，以及来自 `sun.sun` 的昼夜主题。 - **媒体**：Jellyfin 库、架子、详情视图、带恢复播放的 HLS 播放；通过 HA 媒体播放器播放房间音频。 - **能源**：来自真实功率传感器的实时负载和每日消耗，具有诚实的空状态。 - **日常**：日历、笔记、提醒、购物清单、洗衣通知。 - **文档**：受 PIN 保护的 Paperless-ngx 搜索、预览、下载和通过可选伴服务器导入。 - **设备**：从界面内添加、隐藏、重命名、分配到房间并重新排序实体。 - **编辑和使用模式**：一个开关区分配置和操作；使用模式关闭配置门，可选地由 PIN 保护并带空闲超时。 - **待机**：带时钟、周条、笔记和购物清单的平静锁屏；可选地显示从 OpenStreetMap 数据渲染的您所在城镇的淡色街道地图。 - **两种外壳**：横向墙面面板和单手手机布局，共享一个设计系统。 - **酒店模式**：可选访客界面，用于度假公寓，入住来自 Home Assistant 日历，默认拒绝设备释放，PIN 保护的管理员会话和访客结账。 架构：应用是 Svelte 5 + Vite，在 UI 和后端之间有四层适配器（实体存储、待处理意图覆盖、命令队列、可交换后端）。它支持两种到 Home Assistant 的传输方式：作为 Home Assistant 应用（通过 Supervisor 的仅服务器连接）或使用 Docker Compose（浏览器直接连接）。服务器保存经过验证的家庭配置、房间图像存储、待机地图渲染器、集中存储的提醒、可选的 Notion 购物来源和受 PIN 保护的 Paperless-ngx 桥接。集成凭据保留在服务器端。 安装：支持两种路径——作为 Home Assistant 应用（适用于 HA OS/监督）或使用 Docker Compose（适用于 HA 容器、纯 Docker 主机、NAS）。两者都以引导式设置向导结束，涵盖语言选择、Home Assistant 连接、区域发现、房间审查、Jellyfin 启用和原子配置激活。发布镜像为 `ghcr.io/ralleur/hauser:v0.37.2`（当前）。静态演示针对模拟设备运行真实界面，而无需连接到访客的 HA。 文档包括 wiki、设计系统文档、交互契约、性能预算、安装契约、配置参考和开发人员指南。该项目强调性能预算（触摸反馈低于 16 毫秒，仅使用 transform/opacity）、乐观 UI 与协调，以及跨所有表面的统一设计系统。