Skip to content

Flatkey Node v0.5.3 — 删 preview-mode 假授权,改为 'bridge 未就绪' 真错误

Choose a tag to compare

@mguozhen mguozhen released this 23 May 03:01

v0.5.3 · 关键 UX 修复

Root cause

在 macOS Tahoe 26.4.1(可能其他 macOS 也有)上,.app 内 WKWebView 加载 file://app-ui.html 时,window.webkit.messageHandlers.flatkey没注入到 JS 上下文(Swift 端 binary 已注册,只是 JS 拿不到引用)。

旧逻辑(v0.5.0 - v0.5.2):桥找不到就走"预览模式假装授权完成",导致用户以为绑成功了,实际没绑 → 节点本机 sub2api accounts=0 → NAS 调度到该节点 503。

Fix

  • connectAi() / submitOauthCode() 的 preview-mode fallback
  • 桥不存在 → 直接报错 "桥未就绪 · 重启 .app",引导用户退出菜单栏 ⬡ → 重启 .app(重启后 announce.env 存在 → 走 activated=true → 直接加载 dashboard 而非 file:// onboarding,绕过 Tahoe bridge 问题)

v0.5.2 vs v0.5.3

v0.5.2 是内测 unsigned 版,仅自动更新通道用。v0.5.3 是正式版本,推荐 install.sh 默认指向。