1. 更新 JS 和 Resource 版本 URL 后完整刷新浏览器。
2. 仪表盘 → 编辑 → 添加卡片，搜索“室内环境 / 空气传感器”。
3. 打开可视化配置界面，选择 PM2.5、温度、湿度、甲醛实体。每项有一个搜索框和一个下拉列表：搜索框用于筛选，**必须从下方列表选中实体**才会保存选择。
4. 在“亮度实体”中选择 `light`、`number` 或 `input_number`。这里不会列出只读 sensor。
5. 可设置标题、副标题、卡片配色、等级实体、仪表下方说明。
6. 展开“历史与统计”，可启用历史和选择今日最低、最高、平均的统计实体；不选就保留历史计算。
7. 保存卡片。清空某项选择后，该指标显示 `—`。初始空卡片允许进入编辑器，不强制预先填写 YAML。
现有 YAML 卡片同样可使用可视化编辑器，修改实体时会保留原有其他配置。编辑器顶部应显示“可视化编辑器 v1.3.0”，否则仍是旧资源。编辑器使用 HA 官方 WebSocket `get_states` 获取真实实体列表；优先避免枚举 `hass.states`，兼容状态对象不能直接遍历的情况。每个编辑器实例首次加载一次列表，点击“刷新实体列表”可重取。请求失败会在编辑器内显示提示并保留重试按钮，不把异常抛给 HA 导致“可视化编辑器不支持”。请确认 HA 登录和 WebSocket 连接正常。旧环境没有 callWS 时才回退到状态列表。复杂范围覆盖也可继续使用 YAML；可视化的最小值/最大值需成对填写，填完之前可能暂时提示范围配置错误。
### YAML 调用示例（也可继续使用）
仪表盘 → 编辑 → 添加卡片 → 手动，粘贴下列 YAML。**示例实体都是占位名称，必须替换成你自己的实体 ID。** 在“开发者工具 → 状态”查找真实 ID，不能填写设备名或显示名称。
