SuperAPI AI 工具集

website-building

前端与建站

查看项目

更新于 10-15 21:51

技能介绍

用途:在公司代码仓库中搭建公司官网,由 Cargo 托管并在公司自有域名上响应。每次改动(从错别字到新页面)都经过有人审核的 pull request 后再部署,由编码智能体撰写这些 PR。站点由三部分构成:一个 app(defineApp 上传 infra/apps/website/ 中的 Next.js 包,Cargo 执行构建,将每个页面导出为带独立 URL、标题、描述的 HTML;起始模板含 home、about 页面、robots.txt、sitemap、主题切换以及基于 Tailwind 的 shadcn/ui,文案在 site.json 中);app 上的 hostname(domains: ["www.example.com"];Cargo 自带的 *.app.getcargo.run 为 noindex,公司 www 主机才是搜索引擎索引的对象);一个 domain(Cargo 持有 DNS 时 defineDomain 发布记录并将 apex 转发到 www,否则删除该文件并在其他 DNS 服务商处添加相同记录)。

安装命令:cargo-ai cdk add cookbook/website-building;尚无项目时可用 cargo-ai cdk cdk init <dir> --cookbook website-building && cd <dir> && npm install。随后需与已有声明资源协调(应用或域名被重新接线而非重复;别的技能已声明的域名应合并为同一资源)。流程为:先约定 brief 与设计,选 DNS 路径,改造,再运行 node --import tsx evals/contract.mjs、npm run check && cargo-ai cdk plan,展示 diff,仅在明确同意后执行 cargo-ai cdk deploy。

限制:dnsRecords 会合并进 live zone,但 www CNAME 会接管 www 原有指向,redirectUrl 会替换 apex 转发;hostname 在 _cargo-verify TXT 解析前不提供任何服务,因此部署成功不等于站点已上线。站点始终在 www 而非 apex 提供;app 保持静态导出(output: "export" 与 trailingSlash: true);site.json 的 status 在运营者批准前保持 draft;app 是公开 bundle,不得包含凭据、私有上下文或 .env;app slug 与 domain 改名等于销毁并新建资源。费用方面:每次合并是一次静态应用部署,需先查看工作区当前托管用量;认领已有域名不额外收费,注册新域名会消耗工作区额度且不可退款。具体价格与平台细节资料未提供。