EdgeOne 第一周体验报告

作者:sowawu · 导师:haoweichen · 交付日期:2026-05-15 · 版本:v1.0 终稿

01 优化建议

即使在传统控制台流程内,比起翻文档解决问题,我更倾向于直接问 Agent
—— 本周亲跑控制台后的真实感受

经过本周对 EdgeOne Pages、Tunnel、Skill+AI、传统控制台四条路径的亲跑体验,建议优化如下(详细复现路径与证据见 02 章):

#问题建议动作P 级
1tunneleo 输出预期与用户预期不符根据不同场景在官网定义不同的 prompt——目前官网的 prompt 无法覆盖所有场景P0
2SKILL.md 缺「最终视图」每条命令增加 "What you will see" + "Common Agent misuse"P0
3Agent 越界推荐竞品(Skill 失败时无兜底)Skill 里需写明兜底策略——完成不了的任务首先推荐用户回控制台操作P0
4EO 文档站缺乏对 Agent 友好的结构化入口(来自 04 章 GEO)EO 文档根目录发布 llms.txt + 结构化错误码 JSON 字典——这是 GEO「可发现 / 可验证」的最小起点,也是让 Agent 在调用时拿到准确入口、而不是依赖训练时的旧语料P0
5Pages 子目录假成功自动扫描子目录主动弹 toast;构建产物必须包含关键文件才算成功P1
6EO Skill 的 description 与 Skill 里包含的能力不符——经了解是因为 EO Skill 与 EO Pages Skill 是两个团队各自做的要么两个团队的 Skill 合作合并;要么 EO Skill 里把 Pages 相关内容删除(保持描述与实现一致)P1
7传统控制台流程对小白门槛高——「添加站点 → 加速域名 → 源站 → DNS/CNAME → HTTPS → 缓存 → 安全防护」每一步都是专业概念,让用户自己判断"源站类型"和"接入方式"控制台首页提供按用户目标的 5 类场景化路径模板:①我有 GitHub 静态项目 ②我有 COS 静态网站 ③我有 CVM 后端服务 ④我有本地服务想临时暴露 ⑤我已有线上域名想接入加速。这套模板同时写入 llms.txt,让 Agent 也能命中(与 04 章 GEO 联动)P1

02 部署路径对照实验(第一手实验记录)

本章是 01 / 03 / 04 / 05 章所有结论的证据底座。所有截图来自本周亲跑过程,未做任何美化处理。

2.1 实验设置

2.2 对照表

维度Pages(控制台)TunnelSkill + AI传统控制台流程
拿到可预览 URL 总耗时~10 分钟~5 分钟未拿到取决于源站准备进度
让 URL 真正可分享自定义域名 ≈ 20 分钟 + 部分区还要工信部备案关电脑即失效(Tunnel 定位决定)需备案 + DNS/CNAME + HTTPS
操作步数8 步(含错部署一次后重配)4 步多轮对话未完成7 步(站点→域名→源站→DNS→HTTPS→缓存→安全)
切出查文档次数3(输出目录 / 加速区差异 / 备案要求)2(serve vs port / install 失败)5+几乎每步都查(小白视角)
报错/误判次数1 次「假成功」(部署成功但页面打不开)1 次「形态错位」(拿到 URL 但是文件浏览器不是网页)2 次(卡死 + 被推荐竞品)0 次报错,但卡在"选源站类型 / 接入方式"
主观挫败感(1–5)1352(流程通,概念门槛高)
适合的用户画像已有域名 + 知道加速区差异的前端开发者临时 demo / 本地调试场景SRE / 已有源站的运维已懂 CDN/DNS 的运维或全栈

2.3 每条路径的「小白时刻」

路径 A · EO Pages

卡点 #1 · Git 仓库默认搜根目录,子目录里的 HTML 静默不显示("假成功")

EdgeOne Pages 404 NOT_FOUND
证据 1.1 · 部署成功后访问得到 404 NOT_FOUND——「假成功」最直观的截图
构建设置:根目录默认为 ./
证据 1.2 · 构建设置中"根目录"默认为 ./,没有任何提示告诉用户「如果代码在子目录里,这里要改」

