upload-to-catbox

name	upload-to-catbox
description	上传本地图片到 catbox.moe 免费图床，获取公开访问的 URL 链接。当用户需要将本地图片转换为 URL、上传图片到图床、获取图片链接、提到 catbox、或进行图像编辑（如改背景、换脸等）但提供的是本地图片路径时使用此 skill。
triggers	["用户提供本地图片路径（以 / 开头或包含 .cursor/projects/）且需要进行图像处理","用户要求上传图片到图床","用户要求获取图片 URL","用户使用图像编辑模型（如 Seedream、Flux 等）但输入是本地文件"]

Catbox 图床上传

将本地图片上传到 catbox.moe 免费图床，获取永久 URL 链接。

自动触发条件

当以下情况发生时，必须自动触发此 skill：

1. 图像编辑任务 + 本地图片：用户要求编辑图片（换背景、改风格、修图等），但提供的是本地图片路径
2. AI 模型需要图片 URL：用户要使用需要图片 URL 的 AI 模型（如 Seedream、Flux、Sora 等），但输入是本地文件
3. 用户附加了图片：对话中包含 <image_files> 标签，里面有本地图片路径

识别本地图片路径

本地图片路径通常具有以下特征：

• 以 / 开头的绝对路径
• 包含 .cursor/projects/
• 包含 /Users/ 或 /home/
• 以 ./ 或 ../ 开头的相对路径
• 文件扩展名为 .png、.jpg、.jpeg、.gif、.webp

特点

• 免费、无需登录
• 支持直接二进制上传（无需 base64）
• 永久存储（不会自动删除）
• 支持格式：png, jpg, gif, webp 等

上传命令

curl -F'reqtype=fileupload' -F'fileToUpload=@/path/to/image.png' https://catbox.moe/user/api.php

返回值直接是图片 URL，例如：https://files.catbox.moe/abc123.png

使用流程

场景 1：直接上传请求

1. 获取用户提供的本地图片路径
2. 执行 curl 命令上传
3. 返回生成的 URL 给用户

场景 2：图像编辑任务（重要）

当用户请求图像编辑但提供本地图片时：

1. 先上传图片：执行 curl 命令上传本地图片到 catbox
2. 获取 URL：从返回结果获取图片 URL
3. 继续原任务：使用获取的 URL 调用图像编辑模型（如 Seedream）

示例：用户说「把这张图片的背景改成室内」，并附带了本地图片路径

# 步骤 1：上传图片
curl -F'reqtype=fileupload' -F'fileToUpload=@/Users/xxx/.cursor/projects/xxx/assets/image.png' https://catbox.moe/user/api.php
# 返回：https://files.catbox.moe/abc123.png

# 步骤 2：使用返回的 URL 调用图像编辑模型
# （调用 Seedream 等模型的 submit_task）

示例

示例 1：直接上传

用户请求：帮我上传 /tmp/screenshot.png 到图床

执行：

curl -F'reqtype=fileupload' -F'fileToUpload=@/tmp/screenshot.png' https://catbox.moe/user/api.php

返回：

https://files.catbox.moe/x7ppwg.png

示例 2：图像编辑 + 本地图片

用户请求：把这个图片的背景改成海边（附带本地图片路径）

执行流程：

1. 识别到本地图片路径，触发上传
2. 上传完成后获取 URL
3. 使用 URL 调用 Seedream edit 模型

# 1. 上传
IMAGE_URL=$(curl -F'reqtype=fileupload' -F'fileToUpload=@/path/to/local/image.png' https://catbox.moe/user/api.php)
echo "图片已上传: $IMAGE_URL"

# 2. 然后用这个 URL 调用图像编辑 API

注意事项

• 单个文件最大 200MB
• 上传可能需要几秒钟，请耐心等待
• 如果上传失败，可以重试
• 关键：上传成功后，使用返回的 URL 继续执行用户原本的图像处理任务