| 1 | # Storage 工具 |
| 2 | |
| 3 | 浏览器存储与 zustand 持久化工具目录。只放跨 store 复用的存储适配器和持久化 store 工厂。 |
| 4 | |
| 5 | ## 文件清单 |
| 6 | |
| 7 | | 文件 | 导出 | 说明 | |
| 8 | | ----------------------- | ----------------------- | ------------------------------------------------------------------------------------------ | |
| 9 | | `localStorage.ts` | 内部 `appLocalStorage` | SSR 安全的 zustand `StateStorage` localStorage 适配器，仅供 `createPersistStore` 使用。 | |
| 10 | | `indexedDBStorage.ts` | 内部 `indexedDBStorage` | SSR 安全的 IndexedDB 存储适配器，失败时回退 localStorage，仅供 `createPersistStore` 使用。 | |
| 11 | | `createPersistStore.ts` | `createPersistStore` | zustand + persist + combine 的项目级持久化 store 工厂。 | |
| 12 | |
| 13 | ## 使用规则 |
| 14 | |
| 15 | - 需要持久化的 store 优先复用 `createPersistStore`。 |
| 16 | - 只有多个 store 共用的存储能力放这里；单个 store 私有缓存逻辑放对应 store 目录。 |
| 17 | - 新增存储适配器必须说明 SSR 行为、降级策略和适用场景。 |
| 18 |