从写代码到上架：用 AI Skill 在华为云开发者空间一键发布作品到展览馆

最近在华为云开发者成长中心看到「在开发者作品展览馆中发布作品」这个任务，原本以为要手动建仓、做封面、写详情、再找入口投稿，实际走完一遍发现：开发者空间里的 AI Shell 配上一个发布 Skill，可以把整条链路串起来。这篇把过程和踩到的坑记下来。

一、展览馆投稿到底要准备什么

官方投稿指南写得很清楚：一个能打开的在线体验地址、一个 Git 仓库（GitHub、GitCode、Gitee 都支持）、一张封面图、一份包含架构图的详情内容，最后选择一个处于投稿期的活动。任何一项缺失都提交不了。

对个人开发者来说，最费时的是封面和详情包——它们不是写代码，而是设计活儿。

二、整体链路

整条流程可以拆成五段：AI Shell 里发自然语言指令 → CodeArts ACP（沙箱内 19300 端口）写代码 → 通过 bind mount 把沙箱产物搬到宿主机可见的路径 → DevBridge 开发隧道把本地服务暴露成公网地址 → 最后调用 Gallery OpenAPI 完成投递。

每一段都有现成的 Skill 封装，Agent 负责把它们编排起来，人只需要在「GitCode 授权」和「选择活动」这两个必须由本人确认的节点介入。

三、具体操作

1. 在 AI 开发者空间（体验版就够用）打开 AI Shell，描述你想要的作品。比如「在 /root/workspace/hello-gallery 下创建一个极简页面，深色渐变背景、居中标题、纯 HTML/CSS」。

2. 安装发布 Skill：

npx skills add https://gitcode.com/Lingxi-HandsOn/gallery.git --skill huawei-cloud-publish-work-to-gallery -y

3. 发一句「请将当前项目发布至开发者作品展览馆」，然后按提示完成 GitCode OAuth 授权、选择投稿活动。剩下的建仓推送、封面截图、架构图渲染、详情打包、门禁校验都会自动完成。

四、四个容易卡的坑

1）GitCode OAuth 的 state 会失效。授权页打开后如果隔了一会儿才点「授权」，回调会报 Invalid state。解决办法是重新生成一次授权链接（脚本里的 --start），并立刻完成登录和授权两步。

2）沙箱文件系统是隔离的。CodeArts 跑在 bwrap 沙箱里，它写出来的 /root/workspace 在宿主机上看不到。要么通过 /proc/<pid>/cwd/ 取文件，要么利用沙箱已挂载的 bind mount 目录把产物 cp 出来。

3）STS 临时凭证只有 900 秒。完整发布流程要跑字体安装、Chromium 下载、截图、渲染，很容易超过有效期。凭证落盘时同时写入 _refresh 元数据，让脚本遇到 401 时自动重新 AssumeAgency，就不用人工干预。

4）封面中文字体要先装。preflight 会检查 Noto Sans CJK 是否就位并预热 Chromium，没做这一步直接截图，封面里的中文会变成方块。建议让 preflight 在后台先跑，其他步骤并行。

五、结果

从发出指令到发布成功，全程大约十几分钟，人工操作只有两次：一次 GitCode 授权、一次选活动序号。作品页会自动带上封面、简介、架构图详情、代码仓库和在线体验入口，发布成功后 Skill 还会顺手申领成长积分。

如果你也想把练手项目放到展览馆，建议先用最小的作品跑通一遍全流程，再换成真正的项目——先把管道打通，比先纠结作品复杂度更划算。