首页 功能详情 应用场景 服务报价 使用文档
DOCUMENTATION

Refine 使用文档

从 AI 创作到发文中心,八个模块的完整操作指南。适合首次上手的运营人员和系统管理员。

系统概述

Refine 发文精炼系统是一款面向网站运营和 SEO 团队的软文自动生产工具。 它把转载内容、AI 初稿、网页粘贴稿精炼成可直接发布的原创内容,自动配图,一键发布到主流建站程序。

定位:管理网站平台文章更新和专业的软文发布,不是自媒体发布工具。
建站平台:内置对接 WordPress / Z-Blog / EyouCMS,自定义平台可通过 Webhook 接入。

系统包含六大核心模块 + 两个管理模块:

  • AI 创作 - AI 复写 + AI 以词写文
  • AI 配图 - 以文生图、站外补图、图库取图、收藏图夹
  • 二创优化 - 格式优化 + 伪原创
  • 关键词挖掘 - 挖词台 + 关键词夹
  • 发文中心 - 草稿箱 + 一键发文
  • 规则中心 - AI 创作规则、生图规则、格式规则
  • 处理历史 - 七类操作全链路留痕
  • 通用设置 - 模型配置、图库 API、平台接入、对象存储、账号设置

AI 创作

AI 创作模块包含两个子功能:AI 复写和 AI 以词写文,是系统的核心精炼引擎。

AI 复写

把转载内容、AI 初稿或网页链接粘贴进来,选择AI 复写规则后一键复写成原创可发布内容。 AI 复写规则在规则中心 → AI 创作规则中配置,默认自动勾选,配置一次反复使用。

操作步骤

  • 进入 AI 创作 → AI 复写
  • 粘贴原稿内容(支持纯文本、HTML、网页 URL)
  • 选择AI 复写规则(可多选,默认勾选已配置的规则)
  • 点击"开始复写",等待 AI 生成结果
  • 生成后可预览、编辑、继续优化,确认后保存到草稿箱

AI 以词写文

输入关键词或 URL,AI 直接生成完整文章。关键词可从关键词挖掘 → 挖词台获取, 也可手动输入。支持控制文章长度、风格和结构。

操作步骤

  • 进入 AI 创作 → AI 以词写文
  • 输入关键词(可多个,换行分隔)或粘贴 URL
  • 选择文章风格和长度偏好
  • 点击"开始生成",AI 生成文章初稿
  • 生成后可继续精炼、优化格式,保存到草稿箱

AI 配图

AI 配图模块提供四条配图链路,从 AI 生图到团队素材库,覆盖全部配图场景。

以文生图

读取文章内容,AI 自动分析并生成配图。支持自定义图片风格、尺寸和数量。 生成规则在规则中心 → 生图规则中配置。

  • 进入 AI 配图 → 以文生图
  • 选择文章(可从草稿箱或历史记录中选择)
  • 选择生图规则,配置数量、风格、尺寸
  • 点击生成,AI 自动生成配图
  • 预览并选择满意的图片,保存到收藏图夹或直接插入文章

站外补图

抓取站外可用图片资源,按关键词检索并补充到文章配图中。 适用于版权允许的免费图片资源。

  • 进入 AI 配图 → 站外补图
  • 输入检索关键词或选择文章自动提取关键词
  • 选择图片来源和数量
  • 检索结果可直接使用或保存到收藏图夹

图库取图

对接 Pixabay 等图库平台,按关键词检索高质量免费图片。 需在通用设置 → 图库 API中配置 API 密钥。

  • 进入 AI 配图 → 图库取图
  • 输入检索关键词(支持中英文)
  • 设置检索数量和图片尺寸过滤
  • 检索结果可直接取用或保存到收藏图夹

收藏图夹

团队共享的图片素材库。所有配图、取图的结果都可以保存到图夹中, 跨文章、跨项目复用。支持分类管理和批量操作。

二创优化

二创优化模块负责格式调整和伪原创处理,让内容通过平台检测并适配多平台分发。

格式优化

