在 Catalyst 上创建/部署 React…

适用于在 Catalyst Slate 上托管 React、Next.js、Vue、Angular、Svelte、Astro、SolidJS、Preact 等前端应用，并需要预览部署或从 Slate 调用 Catalyst Functions 的场景。

适用场景

解决思路

1. 在任何 Slate 命令前，先确认 Catalyst console 中已激活 Slate：打开 Catalyst console → 进入项目 → 左侧栏点击 Slate → 点击 Start Exploring。这是每个项目一次性的步骤；跳过会导致 `catalyst deploy slate` 失败并返回 `HTTP 400`，即使本地 `slate:create` 成功。
2. 使用 MCP 调用 `CatalystbyZoho_List_All_Slate_Apps` 并传入项目 ID，检查 Slate 是否已激活。
3. 如果该调用返回应用列表或空列表，说明 Slate 已激活，继续后续操作。
4. 如果该调用返回 `INVALID_URL_PATTERN`，说明 Slate 尚未激活，这不是 MCP bug，而是需要一次性在 console 激活；告诉用户：请打开 Catalyst console，进入项目 → Slate（左侧栏）→ 点击 Start Exploring，这是 5 秒的一次性步骤，完成后告诉我，我再继续。等待用户确认后再继续。
5. 不要因为 Slate 尚未激活就回退到 Web Client（legacy）；Web Client 已弃用，Slate 始终是前端托管的正确选择，一次性激活不是改变方案的理由。
6. 如果 `catalyst init` 时没有选择 Slate，则在 init 后立即运行 `catalyst slate:create --name <name> --framework <framework> --default`。该命令会更新 `catalyst.json` 并自动提示源目录，比手动设置更快，应作为默认推荐。
7. 检查是否已存在 Slate 应用；如果还没有，则运行 `catalyst slate:create --name <name> --framework <framework> -ni` 来创建脚手架。如果 `catalyst init` 时没有选择 Slate，也应在 init 后立即运行此命令。
8. 当查询涉及框架设置、`slate-config.toml` 格式与坑点、baseUrl 配置、Slate→function 调用的 CORS、Git 部署或 CLI 命令时，加载 `references/slate-basics.md`。
9. 如果查询涉及从 Slate 应用调用 Functions，则应用完整 URL + `generateAuthToken()` + CORS 白名单模式。
10. 从 basic client hosting 迁移时要注意：`/server/fn/execute` 这类相对路径在 basic client 中可用，但在 Slate 上会静默失效，因为 Slate 从 `*.onslate.com` 提供服务，而 Functions 在 `*.catalystserverless.com`。必须把每个函数调用改成绝对 URL：查找并替换所有相对 `/server/...` 路径为完整的 `https://<project>.catalystserverless.com/server/...` URL，并添加 `generateAuthToken()` 请求头。
11. 部署前再次确认 Slate 已在 console 中激活（Console → Slate）。`slate:create` 在本地运行且无需激活也会成功，但首次后端调用发生在部署时，如果未激活会失败并返回 `HTTP 400: Please access the Slate service in your project's console before deploying`。确认已激活后，运行 `catalyst deploy slate <name> -ni` 部署到当前环境；构建完成后即可获得预览 URL。

适用边界 · 注意事项

• 不适用于后端 API 或服务端逻辑；这些场景应改用 `catalyst-appsail` 或 `catalyst-functions`。
• 不要因为 Slate 尚未激活而回退到 Web Client（legacy）；Web Client 已弃用。
• 如果项目未使用 Catalyst/Zoho Slate，则不要使用此技能。