用途:为项目提供文件存储,支持上传、下载、删除与获取公开访问地址,可用于头像、文档、图片等场景。
主要能力:SDK 提供 upload、download、remove;上传可传 onProgress 回调跟踪百分比,返回 publicUrl;download 返回 downloadUrl 与 filename,可自定义文件名;remove 支持一次删除多个文件。SDK 会根据内容自动识别文件类型并修正扩展名。上传为仅新增,重复路径返回 409,需用时间戳或随机 ID 保证唯一。上传后的文件返回直接 HTTPS 地址,格式为 https://storage.googleapis.com/{project}/uploads/{filename}.{ext},公开可访问且带扩展名,适合作为 AI 视觉输入的图片 URL。
MCP 工具:blink_storage_list 按可选路径前缀列出文件;blink_storage_url 获取已存文件的公开 CDN URL;blink_storage_delete 删除文件。
CLI 用法:blink storage upload ./photo.jpg --path uploads/photo.jpg 上传;blink storage list 列出文件;blink storage list uploads/ 列出指定路径下的文件。
鉴权要求:upload() 无需鉴权,为公开仅新增(不可覆盖);download() 需要鉴权,使用签名 URL;remove() 需要鉴权,要求 JWT。
常见错误与处理:409 conflict 表示路径已存在,需加时间戳或随机 ID;Invalid path 由特殊字符导致,可用 path.replace(/[^a-zA-Z0-9_-/.]/g, '_') 清理;File too large 表示超出限制,需压缩或拆分文件。
限制:资料未提供具体文件大小上限、存储配额、价格与平台支持范围,暂未提供。