WP Manifestindependent plugin directory
manifest / seo / wp-ai-seo-geo

WordPress AI SEO + GEO 智能优化

对 WordPress 全站内容实现 AI 生成 + AI 优化,同时完成 SEO 与 GEO 两大优化方向。

by ivye · github.com/3900132/wp-ai-seo-geo

2stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/3900132/wp-ai-seo-geo/archive/refs/heads/main.zip

Readme

WP AI SEO + GEO 智能优化 — 完整文档

版本 1.8.0 · 作者 ivye · 支持 WordPress 5.0+


目录

用户使用手册

  1. 安装与激活
  2. 基本设置
  3. 单篇文章优化(编辑页)
  4. SEO 评分面板
  5. 批量优化
  6. AI 文章生成
  7. 优化历史
  8. 文章列表 AI 状态列
  9. 定时自动优化
  10. 核心工作流程
  11. 任务中断恢复
  12. 常见问题

开发者文档

  1. 插件结构
  2. 核心类说明
  3. AJAX 接口列表
  4. 数据库结构
  5. 主要 WordPress Hook
  6. 扩展开发指南
  7. 更新日志

用户使用手册

1. 安装与激活

  1. 将插件文件夹 wp-ai-seo-geo 上传到 /wp-content/plugins/
  2. 进入 WordPress 后台 → 插件 → 启用 WP AI SEO + GEO 智能优化
  3. 启用后左侧菜单出现 🤖 AI SEO+GEO 菜单组,首先进入 基本设置 完成 API 配置

2. 基本设置

路径:AI SEO+GEO → 基本设置

一、AI 大模型接口配置(必填)

字段 说明
API 地址(Base URL) 兼容 OpenAI 格式的接口地址,例如 https://api.openai.com/v1、DeepSeek、文心等
API Key 对应平台的密钥
模型名称 例如 gpt-4odeepseek-chaternie-4.0
轻量模型名称 可选,用于 SEO 字段优化等轻量任务,如 gpt-4o-minideepseek-chat,可节省约 90% 费用。留空则统一使用主模型
请求超时 建议 60~120 秒,生成长文需要更多时间
温度 0.1~0.7,越低越稳定,推荐 0.3;需要多样性可调至 0.5~0.7
最大 Tokens 控制 AI 单次最大返回长度,推荐 4096;生成长文可设 8192

连通测试:填写好 API 信息后,点击「测试连接」按钮,插件会用当前填写的配置发送一条极短请求,即时验证接口是否可用,无需提前保存设置。如配置了轻量模型,还会显示「测试轻量模型」按钮,可单独验证轻量模型的连通性。

Token 用量统计

API 配置区底部展示累计 Token 消耗量:

  • 本月消耗:当月所有 AI 调用累计消耗的 Token 数
  • 历史累计:插件安装以来所有调用的总 Token 数
  • 点击「重置统计」可将计数清零(不影响 AI 功能本身)

二、系统提示词(角色 Prompt)

相当于告诉 AI "你是谁、写作风格是什么"。每次调用 AI 时都会先发送这段内容。

  • 留空:使用内置默认提示词(适合大多数场景)
  • 自定义:设置行业角色、语言风格、禁止事项等

支持变量(会自动替换为当前文章内容):

变量 替换为
[标题] 文章标题
[内容] 文章正文
[关键词] SEO 关键词
[摘要] 文章摘要
[描述] SEO 描述

⚠️ Token 警告

  • [内容] 会插入完整正文,导致正文在系统提示词与用户提示词中各发送一次(Token 翻倍),长文章尤其消耗大;
  • 任何变量都会让系统提示词每次内容不同,破坏 OpenAI/Claude 的 prompt caching 命中率(批量优化场景下损失最明显);
  • 建议:留空或写不含变量的纯静态角色描述,插件已自动将文章信息正确传递给 AI。

示例:

你是家居装修领域的资深编辑,写作风格简洁亲切,面向普通家庭用户。
严禁出现价格数字,严禁推荐具体品牌。

三、支持的文章类型

勾选需要开启 AI 功能的文章类型。勾选后,该类型编辑页才显示 AI 操作面板。

四、SEO 字段名配置

插件自动兼容主流 SEO 插件,一般无需修改

