我在 Windows 上把作品发布到了华为云作品展览馆,踩了四个坑

举报
yd_263217773 发表于 2026/10/24 21:17:24 2026/10/24
【摘要】 在 Windows 上跑华为云作品展览馆发布 skill 的完整记录:hcloud 解压被拦、Playwright 装错解释器、reg.exe 被封导致 OAuth 工具装不上、授权回调没人接。四个坑的现象、定位过程与解法,附 GitCode 建仓推送细节。

一篇完整的实战记录:从零做一个 Hello World 网页,到它出现在华为云开发者作品展览馆里,中间到底要过几道关。

先说结论

整条链路是通的,但官方 skill 是为 Linux 沙箱写的,搬到 Windows 上会在第 1、4、8 步先后卡死。四个坑修完之后,发布只用了不到 10 秒。

最终产物:

  • 作品页:gallery.developer.huaweicloud.com/gallery/006a8073e2000000
  • 源码仓库:gitcode.com/gcw_x1XsXMZt/simple-webpage
  • 积分:+200,申领成功

一、这条链路长什么样

发布被拆成 8 个步骤,核心是四件事:

  1. 拿身份:用 hcloud(KooCLI)解析出 IAM Domain ID,再换一张 900 秒有效期的 STS 临时凭证。永久 AK/SK 不上传、不出本机。
  2. 备材料:封面图(1280×720,要过像素级字形校验)、一句话简介(15~50 字符)、详情 zip(README.md 在根 + resources/ 目录)。
  3. 挂代码:GitCode 仓库,因为发布接口的 gitUrl 是必填参数。
  4. 投递:拼参数 JSON 调发布接口,期望 201。

注意第 2 步里那两个"校验"不是形式主义。封面要过 verify-glyphs.py,它读的是 PNG 里内嵌的文本包围盒元数据,专门用来拦"豆腐块"(中文字体缺失渲染成方框)。我第一版封面就是因为 Playwright 装错了 Python 解释器,直接生不出来。

二、四个坑

坑 1:安装脚本的解压被安全策略拦了

install-hcloud.ps1 用 Expand-Archive 解压 KooCLI 的 zip,在当前环境的沙箱策略下被拦掉,同一个策略还顺手封了 reg.exe。

解法:zip 本身是好的(14MB,PK 头正常),直接 unzip 手动解压,落到 %LOCALAPPDATA%\Programs\.huawei\bin\hcloud.exe 就行。

顺带一个隐形问题:KooCLI 首次运行会要求同意隐私协议,没有 TTY 时会直接卡死,表现为进程挂住、零输出。得把 y 写进文件、用 -RedirectStandardInput 喂进去。同意后 ~/.hcloud/config.json 里会出现 "agreePrivacy": "true"。

坑 2:Playwright 装进了另一个解释器

这个最隐蔽。预检脚本 preflight.ps1 报告"✅ Playwright: ok",但实际上它把包装进了 py 启动器指向的 D:\Apps\Python312,而截图脚本调用的是 python3 —— 在这台机器上解析到 WorkBuddy 自带的 3.13.12。

结果是预检全绿、封面生成报 No module named 'playwright'。

解法:给真正被调用的解释器补装。

python3 -m pip install playwright numpy pillow

验证时注意:Pillow 的模块名是 PIL 不是 pillow,import pillow 一定失败,别被这个误导。

python3 -c "import playwright, numpy, PIL; print('ok')"

顺便说,Playwright 会优先复用系统 Edge/Chrome,不用下那 300MB 的 Chromium——这次预检只花了 17 秒。

坑 3:reg.exe 被封导致 OAuth 工具装不上

GitCode 授权走的是一个独立 Go 二进制 gitcode-oauth。它的自动安装逻辑要调 ensure-user-bindir.mjs 读用户目录,而这个脚本依赖 reg.exe,正好被策略拦了。报错信息只有一句"网络/架构不支持",很容易误判成网络问题。

解法:直接从 releases 拿预编译包,用环境变量指定路径。

curl -L -o gitcode-oauth.exe \
  https://gitcode.com/zhoucungen/gitcode-oauth/releases/download/v0.0.1/gitcode-oauth-windows-amd64.exe

export GITCODE_OAUTH_BIN="C:/path/to/gitcode-oauth.exe"

坑 4:授权回调没人接

这是最气人的一个,也是最值得记录的。

skill 的授权是两阶段的:--start 起一个本地 broker 并打印登录链接,--wait 轮询等回调。问题是 --start 把 broker 作为分离进程启动,在受限环境里这类进程会被直接回收。等你点完授权,回调地址 127.0.0.1:7654 已经没人监听了,--wait 轮询到超时,报 reason=timeout。

表象:用户明明点了授权,还是超时。查日志能看到 Starting server on :7654,但 curl 过去是 connection refused。

解法:绕开两阶段,直接跑常驻登录。这个进程活在前台,token 拿到之前不退出。

gitcode-oauth login    # 输出登录 URL + 终端二维码,阻塞等待

授权成功后 token 自动写进 ~/.gitcode/auth.toml,access_token 字段直接可用。

三、建仓推送的几个细节

GitCode 的 API 和 GitHub 有个不一样的地方:认证走 access_token query 参数,不是 Authorization header。

# 建仓
curl -X POST "https://api.gitcode.com/api/v5/user/repos?access_token=$TOK" \
  -H "Content-Type: application/json" \
  -d '{"name":"simple-webpage","private":false}'

# 推送(临时内嵌 token,推完立刻去掉)
git remote add origin "https://<login>:<TOK>@gitcode.com/<login>/simple-webpage.git"
git -c credential.helper= push -u origin main
git remote set-url origin "https://gitcode.com/<login>/simple-webpage.git"

-c credential.helper= 这半句别省。不然 Windows 凭据管理器会跳出来弹窗,在自动化场景里就是卡死。

还有个顺序问题:git init 之前先把 .gitignore 写好,排除 sts-creds.json / sts-creds.sh。凭证文件一旦进了 commit,推上去就洗不掉了。

四、Windows 上没有隧道,这是设计如此

skill 里 Step 2 是"起本地服务 + 开 DevBridge 隧道",但 detect-env.mjs 在 Windows 上返回 tunnel=false,这时正确行为是把 envUrl 置空字符串,直接跳过隧道,不是失败。

所以 Windows 发布出来的作品没有在线预览地址,只有代码仓库和详情包。这是预期行为,不用去折腾什么内网穿透。

五、几点建议

  • 先跑 --help 再读源码。这套脚本每个都有 --help,契约写得比源码清楚,读源码反而容易误判。
  • 门禁不要手改。封面比例、简介字数、zip 结构这些检查是服务端同源的,本地绕过了服务端照样拒。
  • STS 有效期只有 900 秒。全流程走完容易超,发布前重跑一次 gen_sts.py 最稳。
  • 凭证只留 900 秒。永久 AK/SK 留在 hcloud 本地配置里,流程结束后把 sts-creds.* 删掉。

整件事做完最大的感受是:把"构建—发布—上架"整条链路拆成明确的步骤、每步都有可判定的成功信号,比单纯让 AI 写代码有价值得多。代码只是第一步,能可靠地送出去才是闭环。


标签:华为云 / 作品展览馆 / GitCode / KooCLI / Windows 踩坑

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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