从零到一:用 Agent Skill 一键发布网页到华为云开发者作品展览馆

举报
yd_224380536 发表于 2026/10/21 11:21:37 2026/10/21
【摘要】 从零到一:用 Agent Skill 一键发布网页到华为云开发者作品展览馆本文记录了一次完整的实战体验:借助华为云 Agent Skill 编排能力,从 CodeArts ACP 生成网页代码,到 DevBridge 隧道暴露公网访问,再到 GitCode 仓库托管,最终一键投递到华为云开发者作品展览馆——全程仅需一次浏览器 OAuth 授权。 背景华为云开发者作品展览馆(Gallery)...

从零到一:用 Agent Skill 一键发布网页到华为云开发者作品展览馆

本文记录了一次完整的实战体验:借助华为云 Agent Skill 编排能力,从 CodeArts ACP 生成网页代码,到 DevBridge 隧道暴露公网访问,再到 GitCode 仓库托管,最终一键投递到华为云开发者作品展览馆——全程仅需一次浏览器 OAuth 授权。

背景

华为云开发者作品展览馆(Gallery)是面向开发者的作品展示与投递平台,支持闯关活动、高校公开课、开发者大赛等多种活动。传统流程下,要把一个作品发布到展览馆,需要手动完成:生成代码、本地测试、创建仓库、推送代码、截图制封面、写简介详情、选择活动、提交发布——步骤繁多且容易出错。

而 huawei-cloud-gallery-publish 这个 Agent Skill 把整条链路封装成了自动化流程,AI 全程执行,仅在 GitCode OAuth 授权时需要人工介入一次。

整体架构

CodeArts ACP (生成网页)  →  Python HTTP Server (本地服务)
        ↓                          ↓
  沙箱文件系统              DevBridge 隧道 (公网暴露)
        ↓                          ↓
  /proc/<pid>/cwd/ 拷贝     GitCode 仓库 (代码托管)
                                   ↓
                          hcloud STS (临时凭证)
                                   ↓
                    Gallery API (投递到展览馆)

前置依赖

这套流程依赖以下组件,均在华为云 DevSpace 作业环境中预装:

依赖 用途
huawei-cloud-ext-coding skill CodeArts ACP 代码生成,监听 127.0.0.1:19300
huawei-cloud-publish-work-to-gallery skill 发布脚本集(封面生成、详情打包、API 调用等)
huawei-cloud-jobenv-devbridge-tunnel skill DevBridge 开发隧道管理
hcloud CLI 华为云命令行工具,用于 STS 凭证生成
codearts jobenv CodeArts 沙箱环境,提供隔离的代码生成空间

实战全过程

阶段一:CodeArts ACP 生成网页

首先通过 ACP 健康检查确认 CodeArts 服务可用:

curl -s --max-time 3 http://127.0.0.1:19300/healthz
# → ok

然后从 registry.json 读取 CodeArts 沙箱工作目录,在其下创建 simple-webpage 子目录,建立 acpx session,发送 prompt:

