SuperAPI AI 工具集

1k-cold-start-ssr

通用与其它

查看项目

更新于 10-16 02:38

技能介绍

用途:为 OneKey 原生应用提供冷启动优化,思路类似 Web SSR 水合——把上一会话的 Jotai atom 值写入 MMKV,启动时预读并作为 atom 初始值,让首次 React 渲染立即显示缓存数据,随后后台线程再拉取新数据并原地更新。目前仅支持原生(iOS/Android),桌面、Web、扩展端支持计划中。

主要能力与流程:分四个阶段。阶段一预读,在 apps/mobile/index.ts 入口顶部、任何模块导入前同步读取专用 MMKV 实例 coldStartCacheStorage,写入 globalThis.ONEKEY_CTX_ATOM_SNAPSHOT。阶段二水合,在 contextAtomBase() 模块求值时读取快照作为 initialValue,并用 memoizee 保证 atom 只创建一次;另有 hydrateContextColdStartCacheForProvider() 在 provider 挂载时做按账户作用域水合。阶段三保存,flushColdStartCache() 采用读-改-写,仅把脏键补进已有快照,由 scheduleColdStartSave() 防抖 2 秒触发,AppState 进入 background 时立即刷写。阶段四重新验证,后台线程拉取新数据更新 atom。快照在 HomePageReady 事件时清理,以兼容分包懒加载模块。

使用方式:参与冷启动 SSR 的 context atom 需声明 coldStartCacheKey,键集中注册在 packages/shared/src/consts/jotaiConsts.ts 的 CONTEXT_ATOM_COLD_START_CACHE_KEYS;在 contextAtom() 中传入 { coldStartCache: true, coldStartCacheKey: ... }。快照中按 {scopeKey}::{coldStartCacheKey} 存储作用域键。另有独立的 SWR 缓存(usePromiseResult)共用同一 MMKV 实例,键为 onekey_swr_cache,最多 80 条 LRU 淘汰。

适用场景与限制:适合可容忍短暂陈旧的数据,如代币列表、余额;不应缓存安全敏感或强时效数据。contextAtom 走快照 blob,globalAtom 走 MMKV 逐键直读。诊断冷启动回归可采集 NativeLogger 日志,所有启动计时行带 [StartupTiming] 标签,格式为 <label>: <duration>ms [(+<cumulative>ms from launch)] [context],并区分 iOS/Android 原生标签与 JS 侧标签。资料给出 Android 实测基线约 2.4–3.2 秒点击到余额显示,iOS 基线暂未提供。分包体积方面,main.jsbundle 约 10.1MB、求值约 1300ms 是最大瓶颈,可用 apps/mobile/scripts/unionBuild.js 分析构成。