> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 同步与清理

> 适用版本 1.0.4 ｜ 后台路径：插件 → 初春图床 → 同步

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

## 同步做什么

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

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

## 操作步骤

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

## 什么时候需要同步

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

## 注意事项

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