华为云码道沙箱实践：单文件 HTML 小作品从开发到展览馆发布的全流程

一、背景

最近在参与华为云开发者成长中心的每日任务，其中"在开发者作品展览馆中发布作品"是体验最完整的一项。借助华为云码道（CodeArts）的云上沙箱，从写代码到作品上架可以全程在浏览器里完成，不依赖本地环境。这里把完整流程整理出来，给同样想快速上手的开发者一个参考。

二、环境准备

码道沙箱自带 Node 与 Python 环境，主要需要补两样工具：

• KooCLI（hcloud）：执行 NODE_OPTIONS="--experimental-sqlite" npx --yes huaweicloud-devkit install-hcloud 安装（Node 22 必须加 --experimental-sqlite，否则会报 node:sqlite 找不到）；首次使用 echo "y" | hcloud version 同意隐私协议，再用 configure set 配置访问密钥与区域 cn-north-4。
• DevBridge：用官方安装脚本一键装好，devbridge auth login 完成认证，用于把沙箱端口暴露成公网隧道。

三、作品开发与公网暴露

作品本身坚持"单文件 index.html"原则：零依赖、无构建步骤、断网也能双击打开。今天做的是一个番茄钟专注计时器：25/5 分钟模式切换、SVG 圆形进度环、开始/暂停/重置，计时结束用 Web Audio 生成提示音。写完后 setsid python3 -m http.server 8000 起本地服务，再用 DevBridge 的 port create（加 --allow-anonymous --protocol http）生成 *.devbridge-s2.hwtunnel.com 隧道域名，curl 验证返回 200 即完成暴露。

四、封面、详情与提交

官方技能仓库（gitcode.com/huaweicloud/huaweicloud-skills）里的 publish-work-to-gallery 技能提供了整套脚本：build-cover.mjs 按规范生成封面图与作品简介（注意中文字数是硬性门槛，先数好 CJK 字数再生成）；build-detail-zip.mjs 打包作品详情（resources 目录只能放图片，架构图要先生成 PNG）。提交前用 api.mjs 查询当前进行中的活动，再走 publish-work.mjs 提交发布。如果遇到 STS/SELF_VERIFY 相关报错，按提示用 hcloud IAM CreateAgency 创建自委托后重跑生成脚本即可。

五、踩坑记录

• 沙箱访问不了 GitHub，克隆仓库一律走 GitCode 镜像；
• 沙箱 3 小时无操作会被自动回收，重新进入后需按第二节重装工具；
• 作品简介的字数校验是硬性的，中文计数不达标会被驳回。

整体跑下来，从空沙箱到作品上架大约 30 分钟，流程固定后非常适合每天练手一个小创意。后续计划把这个流程做成脚本模板，进一步减少重复操作。