文件存储
功能概述
文件存储为每个项目提供文件管理能力，支持上传、下载、预览和删除文件。文件可以按文件夹组织，支持栅格和列表两种视图模式。上传文件时还可以关联知识库标签，自动触发向量化处理。
界面说明
侧边栏 — 文件夹树
顶部操作栏：
- 上传文件按钮：打开文件上传弹窗
- 新建文件夹按钮：在根目录创建文件夹
文件夹导航：
- 全部文件入口：点击返回根目录
- 文件夹树：展示项目的文件夹层级结构
- 系统文件夹（如
_run）带有特殊标识，不可重命名和删除，排序在最前面 - 虚拟磁盘文件夹会显示为
_disks::{diskId}的系统子节点，并使用磁盘名称作为展示名；它同时也是当前Workspace compatibility layer在 Storage 中的映射 - 支持拖拽排序和重命名
主区域 — 文件浏览
顶部操作栏：
- 面包屑导航：显示当前文件夹路径，点击路径中任一层级可快速跳转
- 上传文件按钮：上传文件到当前文件夹
- 新建文件夹按钮：在当前文件夹下创建子文件夹
- 视图切换：在栅格视图和列表视图之间切换
栅格视图：
- 文件夹以大图标 + 名称的形式展示
- 文件显示类型图标、名称和文件大小
- 点击文件夹进入该文件夹，点击文件打开预览
列表视图：
- 以数据表格形式展示，包含名称、类型、大小、修改时间和操作列
- 双击文件夹进入，点击文件操作按钮预览或下载
右键菜单：
- 文件夹：重命名、删除
- 文件：预览、下载、删除
文件预览弹窗
- 图片文件：显示图片预览（自动生成缩略图），支持查看原图
- 其他文件：显示文件名、类型、大小、上传时间等基本信息
- 底部提供下载按钮
上传弹窗
- 支持拖拽上传和点击选择文件
- 最多同时上传 10 个文件
- 文件大小限制根据订阅计划而定
- 可选择知识库标签，上传的文件将自动进行向量化处理
操作步骤
上传文件
- 点击 上传文件 按钮打开上传弹窗
- 拖拽文件到上传区域，或点击区域选择文件
- （可选）在底部选择知识库标签，上传的文件会自动向量化
- 文件上传成功后自动刷新文件列表
创建文件夹
- 点击 新建文件夹 按钮
- 在文件夹树或主区域中出现新文件夹
- 输入文件夹名称并确认
预览文件
- 在栅格视图中点击文件，或在列表视图中点击预览按钮
- 弹出预览窗口
- 图片文件可查看缩略图和原图
- 点击 下载 按钮可下载文件
下载文件
- 找到目标文件
- 右键选择「下载」，或在预览窗口中点击下载按钮
- 文件通过签名 URL 下载到本地
删除文件或文件夹
- 右键目标文件或文件夹，选择「删除」
- 在确认对话框中确认操作
- 注意：系统文件夹无法删除
浏览虚拟磁盘
- 在 Assets 页创建或绑定虚拟磁盘
- 从 Assets 点击磁盘，跳转到 Storage 中对应文件夹
- 如果磁盘正被运行中的资产占用，Storage 里仍可查看文件，但上传、重命名、删除等写操作会被禁用
当前写保护判断已统一收敛到
workspace lock语义，而不是仅按“selfhosted 磁盘”做硬编码判断。
切换视图模式
- 点击顶部操作栏右侧的视图切换按钮
- 栅格图标切换到网格视图，列表图标切换到列表视图
相关链接
阶段三（E+F）更新（2026-04-18）
Workspace 只读反馈
进入已被资产占用的 _disks::<id> 文件夹时，顶部会出现 warning alert：
当前工作区被资产「XXX」占用，暂为只读
右侧"前往占用资产"按钮会跳转到 Assets 页并自动选中占用资产、定位到 Workspace Tab（URL 约定 ?asset=<id>&tab=disk）。
侧栏 Lock 图标
侧栏文件夹树对已锁定的工作区节点会展示 Lock 图标（代替默认 HardDrive 图标），便于快速识别占用态。
写操作仍然被禁
锁定状态下上传 / 创建文件夹 / 重命名 / 删除等写操作均会被禁用，由统一 workspace lock 语义驱动（阶段二引入）。