Skip to content

Release v2.3.1

Choose a tag to compare

@luyii-code-1 luyii-code-1 released this 15 May 04:11
· 81 commits to main since this release

Full Changelog: v2.2.0...v2.3.1

Light RID Scanner v2.3.0

v2.3.0 是一次版本结构、远程聚合和部署形态升级。项目现在拆分为完整基站版 station_edition、最小化便携版 portable_edition,并新增独立的 Node Center Viewer,用于集中查看和维护多个采集节点。

主要更新

  • 新增 station_edition/ 与 portable_edition/ 版本目录:

    • station_edition 保留完整扫描、网页、鉴权、AP、systemd 和维护能力。
    • portable_edition 面向移动部署,默认关闭网页登录、API Token、SSO、Passkey、指标和企业微信通知。
    • 根目录 run.py 保留为基站版兼容入口。
  • 新增 Node Center Viewer:

    • viewer/server.py 可聚合多个 Station 子站 API。
    • 主界面复用 Station 实时/历史页面模板。
    • 新增 /settings Viewer 设置页和 /nodes 节点管理页。
    • 支持节点添加、测试、负载卡片、扫描统计、远程 SSO URL 创建、批量重启和模型库更新。
    • 节点 URL 现在只接受 API 根地址,并会真实测试 /api/v1 与 /api/v1/snapshot 后再保存。
  • 扩展 Station Token API:

    • 新增或完善 /api/v1、/api/v1/snapshot、/api/v1/drones、/api/v1/tracks/{sn}、/api/health 等接口。
    • 支持 Viewer 通过 X-API-Token 和 Authorization: Bearer 访问子站。
    • 增加历史、轨迹、配置重载、日志和指标相关接口,便于远程维护。
  • 改进离线/AP 场景地图体验:

    • 内置 Leaflet 资源,AP 客户端无公网时仍可加载地图基础交互。
    • 增强 N/A 或非法坐标处理,避免地图跳到错误位置。
    • 历史和实时地图优先使用可显示的飞机坐标。
  • 安全与认证调整:

    • 强化 HTTP 安全响应头和 GitHub Actions 权限。
    • 认证密钥迁移到 PBKDF2/scrypt 风格的安全哈希方案,并移除旧 SHA-256 兼容路径。
    • API 公共访问受鉴权配置控制;未启用时仅内置页面会话可访问内部 API。
    • 保持“至少一种登录方式可用”的防锁定逻辑。
  • 运行状态与维护能力增强:

    • 改进树莓派温度探测,覆盖 vcgencmd、PMIC、thermal_zone、hwmon 和 w1/DS18B20。
    • 增强主机指标、日志导出、运行时状态快照和诊断数据。
    • 历史记录保留原始包片段,为后续重解析和修复提供数据基础。
  • 构建与发布流程升级:

    • 新增 pytools/build_release.py,统一构建 Station / Portable 的 x86_64 与 arm64 二进制。
    • 新增 pytools/build_viewer.py,构建 Viewer 独立二进制。
    • CI 现在覆盖:
      • light_rid_station-x86_64
      • light_rid_station-arm64
      • light_rid_portable-x86_64
      • light_rid_portable-arm64
      • light_rid_viewer-x86_64
      • light_rid_viewer-arm64
      • light_rid_viewer-windows-x86_64

兼容性说明

  • 运行文件默认改为当前工作目录下的 config.json、history-cache.json 和 rid-models.json。
  • 旧入口 run.py 仍可使用,但实际会进入 station_edition。
  • rid_config.example.json 已迁移为 station_edition/config.example.json。
  • 使用 arm64 发布产物需要 64 位系统。
  • 认证配置已升级,旧 SHA-256 密码/Token 存储不再作为兼容路径保留。

推荐升级步骤

  1. 备份现有配置、历史缓存和模型库文件。
  2. 使用 Station 版替换原有基站部署。
  3. 检查 config.json 中认证、API Token、网卡绑定和 AP 设置。
  4. 如需集中管理多个节点,启动 Viewer 并在 /nodes 中添加各 Station API 根地址。
  5. 树莓派二进制部署建议使用对应架构的 light_rid_station-arm64 或 light_rid_station-x86_64。