# 文件关联、引用与临时读取

工作区普通上传创建file记录和存储对象，不自动关联卷；私有Catalog上传自动建立私有卷关联并将引用计数增加为1。列表读取卷关联位置，未关联文件不会因普通上传自动出现在位置列表。

上传先持久化元数据再写对象，私有卷发布还有后续事务。失败不保证前面步骤回滚，也没有本协议幂等请求键；不要把客户端超时当作完全没有创建。保留已返回标识并检查实际状态，清理由实际权限与引用计数决定。

DELETE工作区文件要求零引用，内置样例受保护；解除卷引用使用其已有接口。引用计数为正或并发清理失败可拒绝，成功以HTTP204及后续读取为准。外部文件清理只处理MOI元数据，不删除源连接器对象。

模型链接签发需配置BaseURL、密钥与TTL。url使用签名能力验证，不依赖外部调用者的产品身份；到期时间以expires_at为准。内容端将不可读、无效、过期、空文件统一为404。链接读取不表示已做模型推理。

预览与下载选择不同内容类型。HTML/HTM/SVG预览为附件，Office转换依赖配置；原始下载可只取前缀，其成功长度不能当原文件长度。
