SuperAPI AI 工具集

yjs-nextjs

前端与建站

查看项目

更新于 10-16 09:51

技能介绍

用途:本技能针对在 Next.js 16 App Router 应用中构建 Yjs 协同编辑、在线状态或离线同步时,模型容易做出的错误默认选择,逐条给出纠正规则,供编写或审查代码时套用。仅覆盖这些技术与 CRDT 的交汇处,一般 App Router、tRPC 或 shadcn/ui 用法不在范围内。

主要能力:规则分七类——同步拓扑与依赖(host-)、二进制传输与持久化(wire-)、共享类型建模(model-)、文档生命周期与 React 绑定(react-)、撤销与快照(hist-)、在线状态与光标(pres-)、编辑器与表单集成(ui-)。每条规则先指出其纠正的错误默认,再给规范做法,并尽量附正确与错误对照。

版本约束:规则面向 Yjs 13.6.31、y-websocket 3.0.0、y-protocols 1.0.7、y-indexeddb 9.0.12;Yjs 正迁往 @y/* 作用域的 v14 预发布线,安装前需先确认宿主依赖是否仍停留在 v13 一轨。

使用方式:遇到对应决策时查阅相应规则文件;调试时可按症状定位,如文档空白看 rehydrate 与 IndexedDB 等待、内容重复看一次性种子与 Tiptap 接线、编辑被回退看嵌套类型与撤销来源、拖拽重复看 Y.Array 无移动操作、两端互不可见看实例亲和性、光标跳尾看表单受控方式、渲染死循环看订阅方式。规则库还含 AGENTS.md 目录与各参考文件。具体示例与完整命令资料未逐条提供,此处不展开。