前言¶

本地改完一版，真正費時間的往往是發佈：裝 CLI、選國內站還是國際站、登錄方式在桌面和 CI 裏不一樣，部署成功後還要從日誌裏摳出帶鑑權參數的訪問地址。若主訴求只是「上線 / 發佈 / 重新部署」，在對話裏反覆口述這些步驟既慢也容易漏。

下面介紹 SkillHub 社區 Skill Edgeone Pages Deploy（座標 @user_cdc69ff0/edgeone-pages-deploy）。它把 EdgeOne Pages（騰訊 EdgeOne 靜態與全棧託管）的部署流程寫進 SKILL.md，讓 Agent 按固定檢查項驅動 edgeone CLI，而不是臨時拼湊命令。

這是什麼¶

Edgeone Pages Deploy 面向「部署、發佈、上線」類主意圖：把前端或全棧項目發佈到 EdgeOne Pages。SkillHub 分類爲 it-ops-security，來源爲社區，發佈者爲 user_cdc69ff0；包內 SKILL.md 的 metadata.author 爲 edgeone。當前 SkillHub 版本爲 1.0.8（SkillHub 頁面與包內 _meta.json 一致）。

與同屬 EdgeOne 體系的 edgeone-pages-dev 分工不同：本 Skill 只在用戶主要想部署時觸發；若部署只是附帶步驟（例如「先寫 API 再部署」），或上線後出現 CORS、500 等運行時問題，應使用 dev 類 Skill 做開發與排障，而不是本部署 Skill。

核心功能¶

依據包內 SKILL.md 與 references/command-reference.md，已覈實能力包括：

1. 環境與版本約束：執行任何 edgeone 命令前設置 PAGES_SOURCE=skills；要求 CLI 版本不低於 1.2.30，否則先 npm install -g edgeone@latest。
2. 登錄路徑：部署前讓用戶選擇 China 或 Global 站點；本地桌面 IDE 走瀏覽器登錄（edgeone login --site china|global），遠程 / SSH / 容器 / CI 等無頭環境走 API Token（-t），並說明勿將 Token 提交到倉庫。
3. 部署命令：已關聯項目（存在 edgeone.json）時 edgeone pages deploy；新項目 edgeone pages deploy -n <project-name>；預覽環境 edgeone pages deploy -e preview；Token 部署 edgeone pages deploy -t <token>。
4. 構建與輸出：CLI 自動識別框架、執行構建並上傳產物目錄；成功後必須從輸出中解析 完整的 EDGEONE_DEPLOY_URL（含 ? 後查詢參數），以及 EDGEONE_PROJECT_ID、控制台鏈接。
5. 輔助能力（引用文檔）：edgeone pages init（Edge/Node Functions）、本地 edgeone pages dev、edgeone pages link、環境變量 edgeone pages env 子命令、本地 Token 存於 .edgeone/.token。

SkillHub 標籤含 requires_api_key=true，與 Token 登錄 / 部署方式一致。

安裝與啓用¶

通過 SkillHub 安裝¶

先確認本機已有 skillhub CLI（安裝方式見 SkillHub 安裝說明）。安裝 Skill 時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 且可能不被識別。

skillhub install @user_cdc69ff0/edgeone-pages-deploy --dir ~/.cursor/skills/

Cursor 常用路徑爲 ~/.cursor/skills/；Claude Code、Codex、Windsurf 等路徑以 SkillHub 安裝文檔中的列表爲準，按你實際使用的客戶端替換 --dir。

也可在對話中讓 Agent 按同一文檔安裝：

請根據 https://skillhub.cn/install/skillhub.md，安裝 @user_cdc69ff0/edgeone-pages-deploy。

部署側前置（由 Skill 引導執行）¶

Skill 不會替代你本機安裝 EdgeOne CLI，但會要求 Agent 在會話中設置來源並校驗版本：

export PAGES_SOURCE=skills
npm install -g edgeone@latest
edgeone -v

輸出需爲 1.2.30 或更高。

典型用法¶

安裝並啓用 Skill 後，用自然語言表達以發佈爲主的意圖即可，例如：「把這個站點部署到 EdgeOne」「發一版 preview」「重新部署」。Agent 應按 Skill 中的決策表依次檢查 CLI、登錄態、edgeone.json 與 .edgeone/.token。

瀏覽器登錄（China 站點示例）：

export PAGES_SOURCE=skills
edgeone login --site china
edgeone pages deploy -n my-app

Token 部署（適合 CI / 遠程環境）：

在控制台 API Token 創建 Token（China：https://console.cloud.tencent.com/edgeone/pages?tab=settings；Global：https://console.intl.cloud.tencent.com/edgeone/pages?tab=settings），然後：

export PAGES_SOURCE=skills
edgeone pages deploy -n my-app -t <token>

預覽環境：

export PAGES_SOURCE=skills
edgeone pages deploy -e preview

部署成功後，Agent 應把 CLI 打印的完整 EDGEONE_DEPLOY_URL 交給用戶，並提示：預覽鏈接受鑑權參數約束，長期公網訪問宜綁定已完成備案的自定義域名（說明見 Skill 原文）。

適用場景與注意¶

適合誰：已在本地或倉庫中有可構建的前端 / 全棧項目，希望由 Agent 統一走完 EdgeOne Pages 安裝 CLI、登錄、部署與結果解析；SkillHub 側下載量約 1529、安裝約 75（以 SkillHub 抓取數據爲準）。

觸發邊界：僅當「部署 / 發佈 / 上線」是主訴求時使用；寫代碼爲主、部署順帶一提，或上線後排錯，應換用 edgeone-pages-dev。

常見坑（Skill 已寫明）：

• 省略 EDGEONE_DEPLOY_URL 的查詢參數會導致頁面無法訪問。
• 瀏覽器登錄若複用了另一站點（China / Global）的舊會話，whoami 或 deploy 可能出現鑑權異常，需換賬號登錄或退出全部騰訊雲控制台後重登。
• Token 具備賬號級權限，保存時 Skill 建議寫入 .edgeone/.token 並加入 .gitignore。

結尾¶

Edgeone Pages Deploy 把 EdgeOne Pages 發佈流程固化成可複用的 Agent 指令：版本與 PAGES_SOURCE、站點選擇、登錄方式、部署命令與 URL 解析都有明確規則，減少對話裏臨時拼 CLI 的遺漏。

官方 Skill 頁：https://www.skillhub.cn/skills/user_cdc69ff0/edgeone-pages-deploy
API / 資源地址：https://api.skillhub.cn/user_cdc69ff0/edgeone-pages-deploy