mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 10:55:59 +00:00
67 lines
2.0 KiB
Markdown
67 lines
2.0 KiB
Markdown
---
|
||
id: messenger.send.howto.file
|
||
title: 发送文件消息
|
||
type: howto
|
||
feature: messenger
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- 怎么发文件
|
||
- 发个文件
|
||
- 发附件
|
||
- 上传文件
|
||
- 群里发文件
|
||
- 怎么发文档
|
||
related_tools: [send_message, search_files]
|
||
related_pages: [messenger, dialog_chat]
|
||
prerequisites: []
|
||
negative:
|
||
- 单个文件大小受系统设置 file_upload_limit 限制（默认无单独限制，按 PHP 上传配置 ）
|
||
- 不支持文件夹直接拖入，需要逐个或压缩后上传
|
||
- 不支持已删除文件 ID 复用（通过 sendfileid 发送已删除文件会失败）
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 发送文件消息
|
||
|
||
发送文件（sendfile）支持拖拽、点击附件按钮、粘贴 / 截图、从「我的文件」选择等多种方式。文件保存到 `uploads/chat/yyyymm/dialog_id/` 目录。
|
||
|
||
## 入口
|
||
|
||
- 桌面端：会话输入框 → 左下角「+」/ 回形针图标 → 「上传文件」
|
||
- 桌面端：直接拖拽文件到会话窗口
|
||
- 桌面端：粘贴板（Ctrl+V）粘贴图片 / 文件
|
||
- 移动端：会话底部 → 「+」 → 「文件」/「相册」/「相机」
|
||
|
||
## 操作步骤
|
||
|
||
1. 触发上传入口或拖入文件
|
||
2. 选择文件（可多选，支持 sendfiles 批量）
|
||
3. 客户端展示上传进度
|
||
4. 上传成功后立即以文件消息形态发到会话
|
||
|
||
## 字段说明
|
||
|
||
| 字段 | 含义 |
|
||
|---|---|
|
||
| files | 上传的文件（multipart） |
|
||
| filename | 自定义文件名（可选） |
|
||
| reply_id | 引用的消息 ID |
|
||
| image_attachment | 图片是否也写入任务附件库（1=是） |
|
||
|
||
## 文件类型识别
|
||
|
||
后端根据扩展名自动识别 mtype：
|
||
- jpg / jpeg / png / gif / webp → image（图片）
|
||
- 其他 → file（普通文件）
|
||
- mp4 / mov / mkv 等视频会单独处理
|
||
|
||
## 通过已有文件 ID 转发
|
||
|
||
走 sendfileid 可以把「我的文件」里现存文件以分享链接形式发到会话，不重复上传。
|
||
|
||
## 不支持
|
||
|
||
- 不支持发送大于系统文件上限的文件
|
||
- 不支持「群发但只让部分人下载」的权限隔离，群内所有成员均可下载
|