SEO 插件 标题字段 描述字段 关键词字段
Yoast SEO _yoast_wpseo_title _yoast_wpseo_metadesc _yoast_wpseo_focuskw
RankMath rank_math_title rank_math_description rank_math_focus_keyword
AIOSEO _aioseo_title _aioseo_description _aioseo_keywords
SEOPress _seopress_titles_title _seopress_titles_desc _seopress_analysis_target_kw

如使用其他 SEO 插件,在此手动填写对应的 meta key 名称。可在数据库 wp_postmeta 表中查找文章对应的 meta_key 来确认。

五、批量优化设置

  • 请求间隔(秒):批量优化时每篇文章之间的等待时间,防止 API 过载,推荐 3~5 秒
  • 批量任务模型(v1.6.0 新增):选择批量处理(批量优化、批量生成、批量改写、定时优化)使用的 AI 模型
    • 主模型:使用基本设置中的主模型,质量更高但费用较高(默认值)
    • 轻量模型:使用轻量模型(需先在基本设置中配置),可大幅降低 API 费用
    • 此设置为全局默认值,在批量优化页面和 AI 文章生成页面上也有独立的「使用模型」下拉框,可临时覆盖全局设置
    • 优先级:操作页面选择 > 全局设置默认值
  • 降低 AI 痕迹:勾选后启用内容润色功能。所有 AI 生成/优化的正文内容会经过二次润色,打散 AI 写作痕迹,降低被 AI 检测工具识别的概率。会额外消耗一次 API 调用(优先使用轻量模型),默认关闭
  • 润色提示词(v1.5.0 新增):自定义润色阶段的 user prompt,控制 AI 如何改写正文使其更像人类写作。必须包含 [正文] 占位符(运行时替换为待润色 HTML),留空则使用内置默认提示词。支持"查看内置默认"和"恢复为默认"
  • AI 高频词替换词库(v1.5.0 新增):自定义 AI 高频词及其替换规则
    • 格式:每行一条 原词|替换词,替换词留空 = 删除该词
    • # 开头为注释行,空行忽略
    • 留空文本框 = 使用内置默认词库(60+ 条规则)
    • 可单独关闭此功能(取消勾选"启用 AI 高频词自动替换")
    • 提供"查看/恢复默认词库"折叠面板

六、图片配置

AI 生成文章时自动插入配图,支持三种来源:

Pexels(免费)

  1. 前往 pexels.com/api 注册并申请 API Key
  2. 选择来源 Pexels,填入 API Key,点击「测试搜图」验证

Unsplash(免费)

  1. 前往 unsplash.com/developers 注册并创建 Application
  2. 选择来源 Unsplash,填入 Access Key
    • ⚠️ 是 Access Key,不是 Application ID,也不是 Secret Key
    • 位置:开发者后台 → Your Application → Keys → Access Key

AI 大模型生成图片

  • 适用于支持 OpenAI /v1/images/generations 格式的图片接口
  • 需填写:图片生成 API 地址、API Key、模型名称(如 dall-e-3)、图片尺寸

七、定时自动优化

详见 第 9 节:定时自动优化

八、Schema 结构化数据与 Canonical(v1.5.0 新增)

自动在页面 <head> 中输出 JSON-LD 结构化数据和 Canonical URL 标签。

设置项 说明
FAQPage Schema 自动提取正文 FAQ 区块(<h3>问题 + 后续段落答案),生成 FAQPage JSON-LD。配合 AI 优化生成的 FAQ 结构使用
全站基础 Schema 输出 WebSite + BreadcrumbList + Article/WebPage。完整替代主题 functions.php 中的手动 Schema 代码
Schema 类型开关 WebSite / BreadcrumbList / Article 三个类型可独立启用/关闭
默认图 URL Article Schema 图片四层兜底:特色图 → 正文第一张图 → 站点 Logo → 此默认图。留空且前三层无图时 image 不输出
Canonical URL 自动为所有页面添加 <link rel="canonical"> 标签,防止重复 URL 导致搜索引擎权重分散

Schema 注意事项

  • 启用全站基础 Schema 后,需先移除主题中原有的 Schema 输出代码,避免重复
  • Publisher logo 尺寸固定 600×600
  • FAQ 提取失败时静默跳过,不阻断页面渲染
  • 默认图 URL 未设置时,image 字段留空不输出无效链接

