发布项目到 Store
Store 只接受已经发布到 Server 的项目版本。发布前先确认:
- 项目已经上传到 Server,并有一个符合
x.y.z的版本。 - 当前账号对该项目有管理权限,并且有源码下载权限;两者缺一不可。
- 项目归档不包含
.env、.git、node_modules、密钥或其他凭据。
创建条目
可以从三个地方开始:
- 在 Studio 中运行「发布项目到 Store」,它会带上当前项目的 ID 与版本。
- 在 Store 站点打开发布页,手动选择项目和版本。
- 在 Server Web 的项目控制台创建或继续草稿。
需要填写:
| 字段 | 限制 |
|---|---|
| 标题 | 120 字符 |
| 摘要 | 280 字符 |
| 描述 | 30,000 字符 |
| 使用要求 | 10,000 字符 |
| 截图 | 最多 6 张,PNG / JPEG / WebP,单张 5 MiB |
| 是否使用系统 AI | 发布者声明,审核时会核对 |
可以随时保存草稿。同一个条目同时只能有一个草稿或待审核版本;重复创建会回到已有的待审核版本。
提交与快照
点击提交后,平台会:
- 读取该版本已发布的源码归档。
- 检查归档结构、大小、路径与疑似凭据。
- 从
package.json提取依赖,记录技术信息。 - 固化归档并记录完整性信息,供审核与下载使用。
审核针对的是提交那一刻的归档。之后修改 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 |
| 提交后没有显示 | 刷新提交页;仍不显示时联系管理员检查审核队列 |