对文章进行排版优化--段落间距、标题层级、图片尺寸、样式适配。 格式规则在规则中心 → 格式规则中统一管理。

  • 进入 二创优化 → 格式优化
  • 选择待优化的文章(草稿或历史记录)
  • 选择格式规则(可多选)
  • 点击"开始优化",系统自动调整排版
  • 预览并确认优化结果

伪原创

对文章进行同义改写和替换词处理,提高原创度。 替换词规则在格式规则中统一配置,支持自定义词库。

  • 进入 二创优化 → 伪原创
  • 选择待处理的文章
  • 设置原创度目标(轻度/中度/深度)
  • 选择替换词规则
  • 点击"开始伪原创",系统自动处理
  • 预览并对比原文与改写结果

关键词挖掘

关键词挖掘模块负责选题发现和词库沉淀,直接驱动 AI 以词写文。

挖词台

关键词挖掘与选题发现工具。输入种子词或行业领域,系统自动扩展相关关键词。 挖掘结果可直接用于 AI 以词写文,或将高频词保存到关键词夹。

  • 进入 关键词挖掘 → 挖词台
  • 输入种子关键词或行业名称
  • 选择挖掘深度和范围
  • 查看挖掘结果,筛选高价值关键词
  • 直接发送到 AI 以词写文,或保存到关键词夹

关键词夹

关键词词库管理工具。沉淀挖掘到的关键词,跨项目、跨文章复用。 支持分类管理、批量导入导出。

  • 进入 关键词挖掘 → 关键词夹
  • 创建分类目录,管理关键词组
  • 从挖词台添加关键词,或手动录入
  • 选择关键词批量发送到 AI 以词写文

发文中心

发文中心负责草稿管理和一键发布,是内容生产流的最后一环。

草稿箱

所有 AI 创作、优化后的文章统一存储在草稿箱中。 支持编辑、预览、分类管理。草稿在发布前可以反复修改和优化。

  • 进入 发文中心 → 草稿箱
  • 查看文章列表,编辑或预览草稿
  • 草稿支持分类标记和筛选
  • 确认无误后,点击"发布"推送到目标平台

发文中心

一键发布到已接入的建站平台。支持多站点并行发布, 发布后自动记录发文历史,全链路可回溯。

  • 进入 发文中心 → 发文中心
  • 选择待发布的草稿(可多选)
  • 选择目标平台(WordPress / Z-Blog / EyouCMS)
  • 选择目标站点(支持多站点同时发布)
  • 点击"一键发布",系统自动推送
  • 在处理历史 → 发文历史中查看发布结果
平台接入:在通用设置 → 平台接入中配置。 内置 WordPress / Z-Blog / EyouCMS 三种平台,自定义平台可通过 Webhook 接入。

规则中心

规则中心是系统的自动化引擎。用规则描述生产流程,配置一次持续运行。 规则添加后自动出现在对应处理台的规则选择区。

AI 创作规则

控制 AI 复写和 AI 以词写文的行为。包含复写规则和直写规则两类。

  • 进入 规则中心 → AI 创作规则
  • 创建规则:设置名称、描述、适用的创作类型
  • 配置精炼参数:内容长度、写作风格、保留要素、输出格式
  • 规则默认自动勾选,在 AI 创作页面自动生效

生图规则

控制 AI 配图的生成行为。定义图片风格、数量、尺寸、来源优先级。

  • 进入 规则中心 → 生图规则
  • 创建规则:设置图片风格、数量、尺寸
  • 配置图片来源优先级(以文生图优先 / 图库取图优先)
  • 在"以文生图"页面自动生效

格式规则

控制格式优化和伪原创的行为。包含排版规范和替换词规则。

  • 进入 规则中心 → 格式规则
  • 创建排版规则:段落间距、标题层级、图片尺寸规范
  • 创建替换词规则:配置同义词库和替换策略
  • 在"格式优化"和"伪原创"页面自动生效

处理历史

系统所有操作全链路留痕,共七类历史记录,可查询、可回溯:

  • 格式优化历史 - 每次格式优化的输入输出对比
  • AI 复写历史 - 每次 AI 复写的原稿和结果
  • 伪原创历史 - 每次伪原创处理的原文和改写结果
  • AI 以词写文历史 - 以词写文生成记录
  • 挖词历史 - 关键词挖掘记录
  • 发文历史 - 发布到各平台的结果和状态
  • 生图历史 - 以文生图、图库取图记录

