文件柜
MICROI FILE CABINET · OBJECT STORAGE WORKSPACE
把对象存储，变成人人看得懂的文件工作台
吾码文件柜将租户的私有桶、公有桶、目录、文件预览、回收站与跨平台同步集中到一个界面。管理员不需要直接登录 MinIO、OSS 或 S3 控制台，也能完成日常文件治理。
入口与定位
登录吾码后台后，通过系统菜单进入 /#/mci-file-manage。源码内置组件路由为 /#/file-manage；实际项目应以管理员配置并授权的“文件柜”菜单为准。
一分钟认识文件柜
目录树、面包屑、网格 / 列表视图，让对象存储像桌面文件管理器一样直观。
按租户区分公有桶和私有桶，上传、移动、重命名、回收与恢复都有明确边界。
图片、PDF、音视频、文本代码和部分 CAD 文件可直接在线查看。
当前平台、远程吾码平台和 MinIO 之间可以按目录选择文件并保留同步记录。
文件柜服务于平台级文件治理。普通业务用户上传的附件仍应通过表单、业务记录和字段权限访问，不应为了“方便找文件”而直接开放整个文件柜。
公有桶与私有桶怎么选
文件柜左侧可随时切换桶类型。两类桶目录彼此独立，同步时还可以分别选择源桶和目标桶。
| 对比项 | 私有桶 | 公有桶 |
|---|---|---|
| 典型内容 | 合同、证件、内部文档、业务附件 | 官网图片、公开下载包、前端静态资源 |
| 访问方式 | 通过后端鉴权和短时访问地址读取 | 可由公开地址或 CDN 直接读取 |
| 管理建议 | 默认选择；按业务记录继续做权限控制 | 仅放确认可以公开传播的内容 |
| 主要风险 | 临时地址被转发、业务权限设计不完整 | 一旦公开就不能依赖“路径难猜”保护内容 |
公有桶不等于“已授权公开”
切换到公有桶只是改变存储访问范围，不会自动判断文件是否含个人信息、合同或商业秘密。敏感文件不要放入公有桶。
日常管理能力
目录导航
可调宽度目录树、懒加载展开、面包屑跳转和双击进入，深层目录也能快速定位。
上传与建目录
支持多文件上传与逐项进度；可在当前路径新建文件夹，并校验非法目录名称。
网格 / 列表视图
两种视图一键切换。网格图标大小可调，图片缩略图可按需开启或关闭。
搜索与排序
按文件名筛选；按名称、大小、类型、创建时间或更新时间升降序排列。
选择与批量操作
复选框和 Ctrl / Cmd 多选配合批量移动、删除、恢复，减少重复操作。
快捷菜单
文件、文件夹和空白区域均有右键菜单；常用动作也会直接出现在列表工具栏。
文件与文件夹操作表
| 操作 | 文件 | 文件夹 | 批量 | 说明 |
|---|---|---|---|---|
| 上传 | ✓ | — | ✓ | 多文件上传到当前目录，随后显示进度和结果。 |
| 新建文件夹 | — | ✓ | — | 可从顶部工具栏、目录树或空白区域创建。 |
| 打开 / 预览 | ✓ | ✓ | — | 双击文件夹进入；双击可预览类型打开预览窗口。 |
| 下载 | ✓ | — | — | 私有文件先获取短时地址，再由浏览器下载。 |
| 重命名 | ✓ | ✓ | — | 保留所在目录，仅更新对象名称。 |
| 移动 | ✓ | ✓ | ✓ | 选择目标目录后移动，路径始终限制在当前租户范围。 |
| 属性 | ✓ | ✓ | — | 查看名称、类型、大小、创建时间和更新时间。 |
| 删除到回收站 | ✓ | ✓ | ✓ | 默认是逻辑删除，不立即物理移除源对象。 |
| 从回收站恢复 | ✓ | ✓ | ✓ | 回到删除前路径；可单条或批量恢复。 |
文件很多时，列表会分段加载，底部显示当前已加载数量与总量。刷新按钮会重新读取当前目录；目录树右键也可直接上传、新建、刷新或从该目录发起同步。
在线预览矩阵
jpg、jpeg、png、gif、bmp、svg、webp、ico
pdf
mp4、webm、ogg；mp3、wav、flac、aac、m4a
txt、md、json、xml、csv、log、配置与常见源码文件
dwg、step、stp
DOCX、XLSX、PPTX、压缩包及未识别格式
显示文件信息并提供下载，不会伪装成已支持在线预览。CAD 预览有前置条件
DWG 需要同名的 _preview.dxf，STEP / STP 需要同名的 _preview.stl。转换链路、格式限制和生产验收方法见 3D、CAD 与数据大屏。
Office 在线编辑属于独立集成能力，不等同于文件柜的内置预览。需要 Word、Excel、PowerPoint 在线编辑时，请查看 Office 在线编辑。
回收站：给误操作留一次反悔机会
当前文件柜的“删除”采用逻辑回收流程，目的是降低误删风险；它不等于存储服务上的立即物理删除。需要执行保留期、彻底清理或合规销毁时，应另行建立经授权、可审计的后台策略。
跨平台文件同步
文件柜内置同步工作台，可把选定文件或文件夹从一个存储端迁移到另一个存储端。源端和目标端都能独立选择公有桶或私有桶。
组合兼容性
| 源端 → 目标端 | 是否支持 | 执行方式 |
|---|---|---|
| 当前平台 → 当前平台 | ✓ | 服务端对象同步，可跨公有 / 私有桶。 |
| 当前平台 ⇄ 远程吾码 | ✓ | 获取源文件短时地址，再上传到目标平台并落到目标目录。 |
| 当前平台 ⇄ MinIO 直连 | ✓ | 服务端 MinIO 同步；目标端可检查并创建缺失桶。 |
| MinIO 直连 → MinIO 直连 | ✓ | 服务端在受限根路径之间同步。 |
| 远程吾码 ⇄ MinIO 直连 | — | 当前不直接组合；请把吾码一侧改为“当前平台”后分步同步。 |
一次同步怎么完成
- 01选择源端与目标端
分别确定平台类型、公有 / 私有桶和连接信息。
- 02连接并加载目录树
远程吾码先登录并检查同步能力；MinIO 先测试连接。
- 03勾选源文件
文件和文件夹均可选择；选择父文件夹后会自动去重其子项。
- 04指定目标位置
在目标树中明确落点，原有无关文件保持不变。
- 05设置重名规则
选择“重名忽略”或“文件重名覆盖”。
- 06执行并核对记录
逐项更新进度；完成、忽略、失败和待同步都有明细。
远程连接与 MinIO 连接
REMOTE MICROI
远程吾码平台
- 自动读取远程登录配置，按需显示验证码并使用远端登录协议。
- 登录后先检查 `mci_file_sync_capability`，旧端能力不足时会明确提示升级。
- 支持选择、删除历史连接，也可主动退出当前远程登录。
- 远程 Token 失效时会终止本次操作并要求重新登录。
DIRECT MINIO
MinIO 直连
- 配置端点、访问帐号、SecretKey、可选 Region，以及公有 / 私有桶。
- 根路径必填，用于约束本次可见与可同步的对象范围。
- 连接测试通过后再加载文件树；目标端可创建缺失桶。
- 访问凭据只用于当前会话，不写入同步任务记录。
超大目录会分页读取并设防护上限：单次树构建最多展示前 10,000 个节点，超过时界面会提示截断。大规模迁移建议按业务目录拆成多次任务，而不是一次勾选整个存储桶。
同步记录与审计
同步配置旁的“同步记录”页签保存最近任务，任务归属发起同步的当前租户，不散落到源端或目标端。
| 记录层级 | 可查看内容 |
|---|---|
| 任务摘要 | 任务编号、源 / 目标类型、平台地址与租户、源 / 目标桶范围、冲突规则、开始结束时间。 |
| 进度统计 | 总数、成功数、失败数、已完成数和整体进度。 |
| 文件明细 | 文件名、源路径、目标路径、大小、结果和错误消息。 |
| 状态 | 任务：同步中、已完成、失败；条目：成功、忽略、待同步、失败。 |
同步按文件逐项执行。即使部分文件失败，已完成项和失败原因仍会写入明细，方便重试前核对；任务记录写入失败时，同步流程也会中止，避免出现“文件已经迁移但平台没有审计记录”的静默状态。
权限与安全边界
当前内置文件管理与同步接口会校验租户 Token，并拒绝普通用户及访问密钥会话。
目录、移动和同步路径限制在当前 OsClient 或显式 MinIO 根路径内，不能把任意服务器路径当作对象路径。
预览、下载和跨平台同步先由后端签发短时地址，不把对象存储长期凭据交给浏览器。
同步任务、冲突规则、进度、单文件结果和错误消息保存在当前租户的任务记录中。
更底层的存储后端、SaaS 配置、上传限制、私有文件 URL 与安全建议，请继续阅读 分布式存储。
当前版本边界
请按已实现能力验收
- 右键菜单中的“分享、复制、剪切”目前是预留交互入口，不应把提示消息当成已完成的权限分享或跨目录剪贴板能力。
- 文件柜不内置 DOCX、XLSX、PPTX 在线预览；这些格式默认下载，在线编辑走 Office 集成。
- 远程吾码与 MinIO 直连不能直接组合，需要以当前平台为中转分步执行。
- 树上限、网络带宽、浏览器内存、对象存储策略和目标平台版本都会影响一次同步规模。
管理员使用清单
- 确认当前租户已正确配置公有、私有存储及文件服务地址。
- 仅向平台超级管理员开放文件柜菜单，不用它替代业务表单的附件权限。
- 上传前先判断内容应进入私有桶还是公有桶。
- 大批量删除先进入回收站核对；物理清理另走受控流程。
- 跨平台同步先用少量文件验证登录、桶、根路径、目标目录和重名规则。
- 同步结束后同时核对目标文件、任务汇总和失败明细，不能只看进度条。