展览馆作品发布踩坑实录：GitCode OAuth 走不通，换 GitHub 路线一次过

昨晚为了成长中心的"在开发者作品展览馆中发布作品"任务（+200积分），完整走了一遍官方发布流程，把坑都踩了一遍，记录下来给大伙儿参考。

一、官方路线：AI 开发者空间 + 发布 Skill

展览馆没有网页版发布表单，官方唯一路线是在 AI 对话中安装 Skill 并发送发布口令。Skill 会自动完成：识别作品与账号 → 检查运行与访问地址 → 检查 Git 仓库 → 生成展示材料（封面、架构图、详情包）→ 选择投稿活动 → 发布并返回链接 → 申领成长积分。

安装命令：npx skills add https://gitcode.com/Lingxi-HandsOn/gallery.git --skill huawei-cloud-publish-work-to-gallery

二、第一个大坑：GitCode OAuth 回调链路不通

Skill 默认要新建 GitCode 仓库，走 OAuth 授权。授权链接 300 秒有效，扫码登录、点授权看着都正常，但 broker 的回调始终到不了本地 serve——试了七八次，session 永远停在 waiting。后来发现等待进程被中断时会连带杀掉接收回调的 serve 进程，改用 nohup 保活后依然不通，基本可以判定是回调链路本身的问题。

三、转机：Skill 支持已有 git 信息直接发布

投稿指南 FAQ 里有一句很关键的话："如果选定项目目录已有 .git 信息，将使用此信息发布，无需新建 Git 仓库。"且支持 GitHub、GitCode、Gitee 公开仓。

于是换路线：在 GitHub 建公开仓库，把作品传上去，在工作区里 git remote add origin 指向 GitHub 地址，再发发布口令——Skill 直接使用 GitHub 远端，完全跳过 GitCode OAuth，一路绿灯。

四、第二个坑：展览馆 API 限流 429

发布参数都就绪后，第一次调用返回 429 PUBLISH_RATE_LIMITED。等 30 秒重试还是 429。最后用了退避重试（5分钟→15分钟→30分钟），限流窗口过去后一次成功。建议大家遇到 429 别硬刷，等一会儿再试。

五、结果与建议

作品成功上架展览馆，+200 积分到账。给后来者的三条建议：

1. 提前把作品推到 GitHub 公开仓，能省掉 OAuth 的所有麻烦；
2. 429 限流用退避重试，别连续猛刷；
3. AI 开发者空间页面偶发白屏（昨晚实测），遇到先刷新，不行就换个时间再来。

祝大家都能顺利拿分！