makers-deploy
/makers-deploy
Makers 开发专家团部署 Skill — 将前端/全栈项目部署到 EdgeOne Makers。 包含 CLI 安装、登录鉴权、一键部署、JSON 输出解析、URL 铁律。 触发词:部署、发布、上线、发版、deploy、publish、go live、 重新部署、deploy to EdgeOne。 当执行 edgeone makers deploy 命令时必须加载此 skill。
- Author
- darker2016 ↗
- Repository
- workbuddy-skill-groups ↗
- Licence
- MIT
- Last repository change
- 16.08.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 5
No signals detected. Repository changed on 16.08.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Makers 开发专家团部署 Skill — 将前端/全栈项目部署到 EdgeOne Makers。 包含 CLI 安装、登录鉴权、一键部署、JSON 输出解析、URL 铁律。 触发词:部署、发布、上线、发版、deploy、publish、go live、 重新部署、deploy to EdgeOne。 当执行 edgeone makers deploy 命令时必须加载此 skill。
Original author description
Makers 开发专家团部署 Skill — 将前端/全栈项目部署到 EdgeOne Makers。 包含 CLI 安装、登录鉴权、一键部署、JSON 输出解析、URL 铁律。 触发词:部署、发布、上线、发版、deploy、publish、go live、 重新部署、deploy to EdgeOne。 当执行 edgeone makers deploy 命令时必须加载此 skill。
How it works
- ⛔ 铁律(不可跳过)
- 环境准备
- 安装 CLI
- 登录
- 部署命令
- 解析部署输出
- URL 铁律
- 错误处理
SKILL.md preview
---
name: makers-deploy
description: >-
Makers 开发专家团部署 Skill — 将前端/全栈项目部署到 EdgeOne Makers。
包含 CLI 安装、登录鉴权、一键部署、JSON 输出解析、URL 铁律。
触发词:部署、发布、上线、发版、deploy、publish、go live、
重新部署、deploy to EdgeOne。
当执行 edgeone makers deploy 命令时必须加载此 skill。
metadata:
author: edgeone-makers
version: "2.1.0"
---
# EdgeOne Makers 部署 Skill
将任何项目部署到 **EdgeOne Makers**。
## ⛔ 铁律(不可跳过)
1. **CLI 版本 >= `1.6.7`**——低于此版本在非交互环境会卡住
2. **绝不截断部署 URL**——完整 URL 含鉴权查询参数,省略导致 401
3. **非交互环境用 `--json`**——输出单行机器可读 JSON
4. **部署地址必须醒目展示**——放在回复最前面,用大标题 + 代码块
5. **部署前先问站点选择**——China / Global
6. **桌面环境用浏览器登录,无头环境用 Token 登录**
---
## 环境准备
在任何 `edgeone` 命令之前设置:
```bash
export PAGES_SOURCE=skills
```
### 检测步骤
```bash
# 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
```bash
npm install -g edgeone@latest
edgeone -v # 验证 >= 1.6.7
```
## 登录
### 浏览器登录(推荐)
```bash
# 先询问用户选择站点
edgeone login --site china --local # 国内站
edgeone login --site global --local # 国际站
```
### Token 登录(降级方案)
```bash
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/` 目录)
```bash
# 已链接项目
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/` 目录)
```bash
# 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:
```json
{"status":"success","url":"https://xxx.edgeone.cool?eo_token=...","projectId":"pages-xxx","deploymentId":"dp-xxx","consoleUrl":"https://..."}
```
失败时:
```json
{"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` 换一个名字 |
| 项目配额超限 | 到控制台清理不再需要的旧项目 |
Versions
The database has no other skills named makers-deploy.
Database snapshot: 13.11.2026 · package version 4096f16f2684 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 82edgeone-makers-deploy
This skill deploys frontend and full-stack projects to EdgeOne Makers (Tencent EdgeOne). Trigger this skill whenever deployment is part of the task — whether as the primary intent or a secondary step. Examples: "deploy my app", "publish this site", "push this live", "create a… - 95edgeone-makers-cli
EdgeOne Makers CLI command reference. Use when running edgeone CLI commands for dev, build, deploy, env management. - 90edgeone-makers-cli
EdgeOne Makers CLI command reference. Use when running edgeone CLI commands for dev, build, deploy, env management. - 81edgeone-makers-tools
EdgeOne Makers platform development router — the single entry point for building, storing data, and deploying on Tencent EdgeOne Makers. Trigger whenever the user develops, scaffolds, or deploys anything on EdgeOne Makers / EdgeOne Pages: AI agents (DeepAgents, LangGraph,… - 100tencentcloud-edgeone
Manage Tencent Cloud EdgeOne (CDN + edge security). Use when the user asks to: list zones, purge CDN cache (URL / prefix / hostname / all), prefetch URLs to warm edges, check purge / prefetch task status, manage acceleration domains, list / create / delete EdgeOne DNS records,… - 100do-deploy
Deploy popoto: run tests, bump version, tag release, publish to PyPI, deploy docs. Triggered by 'deploy', 'do-deploy', or any request to publish a new version.