热点链接转换器 1.1.0

热点链接转换器这是一个管理员工具，它可以批量将外部链接的图像转换为本地存储的XenForo附件，适用于整个论坛。它会扫描https://external.com/pic.jpg[/IMG]论坛帖子、个人资料帖、对话消息和资源管理器资源更新下载图片，并创建适当的XF附件，替换BB代码。

它是为包含旧链接内容的论坛而构建的，特别是来自其他软件（如phpBB、vBulletin等）导入的板子中，那里有20年的图片可能在论坛帖子中存在，并且随着时间推移逐渐过时，因为外部托管者会关闭。你可以选择它触及的内容类型，在预览时使用Dry Run，然后进行转换。

---

• []]*全板转换- 将论坛帖子、个人资料帖、对话消息和XFRM资源更新中的热链接图片转换。每种内容类型有一个开关可以选择要扫描的内容。[]]*资源管理器可选- 在纯XenForo上工作。资源更新目标只有在安装了资源管理器时才会出现。[]]*管理员控制面板- 显示每种类型中包含热链接图片的项目数量，以及转换统计（已转换/失败/跳过/待处理）。计数是按需计算的（通过一个重新计算按钮），并且被缓存，所以即使在有数百万条帖子的板子上打开页面也会立即显示。[]]*干跑模式- 预览将要转换的内容而不下载任何内容。结果出现在转换日志中为“待处理”条目。[]]*内联渲染转换后的图片以本地附件形式显示在行内，作为内容类型专用编辑器的一部分，没有多余的“编辑”标记，没有弹出警告，也没有对迁移内容的活动增量。原作者保持不变。[]]*代码/教程类帖子从不被触碰- 线性例子内部
  ，
  ，，，
  ，或
  教程演示BB代码时保持原样，所以永远不会被损坏。[][管理员专用权限 - “热链接转换器”权限控制运行转换并清空日志，可以授予特定的非超级管理员。[]*[转换日志 - 包含每条处理的URL记录的状态徽章、内容类型和ID、附件链接、文件大小以及失败/跳过的可翻译原因和时间戳。可根据状态进行筛选。[]确认提示框-实时转换需要显式确认，因为它会永久修改内容。如果启用了对话扫描功能，提示框还会添加一个私密对话的隐私警告。[]智能IMG处理 - 处理tag 变体，) 和 phpBBform.[]URL去重 - 如果一个外部URL在同一项中出现多次，则只下载一次，并且所有实例共享相同的附件。[]本地URL跳过 - 已经指向您自己板子的URL自动跳过。[]幂等 - 可以重新运行。已经转换为URL的不再在后续运行中被处理，不会下载或附件重复。[]失败恢复 - 失败下载（404错误、超时、过大文件、无效图片）会记录具体原因。任务继续处理其余内容。[]静音大运行 - 大批量运行会抑制外部IndexNow的ping，因此不会填满任务队列或大规模通知搜索引擎关于图片的外貌更改（您的本地搜索索引仍然会被更新）。[]清理卸载 - 卸载时删除转换日志表。

---

1. []前往AdminCP > 工具 > 热链接转换器。[]
2. 在AdminCP > 选项 > 热链接转换器中，选择要扫描的内容类型。论坛帖子默认开启；对话扫描默认关闭。[]点击仪表板上的“重新计算”，看看每种类型物品中包含的外部有多少。标签。[][*]运行干跑以扫描而不进行转换。检查日志以查看将要处理的确切内容。[][*]点击转换所有，在弹窗中确认，可恢复的后台任务负责其余工作–下载每张图片，创建XF附件，并在内容中更新。[]审查转换日志以查找任何失败情况，过滤状态以便专注于问题。[/list]
   [hr][/hr]
   在
   [CODE]
   Check out this screenshot: [IMG]https://external-site.com/image.jpg
   [/CODE]
   之后：
   
   代码：

   Check out this screenshot: 
   [ATTACH=full]12345[/ATTACH]

   图片现在已本地存储为一个正确的XF附件，并嵌入到原始内容中。即使外部托管服务离线，它也会保留。
   

   ---

   • []]*建筑设计：一个内容源抽象层覆盖了Service、Job和Repository，因此每种内容类型都通过相同的管道转换。一个数据库表（xf_qubn_hlc_conversion_log）用于审计日志记录。[]]*内联嵌入：每种内容类型都通过其原生XF编辑服务进行编辑，该服务既设置了attach_count也设置了嵌入元数据——这就是为什么转换后的图片会以内联形式显示而不是作为分离的附件条目。[]]*下载：使用XF内置的getUntrusted() HTTP读取器，带有SSRF保护，每张图片大小限制为10MB，超时时间为15秒。[]]*支持的格式：JPG, JPEG, PNG, GIF, WebP, BMP。[]*]工作处理中：基于光标的可恢复型任务。每批处理50个项目，并进行时间限制检查，可以从AdminCP工作队列中取消。[]]*兼容性：需要XenForo 2.3.0+。XF资源管理器为可选，仅启用resource-update目标。[]]*代码质量：PHPStan级别为3的清洁。没有类扩展 - 完全自包含。