Pages Deploy Skill

Overview

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

使用场景

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

前置条件

1. 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
2. 静态站点目录：包含 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

参数说明

其他操作

# 查看项目列表
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 记录