卡点 #2 · 加速区"三选一"在部署前只有后续自定义域名需要 ICP 备案介绍,默认选项国内访问不通

加速区合规说明气泡
证据 2.1 · 加速区合规说明在部署完成后才在域名管理页弹出——「3 小时预览有效期 / 中国大陆区返回 401」这种关键约束本应在选择那一刻就告知
EdgeOne Pages 401 UNAUTHORIZED
证据 2.2 · 国内朋友访问时返回 401 UNAUTHORIZED——这是加速区前置告知缺失的最终结果
需和导师同步的疑点:做二次实验的时候,三个区都可以把预览转发给国内朋友打开——不理解是否为 bug。

路径 B · EO Tunnel

卡点 #1 · 按官网步骤,URL 打开是文件浏览器不是网站

Tunnel 官网:让 AI Agent 自行完成部署
证据 3.1 · Tunnel 官网推荐路径:"对 AI 说一句话,它帮你安装 tunneleo、启动服务、生成链接,全程无需手动操作"——但实际跑出来的并不是用户期待的"网站上线"

根因简述:tunneleo 提供 serve(文件分享)和 port(端口转发)两种语义不同的能力,但 SKILL.md 把它们并列写在一起、没有显式区分。Agent 默认匹配最显眼的 serve 例子,于是「上线网站」的意图被翻译成了「文件浏览器」。

tunneleo 跑出来的 All files 文件浏览器
证据 3.2 · 实际拿到的:tunneleo 自带的「All files」文件浏览器界面
期望的作品集主页
证据 3.3 · 期望的:作品集主页直接打开
✓ 正确做法(亲跑验证可行)
cd /path/to/portfolio          # 1. 进入作品集目录
python3 -m http.server 8080    # 2. 起一个标准静态服务器(根路径自动指向 index.html)
tunneleo port 8080             # 3. 把这个本地服务暴露成内网 URL

浏览器打开拿到的 URL → 直接进入作品集首页 → 项目卡片正常跳转 → 图片资源全部正常加载。

体感:一脸懵。我做了文档让我做的事,结果跟我期待的不一样——卡点不在动作执行层,而在「动作 → 最终视图」这一段缺失的预期管理。对应建议见 01 章 #1(官网 prompt 区分场景)和 #2(SKILL.md 加最终视图)。

路径 C · Skill + AI

点评:这是一份给已经在云上有域名 + 有源站的运维人员用的「接入加速 / 安全运营 / 看日志」工具包,而不是给开发者把本地项目部署上线的工具包。

SKILL.md 的「自我描述」与「实际内容」出现明显错位(这也是后面卡点的最大原因)。
skills/tencent-edgeone-skill/SKILL.md 的 frontmatter 原文:
description: A comprehensive skill for Tencent EdgeOne ... covering edge acceleration
  (DNS, certificates, caching, rule engine, L4 proxy, load balancing), edge security
  (DDoS protection, Web protection, Bot management), edge media (real-time video /
  image processing), edge development (Edge Functions, EdgeOne Pages), and more.
description 白纸黑字写了 Edge Functions, EdgeOne Pages,但 references/ 目录下只有 4 个模块:
references/
├── acceleration/   ← 只有 cache-purge / cert-manager / zone-onboarding
├── api/
├── observability/
└── security/
没有 pages/ 目录、没有 edge-functions/ 目录、没有 deploy/ 目录、没有 framework/ 目录。
这是优化建议中所有问题里证据最硬、影响面最大的一条——SKILL 在描述层「承诺」了 Pages 和 Edge Functions,在实现层完全没交付。

卡点 #1 · 本地 deploy_folder 卡死

卡点 #2 · CodeBuddy 最终推荐了竞品产品

