用途:把本地图片文件上传到 Lab Nocturne Images API,并返回可用的 CDN URL。触发方式为 /upload <path>,也可用自然语言(如“upload this screenshot”)触发。
主要能力:解析文件路径并校验文件存在与扩展名(仅支持 jpg、jpeg、png、gif、webp、svg);解析 API Key,若环境变量 $LABNOCTURNE_API_KEY 为空则自动调用 curl -s https://images.labnocturne.com/key 生成测试密钥(7 天文件保留、10MB 限制);解析基础 URL,默认 https://images.labnocturne.com;执行上传并处理响应。
使用方式:上传命令为 curl -s -X POST -F "file=@<resolved_path>" -H "Authorization: Bearer <api_key>" <base_url>/upload。成功返回 HTTP 201,响应含 id、url、size、mime_type、uploaded_at,需向用户展示 Image ID、CDN URL 和人类可读的大小。错误响应含 error.message、error.type、error.code,需按 code 给出修复建议,如 missing_api_key、invalid_api_key、file_size_exceeded、quota_exceeded、unsupported_file_type、upload_failed 等。
适用场景:需要快速把截图或图片转为 CDN 链接时使用。
限制:测试密钥文件保留 7 天、上限 10MB;正式密钥上限 100MB;仅支持上述图片格式;配额满时可用 curl -X DELETE <base_url>/i/<id> 删除旧文件。其他细节暂未提供。