用途:该技能提供 Velt Live State Sync API 的实现指南,用于在协作应用中实现跨客户端的实时共享状态,官方描述称具备亚 10ms 延迟、离线支持与 Redux 中间件集成。
适用时机:为协作应用添加实时共享状态(计数器、选中项、光标、工具模式);使用 useLiveState 实现类似 useState 的共享状态;使用 useSetLiveStateData / useLiveStateData 分离读写;使用 LiveStateSyncElement 进行可观察订阅或基于 Promise 的获取;通过 createLiveStateMiddleware 集成 Redux 以同步整个 store;通过 REST API 从服务器广播状态更新;监控连接状态以显示离线/在线指示。
规则分类与优先级:Core(CRITICAL,前缀 core-)、Hooks(CRITICAL,hooks-)、Element(HIGH,element-)、Redux(HIGH,redux-)、API(MEDIUM,api-)、Patterns(MEDIUM,patterns-)。
前置条件:需要 VeltProvider 配合 authProvider 包裹应用,并设置 documentId 以限定状态作用域;除 @veltdev/react 外无需额外包。
文档:AGENTS.md 为所有规则的压缩索引(含文件路径,建议从此开始);AGENTS.full.md 为展开全部规则的完整指南。
限制:资料未提供具体代码示例、安装命令、收费与价格信息,也未说明各平台兼容性细节,这些内容暂未提供。