ZB_AICollector 详细使用教程

准备工作

1. 系统环境检查

在开始安装前，请确保您的服务器环境满足以下要求：
– PHP版本：7.4或更高
– Z-Blog版本：1.7或更高
– 数据库：MySQL 5.0或更高
– PHP扩展：cURL、JSON、MBString
– 磁盘空间：至少100MB可用空间
– 内存：建议512MB或更高

2. 获取AI服务API密钥

根据您计划使用的AI服务，提前获取相应的API密钥：
– OpenAI：访问 https://platform.openai.com/ 注册并获取API密钥
– 百度文心一言：访问 https://cloud.baidu.com/product/wenxinworkshop 注册并获取API密钥
– 其他AI服务：参考相应服务商的文档获取API密钥

3. 获取插件授权码

联系插件提供商获取有效的授权码，这是使用插件的必要条件。

插件安装

步骤1：下载插件

1. 访问插件官方下载页面
2. 下载最新版本的ZB_AICollector插件压缩包
3. 确保下载的文件完整且未损坏

步骤2：解压插件

1. 使用解压软件解压下载的压缩包
2. 确认解压后的文件夹名为”ZB_AICollector”
3. 检查文件夹内是否包含完整的插件文件

步骤3：上传插件文件

1. 使用FTP工具或文件管理器连接到您的服务器
2. 导航到Z-Blog安装目录下的zb_users/plugin/文件夹
3. 将解压后的”ZB_AICollector”文件夹上传到此目录
4. 确保上传后的文件权限正确（一般文件夹权限为755，文件权限为644）

步骤4：启用插件

1. 登录Z-Blog后台管理系统
2. 点击左侧菜单中的”插件管理”
3. 在插件列表中找到”ZB_AICollector”
4. 点击”启用”按钮激活插件
5. 启用成功后，左侧菜单会出现”AI内容采集”选项

初始配置

步骤1：授权设置

1. 点击左侧菜单中的”AI内容采集”→”授权设置”
2. 在”授权码”输入框中输入您获取的有效授权码
3. 点击”验证授权”按钮验证授权码是否有效
4. 验证成功后，点击”保存”按钮保存设置

步骤2：AI服务配置

1. 点击左侧菜单中的”AI内容采集”→”AI设置”
2. 在”AI服务提供商”下拉菜单中选择您使用的AI服务（如OpenAI）
3. 在”API密钥”输入框中输入您的API密钥
4. 根据需要调整以下参数：
   • 温度值：控制AI输出的随机性（0-1，建议0.7-0.9）
   • 最大长度：控制AI生成内容的最大长度
   • 自定义提示词：根据需要自定义AI处理的提示词
5. 点击”测试连接”按钮测试API连接是否正常
6. 测试成功后，点击”保存”按钮保存设置

步骤3：采集设置

1. 点击左侧菜单中的”AI内容采集”→”采集设置”
2. 配置以下基本参数：
   • 采集间隔：设置两次采集之间的间隔时间（建议5-10秒）
   • 超时时间：设置单次采集的超时时间（建议30秒）
   • 重试次数：设置采集失败时的重试次数（建议3次）
3. 配置HTTP请求头（可选）：
   • User-Agent：模拟浏览器标识
   • Referer：设置来源页面
   • 其他自定义请求头
4. 配置内容过滤规则：
   • 最小内容长度：设置采集内容的最小字符数
   • 关键词过滤：设置需要过滤的关键词
   • 正则表达式过滤：设置高级过滤规则
5. 点击”保存”按钮保存设置

步骤4：图片设置

1. 点击左侧菜单中的”AI内容采集”→”图片设置”
2. 配置以下参数：
   • 启用图片处理：勾选此项启用图片功能
   • 图片保存路径：设置图片保存的相对路径
   • 图片最大尺寸：设置图片的最大宽度和高度
   • 图片质量：设置图片压缩质量（0-100）
3. 配置图片插入规则：
   • 每篇文章插入图片数量：设置最小和最大值
   • 图片插入位置：选择图片插入的位置（文章开头、结尾、随机位置等）
4. 点击”保存”按钮保存设置

步骤5：发布设置

1. 点击左侧菜单中的”AI内容采集”→”发布设置”
2. 配置以下参数：
   • 默认分类：选择文章发布的默认分类
   • 文章状态：选择文章的初始状态（发布/草稿）
   • 默认作者：选择文章的默认作者
   • 标签处理：设置标签的自动处理方式
3. 配置发布规则：
   • 发布间隔：设置两篇文章发布之间的间隔时间
   • 每日发布限制：设置每天最多发布的文章数量
   • 发布时间：设置文章发布的具体时间（立即发布/定时发布）
4. 点击”保存”按钮保存设置

基础功能使用

任务1：创建基础采集任务

步骤1：创建新任务

