公开发布与下载目录

把文件发布到公开目录、管理发布状态、了解目录可见性和一次性下载机制，以及下架的边界。

公开意味着什么

实例的 /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。更精确的版本和下载语义见文件与版本。