Skip to content

Releases

v7.0.2

Choose a tag to compare

@chjspp520 chjspp520 released this 18 Nov 07:35
c43e717

v7.0.2(正式版 · 2026-11-18),需要将“HA统一数据存储系统”升级至v6.2.9

1. 新增通知中心(与自动化共同使用,无需配置),点击打开直接打开对应的弹出窗口;

2. 新增媒体查看器(新模块 infra/media-viewer.js),插件可以调用

3. 框架级bug修复;

4. 通知中心性能优化;

5. 自动化中,执行动作新增HA通知(推送标题、详情、内容、附件均支持jinja2,附件支持jinja2定义路径);

6. 新增插件开发指南文档、插件API契约及ai话术(新增共享方法ctx.media.open调用)

2 1

v7.0.1

Choose a tag to compare

@chjspp520 chjspp520 released this 15 Nov 07:53
e22f635

v7.0.1(正式版 · 2026-11-15)

一、插件系统(本次大版本主题)

插件说明文档见https://github.com/chjspp520/room-elves-card/blob/main/%E6%8F%92%E4%BB%B6%E5%BC%80%E5%8F%91%E6%8C%87%E5%8D%97%20-%20%E9%80%82%E9%85%8Dv7.0.1.md

  • Plugin Host:第三方放一个 js 进 /local/,window.RoomElves.defineCard({ type, render })
    即可写出与内置卡同质感的新卡片(统一头部 / 选项卡 / 分段选项卡 / 下拉 / 弹窗 / 主题跟随);
  • plugins 配置任意一张卡配一次即全局生效(localStorage 持久化,300ms 防抖抗编辑器逐字输入);
  • 三种用法:standalone_type(独立卡)/ popup_card(弹窗)/ cards(混排),同一份 render;
  • ctx 门面:frame(createCardHeader / Section / TabBar / SegTabs / presets)、accent、主题、
    onHass、timers、共享 cache、fetch、统一下拉、弹窗/气泡/日历/确认框、ctx.chart 历史曲线;

插件安装

① 把插件文件丢进 www

/config/www/chj/plugin-sample-solar.js

② 在任意一张房间精灵卡里声明一次

type: custom:room-elves-card
plugins:
  - /local/chj/plugin-sample-solar.js

⚠️ 路径必须以 /local/ 开头,对应 config/www/ 下的文件。

2种用法(同一份插件,随你选)

# ① 仪表盘独立使用(外层仍是房间精灵卡)
type: custom:room-elves-card
standalone_type: my-solar-card
power_entity: sensor.pv_power          # ← 这些是传给插件的配置

# ② 作为弹窗打开
buttons:
  - name: 屋顶光伏
    icon: mdi:solar-power
    tap_action:
      action: popup_card
      popup_position: center           # 弹窗参数照常生效
      width: 520px
      card:
        type: my-solar-card
        power_entity: sensor.pv_power

二、简单自动化(v6.14.73 → v7.0.0.13 的主线)