1. 点击左侧菜单中的”AI内容采集”→”任务管理”
2. 点击右上角的”新建任务”按钮
3. 在弹出的对话框中输入任务名称（如”新闻采集任务”）
4. 点击”确定”按钮创建任务

步骤2：配置采集URL

1. 在任务编辑页面，找到”采集URL”部分
2. 在URL输入框中输入要采集的网页地址，每行一个URL
3. 您可以输入多个URL，如：https://example.com/news/1 https://example.com/news/2 https://example.com/news/3
4. 如果有大量URL，可以点击”上传URL文件”按钮上传包含URL的文本文件

步骤3：配置内容提取规则

1. 在任务编辑页面，找到”内容提取规则”部分
2. 设置标题提取规则：
3. 选择提取方式（CSS选择器/ XPath/正则表达式）
4. 输入相应的提取规则（如CSS选择器：h1.title）
5. 设置正文提取规则：
6. 选择提取方式
7. 输入相应的提取规则（如CSS选择器：div.content）
8. 设置其他元素提取规则（可选）：
9. 作者：如CSS选择器：span.author
10. 发布时间：如CSS选择器：time.publish-date
11. 标签：如CSS选择器：div.tags a

步骤4：配置AI处理选项

1. 在任务编辑页面，找到”AI处理”部分
2. 启用AI改写：勾选此项启用AI改写功能
3. 设置改写参数：
4. 改写程度：选择改写的程度（轻度/中度/深度）
5. 保留关键词：设置需要保留的关键词，每行一个
6. 排除关键词：设置需要排除的关键词，每行一个
7. 自定义提示词（可选）：
8. 在提示词输入框中输入自定义的AI处理提示词

步骤5：配置发布选项

1. 在任务编辑页面，找到”发布选项”部分
2. 选择文章分类：从下拉菜单中选择文章发布的分类
3. 设置文章状态：选择”发布”或”草稿”
4. 选择文章作者：从下拉菜单中选择文章作者
5. 设置标签处理方式：选择自动提取标签、使用固定标签或不添加标签

步骤6：保存并运行任务

1. 点击页面底部的”保存”按钮保存任务设置
2. 保存成功后，返回任务列表
3. 在任务列表中找到刚创建的任务
4. 点击任务右侧的”运行”按钮开始执行任务
5. 系统会显示任务执行进度和结果

步骤7：查看执行结果

1. 任务执行完成后，点击任务右侧的”查看结果”按钮
2. 在结果页面可以查看：
3. 成功采集的文章数量
4. 失败的URL及原因
5. 采集到的文章列表
6. 点击文章标题可以预览文章内容
7. 如需修改，可以点击”编辑”按钮进行编辑

任务2：设置定时任务

步骤1：编辑现有任务

1. 在任务管理页面，找到要设置定时的任务
2. 点击任务右侧的”编辑”按钮

步骤2：配置定时任务

1. 在任务编辑页面，找到”定时任务”部分
2. 启用定时任务：勾选”启用定时任务”选项
3. 设置执行频率：
4. 每分钟：每隔几分钟执行一次
5. 每小时：每隔几小时执行一次
6. 每天：每天的特定时间执行
7. 每周：每周的特定日期和时间执行
8. 每月：每月的特定日期和时间执行
9. 设置具体执行时间：
10. 如果选择”每天”，设置具体的小时和分钟
11. 如果选择”每周”，选择星期几和具体时间
12. 如果选择”每月”，选择日期和具体时间

步骤3：保存定时设置

1. 点击页面底部的”保存”按钮保存定时设置
2. 系统会显示”定时任务设置成功”的提示
3. 返回任务列表，可以看到任务状态变为”定时任务”

步骤4：管理定时任务

1. 在任务管理页面，可以查看所有定时任务的状态
2. 可以随时启用/禁用定时任务
3. 可以修改定时任务的执行频率和时间
4. 可以手动触发定时任务立即执行

高级功能使用

任务3：仅AI生成模式

步骤1：创建新任务

1. 点击”新建任务”按钮创建一个新任务
2. 输入任务名称（如”AI生成任务”）

步骤2：配置仅AI生成模式

1. 在任务编辑页面，找到”AI处理”部分
2. 启用AI改写：勾选此项
3. 启用仅AI生成模式：勾选”仅AI生成”选项
4. 添加关键词：
5. 在关键词输入框中输入关键词，每行一个
6. 或者点击”上传关键词文件”按钮上传包含关键词的文本文件

步骤3：设置生成参数

1. 设置文章长度：选择文章的大致长度（短篇/中篇/长篇）
2. 设置文章风格：选择文章的风格（新闻/博客/技术等）
3. 设置生成数量：设置每次任务执行生成的文章数量
4. 自定义提示词：输入更详细的生成指令，如：
   “请根据提供的关键词生成一篇关于科技新闻的文章，要求：
5. 文章长度在800-1000字之间
6. 包含引言、正文和结论
7. 语言风格专业但不失通俗
8. 包含至少3个相关技术术语的解释”

