Repository navigation
Releases: BSakura-Miku/ugreen-ups-panel
Release list
v0.14.5 · 页面整理、主题与记录详情
改进
- 页面分为总览、用电分析、电池与供电、设备管理。总览保留关键读数和摘要，校准、诊断、更新与硬件档案归入二级导航。
- 支持跟随系统、深色和浅色主题，并改善手机布局、日历及状态标签的对比度。
- 供电记录可展开查看起止电量、能量与覆盖依据、附近趋势，以及相关事件和备注。
- 用电明细新增缺口小时列表；相对容量优先显示匹配样本进度，不可比较的数据明确显示原因。
- 支持新增、修改、删除、清空电价及设置过去的生效日期。更正后重算历史费用，原用电量保留；人民币统一显示为元。
- 校准助手按电压确认、基底和可选回充分步展示；诊断优先显示运行摘要，异常检查自动展开。
构建期 source-map-js 已更新至安全修复版本 1.2.2。
更新
Docker 镜像：bsakuramiku/ugreen-ups-panel:0.14.5，支持 linux/amd64、linux/arm64。
本次功能由面板提供，已有兼容采集器可继续运行。保留 Compose 挂载和 data 目录，按 README 更新容器；建议先备份数据库及校准文件。附带采集器包和校验文件供需要更新宿主程序的用户使用。
相对容量不是出厂健康度；缺口不补算，事件相近不代表因果关系。采集器和面板不替代 NAS 原有断电保护。
v0.14.4 · 首页布局优化
顶部按供电模式突出功率，次要读数与电芯窗口按需展开。趋势与电芯卡片对齐，修复记录卡片间距。用电日历、同期对比与费用共享月份，减少隐藏明细轮询。
只需更新面板镜像；现有采集器与宿主更新服务无需升级。
v0.14.3 — 采集器更新加速选项
采集器更新支持直连、gh-proxy.com、ghproxy.net 与自定义公网 HTTPS 加速前缀。gh-proxy.com 用于版本查询和下载；ghproxy.net 仅用于下载，查询仍直连 GitHub。设置保存在宿主服务，切换后重新检查并重新确认安装目标。
包含 v0.14.2 自动检查与缓存。安装和回退仍需管理密钥及确认，安装包校验保留；密钥不会传给加速站，自定义服务禁止连接内网。加速元数据和安装包时需要信任所选第三方服务。
需同时升级面板与宿主更新服务。采集器和数据库无需因本功能迁移，详见 docs/collector-update.md。
Docker Hub 的 0.14.3 与 latest 已同步，支持 linux/amd64 和 linux/arm64。
v0.14.2 — 自动检查采集器更新
打开诊断页后自动检查采集器最新稳定版，成功结果缓存 1 小时；网络失败保留上次结果并在 5 分钟后允许重试。检查无需密钥，安装和回退仍要求管理密钥及目标确认。自动检查不会覆盖安装记录。
需要同时升级面板镜像与宿主更新服务；仅更新面板或采集器不会升级宿主更新服务。采集器和历史数据库无需因本功能而迁移。详见 docs/collector-update.md。
Docker Hub 的 0.14.2 与 latest 已同步，支持 linux/amd64 和 linux/arm64。
v0.14.1 — 版本显示修正
修复页脚显示旧版本号的问题，版本文案改为从构建信息自动生成。
包含 v0.14.0 的连接诊断、轻量诊断读取、同期用电对比、单一电价费用估算及事件时间轴。已有宿主采集器与更新服务继续兼容，仅需更新面板。
分发说明：Docker Hub v0.14.1 与 latest 镜像均已发布，支持 linux/amd64 和 linux/arm64。
v0.14.0 — 轻量诊断与用电分析
0.14.0 — 连接诊断、轻量读取与用电分析（2026-09-13）
- 更新器连接按入口缺失、权限不足、拒绝连接、超时及协议不兼容分别提示，无法连接时不再断言宿主未安装。
- 诊断页使用轻量摘要，展开曲线后按序号增量读取；窗口淘汰、时钟回退和重启可重置，隐藏页面停止诊断请求。大响应启用 gzip，旧诊断与 CSV 接口保留。
- 新增今日/本周/月份的同期完整小时用电对比，显示覆盖率与依据；有效覆盖不足或依据变化时不计算增减。
- 新增按生效日期保存的单一电价、每日费用与分币种月汇总；旧电价保留，缺采与未计价电量单独说明。
- 事件时间轴汇总旧供电/连接事件与此版本开始记录的校准、NUT 状态及应用启动，支持纯文本备注和附近趋势。
- 提供独立、手动启用的容量受限停更取证工具；不启动长期测试，不声称偶发长停更已解决。
- 数据库仅追加电价、补充事件和备注表，原始历史、校准及累计起点保留；已有宿主采集器和更新服务无需升级。
v0.12.2 — 快照新鲜度判定修复
修复读取快照的时序竞态，避免刚发布的正常快照被短暂误判为离线。
- 在读取完成后取得新鲜度评估时间，保留10秒门槛与未来时间戳检查。
- 补充原子换文件、显式评估时间及读错误回归测试。
- 更新面板镜像即可生效；已有采集器、宿主更新服务、历史与校准配置继续兼容。
本次仅修复已确认的判定问题，不代表偶发长时间采集停更已解决。
Docker：bsakuramiku/ugreen-ups-panel:0.12.2（linux/amd64、linux/arm64），同时更新latest。
1225项Python测试、GitHub CI与双架构镜像冒烟均已通过。
v0.12.1 — 安装、校准与升级可靠性
修复安装路径、校准异常和升级状态容易混淆的问题。
- 无效校准只暂停对应功率估算与能量累计；有效的电量、电压、电芯及原始遥测继续显示。
- 校准页面说明路径不一致、文件权限、格式和版本问题；未知配置以空白表单明确恢复，12 V 使用 custom + 12 V，不自动继承 19 V 系数。
- 安装与升级核对配置文件目标、源码指纹和实际运行版本，并在切换后再次核验。网页端同时阻止确定的挂载和配置路径问题。
- 历史权限、锁定、空间不足等故障分别显示；已有数据库可读时保留历史查询，诊断导出只含固定状态。
完整功能需更新面板、采集器及可选宿主更新服务。旧更新服务保持兼容，但要启用新的宿主预检，须按文档用命令行更新该服务本身；网页更新采集器不会替换更新服务。已有历史、校准和容量参考无需重建。
Docker：bsakuramiku/ugreen-ups-panel:0.12.1，支持 linux/amd64、linux/arm64。
验证：1,214 项 Python 测试、101 项前端测试、生产构建、CI、双架构镜像冒烟及桌面/窄屏场景验收通过。12 V 软件支持不代表新增了独立电表定标。
v0.12.0 · 用电月历与日耗电统计
首页新增「用电统计 · 估算」，可查看今日累计、所选月累计、完整记录日均，以及按日期展开的 24 小时平均功率。
- 月历沿用深绿色界面，按北京时间（UTC+08:00）统计，适配桌面与手机；点击日期查看电量和记录覆盖情况。
- 对市电输入估算功率按实际采样时间积分。缺采不补算，未知值不显示为零，电池供电不重复计入市电电量。
- 用电账本独立保存，重启可延续，清理旧趋势不删除用电记录；从升级后的有效记录开始，不反推旧历史。
- 已有 v0.9.1 采集器和更新服务继续兼容，本次只需更新面板镜像。升级前建议保留数据目录备份。
Docker：bsakuramiku/ugreen-ups-panel:0.12.0，支持 linux/amd64 和 linux/arm64。
验证：1,065 项 Python 测试、88 项前端测试、生产构建、两种架构镜像冒烟测试，以及桌面、390/360 像素浏览器验收通过。用电量仍为经验功率模型的积分估算。
v0.11.0 · 固定基线的相对容量参考
概览新增「相对容量参考」。当前校准阶段的首个合格 90%→80% 连续放电区间定义为 100%，后续在相同区间、相近负载下比较观测能量；基线始终固定。
- 显示基线建立进度、初步比较、最近三次匹配记录中位数、基线及观测日期、Wh 和平均负载。
- 拒绝采样缺口、电量跳变/回升、异常短区间及不合格负载；旧历史不补算。
- 基线独立持久保存，重新建立参考需明确确认，旧阶段归档，写入失败保留原参考。
- 百分比表示相对本次参考的变化，不是出厂 SOH；温度条件仍未知。
已有 v0.9.1 采集器和更新服务只需更新面板镜像，无需重新安装宿主服务。 在原 Compose 项目中执行 docker compose pull，再执行 docker compose up -d，沿用原有 Compose 文件与数据目录。原历史和校准保留。
镜像：bsakuramiku/ugreen-ups-panel:0.11.0，同时更新 latest，支持 linux/amd64 / linux/arm64。
镜像索引：sha256:9b4d1baf32414c573ff3afc2387666ba14463c1ed31b5d1eda984a3200a13e5d。
验证：975 项 Python 测试、76 项前端测试、前端构建、Compose、公开文件检查和 GitHub CI 通过；两个架构均通过真实容器启动及接口验证。11 个合成场景完成实际 HTTP → 前端解析验证。长期容量变化仍待真实观测，本版组件尚未完成浏览器视觉验收，README 预览保留 v0.10.0 标识。
附件为同一提交生成的最小采集器代码包与 SHA256SUMS，供已启用网页更新的部署使用；本次 NAS 面板升级不需要安装该包。