edgeone-pages-deploy（edgeone pages 部署）

EdgeOne Pages Deployment Skill

Deploy any project to EdgeOne Pages.

⛔ Critical Rules (MUST follow — never skip)

1. CLI version MUST be 1.2.30 or higher. If the installed version is lower, reinstall. Do NOT proceed with an outdated version.
2. NEVER truncate the deploy URL. The EDGEONE_DEPLOY_URL includes eo_token= and eo_time= query parameters — they are required for access. Always output the complete URL.
3. MUST ask the user to choose China or Global site before login. Never assume.
4. MUST auto-detect the login method — browser login in desktop environments, token login in headless/remote/CI environments. Follow the decision table below.
5. After token login, MUST ask if the user wants to save the token locally for future use.

Deployment Flow

Run these checks first, then follow the decision table:

# Check 1: CLI installed and correct version?
edgeone -v

# Check 2: Already logged in?
edgeone whoami

# Check 3: Project already linked?
cat edgeone.json 2>/dev/null

# Check 4: Saved token exists?
cat .edgeone/.token 2>/dev/null

Decision Table

Install CLI

npm install -g edgeone@latest

Verify: edgeone -v must output 1.2.30 or higher. If not, retry installation.

Login

1. Ask the user to choose a site

You MUST ask before running any login command. Use the IDE's selection control (ask_followup_question):

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

Browser Login

# China site
edgeone login --site china

# Global site
edgeone login --site global

Wait for the user to complete browser auth. The CLI prints a success message when done.

Token Login

Token login does NOT use edgeone login. The token is passed directly in the deploy command via -t.

Guide the user to get a token:

1. Go to the console:

- China: https://console.cloud.tencent.com/edgeone/pages?tab=settings - Global: https://console.intl.cloud.tencent.com/edgeone/pages?tab=settings

1. 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, MUST ask:

Would you like to save this token locally for future deployments? - Yes — Save to .edgeone/.token (auto-used next time) - No — Use for this deployment only

If Yes:

mkdir -p .edgeone
echo "<token>" > .edgeone/.token
grep -q '.edgeone/.token' .gitignore 2>/dev/null || echo '.edgeone/.token' >> .gitignore

Tell the user: "✅ Token saved to .edgeone/.token and added to .gitignore."

Deploy

Browser-authenticated deploy

# Project already linked (edgeone.json exists)
edgeone pages deploy

# New project (no edgeone.json)
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)

# Project already linked
edgeone pages deploy -t <token>

# New project
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 — read carefully)

After edgeone pages deploy succeeds, the CLI outputs:

[cli][✔] Deploy Success
EDGEONE_DEPLOY_URL=https://my-project-abc123.edgeone.cool?eo_token=xxxx&eo_time=yyyy
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

Extraction rules:

Show the user:

✅ Deployment complete! - Access URL: https://my-project-abc123.edgeone.cool?eo_token=xxxx&eo_time=yyyy - Console URL: https://console.cloud.tencent.com/edgeone/pages/project/...

Error Handling

Appendix

Edge/Node Functions

For projects needing server-side functions, run before first deploy:

edgeone pages init

Pure static projects skip this.

Local Development

edgeone pages dev    # http://localhost:8088/

Environment Variables

edgeone pages env ls          # List all
edgeone pages env pull        # Pull to local .env
edgeone pages env add KEY val # Add
edgeone pages env rm KEY      # Remove

Project Linking

edgeone pages link

Token Management

Command Reference