⚠️ 注意: 此功能需要需要[HA统一数据存储系统](https://github.com/chjspp520/ha_data_store/releases/)升级至vv6.0.10
  • 触发:状态触发上线(从…变为… / 任意变化)、支持属性变化触发、冷却时间可配、面板单行化;
  • 条件:属性条件 + 属性下拉(中文标签 / 白名单 / 候选值)、时间窗口条件单行 + 滚轮下拉、
    新增 changed(自上次执行以来变化)与 not_contains 运算符、条件嵌套分组(且/或,层级可视化);
  • 动作:赋值动作三种(实体值 / jinja2 模板 / 固定值 → 目标实体,覆盖 input_number/text/
    select/datetime/boolean 等 11 种域)、多目标批量动作、延迟动作、动作与条件行可排序;
  • 微信发送(ClawBot):文字 / 图片(实体或路径)/ 视频 / 语音 / 文件;路径可写模板与绝对路径;
    ⚠️ 注意:微信发送(ClawBot)需要微信ClawBot集成的支持,也是我维护
条件 动作 触发 微信

三、框架与组件收敛

  • frame/card/header.js:整卡头部统一定义(14 张卡迁移,accent 扩到 16 个 token,
    全仓自绘页签删除,只保留框架那一套);
  • frame/card/seg-tabs.js:分段选项卡收成框架模块(概览气泡等迁入);
  • render/chart-component.js 通用历史曲线组件 + _buildChartSection 通用图表区块
    (天然气/自来水/用电/温湿度/ESXi/飞牛/AC 功率等卡片陆续接入);
  • 服务器卡同构收敛:fnos / ikuai / esxi / nps / one_kvm 抽 server-card-retries 与 state-read 助手层;

四、修复(用户可感知)

  • 鸿蒙:删除 harmony_scale 缩放兼容层——修复靠边弹窗越界;
  • iKuai:4.0 响应信封 {code,message,results} 兼容(四个页签全空),在此感谢wycxyPR;速率图点击气泡改跟随式 tooltip;
  • 自动化保存第二次静默失效(防重入标志不复位);「+多实体」TDZ 崩溃;打印卡打不开;
  • 详情气泡箭头不指向点击处、重复 section 标题、只显示执行记录;
  • ECharts 内部拖动(visualMap / dataZoom)与横向滚动误切选项卡;
  • 实体搜索:iOS 布局抖动误判宿主已关闭、面板被自身遮罩秒关、锚点出屏定位错、
    移动端全屏面板 + 键盘适配、多选能力、两个搜索下拉合并;
  • 体积与清理:未使用变量批量清理。

v6.14.72

Choose a tag to compare

@chjspp520 chjspp520 released this 12 Nov 13:34
eff5686

更新说明

v6.14.72 (2026年11月12日)

新增功能

  • 实体搜索(定时精灵、编组管理卡片)改为全屏面板:手机上点实体输入框后,搜索框固定在屏幕顶部,候选列表铺满下方,
  • 历史记录显示中文状态:空调、窗帘、灯光等实体的历史时间线不再显示 cool / off 这类英文,改为「制冷」「关闭」等中文,并按状态语义着色。你自己配过 map_table 的设备仍以你的配置为准。
  • 定时卡片:最大宽度限制为 500px,宽屏下居中显示。

界面改进

  • 历史记录气泡标题栏:图标移到最左侧并放大,「历史记录」与实体名称分两行显示;
    名称过长时截断显示「…」,不会再把整个气泡撑宽。
  • 两个卡片(定时精灵、编组管理卡片)的实体搜索框:输入框颜色、圆角、字号、聚焦效果统一。

问题修复

  • 长实体名称把历史气泡撑宽。
  • 拖动图表里的可视化组件(如 visualMap)时误切页签,且把手拖不动。

v6.14.37

Choose a tag to compare

@chjspp520 chjspp520 released this 09 Nov 15:15
835d963

v6.14.37 (2026年11月9日)

1. AC 卡片:点击功率显示弹历史曲线气泡(此功能无需配置);

空调

2. iKuai / fnos / NPS / NAS 卡片圆角统一 20px;

3. 调试卡 布局优化;

3 4

4. 修复picture 卡叠加图时图层消失的bug,改为分组互斥;

5. 自由布局弹窗 title_entities 里配置了传感器且非 way 时,点击 → 弹出历史曲线气泡(此功能无需配置);

2

6. 卡片内所有涉及历史图表的都全部改为统一动作系统history_chart动作;

7. 统一动作系统新增history_chart动作(弹出历史记录气泡);

5

本地 UI 动作:点一下直接弹出该实体的历史曲线气泡(不调用服务、不写「最近使用」操作记录);
气泡由统一的图表组件渲染:标题行(含时长下拉)+ 曲线 + 右端实时值 + 最高/最低统计行。

tap_action:
  action: history_chart
  entity: sensor.ertongfang_diannao_day   # 可省:默认取所在项的 entity
  duration: 1440                          # 可省:默认图表时长(分钟,10 档之一)
  stat_methods: [sum, max]                # 可省:统计方法(每个方法一条线)
  stat_bucket: 1d                         # 可省:聚合粒度(默认 auto)
  title: 日用电                            # 可省:标题名
  color: '#f59e0b'                        # 可省:曲线基色

参数

参数 说明
entity 目标实体;缺省取所在项(按钮 / title_entities / 传感器卡片)的 entity
duration 默认时长(分钟),必须是 10 档之一(见下);缺省 24 小时
stat_methods 统计方法(可选):每个方法画一条线(最多 3 条),同时决定图表下方统计行;传 [] = 不聚合 + 不显示统计行;不写 = 原始曲线 + 默认「最高/最低」
stat_bucket 聚合粒度:auto(默认)/ 30s / 1m / 5m / 15m / 30m / 1h / 3h / 6h / 12h / 1d
title / name 标题名。优先级:tap_action.name → tap_action.title → 所在项 name → 实体 friendly_name → entity_id
color 曲线基色(多方法时以此色压暗出多条线)

时长 10 档:5分钟 / 10分钟 / 30分钟 / 1小时 / 12小时 / 24小时 / 2天 / 3天 / 5天 / 7天
(切换后标题括号与取数窗口一起变,只影响当前气泡,关掉重开恢复默认值)

内置统计方法(20 个)

类别 方法
基础 mean 平均、median 中位数、min 最低、max 最高、first 首值、last/state 末值、sum 合计、change 变化(累计型跨归零重置)、integral 积分(W/kW/MW 自动折算 kWh)
派生 delta 波动、stdev 标准差、cv 变异系数、p90 / p95 分位、slope 斜率(单位/小时)、change_pct 变化率、count 采样数
开关型 on_count 开启次数、on_duration 开启时长、on_ratio 开启占比(仅 binary_sensor 这类开关语义实体有效)

多条线若量纲不同(如 sum + count),只画第一个量纲的线,其余只进统计行。
桶数超过 500 会自动放大一档(避免 7天 × 30秒 把页面算卡)。

点击区域(自由布局弹窗内的按钮 / 传感器卡片)

点击位置 行为
图标区域 该实体的历史记录气泡(timeline-history-bubble,与未配 tap_action 时完全一致)
其余区域(名称 / 数值 / 整块) 执行 tap_action —— 配 history_chart 时即弹出历史曲线气泡

常用组合

场景 stat_methods stat_bucket
温度 / 湿度 [mean, max, min] auto
功率 [max, mean] auto
日用电 [sum, max] 1d
累计电量(总表) [change, max] auto
开关 / 门磁 [on_count, on_ratio] auto

v6.14.4

Choose a tag to compare

@chjspp520 chjspp520 released this 08 Nov 08:37
c14ec4c

Version v6.14.4 (2026-11-08)

1、修复常用设备气泡中编组设备(窗帘 / 空调)点击弹出的是more-info而非卡片的bug;

2、统一动作系统埋点补齐;

3、getHistory 同参在途合并 + 多实体单条 WebSocket;

4、修复下拉框在鸿蒙系统中显示错位的bug(缩放情况下);

5、优化定时器卡片UI、布局;

6、新增电力卡片 “type: power_center” (需要 “HA统一数据存储系统” 升级v6.0.7),目前卡片式初代版本,后续将继续美化、增加功能。

使用方法:

1) 独立使用模式(整张 HA 卡片就是一个电力面板)

