SuperAPI AI 工具集

superpower-zustand

前端与建站

查看项目

更新于 10-15 20:30

技能介绍

用途:在 React 应用中进行客户端状态管理时,强制采用统一的 Zustand store 创建方式;用户提及状态管理、创建 store 或 Zustand 时应使用本技能。

主要能力:使用 StoreBuilder 工具(源文件 skills/superpower-zustand/assets/storebuilder.ts,复制到 src/lib/storebuilder.ts 或类似位置);将状态类型与动作分离,用 Omit 排除动作方法后传入 StoreBuilder;用 createFactory 定义动作,通过闭包访问 set;内置 immer 中间件,更新时直接修改 draft,不返回新对象;支持可选持久化,可配置 name、version、storage、partialize;同时提供响应式 useStore hook 与非响应式 get/set/subscribe 访问。

使用方式:先定义完整状态类型,再初始化 StoreBuilder,传入初始状态和可选 PersistConfig;然后用 createFactory 定义动作并导出 hook,命名如 useMyStore。在 React 外可通过 StoreBuilder 返回的 get、set、subscribe 使用。复杂 store、异步操作或持久化细节可参考 references/pattern-guide.md。

限制:必须使用 StoreBuilder,动作只能定义在 createFactory 中;状态更新必须采用 immer 式直接修改,不得返回展开的新对象。资料未提供安装命令、许可方式、具体版本或兼容性信息。