跳到主要内容

发布项目到 Store

Store 只接受已经发布到 Server 的项目版本。发布前先确认:

  1. 项目已经上传到 Server,并有一个符合 x.y.z 的版本。
  2. 当前账号对该项目有管理权限,并且有源码下载权限;两者缺一不可。
  3. 项目归档不包含 .env、.git、node_modules、密钥或其他凭据。

创建条目​

可以从三个地方开始:

  • 在 Studio 中运行「发布项目到 Store」,它会带上当前项目的 ID 与版本。
  • 在 Store 站点打开发布页,手动选择项目和版本。
  • 在 Server Web 的项目控制台创建或继续草稿。

需要填写:

字段限制
标题120 字符
摘要280 字符
描述30,000 字符
使用要求10,000 字符
截图最多 6 张,PNG / JPEG / WebP,单张 5 MiB
是否使用系统 AI发布者声明,审核时会核对

可以随时保存草稿。同一个条目同时只能有一个草稿或待审核版本;重复创建会回到已有的待审核版本。

提交与快照​

点击提交后,平台会:

  1. 读取该版本已发布的源码归档。
  2. 检查归档结构、大小、路径与疑似凭据。
  3. 从 package.json 提取依赖,记录技术信息。
  4. 固化归档并记录完整性信息,供审核与下载使用。

审核针对的是提交那一刻的归档。之后修改 Server 上的项目不会改变待审核内容;需要重新提交新版本。

审核状态​

draft 草稿,仅发布者可见
pending 已提交,等待管理员审核
approved 已批准,成为当前版本并上架
rejected 被拒绝,必须附原因
withdrawn 发布者或下架操作撤回
unlisted 条目已下架(界面上的派生状态)

审核在管理控制台完成。批准时会重新校验归档完整性;检查不通过不会切换当前版本。

新版本审核期间,旧的已批准版本继续对外提供下载。批准后当前版本才切换到新版本。

拒绝、撤回与下架​

  • 拒绝:管理员必须填写原因,发布者可以看到原因并修改后重新提交。
  • 撤回:发布者可以撤回待审核版本,条目回到可编辑状态。
  • 下架:发布者或管理员可以下架条目。下架会隐藏条目,并撤回仍在等待中的版本;已批准的历史版本不会删除,但公开页面不再展示。
  • 重新上架:重新提交并通过审核后恢复展示。

归档限制​

限制值
压缩后大小100 MiB
展开后大小512 MiB
文件/目录条目100,000
截图6 × 5 MiB

归档必须是 gzip tar,不能包含绝对路径、..、Windows 盘符、重复路径、符号链接或特殊文件。运行时目录和常见凭据模式会被拒绝。

常见问题​

现象处理
看不到可发布的项目确认项目已上传到 Server,并且当前账号有管理权限和源码下载权限
同一版本无法再次提交已批准的版本不可变;请发布新的 x.y.z 版本
提示已有待审核版本先处理或撤回该条目的草稿/待审核版本
归档校验失败检查归档是否包含符号链接、越界路径或凭据,然后重新发布版本
截图上传失败确认单张不超过 5 MiB,格式为 PNG / JPEG / WebP
提交后没有显示刷新提交页;仍不显示时联系管理员检查审核队列