每条历史记录包含:操作时间、输入内容、输出结果、使用的规则、处理耗时。

通用设置

通用设置包含系统基础设施配置,通常由管理员操作。

模型配置

配置 AI 模型接入参数。支持自定义 API 地址、模型名称、请求参数。 系统预设通用模型,也可手动添加第三方模型。

  • 进入 通用设置 → 模型配置
  • 查看已配置的模型列表
  • 添加新模型:填写 API 端点、密钥、模型名称
  • 配置默认模型和备用模型

图库 API

配置图库平台的 API 密钥。当前支持 Pixabay。 配置后,图库取图功能即可使用。

  • 进入 通用设置 → 图库 API
  • 填写 API 密钥并保存
  • 测试连接确认配置生效

平台接入

配置目标建站平台的连接信息。支持多平台、多站点同时管理。

  • 进入 通用设置 → 平台接入
  • 选择平台类型(WordPress / Z-Blog / EyouCMS / 自定义 Webhook)
  • 填写站点地址、API 凭证
  • 测试连接,确认发文通道正常
  • 可添加多个站点,每个站点独立配置

对象存储

配置图片和稿件的存储方式。支持阿里云 OSS、腾讯云 COS 和本地存储。

  • 进入 通用设置 → 对象存储
  • 选择存储类型(OSS / COS / 本地)
  • 填写 Access Key、Bucket 等信息
  • 测试上传确认配置生效

账号设置

修改个人账号信息、密码和偏好设置。位于 通用设置 → 账号设置。

后台设置(管理员)

系统级配置,包括品牌信息、功能开关、运行环境等。位于 通用设置 → 后台设置。

系统安装

系统支持一键部署到 Linux 服务器(推荐宝塔面板),也支持本地开发环境(如 upupw)。 以下以宝塔面板为例说明完整安装流程。

运行环境要求:PHP ≥ 8.1(推荐 8.3)| MySQL ≥ 5.5(推荐 5.7+)| Nginx ≥ 1.18 | 内存 ≥ 512MB

环境依赖

系统依赖以下 PHP 扩展,部署前务必确认全部已安装并启用:

  • pdo_mysql - 数据库连接
  • mbstring - 多字节字符串处理(中文必需)
  • curl - HTTP 请求(AI 接口、远程抓取)
  • openssl - HTTPS 加密通信
  • json - JSON 编解码
  • gd - 图片处理(缩放、水印)
  • fileinfo - 文件类型检测(上传校验)
  • session - 会话管理
  • bcmath - 高精度数学运算
  • dom / SimpleXML / xml / xmlreader / xmlwriter - XML 与 HTML 解析
  • sockets - Socket 通信
  • intl - 国际化支持
  • filter - 数据过滤

宝塔面板安装扩展:软件商店 → PHP-8.3 → 设置 → 安装扩展,搜索并安装缺失的扩展。

安装步骤

1. 创建站点

  • 宝塔 → 网站 → 添加站点 → 填写域名、选择 PHP 8.3
  • 确认 PHP 扩展全部就绪

2. 上传文件

  • 将站点目录所有文件上传到站点根目录
  • 确保 config.php、index.php、app/、storage/、views/ 等目录完整

3. 创建数据库

  • 宝塔 → 数据库 → 添加数据库
  • 记录数据库名、用户名、密码,后续配置使用

4. 配置伪静态

宝塔 → 站点设置 → 伪静态 → 自定义,填入:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

5. 配置 Nginx PHP-FPM

确保 Nginx 配置中 PHP-FPM socket 路径正确(宝塔默认 /tmp/php-cgi-83.sock):

location ~ \.php$ {
    fastcgi_pass unix:/tmp/php-cgi-83.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
    fastcgi_read_timeout 300;
}

6. 设置权限

storage/ 目录需要 Web 用户可写:

chown -R www:www /www/wwwroot/your-domain.com/storage/
chmod -R 755 /www/wwwroot/your-domain.com/storage/

7. 运行安装向导

  • 浏览器访问 http://你的域名/install/
  • 在安装向导中填写数据库信息和创建管理员账号
  • 安装完成后系统自动标记,建议删除 install/ 目录

