1.7 KiB
Raw Permalink Blame History

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.tree.concept 文件树结构 concept file end-user zh
文件夹结构
文件父子关系
文件嵌套
文件树
文件层级
list_files
get_file_detail
file
单个文件夹下最多 300 个直接子文件 / 子文件夹
不支持软链接 / 快捷方式(一个文件只能在一个位置)
不支持跨用户的全局共享根目录
v1.7.90

文件树结构

定义

DooTask 的文件以树形结构组织每个文件或文件夹type=folder通过 pid 字段指向父级,根目录 pid=0。系统额外维护 pids 字段(递归祖先 ID 串)用于快速查询路径与权限。

关键属性

  • pid:直接父文件夹 ID0 表示根
  • pids:祖先链字符串如 ,5,12,28,,用于 LIKE 查询子树
  • type=folder:文件夹本身也是 File 表的一条记录
  • userid:拥有者(与共享文件夹一致时表示共享根)
  • pshare:所属共享根 ID0 表示不在任何共享内

容量限制

  • 单文件夹直接子项数量上限 300含子文件夹
  • 整树深度无强制上限但超过 10 层不推荐
  • 共享文件夹最多 100 个共享成员

与「项目任务文件」的区别

  • 文件树:用户的网盘,独立功能
  • 项目任务文件:附在任务下的附件(project_task_files 表),不进入文件树
  • 两者完全隔离,互不可见

文件类型枚举

folder文件夹/ document在线文档/ mind思维导图/ drawio流程图/ word / excel / ppt / picture / archive / pdf / txt / code / media 等。