القائمة
Guides Vercel deployment and PWA setup for petconnect-app. Use when deploying to Vercel, configuring PWA, adding to home screen, or troubleshooting deployment/auth/AI issues.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
回答 PetConnect 生态任务的设计规范、完成进度时间轴、交付验证。当用户问设计规格、spec、验收标准、进度、时间轴、交付情况、任务状态、认领情况时使用。按统一模板凝练输出，数据来自 tasks/、docs/demand/。
Guides AI agent features in petconnect-app including LLM providers (DeepSeek, Doubao, Gemini), anti-abuse constraints, prompt design, and keyword-based human simulation. Use when adding AI agents, changing LLM providers, adjusting rate limits, or modifying agent prompts.
Analyzes staged and modified files, groups them by feature, and guides batch commits. Use when the user says "提交到Github", "提交到 GitHub", "push to GitHub", or has many staged files from multiple features and wants to commit by feature.
按需开启/关闭 MCP 服务。当用户说"开启 xxx MCP"、"关闭 yyy MCP"、"MCP 太多了"、"管理 MCP"、"禁用 MCP"时触发。
将大型需求拆分为多阶段任务文档并分步交付。当用户说「拆分任务」「分阶段执行」「按需求文档实现」「分部交付」，或提供分析报告要求逐步实现时使用。自动在 docs/demand/<主题>/ 下建立 phases/ 目录，生成带状态标注的阶段文档，每阶段完成后更新状态、提供后续步骤，并询问是否 push。
专业处理 README 与部署文档。Use when writing README, deployment guides, environment variable docs, or project structure documentation. 约定：README 必须包含环境变量表、获取 API Key 的链接、部署步骤、项目结构。
| name | deploy |
| description | Guides Vercel deployment and PWA setup for petconnect-app. Use when deploying to Vercel, configuring PWA, adding to home screen, or troubleshooting deployment/auth/AI issues. |
触发词：部署、Vercel、PWA、发布、上线、vercel 部署、PWA 安装
pet-adoption-app）main| 配置项 | 值 |
|---|---|
| Framework Preset | Vite（自动检测） |
| Build Command | npm run build |
| Output Directory | dist |
| Root Directory | ./ |
项目已有 vercel.json，可覆盖上述配置。
在 Vercel → Settings → Environment Variables 添加：
| Key | 必填 | 说明 |
|---|---|---|
VITE_SUPABASE_URL | 是 | Supabase 项目 URL |
VITE_SUPABASE_ANON_KEY | 是 | Supabase Anon Key |
VITE_LLM_PROVIDER | 否 | deepseek / doubao / gemini，默认 deepseek |
VITE_DOUBAO_API_KEY | doubao 时 | 豆包 API Key |
VITE_DOUBAO_MODEL_ID | doubao 时 | 豆包推理接入点 ID（ep-xxx 或预置模型 ID） |
VITE_DEEPSEEK_API_KEY | deepseek 时 | DeepSeek API Key |
VITE_GEMINI_API_KEY | gemini 时 | Gemini API Key |
注意：环境变量修改后必须 Redeploy 才能生效（Vite 在构建时注入）。
部署完成后，在 Supabase Dashboard → Authentication → URL Configuration：
https://<你的项目>.vercel.app/（如 https://pet-adoption-app-omega.vercel.app/）否则登录/注册后重定向会失败。
项目已集成 vite-plugin-pwa，vite.config.ts 中已配置 VitePWA 插件及 manifest。
图标位于 public/pets/：
| 文件 | 用途 |
|---|---|
pwa-192x192.png | Manifest 小图标 |
pwa-512x512.png | Manifest 主图标 |
favicon.ico | 浏览器标签页 |
apple-touch-icon.png | iOS 主屏幕 |
完整坑点见 reference.md。
| 坑点 | 快速处理 |
|---|---|
| 提交信息乱码 | 提交信息请使用英文；若已乱码，用 git commit -F <文件> 修正，见 github-batch-commits |
| AI 回复失败 | 配置 VITE_LLM_* 环境变量并 Redeploy |
| 注册成功登录失败 | Supabase 邮箱未验证，查 auth.users.email_confirmed_at |
| 登录重定向失败 | Supabase Redirect URLs 添加 Vercel 域名 |
| 环境变量不生效 | 修改后必须 Redeploy |
部署前：
部署后：
调试：
execute_sql 查 auth.users、profiles[PetConnect Doubao] 日志