SnowLuma v2.4.2 source snapshot

packages/onebot/GROUP_FILES.md

@@ -0,0 +1,26 @@
+# 群文件发送与临时存储
+
+`upload_group_file` 和 `send_group_msg` 中的文件段默认使用群永久文件空间。
+当服务器明确返回容量或文件数量限制时，SnowLuma 会尝试一次临时存储，并在日志中记录这次切换。
+临时申请、文件传输或聊天发布失败仍会报错；权限不足、连接失败等其他错误不会触发切换。
+临时文件可能过期，不能作为永久保存的替代。
+
+## 消息内容限制
+
+进入临时文件路径时，一条消息只能包含文件或图片段。
+含文字、提及、表情等其他内容的混合消息会被拒绝，需要调用方拆成独立消息后再发送。
+合并转发按每个节点的内容检查同一规则。
+
+SnowLuma 会在发布聊天消息前检查附件；发现不允许的组合时，不会先发文字、再丢掉附件或文字。
+检查之前已完成的其他附件上传不会自动删除。上传成功后如果聊天发布失败，错误仍会保留文件标识。
+这不是跨多条消息的事务：开始发布后出现的网络或服务端错误仍可能使前面的消息已经送达。
+
+普通图片加文字仍通过图片消息通道发送，不会因为群永久文件空间不足而转成群文件。
+永久文件与文字的现有分开发送方式保持兼容。超大视频按原有规则转成文件后，也适用临时文件的内容限制。
+
+## 文件复用与下载
+
+运行期间上传过的群文件会按账号、群和文件标识保留其存储类型。
+同一群中用 `file_id` 再次发送、获取下载链接或生成合并转发时，会使用该存储类型。
+`get_group_file_url` 显式传入的 `busid` 仍优先；未提供有效值时，使用当前会话记住的类型，否则沿用永久文件默认值。
+上传记录不是持久化目录；重启后获取临时文件链接，应从群文件列表取得对应的 `busid` 并传入。