# 🍙 七牛云上传 - 快速参考

## 📤 上传指令

| 指令 | 说明 | 示例 |
|------|------|------|
| `/upload` | 使用原文件名上传 | `/upload` + 文件 |
| `/upload --original` | 同 `/upload` | `/upload --original` + 文件 |
| `/upload 路径` | 上传到指定路径 | `/upload /config/file.txt` + 文件 |
| `/upload 路径 存储桶` | 指定路径和存储桶 | `/upload /docs/r.pdf prod` + 文件 |

## ⚙️ 配置命令

| 命令 | 说明 | 示例 |
|------|------|------|
| `/qiniu-config list` | 查看配置 | `/qiniu-config list` |
| `/qiniu-config set 键 值` | 修改配置 | `/qiniu-config set default.accessKey XXX` |
| `/qiniu-config set-bucket 名称 JSON` | 添加存储桶 | `/qiniu-config set-bucket prod '{...}'` |
| `/qiniu-config reset` | 重置配置 | `/qiniu-config reset` |
| `/qiniu-help` | 查看帮助 | `/qiniu-help` |

## 🔑 可配置项

```
default.accessKey   - 访问密钥
default.secretKey   - 密钥
default.bucket      - 存储桶名称
default.region      - 区域 (z0/z1/z2/na0/as0)
default.domain      - CDN 域名
```

## 📋 区域代码

| 代码 | 区域 |
|------|------|
| `z0` | 华东（浙江） |
| `z1` | 华北（河北） |
| `z2` | 华南（广东） |
| `na0` | 北美 |
| `as0` | 东南亚 |

## 🎯 常用场景

### 上传配置文件
```
/upload /config/app/config.json
[文件]
```

### 上传图片
```
/upload /images/2026/photo.jpg
[文件]
```

### 修改 CDN 域名
```
/qiniu-config set default.domain https://new-cdn.com
```

### 添加生产环境
```
/qiniu-config set-bucket production {"accessKey":"...","secretKey":"...","bucket":"prod","region":"z0","domain":"https://prod-cdn.com"}
```

### 上传到生产环境
```
/upload /assets/main.js production
[文件]
```

## 🔧 命令行

```bash
# 上传
node scripts/upload-to-qiniu.js upload --file ./f.txt --key /path/f.txt

# 配置
node scripts/upload-to-qiniu.js config list
node scripts/upload-to-qiniu.js config set default.accessKey XXX

# 启动
./scripts/start-listener.sh
```

## 📞 帮助

- 飞书中：`/qiniu-help`
- 文档：`cat README.md`