qiniu-object-storage

by showtimewalker

Install this Skill

curl -fsSL -o qiniu-object-storage.zip https://skill.seembox.com/api/v1/skills/qiniu-object-storage/download && unzip qiniu-object-storage.zip

Download qiniu-object-storage.zip

SKILL.md About

---
name: qiniu_object_storage
description: 上传本地文件到七牛对象存储，返回可交付的下载链接。当用户提到"上传""七牛""对象存储""OSS""交付链接""公网链接""签名链接"时引用；当已有本地文件需要上传并获得可访问的 URL 时引用；当工作流完成内容生成后进入交付阶段时引用。自动按扩展名判定文件类型，私有空间返回签名链接，公开空间返回公网链接。
metadata:
  openclaw:
    requires:
      bins:
        - uv
      anyBins:
        - python
        - python3
        - py
      env:
        - QINIU_ACCESS_KEY
        - QINIU_SECRET_KEY
        - QINIU_BUCKET
        - QINIU_PUBLIC_DOMAIN
        - QINIU_IS_PRIVATE
    primaryEnv: QINIU_ACCESS_KEY
---

# 七牛对象存储

这个 skill 只负责文件上传与交付链接，不负责图片或视频生成。

适用场景：

- 已有本地文件，需要上传到七牛
- 需要返回一个可直接交付的下载链接
- 私有空间需要带时效签名链接

## 默认行为

- 对象 key 自动生成为 `日期/类型/文件名`，如 `20260327/images/photo.png`
- 类型按扩展名自动判定：images / videos / audio / others
- 如果配置里声明空间是私有的，上传后默认返回签名链接
- 如果配置里声明空间是公开的，上传后默认返回公网链接
- 只有用户明确要求，或脚本显式传 `--private-url` / `--public-url` 时，才覆盖默认行为

## 使用脚本

脚本位于 skill 目录内的 `scripts/`，运行时始终使用绝对路径。

设 `QINIU_SKILL_DIR` 为 `.claude/skills/qiniu_object_storage` 的绝对路径：

- 上传文件并按空间配置返回默认交付链接：`uv run --python python $QINIU_SKILL_DIR/scripts/upload_file.py --file <本地文件>`
- 强制返回私有签名链接：`uv run --python python $QINIU_SKILL_DIR/scripts/upload_file.py --file <本地文件> --private-url --expires-in 600`
- 强制返回公网链接：`uv run --python python $QINIU_SKILL_DIR/scripts/upload_file.py --file <本地文件> --public-url`
- 已有对象 key，生成私有签名链接：`uv run --python python $QINIU_SKILL_DIR/scripts/generate_private_download_url.py --key <对象key> --expires-in 600`

## 输出约定

- 输出 JSON 至少包含：
  - `storage_provider`
  - `bucket`
  - `object_key`
  - `access_mode`
  - `delivery_url`
- 可能额外包含：
  - `public_url`
  - `private_url`
  - `base_url`
  - `expires_in`

## 配置

仅通过环境变量配置，缺失时抛出异常：

| 环境变量 | 说明 |
|---|---|
| `QINIU_ACCESS_KEY` | 七牛 Access Key（主标识） |
| `QINIU_SECRET_KEY` | 七牛 Secret Key |
| `QINIU_BUCKET` | 存储空间名称 |
| `QINIU_PUBLIC_DOMAIN` | 公网访问域名 |
| `QINIU_IS_PRIVATE` | 是否为私有空间（可选，默认 false） |

## 协作方式

- 它通常是图片或视频 workflow 的交付步骤
- 当用户只要求上传已有文件时，也可以单独调用
- 它不应决定前置内容由哪个 AI 供应商生成

_meta.json Metadata

{
  "ownerId": "kn730ch14gb1v4ab6865m2hts982vh51",
  "publishedAt": 1775311714149,
  "slug": "qiniu-object-storage",
  "version": "1.0.0"
}