我在 Windows 上把作品发布到了华为云作品展览馆,踩了四个坑
一篇完整的实战记录:从零做一个 Hello World 网页,到它出现在华为云开发者作品展览馆里,中间到底要过几道关。
先说结论
整条链路是通的,但官方 skill 是为 Linux 沙箱写的,搬到 Windows 上会在第 1、4、8 步先后卡死。四个坑修完之后,发布只用了不到 10 秒。
最终产物:
- 作品页:
gallery.developer.huaweicloud.com/gallery/006a8073e2000000 - 源码仓库:
gitcode.com/gcw_x1XsXMZt/simple-webpage - 积分:+200,申领成功
一、这条链路长什么样
发布被拆成 8 个步骤,核心是四件事:
- 拿身份:用 hcloud(KooCLI)解析出 IAM Domain ID,再换一张 900 秒有效期的 STS 临时凭证。永久 AK/SK 不上传、不出本机。
- 备材料:封面图(1280×720,要过像素级字形校验)、一句话简介(15~50 字符)、详情 zip(README.md 在根 + resources/ 目录)。
- 挂代码:GitCode 仓库,因为发布接口的
gitUrl是必填参数。 - 投递:拼参数 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 踩坑
- 点赞
- 收藏
- 关注作者
评论(0)