К основному содержанию
скилл CX Codex

tencentcloud-cos — скилл для Claude Code: установка

Скилл для Claude Code управляет бакетами и объектами Tencent Cloud COS: загружает, скачивает, копирует и удаляет файлы. Выполняет задачи объектного хранилища из агента.

Apache-2.0 232 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill tencentcloud-cos -a claude-code
Открыть на GitHub

Что делает tencentcloud-cos

tencentcloud-cos работает с Tencent Cloud COS через официальный cos-python-sdk-v5. Скилл умеет перечислять бакеты и объекты с фильтрацией по префиксу, загружать и скачивать файлы, получать pre-signed URL, считать размер бакета или префикса, копировать объекты и удалять их по одному или пачкой.

Внутри есть CLI scripts/cos.py с подкомандами buckets, ls, upload, download, url, du, cp, batch-delete и info. Для подключения нужны TENCENTCLOUD_SECRET_ID, TENCENTCLOUD_SECRET_KEY и TENCENTCLOUD_REGION, а также пакет cos-python-sdk-v5. Имя бакета передаётся в полной форме с суффиксом -<APPID>.

Пачечное удаление сначала можно запустить с --dry-run, а затем подтвердить отдельно. Pre-signed URL даёт доступ к объекту до истечения срока, поэтому срок действия стоит задавать осознанно. Без переменных Tencent Cloud и установленного SDK клиент не подключится.

Какие задачи решает

  • перечислить бакеты Tencent Cloud COS
  • найти объекты по префиксу
  • загрузить или скачать файл
  • создать временную ссылку на объект
  • посчитать размер префикса и удалить его содержимое

Примеры запросов агенту

  • Покажи все бакеты Tencent Cloud COS и их регионы.
  • Загрузи ./report.pdf в бакет mydata-1250000000 под ключом docs/report.pdf.
  • Сначала проверь через --dry-run, какие объекты с префиксом temp/old/ будут удалены.

Как установить tencentcloud-cos

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill tencentcloud-cos -a claude-code

2Вручную: положить файлы

~/.claude/skills/tencentcloud-cos/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/tencentcloud-cos/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о tencentcloud-cos

Как установить tencentcloud-cos в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill tencentcloud-cos -a claude-code, затем проверьте файл ~/.claude/skills/tencentcloud-cos/SKILL.md.

Что делает tencentcloud-cos?

Скилл управляет бакетами и объектами Tencent Cloud COS: листит содержимое, загружает и скачивает файлы, создаёт pre-signed URL, считает размер, копирует и удаляет объекты.

Что нужно для работы с Tencent Cloud COS?

Нужны пакет cos-python-sdk-v5 и переменные TENCENTCLOUD_SECRET_ID, TENCENTCLOUD_SECRET_KEY, TENCENTCLOUD_REGION. Бакет указывается с полным суффиксом -<APPID>.

Исходный текст

SKILL.md · Apache-2.0
---
name: tencentcloud-cos
description: |
  Manage Tencent Cloud COS (Cloud Object Storage) buckets and objects.
  Use whenever the user asks about COS / 对象存储 / Tencent Cloud bucket
  operations: list buckets, list objects, upload, download, delete,
  pre-signed URLs, calculate bucket size (du), batch delete with prefix,
  copy objects between keys. Backed by the official cos-python-sdk-v5.
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.0"
connections: [tencentcloud]
---

# Tencent Cloud COS (Object Storage)

Manage Tencent Cloud COS buckets and objects via the official `cos-python-sdk-v5` client.

> **Setup:** See [tencentcloud authentication](../_shared/tencentcloud.md) for SecretId / SecretKey / region setup. The SDK reads `TENCENTCLOUD_SECRET_ID` / `TENCENTCLOUD_SECRET_KEY` / `TENCENTCLOUD_REGION` from the environment.

## CLI (preferred)

The skill ships [`scripts/cos.py`](scripts/cos.py) — a self-contained CLI that wraps every COS operation below. **Prefer this over hand-rolled SDK calls** when the user's request maps cleanly onto one of its subcommands; it's what the maintained code paths exercise.

```bash
# $SKILL_DIR can point at another skill loaded this turn — anchor on our own
# script (re-run this at the top of every fresh-shell Bash block).
COS="$SKILL_DIR/scripts/cos.py"; [ -f "$COS" ] || COS=$(find /tmp -maxdepth 8 -path '*/skills/*/scripts/cos.py' 2>/dev/null | head -1)
[ -f "$COS" ] || { echo "tencentcloud-cos script not found (SKILL_DIR=$SKILL_DIR)" >&2; exit 1; }

python3 $COS buckets                                  # list all buckets
python3 $COS ls mydata-1250000000 --prefix images/    # list objects
python3 $COS upload mydata-1250000000 ./report.pdf --key docs/report-2026.pdf
python3 $COS download mydata-1250000000 docs/report-2026.pdf --output ./out.pdf
python3 $COS url mydata-1250000000 docs/report-2026.pdf --expires 3600
python3 $COS du mydata-1250000000 --prefix logs/
python3 $COS cp mydata-1250000000 old/path.txt new/path.txt
python3 $COS batch-delete mydata-1250000000 --prefix temp/old/ --dry-run
python3 $COS batch-delete mydata-1250000000 --prefix temp/old/   # actually delete
python3 $COS info mydata-1250000000 docs/report-2026.pdf
```