步骤4：配置发布选项

1. 选择文章分类、状态和作者
2. 设置标签处理方式
3. 配置发布间隔和数量限制

步骤5：保存并运行任务

1. 点击”保存”按钮保存任务设置
2. 点击”运行”按钮开始执行任务
3. 系统会根据关键词生成文章并自动发布

任务4：批量任务管理

步骤1：批量创建任务

1. 在任务管理页面，点击”批量操作”按钮
2. 选择”批量创建任务”选项
3. 上传包含任务配置的CSV文件
4. 系统会根据CSV文件内容批量创建任务

步骤2：批量启动任务

1. 在任务列表中勾选要启动的任务
2. 点击上方的”批量操作”按钮
3. 选择”批量启动”选项
4. 系统会依次启动选中的任务

步骤3：批量删除任务

1. 在任务列表中勾选要删除的任务
2. 点击上方的”批量操作”按钮
3. 选择”批量删除”选项
4. 确认删除操作

任务5：日志分析与问题排查

步骤1：查看操作日志

1. 点击左侧菜单中的”AI内容采集”→”日志管理”
2. 在日志页面可以查看所有操作记录
3. 使用筛选功能按日期、类型筛选日志

步骤2：查看错误日志

1. 在日志管理页面，点击”错误日志”选项卡
2. 查看系统记录的错误信息
3. 点击错误详情可以查看更多错误信息

步骤3：下载日志文件

1. 在日志管理页面，点击”下载日志”按钮
2. 选择要下载的日志类型（操作日志/错误日志/调试日志）
3. 选择日期范围
4. 点击”下载”按钮下载日志文件

步骤4：分析日志

1. 使用文本编辑器打开下载的日志文件
2. 搜索关键词（如”错误”、”失败”）定位问题
3. 分析错误发生的时间和原因
4. 根据错误信息采取相应措施

常见问题解决

问题1：插件安装失败

症状：安装插件时提示错误或安装后无法启用

解决方案：
1. 检查PHP版本是否满足要求（5.3+）
2. 检查Z-Blog版本是否满足要求（1.5+）
3. 检查必要PHP扩展是否已安装（cURL、JSON、MBString）
4. 检查文件权限是否正确（文件夹755，文件644）
5. 检查磁盘空间是否充足
6. 重新下载插件文件并重新安装

问题2：授权验证失败

症状：输入授权码后提示”授权验证失败”

解决方案：
1. 检查授权码是否正确（注意区分大小写）
2. 检查授权码是否已过期
3. 检查网络连接是否正常
4. 尝试联系插件提供商获取新的授权码
5. 检查服务器时间是否正确

问题3：AI服务连接失败

症状：测试AI服务连接时提示失败

解决方案：
1. 检查API密钥是否正确
2. 检查网络连接是否正常
3. 检查AI服务是否可用
4. 检查服务器是否支持HTTPS
5. 检查防火墙设置是否阻止了API请求
6. 尝试更换AI服务提供商

问题4：采集内容为空

症状：任务执行成功但采集到的内容为空

解决方案：
1. 检查URL是否可访问
2. 检查内容提取规则是否正确
3. 使用浏览器开发者工具检查网页结构
4. 尝试使用不同的提取规则
5. 检查目标网站是否有反爬虫机制
6. 尝试添加更多请求头模拟真实浏览器

问题5：AI改写质量差

症状：AI改写后的内容质量不理想

解决方案：
1. 调整AI温度值（建议0.7-0.9）
2. 优化自定义提示词
3. 设置保留关键词和排除关键词
4. 尝试不同的AI服务提供商
5. 启用内容过滤规则
6. 考虑人工审核和修改

问题6：定时任务不执行

症状：设置的定时任务没有按时执行

解决方案：
1. 检查服务器系统时间是否正确
2. 检查定时任务是否已启用
3. 检查任务状态是否正常
4. 查看定时任务日志
5. 检查服务器cron服务是否正常运行
6. 尝试手动触发定时任务

问题7：图片下载失败

症状：图片处理功能启用但图片下载失败

解决方案：
1. 检查图片URL是否有效
2. 检查图片保存路径是否有写入权限
3. 检查磁盘空间是否充足
4. 检查图片URL是否使用HTTPS
5. 检查防火墙设置是否阻止了图片下载
6. 尝试调整图片处理参数

---

总结

通过本教程，您应该已经掌握了ZB_AICollector插件的详细使用方法。从插件安装到基础功能使用，再到高级功能应用，每一步都有详细的说明。如果您在使用过程中遇到问题，可以参考常见问题解决部分，或者查看日志文件获取更多错误信息。

记住，合理使用插件可以帮助您大幅提高内容生产效率，但也要注意遵守相关法律法规，尊重原创内容，确保网站内容的合法性和质量。

祝您使用愉快！