initial: 七牛云上传 OpenClaw Skill
功能特性: - 支持 /upload, /u 命令上传文件到七牛云 - 支持 /qiniu-config 配置管理 - 支持飞书卡片交互 - 支持指定上传路径和存储桶 - 自动刷新 CDN 缓存 - 支持文件覆盖上传 包含组件: - OpenClaw 处理器 (openclaw-processor.js) - 独立监听器 (scripts/feishu-listener.js) - 核心上传脚本 (scripts/upload-to-qiniu.js) - 部署脚本 (deploy.sh) - 完整文档 部署方式: 1. 复制 skill 到 ~/.openclaw/workspace/skills/ 2. 配置 ~/.openclaw/credentials/qiniu-config.json 3. 重启 OpenClaw Gateway
This commit is contained in:
daoqi
276
UPGRADE.md
Normal file
276
UPGRADE.md
Normal file
@@ -0,0 +1,276 @@
|
||||
# 🍙 七牛云自动上传 v2 - 更新说明
|
||||
|
||||
## 🎉 新增功能
|
||||
|
||||
### 1. 支持指定上传路径
|
||||
|
||||
现在可以在飞书聊天中指定文件上传到存储桶的具体路径：
|
||||
|
||||
```
|
||||
/upload /config/test/test.txt default
|
||||
[附上文件]
|
||||
```
|
||||
|
||||
文件将上传到七牛云：`bucket/config/test/test.txt`
|
||||
|
||||
### 2. 使用原文件名上传
|
||||
|
||||
支持保留原始文件名：
|
||||
|
||||
```
|
||||
/upload --original
|
||||
[附上文件]
|
||||
```
|
||||
|
||||
或直接：
|
||||
|
||||
```
|
||||
/upload
|
||||
[附上文件]
|
||||
```
|
||||
|
||||
### 3. 聊天命令动态配置
|
||||
|
||||
无需编辑配置文件，在飞书中直接修改七牛云配置：
|
||||
|
||||
```
|
||||
/qiniu-config list
|
||||
/qiniu-config set default.accessKey YOUR_KEY
|
||||
/qiniu-config set default.domain https://cdn.example.com
|
||||
```
|
||||
|
||||
### 4. 多存储桶管理
|
||||
|
||||
动态添加和管理多个存储桶：
|
||||
|
||||
```
|
||||
/qiniu-config set-bucket production {"accessKey":"...","secretKey":"...","bucket":"prod","region":"z0","domain":"https://prod-cdn.com"}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📋 完整指令列表
|
||||
|
||||
### 上传指令
|
||||
|
||||
| 指令 | 说明 |
|
||||
|------|------|
|
||||
| `/upload` | 使用原文件名上传到 default 存储桶 |
|
||||
| `/upload --original [bucket]` | 使用原文件名，可指定存储桶 |
|
||||
| `/upload 路径 [bucket]` | 上传到指定路径 |
|
||||
|
||||
### 配置指令
|
||||
|
||||
| 指令 | 说明 |
|
||||
|------|------|
|
||||
| `/qiniu-config list` | 查看当前配置 |
|
||||
| `/qiniu-config set <键> <值>` | 修改配置项 |
|
||||
| `/qiniu-config set-bucket <名> <JSON>` | 添加/修改存储桶 |
|
||||
| `/qiniu-config reset` | 重置配置 |
|
||||
| `/qiniu-help` | 查看帮助 |
|
||||
|
||||
---
|
||||
|
||||
## 🔑 可配置项
|
||||
|
||||
```bash
|
||||
# 查看配置
|
||||
/qiniu-config list
|
||||
|
||||
# 修改 AccessKey
|
||||
/qiniu-config set default.accessKey YOUR_ACCESS_KEY
|
||||
|
||||
# 修改 SecretKey
|
||||
/qiniu-config set default.secretKey YOUR_SECRET_KEY
|
||||
|
||||
# 修改存储桶名称
|
||||
/qiniu-config set default.bucket my-bucket
|
||||
|
||||
# 修改区域
|
||||
/qiniu-config set default.region z0
|
||||
|
||||
# 修改 CDN 域名
|
||||
/qiniu-config set default.domain https://cdn.example.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 使用示例
|
||||
|
||||
### 场景 1：上传配置文件到指定目录
|
||||
|
||||
```
|
||||
/upload /config/app/config.json
|
||||
[附上 config.json]
|
||||
```
|
||||
|
||||
回复：
|
||||
```
|
||||
✅ 上传成功！
|
||||
📦 文件：config/app/config.json
|
||||
🔗 链接：https://cdn.example.com/config/app/config.json
|
||||
```
|
||||
|
||||
### 场景 2：批量上传不同环境的配置
|
||||
|
||||
```
|
||||
# 上传到开发环境
|
||||
/upload /config/dev.json dev
|
||||
[文件]
|
||||
|
||||
# 上传到生产环境
|
||||
/upload /config/prod.json production
|
||||
[文件]
|
||||
```
|
||||
|
||||
### 场景 3：动态修改配置
|
||||
|
||||
```
|
||||
# 查看当前配置
|
||||
/qiniu-config list
|
||||
|
||||
# 修改 CDN 域名
|
||||
/qiniu-config set default.domain https://new-cdn.com
|
||||
|
||||
# 添加新的存储桶
|
||||
/qiniu-config set-bucket backup '{"accessKey":"...","secretKey":"...","bucket":"backup","region":"z1","domain":"https://backup-cdn.com"}'
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📁 更新的文件
|
||||
|
||||
```
|
||||
scripts/
|
||||
├── upload-to-qiniu.js # ⭐ 重写，支持配置管理和路径
|
||||
└── feishu-listener.js # ⭐ 重写，支持聊天命令
|
||||
|
||||
docs/
|
||||
├── README.md # ⭐ 更新使用指南
|
||||
├── CHEATSHEET.md # ✨ 新增快速参考
|
||||
└── UPGRADE.md # ✨ 本文档（更新说明）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 升级步骤
|
||||
|
||||
如果你已经安装了 v1 版本：
|
||||
|
||||
### 1. 备份现有配置
|
||||
|
||||
```bash
|
||||
cp ~/.openclaw/credentials/qiniu-config.json \
|
||||
~/.openclaw/credentials/qiniu-config.json.bak
|
||||
```
|
||||
|
||||
### 2. 更新脚本
|
||||
|
||||
脚本已自动更新，无需手动操作。
|
||||
|
||||
### 3. 重启监听器
|
||||
|
||||
```bash
|
||||
# 停止旧版本
|
||||
pkill -f feishu-listener
|
||||
|
||||
# 启动新版本
|
||||
cd ~/.openclaw/workspace/skills/qiniu-uploader
|
||||
./scripts/start-listener.sh
|
||||
```
|
||||
|
||||
### 4. 测试新功能
|
||||
|
||||
```
|
||||
# 在飞书中测试
|
||||
/qiniu-config list
|
||||
/upload /test/v2-upgrade.txt
|
||||
[附上文件]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🔄 兼容性说明
|
||||
|
||||
### ✅ 向后兼容
|
||||
|
||||
- 旧的上传指令仍然有效
|
||||
- 现有配置文件格式兼容
|
||||
- 无需重新配置
|
||||
|
||||
### ⚠️ 行为变化
|
||||
|
||||
1. **默认使用原文件名**：`/upload` 不再要求指定文件名
|
||||
2. **路径支持**：现在支持 `/` 开头的完整路径
|
||||
3. **配置管理**：新增聊天命令配置功能
|
||||
|
||||
---
|
||||
|
||||
## 💡 最佳实践
|
||||
|
||||
### 1. 路径规范
|
||||
|
||||
```
|
||||
✅ 推荐：/config/app/config.json
|
||||
✅ 推荐：/images/2026/03/photo.jpg
|
||||
❌ 避免：config/app/config.json (缺少前导 /)
|
||||
```
|
||||
|
||||
### 2. 存储桶命名
|
||||
|
||||
```
|
||||
default - 默认存储桶
|
||||
production - 生产环境
|
||||
staging - 测试环境
|
||||
backup - 备份存储
|
||||
```
|
||||
|
||||
### 3. 安全建议
|
||||
|
||||
- 定期轮换 AccessKey/SecretKey
|
||||
- 使用 `/qiniu-config set` 命令修改，避免明文传输
|
||||
- 不要在不安全的渠道分享配置命令
|
||||
|
||||
---
|
||||
|
||||
## 🆘 故障排查
|
||||
|
||||
### 问题：配置命令无响应
|
||||
|
||||
```bash
|
||||
# 检查监听器状态
|
||||
ps aux | grep feishu-listener
|
||||
|
||||
# 查看日志
|
||||
tail -f listener.log
|
||||
```
|
||||
|
||||
### 问题：上传路径不正确
|
||||
|
||||
```bash
|
||||
# 手动测试
|
||||
node scripts/upload-to-qiniu.js upload --file ./test.txt --key /test/path.txt
|
||||
```
|
||||
|
||||
### 问题：配置丢失
|
||||
|
||||
```bash
|
||||
# 重置配置
|
||||
/qiniu-config reset
|
||||
|
||||
# 或手动初始化
|
||||
node scripts/upload-to-qiniu.js config init
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📞 获取帮助
|
||||
|
||||
- 飞书中：`/qiniu-help`
|
||||
- 快速参考：`cat CHEATSHEET.md`
|
||||
- 完整文档：`cat README.md`
|
||||
- 更新说明：`cat UPGRADE.md`（本文档）
|
||||
|
||||
---
|
||||
|
||||
**升级完成！享受更强大的功能！** 🍙
|
||||
Reference in New Issue
Block a user