AI 配图（AiPic）使用文档

作者：kuakeba.cn | 版本：1.0.0 | 适用于 Zsens Admin 3.0+（PHP 8.2+）

一、插件简介

发帖页 AI 智能配图工具：

• 发帖页编辑器下方新增「AI 配图」按钮，弹窗内完成全部生图操作
• 「根据内容整理建议」：AI 阅读当前标题与正文，自动产出配图参考分析与画面描述（prompt）
• 支持方图 / 横图 / 竖图三种比例，内置写实摄影、清新插画、国风水墨等风格快捷词
• 生成的图片自动下载转存本地 /storage/uploads/aipic/，不受厂商临时链接过期影响
• 一键插入正文（兼容 wangEditor / TinyMCE / 通用编辑器）
• 支持硅基流动、智谱 CogView、豆包 Seedream、OpenAI DALL·E 及自定义 OpenAI 兼容生图接口（硅基流动与智谱提供免费生图模型）

二、环境要求

三、安装步骤

1. 将 AiPic 目录放入 plugins/ 下
2. 进入后台 应用中心，找到「AI 配图」，点击 安装

  - 静态资源自动复制到 public/static/AiPic/

  - 无需建表

1. 进入 应用中心 → AI 配图 → 配置，选择服务商并填入 API Key，保存
2. 点击配置弹窗中的「测试连接」验证配置可用
3. 前台进入发帖页，编辑器下方即出现「AI 配图」按钮

四、配置项说明

后台 应用中心 → AI 配图 → 配置：

服务商预设

五、前台使用

1. 发帖页填写标题与正文后，点击编辑器下方「AI 配图」按钮
2. 弹窗中默认勾选「结合当前正文」，点击 根据内容整理建议：

  - 「查看配图参考」展开显示 AI 对正文的配图方向分析

  - 「画面描述」输入框自动填入 AI 整理的画面描述

1. 可手动修改画面描述，点击风格快捷词（写实摄影 / 清新插画 / 国风水墨 / 日系动漫 / 极简扁平 / 3D 渲染）追加画风关键词
2. 选择图片比例（方图 1024×1024 / 横图 1344×768 / 竖图 768×1344，OpenAI 自动映射为官方三档）
3. 点击 生成配图，等待 10-30 秒，右侧预览生成结果
4. 满意后点击 插入正文，图片自动插入编辑器光标处；也可点「重新生成」再次绘制

六、文件结构

plugins/AiPic/
├── plugin.json              插件信息
├── AiPicPlugin.php          主类（配置表单、compose_assets 插槽注入）
├── routes.php               路由（前台 suggest/generate，后台连通性测试）
├── icon.svg                 插件图标
├── controller/
│   └── Index.php            suggest / generate / test 接口
├── service/
│   └── PicClient.php        生图服务（服务商预设、生图、建议、本地转存）
└── static/
    ├── aipic.css            弹窗与按钮样式
    └── aipic-compose.js     发帖页按钮与弹窗交互

七、接口说明

八、常见问题

Q：点击「生成配图」提示"请先在插件配置中填写 API Key"？

A：进入后台插件配置，选择服务商并填入有效 API Key 后保存。

Q：生成速度慢？

A：AI 生图通常需要 10-30 秒，属正常现象；服务端最长等待 120 秒。

Q：「根据内容整理建议」提示自定义接口无对话端点？

A：自定义接口地址需包含 /v1 才能自动推导对话端点；否则请手动填写画面描述，不影响生图。

Q：生成的图片会过期吗？

A：不会。生成成功后插件立即将图片下载转存到本站 /storage/uploads/aipic/ 目录，插入正文的是本站永久地址。

九、更新日志

v1.0.0（2026-10-20）

• 首次发布：发帖页 AI 配图按钮、两栏生图弹窗、内容建议整理、三档比例、风格快捷词、图片本地转存、一键插入正文