This page mirrors the contents of README_ADDENDUM.md.
# aiagent.3000dollar.com AI 智能体任务说明书 ## 1. 任务背景 这是一个已完成云端基础设施（GitHub, Vercel, Supabase）初始化的全栈项目。 三者已经完成自动绑定： - GitHub 仓库：https://github.com/ychocm-stack/aiagent.3000dollar.com - Vercel 控制台：https://vercel.com/dashboard/aiagent.3000dollar.com - Supabase 控制台：https://supabase.com/dashboard/project/pqlmaqyotkpjhzxaicws - Supabase Project Ref：`pqlmaqyotkpjhzxaicws` - 数据库表前缀：`aiagent_3000dollar_com` - Supabase 模式：复用现有 Supabase 项目 **关键凭证信息（仅限本地开发验证使用）：** - `VITE_SUPABASE_URL`: `<请在导出的交接文档中查看，或前往 Supabase 控制台获取>` - `VITE_SUPABASE_ANON_KEY`: `<请在导出的交接文档中查看，或前往 Supabase 控制台获取>` 注意：Vercel 已经自动关联了 GitHub 仓库（提交代码自动部署），并且已经在云端环境中注入了 `VITE_SUPABASE_URL` 和 `VITE_SUPABASE_ANON_KEY` 环境变量。 ## 2. 探查指令指南 作为接手该项目的 AI，在开始正式编写业务代码前，请必须先通过调用终端命令执行以下信息探查与连通性验证： ### 2.1 探查项目结构与依赖 请执行命令（如 `ls -la`, `cat package.json`, `cat vite.config.ts` 等）查看当前仓库的代码工程结构。 - 确认项目使用的前端框架和构建工具。 - 确认是否已安装 Supabase 客户端依赖（如 `@supabase/supabase-js`），若未安装请先指导用户或直接执行安装命令。 ### 2.2 配置本地环境变量 - 请将上方提供的 `VITE_SUPABASE_URL` 和 `VITE_SUPABASE_ANON_KEY` 写入到项目根目录的本地环境变量文件（如 `.env` 或 `.env.local`）中，以便本地开发和测试代码能够连接到数据库。 ### 2.3 验证 Supabase 数据库连通性 请编写一段最小化的测试代码（例如在项目入口文件中，或单独的 Node 脚本中）： 1. 使用环境变量初始化 Supabase 客户端。 2. 尝试对 `public.aiagent_3000dollar_com_messages` 表执行简单的 `select` 查询。 3. 执行该代码并观察输出，如果能成功获取数据（即使是空数组），则证明数据库连通性正常。 ### 2.4 验证 Vercel 与 GitHub 关联情况 - 如果环境中安装了 Vercel CLI，你可以尝试运行 `vercel env pull` 来拉取云端变量进行核对。 - 或者你可以运行 git 相关的命令检查当前 remote 是否配置正确，并可以通过推送一个空提交来验证 CI/CD 流程是否被正常触发。 只有在完全确认项目工程结构、环境变量已就绪、数据库读写连通性正常后，你才可以进入正式业务需求的开发。 后续新增的数据库表，请务必遵守 `aiagent_3000dollar_com_` 的前缀命名规范。