dootask/resources/ai-kb/zh/howto/file/upload.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
file.upload.howto	上传文件	howto	file	end-user	zh	怎么传文件 上传文档 把文件传上去 拖进来 上传到网盘	list_files	file	当前所在文件夹有写权限（自己的文件夹或共享读写权限）	同一用户在同一目录下并发上传会自动排队（避免数据库死锁），慢但不会丢 单个文件夹直接子项上限 300，超出会报错 不支持上传文件夹后保留文件夹下原有空目录（空目录会被忽略） 不支持断点续传，超大文件请先压缩	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 的文件夹继续上传（会被拒绝）
• 不支持断点续传 / 分片上传（超大文件建议先压缩）
• 不支持移动端后台续传（应用切到后台可能中断）