mirror of
https://github.com/kuaifan/dootask.git
synced 2026-08-01 02:45:58 +00:00
54 lines
2.1 KiB
Markdown
54 lines
2.1 KiB
Markdown
---
|
||
id: file.upload.howto
|
||
title: 上传文件
|
||
type: howto
|
||
feature: file
|
||
scope: end-user
|
||
locale: zh
|
||
aliases:
|
||
- 怎么传文件
|
||
- 上传文档
|
||
- 把文件传上去
|
||
- 拖进来
|
||
- 上传到网盘
|
||
related_tools: [list_files]
|
||
related_pages: [file]
|
||
prerequisites:
|
||
- 当前所在文件夹有写权限（自己的文件夹或共享读写权限）
|
||
negative:
|
||
- 同一用户在同一目录下并发上传会自动排队（避免数据库死锁），慢但不会丢
|
||
- 单个文件夹直接子项上限 300，超出会报错
|
||
- 不支持上传文件夹后保留文件夹下原有空目录（空目录会被忽略）
|
||
- 不支持断点续传，超大文件请先压缩
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 上传文件
|
||
|
||
## 入口
|
||
- 桌面端 Web：进入「文件」页 → 任意文件夹内 → 顶部「+」→「上传文件」 / 「上传文件夹」
|
||
- 桌面端 Web：直接把文件拖入页面任意位置
|
||
- 桌面端 Electron：拖入应用窗口
|
||
- 移动端：「文件」页右上角「+」→「上传文件」（受系统相册 / 文件选择器限制）
|
||
|
||
## 操作步骤
|
||
1. 进入目标文件夹（顶部面包屑确认位置）
|
||
2. 选择文件或直接拖入（支持多选）
|
||
3. 系统自动按扩展名识别类型（word / excel / picture / archive 等），保存到 `uploads/file/<type>/<年月>/<id>/`
|
||
4. 若同名同后缀文件已存在，可选「保留两个」（默认）或「覆盖」（cover 参数 1）
|
||
|
||
## 上传文件夹
|
||
- 拖入整个文件夹时，系统会自动按 `webkitRelativePath` 重建文件夹结构
|
||
- 路径中每一级文件夹会自动创建（已存在则复用）
|
||
- 空目录会被忽略（只创建有文件的层级）
|
||
|
||
## 字段默认值
|
||
- 拥有者（userid）：当前文件夹的拥有者（避免共享目录混乱）
|
||
- 父目录：当前所在文件夹
|
||
- 版本：上传产生一条新的 FileContent 记录（详见 [[file.version.concept]]）
|
||
|
||
## 不支持
|
||
- 无法向直接子项 ≥ 300 的文件夹继续上传（会被拒绝）
|
||
- 不支持断点续传 / 分片上传（超大文件建议先压缩）
|
||
- 不支持移动端后台续传（应用切到后台可能中断）
|