SuperAPI AI 工具集

effector-storage

编程与开发

查看项目

更新于 10-15 16:43

技能介绍

用途:该技能用于设计、实现和调试 Effector 应用中的 effector-storage 持久化,目标运行时行为可预测。适用任务包括 persist/createPersist 的使用、适配器选择、契约与错误通道、同步调试以及 SSR 兜底。

主要能力与工作流:先把请求分类为 adapter-choice(选适配器)、integration(接入现有模型流)、contracts-errors(校验存储负载并路由失败)、sync-debug(排查跨标签页、query、broadcast 同步问题)、ssr-fallback(让持久化在浏览器与服务器运行时都安全)。随后按需渐进加载参考资料:从 references/core-patterns.md 起步;需要适配器选择或配置时加 references/adapter-matrix.md;涉及异步、either、farcached 或组合配方时加 references/tools-and-composition.md;涉及契约与错误通道时加 references/contracts-and-errors.md;定稿前看 references/pitfalls-and-checklist.md。

输出约定:先给出明确的适配器决策及理由,再给带显式 key 策略的最小可用片段,列出行为注意事项(初始化时机、同步限制、校验行为),最后补充针对所选流程的验证步骤或测试。

默认约定:面向 effector-storage v7.x 行为;优先使用显式 key 而非隐式 store 名以提升可移植性;优先使用围绕 persist 的声明式 Effector 接线(sample/clock/context 单元);保持负载为普通结构且序列化稳定(deserialize(serialize(x)))。

限制与护栏:不要同时省略 key 和 store 名;不要对非 store 单元使用 source === target;不要假设 pickup 仍会执行自动初始恢复(它会禁用该行为);不要假设契约校验会阻止写入,无效值仍可能被持久化并通过 fail 上报;不要将 broadcast 当作持久存储,它只是仅同步的消息传递。来自 effector-storage-extras 的适配器沿用同一适配器契约与决策流程,但编码前需在该仓库核实准确的 API 与选项。