Run `python3 $COS --help` (or `python3 $COS <cmd> --help`) for full flags. Pass `--region <region>` to override per-call.

## When to Use

- List COS buckets across the account
- List objects in a bucket (with prefix / delimiter filtering)
- Upload / download files
- Delete a single object or batch-delete by prefix
- Generate pre-signed download URLs (private bucket sharing)
- Calculate bucket / prefix storage usage
- Copy objects within a bucket

## Dependencies

```bash
pip install cos-python-sdk-v5
```

## Bucket naming

Tencent Cloud bucket names always end in `-<APPID>`, e.g. `mydata-1250000000`. The APPID is the numeric account identifier. The SDK requires the full `name-APPID` form everywhere a bucket is named.

## Quick start

```python
import os
from qcloud_cos import CosConfig, CosS3Client

config = CosConfig(
    Region=os.environ["TENCENTCLOUD_REGION"],
    SecretId=os.environ["TENCENTCLOUD_SECRET_ID"],
    SecretKey=os.environ["TENCENTCLOUD_SECRET_KEY"],
    Scheme="https",
)
client = CosS3Client(config)
```

## Workflows

### List all buckets

```python
resp = client.list_buckets()
for b in resp["Buckets"]["Bucket"]:
    print(b["Name"], b["Location"], b["CreationDate"])
```

### List objects in a bucket

```python
# Single page (max 1000 objects)
resp = client.list_objects(Bucket="mydata-1250000000", Prefix="images/", Delimiter="/")
for obj in resp.get("Contents", []):
    print(obj["Key"], int(obj["Size"]), obj["LastModified"])

# Paginate through everything
marker = ""
while True:
    resp = client.list_objects(Bucket="mydata-1250000000", Prefix="logs/", Marker=marker, MaxKeys=1000)
    for obj in resp.get("Contents", []):
        print(obj["Key"])
    if resp.get("IsTruncated") != "true":
        break
    marker = resp["NextMarker"]
```

### Upload a file

```python
# Streaming upload — handles multipart / resumes / 5GB+ files transparently
client.upload_file(
    Bucket="mydata-1250000000",
    Key="uploads/2026/report.pdf",
    LocalFilePath="./report.pdf",
)
```

### Download a file

```python
client.download_file(
    Bucket="mydata-1250000000",
    Key="uploads/2026/report.pdf",
    DestFilePath="./report.pdf",
)
```

### Generate a pre-signed download URL

```python
# Default expiry 1 hour; pass Expired=86400 for 24h, etc.
url = client.get_presigned_url(
    Method="GET",
    Bucket="mydata-1250000000",
    Key="uploads/2026/report.pdf",
    Expired=3600,
)
print(url)
```

### Delete a single object

```python
client.delete_object(Bucket="mydata-1250000000", Key="uploads/old-file.txt")
```

### Batch delete by prefix (with dry-run safety)

```python
# 1) Always preview first
to_delete = []
marker = ""
while True:
    resp = client.list_objects(Bucket="mydata-1250000000", Prefix="temp/old/", Marker=marker, MaxKeys=1000)
    for obj in resp.get("Contents", []):
        to_delete.append({"Key": obj["Key"]})
    if resp.get("IsTruncated") != "true":
        break
    marker = resp["NextMarker"]

print(f"Would delete {len(to_delete)} objects")
for o in to_delete[:10]:
    print("  -", o["Key"])

# 2) Confirm with the user before running this:
# resp = client.delete_objects(Bucket="mydata-1250000000", Delete={"Object": to_delete, "Quiet": "false"})
# print("Deleted:", len(resp.get("Deleted", [])))
```

### Calculate bucket / prefix size (du)

```python
total_bytes = 0
total_count = 0
marker = ""
while True:
    resp = client.list_objects(Bucket="mydata-1250000000", Prefix="logs/", Marker=marker, MaxKeys=1000)
    for obj in resp.get("Contents", []):
        total_bytes += int(obj["Size"])
        total_count += 1
    if resp.get("IsTruncated") != "true":
        break
    marker = resp["NextMarker"]

print(f"{total_count} objects, {total_bytes / 1024 / 1024:.1f} MiB")
```

### Copy objects within a bucket

