后端前端协同办公即时通讯企业应用【免费下载链接】dootaskDooTask是一款开源在线项目任务管理工具提供各类文档协作工具、在线思维导图、在线流程图、项目管理、任务分发、即时IM文件管理等工具同时消息功能使用非对称加密技术让你的沟通更安全。项目地址https://gitcode.com/gh_mirrors/do/dootask点击查看免费下载导读本文围绕 DooTask「文件」模块的入口与基本使用完整说明桌面端 Web / Electron、移动端以及直接 URL 四种进入方式梳理「我的文件 / 共享文件 / 协作文件」三大板块的默认视图与权限规则并给出上传、新建、共享、预览、搜索、WebDAV 挂载等常见操作的高频要点。阅读后你可以快速定位文件入口、理解文件树的底层数据结构pid/pids/pshare字段并掌握 DooTask 文件功能的能力边界。一、文件入口在哪四条路径对照在 DooTask 中「文件」是一级导航系统级入口集中展示个人文件、共享文件和协作场景中的文件它的定位接近内置网盘。进入方式共有四种覆盖桌面端、桌面客户端与移动端端入口路径说明桌面端 Web左侧栏「文件」文件夹图标一级菜单点击后进入个人文件根目录桌面端 Electron左侧栏「文件」或直接把文件拖入应用窗口与 Web 一致额外支持窗口拖入上传桌面端 URLhttps://域名/manage/file直接访问文件管理页移动端竖屏底部 Tabbar 不显示「文件」一级需「应用」→「文件」卡片或底部「更多」→「文件」文件入口被收纳在二级页面几个容易混淆的细节快捷键文件入口本身没有快捷键但选中文件后重命名支持F2、删除支持Delete键见下文「高频操作」。不可隐藏、不可改顺序文件菜单是系统级一级入口前端无法隐藏或调整顺序参见 入口详解 的 negative 说明。不支持挂载外部网盘如百度网盘、OneDrive 等第三方网盘均不支持挂载DooTask 文件功能是独立的内部存储体系。访客游客 token限制所有登录用户都能看到「文件」入口但游客只能访问被显式标记guest_access的链接无法进入文件管理页。前端路由resources/assets/js/routes.js中注册了/manage/file对应页面组件./pages/manage/file.vue与文档中的 URL 入口相互印证。二、默认视图三大板块与面包屑进入「文件」页后顶部是板块 Tab主区域按板块展示内容我的文件我拥有的全部文件含已共享出去的共享不会让文件从「我的文件」消失。共享文件双向共享聚合——既包含「我共享出去的」也包含「别人共享给我的」可用「全部 / 我共享的 / 共享给我的」二次筛选我共享出去的文件会同时出现在「我的文件」与「共享文件」两个板块。协作文件汇总当前用户有权访问的私聊、普通群聊、项目群聊和任务聊天中的文件可按会话或项目继续筛选。进入子文件夹后Tab 下方出现面包屑路径以板块名为起点可点击回到板块根目录根目录不显示重复标题。主区域列出当前文件夹下的文件与文件夹单次最多展示 500 条超出部分滚动加载。板块选择会记住上次停留的 Tab。权限要求所有登录用户可见无管理员限制。看到的内容范围 自己创建的 他人共享给我的不包含全公司维度浏览所有人文件出于隐私设计这是明确的限制项。对某个文件的具体操作权限分为四级由File::getPermission()计算详见 File.php权限值含义触发条件1000所有者或创建者userid或created_id命中当前用户1读写在共享成员内且权限为读写0只读访问在共享成员内且权限为只读-1无权限不在任何共享范围内三、核心入口之「上传」分片、断点续传与秒传桌面端 Web 进入「文件」页任意文件夹点顶部「」→「上传文件 / 上传文件夹」或直接把文件拖入页面任意位置Electron 可拖入应用窗口移动端在「文件」页右上角「」→「上传文件」受系统相册 / 文件选择器限制。上传时系统按扩展名自动识别类型word / excel / picture / archive 等保存路径为uploads/file/type/年月/id/同名同后缀文件已存在时可选「保留两个」默认或「覆盖」cover参数为 1。上传文件夹拖入整个文件夹时系统按webkitRelativePath重建文件夹结构路径中每一级文件夹自动创建已存在则复用空目录会被忽略只创建有文件的层级。该逻辑在File::contentUploadPrep()File.php中实现逐级拆分路径、按pid typefolder name查询或创建中间文件夹并利用lockForUpdate()防止并发竞态。大文件 / 断点续传 / 秒传实现在 ChunkUpload.php≥10MB 自动分片文件切成 5MB 分片CHUNK_SIZE 5 * 1024 * 10243 路并发上传前端先在 Web Worker 中计算 md5不阻塞 UI。断点续传上传中刷新页面或断网后重新选择同一文件会跳过已上传分片从中断处继续。服务端用 Redisupload:*key 保存分片索引与元数据TTL 24 小时STATE_TTL 86400浏览器侧用localStorage的chunked_upload:hash索引同样 24 小时定位续传点。秒传同一用户上传过相同 md5 的文件命中files.hash字段时目标文件夹立即出现新记录零传输。ChunkUpload::trySecondPass()会在 merge 前按hash userid反查复用已有内容。残留清理uploads/tmp/chunks/{userid}/{upload_id}/中超过 24 小时的残留分片由DeleteTmpTask定时任务兜底清除。限制单文件夹直接子项上限 300超出拒绝续传索引存于 localStorage跨设备 / 跨浏览器无效服务端可按 hashuserid 反查兜底移动端切后台可能中断上传。四、核心入口之「新建」文件夹与在线文档类型「文件」页内任意文件夹点顶部「」可新建以下类型类型说明依赖folder文件夹无document在线文档Markdown 富文本扩展名 md无word / excel / ppt在线 Office 文档docx / xlsx / pptx需 office 插件OnlyOfficemind思维导图扩展名 mind需 minder 插件产品默认随包提供drawio流程图 / 架构图扩展名 drawio需 drawio 插件命名规则文件名必填长度 2–100 字符不能包含\ / : * ? |同名冲突时系统自动追加(2)、(3)后缀File::handleDuplicateName()实现见 File.php。文档类型创建后自动打开编辑器可立即编辑。默认字段拥有者为所在文件夹的拥有者共享文件夹内则归文件夹所有者创建人为当前用户父目录为当前文件夹。不支持新建 PDF / 图片 / 压缩包等二进制类型只能上传不支持批量新建不支持复制文件夹。五、文件树结构pid / pids / pshare 的底层模型DooTask 文件以树形结构组织详见 tree.md每个文件或文件夹typefolder都是files表的一条记录通过字段描述层级与共享归属字段含义pid直接父文件夹 ID0表示根目录pids祖先链字符串如,5,12,28,用于 LIKE 查询子树type文件类型枚举folder / document / mind / drawio / word / excel / ppt / picture / archive / pdf / txt / code / media 等userid拥有者 ID与共享根一致时表示共享根share是否为共享根0/1pshare所属共享根 ID0表示不在任何共享内ext扩展名handleDuplicateName按ext判定重名hash文件 md5秒传索引由 2026_06_30 迁移新增saveBeforePP()File.php在保存前递归向上重建pids与pshare链并在祖先变化时向下级联更新子树保证路径与共享信息的强一致。与「项目任务文件」的区别文件树是用户的网盘独立功能项目任务文件是附在任务下的附件存于project_task_files表两者完全隔离、互不可见。容量限制单文件夹直接子项上限 300含子文件夹整树深度无强制上限但不推荐超过 10 层共享文件夹最多 100 个共享成员。六、共享与他人协作权限两档与数据结构入口桌面端 Web 选中文件 / 文件夹 → 右键 /「···」→「共享设置」或在文件列表「共享」段点开已共享项 → 设置图标。操作三步进入共享设置弹窗 → 搜索框添加协作成员可多选→ 选择权限并确定。权限只有两档只读permission0只能浏览 / 下载。读写permission1可编辑 / 上传 / 在共享文件夹内新建。共享数据结构与 FileUser.php 及 File.php 对应共享记录存于file_users表每条 一个文件 × 一个用户 × 一个权限。文件的share字段标记自身是否为共享根pshare指向其所在共享根 ID。共享根之下的所有子文件、子文件夹自动继承共享getShareInfo()沿pid链向上找到共享根scopeSharedToUser按psharefile_users筛选“别人共享给我的”文件。共享后读写成员可以在共享文件夹内创建 / 上传新文件成员看到的拥有者仍是原拥有者被共享方可在自己文件页对该文件「退出共享」。限制不能嵌套共享已在共享文件夹内的子项不能单独再共享共享给「所有人」userid0的链接被共享方不能退出单个共享最多 100 个成员没有「评论」「仅看链接」「下载禁止」等中间档。七、公开访问链接与游客访问选中文件 → 右键 /「···」→「分享链接 / 获取链接」或从文件预览页右上角「分享」按钮进入。首次获取时系统生成一条file_links记录链接形如https://your-domain.com/single/file/base64-codecode由file_id userid 随机串经 base64 编码得到见 FileLink.php请勿泄露。同一用户对同一文件只有一个链接再次获取返回同一个 code勾选「刷新链接」可重新生成旧 code 立即作废无过渡期。登录用户点链接进入文件预览页受文件本身权限校验游客访问仅当guest_access1时可直接预览否则跳登录校验逻辑在FileController::one()FileController.php。每次访问num计数 1可在分享设置看到累计访问数。不支持设置过期时间除非手动刷新或删文件、访问密码、总访问次数上限。给 MCP / AI 使用时可用api/file/fetch按文件路径分页获取文本内容offset/limit参数默认 50000 字符、最大 200000。八、在线预览与编辑插件依赖一览文件预览指在浏览器内不下载即可查看的能力详见 preview.md不同文件类型走不同预览管线浏览器直接预览无需插件document内置 Markdown 渲染、txt / code纯文本与代码高亮代码预览限制 2M 内、picturejpg / png / webp / gif / bmp、mind需 minder 插件但随包默认提供、drawio需 drawio 插件。需安装插件预览word / excel / ppt 由 OnlyOffice 渲染office 插件pdf / cad / ofd / tif / wps 由 fileview 插件提供。不支持预览archivezip / rar / 7z 只能下载无在线解压、mediamp3 / mp4 / mov 直接下载预览依赖浏览器原生、axurerp 仅记录类型需用 Axure 客户端查看。在线编辑类型document、word/excel/pptoffice 插件、mind、drawio仅预览类型pdf 及其他 fileview 支持的类型。编辑权限受 FileUser 权限位读写 / 只读控制。未安装对应插件时打开会提示「未安装」但仍可下载。九、搜索与协作文件能力边界文件名搜索文件页内置文件页顶部搜索框输入即筛选按name LIKE %关键词%包含匹配不分词关键词为纯数字时同时按文件 ID 精确匹配File::scopeSearchByKeyword见 File.php。搜索范围 自己的文件 他人共享给我的文件单次最多返回 100 条。搜索框也可粘贴分享链接系统会解析 code 反查文件。文件内容搜索全局搜索走全局搜索Manticore 索引仅文档类document / txt / code / pdf 抽取出的文本被索引office 文件doc / xls / ppt索引后可按内容关键词命中图片不参与内容索引需理解图中文字可交给 AI 助手多模态识别。协作文件「文件」→ 顶部「协作文件」可看会话、项目和任务中的文件支持按「会话 / 项目 / 任务」筛选也可按文件类型、成员、发送人筛选可搜索文件名、会话名、项目名、任务名。一条聊天消息含多张图片时每张独立展示Electron 客户端会同步本地下载状态未下载 / 下载中 / 已下载可定位。协作文件只展示当前仍有权限的来源已撤回或删除的文件消息不显示遵循任务可见性规则。限制协作文件是只读聚合视图不支持新建、上传、移动、删除不汇总以文本链接分享的个人文件。十、WebDAV把 DooTask 文件挂载到本机管理员已启用 WebDAV 并允许当前用户时可在「文件」页右上角「···」→「WebDAV」创建连接凭据停留在「我的文件」或「共享文件」板块点右上角加号右侧的圆形「···」→「WebDAV」。点「新建」填写设备名称与有效期。创建后立即保存弹窗中的连接地址、用户名和应用密码应用密码只显示一次关闭后不可再查看只能撤销后重建。连接后的目录files/为「我的文件」允许按权限新建、读取、修改、移动、删除shared/为共享给我的文件共享顶层名称带[#文件ID]标识用于避免重名勿手工删除。只读共享只能浏览下载读写共享可保存修改与新建。连接采用 HTTP Basic 应用密码认证但服务端只允许通过 HTTPS 传输因此必须使用弹窗给出的三项信息并确保当前页面为 HTTPS。设备管理支持查看名称、状态、凭据尾号、有效期、最近使用时间可撤销或永久删除凭据撤销后设备立即认证失败永久删除不影响既有 WebDAV 操作审计日志。常见问题看不到入口 管理员未开启或不在成员范围无法创建密码 非 HTTPS 或达到每人应用密码数量上限密码忘记不可找回撤销重建保存失败需检查共享权限、文件锁、名称合法性及大小限制。十一、移动 / 重命名 / 删除与恢复高频操作要点操作入口关键规则移动顶部「移动」按钮 / 右键「移动到...」/ 拖拽到文件树一次最多 100 项已共享文件不能移入另一共享文件夹不能移到自己的子目录循环引用移入共享文件夹后userid改为共享根拥有者重命名右键「重命名」/「···」/F2长度 2–100 字符、不能含\ / : * ? \|不能改扩展名同目录重名自动加(2)后缀通过 WebSocket 实时推送给所有有权访问的人删除顶部「删除」/ 右键 /Delete键仅所有者或创建者可删后端file/remove对他人返回「仅限所有者或创建者操作」软删除deleted_at标记级联删除子文件与子文件夹同时清理 FileUser 共享配置与 FileLink 分享链接一次最多 100 项恢复无前端回收站 UI数据层保留在数据库Laravel SoftDeletes普通用户无法自助恢复需联系管理员通过数据库恢复deleted_at约 30 天后定时任务清理本地物理文件删除会走File::deleteFile()事务File.php软删自身 → 推送删除消息 → 清共享配置与分享链接 → 递归删除子项。注意任务里引用了该文件的「关联文件」不会自动清理会显示「文件不存在或已被删除」。十二、文件版本历史谁改过、怎么回滚对支持在线编辑的文件每次保存都会在file_contents表插入新记录FileContent文件本身File 表只指向最新版通过whereFid orderByDesc(id)可查出全部历史详见 version.md 与 FileContent.php。file_contents关键字段fid所属文件 ID、contentJSON 元数据含真实存储路径 url、类型 type、扩展 ext、text提取的纯文本用于全文检索、size本版本字节数、userid本次保存人、created_at保存时间。有版本的类型document、word / excel / pptOnlyOffice 在线编辑、mind、drawio。无版本的类型上传的二进制文件pdf / archive / picture / media 等覆盖上传只保留最新一版folder 本身无内容无版本。查看与恢复文件预览页 / 编辑页 → 顶部菜单「历史记录」列表显示每一版的保存人头像 时间 大小选某一版可「预览」或「恢复」恢复 把该历史版复制为新的最新版保留中间版本。多人协作时由 OnlyOffice 自身协同逻辑保证一致性并在最后一个编辑者关闭后回写一版到 FileContent。十三、能力边界速查来自官方文档的 negative 声明「文件」入口不能隐藏 / 改顺序不支持挂载外部网盘百度网盘 / OneDrive。不支持按全公司维度浏览所有人文件隐私设计。单文件夹直接子项上限 300单次上传/移动/删除最多 100 项。不支持软链接 / 快捷方式一个文件只能在一个位置。版本历史仅对在线编辑类有效无「版本备注」字段。共享没有「评论」「仅看链接」等中间档嵌套共享被拒绝单个共享最多 100 成员。链接不支持期限 / 密码 / 访问次数上限刷新后旧链接立即失效。文件页内置搜索只匹配文件名与文件 ID不搜内容内容搜索需 Manticore 索引二进制文件压缩包 / 视频不参与。删除无前端回收站 UI普通用户无法自助恢复。相关文档延伸阅读文件入口详解上传文件操作共享与协作权限协作文件聚合视图公开访问链接文件预览类型 文件树结构 版本历史WebDAV 访问文件底层实现核心模型 File.php、FileContent.php、FileUser.php、FileLink.php分片上传 ChunkUpload.php接口控制器 FileController.php路由入口 routes.js赞分享后端前端协同办公即时通讯企业应用【免费下载链接】dootaskDooTask是一款开源在线项目任务管理工具提供各类文档协作工具、在线思维导图、在线流程图、项目管理、任务分发、即时IM文件管理等工具同时消息功能使用非对称加密技术让你的沟通更安全。项目地址https://gitcode.com/gh_mirrors/do/dootask点击查看免费下载相关推荐DooTask 新建任务入口全指南桌面端、移动端路径与快捷键详解DooTask 新建任务入口全指南桌面端、移动端路径与快捷键详解 DooTask 是一款开源在线项目任务管理工具其新建任务入口贯穿桌面端、移动端与快捷键后端前端协同办公即时通讯企业应用DooTask 个人设置入口全指南桌面端 / 移动端 / Electron 的进入路径与全部子页详解DooTask 个人设置入口全指南桌面端 / 移动端 / Electron 的进入路径与全部子页详解 「个人设置」是 DooTask 中每个用户管理自身资料、后端前端协同办公即时通讯企业应用DooTask 新建审批入口指南桌面端与移动端从应用中心到发起审批的完整路径DooTask 新建审批入口指南桌面端与移动端从应用中心到发起审批的完整路径 本篇技术指南以 DooTask 的「新建审批入口在哪」知识库条目 resour后端前端协同办公即时通讯企业应用上一篇SwiftUIX网络缓存终极指南如何使用URLProtocol实现高效请求缓存下一篇EeveeSpotify终极指南免费解锁Spotify Premium功能的完整教程创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
