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

# 初春图床 Halo 插件

> 适用版本 1.0.4 ｜ Halo ≥ 2.25.0 ｜ 后台路径：插件 / 附件

把自部署的 [初春图床（oneimg）](https://github.com/onexru/oneimg) 接入 Halo 2.x 的附件系统：新上传的图片直接进入图床，图床里已有的图片可以批量同步回 Halo 附件库。

## 初春图床是什么

oneimg 是一个基于 Go + Vue 3 的图床管理系统，支持本地、S3、WebDAV、FTP 等多种存储后端，上传图片自动转 WebP，提供 POW 安全验证、剪贴板粘贴上传与数据仪表板，可通过 Docker Compose 一键部署。

本插件不包含图床服务本体，**必须先在外部部署好 oneimg**，插件通过 API 与它通信。

## 功能

| 能力   | 行为                                          |
| ---- | ------------------------------------------- |
| 附件上传 | Halo 中通过该存储策略上传的图片，写入初春图床                   |
| 附件删除 | **仅删除 Halo 侧附件记录，不联动删除图床图片**                |
| 一键同步 | 把图床中已有图片批量导入 Halo 附件库，实时显示日志，已存在的图片自动跳过     |
| 反向清理 | 同步完成后，对属于本策略的 Halo 附件，若图床中对应图片已不存在，则删除该附件记录 |

## 使用前提

1. 已部署可访问的 oneimg 服务（建议 HTTPS）
2. 在 oneimg 后台「系统设置 → API Token」生成并启用 Token
3. Halo ≥ 2.25.0

## 相关链接

- 插件仓库：[https://github.com/AloneNanNan/oneimg-halo-plugin](https://github.com/AloneNanNan/oneimg-halo-plugin)
- 图床项目：[https://github.com/onexru/oneimg](https://github.com/onexru/oneimg)
- 应用市场：在 Halo 后台搜索「初春图床」

## 下一步

- [安装与部署](/oneimg/install.md)
- [存储策略配置](/oneimg/storage.md)
- [同步与清理](/oneimg/sync.md)