来源信息
- 仓库
- llm011/ethan-agent
- 最近来源活动
- 2026年9月13日 18:37
- 检测到的 SKILL.md 语言
- 中文
- 星标
- 8
- 分支
- 0
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
2 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- 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 注入是否生效（可选快速确认）：**
```bash
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。**
**上传图片/文件：**
```bash
python ~/.ethan/skills/upload-cdn/scripts/upload_cdn.py /path/to/file.png "ethan/upload/$(basename /path/to/file.png)"
```
**批量上传（shell 循环）：**
```bash
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 会覆盖已有文件
- 脚本纯标准库实现，无需额外依赖
在 GitHub 查看