Canonical URL 说明

  • 覆盖所有页面类型:单篇文章/页面、首页、分类/标签归档、文章类型归档、作者页、日期归档
  • 分页页面(/page/2/)的 canonical 自动指向第一页,集中权重
  • 开启后自动移除 WordPress 默认的 rel_canonical 输出,避免重复
  • 如果已使用 Yoast / RankMath / AIOSEO 等 SEO 插件,它们通常已输出 canonical,请勿重复开启

九、内容结构模板

预定义文章结构规范,AI 生成/优化时选择模板后,按预设结构组织内容。

创建模板:点击「+ 新增模板」

字段 说明
模板名称 便于识别的名称,如"产品介绍标准模板"
文章结构 每行一个章节或段落要求,支持 Markdown 标题格式
附加要求 可选,如"每章节不少于 200 字;语气专业正式"

{关键词} 占位符:在结构中使用 {关键词},生成时会自动替换为实际关键词。

模板示例:

## {关键词}简介
介绍{关键词}的基本概念和背景

## {关键词}的核心优势
### 优势一
### 优势二

## 实际使用场景

## 选购指南

## 常见问题解答

## 总结

3. 单篇文章优化(编辑页)

进入任意文章或页面的编辑页,在编辑器下方找到 🤖 AI SEO + GEO 智能优化 面板。

完整兼容 Gutenberg(块编辑器)经典编辑器(包括可视模式和文本/代码模式)。AI 优化结果会自动填入当前使用的编辑器。

使用模型(v1.6.3 新增)

面板顶部和右侧边栏「🤖 AI 快捷操作」区各有一个「🧠 使用模型」下拉框,两处实时联动同步。选择后,本页所有 AI 操作(AI 生成文章、一键优化全部、仅优化 SEO、单字段优化、点击 SEO 评分指示灯修复)都使用所选模型:

  • 主模型:质量更高,费用较高
  • 轻量模型:大幅降低 API 费用(需先在「基本设置」中配置轻量模型名称)

默认选中轻量模型(如已配置),未配置轻量模型时仅显示主模型选项。

AI 生成文章(从零创作)

在面板第一区域:

  • 主题/要求:文章的核心主题或具体写作要求
  • 关键词:AI 会在文章中重点体现的关键词,逗号分隔
  • 字数要求:0 = 不限;填写具体数字控制文章长度

点击「✨ AI 生成文章」,AI 生成结果会直接填入编辑器各字段。

一键优化全部字段

点击「⚡ 一键优化全部」:

  • AI 同时优化:标题、正文、摘要、SEO 标题、SEO 描述、SEO 关键词
  • 结果填入编辑器,不会自动保存,检查后手动点击「更新」保存
  • 每次保存时插件自动备份当前版本,可在「优化历史」中回滚

仅优化 SEO 字段

点击「🎯 仅优化 SEO」:

  • 只优化 SEO 标题、SEO 描述、SEO 关键词、文章标题和摘要,不修改正文内容
  • Token 消耗仅为全量优化的约 30%,适合正文质量已满意但 SEO 字段需要优化的场景
  • 优先使用轻量模型(如已配置)进一步降低成本

单字段优化

在「单独优化」区域点击对应按钮(标题 / 正文 / 摘要 / SEO标题 / SEO描述 / SEO关键词),只优化该字段。适合对某项单独调整的场景。

SEO 字段编辑区

直接编辑:SEO 标题、SEO 描述、SEO 关键词可直接在输入框中手动修改,字符计数实时更新:

  • SEO 标题:右侧显示 N/60,超过 60 字符时数字变红
  • SEO 描述:右侧显示 N/160,超过 160 字符时数字变红

保存 SEO 字段:点击「💾 保存 SEO 字段到数据库」可立即将 SEO 字段写入数据库,无需更新文章主体。保存成功后页面不会刷新,同时会自动同步更新页面上 SEO 插件的表单字段。

⚠️ 只有在「基本设置 → SEO 字段名配置」中明确配置了字段名的项才会被保存。未配置的字段会被跳过并显示提示信息。

暂存到待处理

优化完成后,面板出现一个提示条:

优化完成,是否要暂存到「待处理」?
[📥 暂存到待处理]  [关闭]

