Flatkey Node v0.5.3 — 删 preview-mode 假授权,改为 'bridge 未就绪' 真错误
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 默认指向。