name: md-img-r2 description: Upload local images in Markdown directly to Cloudflare R2 and replace paths with public URLs.

md-img-r2

将 Markdown 文件中的本地图片直接上传到 Cloudflare R2，并把本地路径替换为公开 URL。

适用场景

• 你已经有 Cloudflare R2 桶和可公开访问域名
• 你不想依赖 PicList Desktop
• 你希望把这个能力作为可分发 skill 交给别人使用

前置条件

1. 已有可写入的 Cloudflare R2 凭证
2. 已有桶名和公开访问域名或 CDN 域名
3. 运行环境有 python3

推荐配置

优先用环境变量或项目根目录的 .env 提供配置：

• CF_R2_ACCOUNT_ID
• CF_R2_ACCESS_KEY_ID
• CF_R2_SECRET_ACCESS_KEY
• CF_R2_BUCKET
• CF_R2_PUBLIC_BASE_URL
• CF_R2_REGION，默认 auto
• CF_R2_ENDPOINT，默认 https://<account_id>.r2.cloudflarestorage.com
• CF_R2_KEY_PREFIX，默认 md-assets
• --env-file 可显式指定 .env 路径；不传时会优先读取 skill 目录下的 .env，再从目标目录向上查找

用法

单文件

bash run.sh path/to/article.md

目录批处理

bash run.sh path/to/dir --recursive

Dry run

bash run.sh path/to/article.md --dry-run

临时覆盖 key 前缀

bash run.sh path/to/article.md --key-prefix posts/2026-04

输出

• 默认原地修改，并生成备份：xxx.md.bak
• 生成报告：xxx.md.replace-report.json

这个 Skill 质量不错，做得用心。优点是配置简单、用法清晰、支持批量处理，还能先预览再执行，不怕误改文件。文档写得很详细，小白也能上手。不过缺少类型提示和测试覆盖，长期维护可能有一定风险。对于需要把本地图片迁移到 R2 图床的用户来说，这是一个值得一试的工具。