SuperAPI AI 工具集

cargo-hosting

通用与其它

查看项目

更新于 10-15 21:51

技能介绍

用途:Cargo Hosting 管理两类工作区级资源及其部署。App 是托管在独立子域名的静态前端,默认 Vite,也识别 Next.js 静态导出、Astro、SvelteKit、Nuxt、Gatsby、Create React App,模板基于 @cargo-ai/app-sdk。Worker 是运行在边缘的 serverless HTTP 处理器,入口为 fetch(request, env),基于 @cargo-ai/worker-sdk,自动生成 /openapi.json 的 OpenAPI 3.1 规格与 /docs 的 Swagger UI。Deployment 是把本地源码目录构建并上传到某个 app 或 worker,只有 promote 之后才正式对外。

用法:先安装 npm install -g @cargo-ai/cli,再 cargo-ai login --email you@company.com(或用 --oauth / --token)并 cargo-ai whoami 确认工作区。生命周期为 init(本地脚手架)→ create(创建槽位与 slug)→ deployment create(构建上传)→ deployment promote(上线)。例如 cargo-ai hosting app init ./my-app --template blank --name "My App"、cargo-ai hosting app create --name "My App" --slug my-app、cargo-ai hosting deployment create --app-uuid <uuid> --source ./my-app、cargo-ai hosting deployment promote --uuid <deploymentUuid>。worker 命令把 app 换成 worker。

主要能力与限制:slug 在工作区内唯一,实际访问地址由 create/get 返回的 url 决定,不要手写;app 与 worker 根域名不同,因此彼此调用属跨域,worker 需处理 CORS。App 的环境变量必须是公开前缀(VITE_、NEXT_PUBLIC_、PUBLIC_、NUXT_PUBLIC_、GATSBY_、REACT_APP_),不能设为 secret,值在构建时写入。部署异步执行,需轮询 deployment get 至终态再 promote。worker 的密钥需另行创建,CARGO_API_TOKEN 不会自动注入;本地开发时 c.env 为空,需在 shell 中导出变量。自定义域名在 CLI 1.0.96 需通过 API 添加,主机名至少三个标签。Cargo 自带域名默认 noindex,需要索引应在构建脚本中预渲染并提供 robots.txt、sitemap.xml。以上以资料所述为准,其他费用与细节暂未提供。