Store 概览
Store 是 SteamHarness 项目版本的公开目录。你可以浏览、查看技术信息、下载归档,也可以把自己项目的版本发布上来。
Store 不执行项目代码,也不代替 Server 的项目权限。
浏览与下载
目录页支持按项目类型(Workflow、Conversation、Kanban)、是否使用系统 AI、名称或最近更新筛选。公开列表只包含已批准且已上架的条目:
- 搜索覆盖标题、摘要和描述。
- 技术信息(依赖、版本、归档信息)需要登录后查看。
- 下载需要登录;下载的是提交审核时固化的
.tar.gz归档。 - 未登录用户可以看到公开条目和已批准条目的媒体;待审核媒体只对发布者本人和管理员可见。
发布入口
| 入口 | 位置 | 能做什么 |
|---|---|---|
| Store 控制台 | Store 站点的发布与提交页 | 填写条目信息、上传截图、保存草稿、提交审核、撤回、下架 |
| Server Web 项目控制台 | Server Web 的 Store 与项目详情 | 管理自己项目的草稿、版本与上架状态 |
| 管理控制台 | 管理控制台的 Store 审核 | 审核队列、批准、拒绝、下架 |
Server Web 不能审核 Store,即使账号是系统管理员也一样;审核只在管理控制台进行。完整发布步骤见发布项目到 Store。
账号与登录
Store 使用 SteamHarness 账号登录:
- 受保护页面会跳转到登录页,并在登录后回到原页面;下载意图会继续。
- 所有请求都使用同一个登录会话,不需要额外令牌。
- 修改类请求会校验请求来源,响应不会被浏览器缓存。
状态与版本
条目版本使用 x.y.z,提交后经历:
draft → pending → approved / rejected
pending → withdrawn
approved → unlisted(下架,可重新上架)
- 同一版本一旦批准就不可变:不能用不同的归档重新批准同一版本。
- 新版本处于
pending时,旧的已批准版本仍是当前版本,可继续下载。 - 拒绝必须填写原因,原因会展示给发布者。
- 下架会隐藏条目,并撤回仍在等待审核的版本。
限制
- 不支持上传本地项目包;只能发布已经在 Server 上存在的版本。
- 归档大小上限:压缩后 100 MiB、展开后 512 MiB、10 万个条目。
- 归档会拒绝符号链接、越界路径、运行时目录、密钥文件和疑似凭据。
- 截图最多 6 张,单张 5 MiB,支持 PNG / JPEG / WebP。