版本更新记录

实体 eSIM 全量写卡与元数据缓存：新增 eSIM 资料下载安装能力，写卡完成后自动解析 ICCID、IMSI、运营商编码等卡片信息并本地持久缓存，补齐写卡后无法读取卡片元数据的短板。
二维码本地解析：内置离线解码能力，支持点击 / 拖拽图片解析 LPA 激活码，无需调用设备摄像头、不依赖外部网络接口。
LPA 地址智能解析：粘贴 LPA 格式链接（如 LPA:1$...）时自动拆分服务器地址、配对 ID、校验码等信息，一键自动填充表单。

📌 v1.0.9

✨ 新增功能

短信通知模板新增 {{验证码}} 变量，可按需嵌入转发规则使用，原有默认模板保持不变。
后端新增专属验证码识别提取器，结合数字位数、位置权重、关键词关联、格式特征及干扰词剔除等规则进行加权识别智能解析验证码。
适配中英文主流验证码短信格式，可识别带短横线分隔的验证码，并自动规整为纯数字格式。
通知中心新增设备状态定时报表，支持定点或间隔周期推送，兼容现有通知规则、推送通道、转发日志及免打扰机制。
报表支持各项状态指标单独启停监控，涵盖网络连接、蜂窝状态、系统运行、流量使用、短信转发统计、OTA 更新等设备核心信息。
短信转发统计支持今日、最近 24 小时、最近 7 天和累计统计周期，优先展示接收、成功、失败关键数据，自动隐藏无数据空值项。
新增消息队列与保护机制，转发通道支持独立频率配置并预置默认规则。

💫 体验优化

设备状态数据采用懒加载采集策略，仅读取已开启指标数据，减少无效系统调用，节约系统资源。
后端统一处理温度传感器名称映射，报表与仪表盘统一展示中文友好名称。
设备状态报表模板支持分类段落排版，规整内容层级结构，条理更清晰，方便查阅各类设备指标信息。

📌 v1.0.8

✨ 新增功能

短信管理加入常驻搜索框，支持按号码、短信内容检索会话；匹配项可自动高亮检索关键词。
短信统计新增推送数据统计，直观展示推送成功、尝试推送条数。
新增系统配置「安全性」页面，支持启用密码保护、修改管理员密码、密码策略、会话有效期和空闲超时设置。
重构通知中心架构，解耦为转发日志、转发规则、转发通道三大模块，明确分工：通道负责发送、规则负责筛选分配、日志负责监控排错。
升级转发通道，支持多实例配置，可创建多个同类型通道，支持独立命名、启停、配置及测试发送。
升级转发规则为事件路由层，支持多类型事件匹配、多目标通道分发、纯文本模板配置，新增星期 + 时间段免打扰。
转发日志新增分页、多维度筛选及清空功能，细化状态分类，提升转发链路问题排查效率。
转发日志增强时间范围筛选、高级清理和自动清理配置，支持按类型、状态、时间段及保留策略管理日志。
DDNS 转发规则新增连续失败推送阈值，支持达到指定失败次数后再推送，减少短时网络波动造成的通知干扰。
通知中心新增系统事件通知，覆盖基带、蜂窝网络、设备网络、系统/服务、安全审计、SIM/eSIM 和资源告警，支持按事件独立启停、阈值/恢复推送及系统事件模板。

💫 体验优化

精简短信统计面板，隐藏总计数据，保留收发统计，新增独立推送统计卡片，支持悬停查看数据说明。
持久化存储短信转发状态，过滤无效异常数据，保证推送统计结果准确可靠。
优化登录页和首次设置密码页视觉效果，补充忘记密码提示。
支持按已保存的密码策略校验新密码，并提供密码强度提示。
统一通知模板为纯文本格式，前端支持中文变量名，简化模板配置。
优化短信监听转发策略，区分历史短信补录与新短信转发，避免批量转发与消息漏推。

📌 v1.0.7

✨ 新增功能

新增管理员密码登录能力，支持初始配置、会话校验，防护页面与接口访问访问保护。
支持 SSH 本地命令交互式重置密码、清空认证配置后重新设置。
增加密码复杂度校验，过滤非法格式字符。