CodeBuddy 推荐 GitHub Pages / Vercel / Netlify
证据 4 · CodeBuddy 在 Pages 部署失败后明文建议「使用 GitHub Pages 部署(免费)」「或使用 Vercel/Netlify 等平台一键部署」(红框处)——这是越过产品红线的直接证据
整体体感:流畅的开场 → 卡顿的中段 → 自我怀疑 → 失望 → 转向竞品。所有的体验崩点都在最后 30%。
对应建议见 01 章 #3(兜底策略)和 #6(两个团队 Skill 合并)。

路径 D · 传统控制台流程(站点接入加速)

实验设置差异:路径 A/B/C 都是「我有一份本地代码想上线」场景;路径 D 是另一个场景——「我已有源站/域名,想接入 EO 加速」。两个场景互补,本周后期补做。

卡点 · 流程完整,但每一步都是专业概念,小白难以自驱

关键洞察
  • 这条路径反证了一个判断:「前置告知缺失」不是 Agent 时代独有的问题——即使在传统控制台流程里,小白用户同样需要按目标的路径模板。Agent 时代之所以让这个问题显形,是因为 Agent 替用户做选择时这些"选择题"全部裸露出来
  • 所以解法不是"为 Agent 单做一套引导",而是同一套场景模板既写进控制台、又写进 llms.txt——人类用户和 Agent 同时受益(与 04 章 GEO「可理解 / 可发现」联动)
  • 用户的真实声音:即使我已经在控制台流程里了,比起翻文档解决问题,我也更倾向于直接问 Agent。这正是产品组该警觉的信号——文档投入再大,用户已经不去那里找答案了