```python
client.copy_object(
    Bucket="mydata-1250000000",
    Key="new/path.txt",
    CopySource={
        "Bucket": "mydata-1250000000",
        "Key": "old/path.txt",
        "Region": os.environ["TENCENTCLOUD_REGION"],
    },
)
```

## Safety reminders

- **Confirm batch deletes with the user** before running. The `delete_objects` call is irreversible — there's no recycle bin in COS by default.
- **Pre-signed URLs are bearer tokens** — anyone with the URL gets the object until it expires. Default to short expiries (1 hour) unless the user explicitly asks for longer.
- **Cross-region operations** require the source / destination Region in `CopySource`. Mismatched region triggers `NoSuchBucket`.
- **`download_file` overwrites the destination** without asking. Pick `DestFilePath` carefully when scripting in a loop.

## Error patterns

| Symptom | Likely cause |
|---|---|
| `NoSuchBucket` | Wrong region, wrong APPID suffix on the bucket name |
| `AccessDenied` | Sub-account missing `QcloudCOSReadOnlyAccess` / `QcloudCOSDataReadOnly` etc. |
| `SignatureDoesNotMatch` | SecretKey was pasted with leading / trailing whitespace, or the system clock is off by more than 5 minutes |
| `RequestTimeTooSkewed` | Same — clock skew |

## Console links

- COS console: <https://console.cloud.tencent.com/cos/bucket>
- API reference: <https://www.tencentcloud.com/document/product/436/41330>

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Облака: AWS, Azure, GCP» →
cloud-functions TencentCloudBase Скилл cloud-functions для Claude Code и Codex. Ведёт агента по созданию, деплою и отладке Event и HTTP Functions в CloudBase. Требует выбрать тип функции заранее — рантайм после создания не меняется. CX Codex +1 1 200установок huawei-cloud-obs-upload huaweicloud Скилл huawei-cloud-obs-upload для Claude Code загружает файлы и каталоги в бакеты Huawei Cloud OBS через obsutil. Настраивает регулярную синхронизацию через crontab и запрашивает метрики хранилища. CX Codex +1 18 400установок huawei-cloud-obs-stats huaweicloud Скилл huawei-cloud-obs-stats показывает бакеты Huawei Cloud OBS с объёмом и числом объектов, скачивание и число запросов с месяцем к месяцу. CX Codex +1 18 300установок tigris-agent-kit tigrisdata Скилл tigris-agent-kit для работы с объектным хранилищем Tigris: изолированные копии датасетов, бакеты под каждого агента, снапшоты и вебхуки. CX Codex +1 3 800установок tigris-s3-migration tigrisdata Скилл tigris-s3-migration для Claude Code ведёт миграцию объектного хранилища с AWS S3, GCS или Azure Blob на Tigris. Переключает бакет без остановки продакшена через shadow bucket, массовое копирование или инкрементальный синк. CX Codex +1 3 800установок object-storage devops-skills Скилл object-storage для работы с объектным хранилищем: команды AWS CLI, бакет-политики, lifecycle-правила, версионирование и self-hosted MinIO. CX Codex +1 387установок

Из того же набора67

Весь набор →
producer-music Скилл producer-music генерирует музыку через AceDataCloud API: песни, тексты, каверы и инструментальные треки. Работает с продолжением, заменой фрагментов и разделением дорожек. CX Codex +1 236установок hailuo-video Скилл hailuo-video генерирует видео из текста или анимирует картинки через API Hailuo (MiniMax) от AceDataCloud. Работает через три модели: текст-в-видео, картинка-в-видео и режим режиссёра для точного контроля над камерой. CX Codex +1 235установок seedream-image Скилл seedream-image для Claude Code подключает Seedream 5.0 для генерации, редактирования и разложения изображений на слои. Обрабатывает референсы, создаёт изображения с прозрачным фоном и серии картинок. CX Codex +1 235установок nano-banana-image Скилл nano-banana-image генерирует и правит изображения через API AceDataCloud: промпт текстом, референсы ссылками, вывод в 1K, 2K или 4K. CX Codex +1 232установок google-search Скилл google-search ищет в Google страницы, картинки, новости, места и видео через API AceDataCloud и отдаёт агенту ссылки с заголовками и сниппетами. CX Codex +1 232установок google-gmail Скилл google-gmail позволяет искать письма Gmail, разбирать цепочки и работать с метками и вложениями. Отправка и архивирование требуют соответствующих разрешений и подтверждения пользователя. CX Codex +1 231установок ai-chat Скилл ai-chat подключает шлюз AceDataCloud к агенту для вызова более 50 моделей LLM через единый API. Запускается при запросах к Claude, GPT, Gemini, DeepSeek или Kimi с сохранением контекста и стримингом. CX Codex +1 230установок zhihu Скилл подключает Zhihu к агенту: ищет посты и весь веб, показывает горячие темы, отдаёт статистику ваших статей и ответов. CX Codex +1 229установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой