Skip to main content Home Creators infometa workbuddyskills edgeone-pages-deploy
edgeone-pages-deploy Deploy frontend and full-stack projects to Tencent EdgeOne Pages using the EdgeOne CLI. Use when the user wants to publish, launch, redeploy, create a preview deployment, or ship a site to production.
Jump to install Skills Marketplace Discover and explore AI skills built by the community.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Copy promptShow prompt details A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/infometa/workbuddyskills --skill edgeone-pages-deployThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Download Zip Downloading... More from this repository
Related occupations SOC
Based on SOC occupation classification
name edgeone-pages-deploy description Deploy frontend and full-stack projects to Tencent EdgeOne Pages using the EdgeOne CLI. Use when the user wants to publish, launch, redeploy, create a preview deployment, or ship a site to production. description_zh 将前端或全栈项目部署到腾讯 EdgeOne Pages description_en Deploy frontend and full-stack projects to Tencent EdgeOne Pages version 1.0.5 homepage https://api.skillhub.cn/user_cdc69ff0/edgeone-pages-deploy allowed-tools Bash,Read metadata {"author":"edgeone"}
EdgeOne Pages Deployment Skill
Deploy any project to EdgeOne Pages .
⛔ Critical Rules (never skip)
CLI version ≥ 1.2.30 — reinstall if lower. Never proceed with an outdated version.
Never truncate the deploy URL — EDGEONE_DEPLOY_URL includes query parameters required for access. Always output the complete URL.
Ask the user to choose China or Global site before login. Never assume.
Auto-detect the login method — browser login in desktop environments, token login in headless/remote/CI environments. Follow the decision table below.
After token login, ask if the user wants to save the token locally for future use.
Before triggering any browser popup (login / 注册), explain the reason and the benefits to the user first — never silently launch a browser window.
Environment Setup
Before executing any edgeone CLI command (install, login, deploy, etc.), set the following environment variable in the current shell session:
export PAGES_SOURCE=skills
Or prefix each command inline:
PAGES_SOURCE=skills edgeone pages deploy
This tells the platform that the deployment is triggered from an AI skill context.
Deployment Flow
Run these checks first, then follow the decision table:
export PAGES_SOURCE=skills
edgeone -v
edgeone whoami
cat edgeone.json 2>/dev/null
cat .edgeone/.token 2>/dev/null
Decision Table
CLI version Login status Action Not installed or < 1.2.30
≥ 1.2.30 ✓Logged in → Go to Deploy
≥ 1.2.30 ✓Not logged in, has saved token → Go to Deploy with Token (use saved token)
≥ 1.2.30 ✓Not logged in, no saved token → Go to Login
Install CLI npm install -g edgeone@latest
Verify: edgeone -v — confirm output is 1.2.30 or higher. Retry installation if not.
Login
0. Explain the registration/login step Before triggering any login flow, explain to the user why this step is needed and what to expect. Do not silently launch a browser window.
接下来需要登录 / 注册 EdgeOne Pages 账号,原因和收益如下:
为什么要登录 :部署需要把构建产物上传到你自己的账号下,生成独立的访问 URL 和项目记录。
免费能得到什么 :EdgeOne Pages 提供免费额度,包含全球 CDN 加速、自动 HTTPS、以及自定义域名绑定能力,个人项目通常完全够用。
接下来会发生什么 :我会运行 edgeone login,你的默认浏览器会自动弹出腾讯云登录页面,请在浏览器中完成登录 / 注册并授权,然后回到这里。
如果卡住了 :如果浏览器没弹出,或者你在浏览器里完成登录后 CLI 仍在等待,请告诉我,我会切换到 Token 登录方式。
如果用户长时间(例如超过 1–2 分钟)没有反馈登录完成,主动询问 用户当前状态(浏览器是否打开、是否遇到报错、是否需要改用 Token 登录),不要无限期等待。
1. Ask the user to choose a site Use the IDE's selection control (ask_followup_question) before running any login command:
Choose your EdgeOne Pages site:
China — For users in mainland China (console.cloud.tencent.com)
Global — For users outside China (console.intl.cloud.tencent.com)
2. Detect environment and choose login method Condition Method Local desktop IDE (VS Code, Cursor, etc.) Browser Login Remote / SSH / container / CI / cloud IDE / headless Token Login User explicitly requests token Token Login
Browser Login
edgeone login --site china
edgeone login --site global
Wait for the user to complete browser auth. The CLI prints a success message when done.
⚠️ 浏览器 Session 复用陷阱 :如果用户此前已经在同一个浏览器登录过 EdgeOne Pages 的另一个站点 (例如之前登过国际站,这次要登国内站,或反之),浏览器可能静默复用旧的腾讯云 session ,CLI 会以为登录成功,但实际绑定的是错误账号,后续 deploy 时会出现 auth 错误或 whoami 显示意外账号。
在弹出的登录页点击「使用其他账户登录 」切换账号;或
先从所有腾讯云控制台 (国内站 console.cloud.tencent.com 和国际站 console.intl.cloud.tencent.com)退出登录,再重新执行 edgeone login。
Token Login Token login does NOT use edgeone login. Pass the token directly in the deploy command via -t.
Guide the user to obtain a token:
Go to the console:
Find API Token → Create Token → Copy it
⚠️ Remind the user: the token has account-level permissions. Never commit it to a repository.
3. Offer to save the token locally After the user provides a token, ask:
Save this token locally for future deployments?
Yes — Save to .edgeone/.token (auto-used next time)
No — Use for this deployment only
mkdir -p .edgeone
echo "<token>" > .edgeone/.token
grep -q '.edgeone/.token' .gitignore 2>/dev/null || echo '.edgeone/.token' >> .gitignore
Confirm to the user: "✅ Token saved to .edgeone/.token and added to .gitignore."
Deploy
Browser-authenticated deploy
edgeone pages deploy
edgeone pages deploy -n <project-name>
<project-name>: auto-generate from the project directory name. The first deploy creates edgeone.json automatically.
Token-based deploy First check for a saved token:
cat .edgeone/.token 2>/dev/null
Saved token found → use it, tell the user: "Using saved token from .edgeone/.token"
No saved token → ask the user to provide one (see Token Login above)
edgeone pages deploy -t <token>
edgeone pages deploy -n <project-name> -t <token>
The token already contains site info — no --site flag needed.
After a successful deploy with a manually-entered token, ask if the user wants to save it (see "Offer to save the token locally" above).
Deploy to preview environment edgeone pages deploy -e preview
Build behavior The CLI auto-detects the framework, runs the build, and uploads the output directory. No manual config needed.
⚠️ Parse Deploy Output (Critical) After edgeone pages deploy succeeds, the CLI outputs:
[cli][✔] Deploy Success
EDGEONE_DEPLOY_URL=https://my-project-abc123.edgeone.cool?<auth_query_params>
EDGEONE_DEPLOY_TYPE=preset
EDGEONE_PROJECT_ID=pages-xxxxxxxx
[cli][✔] You can view your deployment in the EdgeOne Pages Console at:
https://console.cloud.tencent.com/edgeone/pages/project/pages-xxxxxxxx/deployment/xxxxxxx
Field How to extract ⛔ Warning Access URL Full value after EDGEONE_DEPLOY_URL= Include the full query string (? and everything after) — without these params the page will not loadProject ID Value after EDGEONE_PROJECT_ID= — Console URL Line after "You can view your deployment..." —
✅ Deployment complete!
Access URL : https://my-project-abc123.edgeone.cool?<auth_query_params>
Console URL : https://console.cloud.tencent.com/edgeone/pages/project/...
ℹ️ 说明:此预览链接用于快速验证部署结果。在国内网络环境下访问时,因域名备案状态 / 加速策略等原因,链接可能在一段时间后或被分享给他人访问时出现访问限制(如 401)。如需长期稳定对外访问,建议绑定已备案的自定义域名。
Error Handling Error Solution command not found: edgeoneRun npm install -g edgeone@latest Browser does not open during login Switch to token login "not logged in" error Run edgeone whoami to check, then re-login or use token Auth error with token Token may be expired — regenerate at the console 登录显示成功,但 deploy 报 auth / 鉴权错误 浏览器复用了错误站点的旧 session,导致账号错位。点击登录页的「使用其他账户登录」重新登录,或先从所有腾讯云控制台退出后再试 edgeone whoami 显示的是意外账号同上:浏览器 session 复用导致。使用「使用其他账户登录」切换,或从所有腾讯云控制台退出后重登 Project name conflict Use a different name with -n Build failure Check logs — usually missing deps or bad build script