WordPress 的 SEO 插件通常分成两类:一类只管元标签,另一类塞进几十个用不上的模块, 把后台拖慢一倍。站点真正需要的往往是固定的几件事:标题描述、结构化数据、 站点地图、死链与 AI 爬虫的收录策略。
站优把这四件事做在同一个小插件里:元信息、结构化数据、站点地图、AI 收录。 装完按默认规则就能用,也可以在设置里逐项覆盖。
后起的一层需求是 AI 收录:搜索引擎之外,越来越多的流量来自直接问 AI。
它们不像爬虫那样顺着链接爬完整个站,而是先看站点说明、再看几篇内容。
所以除了 sitemap,它还输出 llms.txt 与全文摘要——告诉 AI 这个站讲什么、哪几篇值得读。
安装部署
前置要求:WordPress 5.0+、PHP 7.0+,插件包 62 KB、不依赖第三方库。安装前建议先备份数据库。
方式一 · 后台上传 zip(推荐)
- 下载
sanqi-seo-2.3.8.zip(不要解压)。 - 后台 → 插件 → 安装插件 → 上传插件 → 选择该 zip → 立即安装。
- 安装完点「启用插件」,左侧菜单出现 SQ SEO。
方式二 · FTP / 文件管理器上传目录
后台上传常因上传大小限制或权限失败时用这个,效果一样。
- 把 zip 解压,得到
sanqi-seo目录。 - 整个目录上传到
/wp-content/plugins/下。 - 后台 → 插件,找到「站优 SEO」点启用。
目录层级别多套一层:正确路径是 plugins/sanqi-seo/sanqi-seo.php。
方式三 · WP-CLI 一条命令
wp plugin install https://github.com/limaosou/sq-seo-toolkit/releases/download/v2.3.8/sanqi-seo-2.3.8.zip --activate
批量维护多个站点时最省事,可脚本化。
方式四 · 覆盖升级(先导出设置)
- 升级前先到「导入导出」页把设置与 301 规则导出成 JSON。
- 后台禁用并删除旧版本(选「保留数据」时设置不受影响)。
- 按方式一装新版本并启用,必要时导入刚才的 JSON 核对。
直接覆盖文件也能升级,但旧文件残留可能导致版本号与实际代码不一致,稳妥起见走上面三步。
装好之后先自检
装完别急着用,先跑一遍这 5 项。任何一项不对,说明环境或权限还没到位。
- 后台左侧出现 SQ SEO 菜单,15 个设置页都能打开,不报 PHP 错误。
- 前台页面源码里能看到插件输出的 meta 与 JSON-LD(且没有重复的一组)。
/sitemap.xml返回 200,内容是 XML 而不是 404 页面。/llms.txt返回 200(若该模块已开启)。- 清一次页面缓存/CDN 后再看源码,改动确实生效。
前台使用
前台输出:meta 与社交卡片
文章页输出 title、description、canonical、OG 与 Twitter 卡片。默认不接管 description、文章页不输出 keywords,尽量避免与主题重复。
每项都能单独关:主题已经输出的项,把插件这边关掉即可,不用二选一。
前台输出:结构化数据
输出 JSON-LD,覆盖文章、面包屑、站点组织等常见类型。字段取自文章本身,不虚构作者与评分。
前台输出:Sitemap 与 llms.txt
/sitemap.xml 按内容类型分节,可排除不重要的分类与标签页;/llms.txt 与 /llms-full.txt 给 AI 爬虫一份站点说明与内容清单。这是它区别于老式 SEO 插件的部分。
前台输出:301 与 404
301 重定向在插件里配规则,命中即跳转,不经过主题;404 命中会记一条日志,方便发现失效外链与被扫描的路径。
日志的价值在排查:如果某个旧链接持续被访问,说明外部还有人在指它,那就该配一条 301 而不是让它 404。长期没人访问的死链,忽略就好。
前台不输出多余代码
插件只在需要的页面输出需要的标签:文章页才有 Article 结构化数据,首页才有 Organization,列表页不加。关掉的模块不会留下空标签或注释。
这一点比“功能多”更重要。前台源码里的无用输出会直接影响首屏体积,也会让搜索引擎看到互相矛盾的信号。
后台与设置
基础 TDK
首页标题与描述、文章/分类/标签的标题模板(支持变量)、分隔符、是否输出 keywords。description 默认不接管,避免与主题打架。
社交卡片与结构化数据
- OG / Twitter 卡片:默认使用文章特色图,可设兜底图与站点名。
- JSON-LD:按内容类型开关,能预览生成的 JSON。
- 面包屑:结构化面包屑与前台面包屑联动,也可只输出结构化数据。
Sitemap 与 llms.txt
- Sitemap:包含哪些内容类型、每页条数、是否含图片、是否自动 ping。
- llms.txt:站点一句话简介、主要栏目、内容清单;
llms-full.txt输出全文摘要。 - 要点速览:给文章生成一段可被 AI 引用的摘要块。
链接推送
- 百度主动推送:填 token,新文章发布即推。
- 神马 MIP 提交:同样填 token。
- IndexNow:一次提交,参与该协议的搜索引擎共用。
token 只存在你自己的数据库里,插件不回传任何数据。
重定向、日志与内容体检
- 301 重定向:按路径或正则配置,可导入导出。
- 404 与蜘蛛日志:记录访问路径、UA、时间,用于发现死链。
- 内容体检:检查标题长度、描述缺失、图片 alt、内链数量等。
- 导入导出:设置与规则一键备份,卸载脚本会清干净全部数据。
AI 收录怎么取舍
是否让 AI 爬虫抓全文,是个业务判断,不是技术判断:
- 开:希望内容被引用、被搜索到,接受“用户可能只看摘要不点进来”。工具站、文档站一般选这个。
- 只开摘要:给标题与简介,不给全文——保留一点点击动机,同时仍能出现在回答里。
- 关:付费内容或独家内容,宁可少曝光也不外流。
无论选哪种,都不影响站点正常的搜索引擎收录——两套通道独立开关。
使用帮助
刚装好先只开基础项
先启用「基础 TDK」,确认前台源码里只有一组 meta,再逐项开结构化数据与 Sitemap。一次全开,出问题很难判断是哪一项引起的。
和主题自带 SEO 并存
主题已经输出 title/description 的,把插件对应项关掉,只留一处输出。重复输出不会让排名更好,只会让搜索引擎判断不一致。
升级与迁移
升级前导出设置 JSON;换站时在新站导入,再刷新一次固定链接让重写规则生效。卸载时插件会清掉自己的设置与日志,不留垃圾表。
上线后先查这四项
- 前台页面源码里 meta 只有一组,canonical 指向自己而不是首页。
/sitemap.xml打开是 XML,里面能看到新发的文章。- 结构化数据用搜索引擎的测试工具跑一次,无报错。
- 发布一篇测试文章,看推送日志是否返回成功。
四项过了再谈优化;四项没过就调标题文案,等于在漏水的桶里加水。
不想要的功能怎么彻底关掉
分两层:先在设置页把开关关掉(不再输出代码),再确认前台源码里确实没有了。只关样式不关输出,标签还在,白关。
整块不需要(例如不做 AI 收录)就到对应模块关总开关,而不是逐个子项关——子项会随版本增加,总开关不会。
几个真实用法
| 场景 | 怎么做 |
|---|---|
| 刚搭好的内容站 | 不想为了 sitemap、分享卡片、结构化数据各装一个插件:上传启用后按需开开关,一次配完就能长期不管。 |
| 主题已经自带 SEO 功能 | description 默认不接管、文章页不再输出 keywords,并带插件冲突检测,尽量不与主题重复输出同一份标签。 |
| 站点跑久了要体检 | 超期未更新文章清单、正文内外链批量死链扫描、404 一键加 301,把「发现 → 跳转 → 验证」串成一条线。 |
常见问题
和主题自带的 SEO 功能会冲突吗?
插件默认不接管 description,文章页也不再输出 keywords,并提供冲突检测提醒。若主题已输出同类标签,把对应开关保持关闭即可;每项功能都能单独停。
要付费或授权吗?
完全免费,GPL-2.0-or-later,不需要注册账号、授权码或在线激活,装完即用。
会把站点数据发给作者吗?
不会。默认安装后不发任何外部请求;只有你主动填写 token 后,插件才会把文章 URL 提交给百度、神马或 IndexNow。token 只存在你自己站点的数据库里。
覆盖升级会丢设置吗?卸载干净吗?
文件夹名、文本域与设置项键名都保持兼容,直接覆盖文件不会丢配置;「备份 / 迁移」页可先导出 JSON。删除插件时会执行 uninstall.php,清掉全部设置、日志、文章 meta 与定时任务。
问题解决
先按下面的顺序自查一遍,九成问题能在三步内定位,再往下才是具体现象的对照表。
- 确定范围:只有这一台设备/这一个页面出问题,还是全部都这样。只在一处出现,基本是环境或权限;全都这样,先怀疑版本与配置。
- 看最先报错的地方:前台报错的原文、浏览器控制台的第一行红字、后台日志里最早的那一条,比最后一条有用。
- 退回默认:关掉自己加的配置或与其他插件/脚本的冲突项,用默认设置复现一次。默认能用,问题就在改动里。
| 现象 | 原因 | 处理 |
|---|---|---|
| 启用后前台出现重复的 meta 标签 | 主题或其他 SEO 插件也在输出同一组标签。 | 在设置里关闭站优的对应输出项,或先停用另一个插件,只保留一处输出。 |
| 站点地图打开是 404 | 固定链接未刷新,或伪静态规则未生效。 | 到「设置 → 固定链接」保存一次以刷新重写规则,再重新生成站点地图。 |
| 改了设置但前台没变化 | 页面缓存、对象缓存或 CDN 还存着旧 HTML。 | 清 WordPress 缓存插件 → 清 CDN → Ctrl+F5 硬刷新,再查看页面源码。 |
| 上传 zip 提示超过大小限制 | PHP upload_max_filesize / post_max_size 太小,或目录不可写。 | 改用 FTP 上传目录方式;或调大 PHP 限制并确认 wp-content/plugins 可写。 |
| 结构化数据测试工具报错 | 主题或另一个插件也输出了 JSON-LD,两份合并不合法。 | 只留一处输出;在站优里关掉对应类型,或停用另一个插件的结构化数据模块。 |
| 推送接口返回 token 无效 | token 复制时带了空格,或站点域名与平台登记的不一致。 | 重新复制 token(去首尾空格);确认推送的域名与平台后台填写的一致,含 www 与否要对应。 |
| 卸载后设置还在 | 只停用没卸载,或卸载时选了保留数据。 | 重新安装后走卸载流程;保留数据是给“临时关掉”用的,不是卸载。 |
| 日志表涨得很快 | 404 与蜘蛛日志默认长期保留,扫描器请求也会记。 | 在日志页设置保留天数,或定期清理;只留最近一周足够排查。 |
以上之外的问题,带上产品名、版本号、报错原文、操作步骤反馈到 hi@qinghuali.com,四项齐了基本一次能定位。
能力边界
这一节比功能列表更值得先看——它决定了你会不会在错误的场景里浪费时间。
- 只服务 WordPress,其他建站系统不适用。
- 不做关键词研究与排名追踪,那类数据需要外部服务。
- 不代替缓存与 CDN 优化,页面速度问题需要另配方案。
- 不保证收录与排名:推送只是把 URL 告知搜索引擎,收不收、排第几由对方决定。
- 不接管主题的模板与路由,不会替你改版式;只输出 head 标签、站点地图与重定向。
- 不收集站点访问统计,也没有云端控制台,所有设置存在你自己的数据库里。
版本记录
| 版本 | 日期 | 变更 |
|---|---|---|
| 2.3.8 | 2026-11-11 | 对外首发版本:15 个设置页、17 个 AI 爬虫放行、301 重定向、内容体检与备份迁移;GitHub 公开仓库与 Release v2.3.8 已发布,对外发布版清理了自用站信息并补齐卸载脚本与 GPL 许可证。 |