跳到主要内容

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。