【Ciuic自动配图发文 操作手册】
# Ciuic自动配图发文 操作手册
## 一、功能概述
本插件用于 Z-Blog 自动 AI 发文和自动配图，支持通义千问和 DeepSeek 大模型。
核心功能：
- AI 自动发文：通过触达地址调用 AI，根据关键词自动生成文章并发布
- 自动配图：发布文章时自动合成配图（背景 + 文字标题），或为无图文章自动插入配图
- 关键词管理：支持上传/指定关键词文件，每次调用消费一个关键词
## 二、页面导航
后台管理入口有 4 个子页签：
页签
功能
插件说明
使用协议、技术支持、QQ群
配置中心
基础配置（写作指令、作者、分类、关键词文件、触达地址等）
通义千问
AI 模型配置（API Key、模型选择）
自动配图
配图参数配置和背景图片上传
## 三、配置中心
配置项
说明
默认值
快捷键显示位置
插件入口在后台导航的显示位置
无
写作指令
AI 生成文章的 Prompt，{$textkey} 会被替换为关键词
空
默认作者ID
生成文章的默认作者
空
默认分类
生成文章的默认所属分类
空
默认AI
当前固定为「通义千问」
1
关键词地址
关键词 txt 文件路径（相对于网站根目录）
空
访问密钥
触达地址的 code 校验参数
自动生成 GUID
触达地址
用于触发自动发文的 URL（只读）
自动生成
输出结果
成功返回 1，失败返回 0
—
可选配置
带参数覆盖的触达地址格式
—
### 3.1 写作指令示例
写一篇文章关于{$textkey}的文章，内容不少于1000个字。格式要求：第一行是文章标题，使用Markdown格式，包含h3小标题。
### 3.2 触达地址格式
基础格式：
https://你的域名/zb_users/plugin/ciuic_aipost/api.php?code=你的密钥
带可选参数（覆盖默认值）：
https://你的域名/zb_users/plugin/ciuic_aipost/api.php?code=xxx&uid=作者ID&cid=分类ID&ai=1
### 3.3 上传关键词文件
在配置中心页面底部可上传 .txt 关键词文件。每行一个关键词，上传后自动填充到「关键词地址」字段。
执行流程：
1. 请求触达地址
2. 从关键词文件中随机取出一行（该关键词被消费并从文件中删除）
3. 替换写作指令中的 {$textkey} 为关键词
4. 调用 AI 生成文章
5. 解析返回内容，提取标题和正文
6. 发布为 ZBlog 文章
## 四、通义千问（AI 模型配置）
配置项
说明
KEY
阿里云 DashScope API Key
模型
qwen-plus 或 deepseek-v3
### 4.1 获取 API Key
1. 访问 阿里云模型服务灵积 https://dashscope.aliyuncs.com/
2. 注册/登录阿里云账号
3. 开通模型服务
4. 在 API-KEY 管理页面创建 Key
### 4.2 模型说明
模型
说明
qwen-plus
通义千问增强版，能力均衡，性价比高
deepseek-v3
DeepSeek V3，通过阿里云兼容接口调用
## 五、自动配图
### 5.1 配置项
配置项
说明
默认值
自动插图
开启后，无图文章发布时自动插入配图
0（关闭）
图片宽度
生成配图的宽度（像素），高度为宽*2/3
500
文字大小
配图上标题文字字号
16
压缩图片
JPEG 压缩率（1-100）
50
### 5.2 配图生成原理
插件使用 PHP GD 库合成配图：
1. 从 static/image/one/ 目录随机选一张背景图
2. 从 static/image/two/ 目录随机选一张前景叠加图
3. 将文章标题文字渲染到图片上
4. 保存到 zb_users/upload/ciuic_aipost_YYYYMMDD/ 目录
### 5.3 上传背景图片
在自动配图页面底部可批量上传背景图（支持 .jpg/.jpeg/.png，可多选）。
### 5.4 配图触发方式
AI 发文触发：通过 api.php 生成文章后，自动调用配图保存（已默认开启）
手动发文触发：如果开启了「自动插图」，通过后台手动发布文章时也会自动插入配图
条件：仅在文章内无 img 标签时触发
## 六、定时任务配置
将触达地址配置到 cron job 实现定时自动发文：
Linux crontab（每30分钟发一篇）：
*/30 * * * * /usr/bin/curl -s "https://你的域名/zb_users/plugin/ciuic_aipost/api.php?code=你的密钥"
Windows 计划任务：
powershell -Command "Invoke-WebRequest -Uri 'https://你的域名/zb_users/plugin/ciuic_aipost/api.php?code=你的密钥'"
## 七、操作规则与注意事项
1. PHP GD 扩展必须安装：自动配图功能依赖 GD 库，请确保 PHP 已安装 GD 扩展
2. API Key 安全：请妥善保管 DashScope API Key，不要泄露
3. AI 调用有费用：调用通义千问/DeepSeek API 会产生费用，请关注阿里云账户余额
4. 关键词消费不可逆：每次触发会从关键词文件中删除一行，请做好关键词文件的备份
5. 访问密钥安全：触达地址中的 code 参数为安全校验，请妥善保管，不要泄露到公开位置
6. code 可随时修改：在配置中心修改「访问密钥」后，旧的触达地址立即失效
7. 文章格式要求：AI 返回的第一行会被解析为文章标题，剩余内容为正文。建议在写作指令中明确格式要求
8. 配图文件路径：配图保存在 zb_users/upload/ciuic_aipost_日期/ 目录下，按日期分子目录
9. 模型兼容性：插件通过阿里云 DashScope 兼容接口调用，支持 qwen-plus 和 deepseek-v3 两种模型
10. 文章默认状态：生成的文章直接发布为已发布状态（PostTime=当前时间）
11. Markdown 支持：AI 返回的内容会通过 Parsedown 转换为 HTML，支持 Markdown 格式
12. 关键词文件格式：纯文本，每行一个关键词，UTF-8 编码
