目标：让 Gutenberg 粘贴图片即上云，返回可长期访问的外链，解决共享主机 inode 限制与链接失效痛点。
- 剪贴板直传：在区块编辑器粘贴图片时自动上传到 image2url，插入外链图片块，不占用本地媒体库。
- 多图顺序上传：一次粘贴多张图片时按顺序上传并批量插入，适合截图流和内容搬运场景。
- 端点可配置与校验：支持自建/自定义域名的上传端点，并可在后台直接验证连通性。
- 本地回退工具：支持扫描文章中的外链图片、下载到媒体库，并把文章内容中的远端 URL 替换为本地 URL。
- 后台批量任务：批量回退和批量验证都会进入后台队列，由 WP-Cron 按批次自动执行，避免大站点一次请求超时。
- 验证报告导出：批量验证任务会沉淀文章级审计结果，可在后台预览并导出 CSV。
- 问题类型聚合：验证报告会按问题类型汇总，并支持在后台按结果状态和问题类型快速筛选。
- 多维审计筛选：验证报告支持按严重度和文章类型继续切分，适合大站点做分组排查。
- 块属性与特色图同步：回退时会把
core/image、core/cover、core/media-text区块升级为本地附件引用，并可在缺少特色图时自动补正文首图。 - 无侵入部署：启用后即可用，无需改模板；停用后粘贴行为恢复默认。
未来规划（未实现）：本地+云端双备份、一键回退、本地/云端批量迁移、Markdown 粘贴增强（解析 data URI 转云端）。
- 运行
tools/package-release.ps1生成干净的提审包，或将生成后的插件目录安装到 WordPress 插件目录。 - 在后台启用插件，进入
设置 -> Image2URL进行配置。
- 上传端点：默认
https://www.image2url.com/api/upload。可改为自建 API 或自定义域，并支持后台验证连通性。 - 体积限制 (MB)：默认 2MB；超过会在本地阻断，避免无效请求。
- 启用剪贴板直传：开启后，Gutenberg 中粘贴图片会自动上云并插入外链。
- 迁移入口：后台
工具 -> Image2URL Migration可执行单篇扫描、单篇回退、单篇验证、批量验证和后台队列化批量回退。
- 在区块编辑器中直接
Ctrl+V / Cmd+V粘贴图片，等待提示完成即可。 - 一次粘贴多张图片时，会按顺序上传并插入多个图片块。
- 上传成功会自动插入图片块并显示外链；失败会给出错误提示和重试结果。
- 如需回退，将文章中的外链图片下载回本地媒体库，可前往
工具 -> Image2URL Migration。 - 批量回退会创建后台任务，由 WP-Cron 分批执行；后台页负责查看进度、日志与重试。
- 回退后的
core/image、core/cover、core/media-text区块会补上本地附件 ID、本地 URL 和图片标记；如文章尚无特色图，会尝试把正文首张已本地化图片设为特色图。 - 回退后可直接在迁移页运行单篇验证，检查残留外链、块附件绑定和特色图状态。
- 也可以把验证做成后台任务，按指定文章列表或当前可访问的全部已发布文章进行批量审计，并按结果状态、问题类型、严重度、文章类型筛选或导出完整 CSV 明细。
- inode 减负：默认不入本地媒体库，降低共享主机 inode 压力。
- 剪贴板体验：前端 Paste Handler 拦截剪贴板文件，上云后插入 image block，避免路径错乱。
- 可信策略：后台可验证端点连通性，失败会自动重试；并已提供基础“外链转本地媒体库”回退入口。
- 安全收敛：默认仅开放 JPEG、PNG、GIF、WebP，SVG 交给更严格的独立安全链路。
- 代码入口：
image2url-clipboard-booster.php - 设置逻辑：
includes/class-image2url-plugin.php - 前端粘贴脚本：
assets/js/editor-paste.js
- Gutenberg Markdown 粘贴增强：识别 Markdown/Docs 粘贴中的 data URI 或本地相对路径，自动转存至云端。
- 双备份模式：上传后可选镜像到本地媒体库（可控开关），并记录映射表以便回退。
- 一键回退/导出：提供后台工具，将文章中的外链批量替换为本地附件（利用映射表），满足安全感与合规需求。
- 多端点与 SLA：按作者/站点路由到不同端点或地域；暴露健康检查与速率统计。
- 安全与 SEO：支持自定义域名、签名上传、可配置的缓存头与 alt 自动补全。