必须通过atoms官方supabase连接器完成oauth授权与凭据绑定，否则无法触发数据同步与实时事件监听；登录atoms控制台→进入integrations→搜索并添加supabase→用同一邮箱授权→勾选项目设置与数据库结构权限→配置项目与表同步范围→启用realtime cdc自动或手动模式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Atoms 平台中连接 Supabase 数据库，必须通过 Atoms 官方提供的 Supabase 连接器完成 OAuth 授权与数据库凭据绑定，跳过手动配置连接字符串或环境变量的步骤，否则无法触发 Atoms 内置的数据同步与实时事件监听机制。
在 Atoms 中添加 Supabase 连接器
登录 Atoms 控制台 → 点击左侧导航栏「Integrations」→ 在搜索框输入「Supabase」→ 点击「Add」按钮启动连接流程。
Atoms 将跳转至 Supabase 的 OAuth 授权页，此时需使用与 Supabase 项目归属同一邮箱的账户登录；【若用其他邮箱授权，Atoms 将无法读取该项目的 API 密钥和表结构】。
勾选「Allow access to project settings and database schema」后点击「Authorize」，授权成功后页面自动返回 Atoms，连接器状态变为「Connected」。
配置数据库访问权限与同步范围
点击刚添加的 Supabase 连接器卡片 → 选择「Configure」→ 在「Project Selection」下拉菜单中选择目标 Supabase 项目（仅显示你有 Owner 或 Editor 权限的项目）。
进入「Table Sync Settings」区域，勾选需要双向同步的表名。注意：未勾选的表不会出现在 Atoms 数据流节点中，也无法被后续的 Transform 或 Trigger 节点引用。
点击「Save & Validate」，Atoms 会向 Supabase 发起一次 schema 拉取请求。若提示「Failed to fetch table list」，请确认该 Supabase 项目的 【Row Level Security (RLS) 已对 anon 用户禁用或配置了对应策略】，否则 Atoms 无法读取元数据。
启用实时变更捕获（Realtime CDC）
方法一：自动模式（推荐）
在连接器设置页，开启「Enable Realtime Changes」开关 → Atoms 自动在 Supabase 侧创建一个 service role 用户，并为其授予 LISTEN 权限及对应表的 SELECT 权限 → 系统生成唯一 channel 名称（如 atoms_realtime_v2_abc123）并写入 Supabase 的 replication slot。
方法二：手动模式（适用于已存在 pg_recvlogical 流程的团队）
关闭自动模式 → 复制 Atoms 提供的 logical replication connection string → 登录 Supabase SQL Editor，执行：
SELECT * FROM pg_create_logical_replication_slot('atoms_manual_slot', 'pgoutput');
再将该 slot 名填入 Atoms 手动模式字段中。
启用后，Atoms 即刻开始监听 INSERT/UPDATE/DELETE 事件，延迟通常低于 800ms。此过程不可逆，关闭开关不会删除已创建的 replication slot，需手动清理避免 WAL 积压。
