#常见问题

#找不到封面生成工具

确认插件已启用，Halo 版本大于等于 2.27.0，并且 Halo AI Foundation 1.x 已启用。更新后刷新控制台，重新进入文章编辑器。新文章先保存一次，再生成封面。

#图片模型列表为空

到 AI Foundation 检查供应商、模型启用状态和能力。图像模型必须支持文生图；文本模型不会出现在图片生成列表。没有默认图像模型时，请显式选择一个模型。

#提示词优化要求配置文本模型

图像生成和提示词优化使用不同类型的模型。即使已经配置图像模型，也需要添加文本模型，再在「提示词优化模型」选择，或设置 AI 基座默认文本模型。

优化失败保留原提示词。成功结果可以编辑；只有结果未再次修改时，才显示可用的「撤销优化」。

#模型不支持所选尺寸

面板优先使用模型声明的尺寸或比例；模型没有声明时显示通用选项。通用选项不保证每个供应商都支持，请在 AI 基座补全模型能力配置，或切换到该模型支持的尺寸后重试。

#提示没有文章图片

「文章首图」读取服务端已保存内容。先插入图片并保存文章，再提取。检查图片地址可访问；仅在编辑器中显示的未保存修改不会被读取。

#自定义封面上传失败

在「插件 → 封面图 → 基本设置」选择附件存储策略并保存，再确认该策略本身能上传附件。附件分组被删除时也应重新选择有效分组。

#图标选择报错

图标库使用 Halo 的图标服务，图标详情可能因为网络或来源数据返回错误。可换一个图标，使用「手动编辑图标」输入 SVG，或清除当前图标后选择附件图片。

#生成成功，但编辑器上方封面未立即刷新

成功预览表示服务端已更新文章封面，编辑器自身的封面区域可能仍显示旧状态。保存并重新打开文章检查；需要插入正文时可直接在成功面板点击「插入正文」，然后保存。

#发布后没有自动生成封面

插件仅在发布且封面为空时尝试补齐，已有封面不会被替换。检查文章的「封面图来源」、对应的正文图片 / AI 默认模型 / 附件策略，并查看 Halo 日志。需要即时预览时用编辑器工具栏生成。

#从旧版升级后 AI 失效

1.2.0 不再读取封面图插件内的旧 CodeSphere / 火山方舟密钥。按 升级说明 将供应商配置迁移到 AI Foundation。

#反馈问题

在 GitHub Issues 提供 Halo、封面图、AI Foundation 版本，说明生成方式、模型类型、复现步骤、错误信息和截图。附日志时隐藏 API Key 等凭据。