点击「暂存到待处理」后,当前编辑器中所有字段(含你手动修改过的内容)会以快照形式保存到「优化历史 → 待处理」,不影响文章当前发布状态。适合"先存起来,稍后再决定是否应用"的场景。

内链建议

AI 优化完成后,系统会自动根据 SEO 关键词搜索站内相关文章,在 SEO 字段区下方显示建议内链:

  • 点击文章标题可在新标签打开查看
  • 点击「复制」可将 <a href="...">标题</a> 代码复制到剪贴板,直接粘贴到正文中使用

4. SEO 评分面板

SEO 字段区下方(字段有内容时自动显示)有一个实时 SEO 评分面板,由 5 个颜色指示灯 和一个 总分 组成。

指示灯颜色含义

颜色 含义
🟢 绿色 该项达标,符合 SEO 最佳实践
🟡 黄色 该项勉强可接受,建议优化
🔴 红色 该项不达标,需要修改
⚪ 灰色 该字段为空,暂无数据

5 个评分项详细说明

指示灯 绿色标准 黄色标准 红色标准
标题 20~60 字符 15~19 或 61~80 字符 <15 或 >80 字符
SEO 标题 30~60 字符 20~29 或 61~80 字符 <20 或 >80 字符
SEO 描述 120~160 字符 100~119 或 161~200 字符 <100 或 >200 字符
关键词↑标题 关键词出现在文章标题中 关键词未出现在标题中
关键词↑描述 关键词出现在 SEO 描述中 关键词未出现在 SEO 描述中

字符数说明:所有计算基于字符数(中文每字算 1 个字符),与字节数不同。

总分计算

  • 每个绿色指示灯:+20 分
  • 每个黄色指示灯:+10 分
  • 红色/灰色指示灯:+0 分
  • 满分 100 分,80 分及以上为优秀(绿色显示),50~79 分为良好(橙色),50 分以下需改进(红色)

点击指示灯优化

点击任意非灰色指示灯,插件会自动调用 AI 重新优化对应字段:

  • 点击「SEO 标题」→ AI 重写 SEO 标题,确保长度合适且含关键词
  • 点击「SEO 描述」→ AI 重写 SEO 描述,确保长度合适且含关键词
  • 点击「标题」→ AI 重写文章标题,确保长度合适
  • 点击「关键词↑标题」→ AI 重写文章标题,确保包含关键词
  • 点击「关键词↑描述」→ AI 重写 SEO 描述,确保包含关键词

优化完成后对应指示灯自动更新颜色,总分重新计算。灰色(空字段)不支持点击,请先填写内容。鼠标悬停在可点击的指示灯上时会显示手型光标和下划线提示。

💡 批量优化详情行同样有 SEO 评分面板,也支持点击指示灯自动修复该行对应字段。


5. 批量优化

路径:AI SEO+GEO → 批量优化

适合对大量已有文章进行统一 AI 优化。所有优化结果先存入暂存区,由你审阅后决定是否应用,不会直接覆盖文章。

步骤一:筛选文章

筛选项 说明
文章类型 选择要优化的文章类型
文章状态 已发布 / 草稿 / 全部
分类 仅文章类型有效,按分类筛选
每次最多获取 从数据库读取的上限,建议不超过 200
每页显示 分页显示条数
排除文章 ID 不想优化的文章 ID,多个用英文逗号分隔

点击「获取文章列表」加载文章。

步骤二:选择文章

  • 勾选单篇 / 全选当前页 / 全选所有页
  • 可选:选择「使用模型」(v1.6.0 新增):主模型或轻量模型,默认值跟随全局设置,可临时切换
  • 可选:勾选「仅优化 SEO 字段」复选框,只优化 SEO 相关字段而不修改正文,大幅节省 Token
  • 可选:勾选「跳过二次润色」(v1.5.0 新增),批量场景下不执行 humanize,每篇少 1-3 次 API 调用
  • 可选:「SEO 评分保障」默认开启(v1.5.0 新增),优化后自动用 PHP 修正不达标字段至 ≥ 90 分,零额外 Token
  • 点击「▶ 开始批量优化」

步骤三:查看优化结果

