| 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 会覆盖已有文件
- 脚本纯标准库实现，无需额外依赖
