文件管理
菜单路径：资源管理 → 文件管理。 本章适用于 tkl-main 2.00.083 及配套前端；启用前由管理员确认前后端版本和数据库迁移已完成。文件管理权限编号为 1402。
文件管理用于保存模型、贴图、图片、视频和文档等资源。微应用保存代码和必要的小资源，应用配置通过文件 ID 引用大文件。普通文件与微应用文件分别计量。
上传和维护文件
- 进入文件管理，检查当前组织已用空间。
- 点击上传文件，选择文件；可填写别名、标签和备注，按实际需要设置共享。
- 点击开始上传。多选文件会逐个上传，检查每个文件的结果；部分失败时不要将整批视为成功。
- 在列表查看文件名、大小及共享状态，使用预览或下载检查内容。浏览器不支持的格式可下载后用对应软件打开。
- 编辑只修改别名、标签、备注。修改文件内容请使用替换文件。
| 限制 | 当前上限 |
|---|---|
| 单个普通文件 | 50 MiB |
| 当前组织全部普通文件合计 | 50 MiB |
界面可能显示 MB，实际按 1024 × 1024 字节计算。上传前通过 /thinklink/custom-file/quota 核对余量；资源超限时先压缩或减小规模。
替换内容并保留链接
- 在目标文件操作菜单选择替换文件。
- 选择新文件并确认。原内容会被替换，需要旧内容时请提前下载备份。
- 替换后检查预览及引用该文件的应用。
替换保留文件 ID、原文件名、别名、标签、备注、共享状态及共享码；已有有效链接读取新内容。配额按“已用总量 − 旧文件大小 + 新文件大小”核算。平台目前不提供用户可用的历史版本恢复。
应用应在替换后按 update_time 或自身资源版本使缓存失效，重新加载模型、贴图等内容；文件 ID 或链接不变不表示内容不变。
共享与私有访问
- 未共享文件由已登录且有权限的用户获取临时访问票据。票据有效期为 7200 秒，到期后需重新取得。
- 明确打开共享后，持有共享链接的人可匿名访问。仅对需要公开的资源开启共享。
- 关闭共享后，旧公开链接立即失效；再次开启会生成新共享码。读取当前链接时使用复制链接，不要重复调用开启共享来取链接。
- 关闭共享不会撤销此前已经签发且未过期的私有票据。
应用配置持久保存文件 ID，不保存会过期的临时 URL；权限或共享状态变化后，加载失败应显示不可访问状态。
在微应用中使用文件 API
以下路径均以 /thinklink/custom-file 为前缀，使用当前组织的认证上下文。
| 方法与路径 | 用途与请求 |
|---|---|
POST /quota、/find-page | 查询配额和分页列表 |
POST /upload | multipart file；可带 alias、JSON 数组字符串 tags、remark、shared |
POST /replace | multipart id 和 file，更新内容并保留身份 |
POST /batch-save-update | {dataList:[{id,alias?,tags?,remark?}]}，只更新元数据 |
POST /change-share | {id,shared:boolean}，改变共享状态 |
POST /access-ticket | {id}，返回 ticket、expires_in |
GET /v/:ticket | 使用有效票据取得文件流 |
POST /download | {id}，下载文件流 |
POST /batch-delete-by-ids | {ids:[...]}，删除选中文件 |
推荐顺序：查询配额 → 上传并保存文件 ID → 使用时获取访问票据 → 加载资源。不要使用对象存储路径自行拼接公开 URL。按场景和可见对象加载并复用资源；告警或在线状态刷新时不重新下载模型。离开场景后释放不再使用的资源与 Blob URL。详见微应用按需读取与资源加载。
删除和失败处理
删除前核对引用该文件的应用，备份仍需保留的内容。删除接口报错可能发生在数据库记录已删除、对象存储清理失败之后；重新查询文件列表和错误阶段，再决定后续处理，不能直接报告“未删除”或“全部清理成功”。