每篇完成后:

  • 主行 SEO 评分(v1.5.0 新增):不用展开详情就能在列表主行看到 SEO 总分(0~100)和 5 个彩色圆点指示灯(绿/黄/红/灰),点击红/黄圆点可直接触发 AI 修复该字段
  • 点击「查看 & 应用」展开详情:
    • 左侧(黄色背景):原始内容(只读)
    • 右侧(蓝色背景):AI 优化后内容(可编辑)
    • SEO 评分面板:显示优化后内容的 SEO 得分,非灰色指示灯可点击让 AI 重新优化

步骤四:应用到 WordPress

  • 逐篇应用:在详情中选择状态 → 点击「应用到文章」
  • 批量应用:勾选多篇 → 底部「批量应用到 WordPress」→ 选状态 → 「批量应用」

重新开始与重试(v1.5.0 改进)

  • 保留已成功项:重新点击"继续优化"时,自动跳过已优化成功的文章,不会重复消耗 Token
  • 仅重试失败项:优化完成后如有失败的文章,会出现独立的「🔄 仅重试失败项」按钮,只对失败的文章重新优化
  • 批量应用始终可用:只要有任何已优化成功的文章,底部批量应用栏始终可见可用

⚠️ 未应用的结果自动保存在「优化历史 → 待处理」,下次可继续处理


6. AI 文章生成

路径:AI SEO+GEO → AI 文章生成

从零生成全新文章,支持三种模式。

通用设置(三种模式共用)

字段 说明
使用模型 主模型或轻量模型,默认值跟随全局设置,可临时切换(v1.6.0 新增)
每篇字数 0 = 不限,填具体数字控制长度
保存为(文章类型) 生成文章的 WordPress 文章类型
文章分类 仅文章类型有效
输出语言 中文(简体)/ 中文(繁体)/ English / 日本語 / 한국어 / Español / 法文 / 自定义
内容结构模板 选择预设模板后 AI 按模板结构生成文章(见第 2 节)

模式一:手动输入

适合围绕同一主题批量生成多篇角度各异的文章。

字段 说明
核心关键词 必填,AI 重点体现的关键词
主题/要求 可选,不填则以关键词为主题
补充说明 可选,填写风格要求、目标受众等
生成篇数 1~50 篇,同关键词但角度各异

模式二:批量导入关键词

适合为多个不同关键词分别生成文章。

  1. 在文本框粘贴关键词,每行一个
  2. 点击「📋 导入关键词」
  3. 在列表中为每个关键词设置篇数(1~20)
  4. 可选:主题前缀(如填"如何选购",生成主题为"如何选购 + 关键词")
  5. 点击「✨ 开始批量生成文章」

模式三:改写 / 伪原创

将已有文章改写为全新内容,保留主题但完全重写句式和结构。

  1. 将原文粘贴到文本框
  2. 可选填关键词、改写要求、输出语言
  3. 点击「✂️ 开始改写文章」
  4. 改写结果进入结果列表,审阅后保存到 WordPress

AI 改写规则:主题相同,句式/段落/表达全部重写,不直接复制原文任何句子

查看和保存生成结果

生成完成后在结果列表中:

  1. 点击「编辑/保存」展开详情
  2. 编辑:标题、摘要、正文(HTML)、SEO 字段
  3. 查看 SEO 评分(非灰色指示灯可点击让 AI 重新优化对应字段,手动修改后评分自动更新)
  4. 选择保存状态:草稿 / 立即发布 / 定时发布
  5. 点击「保存到 WordPress」

批量保存:勾选多篇 → 底部「批量保存到 WordPress」→ 选状态 → 「批量保存」

💡 生成结果不会自动写入 WordPress,确认后才会保存,避免草稿堆积


7. 优化历史

路径:AI SEO+GEO → 优化历史

Tab 1:待处理

显示所有 AI 生成或优化、尚未保存到 WordPress 的内容。

  • 来源:批量优化未应用的结果、单篇编辑页点击「暂存」的结果、AI 生成未保存的文章、定时自动优化的结果
  • 搜索/筛选:列表上方支持按标题/关键词搜索,按类型筛选(全部 / AI生成 / AI优化)
  • 每页条数:搜索栏右侧可输入每页显示条数(10~200),点击「应用」刷新页面
  • 批量应用到 WordPress(v1.5.0 新增):勾选多条记录 → 选择状态(草稿/发布/定时)→ 点击「📥 批量应用到 WordPress」,逐条将暂存内容保存到 WordPress,完成后自动从列表移除
  • 批量删除:每行左侧有勾选框,支持全选当前页;勾选后点击「批量删除选中」一次性删除多条记录
  • 操作:点击「编辑/保存到WP」打开弹窗,可编辑全部字段后选发布状态保存;已保存后自动从列表移除

