For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /oneimg/sync.md.

同步与清理

适用版本 1.0.4 | 后台路径:插件 → 初春图床 → 同步

把图床里已有的图片批量导入 Halo 附件库,并在同步结束后清理 Halo 侧已失效的附件记录。适合「先用了图床,后接入 Halo」或「换过图床」的场景。

同步做什么

步骤行为
拉取从初春图床读取图片列表
导入在 Halo 附件库中创建对应记录,已存在的图片自动跳过
日志前端实时滚动显示处理进度与结果
反向清理同步完成后,对属于本策略的 Halo 附件,若图床中已无对应图片,删除 Halo 侧记录

反向清理只删 Halo 侧的附件记录,不会去删图床里的图片。

操作步骤

  1. 确认存储策略已配置且能正常上传(见 存储策略配置)
  2. 后台「插件 → 初春图床 → 同步」标签页
  3. 点击「开始同步」
  4. 观察日志直到结束,确认导入数量与清理数量

什么时候需要同步

  • 图床里已经有一批历史图片,希望它们出现在 Halo 附件库中统一管理
  • 从其它图床迁移到 oneimg,Halo 侧记录与图床不一致
  • 图床侧批量删除过图片,需要把 Halo 里的失效记录清掉

注意事项

  • 同步前先备份。反向清理会删除 Halo 侧记录,虽然不影响图床文件,但附件记录删除后无法从 Halo 恢复
  • 建议在低峰期执行:同步会遍历图片列表并逐条写入,图片多时耗时较长
  • 重复执行是安全的:已存在的图片会被跳过,不会产生重复附件
  • 同步过程中不要在图床侧删除图片,否则可能出现「刚导入又被判定失效」的竞态
  • 日志出现个别失败条目时,先确认该图片在图床侧是否仍可访问,再决定是否重跑
  • 反向清理与同步绑定执行,没有单独开关;如果不想清理失效记录,就不要执行同步