SuperAPI AI 工具集

1k-state-management

通用与其它

查看项目

更新于 10-15 21:09

技能介绍

用途:为 OneKey 项目提供 Jotai 状态管理的统一组织规范,适用于处理 atoms、全局状态、功能状态或 context atoms 的场景,触发关键词包括 jotai、atom、state 等。

主要能力与结构:项目只允许两种原子模式。全局状态原子用于应用级、可持久化状态,位于 packages/kit-bg/src/states/jotai/atoms/,使用 globalAtom 与 EAtomNames 标准化,示例包括 settings.ts、account.ts、hardware.ts、currency.ts。功能级状态原子用于局部功能,位于 packages/kit/src/states/jotai/contexts/[feature_name]/atoms.ts,使用 createJotaiContext 提供的 contextAtom,目录内通常包含 atoms.ts(状态定义)、actions.ts(状态操作)和 index.ts(导出)。

选用标准:需要跨应用重启持久化、被多个主要功能使用或影响整个应用(如设置、认证)时用 globalAtom;仅属于某功能或模块、临时或会话级、在功能内相关组件间共享时用 contextAtom。

禁止事项:不得在 packages/kit/src/views/ 下创建 atom 目录;不得在组件目录中创建独立 atom 文件;不得在无架构理由时混用 globalAtom 与 contextAtom;不得创建自定义原子模式或在既定结构外使用普通 Jotai 原子。

使用方式:组件中通过 jotai 的 useAtom、useAtomValue、useSetAtom 读取或写入原子。创建全局原子时从 ../utils 引入 globalAtom、从 ../atomNames 引入 EAtomNames,并可按需设置 persist: true;创建上下文原子时从 ../../utils 引入 createJotaiContext,解构出 contextAtom 与 useContextAtom 并导出 hook。

限制:资料仅覆盖上述目录约定与代码模式,未提供安装命令、版本要求、测试方式或性能数据。