SnowLuma/packages/onebot/GROUP_FILES.md

# 群文件发送与临时存储

`upload_group_file` 和 `send_group_msg` 中的文件段默认使用群永久文件空间。
当服务器明确返回容量或文件数量限制时，SnowLuma 会尝试一次临时存储，并在日志中记录这次切换。
临时申请、文件传输或聊天发布失败仍会报错；权限不足、连接失败等其他错误不会触发切换。
临时文件可能过期，不能作为永久保存的替代。

## 消息内容限制

进入临时文件路径时，一条消息只能包含文件或图片段。
含文字、提及、表情等其他内容的混合消息会被拒绝，需要调用方拆成独立消息后再发送。
合并转发按每个节点的内容检查同一规则。

SnowLuma 会在发布聊天消息前检查附件；发现不允许的组合时，不会先发文字、再丢掉附件或文字。
检查之前已完成的其他附件上传不会自动删除。上传成功后如果聊天发布失败，错误仍会保留文件标识。
这不是跨多条消息的事务：开始发布后出现的网络或服务端错误仍可能使前面的消息已经送达。

普通图片加文字仍通过图片消息通道发送，不会因为群永久文件空间不足而转成群文件。
永久文件与文字的现有分开发送方式保持兼容。超大视频按原有规则转成文件后，也适用临时文件的内容限制。

## 文件复用与下载

运行期间上传过的群文件会按账号、群和文件标识保留其存储类型。
同一群中用 `file_id` 再次发送、获取下载链接或生成合并转发时，会使用该存储类型。
`get_group_file_url` 显式传入的 `busid` 仍优先；未提供有效值时，使用当前会话记住的类型，否则沿用永久文件默认值。
上传记录不是持久化目录；重启后获取临时文件链接，应从群文件列表取得对应的 `busid` 并传入。