# oss-upload-skill

**Repository Path**: windRainCode/oss-upload

## Basic Information

- **Project Name**: oss-upload-skill
- **Description**: 阿里云 OSS 文件上传工具 Skill - 支持文件上传、文本上传、列表、删除、临时URL生成
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-28
- **Last Updated**: 2026-03-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OSS Upload ☁️

阿里云 OSS 文件上传管理工具

## 功能

- 📤 **文件上传** - 本地文件上传到 OSS
- 📝 **文本上传** - 直接上传字符串内容
- 📋 **文件列表** - 列出 OSS 中的文件
- 🗑️ **文件删除** - 删除 OSS 文件
- 🔗 **临时 URL** - 生成带签名的临时访问链接

## 安装

```bash
cd ~/.openclaw/workspace/skills/oss-upload
npm install
```

## 配置

### 方式1：交互式配置（推荐）

```bash
node index.mjs init
```

### 方式2：手动创建 .env 文件

```bash
cp .env.example .env
# 编辑 .env 填入实际值
```

## 使用方法

### 上传文件

```bash
node index.mjs upload ./local-file.txt
node index.mjs upload ./image.png photos/logo.png
```

### 上传文本

```bash
node index.mjs text "Hello World" greeting.txt
```

### 列出文件

```bash
node index.mjs list
node index.mjs list photos/
```

### 删除文件

```bash
node index.mjs delete photos/old.png
```

### 生成临时 URL

```bash
node index.mjs url private-file.pdf 3600
```

## 程序化使用

```javascript
import { OSSClient } from './lib/oss-client.mjs';

const client = new OSSClient();

// 上传文件
const result = await client.uploadFile('./file.txt', 'docs/file.txt');
console.log(result.url);

// 上传文本
await client.uploadText('Hello', 'hello.txt');

// 列出文件
const files = await client.listFiles('docs/');

// 删除
await client.deleteFile('old.txt');

// 临时 URL
const url = client.getSignedUrl('private.pdf', 3600);
```

## 环境变量

| 变量 | 必需 | 说明 |
|------|------|------|
| `OSS_REGION` | ✅ | OSS 区域 |
| `OSS_BUCKET` | ✅ | Bucket 名称 |
| `OSS_ACCESS_KEY_ID` | ✅ | AccessKey ID |
| `OSS_ACCESS_KEY_SECRET` | ✅ | AccessKey Secret |
| `OSS_BASE_PATH` | ❌ | 基础路径前缀 |

## 安全

⚠️ `.env` 文件包含敏感信息，已添加到 `.gitignore`，请勿提交到 Git！

## 许可证

[MIT](LICENSE) © windRainCode

## 作者

windRainCode