用途:列出 Lab Nocturne Images 账户中已上传的文件,支持分页和排序。可通过 /files 命令或自然语言触发,例如“list my images”“show my files”“what have I uploaded”。
主要能力:支持 limit(1-100,默认 100)、offset(默认 0)和 sort(uploaded_at_desc 默认、uploaded_at_asc、size_desc、size_asc)。自然语言可映射排序,如“newest first”对应 uploaded_at_desc,“largest first”对应 size_desc;请求“page N”时 offset 按 (N-1)*limit 计算。
使用方式:先解析选项,再解析 API key。检查 $LABNOCTURNE_API_KEY,若为空或未设置,可运行 curl -s https://images.labnocturne.com/key 自动生成测试 key,响应为 {"api_key": "ln_test_..."},并告知用户已生成临时测试 key。基础 URL 使用 $LABNOCTURNE_BASE_URL,否则默认 https://images.labnocturne.com。随后运行 curl -s -H "Authorization: Bearer <api_key>" "<base_url>/files?limit=<limit>&offset=<offset>&sort=<sort>" 获取列表。
结果展示:成功时响应包含 files 数组(id、url、filename、size、mime_type、uploaded_at)和 pagination(total、limit、offset、next)。向用户展示每个文件的 ID、文件名、人类可读大小、类型和相对上传时间,并显示“Showing X-Y of Z files”;若存在 pagination.next,提示如何查看下一页;列表为空则告知无上传文件。错误时响应包含 error.message、type、code,需展示错误信息并按 code 建议修复,如 missing_api_key 设置环境变量或生成测试 key,invalid_api_key 检查或取消设置以自动生成,invalid_auth_format 说明 key 应以 Bearer 传递且已自动处理。
适用场景:需要查看、分页浏览或按时间/大小排序 Lab Nocturne Images 账户中已上传文件的场景。
限制:资料未提供其他功能、收费、价格、平台或效果信息;具体可用性取决于 API key 和基础 URL 配置。