用途:local-first 是一个架构决策框架,帮助 Web 应用判断应采用服务端架构、本地优先架构还是混合架构。本地优先指应用直接读写本地数据库,变更在后台同步到服务器;本地数据库作为 UI 的真相来源,从而获得即时读取、离线支持和默认乐观写入。
适用场景:需要离线支持的协作应用、对延迟敏感的 UI、网络不稳定环境、实时多人功能、连接间歇性的移动应用。不适合:连接可靠的简单 CRUD 应用、服务端权威流程(支付、库存)、以内容为主且交互少的站点、每次渲染都依赖服务端最新数据的应用。
主要能力:给出决策速查表,覆盖架构模型、读路径、写路径、同步引擎、客户端存储、冲突解决、数据模型、部分复制、渐进增强、CQRS 分离、初始同步、鉴权集成、Schema 演进、状态管理与测试策略。同步引擎选项包括 Electric、Zero、PowerSync、Replicache、LiveStore;客户端存储包括 IndexedDB、OPFS、SQLite WASM、PGlite;冲突解决包括 LWW、CRDT、server-wins、字段级合并。
常见错误提醒:简单 CRUD 应用不应上本地优先;先定义数据模型再选同步引擎;冲突解决需尽早设计;避免向每个客户端同步整库;本地数据库不是缓存;不必对所有字段用 CRDT;要规划本地 Schema 迁移。
委派与用法:若已安装 electricsql、realtime-sync、tanstack-db、tanstack-start 等 skill,可将相应细节委派;否则资料建议的命令为 pnpm dlx skills add oakoss/agent-skills -s electricsql -a claude-code -y 等(保持原样)。
限制:资料未提供具体收费、价格、平台支持范围与效果数据,暂未提供。