【免费下载链接】house-control
Your home as a live 3D model in the Mac menu bar and on iPhone — lights and ACs via Smart Life, Home Assistant, Philips Hue and Apple Home.
House Control 是一款把家变成实时 3D 模型的 macOS 菜单栏应用(也有 iPhone 版)。它的 AI Access 功能通过 MCP 和私有链接,让 ChatGPT、Claude 等 AI 助手直接访问你的 3D 家:一句话控灯、调空调、跑场景,甚至发几张客厅照片就能重建 3D 房间。整个过程由你的 Mac 本地应答,无需服务器、无需注册账号。
House Control 是什么:菜单栏里的 3D 家
House Control 住在 Mac 菜单栏里——点房子图标弹出面板,再点别处它就消失。它把户型图渲染成一个 3D 场景:灯亮起来真的照亮房间,开着的空调会吹出可见的气流。
设备可以来自 Smart Life / Tuya、Home Assistant、Philips Hue 和 Apple Home,自由混用在一个家里;不登录任何账号时所有设备都是模拟的,可以先玩起来。
三步开启 AI Access:最快上手步骤
- 右键菜单栏图标 →AI Access…(或面板齿轮菜单 →AI access…);
- 点Start AI Access,几秒后窗口里出现你的私有链接;
- 把链接交给 AI 助手即可——下面两种方式任选。
链接存活期间,菜单栏房子旁边会出现闪烁的星标,面板里出现AI徽章;助手做的每一件事都会实时显示在窗口的Activity动态流里。点Stop AI Access立即结束;每次开启都生成新链接,旧链接永久失效。
方式一:把链接贴进聊天,一句话控灯
按Copy for a chat复制链接,连同需求一起粘贴给 ChatGPT、Claude、Gemini 等:
你可以用 House Control 控制我的家。打开这个私有链接并按里面的说明操作:https://….trycloudflare.com/k3Vb… 把客厅灯调暗到 30%,卧室空调降到 22°。
链接会打开一份专门为 AI 写的"指南":规则、每个设备的当前状态,以及每件能做的事对应的动作链接(形如…/do/light/living.main/brightness/30)。助手打开动作链接即执行,并返回最新状态——哪怕它只会浏览网页,也能操控你的家。
方式二:连接为 MCP,让助手改动 3D 家本身
改 3D 模型需要更多能力,此时把 House Control 作为 connector 接入:
- Claude:Settings → Connectors → Add custom connector,命名House Control,粘贴Claude标签页里的MCP 地址(
https://….trycloudflare.com/<key>/mcp),聊天时从工具菜单启用; - ChatGPT:Settings → Apps & Connectors → Advanced → Developer mode,用 MCP 地址创建 connector,认证选No authentication;
- Claude Code / Cursor 等 MCP 客户端:
claude mcp add --transport http house-control https://….trycloudflare.com/<key>/mcp。
AI 能做什么:9 个工具一览
| 工具 | 作用 |
|---|---|
get_home | 每个房间的灯和空调、各自能力与当前状态、场景列表 |
set_lights | 开关、亮度(%)、色温(K)、颜色;支持 id、整间房、名字或all |
set_air_conditioners | 开关、目标温度、模式、风速 |
activate_scene | 执行一个场景 |
get_floor_plan | 3D 模型的户型数据、坐标规则、家具目录 |
edit_floor_plan | 批量操作:重建房间(照片场景)、增删改房间/家具/门窗/灯/空调/场景 |
replace_floor_plan | 整体替换户型,例如照着草图画一个家 |
undo_floor_plan_edit | 撤销上一次改动 |
render_home | 渲染 3D 模型图片,让助手"看到"自己的改动效果 |
编辑会在保存前校验(未知家具、id 冲突、房间对不上都会被拒绝,并给出助手能处理的原因)。保存后你屏幕上的模型立刻更新,配对的 iPhone 也会收到;窗口里的Undo home edit或助手自己都能撤销。
照片重建房间:最惊艳的玩法
把 Claude 连上 MCP 后,附上几张照片,说一句"这是我的客厅——用 3D 重建它"。助手会读取get_floor_plan了解坐标规则和家具目录,然后用一个furnish_room操作把照片里看到的每件家具摆进房间。改完你还可以让它render_home渲染一张图来自检,不满意就undo_floor_plan_edit重做。搬家了沙发?直接告诉它就行。
权限与隐私:像房钥匙一样管理
- What it may do开关即时生效:Lights, climate and scenes(关掉后链接对设备只读)、Your 3D home(关掉后隐藏编辑工具)、链接自动失效时间(1 小时 / 8 小时默认 / 永不);
- 你的 Mac 只监听
127.0.0.1(7419 端口),局域网谁也看不到它;要对外可达时由cloudflared开一个免费的 Cloudflare Quick Tunnel,无需 Cloudflare 账号;选This Mac only则完全跳过隧道,专供本机应用(Claude Code、Cursor、脚本); - 每个地址都带 128 位随机密钥,没有密钥的每个路径都返回 404;
- Smart Life 登录态和真实设备 ID 永不离开 Mac——AI 看到的是
"linked": true,助手写的户型也会原样保留这些 id,已绑定真实硬件的设备无法通过链接被删除; - 请求限速每分钟 240 次,请求体上限 4 MB;除了你的三个设置,AI Access 不存储任何东西。
常见问题:AI 打不开链接怎么办?
| 症状 | 原因与处理 |
|---|---|
| "Cloudflare is limiting new quick tunnels" | Quick tunnel 按 IP 限速,等一分钟再开 |
| 助手说打不开链接 | 部分聊天模式只能打开它搜索到的页面;把链接单独放一行让它打开,或改用 connector |
| 助手读了指南但不点动作链接 | 让它打开那个动作的链接——或接成 MCP connector |
| connector 突然失效 | 链接变了(每次开启都是新链接),把新 MCP 地址重新粘进去 |
相关资料
- 完整说明(工具表、隐私模型、故障排查):docs/ai-access.md
- AI 网关与权限模型(Swift):core/Sources/HouseCore/AgentGateway.swift
- 9 个工具与"指南"生成(JS,MCP 与 HTTP 共用):web/src/agent/tools.js
- Cloudflare 隧道封装:macos/Sources/HouseControl/CloudflareTunnel.swift
- AI Access 窗口(macOS 壳):macos/Sources/HouseControl/AgentController.swift
- 户型字段参考:docs/floor-plan.md
一句话总结:House Control 的 AI Access 让你用一杯咖啡的时间,把家变成 ChatGPT 和 Claude 能听指挥的 3D 世界——而且钥匙随时可以收回。
【免费下载链接】house-control
Your home as a live 3D model in the Mac menu bar and on iPhone — lights and ACs via Smart Life, Home Assistant, Philips Hue and Apple Home.
相关推荐
House Control + Home Assistant:一次接入,让上千款智能家居设备进入你的3D家
House Control + Home Assistant:一次接入,让上千款智能家居设备进入你的3D家 House Control 是一款开源智能家居控制工
House Control iPhone应用教程:无需Mac也能画3D家并控制灯光空调
House Control iPhone应用教程:无需Mac也能画3D家并控制灯光空调 House Control 是一款开源免费的家庭控制应用,它把家变成一栋
House Control的plan.json完整参考:用一个JSON文件定义你的3D家
House Control的plan.json完整参考:用一个JSON文件定义你的3D家 House Control 可以把你的家变成一个可交互的 3D 模型,
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考