使用「栖光」模板

「栖光」是一套复制到当前项目的完整 UI 方案，包含页面、控件、弹窗、主题和内置素材。创建后可替换实体、图片和文字。

适合什么时候使用

想先得到完整界面、再逐步替换设备时选择栖光。它减少初始搭建，但不会自动匹配所有设备，仍需检查实体和交互。

从创建到可用

1. 创建项目

1. 在左侧「仪表盘」区域点击「新建」。
2. 选择「栖光」UI 方案。
3. 输入容易识别的仪表盘名称。
4. 确认中控设备方向和模板画布比例；
5. 按提示创建并进入编辑器。

创建后得到的是项目副本，修改不会影响栖光方案或其他仪表盘。

2. 先浏览结构

进入编辑器后，先浏览页面、侧边栏和弹窗：

1. 确认导航能切换到目标页面；
2. 在图层列表确认控件所属区域；
3. 在「仪表盘」模式预览，再从常用房间开始替换。

先区分模板布局问题和实体未替换，避免一开始大范围删除。

3. 替换自己的实体

对需要设备状态的控件：

1. 在目标页面的「编辑」模式选中控件；
2. 在右侧「关联实体」中搜索设备名称或 entity_id 并选择；
3. 有「设备弹窗功能」时确认自动关联，或手动选择功能；
4. 保存后在「仪表盘」模式验证点按、双击和长按。

灯光通常选择 light.，开关选择 switch.，空调选择 climate.，窗帘选择 cover.，传感器选择 sensor. / binary_sensor.，摄像头选择 camera.，扫地机选择 vacuum.。实体找不到时，先回到连接 Home Assistant检查同步。

4. 替换素材和文字

• 图片控件可从「我的图片」或「栖光素材」选择；3D 导出图片在「我的图片」的导出文件夹中；
• 替换背景后检查透明度、铺满方式和图层顺序；
• 修改标题、副标题、导航文字和页面名称，让家人能看懂；
• 使用「图标按钮（效果）」时，分别检查控制按钮层和开关状态效果层；
• 不需要的控件先隐藏；确认无动作依赖后再删除。

如果要使用 3D 户型图，请先把导出的底图、户型图和灯光层添加到目标主页面，再在设备位置叠加控件并绑定实体；图片层只负责显示，具体步骤见导出后制作仪表盘。

5. 调整交互

替换实体后逐个确认：

• 点按是否切换了正确设备；
• 「打开弹窗」的来源是当前实体、其他实体还是弹窗组合；
• 跳转按钮是否指向仍然存在的页面；
• 弹窗内的模块是否绑定了自己的实体；
• 危险操作是否仍有确认提示。

动作配置完成后进入「仪表盘」模式验证，不要只看下拉框。

6. 保存并在中控设备检查

完成一个房间或一组设备后保存，检查背景、文字、间距和弹窗布局；最后在中控设备上确认方向、字号、点击范围和实时状态。

什么时候应该改用空白仪表盘

不想保留栖光结构，或要从户型图重新规划时，建议新建空白仪表盘，不要在栖光项目中大规模删除后重建。两种项目可以并存。

相关操作

• 编辑器区域、保存和快捷键： 编辑器与基本操作；
• 分辨率、页面和项目管理： 页面、分辨率与仪表盘设置；
• 控件和实体： 认识控件及实体配置；
• 弹窗、复制和批量操作： 弹窗、复制与批量操作；
• 素材和 3D 户型图： 素材与 3D 户型图。