💫 体验优化

优化本机号码变量展示，国内号码精简为 11 位格式，境外号码保留或补全国际前缀。
版本检测改为北京时间每天 09:00 和 18:00 执行，并新增超时限制、多节点降级重试，提升更新通知获取成功率。

📌 v1.0.6

✨ 新增功能

数据连接管控从 ModemManager D-Bus 迁移至 NetworkManager，通过nmcli实现联网启停。
交由 NetworkManager 自动完成接口启用、IP、DNS、IPv6 及路由全流程配置。
新增双轨流量统计机制，精准获取蜂窝网口真实上下行流量。
新增统一网络地址选择能力，仪表盘与 DDNS 共用同一套 IPv4 / IPv6 网口判断逻辑。
在未自动识别到 SIM 卡的本机号码或短信中心（SMSC）时，允许用户在界面手动输入并持久化缓存。
手动输入的本机号码立即生效，自动支持并映射通知中心的短信转发变量。

💫 体验优化

职责拆分，ModemManager 仅负责信号、注册状态等只读查询。
程序启动自动清理旧 unmanaged 配置，自动生成蜂窝网络配置。
移除 wwan0 等网口名称硬编码，由 NetworkManager 自动适配识别。
APN 配置界面默认选中并展示当前已连接的 APN 槽位。
优化 DDNS 公网 IP 获取逻辑，非蜂窝网卡跳过冗余 D-Bus 请求，减少资源开销。
完善蜂窝接口流量展示，支持展示真实上下行流量字节与数据包数量。
优化仪表盘与 DDNS 的 IP展示和获取优先级，有无线网络时优先使用无线网口，无无线网络时自动回落到蜂窝数据网口。
自动识别无线网口、蜂窝网口和默认路由，不再依赖 wlan0、wwan0 等固定网口名称。
在仪表盘和设备信息页增加 SIM 号码空值识别，无缝集成在线编辑组件及输入格式校验。

🐞 bug 修复

彻底修复数据连接假开关问题，解决前台显示已联网、实际接口未启用无 IP 无法上网的故障。
修复正常网口因内核限制被误判为 UNKNOWN 的问题，优化状态自动纠正逻辑。
彻底解决高通平台蜂窝网口流量统计恒为 0 问题，同时兼容联发科、展锐等多类模组设备。
解决内核网口统计数据不准，造成前端无法展示真实蜂窝流量的问题。
修复仪表盘和 DDNS 在部分场景下误选本地回环、管理桥或链路本地地址，导致显示或解析 IP 不符合实际上网出口的问题。

📌 v1.0.5

✨ 新增功能

新增短信中心号码、本机号码多源读取 + 缓存能力，多通道静默提取、命中即止。
新增缓存表，接收短信时自动学习并持久化存储短信中心号码、本机号码。
新增 SIM / eSIM 工作模式功能开关，默认保持普通 SIM 模式。
依托 lpac 实现实体 eUICC 卡轻量 eSIM 管理，配套管理页面支持卡信息查看、配置文件切换、重命名与删除。
通知模板新增本机号码变量，适配短信转发场景。

💫 体验优化

短信中心号码、本机号码读取失败均静默处理，不影响功能使用与页面展示。
优化短信接收可靠性，服务启动、Profile 切换和基带恢复后会主动检查未同步短信。
优化短信去重策略，减少设备重启或短信编号复用导致的误判漏收。
采用命中即停策略，减少冗余调制解调器指令调用，降低日志干扰。
优化系统配置页面 UI，调整布局并新增工作模式卡片。
侧边栏随工作模式动态隐藏 eSIM 相关入口，普通 SIM 模式不加载对应页面资源。
优化 eSIM 调用逻辑，仅使用对应功能时调用 lpac，无需常驻后台进程。
优化设备开机及 SIM 搜网注册阶段前端界面频繁报错的问题，同时将用户操作触发的错误提示改为常显，解决此前错误信息自动消失过快导致用户无法阅读的问题。

🐞 bug 修复

