Markdown 图片直传 R2

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

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

前置条件： 已有可写入的 Cloudflare R2 凭证 已有桶名和公开访问域名或 CDN 域名 运行环境有 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://.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