从零到一:用 Agent Skill 一键发布网页到华为云开发者作品展览馆
从零到一:用 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
踩坑总结
- STS 凭证过期:900 秒有效期容易被全流程超掉,发布前必须刷新。第一次发布时就因为流程耗时超过 900s 导致 401。
- SELF_VERIFY 委托不存在:新账号没有预置这个自委托,需要先通过
IAM CreateAgency创建。 - 沙箱文件隔离:bwrap mount namespace 导致外层看不到沙箱文件,必须用
/proc/<pid>/cwd/访问。 - GitCode API 认证方式:使用
private_tokenquery param,不是Authorizationheader;token 字段名是access_token不是token。 - DevBridge 域名不可拼接:中继域名随集群变化,必须用
db_tunnel_url权威读取。 - .gitignore 时机:必须在
git init之前写好,排除 STS 凭证文件,否则凭证会被提交到仓库。 - 详情包图片引用:README 中的图片路径必须指向
resources/目录内的实际文件,否则校验不通过。
总结
这次实战展示了华为云 Agent Skill 的编排能力:把 CodeArts ACP(代码生成)、DevBridge(隧道暴露)、GitCode(仓库托管)、hcloud STS(临时凭证)、Gallery API(作品投递)五个独立服务串成一条全自动链路。
整个过程从启动到发布完成约 15 分钟,其中大部分时间在等待 CodeArts 生成代码和 preflight 字体准备。人工介入仅一次——GitCode OAuth 授权扫码。
对于开发者而言,这意味着可以把重复的发布流程交给 AI 自动执行,自己只需关注作品本身的质量。华为云的开发者工具链正在朝着"声明意图 → 自动执行"的方向演进,Agent Skill 就是这一理念的体现。
- 点赞
- 收藏
- 关注作者
评论(0)