8. 添加定时任务(可选)

宝塔 → 计划任务 → 添加 Shell 脚本,每分钟执行:

/www/server/php/83/bin/php /www/wwwroot/your-domain.com/cron/publish.php

数据迁移

从本机开发环境迁移到服务器:

# 导出数据库
mysqldump -u 用户名 -p 数据库名 > refine_backup.sql

# 导入到服务器
mysql -u 用户名 -p 数据库名 < refine_backup.sql

# 同步 storage 目录(品牌 logo、AI 图片、同义词库等)
rsync -avz /本地路径/storage/ root@服务器:/www/wwwroot/域名/storage/

storage/cache/ 和 storage/logs/ 可以不同步(会自动重建)。

常见问题

部署相关

502 Bad Gateway

通常是 PHP-FPM 未启动或 Nginx 的 socket 路径配置错误。检查:

  • 确认 PHP-FPM 正在运行:ps aux | grep php-fpm
  • 确认 socket 文件存在:ls /tmp/php-cgi-83.sock
  • 查看 Nginx 错误日志:tail -20 /www/wwwlogs/你的域名.error.log

白屏或 Fatal Error

最常见原因是缺少 mbstring 扩展。检查 PHP 错误日志确认,然后在宝塔面板安装该扩展。

上传图片提示「仅支持 PNG、JPG、WEBP 或 GIF」

PHP 缺少 fileinfo 扩展。系统已内置降级方案(通过文件扩展名推断 MIME 类型),确保上传的文件扩展名正确。如需完整支持,在宝塔面板安装 fileinfo 扩展。

数据库连接失败

确认 config.php 中的数据库主机、端口、库名、用户名、密码正确,且 MySQL 用户有对应数据库的完整权限。

定时任务不执行

检查 cron 是否配置正确:crontab -l,查看日志输出。

AI 功能相关

AI 复写 / 以词写文返回异常或超时

常见原因:

  • AI 模型 API 密钥失效或余额不足
  • 网络不通(服务器无法访问 AI 接口地址)
  • 请求超时--在 通用设置 → 模型配置 中调整超时时间
  • PHP 缺少 curl 或 openssl 扩展

AI 生图无响应

检查 规则中心 → 生图规则 中的配置是否正确,确保模型配置中已关联生图模型。同时确认 通用设置 → 模型配置 中的生图模型 API 端点可用。

SSL 证书验证失败

服务器与 AI 服务商通信时出现 SSL 证书验证错误。解决方案:

  • 更新服务器 CA 证书包:apt update && apt install ca-certificates
  • 配置 PHP 的 curl.cainfo 指向正确的 CA 证书路径
  • 如果使用宝塔面板,确认 PHP 的 curl 扩展已启用

发文相关

文章发布到 WordPress / Z-Blog 失败

检查:

  • 通用设置 → 平台接入 中的站点地址和 API 凭证是否正确
  • 目标平台的 API 是否已启用(WordPress 需安装 REST API,Z-Blog 需确认 API 插件)
  • 目标站点是否可访问(防火墙/安全组是否放行)
  • 在处理历史 → 发文历史中查看具体失败原因

自定义平台 Webhook 不生效

确认 Webhook URL 正确且可访问,目标服务能接收 POST 请求并返回 200 状态码。可以通过 curl 手动测试 Webhook 端点。

图片相关

图库取图(Pixabay)无结果

检查 通用设置 → 图库 API 中的 API 密钥是否配置正确,Pixabay 免费 API 有每日请求次数限制。

对象存储上传失败

检查 通用设置 → 对象存储 中的 Access Key、Secret Key、Bucket 名称和 Region 是否正确。确认 Bucket 的读写权限已开放。

系统维护

如何备份系统

定期备份两部分:数据库(通过宝塔面板或 mysqldump 导出)+ storage/ 目录(品牌 logo、AI 生成的图片、同义词库等)。建议设置宝塔的自动备份计划。

升级 PHP 版本后系统异常

升级 PHP 后需重新安装所有依赖扩展,并确认 config.php 配置正确。必要时重启 PHP-FPM 和 Nginx。