Title: 文件柜 Canonical: https://microi.net/doc/system-engine/file-manage.html Page-Modified: 2026-10-12T10:49:46.000Z Source: published HTML document body; page revision is not a capability verification date. # 文件柜 MICROI FILE CABINET · OBJECT STORAGE WORKSPACE ## 把对象存储，变成人人看得懂的文件工作台 吾码文件柜将租户的私有桶、公有桶、目录、文件预览、回收站与跨平台同步集中到一个界面。管理员不需要直接登录 MinIO、OSS 或 S3 控制台，也能完成日常文件治理。 查看管理能力 (https://microi.net/doc/system-engine/file-manage.html#%E6%97%A5%E5%B8%B8%E7%AE%A1%E7%90%86%E8%83%BD%E5%8A%9B)了解文件同步 (https://microi.net/doc/system-engine/file-manage.html#%E8%B7%A8%E5%B9%B3%E5%8F%B0%E6%96%87%E4%BB%B6%E5%90%8C%E6%AD%A5) 私有 / 公有桶多格式预览逻辑回收站同步审计 文件柜私有桶 ▾ 上传新建文件夹同步搜索文件 全部文件　/　项目资料 ▰设计稿文件夹 PDF项目方案.pdf2.8 MB IMG首页效果图.png1.4 MB 3D设备模型.step18 MB ## 📸 预览图 [Microi吾码文件柜文件同步弹窗，展示源与目标文件系统、桶类型、路径和双侧文件树: https://file.microi.net/itdos/official-docs/images/0559d12ec7b6a679d7fee17492e8587da04f92d4c9e507f23715927370851267/202610/file-manage-sync-dialog.jpg] 文件同步：在当前平台、远程平台或 MinIO 之间选择源与目标，并按文件树执行可审计同步。 入口与定位 登录吾码后台后，通过系统菜单进入 /#/mci-file-manage。源码内置组件路由为 /#/file-manage；实际项目应以管理员配置并授权的“文件柜”菜单为准。 ## 一分钟认识文件柜 01看得见 目录树、面包屑、网格 / 列表视图，让对象存储像桌面文件管理器一样直观。 02管得住 按租户区分公有桶和私有桶，上传、移动、重命名、回收与恢复都有明确边界。 03预览快 图片、PDF、音视频、文本代码和部分 CAD 文件可直接在线查看。 04迁得动 当前平台、远程吾码平台和 MinIO 之间可以按目录选择文件并保留同步记录。 文件柜服务于平台级文件治理。普通业务用户上传的附件仍应通过表单、业务记录和字段权限访问，不应为了“方便找文件”而直接开放整个文件柜。 ## 公有桶与私有桶怎么选 文件柜左侧可随时切换桶类型。两类桶目录彼此独立，同步时还可以分别选择源桶和目标桶。 对比项 | 私有桶 | 公有桶 | 典型内容 | 合同、证件、内部文档、业务附件 | 官网图片、公开下载包、前端静态资源 | 访问方式 | 通过后端鉴权和短时访问地址读取 | 可由公开地址或 CDN 直接读取 | 管理建议 | 默认选择；按业务记录继续做权限控制 | 仅放确认可以公开传播的内容 | 主要风险 | 临时地址被转发、业务权限设计不完整 | 一旦公开就不能依赖“路径难猜”保护内容 | 公有桶不等于“已授权公开” 切换到公有桶只是改变存储访问范围，不会自动判断文件是否含个人信息、合同或商业秘密。敏感文件不要放入公有桶。 ## 日常管理能力 ⌘ ### 目录导航 可调宽度目录树、懒加载展开、面包屑跳转和双击进入，深层目录也能快速定位。 ⇧ ### 上传与建目录 支持多文件上传与逐项进度；可在当前路径新建文件夹，并校验非法目录名称。 ▦ ### 网格 / 列表视图 两种视图一键切换。网格图标大小可调，图片缩略图可按需开启或关闭。 ⌕ ### 搜索与排序 按文件名筛选；按名称、大小、类型、创建时间或更新时间升降序排列。 ✓ ### 选择与批量操作 复选框和 Ctrl / Cmd 多选配合批量移动、删除、恢复，减少重复操作。 ⋯ ### 快捷菜单 文件、文件夹和空白区域均有右键菜单；常用动作也会直接出现在列表工具栏。 ### 文件与文件夹操作表 操作 | 文件 | 文件夹 | 批量 | 说明 | 上传 | ✓ | — | ✓ | 多文件上传到当前目录，随后显示进度和结果。 | 新建文件夹 | — | ✓ | — | 可从顶部工具栏、目录树或空白区域创建。 | 打开 / 预览 | ✓ | ✓ | — | 双击文件夹进入；Office 文件打开在线编辑与版本页，其它可预览类型打开预览窗口。 | 下载 | ✓ | — | — | 私有文件先获取短时地址，再由浏览器下载。 | 重命名 | ✓ | ✓ | — | 保留所在目录，仅更新对象名称。 | 移动 | ✓ | ✓ | ✓ | 选择目标目录后移动，路径始终限制在当前租户范围。 | 属性 | ✓ | ✓ | — | 查看名称、类型、大小、创建时间和更新时间。 | 删除到回收站 | ✓ | ✓ | ✓ | 默认是逻辑删除，不立即物理移除源对象。 | 从回收站恢复 | ✓ | ✓ | ✓ | 回到删除前路径；可单条或批量恢复。 | 文件很多时，列表会分段加载，底部显示当前已加载数量与总量。刷新按钮会重新读取当前目录；目录树右键也可直接上传、新建、刷新或从该目录发起同步。 ## 在线预览矩阵 IMAGE图片 jpg、jpeg、png、gif、bmp、svg、webp、ico 适配容器显示，可放大查看并下载原文件。 PDFPDF 文档 pdf 在文件柜弹窗内嵌浏览器 PDF 阅读器。 MEDIA音视频 mp4、webm、ogg；mp3、wav、flac、aac、m4a 使用浏览器原生播放控件，实际解码能力取决于浏览器。 TEXT文本与代码 txt、md、json、xml、log、配置与常见源码文件 只读显示文本内容，不会在预览中执行脚本。 CADCAD / 3D dwg、step、stp 读取同目录转换得到的 DXF / STL 预览文件，支持缩放、重置、旋转 / 俯视和全屏。 OFFICEOffice 文档 doc/docx、xls/xlsx、ppt/pptx、csv 使用已配置的 OnlyOffice 在线编辑；手动保存生成历史版本。 FILE其他格式 压缩包及未识别格式 显示文件信息并提供下载，不会伪装成已支持在线预览。 CAD 预览有前置条件 DWG 需要同名的 _preview.dxf，STEP / STP 需要同名的 _preview.stl。转换链路、格式限制和生产验收方法见 3D、CAD 与数据大屏 (https://microi.net/doc/system-engine/visualization-engine.html)。 Office 在线编辑依赖当前租户配置的 OnlyOffice Docs 服务。文件柜的私有桶、公有桶均支持打开与手动版本管理；历史版本只读，最新版本可编辑。查看配置、权限和版本存储规则请阅读 Office 在线编辑 (https://microi.net/doc/more/office.html)。 ## 回收站：给误操作留一次反悔机会 1选择对象单个文件、文件夹或批量选择 2删除到回收站记录原路径并从正常列表隐藏 3查看回收站集中核对已删除对象 4恢复单条或批量回到原路径 当前文件柜的“删除”采用逻辑回收流程，目的是降低误删风险；它不等于存储服务上的立即物理删除。需要执行保留期、彻底清理或合规销毁时，应另行建立经授权、可审计的后台策略。 ## 跨平台文件同步 文件柜内置同步工作台，可把选定文件或文件夹从一个存储端迁移到另一个存储端。源端和目标端都能独立选择公有桶或私有桶。 当前平台本次登录的吾码租户复用当前 Token、OsClient 和 SaaS 存储配置 远程吾码另一套吾码平台 / 租户输入 ApiBase、OsClient、帐号密码并完成动态登录 MinIO 直连指定对象存储端点配置 Endpoint、AccessKey、SecretKey、桶和根路径 ### 组合兼容性 源端 → 目标端 | 是否支持 | 执行方式 | 当前平台 → 当前平台 | ✓ | 服务端对象同步，可跨公有 / 私有桶。 | 当前平台 ⇄ 远程吾码 | ✓ | 获取源文件短时地址，再上传到目标平台并落到目标目录。 | 当前平台 ⇄ MinIO 直连 | ✓ | 服务端 MinIO 同步；目标端可检查并创建缺失桶。 | MinIO 直连 → MinIO 直连 | ✓ | 服务端在受限根路径之间同步。 | 远程吾码 ⇄ MinIO 直连 | — | 当前不直接组合；请把吾码一侧改为“当前平台”后分步同步。 | ### 一次同步怎么完成 - 01 选择源端与目标端 分别确定平台类型、公有 / 私有桶和连接信息。 - 02 连接并加载目录树 远程吾码先登录并检查同步能力；MinIO 先测试连接。 - 03 勾选源文件 文件和文件夹均可选择；选择父文件夹后会自动去重其子项。 - 04 指定目标位置 在目标树中明确落点，原有无关文件保持不变。 - 05 设置重名规则 选择“重名忽略”或“文件重名覆盖”。 - 06 执行并核对记录 逐项更新进度；完成、忽略、失败和待同步都有明细。 ### 远程连接与 MinIO 连接 REMOTE MICROI ### 远程吾码平台 - 自动读取远程登录配置，按需显示验证码并使用远端登录协议。 - 登录后先检查 `mci_file_sync_capability`；探针按目标租户实时回查文件柜菜单并返回 `FileManagerSysMenuId`，旧端能力不足或菜单不明确时会失败关闭并提示升级。 - 支持选择、删除历史连接，也可主动退出当前远程登录。 - 远程 Token 失效时会终止本次操作并要求重新登录。 DIRECT MINIO ### MinIO 直连 - 配置端点、访问帐号、SecretKey、可选 Region，以及公有 / 私有桶。 - 根路径必填，用于约束本次可见与可同步的对象范围。 - 连接测试通过后再加载文件树；目标端可创建缺失桶。 - 访问凭据只用于当前会话，不写入同步任务记录。 远程私有对象不会直接复用列表里的存储路径作为可访问 URL。客户端以 ResourceKind=FileManagerObject 提交能力探针返回的 SysMenuId，后端再次校验平台超级管理员 DiyToken、权威文件柜组件、租户根目录、大小写精确对象 Key 与对象存在性后，才签发短效代理地址。普通用户、访问密钥、硬编码其它租户菜单、前缀相似路径以及不存在的对象都会被拒绝。 超大目录会分页读取并设防护上限：单次树构建最多展示前 10,000 个节点，超过时界面会提示截断。大规模迁移建议按业务目录拆成多次任务，而不是一次勾选整个存储桶。 ## 同步记录与审计 同步配置旁的“同步记录”页签保存最近任务，任务归属发起同步的当前租户，不散落到源端或目标端。 记录层级 | 可查看内容 | 任务摘要 | 任务编号、源 / 目标类型、平台地址与租户、源 / 目标桶范围、冲突规则、开始结束时间。 | 进度统计 | 总数、成功数、失败数、已完成数和整体进度。 | 文件明细 | 文件名、源路径、目标路径、大小、结果和错误消息。 | 状态 | 任务：同步中、已完成、失败；条目：成功、忽略、待同步、失败。 | 同步按文件逐项执行。即使部分文件失败，已完成项和失败原因仍会写入明细，方便重试前核对；任务记录写入失败时，同步流程也会中止，避免出现“文件已经迁移但平台没有审计记录”的静默状态。 ## 权限与安全边界 ADMIN仅平台超级管理员 当前内置文件管理与同步接口会校验租户 Token，并拒绝普通用户及访问密钥会话。 TENANT路径按租户隔离 目录、移动和同步路径限制在当前 OsClient 或显式 MinIO 根路径内，不能把任意服务器路径当作对象路径。 URL私有地址短时有效 预览、下载和跨平台同步先由后端签发短时地址，不把对象存储长期凭据交给浏览器。 AUDIT任务与明细留痕 同步任务、冲突规则、进度、单文件结果和错误消息保存在当前租户的任务记录中。 更底层的存储后端、SaaS 配置、上传限制、私有文件 URL 与安全建议，请继续阅读 分布式存储 (https://microi.net/doc/more/hdfs.html)。 ## 当前版本边界 请按已实现能力验收 - 右键菜单中的“分享、复制、剪切”目前是预留交互入口，不应把提示消息当成已完成的权限分享或跨目录剪贴板能力。 - Word、Excel、PowerPoint、CSV 在线编辑要求 OnlyOffice Docs 服务可用，并且文档服务能访问平台的文件地址；只安装前端 npm 包不能替代该服务。 - Office 历史版本随单个文件的移动、重命名处理；整文件夹操作和跨平台同步不会自动迁移子文件的版本索引与私有历史快照。 - 远程吾码与 MinIO 直连不能直接组合，需要以当前平台为中转分步执行。 - 树上限、网络带宽、浏览器内存、对象存储策略和目标平台版本都会影响一次同步规模。 ## 管理员使用清单 - 确认当前租户已正确配置公有、私有存储及文件服务地址。 - 仅向平台超级管理员开放文件柜菜单，不用它替代业务表单的附件权限。 - 上传前先判断内容应进入私有桶还是公有桶。 - 大批量删除先进入回收站核对；物理清理另走受控流程。 - 跨平台同步先用少量文件验证登录、桶、根路径、目标目录和重名规则。 - 同步结束后同时核对目标文件、任务汇总和失败明细，不能只看进度条。