常见问题
适用版本 1.0.4 ｜ 后台路径：插件 / 附件
安装与启用
应用市场搜不到插件 确认 Halo ≥ 2.25.0，且应用市场源可访问；也可以从 Releases 下载 JAR 手动上传。
插件启用后，存储策略里没有「初春图床」选项 先确认插件处于启用状态，再强刷后台页面。仍不出现时检查插件日志，确认版本与 Halo 版本匹配。
能否不部署图床，只用插件 不能。插件只做对接，图片实际存放在 oneimg；没有图床服务，上传会直接失败。
上传
上传报 401 Token 无效或已停用。回图床后台重新生成 Token，更新存储策略后重试。
上传报 403 图床侧没有开启 API 功能，或 Token 权限不足。检查「系统设置 → API Token」的启用状态。
上传报存储桶不存在 策略里的桶 ID 与图床实际桶不一致。到图床后台查看桶 ID 后修改。
上传很慢或超时
多为 Halo 服务器到图床的网络问题。在服务器上直接 curl 图床地址，确认 DNS、证书与连通性。
图片能用 HTTP 吗 可以但不建议。HTTP 下 Token 明文传输，且部分浏览器会拦截混合内容。生产环境请配置 HTTPS。
访问与显示
附件列表有图，打开却是 404 先直接在浏览器访问图片地址：如果图床也 404，说明图片已被删除或桶配置错误；如果图床正常但站点 404，检查图床域名、防盗链与反向代理。
图片地址是图床域名，能否换成自己的 CDN 可以，在图床侧绑定自定义域名或 CDN，然后同步修改存储策略的 API 地址；已上传图片的地址不会自动改写。
删除了 Halo 附件，图床图片还在 这是设计行为：删除只清理 Halo 侧记录，不联动图床。需要清理图床文件时，到 oneimg 后台操作。
同步
同步没有导入任何图片 确认图床里确实有图片、Token 有效、策略里的 API 地址指向同一套图床服务。
同步后出现重复附件 正常情况下已存在的图片会自动跳过。出现重复时检查是否配置了多条指向同一图床的策略，或在同步期间更换过策略。
同步把某些附件删了 这是反向清理：这些附件在图床中已不存在。执行前请先备份；被清理的只是 Halo 侧记录。
同步能中断吗 同步由后端异步执行，关闭页面只会停止前端日志轮询，任务本身仍在跑。建议等它跑完再操作图床；重新执行是安全的，已处理的会跳过。
版本与升级
升级插件后配置丢了 正常升级不会删除插件设置与存储策略。若确实丢失，检查是否卸载重装过插件。
图床升级后插件不能用了 先确认 oneimg 的 API 是否变更；必要时升级插件到最新版本，两者都保持最新最稳妥。
反馈
提 Issue 请附：Halo 版本、插件版本、oneimg 版本、报错日志、复现步骤。