Supabase Upload

Supabase Upload Skill

使用 Supabase Storage 上传文件，获取公开访问 URL。

快速开始

环境配置

在项目根目录 .env 文件中添加：

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-anon-or-service-key
SUPABASE_BUCKET=uploads  # 可选，默认 uploads

上传文件

cd .claude/skills/supabase-upload
uv run python scripts/upload.py upload /path/to/image.png

只输出 URL：

uv run python scripts/upload.py upload /path/to/image.png --url-only

指定文件夹：

uv run python scripts/upload.py upload /path/to/image.png --folder images

列出文件

uv run python scripts/upload.py list --folder images

删除文件

uv run python scripts/upload.py delete images/filename.png

命令行参数

upload

list

delete

Python API

from supabase_client import upload_file, upload_base64, delete_file, list_files

# 上传本地文件
url = upload_file("/path/to/image.png", folder="images")
print(f"Uploaded: {url}")

# 上传 Base64 数据
url = upload_base64(base64_data, content_type="image/png", folder="images")
print(f"Uploaded: {url}")

# 删除文件
delete_file("images/filename.png")

# 列出文件
files = list_files("images")
for f in files:
    print(f["name"])

与 digital-human 配合使用

上传图片和音频到 Supabase，获取 URL 后用于数字人视频生成：

# 上传图片
IMAGE_URL=$(uv run python .claude/skills/supabase-upload/scripts/upload.py upload avatar.png --url-only)

# 上传音频
AUDIO_URL=$(uv run python .claude/skills/supabase-upload/scripts/upload.py upload speech.mp3 --url-only)

# 生成数字人视频
uv run python .claude/skills/digital-human/scripts/digital_human.py \
  --image-url "$IMAGE_URL" \
  --audio-url "$AUDIO_URL"

Supabase 配置说明

创建 Storage Bucket

1. 登录 Supabase Dashboard
2. 进入 Storage 页面
3. 创建新 Bucket（如 uploads）
4. 设置为 Public（公开访问）

获取 API Key

1. 进入 Project Settings > API
2. 复制 anon 或 service_role key
3. 复制 Project URL

错误处理