Tab 2:备份历史

每次 AI 优化前自动备份的旧版本快照。

  • 每页条数:与待处理 Tab 相同,支持自定义每页显示条数(10~200)
  • 批量删除:勾选多条备份记录后点击「批量删除选中」一次性删除
操作 说明
查看 查看该历史版本所有字段内容
对比当前 左右对比历史版本与文章当前版本,高亮差异字段
回滚 将文章恢复到该历史版本(回滚前自动再备份一次当前版本)
删除 删除该条备份记录

8. 文章列表 AI 状态列

WordPress 后台文章列表新增 🤖 AI 状态 列:

显示内容 含义
AI 生成(蓝色徽标) 该文章由本插件 AI 生成
N 次优化(蓝色数字) 该文章被 AI 优化过 N 次
(灰色) 未经过 AI 处理

按状态筛选:列表顶部筛选栏新增 AI 状态过滤,可筛选「AI生成」/「已优化」/「未优化」的文章。

批量操作:文章列表勾选后,批量操作下拉有「🤖 AI 批量优化」选项,点击跳转到批量优化页面并自动填入所选文章 ID。


9. 定时自动优化

路径:基本设置 → 七、定时自动优化

定期自动对旧文章执行 AI 优化,结果存入「待处理」,由你手动审阅后决定是否应用,不会直接覆盖文章

配置项

配置项 说明
启用定时优化 勾选后启用,保存设置生效
执行频率 每天 / 每天两次 / 每周 / 每两周
每次优化篇数 每次最多优化的文章数,建议 3~10 篇
优化目标 最旧的文章优先 / 优化次数最少的优先 / 随机选取
优化文章类型 勾选要纳入定时优化的文章类型

执行状态

  • 上次执行:显示上次执行时间和处理篇数
  • 下次执行:页面加载时自动显示 WP-Cron 计划的下次执行时间

手动触发

点击「立即执行一次」按钮,立即触发一次定时优化(不影响既有定时计划),执行完成后显示本次处理篇数。


10. 核心工作流程

插件所有 AI 操作均采用「暂存审核」模式,AI 结果不会自动写入 WordPress,由你确认后再决定是否保存。

单篇优化流程

进入编辑页 → 点击"一键优化全部"
     ↓
AI 处理(显示进度)→ 结果填入编辑器
     ↓
查看 SEO 评分 → 点击非灰色指示灯让 AI 重新优化
     ↓
检查/修改内容 → 点击"更新"保存
(或点击"暂存到待处理"稍后再决定)

批量优化流程

筛选文章 → 勾选 → 开始批量优化
     ↓
AI 逐篇优化(进度条显示)→ 结果存入暂存区
     ↓
展开详情:左侧原文 vs 右侧 AI 优化(可编辑)
     ↓
查看 SEO 评分 → 点击非灰色指示灯让 AI 重新优化
     ↓
选择状态 → 应用到文章
(未应用的结果保存在"优化历史→待处理")

AI 生成文章流程

填写关键词 → 选择模式 → 开始生成
     ↓
AI 逐篇生成(进度显示)→ 结果存入暂存区
     ↓
展开详情 → 编辑字段 → 查看 SEO 评分
     ↓
选择状态(草稿/发布/定时)→ 保存到 WordPress

11. 任务中断恢复

批量优化和文章生成任务的进度自动保存到浏览器 localStorage

如果中途关闭页面或网络中断,下次打开对应页面时会出现黄色提示条:

⚠️ 发现上次未完成的任务(已完成 X/Y 篇,剩余 Z 篇)。
[继续执行]  [放弃]
  • 继续执行:从上次断点恢复,继续处理剩余任务
  • 放弃:清除记录,重新开始

💡 已完成的优化结果不会因为中断而丢失,它们已保存在「优化历史→待处理」中


Read the full README on GitHub →