修复 PushPlus 部分配置场景报错问题，提升通知渠道兼容性。
修复短信中心号码读取时，ModemManager 非调试模式的未授权告警问题。
修复实体 eSIM 卡在 Profile 切换或基带恢复后，短信已到设备但 Web 页面未显示的问题。

📚 接口与文档更新

数据库新增号码缓存表，持久化存储 SMSC 与本机号码。
新增工作模式、eSIM 管理全套 API 接口。
eSIM 接口适配 lpac 标准 JSON 输出，适配各类 eSIM 管理操作。
完善文档，补充相关使用说明。

📌 v1.0.4

✨ 新增功能

通知中心新增 PushPlus 通知渠道，支持配置 Token、标题模板、群组编码、消息模板、发送渠道、渠道参数和回调地址，并接入短信、DDNS 事件转发及测试发送。
通知中心新增版本更新提醒：后台每天北京时间 09:00 和 18:00 检测，发现新版本时按渠道首次提醒一次，不对检测失败或无更新场景推送通知。

💫 体验优化

抽象封装前端通用 IPv6 公网地址筛选工具，仪表盘连接展示、设备网络 DDNS 接口统一复用同一套判定规则。
数据连接看门狗保留蜂窝状态巡检与 Modem 自愈能力，不再自动清空宿主机 iptables/ip6tables 规则，避免影响 Docker、VPN 及容器端口映射等业务。
切换蜂窝数据连接时取消全局防火墙规则刷新，减少对宿主机网络栈、容器转发链路的副作用。
通知中心统一在模板渲染层将短信、DDNS 的时间变量格式化为北京时间，避免各渠道收到 UTC 原始时间。

🐞 bug 修复

修正 DDNS 模块 IPv6 公网地址判断逻辑，前后端统一以公网域 IPv6 作为 AAAA 记录候选地址，避免误选链路本地地址、内网 ULA 地址。
IPv6 地址候选按 /128 优先排序，提升多 IPv6 地址场景下 DDNS 自动选择地址的准确性。
修复宿主机 FORWARD 默认策略为 DROP 时，清空 filter 表规则引发 Docker 网桥转发失效、外部无法访问容器映射端口的问题。
修复企业微信应用消息可能报错的问题。

📚 接口与文档更新

明确 NetworkManager wwan* 非托管配置仅用于防止蜂窝接口被双重管理，不会直接修改 iptables 规则。
同步更新 README 及 Bruno 接口示例，标注 iptables/ip6tables 仅作只读诊断使用，程序不会自动清空宿主机防火墙规则。

📌 v1.0.3

✨ 新增功能

新增“设备网络”模块，用于配置设备侧 WLAN 客户端联网、 DDNS 动态解析，以及后期其他高级功能的扩充。
新增设备侧 WLAN 管理能力：
- 开启 / 关闭 WLAN。
- 扫描附近无线网络。
- 连接、断开和忘记已保存 WLAN。
- 保存自动加入和 IPv4 地址配置。
新增原生 DDNS 同步能力：
- 支持腾讯云 DNSPod、阿里云 AliDNS 和 Cloudflare。
- 支持 IPv4 / IPv6 独立解析配置。
- 支持通过网卡或多接口 API 获取公网 IP。
- 支持立即同步、后台周期同步、同步状态和最近 50 条运行日志。
DDNS 变更和失败事件接入通知中心，可按通知渠道独立开启“DDNS 变更”转发。

💫 体验优化

侧边栏和页面分为“蜂窝网络”和“设备网络”，职责更清晰。
OTA 更新页面优化待安装更新和验证结果展示，在线更新支持 GitHub Release 检查、下载加速节点和下载进度。
仪表盘温度展示改为冷到热连续热力色，并同时标识最低和最高温度探头。

🐞 bug 修复

运营商扫描和手动 / 自动注册增加超时处理，避免 ModemManager D-Bus 调用长时间阻塞。
数据连接 watchdog 增强长时间 searching 状态恢复逻辑，可自动尝试重新注册或循环射频状态。
注册遇到 QMI network selection internal 类错误时统一走射频恢复流程，减少注册异常后的卡死概率。

