跳转到主要内容

​
Supabase 集成

Supabase 是 Subscription Manager 的可选云层。未配置 Supabase 时，应用仍然可以使用本地存储模式。

​
Supabase 负责什么

  • 用户认证。
  • 多设备订阅同步。
  • API Key 归属关系。
  • 订阅数据表。
  • 付费状态和套餐信息。
  • Bark 提醒配置。
  • AI 录入的每日配额与月度预算计数。

​
配置步骤

  1. 创建 Supabase 项目。
  2. 应用 supabase/ 目录下的 migrations。
  3. 在前端配置 VITE_SUPABASE_URL 和 VITE_SUPABASE_ANON_KEY。
  4. 在 Netlify Functions 环境中配置 SUPABASE_SECRET_KEY，或继续使用兼容别名 SUPABASE_SERVICE_ROLE_KEY。

​
SQL migrations

正式 schema 由时间戳迁移管理： 
supabase/migrations/20260615000100_baseline.sql
supabase/migrations/20260615000200_harden_existing_schema.sql
supabase/migrations/20260616000100_public_api.sql
supabase/migrations/20260617000100_public_api_security_fixes.sql
supabase/migrations/20260618000100_agent_operations_layer.sql
supabase/migrations/20260619000100_ai_capture.sql
supabase/migrations/20260625000100_ai_budget_reservations.sql
AI 录入相关表只保存每日调用次数和月度聚合 token 计数，不保存用户粘贴的文本、截图或解析内容。

​
安全边界

浏览器只能使用 anon key。任何需要绕过 RLS 或执行可信写入的逻辑，都必须放在 Netlify Functions 中，并使用 service role key。

​
RLS

数据库表应该通过 Row Level Security 限制用户只能访问自己的数据。开放 API 也会根据 API Key 所属用户过滤订阅查询。

​
与开放 API 的关系

开放 API 使用 Developer API Key 认证。Function 验证 key 后，会以 key owner 的身份读写订阅数据。