公开发布与下载目录

发布状态、公开标识、目录可见性、一次性下载和下架边界。

公开意味着什么

实例的 /download 是无需登录的发布目录。只有可用文件的 published 记录进入公开结果；公开后访问者能看到文件名、类型、大小并申请下载。先确认你有权分发文件，并确认文件内容适合公开。

上传成功不会自动发布。创建分享也不等于进入公开目录；两者是独立控制。目录请求失败会显示错误，不能把错误当成“没有发布文件”。

通过管理员页面发布自己的文件

管理员打开 /admin/publish，从列表选择有可用当前版本的自己的文件；必要时“加载更多”。
填写“公开标识”slug，只用小写字母、数字和中划线，长度 1–64，首尾必须是字母或数字。
明确选择“立即公开”或“保存为草稿”。页面默认选择立即公开，提交前要检查。
点击“保存发布状态”，核对结果中的标识和状态。
若选择公开，在未登录浏览器打开 /download 并实际下载核对内容；保存草稿时不应出现在公开目录。

页面位于管理区域，但底层 PUT /api/v1/files/{fileId}/publication 校验文件所有权；管理员权限不表示可以用此接口直接发布别人的文件。普通所有者可通过已认证 API 管理自己的发布，当前没有对应普通用户页面。

API 状态和冲突

请求体为 {"slug":"release-notes","status":"draft"}，status 支持 draft、published、disabled。每个文件通过同一路径创建或更新发布；slug 冲突返回 409。更换 slug 会改变按标识申请票据的入口，应检查已有分发方式。

disabled 可通过 API 下架，当前页面选择器只提供公开和草稿，没有 disabled 选项。不要把“没有下架按钮”解释成 API 不支持，也不要承诺已发出去的文件副本能收回。

目录和下载限制

GET /api/v1/publications 默认 50 条、最大 100 条，并返回 nextCursor。当前 /download 页面只读取第一批，没有继续分页或搜索筛选控件；超过首批的发布未显示不代表记录不存在。

点击下载时调用 POST /api/v1/publications/{slug}/download-ticket，再以 grant 请求 Storage。票据 60 秒有效、单次消费；原始对象地址不是永久外链。draft、disabled 或不可用发布的票据请求返回 404。

发布跟随文件当前版本，既有票据锁定签发时的版本。状态变更阻止新的不合规票据，不保证立即作废已签发的短期 grant。更精确的版本和下载语义见文件与版本。