子比主题 AI 摘要 (SEO 描述) 插件完整介绍

一、基础信息

1. 插件名称：子比主题 AI 摘要 (SEO 描述)
2. 版本：V1.0.0
3. 开发：智界工作室，基于李初一原版代码二次改版
4. 运行环境：WordPress ≥5.2，PHP ≥7.4
5. 专属限制：仅适配 Zibll 子比主题，其他 WP 主题无法生效

二、核心作用

1. 读者不用通读全文，一眼看懂文章核心内容，提升阅读体验与停留时长；
2. 把子比主题内置 AI 生成的 SEO 描述可视化展示，强化页面关键词布局，辅助 SEO 收录。

三、核心功能逻辑（源码实现机制）

1. 双数据源自动读取（优先级自动判断）

• 第一优先级：读取子比主题后台 AI 生成的descriptionSEO 描述（子比自带 AI 一键生成文章简介字段）；
• 兜底方案：如果没有 SEO 描述，自动读取 WordPress 原生文章摘要excerpt；
• 空内容自动隐藏：两种数据都为空时，插件不输出任何模块，无多余空白代码。

2. 原生钩子挂载，零冲突

1. 挂载zib_require_end：主题加载完成后才初始化插件，避免加载顺序报错；
2. 挂载zib_posts_content_before：精准插入到文章正文最前方；
3. 仅在文章详情页（is_singular('post')）加载 CSS，列表页、页面、后台不加载资源，轻量化不拖慢网站速度。

3. 前端 UI 完全复刻子比风格

• 左侧机器人 SVG 图标（AI 标识）；
• 标题文字「AI 摘要」+ 右侧橙色标签「ZibllAI」；
• 下方文本框展示摘要内容；
• 配套独立ai-abstract.css样式文件，和子比整体 UI 视觉统一，无样式错乱。

4. 后台兼容提示

四、使用优势

1. 开箱即用：安装启用直接生效，无需后台配置、不用改代码；
2. 轻量化无冗余：只在文章单页加载样式，无多余 JS、无数据库新增表；
3. 完美适配子比：使用主题原生函数zib_get_post_meta读取 SEO 字段，和主题 AI 功能打通；
4. 容错性强：无摘要内容自动隐藏，不会出现空白模块影响页面美观；
5. 安全规范：输出内容使用esc_html()转义，防止 XSS 注入；文件访问做ABSPATH防护，禁止直接访问插件文件。

五、适用人群

• 想把 AI 生成的 SEO 简介展示给访客，提升阅读体验；
• 不想手动修改主题模板增加摘要模块；
• 追求轻量化、不增加网站加载负担；
• 依赖子比自带 AI 批量生成文章描述，需要前端可视化展示。

六、简单使用流程

1. 上传插件安装并启用；
2. 网站必须启用 Zibll 子比主题；
3. 编辑文章时，使用子比主题自带 AI 生成 SEO 描述；
4. 发布文章后，自动在正文顶部出现 AI 摘要卡片；
5. 未填写 SEO 描述时，自动调用文章摘要填充。

七、局限性

1. 仅限子比主题，Astra、Divi、JustNews 等其他 WP 主题无法使用；
2. 仅做前端展示，不具备 AI 生成摘要能力（摘要依赖子比主题自身 AI 功能提前生成）；
3. 无后台设置面板，样式、文字、标签（ZibllAI）需要修改 CSS/PHP 源码自定义。