Create a single file index.html: centered title "Hello World",
welcome paragraph, light background (#f0f4f8), CSS flexbox centering.
Then start python3 -m http.server 8000 --bind 0.0.0.0.

CodeArts 在沙箱内生成 index.html 并启动 HTTP 服务器。轮询日志约 60 秒后检测到 [done],验证 http://127.0.0.1:8000 返回 200。

关键技术点:沙箱运行在 bwrap mount namespace 内,外层 ls 看不到沙箱文件。必须通过 http.server 进程的 /proc/<pid>/cwd/ 路径访问:

HTTP_PID=$(pgrep -f "http.server 8000" | head -1)
cp /proc/$HTTP_PID/cwd/index.html /root/workspace/simple-webpage/index.html

阶段二:DevBridge 隧道暴露公网

DevBridge 是华为云开发隧道服务,通过出站连接将本地端口安全暴露到公网,无需开放入站端口。

source devbridge_cmd.sh
db_init                              # 确保沙箱运行
db_auth_status                       # 认证检查
TUNNEL_ID=$(db_create "simple-webpage-tunnel" "开发隧道" 72)
db_port_create "$TUNNEL_ID" 8000 auto true   # 端口 + 匿名访问
PID=$(db_host "$TUNNEL_ID")                   # 启动托管
TUNNEL_URL=$(db_tunnel_url "$TUNNEL_ID")      # 获取公网 URL

最终得到公网 URL:https://xhba4xw6-8000.devbridge-s2.hwtunnel.com

注意:中继域名随集群变化,严禁按文档拼接 URL,必须用 db_tunnel_url 从 host 进程 logs 权威读取。

阶段三:GitCode 仓库托管

Git 初始化

在 git init 之前先写 .gitignore,排除 STS 凭证文件:

printf 'sts-creds.json\nsts-creds.sh\n' > .gitignore
git init -b main
git add -A
git -c user.email=agent@local -c user.name=agent commit -m "Initial commit"

GitCode OAuth 授权

这是全流程唯一需要人工介入的环节。脚本启动 OAuth 服务并生成登录链接:

登录链接: https://acs.atomgit.com/s/87124c1e

用户在浏览器中打开链接完成授权后,token 自动保存到 ~/.gitcode/auth.toml。

创建仓库并推送

# GitCode API 使用 private_token query param(不是 Authorization header)
TOK=$(grep 'access_token' ~/.gitcode/auth.toml | ...)
LOGIN=$(curl -sf "https://gitcode.com/api/v5/user?private_token=$TOK" | ...)

# 创建仓库
curl -X POST "https://gitcode.com/api/v5/user/repos?private_token=$TOK" \
  -d '{"name":"simple-webpage","private":false}'

# 推送(带 token 的 URL,推送后清除 token)
git remote add origin "https://${LOGIN}:${TOK}@gitcode.com/${LOGIN}/simple-webpage.git"
git push -u origin main
git remote set-url origin "https://gitcode.com/${LOGIN}/simple-webpage.git"

阶段四:STS 临时凭证

Gallery API 需要华为云 STS 临时凭证认证。流程使用 SELF_VERIFY 自委托(trust domain = 自己的 domain)通过 AssumeAgency 获取最小权限临时凭证:

# 首次需要创建 SELF_VERIFY 自委托
hcloud IAM CreateAgency --cli-region=cn-north-4 \
  --agency.name=SELF_VERIFY \
  --agency.domain_id=<domainID> \
  --agency.trust_domain_id=<domainID> \
  --agency.duration=FOREVER

# 生成 STS 凭证(900s 有效期)
python3 gen_sts.py --account <domainID> --hcloud /usr/local/bin/hcloud \
  --creds-out ./sts-creds.json --sh-out ./sts-creds.sh

重要:STS 凭证有效期仅 900 秒,全流程可能超过这个时间。发布前必须刷新 STS,否则会收到 401 错误。

阶段五:封面与详情

封面图生成

build-cover.mjs 对本地网页截图生成 16:9 封面图,verify-glyphs.py 做像素级中文字形校验,确保不乱码:

node build-cover.mjs --url http://127.0.0.1:8000 \
  --title "Simple Webpage" --tagline "极简Hello World网页" \
  --description "单文件居中布局,浅色背景" \
  --out /tmp/cover.png --quiet
python3 verify-glyphs.py /tmp/cover.png --quiet

简介撰写

简介有字数限制(15~50 字符),直接写 29 字符短版一次通过:

极简Hello World网页,单文件居中布局,浅色背景。

详情包

详情包含架构图(HTML → PNG)+ 500-1500 字 README + 资源文件,打包为 zip:

python3 generate_diagram.py --html /tmp/diagram.html --out /tmp/diagram.png --width 1280
node build-detail-zip.mjs --readme detail-readme.md --resources resources/ --out /tmp/detail.zip

阶段六:投递到展览馆

选择活动

查询当前可投稿活动列表(startsAt ≤ 今天 ≤ endsAt 且 status=published):

node api.mjs GET /v1/gallery/camps --creds-file ./sts-creds.json

返回 45 个活动,默认推荐「闯关活动」。

发布

发布前刷新 STS → 门禁检查 → 构建参数 → 提交:

# 刷新 STS(防过期)
python3 gen_sts.py --account <domainID> ...

# 门禁检查
node check-gates.mjs --cover /tmp/cover.png --detail /tmp/detail.zip --strict

# 发布
node publish-work.mjs /tmp/publish-params.json --max-age 3600
# → #status=201
# → workUrl=https://gallery.developer.huaweicloud.cn/gallery/00686f7cdb800000
# → reward=success value=200

踩坑总结

  1. STS 凭证过期:900 秒有效期容易被全流程超掉,发布前必须刷新。第一次发布时就因为流程耗时超过 900s 导致 401。
  2. SELF_VERIFY 委托不存在:新账号没有预置这个自委托,需要先通过 IAM CreateAgency 创建。
  3. 沙箱文件隔离:bwrap mount namespace 导致外层看不到沙箱文件,必须用 /proc/<pid>/cwd/ 访问。
  4. GitCode API 认证方式:使用 private_token query param,不是 Authorization header;token 字段名是 access_token 不是 token。
  5. DevBridge 域名不可拼接:中继域名随集群变化,必须用 db_tunnel_url 权威读取。
  6. .gitignore 时机:必须在 git init 之前写好,排除 STS 凭证文件,否则凭证会被提交到仓库。
  7. 详情包图片引用:README 中的图片路径必须指向 resources/ 目录内的实际文件,否则校验不通过。

总结

这次实战展示了华为云 Agent Skill 的编排能力:把 CodeArts ACP(代码生成)、DevBridge(隧道暴露)、GitCode(仓库托管)、hcloud STS(临时凭证)、Gallery API(作品投递)五个独立服务串成一条全自动链路。

整个过程从启动到发布完成约 15 分钟,其中大部分时间在等待 CodeArts 生成代码和 preflight 字体准备。人工介入仅一次——GitCode OAuth 授权扫码。

对于开发者而言,这意味着可以把重复的发布流程交给 AI 自动执行,自己只需关注作品本身的质量。华为云的开发者工具链正在朝着"声明意图 → 自动执行"的方向演进,Agent Skill 就是这一理念的体现。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。