cloudflare-drivelisted
Install: claude install-skill yourba/cloudflare-drive-skill
# Cloudflare Drive 网盘
个人文件中转站,跑在 Cloudflare 免费套餐上。用它上传文件、生成分享链接、管理已存文件。
系统本体:https://github.com/yourba/cloudflare-drive
## 先读配置
需要两个值:**站点地址**和 **API Token**。按顺序找,找到就用,别问用户要。
**站点地址**(记作 `$B`,形如 `https://你的域名/api/v1`):
1. 环境变量 `CFDRIVE_BASE_URL`
2. 配置文件里的 `base_url` 字段(见下)
3. 都没有就问用户一次,并建议写进配置文件
**API Token**(记作 `$TOKEN`):
1. 环境变量 `CFDRIVE_TOKEN`
2. 当前工作目录下的 `.cfdrive-token`(纯文本,一行)
3. `~/.cfdrive/config.json` 或 `%USERPROFILE%\.cfdrive\config.json`,格式:
```json
{ "base_url": "https://你的域名/api/v1", "token": "cfd_live_..." }
```
用 Read 工具读文件,取值后去掉首尾空白。都找不到就告诉用户:在网盘界面的「Token 管理」里新建一个,然后存到上面任一位置。
**不要把 Token 明文打印到回复里。**
## 响应格式
除下载类接口返回原始字节外,全部是 `{"ok":true,"data":{…}}` 或 `{"ok":false,"error":{"code","message","details"}}`。判断成功看 `ok`,分支逻辑读 `error.code` 而不是 `message`。
## 最���见的任务:传文件 + 给链接
用户说「传到网盘」「发我个链接」「中转一下这个文件」时的完整流程。
```bash
TOKEN=$(cat .cfdrive-token) # 按上面的顺序找到的那份
B=https://你的域名/api/v1
F=/path/to/文件.pdf
# 1. 建上传会话。strategy=presigned 让服务端返回一个可直传 R2 的 URL,
# 最大支持 5 GiB,一条 curl 就能传完,不用处理分片。
SESS=$(curl -s -X POST "$B/uploads" \
-H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
-d "$(python3 -c "
import json,os,sys,mimetypes
p=sys.argv[1]
print(json.dumps({'name':os.path.basename(p),'size':os.path.getsize(p),
'mime':mimetypes.guess_type(p)[0] or 'application/octet-stream',
'storage_class':'short','expires_in':604800,'strategy':'presigned'}))" "$F")")
UPID=$(echo "$SESS" | python3 -c "import sys,json;pri