📚 接口与文档更新

新增设备网络 API 文档和 Bruno 示例，覆盖 DDNS 配置、状态、同步、日志以及 WLAN 状态、扫描、连接、断开、忘记和配置保存。
API 契约新增 DDNS、WLAN 和 DDNS 同步日志相关类型。
配置持久化新增 device_network.ddns，通知渠道配置新增 forward_ddns。

📌 v1.0.2

✨ 新增功能

频段锁定状态新增后端报告的真实支持频段：
- supported_lte_fdd_bands
- supported_lte_tdd_bands
- supported_nr_fdd_bands
- supported_nr_tdd_bands
小区与信号数据增加 qmicli 兜底解析，提升 ModemManager GetCellInfo 不可用场景下的可观测性。

💫 体验优化

优化移动网络注册问题的诊断路径，重点区分 SIM 归属运营商、当前注册网络、漫游状态、射频模式、频段限制和小区数据。
前端自定义频段选项改为基于后端 SupportedBands 动态显示，不再依赖固定写死的 LTE/NR 频段列表。
从“未锁定”切换到“自定义”时，默认勾选当前设备真实支持的全部频段，更符合使用预期。
移除网络页面中不必要的“验证说明”文案，简化频段锁定 UI。

🐞 bug 修复

SIM 信息优先从 IMSI 推导 MCC/MNC，避免注册到漫游网络时把当前网络运营商误当成 SIM 归属运营商。
后端设置自定义频段时会校验用户选择是否被当前 modem 支持；发现不支持的频段会返回明确错误，不再静默忽略。
自动注册遇到 QMI Internal 类错误时增强恢复处理，降低调制解调器处于异常注册状态时的卡死概率。

📚 接口与文档更新

修正 README、Bruno API 示例 and 前端开发代理中的默认访问地址为 http://192.168.68.1:3000/。

📌 v1.0.1

✨ 新增功能

新增“通知中心”多渠道通知配置能力。
- 通知配置从单一 Webhook 扩展为多渠道：
  - Webhook
  - Bark
  - 企业微信应用消息
  - 企业微信群机器人
  - 钉钉群自定义机器人
  - 钉钉企业内机器人
  - 飞书机器人
  - Telegram 机器人
- 新增通知中心后端接口：
  - GET /api/notifications/config
  - POST /api/notifications/config
  - POST /api/notifications/test/{channel}
- 新增各通知渠道的测试发送能力，可按渠道发送模拟短信测试。
新增短信批量管理能力。
- 删除短信：
  - 删除单条短信
  - 删除整个短信对话
  - 批量删除短信或多个对话
- 新增短信删除相关后端接口：
  - DELETE /api/sms/message/{id}
  - DELETE /api/sms/conversation/{phone_number}
  - POST /api/sms/batch-delete
新增设备侧一键卸载脚本 uninstall.sh，支持彻底卸载和保留用户数据卸载。

💫 体验优化

Dashboard 仪表盘加载性能优化。
通知中心页面重构为左右分栏布局：
- 左侧展示通知渠道列表和启用统计
- 右侧展示当前渠道配置表单
通知中心支持按渠道独立配置启用状态、短信转发、模板和渠道专属参数。
通知模板编辑支持中文变量标签，前端显示中文变量，保存时映射为后端变量。
通知渠道测试按钮会先保存当前配置，再执行测试，减少“配置未保存导致测试不生效”的误操作。
短信页面优化为更完整的对话管理体验：
- 对话列表支持删除按钮
- 聊天消息支持单条删除
- 支持批量管理，有清晰的选择数量提示
- 删除这种不可逆的危险操作增加二次确认
短信列表加载数量提升，减少历史短信遗漏。

📚 接口与文档更新

README 中 Webhook 章节改为“通知中心”，补充多渠道通知能力说明。
Bruno 文档同步更新通知中心接口说明。
README 新增卸载脚本使用说明、参数说明和清理范围说明。
API 类型定义新增完整通知中心配置类型，包括各渠道配置结构。