首次使用：连接你自己的数据库

任务和图片保存在你自己的 Supabase 项目中，由你管理数据和访问权限。下面的配置只需首次完成一次，适用于 Mac 和 Android。建议在电脑浏览器中操作 Supabase，旁边打开 WhaleTodo 的首次使用向导。

1. 创建一个空的 Supabase 项目

打开 Supabase 控制台，注册或登录。选择或创建自己的组织（Organization），点击 New project，填写项目名称、数据库密码并选择区域。等项目创建完成后再继续。

为 WhaleTodo 单独新建一个空项目即可。保存好数据库密码；它用于管理数据库，不是稍后登录 WhaleTodo 的密码，也不用填进应用。

2. 把这两项填进 WhaleTodo

打开项目的 Connect 面板，找到以下两项。若需要单独查找公钥，也可打开 Settings → API Keys。

Project URL：填入「项目地址」

类似 https://your-project.supabase.co。复制完整地址，不要用控制台网页地址或数据库连接字符串。

Publishable key：填入「项目发布密钥」

以 sb_publishable_ 开头的公钥。旧项目的 anon key 也受当前应用支持；新项目优先选 Publishable key。

在 WhaleTodo 中选「第一次使用」，填写同一个项目的地址和公钥，点击「检查项目并继续」。不要填写 Secret key、service_role 管理员密钥或数据库密码。

3. 初始化数据库

应用显示「准备你的项目」后，点击「复制初始化脚本」。回到该项目的 SQL Editor，新建查询，粘贴完整脚本并点击 Run。

脚本会创建任务表、账号访问规则和私有图片存储。使用应用提供的脚本即可，不需要自己建表，也不要关闭行级安全规则（RLS）或把图片存储改成公开。

4. 设置登录方式

在 Supabase 的 Authentication → Sign In / Providers 中设置并保存：

• Email：启用。
• Allow new users to sign up：开启。
• Confirm email：关闭。
• Minimum password length：设为 16（在 Email 设置中）。

WhaleTodo 使用用户名登录，底层借助 Supabase 的 Email 登录方式，但不使用真实邮箱。因此这里关闭邮件确认，也无需配置发信服务。回到应用，点击「已完成，重新检查」。

5. 创建你的 WhaleTodo 账号

设置用户名（3–32 位英文字母、数字、下划线或短横线）和至少 16 位的密码，也可以让应用生成密码。保存好密码，再点击「创建账号并开始」。这个账号独立于你的 Supabase 控制台账号。

完成后就可以使用任务列表了。请用密码管理器保存登录信息：此用户名账号不支持邮件找回；忘记密码时，可通过项目所有者恢复流程重置原账号。AI 功能可稍后配置，需要自己的模型访问配置；后台代理还需要已配置的执行端。

公钥为什么不等于公开数据？

Publishable key 是给客户端使用的项目公钥，不能代替用户登录。按上述脚本完成权限配置后，仅有项目地址和公钥，无法读取你的任务和图片。数据库按登录账号检查数据归属，图片也由私有存储规则保护。

保护来自登录和正确的权限规则，而不是把公钥藏起来。公钥仍可用于访问开放的登录、注册接口；管理员密钥则可以绕过 RLS，必须保密。查看 Supabase 对密钥的说明。

自备数据库让你掌握项目、备份和访问权限，不等于端到端加密。使用 Supabase 云服务时，数据由 Supabase 托管；使用 AI 时，所需上下文会发送给你选择的模型服务，配置的执行端也会处理执行任务所需的数据。

需要时再看