关于 catalyst-appsail
catalyst-appsail 是在 Zoho Catalyst 上部署和运行 AppSail 应用的指导技能,帮助 Agent 选择运行时、遵循配置要求,并区分 AppSail 与 Functions。
主要功能
- 01涵盖托管运行时与 Docker
- 02说明 AppSail 配置和部署
- 03规定 Catalyst 监听端口变量
- 04比较 AppSail 与 Functions
适用场景
- 01部署 Node.js、Java 或 Python 应用
- 02在 Catalyst 托管持久运行的服务器
- 03在 AppSail 与 Functions 间选择
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ catalystbyzoho/ agent-skills --skill catalyst-appsail安装后在 Claude Code 中输入/catalyst-appsail确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/appsail-basics.mdappsail-crossorigin.mdappsail-deploy.md详细介绍
工作原理
-
识别运行时 — 托管运行时(Node.js、Java、Python)或自定义 Docker 容器。
-
加载
references/appsail-basics.md— 查看 PORT 配置、项目结构和 Dockerfile 要求。有关部署命令和环境变量,请加载references/appsail-deploy.md。 -
PORT 规则 — 始终使用
process.env.X_ZOHO_CATALYST_LISTEN_PORT,绝不要将PORT或3000硬编码。 -
AppSail 与 Functions 的选择 — 如果用户不确定该使用哪一个,请参照此对照表:
Catalyst Functions AppSail 代码结构 必须使用 Catalyst 专用模板 任意框架、任意格式,完全独立 使用场景 HTTP 处理程序、事件、定时任务、Zoho 集成 持久化服务、长时间运行的进程、Docker 计费方式 按 API 调用次数计费 按实例运行时间计费 依赖管理 由 Catalyst 处理 由你管理所有库和框架
触发条件
适用于以下情况:"AppSail"、"持久化服务"、"在 Catalyst 上使用 Docker"、"后端托管"、X_ZOHO_CATALYST_LISTEN_PORT、appsail:add、"Catalyst 托管运行时"、"部署 Express 应用"、"AppSail 与 Functions 的对比"、"在 Catalyst 上运行长时间任务的进程"或"在 Catalyst 上运行容器化应用"。
参考资料
| 参考资料 | 在查询涉及以下内容时加载… |
|---|---|
references/appsail-basics.md | 运行时、项目结构、app-config.json 字段、Node.js/Docker 模板、SDK 版本 |
references/appsail-deploy.md | 部署命令(路径 A/B/C)、环境变量、健康检查、AppSail URL 模式、配置 |
references/appsail-crossorigin.md | Slate 与 AppSail 跨域错误、通过 MCP 配置 CORS、catalyst_auth、自定义域名 SSL |
评论
支持 Markdown