通过 API 渠道上传附件

API 渠道支持图片和普通文档，不支持音频、视频或外部文件 URL。每条消息最多引用 10 个附件。

上传模式

渠道会根据当前存储方式提供以下一种流程：

直接上传

POST /api/public/api-channels/{channelId}/uploads
Content-Type: multipart/form-data

表单包含一个 file 和一个 category；类别只能是 image 或 document。签名覆盖完整原始 multipart Body。

预签名上传

1. 调用 POST .../uploads/presign，提交文件名、类型、大小和类别。
2. 使用返回的 uploadUrl 与请求头把文件 PUT 到存储。
3. 调用 POST .../uploads/complete，提交 objectKey 和同一组文件信息。

两种模式最终都返回 attachmentId。消息只能引用当前租户、当前渠道、已经完成且尚未过期的附件。