mcpField
C
catalyst-slate

catalyst-slate

github.com/catalystbyzoho云与 DevOps701.0k 次安装今天更新
代码仓库

关于 catalyst-slate

用于通过 Zoho Catalyst Slate 构建、配置和部署前端应用的技能，强调部署前检查控制台的一次性激活，并涵盖框架设置、跨域函数调用和部署检查。

主要功能

  1. 01部署前检查 Slate 是否已激活
  2. 02指导 Slate 应用脚手架与配置
  3. 03说明跨域函数调用要求
  4. 04涵盖部署与预览 URL
  5. 05指出从 basic client hosting 迁移的问题

适用场景

  1. 01Catalyst 初始化后创建 Slate 应用
  2. 02配置 slate-config.toml 中的框架设置
  3. 03将 Slate 前端连接到 Catalyst 函数
  4. 04排查因未激活导致的部署失败

MCP 相关

该技能使用 `CatalystbyZoho_List_All_Slate_Apps` MCP 工具检查项目的 Slate 激活状态。它没有说明如何向 MCP 工具暴露功能。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-slate

安装后在 Claude Code 中输入/catalyst-slate确认已加载。

附带文件references/slate-basics.md

详细介绍

⚠️ 前置检查 — Slate 激活（每个项目仅需一次）： 执行任何 Slate 命令前，请确认 Slate 已在控制台中激活。 打开 Catalyst 控制台 → 您的项目 → Slate（左侧边栏）→ 点击 Start Exploring。 这一步仅需执行一次。若跳过，即使 slate:create 在本地执行成功，catalyst deploy slate 也会因 HTTP 400 而失败。

工作原理

  1. 检查 Slate 是否已激活 — 使用 MCP：调用 CatalystbyZoho_List_All_Slate_Apps，并传入项目 ID。
    • 如果返回应用或空列表 → Slate 已激活。继续操作。
    • 如果返回 INVALID_URL_PATTERN → Slate 尚未激活。这不是 MCP 错误——这意味着需要在控制台中进行一次性激活。请告诉用户：

      "请打开 Catalyst 控制台，进入您的项目 → Slate（左侧边栏）→ 点击 Start Exploring。这是一项只需 5 秒的一次性操作。完成后告诉我，我会继续。" 等待确认后再继续。

    • 切勿仅因为 Slate 尚未激活就退回使用 Web Client（旧版）。 Web Client 已弃用——Slate 始终是前端托管的正确选择。一次性激活不是改变方案的理由。

    如果在执行 catalyst init 时未选择 Slate，请在 init 后立即运行 catalyst slate:create --name <name> --framework <framework> --default。此命令会更新 catalyst.json 并自动提示输入源目录；它比手动设置更快，也应作为默认建议。

  2. 检查 Slate 应用是否存在 — 如果尚无应用，请运行 catalyst slate:create --name <name> --framework <framework> -ni 创建应用脚手架。如果在执行 catalyst init 时未选择 Slate，请在 init 后立即运行此命令。
  3. 加载 references/slate-basics.md — 了解框架设置、slate-config.toml 格式和 baseUrl 配置。
  4. 跨域调用 — 如果查询涉及从 Slate 应用调用函数，请应用完整 URL + generateAuthToken() + CORS 白名单模式。

    ⚠️ 从基础客户端托管迁移？ 在基础客户端中可用的相对路径（例如 /server/fn/execute）在 Slate 上会悄然失效——Slate 托管在 *.onslate.com，而函数托管在 *.catalystserverless.com。每次函数调用都必须改用绝对 URL。查找并替换所有相对 /server/... 路径，将其改为完整的 https://<project>.catalystserverless.com/server/... URL，并添加 generateAuthToken() 请求头。

  5. 部署 — 部署前，请确认 Slate 已在控制台中激活（控制台 → Slate）。slate:create 会在本地运行，即使未激活也能成功；首次后端调用发生在部署时，如果未激活，就会因 HTTP 400: Please access the Slate service in your project's console before deploying 而失败。确认后，运行 catalyst deploy slate <name> -ni，即可部署到当前环境。构建完成后即可使用预览 URL。

触发条件

以下查询使用此技能："Slate"、"前端托管"、catalyst slate、slate-config.toml、"部署 React 应用"、"Slate 框架"、slate:create、slate deploy、"在 Catalyst 上托管前端"、"Slate 与 Vercel 的比较"、"Slate 跨域调用函数"、"Slate baseUrl"、"在 Catalyst 上使用 Next.js"或"在 Catalyst 上托管静态前端"。

参考资料

参考资料在查询涉及以下内容时加载…
references/slate-basics.md框架设置、slate-config.toml 注意事项、baseUrl 配置、Slate→函数调用的 CORS、Git 部署、CLI 命令

评论

支持 Markdown