用途:这是一个面向智能体的 PowerSync 技能(Skill),用于把项目接入 PowerSync 并在之后维持其健康运行,主打引导式工作流,其次才是参考资料库。处理前须先阅读 AGENTS.md,其中含强制合规规则与接入手册。
主要能力与覆盖范围:Cloud 与自托管的搭建、同步配置(新项目用 Sync Streams,Sync Rules 为旧版)、客户端 SDK 使用、后端集成,以及从 Electric Cloud 迁移、Terraform/IaC 配置、调试同步问题、Raw Tables、附件、SQLite 扩展和架构概览。SDK 参考覆盖 JS/TS(含 React、Next.js、React Native、Expo、Vue、Nuxt、Node、Electron、TanStack、Drizzle/Kysely)及 Dart/Flutter、.NET、Kotlin、Swift、Rust。
使用方式:CLI 优先,所有操作使用 PowerSync CLI,不手写配置文件;先询问运营方选择 Cloud 还是自托管、使用哪种后端(Supabase、Postgres、MongoDB、Azure DocumentDB、MySQL、MSSQL),不默认 Supabase;先部署同步配置并验证服务,再写应用代码。凭证放在 .env,不硬编码。执行任何变更命令(deploy、destroy、stop、link --create、pull instance)前须确认目标实例,未经授权不得部署,生产环境默认禁入。首次在仓库使用时运行 node scripts/trim.mjs 做只读报告,经运营方明确同意后再执行 --apply。
关键规则:表结构不要定义 id 列(自动创建);布尔用 column.integer,ISO 日期字符串用 column.text;connect() 为 fire-and-forget,需要就绪时用 waitForFirstSync();每次会话只调用一次 connect();transaction.complete() 必须调用,否则上传队列永久停滞;退出登录按设备可能残留的数据选择 disconnect()、disconnectAndClear(soft: true) 或默认 disconnectAndClear(),绝不能为用户保留另一用户的数据;uploadData 返回 4xx 会永久阻塞上传队列,校验错误应返回 2xx。
限制:关于收费、价格、平台支持与效果等事实,资料未提供。