前言¶

本地改完一版，真正费时间的往往是发布：装 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