mkerix/room-assistant

room-assistant

镜像概述和主要用途

room-assistant 是一款房间级自动化工具，旨在将家庭自动化提升到新高度。它能够精准追踪房间占用情况和室内位置，并支持集成各类传感器，为编写强大的自动化规则提供所需数据，且可轻松与主流家庭自动化系统集成。

核心功能和特性

• 精准存在检测：准确追踪房间占用状态，即使人员静止（如坐在沙发上）也能可靠检测，解决传统运动传感器的局限性
• 室内位置追踪：高精度定位人员在房屋内的位置
• 传感器集成：支持连接各类传感器，扩展数据采集能力
• 灵活性：可根据需求选择所需功能模块，定制化配置
• 系统集成：无缝对接主流家庭自动化套件，便于构建复杂自动化场景

使用场景和适用范围

• 智能照明控制：仅在有人的房间自动开启灯光
• 温控管理：根据房间占用情况调节 heating/空调，实现节能
• 个性化环境设置：根据房间内人员自动应用其偏好的温度、电视频道等
• 家庭安全：准确检测房间内是否有人，提升安全监控能力
• 节能自动化：避免无人房间的能源浪费，降低能耗

使用方法和配置说明

安装与配置

详细的安装和配置指南请参考官方文档：room-assistant.io

Docker 部署示例

使用 docker run 命令

bash
docker run -d \
  --name room-assistant \
  --restart unless-stopped \
  -v /path/to/config:/room-assistant/config \
  --network host \
  mkerix/room-assistant

使用 docker-compose 配置

yaml
version: '3'
services:
  room-assistant:
    image: mkerix/room-assistant
    container_name: room-assistant
    restart: unless-stopped
    volumes:
      - /path/to/config:/room-assistant/config
    network_mode: host

配置说明

配置文件需放置在 /path/to/config 目录下，命名为 local.yml。具体配置选项可参考官方配置指南，包括传感器设置、存在检测参数、集成平台配置等。