darker2016 EdgeOne Makers 部署 Skill
将任何项目部署到 EdgeOne Makers。
⛔ 铁律（不可跳过）
- CLI 版本 >=
1.6.7——低于此版本在非交互环境会卡住 - 绝不截断部署 URL——完整 URL 含鉴权查询参数，省略导致 401
- 非交互环境用
--json——输出单行机器可读 JSON - 部署地址必须醒目展示——放在回复最前面，用大标题 + 代码块
- 部署前先问站点选择——China / Global
- 桌面环境用浏览器登录，无头环境用 Token 登录
环境准备
在任何 edgeone 命令之前设置：
export PAGES_SOURCE=skills
检测步骤
# 1. CLI 版本检测
edgeone -v # 必须 >= 1.6.7
# 2. 登录状态检测（CLI >= 1.6.7 会快速失败，不会卡住）
edgeone whoami
# 3. 项目关联检测
cat .edgeone/project.json 2>/dev/null && echo "LINKED" || echo "NOT LINKED"
决策表
| CLI 版本 | 登录状态 | 操作 |
|---|---|---|
| 未安装或 < 1.6.7 | — | → 安装 CLI |
| >= 1.6.7 ✓ | 已登录或 token 存在 | → 部署 |
| >= 1.6.7 ✓ | 未登录，桌面环境 | → 浏览器登录 |
| >= 1.6.7 ✓ | 未登录，无头环境 | → 让用户提供 token |
安装 CLI
npm install -g edgeone@latest
edgeone -v # 验证 >= 1.6.7
登录
浏览器登录（推荐）
# 先询问用户选择站点
edgeone login --site china --local # 国内站
edgeone login --site global --local # 国际站
Token 登录（降级方案）
edgeone login --token <token> --local
Token 获取方式：
- 国内站：https://console.cloud.tencent.com/edgeone/pages?tab=settings
- 国际站：https://console.intl.cloud.tencent.com/edgeone/pages?tab=settings
部署命令
Web 项目（无 agents/ 目录）
# 已链接项目
edgeone makers deploy -t <token> --json
# 新项目
edgeone makers deploy -n <project-name> -t <token> --json
# 预览环境
edgeone makers deploy -n <project-name> -t <token> --json -e preview
Agent 项目（有 agents/ 目录）
# edgeone makers deploy 自动执行 build + 部署
edgeone makers deploy -n <project-name> -t <token> --json
# 预览环境
edgeone makers deploy -n <project-name> -t <token> --json -e preview
部署命令必须前台同步执行（不加 run_in_background）。部署通常 1-3 分钟。
解析部署输出
成功时 stdout 最后一行是 JSON：
{"status":"success","url":"https://xxx.edgeone.cool?eo_token=...","projectId":"pages-xxx","deploymentId":"dp-xxx","consoleUrl":"https://..."}
失败时：
{"status":"error","error":"<message>"}
URL 铁律
🌐 线上地址：https://xxx.edgeone.cool?eo_token=xxx&eo_time=xxx
- 绝不截断 URL 的查询参数（
eo_token、eo_time） - 告知用户该 URL 含时效性鉴权参数，分享链接可能失效
- 如需长期公开访问，请在控制台绑定自定义域名
错误处理
| 错误 | 解决方案 |
|---|---|
command not found: edgeone |
npm install -g edgeone@latest |
| CLI 版本 < 1.6.7 | 重新安装 npm install -g edgeone@latest |
| 浏览器无法打开 | 切换到 token 登录 |
| "not authenticated" | 运行登录或提供 token |
| 部署卡在 "Deploying..." | CLI >= 1.6.7 非 TTY 会发心跳，未卡住；用 --json |
| Token 认证错误 | Token 可能过期，去控制台重新生成 |
| 项目名冲突 | 用 -n 换一个名字 |
| 项目配额超限 | 到控制台清理不再需要的旧项目 |