Repolode
0xProbabillity

0xProbabillity/house-control

菜单栏与 iPhone 应用,以实时 3D 模型展示家居,并通过智能生活、Home Assistant、Hue 和 Apple Home 控制灯光与空调。

可替代:Apple Home

Star
691
Fork
100
未关闭 Issue
12
最近提交
5天前

这是什么?

House Control 用一个 JSON 文件描述户型,在 3D 场景中渲染房间、墙体、门窗和家具。灯具会照亮场景,运行中的空调会显示气流。用户可以开关和调暗灯光、设置颜色与色温,也能调整空调的开关、目标温度、模式和风速,并通过一键场景统一控制全屋设备。

应用基于原生外壳(macOS 使用 AppKit,iPhone 使用 SwiftUI)加 Three.js 网页界面构成。设备支持智能生活(Tuya)、Home Assistant、Philips Hue 和 Apple Home,并可在同一个家中混合使用。未登录时所有设备均为模拟状态,方便先行体验。可视化编辑器可用于绘制房间,并把每盏灯或空调关联到真实设备。

Mac 与 iPhone 应用可通过二维码在局域网内配对,经 TLS 同步户型,无需服务器。项目还提供菜单栏灵动岛、小组件,以及 AI Access 功能,可通过私有链接或 MCP 让 AI 助手控制灯光和空调。

核心功能

  • 01由单个 JSON 文件生成 3D 户型,灯光会照亮场景
  • 02可控制灯光(开关、调光、亮度、颜色)和空调(开关、温度、模式、风速)
  • 03同一个家中可混合接入智能生活/Tuya、Home Assistant、Hue 与 Apple Home
  • 04无需硬件或登录即可在模拟模式下体验
  • 05Mac 与 iPhone 应用通过局域网和二维码配对同步
  • 06iPhone 上提供小组件、锁屏及控制中心控件

适用场景

  • 在 Mac 菜单栏中直接控制灯光和空调,无需打开其他应用
  • 在一个界面中管理混合了 Hue、Home Assistant 和 Tuya 设备的家庭
  • 通过私有链接让 AI 助手有限度地控制家中设备
  • 在连接真实硬件前规划并可视化户型

快速上手

  1. 1

    从 Releases 页面下载 HouseControl DMG 文件

  2. 2

    克隆代码仓库

    git clone https://github.com/0xProbabillity/house-control.git
  3. 3

    在项目文件夹中构建应用

    cd house-control && ./scripts/build-app.sh
  4. 4

    打开构建好的应用,并在菜单栏中找到房屋图标

    open build/HouseControl.app

使用前须知

  • 菜单栏应用仅支持 macOS 13 或更新版本,iPhone 应用需要 iOS 17 或更新版本。
  • 应用未经过公证,首次启动时 macOS 会阻止它,需要手动允许。
  • 从源码构建需要 Xcode 命令行工具以及 Node.js 20.19+ 或 22.12+。

标签

常见问题

house-control 是什么?
菜单栏与 iPhone 应用,以实时 3D 模型展示家居,并通过智能生活、Home Assistant、Hue 和 Apple Home 控制灯光与空调。 House Control 用一个 JSON 文件描述户型,在 3D 场景中渲染房间、墙体、门窗和家具。灯具会照亮场景,运行中的空调会显示气流。用户可以开关和调暗灯光、设置颜色与色温,也能调整空调的开关、目标温度、模式和风速,并通过一键场景统一控制全屋设备。
house-control 可以免费使用吗?用的什么许可证?
house-control 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
house-control 还在维护吗?
活跃维护中。house-control 最近一次提交是在 2026年10月16日。
house-control 适合用来做什么?
在 Mac 菜单栏中直接控制灯光和空调,无需打开其他应用 在一个界面中管理混合了 Hue、Home Assistant 和 Tuya 设备的家庭 通过私有链接让 AI 助手有限度地控制家中设备 在连接真实硬件前规划并可视化户型
house-control 怎么安装和运行?
从 Releases 页面下载 HouseControl DMG 文件 克隆代码仓库: git clone https://github.com/0xProbabillity/house-control.git 在项目文件夹中构建应用: cd house-control && ./scripts/build-app.sh 打开构建好的应用,并在菜单栏中找到房屋图标: open build/HouseControl.app
在哪里获取 house-control?
源代码和安装说明在 GitHub 上:https://github.com/0xProbabillity/house-control

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目