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，再從目標目錄向上查詢

  想要更強大的技能外掛，就來小蔥技能站7w4.net看看吧。

用法

單檔案

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 圖床的使用者來說，這是一個值得一試的工具。