Repository navigation
Releases
Releases · MisiteQ/qfnplus-ha
v0.4.1 — 入口磁贴,一点弹出设备面板
Q飞牛+ v0.4.1
新增
- 入口磁贴卡片
custom:qfnplus-popup-card:在任意仪表盘上放一个实体磁贴(可绑定任意实体或开关),点击后页面中央弹窗打开完整设备面板。- 磁贴显示实体当前状态(格式跟随 HA),不填
entity时显示为「Q飞牛+ 面板」入口 - 弹窗内仍是完整设备面板,点磁贴照常打开 more-info
- Esc / 点击遮罩 / 右上角 × 关闭;浅色、深色主题自动适配
- 与完整面板卡片一样随集成自动注入,无需 HACS 前端资源
- 磁贴显示实体当前状态(格式跟随 HA),不填
用法
type: custom:qfnplus-popup-card
entity: sensor.qfnplus_cpu_usage # 可选:磁贴展示的实体
name: Q飞牛+ NAS # 可选:磁贴标题
icon: mdi:nas # 可选:磁贴图标
# title: Q飞牛+ · NAS # 可选:弹窗标题升级方式
- HACS:更新到 0.4.1 后重启 Home Assistant
- 手动侧载:下载下方
qfnplus-sideload.zip,解压后把qfnplus/放入/config/custom_components/,重启 Home Assistant
v0.4.0 — 自带仪表盘卡片 + 数值精度修复
Q飞牛+ v0.4.0
新增
- 集成自带仪表盘卡片
custom:qfnplus-device-card:随集成自动注入前端资源,无需 HACS 前端组件或手动添加资源。- 自动发现主设备与每块硬盘子设备下的全部实体,按「系统 / 存储 / 硬盘健康 / 磁盘 IO / 网络 / 电源 / 容器 / UPS / 风扇 / GPU」分组
- 顶部 CPU / 内存 / 存储三环形图(阈值变色),快捷读数行,其余为可点击磁贴(打开标准 more-info 弹窗)
- 颜色全部取自 HA 主题变量,浅色/深色主题自动适配
lovelace/qfnplus-dashboard-card.yaml:推荐的仪表盘配置示例
修复
- 读数难看的长小数:
DATA_SIZE改用 GiB、DATA_RATE改用 MB/s,后端换算并统一取整,实体页不再是8.00448989868164GiB - 运行时长:由 UTC 时间戳改为真正的时长传感器(
h,保留 1 位小数),可直接用于图表与统计 - 卷容量、网卡累计流量、磁盘 IO 等数值统一精度
升级方式
- HACS:商店中更新到 0.4.0 后重启 Home Assistant
- 手动侧载:下载下方
qfnplus-sideload.zip,解压后把qfnplus/放入/config/custom_components/,重启 Home Assistant
升级后在仪表盘添加卡片:
type: custom:qfnplus-device-cardQ飞牛+ v0.3.0
新增
- UPS 实体组(fnmonitor 新版
/api/upsNUT 直连):电池电量ups_battery_charge、预计续航ups_runtime、负载ups_load、输入电压ups_input_voltage+ 市电异常ups_on_battery(binary_sensor,NUT status 含 OB 即 on)。未配置 UPS 时不建实体。 - 网络流量日/月累计 4 个 sensor(
traffic.totals):net_today_rx/net_today_tx/net_month_rx/net_month_tx,TOTAL_INCREASING,建议展示单位 GB,可直接进 HA 统计卡片。 - API 客户端新增
async_get_ups,coordinatorSUB_FETCHES接入,60s 节流。
修复
- 存储卷 / 网卡 / 风扇 / GPU 拔掉再插回后实体永久不重建(
prune清理时未同步known_*集合,守卫条件in known_*永久跳过重新出现的设备)。 - 纯中文风扇名
slug()后为空串,导致unique_id冲突(兜底fan{序号})。
同步更新
- manifest v0.2.1 → v0.3.0
- strings.json / en.json / zh-Hans.json 三语翻译
- coordinator 节流窗口(ups 60s)
- 测试 61 → 67 全绿(新增 UPS 实体 / 断电状态 / 未配置不建实体 / 流量累计 / 卷重新挂载重建 / 网卡重新出现重建)
- lovelace 仪表盘:UPS 区 + 整机流量累计卡
v0.2.1
首发版本。fnmonitor v2.20.0 数据接入:CPU/内存/存储/磁盘 SMART/GPU/Docker 容器/网卡流量/功耗用电等 60+ 实体,纯只读。HACS 安装直接添加本仓库;手动侧载下载下方 qfnplus-sideload.zip。