上传一个文件并获得标识码与下载链接。 content / text / path / url 四个来源参数只能传其中一个：

• content：base64 内容（二进制文件用这个）

• text：纯文本内容

• path：服务器本地文件路径

• url：远程文件地址，由服务端抓取 默认保留 24 小时，到期自动删除；如需其他时长用 ttlHours。

根据标识码取回文件内容。 默认自动选择编码：文本类直接返回正文，二进制返回 base64。 传 savePath 可以直接写到服务器本地路径；文件过大时只返回链接。

根据标识码查看文件名、大小、校验值、下载链接与剩余保留时间，不返回文件内容。

列出当前未过期的文件，支持关键词、标签过滤与分页。忘记标识码时用它找回文件。

立即删除指定标识码的文件与元数据，不等到期。操作不可恢复。

把文件的到期时间重算为“从现在起再保留 N 小时”，上限 720 小时。

生成一个临时上传页面链接，可以直接发给人类用户在浏览器里上传文件。 用户上传完成后会得到标识码，把标识码告知你即可用 download_file 取用。

手动触发一次到期清理（后台任务已经定时执行，一般无需调用）。

查看当前文件数量、占用空间、保留策略与下一个到期时间。