type: custom:room-elves-card
standalone_type: power_center
api_base_url: /api/ha_data_store/
key: <你的 key>
day_table: attr_ele_day
env_entity: sensor.quan_wu_ri_yong_dian_liang

2) 弹出卡片模式

action: card
popup_position: center
card:
  type: power_center
  width: 430px
  day_table: attr_ele_day
  env_entity: sensor.quan_wu_ri_yong_dian_liang
1 2

v6.12.94

Choose a tag to compare

@chjspp520 chjspp520 released this 06 Nov 02:32
c14ec4c

v6.12.94 (2026年11月6日)

1、定时器布局优化;

2、全卡片下拉改为内部组件,不在调用系统下拉;

3、空调定时器去掉进度条,将定时器本身作为进度条(定时器的背景色会根据目标状态来改变颜色);

4、历史记录气泡中新建定时器支持左右滑动(新建与历史之间左右滑动);

5、修复空调实体不可用时,空调卡片显示不正常的bug;

6、其他方面的优化。

1 2 3 4 5

v6.12.51

Choose a tag to compare

@chjspp520 chjspp520 released this 04 Nov 16:06
086b9dc

v6.12.51 (2026年11月5日)

1、定时卡片全面重构,接入内部卡片框架,定时功能更为丰富,界面更美观(后端 HA统一数据存储系统 需要更新至v6.0.5 )

1 2 3 4 ## 卡片形态与四种入口

本卡只有全卡一种形态,3种入口共用同一套渲染:

# 1) 独立使用模式(房间精灵主卡配置)
type: custom:room-elves-card
standalone_type: timer_elves

# 2) 卡片区 / popup_card(子卡)
- type: popup_card
  card:
    type: timer_elves

# 3) 动作
- tap_action:
    action: card
    card:
      type: timer_elves


#### 房间精灵内部使用完整配置(如上图所示)
  - name: 定时器
    badge_entity: sensor.ha_data_store_timer
    icon: mdi:clock-outline
    on_color: '#e74c3c'
    off_color: '#8e8e93'
    tap_action:
      action: popup_card
      popup_position: down
      card:
        type: timer_elves
        width: 430px

v6.11.85

Choose a tag to compare

@chjspp520 chjspp520 released this 04 Nov 01:57
086b9dc

Version v6.11.85 (2026-11-04)

1. 修复对话记录气泡「没有更早的对话了」误判的bug;

2. 历史记录气泡最小宽度改为310px;

3. 第五轮优化:弹窗监听泄漏 + 网络在途合并 + 死代码清理

v6.11.81

Choose a tag to compare

@chjspp520 chjspp520 released this 03 Nov 11:25
086b9dc

更新日志

v6.11.81 (2026-11-03)

1、定时器功能全面升级,卡片内部支持任意实体定时(支持服务类),需要将 HA统一数据存储系统 升级到 V6.0.4 ;

2、性能优化。

3、修复定时器进度条中时间不更新的bug

2 1

v6.11.77

Choose a tag to compare

@chjspp520 chjspp520 released this 03 Nov 10:05
086b9dc

更新日志

v6.11.77 (2026-11-03)

1、定时器功能全面升级,卡片内部支持任意实体定时(支持服务类),需要将 ' HA统一数据存储系统 ' 升级到 V6.0.4 ;

2、性能优化。

2 1