用途：这是 Spuree 云存储的文件管理技能。Spuree 面向智能体设计，项目（creative_project）下可包含可嵌套的文件夹（session），文件可位于项目根或任意文件夹中。API 中项目与文件夹统称 session。搜索接口为跨项目全文检索，基于 Atlas 分析器而非子串匹配，返回按源对象分组的结果。
主要能力与用法：认证使用 Authorization: Bearer $SPUREE_ACCESS_TOKEN 或 X-API-Key: $SPUREE_API_KEY。基础地址为 https://data.spuree.com/api/v1/files（文件 CRUD）与 https://data.spuree.com/api/v1/search（跨项目搜索）。支持按名称搜索文件与文件夹、按 ID 获取文件及预签名下载 URL、读取小型文本文件内联内容、创建文件记录并获取预签名上传 URL、完成上传、更新元数据或内容、软删除文件。上传分单文件（<100 MB，单个 PUT URL）与分片（≥100 MB，每分片签名 URL）两种模式，需上传至 S3 后调用 /upload/complete 才算完成，否则文件保持 pending 不可用。支持校验和验证：请求可传 CRC32 base64，完成时服务端返回 S3 验证结果。内容更新使用乐观并发，需 expectedChecksum 与 newChecksum，获取上传锁（单文件 1 小时，分片 6 小时）；分片上传可查询已传分片并续传、刷新过期 URL、或中止上传。搜索支持按类型、searchIn、matchMode、格式、实体类型、workspace、project、创建时间与排序过滤，使用不透明游标分页，游标与查询和权限范围绑定，不可篡改或跨查询复用。
适用场景：智能体在 Spuree 项目中对文件进行检索、读写、整理和迁移；大文件分片上传与断点续传；需要内容冲突检测的更新流程。
限制：搜索为分析器分词匹配，不支持子串匹配；未签名的 v1 之前游标已不再接受（2026-09-07 后返回 422）；内联内容接口仅适用于小型文本类文件，二进制或过大文件返回 413/415，应改用 downloadUrl；层级信息须使用返回值中的 container、project、breadcrumb，不应从摘要推导。价格、配额等资料暂未提供。