把本地小工具发布到华为云开发者作品展览馆的完整流程

去年十月底，我把一个本地能直接打开的单文件小工具，完整走了一遍从本地到华为云开发者作品展览馆的发布流程。整个过程没有服务器、没有构建步骤，关键在三处：作品本身要能独立运行，代码仓库要公开且结构清晰，发布时的授权要按提示一步步完成。下面按实际顺序记录，方便下次照着做，也避免在同一个环节重复踩坑。

一、先让作品在本地真正跑起来

发布之前，先在浏览器里直接打开本地的单文件页面，把主要功能点走一遍：输入、计算、结果展示、异常输入的提示。我的做法是只用原生 HTML、CSS 与 JavaScript，不依赖外部资源，这样换一台电脑、换一个网络环境也能打开。还要准备一份简短的说明，写清这个工具是做什么的、怎么用、输入什么、输出什么、运行需要什么条件。说明不需要写得很长，但要让第一次看到的人不用猜就能上手。

另外建议在本地多试几种边界情况，例如空输入、极端数值、重复操作。发布之后再改，虽然可以更新仓库，但展览馆侧的同步与展示需要时间，提前在本地把问题解决掉，整体效率更高。

二、在 GitCode 新建公开仓库并传代码与说明

第二步是把代码放进一个公开仓库。新建仓库时选择公开，分支使用默认的主分支，把单文件页面与说明文件放在仓库根目录，不要再套一层文件夹。根目录结构简单，发布工具在读取时不容易找错文件，别人点进仓库也能第一时间看到入口文件。

上传完成后，不要只看文件列表，还要点开说明文件，确认渲染出来的标题、功能描述与使用方法没有乱码、没有缺段。说明文件就是后续作品介绍的主要依据，写得清楚，后面填写作品信息时可以直接引用，不用再临时组织语言。如果说明里提到了运行方式，要与实际文件保持一致，例如直接用浏览器打开入口文件即可使用。

三、通过码道的发布 Skill 发起发布

仓库就绪后，回到华为云的开发环境，通过码道 CodeArts 的发布 Skill 发起作品发布。按 Skill 的引导填写作品名称、作品介绍、仓库地址与入口文件等信息。作品介绍以仓库里的说明为准，不要在发布表单里另写一套说法，避免仓库与展览馆展示的信息不一致。

填写时注意区分必填项与可选项，必填项一次填全。仓库地址要复制仓库主页的地址，不要只写仓库名；入口文件要写根目录下的单文件页面文件名。提交前再核对一遍：公开仓库、根目录、入口文件、作品名称与介绍，四项都对得上，再点提交。

四、给 AtomCode 做一次 OAuth 授权，链接失效就重新生成

发布过程中会要求给 AtomCode 做一次 OAuth 授权，授权范围是 user_info 加 projects，用于读取账号基本信息与项目信息，以便发布工具确认仓库归属并完成发布。这是发布流程里的正常一步，不是开通付费服务，也不需要在别处再做一次相同的授权。

我实际遇到过一次情况：第一次生成的授权链接打开后已经失效，页面无法继续。当时没有反复刷新旧链接，也没有换一个仓库重来，而是回到对话里让 AI 重新生成一条新的授权链接，再用新链接完成授权。重新生成的链接有效，授权一次通过，发布流程继续向下走。如果遇到同样的提示，先确认自己点的是最新一条链接，再看授权范围是否与上面一致，范围不对就停下来核对，不要盲目确认。

五、确认发布成功并拿到作品页

授权通过后，等待发布工具完成处理，直到出现发布成功的提示与作品页。拿到作品页后，先打开作品页检查三件事：作品名称是否正确，作品介绍是否与仓库说明一致，入口或仓库链接是否能正常打开。有一项不对，都先回到仓库或发布表单核对，不要直接再发布一个同名作品。

作品页就是这次发布的最终凭证，后面在成长中心申领积分时也以它为准。建议把作品页保存下来，方便后续核对与分享。

六、回成长中心申领积分，注意延迟与每月一次

最后回到开发者成长中心，找到发布作品的任务卡，提交作品页信息并申领积分。这里有三点要特别注意。第一，积分发放可能有延迟，提交后如果没有立刻到账，先刷新页面再看一次，不要因为没立刻看到分数就重复提交。第二，发布作品任务每月仅能申领一次，同一个月已经申领成功，就不要再发布一个类似作品去重复申领。第三，不要重复发布同一个作品，重复作品不仅不会多拿积分，还可能让展览馆里出现重复条目，后续整理起来更麻烦。

回顾整个流程，最花时间的不是写代码，而是把每一步的衔接做对：本地先跑通，仓库保持公开与根目录清晰，发布信息与说明保持一致，授权用最新链接完成一次。按这个顺序走，单文件小工具从本地到展览馆，就是一条可以直接复用的通路。