Repository navigation
Releases
Releases · chjspp520/room-elves-card
v7.0.2
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调用)

v7.0.1
v7.0.1(正式版 · 2026-11-15)
一、插件系统(本次大版本主题)
- 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
更新说明
v6.14.72 (2026年11月12日)
新增功能
- 实体搜索(定时精灵、编组管理卡片)改为全屏面板:手机上点实体输入框后,搜索框固定在屏幕顶部,候选列表铺满下方,
- 历史记录显示中文状态:空调、窗帘、灯光等实体的历史时间线不再显示
cool/off这类英文,改为「制冷」「关闭」等中文,并按状态语义着色。你自己配过map_table的设备仍以你的配置为准。 - 定时卡片:最大宽度限制为 500px,宽屏下居中显示。
界面改进
- 历史记录气泡标题栏:图标移到最左侧并放大,「历史记录」与实体名称分两行显示;
名称过长时截断显示「…」,不会再把整个气泡撑宽。 - 两个卡片(定时精灵、编组管理卡片)的实体搜索框:输入框颜色、圆角、字号、聚焦效果统一。
问题修复
- 长实体名称把历史气泡撑宽。
- 拖动图表里的可视化组件(如 visualMap)时误切页签,且把手拖不动。
v6.14.37
v6.14.37 (2026年11月9日)
1. AC 卡片:点击功率显示弹历史曲线气泡(此功能无需配置);
2. iKuai / fnos / NPS / NAS 卡片圆角统一 20px;
3. 调试卡 布局优化;
4. 修复picture 卡叠加图时图层消失的bug,改为分组互斥;
5. 自由布局弹窗 title_entities 里配置了传感器且非 way 时,点击 → 弹出历史曲线气泡(此功能无需配置);
6. 卡片内所有涉及历史图表的都全部改为统一动作系统history_chart动作;
7. 统一动作系统新增history_chart动作(弹出历史记录气泡);
本地 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
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_liang2) 弹出卡片模式
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

v6.12.94
v6.12.51
v6.12.51 (2026年11月5日)
1、定时卡片全面重构,接入内部卡片框架,定时功能更为丰富,界面更美观(后端 HA统一数据存储系统 需要更新至v6.0.5 )
## 卡片形态与四种入口
本卡只有全卡一种形态,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: 430pxv6.11.85
v6.11.81
更新日志
v6.11.81 (2026-11-03)
1、定时器功能全面升级,卡片内部支持任意实体定时(支持服务类),需要将 HA统一数据存储系统 升级到 V6.0.4 ;
2、性能优化。
3、修复定时器进度条中时间不更新的bug





