| name | upload-cdn |
| version | 1.0.0 |
| trigger | 上传CDN|上传图床|upload cdn|上传到CDN|上传文件到云|获取外链|公开链接|图片外链 |
| description | 上传本地文件到 S3 兼容对象存储(Cloudflare R2 等),返回公开访问 URL。当用户要上传图片/文件到 CDN、获取外链时使用。 |
upload-cdn
上传本地文件到 S3 兼容对象存储,返回公开 URL。支持 Cloudflare R2 及任意 S3 兼容服务。
密钥配置
凭证存放在 ~/.ethan/.secrets/upload-cdn.env,由 shell 工具自动注入,不要在对话中回显明文值。
第 0 步:先用 list_secrets 检查凭证是否已存。
- 若输出包含
upload-cdn.env → 已配置,直接跳到「使用方法」。
- 若没有 → 立即停止,不要再 find / read config 探索——凭证就是没有。直接告知用户需要提供以下字段(不要绕圈子):
第 1 步(凭证不存在时):检测 shell 注入是否生效(可选快速确认):
test -n "$CDN_ENDPOINT" && test -n "$CDN_ACCESS_KEY" && test -n "$CDN_SECRET_KEY" \
&& test -n "$CDN_BUCKET" && test -n "$CDN_PUBLIC_URL" && echo READY || echo MISSING
READY → 继续。
MISSING → 凭证缺失。直接向用户索要以下字段,不要再探索其他路径:
| 字段 | 说明 | 示例 |
|---|
CDN_ENDPOINT | S3 endpoint URL | https://<account_id>.r2.cloudflarestorage.com |
CDN_ACCESS_KEY | Access Key ID | R2 → 管理 API 令牌 → 创建令牌 |
CDN_SECRET_KEY | Secret Access Key | 同上 |
CDN_BUCKET | 存储桶名 | my-assets |
CDN_PUBLIC_URL | 公开访问 URL 前缀 | https://cdn.example.com 或 R2 公开域名 |
CDN_REGION | 区域(可选) | R2 填 auto,其他填对应 region(默认 auto) |
拿到后由 agent 写入(file_write 工具,path=~/.ethan/.secrets/upload-cdn.env):
CDN_ENDPOINT="https://<account_id>.r2.cloudflarestorage.com"
CDN_ACCESS_KEY="<access_key_id>"
CDN_SECRET_KEY="<secret_access_key>"
CDN_BUCKET="<bucket_name>"
CDN_PUBLIC_URL="https://cdn.example.com"
CDN_REGION="auto"
写完执行 chmod 600 ~/.ethan/.secrets/upload-cdn.env,然后重新执行原始请求。
使用方法
规则:所有上传统一使用 ethan/upload/ 路径前缀,不要用裸文件名作为 key。
上传图片/文件:
python ~/.ethan/skills/upload-cdn/scripts/upload_cdn.py /path/to/file.png "ethan/upload/$(basename /path/to/file.png)"
批量上传(shell 循环):
for f in /tmp/imgs/*.png; do
python ~/.ethan/skills/upload-cdn/scripts/upload_cdn.py "$f" "docs/$(basename "$f")"
done
成功时 stdout 输出公开 URL,失败时 stderr 输出错误并 exit 非0。
注意事项
- Object key 建议带路径前缀(如
docs/2024/image.png),避免与其他文件冲突
- 同名 key 会覆盖已有文件
- 脚本纯标准库实现,无需额外依赖