建议的 5 类场景化路径模板(已上 01 章 #7):

  1. 我有 GitHub 静态项目 → 推荐 EdgeOne Pages
  2. 我有 COS 静态网站 → 推荐源站接 COS + 加速域名
  3. 我有 CVM 后端服务 → 推荐源站接 CVM + 配置 HTTPS/缓存
  4. 我有本地服务想临时暴露 → 推荐 Tunnel
  5. 我已有线上域名想接入加速 → 推荐站点接入 + DNS/CNAME 一步到位

2.4 阶段性总结

03 Agent 时代的 B 端 user journey 重构

传统旅程 → Agent 旅程 → 新设计重点;以及风险等级四档分层接管
图 · 从「用户逐步操作」到「用户表达目标 + Agent 拆解执行」——新设计重点是控制权如何下放、风险节点如何收回

3.1 观察到的变化

Agent 让 B 端用户旅程从「用户逐步操作产品」变成「用户表达目标,Agent 代为拆解和执行」。

3.2 暴露的问题

控制权下放后,用户不再只关心 Agent 能不能完成任务,还会关心:

3.3 对应的产品解法

B 端 Agent 不应默认全自动,而应设计分层接管机制

风险等级Agent 接管方式产品设计要求
低风险自动执行执行后留痕
状态变更用户确认后执行展示操作计划和影响范围
高风险强确认后执行展示风险、权限、成本和回滚方案
不可逆 / 敏感操作禁止自动执行只允许建议、模拟或生成草稿

3.4 结论

B 端 Agent 产品的关键,不是简单缩短用户路径,而是设计一套「可下放、可确认、可收回」的控制权机制。

EdgeOne Skill 基本遵循「可控委托」原则:低风险查询和分析可自动执行,涉及状态变更和高风险操作时要求用户确认;但仍可在统一风险分级、回滚提示和审计追踪上进一步增强。

04 如何让 Agent 们更好地发现或推荐 EO(本质 GEO)

让 Agent 推荐 EO,不是让它"看见广告",而是让它在解决用户任务时,能判断 EO 是一个可信、适合、可执行的选项。
GEO 五件事框架图:可发现 / 可理解 / 可比较 → Agent 判断 → 可验证 / 可调用 → 被推荐
图 · 让 Agent 发现并推荐 EO 的五件事——可发现 / 可理解 / 可比较 → Agent 判断 → 可验证 / 可调用 → 被推荐

具体做 5 件事 + EO 当前现状对照

维度EO 应该做的EO 当前现状
可发现llms.txt / llms-full.txt / sitemap / Markdown 版本,让 Agent 抓到干净结构化内容❌ 暂无
可理解不要只写"边缘安全、全球加速",要写清楚"什么场景用什么工具"⚠️ 当前更多是"边缘安全 / 全球加速"这类宏大叙事
可比较主动提供 EO vs Vercel / Cloudflare / Netlify 的差异页,让 Agent 知道什么时候该推荐 EO❌ 暂无
可验证放真实案例、数据、限制条件、FAQ 排障,减少 AI 幻觉⚠️ 部分已有,但分散在帮助中心多层目录
可调用把 CLI、MCP、SDK、API 示例写成 Agent 可直接执行的步骤✅ 三类能力齐备(CLI/MCP/SDK),但 SKILL.md 未引入开发者侧 CLI

5 件事中"可发现 / 可验证"的最小起点已沉淀为 01 章 #4(llms.txt + 错误码字典);"可理解"的场景化表达已沉淀为 01 章 #7(5 类路径模板)。

05 友商对比

5.1 友商进展(截至 2026-05-13)

友商关键产品Agent 接入姿势对 EO 的判断
CloudflareWorkers + Pages + Agents SDK + AI Gateway + 官方 MCPwrangler + Agents SDK + 官方 MCP(Code Mode,2500 endpoints/1k tokens)Agent 时代最激进的对标;EO 在三类接入能力上已与之对齐(详见下方"EO 现状"),主要差距是覆盖面与组织方式——Cloudflare 用一份 MCP 覆盖全部 2500 个 API,EO 的 CLI/MCP 当前主要面向 Pages 场景
VercelVercel + v0 + AI SDKvercel deploy + v0 + AI SDK「AI 辅助开发→部署」闭环做深,与 Pages 直接对标
NetlifyNetlify + AI Functions + Codex Pluginnetlify CLI + 官方 MCP + Deploy from Codex(2026-03-27)2026 Q1 把 Agent 接入做扎实,对 EO 是直接威胁
FastlyCompute@Edgefastly CLI工程师向,小白门槛高
AkamaiEdgeWorkers有 CLI 但 Agent 叙事几乎没有最传统、最企业向
阿里云ENS / CDN / DCDN通义 + 一体化云「AI 一体化云」路线
火山引擎CDN / 边缘计算豆包 + 一体化同阿里路线
EO 现状(事实陈述):EdgeOne 已具备 CLI、MCP 和 SDK 三类开发者接入能力—— 对照本周亲跑的结果:能力齐备 ≠ Agent 能用上——路径 C 的卡点根源不在"EO 缺 CLI",而在 tencent-edgeone-skill 的 SKILL.md 当前 100% 围绕 tccli(运维侧)展开,没有把面向 Pages 的开发者侧 CLI 与 MCP 引入到 Skill 的 references/ 里,导致 Agent 在调用时拿不到正确入口。这是"已有能力 vs 已被 Agent 用上"之间的最后一公里

5.2 EO 差异化机会

  1. 把 Skill 范式做深做厚——海外没人走完(Cloudflare 选了 MCP、Vercel 选了 v0),是真正的窗口

结语

这份报告的所有判断都来自一周内对四条路径的亲跑,不来自二手资料;所有建议都从这些路径的具体卡点抽离而来,不来自抽象推演。

附录

A. 友商资料原始引用

来源标题链接
Cloudflare BlogCode Mode: give agents an entire API in 1,000 tokens链接
Cloudflare DocsBuild a Remote MCP server链接
Vercel BlogIntroducing the new v0链接
Vercel KBHow to build AI Agents with Vercel and the AI SDK链接
Netlify ChangelogDeploy from Codex with the Netlify Plugin链接
ChatForestNetlify MCP Server Review链接

B. 写作纪律自审

  1. ✅ 每个观点后挂证据:截图 / 数据 / 链接
  2. ✅ 措辞禁用清单(「我感觉/可能/也许/应该会/大概率」)已全部清理
  3. ✅ 倒金字塔:每段第一句话能独立成立

C. 旁路项目:CDN 行业洞察 Agent