byted-bp-cdn-pagesdeploy — ByteDance 部署 CDN 页面

Pages Deploy Skill 概述 将静态网页代码一键部署到 BytePlus / 火山引擎 Edge Pages 平台。适用于在 Coding Agent（Cursor、Claude Code、Trae 等）中生成静态网页后，快速完成托管、构建和 CDN 接入。

使用场景 Coding Agent 生成了静态网页代码，需要部署上线 需要将本地静态站点部署到全球 CDN 需要为部署的站点绑定自定义域名 需要对已有 Pages 项目进行迭代更新

前置条件 AK/SK 配置：需要 BytePlus / 火山引擎的 Access Key 和 Secret Key Mira 客户端：存储在 secrets/byteplus.json，格式：{"access_key": "xxx", "secret_key": "xxx"} 手动配置：nest config set -g cloud.access_key YOUR_AK && nest config set -g cloud.secret_key YOUR_SK 静态站点目录：包含 index.html 的目录

CLI 命令 完整部署（首次 + 更新自动判断） # 自动判断：项目不存在则创建，已存在则更新部署 bash /path/to/scripts/deploy.sh --name my-site --dir ./dist # 指定描述和加速区域 bash /path/to/scripts/deploy.sh --name my-site --dir ./dist --desc "AI generated site" --region global # 绑定自定义域名 bash /path/to/scripts/deploy.sh --name my-site --dir ./dist --domain www.example.com

参数说明 参数 必填 说明 --name 是 Pages 项目名称 --dir 是 静态站点资源目录（需含 index.html） --desc 否 项目描述 --region 否 加速区域：global / chinese_mainland / outside_chinese_mainland --domain 否 自定义域名 --build-cmd 否 部署前执行的构建命令（如 npm run build） --secrets-file 否 AK/SK 配置文件路径（默认 secrets/byteplus.json）

其他操作 # 查看项目列表 bash /path/to/scripts/manage.sh list # 查看项目详情 bash /path/to/scripts/manage.sh get --pages p-xxx # 查看部署历史 bash /path/to/scripts/manage.sh deployments --pages p-xxx # 本地预览 bash /path/to/scripts/manage.sh serve --dir ./dist --port 8080 # 域名管理 bash /path/to/scripts/manage.sh domain-list --pages p-xxx bash /path/to/scripts/manage.sh domain-add --pages p-xxx --domain www.example.com bash /path/to/scripts/manage.sh domain-verify --pages p-xxx --domain www.example.com # 下线/删除 bash /path/to/scripts/manage.sh offline --pages p-xxx bash /path/to/scripts/manage.sh delete --pages p-xxx

完整工作流 Step 0: 环境准备（一次性）→ 安装 CLI + 配置 AK/SK Step 1: Coding Agent 生成代码 → ./my-site/ Step 2: 本地预览 → nest pages serve ./my-site Step 3: 部署 → deploy.sh --name xxx --dir ./my-site Step 4: 查看域名 → manage.sh get --pages p-xxx Step 5: 绑定域名 → deploy.sh --name xxx --dir ./my-site --domain www.example.com Step 6: 迭代更新 → deploy.sh --name xxx --dir ./my-site Step 7: 管理 → manage.sh list / deployments / offline

注意事项 国内生产环境不提供默认域名，必须绑定自定义域名才能访问 CLI 包名为 @byteplus/nest（非 @byted/nest） 部署后 CDN 生效需 1-5 分钟 自定义域名需到 DNS 服务商添加 CNAME 记录