Agent Skills
返回列表
💻

Json-Render Jotai 状态适配器

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/vercel-labs-json-render-jotai。

技能介绍

背景:json-render 需要可插拔的状态后端

json-render 通过 StateStore 抽象读写渲染所需的状态模型。若你已经在 React 应用里用 Jotai 管理全局或局部状态,再为 json-render 单独维护一套状态,容易出现双写、订阅不一致,调试时也难以对齐「组件里看到的 atom」和「渲染引擎里看到的 model」。

技能做什么:用 Jotai atom 实现 StateStore

本技能围绕 jotaiStateStore(options):把 可写 atom(WritableAtom)作为状态承载,让 json-render 的读写走同一套 Jotai 数据流。

  • atom(必填):持有与 json-render 状态模型对应的可写 atom。
  • store(可选):传入应用里已有的 Jotai Store 实例;不传则使用默认新 store。传入后,json-render 与现有 Jotai 组件共享同一 store,避免两套状态树。

典型用法是:应用已配置自定义 Jotai store 时,在初始化 json-render 时把该 store 一并传入,使渲染层与业务组件对同一 atom 的更新立即可见。

适用与注意

技能覆盖的是 StateStore 适配层,不包含 json-render 的 schema、组件映射或 Jotai 本身的 atom 设计。你需要自行定义 atom 的结构是否与 json-render 期望的 model 一致。未传 store 时状态隔离在默认 store 内,不会自动与页面其余 Jotai 逻辑合并——若要与现有应用共享状态,务必显式传入同一 store。

使用场景

  • 在已有 Jotai 自定义 store 的 React 项目里,把 json-render 接到同一 store,避免渲染状态与业务 atom 分叉。
  • 用单个可写 atom 承载 json-render 的状态模型,让 AI 或配置驱动的 UI 更新直接反映到 Jotai 订阅组件。
  • 从非 Jotai 状态迁到 Jotai 时,只需实现 StateStore 适配,而不改 json-render 上层集成方式。
  • 调试 json-render 与页面组件状态不一致时,通过共享 store 在同一 DevTools/订阅链路上对比 atom 值。

适合人员

  • 在 Vercel json-render 方案里做 React 集成、必须把渲染状态纳入现有 Jotai 数据流的前端工程师
  • 维护多套全局状态(Jotai + json-render 默认存储)并想合并为单一 store 的全栈或前端负责人
  • 用 Jotai atom 描述 AI 生成 UI 的状态、需要渲染引擎与业务侧读写同一模型的技能作者
  • 评估 json-render 状态抽象、需要快速验证「Jotai 作后端」是否满足项目约束的技术调研者