用途:该技能用于管理 Spuree 云存储中的顶层容器「项目」,适合智能体需要列出、创建、重命名、删除、共享或浏览项目时调用。
认证与基址:使用 Authorization: Bearer $SPUREE_ACCESS_TOKEN 或 X-API-Key: $SPUREE_API_KEY,基址为 https://data.spuree.com/api/v1/projects。
主要能力:GET /v1/projects 列出可访问项目(按名称排序,支持 sortOrder、limit、offset;无 sortBy,按更新时间排序需客户端在 updatedAt 上排序并拉取全部页);POST /v1/projects 创建项目(name 与 workspaceId 必填,可选 description、sharedWith);PATCH /v1/projects/{projectId} 重命名;DELETE 软删除;GET /v1/projects/{projectId}/children 浏览项目直接内容,返回统一的 items 数组,含 session(文件夹)、entity(资产)、file 三类,可继续通过 folder-management 深入;POST /share 共享(工作区成员直接添加,非成员则生成 7 天邀请);DELETE /share/{email} 取消共享(仅所有者);GET /share 查看共享信息;POST /leave 退出他人共享的项目(所有者不能退出)。
限制与注意:项目名为 Windows 文件系统兼容,ID 为 24 位十六进制;400 无效名称或 ID,401 令牌失效,403 非工作区成员或非所有者,409 名称冲突或重复共享。列表分页默认 500、上限 1000;children 默认 100、上限 500。
分类:属于办公与效率场景。