Zephyrian 平台文档

Appearance

nem-auth-collector · 通用授权采集 ​

当前版本 v0.3.1 · 一键安装 · 查看源码

一次安装覆盖 NEM / NDP / Waypulse 三个域名,自动把对应 token 同步到 NEMPOI / MapDeploy 两个后端(Vehicle Analytics 后端预留)。NEMPOI 与 MapDeploy 的 sync_key 都走 zephyrian.site SSO 自动取,装上即用。

适用场景 ​

  • NEMPOI 运营 + MapDeploy 运营(NDP / Waypulse OTA 操作)— 一次安装覆盖所有授权同步
  • 多人协作 — MapDeploy v0.4.0+ 走 per-user secret,各运营 token 互不覆盖
  • 不愿手动复制 sync_key / secret

使用步骤 ​

  1. 先确保已登录 zephyrian.site 门户(zsess cookie 跨子域共享 — collector 自动取 sync_key 的前提)
  2. 装 Tampermonkey → 点上面「一键安装」
  3. 装好后访问任一域名页面(NEM / NDP / Waypulse),右下角出现 14px 圆点,hover 浮出后端状态面板
  4. NEMPOI sync_key 完全自动 — GM_xmlhttpRequest 调 nempoi.zephyrian.site/api/admin/sync-info,zsess cookie 自动带,后端识别用户返 sync_key
  5. MapDeploy sync_key 也完全自动 — GM_xmlhttpRequest 调 mapdeploy.zephyrian.site/__bookmarklet/sso-secret,反查 fleet portal-me 后 lazy 建 mapdeploy_secrets 行,返该用户的 sync_key
  6. Vehicle Analytics 后端未上线,圆点状态聚合显示「后端未上线」,留空可跳过

圆点颜色聚合 ​

14px 锚点的颜色按所有 backend 当前状态聚合:

颜色含义
🔴 红任一 backend err(401/403/网络错;hover 看具体哪个)
🟠 橙有 backend 缺 sync_key 或 secret(no_key)
🟢 绿全部 backend ok(token 已成功同步)
⚪ 灰等待 token / 全部预留未上线

Hover 整个 wrapper 浮出原 backend 状态面板,显示每个 backend 的细粒度状态、推送 token 长度、时间戳。

浮窗操作 ​

  • 位置 — 右下 120px(让开 batch-edit 84 / point-filter 48 / 锚点 12)
  • 拖动 — 直接按住圆点拖到任意位置,cursor:move 提示;panel 展开时也可从标题栏拖,与圆点拖动共享同一 LS(auth_collector_panel_pos)
  • 双击标题 — 折叠 body,只剩标题栏

换 / 清 key ​

浏览器 console 跑:

javascript
// 清 NEMPOI sync_key(下次自动重新拉)
localStorage.removeItem('auth_collector_nempoi_sync_key');

// 清 MapDeploy sync_key(下次自动重新拉,v0.2.0+)
localStorage.removeItem('auth_collector_mapdeploy_sync_key');

// 清浮窗位置(回到默认右下)
localStorage.removeItem('auth_collector_panel_pos');

location.reload();

安全边界 ​

  • 所有 sync_key 仅在浏览器 localStorage 存,只往 @connect 白名单 host 发(nempoi / mapdeploy / fleet-analytics)
  • NEMPOI 端鉴权:sync_key 由 nempoi 后端按 zsess cookie 识别用户后返,跟用户绑定
  • MapDeploy 端鉴权(v0.2.0+):sync_key 由 mapdeploy 后端反查 fleet portal-me 后返,per-user 隔离
  • 不读、不验证 NEM 用户身份 — collector 跟 NEM 会话权限走,不放大权限
  • 三套账号体系不互通(NEM / NDP / Waypulse,详见 系统架构 中 neolix-account-systems),collector 各 backend 拿到的是各自体系独立 token

更新日志 ​

v0.3.1 — 2026-06-26 ​

圆点直接可拖,与 point-filter v0.4.3 / batch-edit v0.4.1 形态对齐。dotEl 加 mousedown → startDrag,与 title 拖动共享同一 drag state。clamp 边距 30 → 14(圆点宽度)允许贴边。详见 PR #11。

v0.3.0 — 2026-06-25 ​

14px 圆点锚点 + hover 展开整个浮窗。圆点颜色按所有 backend 状态聚合(红/橙/绿/灰), 让运营一眼判断有没有未配 / 出错的 backend。位置 right:12 bottom:120 让开 batch-edit 84 / point-filter 48 / 老脚本位 12。

v0.2.0 — 2026-06-25 ​

MapDeploy backend 改 authMode:'auto',走 zsess SSO 调 mapdeploy.zephyrian.site/__bookmarklet/sso-secret 自动取 sync_key, 配套 nem-map-deploy v0.4.0 per-user secret 改造。lsKey 从 auth_collector_mapdeploy_secret 改 auth_collector_mapdeploy_sync_key。

v0.1.5 — 2026-06-24 ​

跨域全局同步状态板。三个域(NEM / NDP / Waypulse)的 backend 状态用 GM_setValue/GM_getValue 共享,让"NDP 页里也能看到 NEM 同步是否成功"。

v0.1.3 — 2026-06-24 ​

浮窗可拖动 + 位置 localStorage 持久化。

v0.1.0 — 2026-06-23 ​

首版:三 @match + 四后端推送。

京ICP备2026033946号

Zephyrian Platform © 2026