WP Manifestindependent plugin directory
manifest / ai / ai-post-summary

AI Post Summary

为 WordPress 文章生成和管理 AI 摘要、标签与关键词，支持小工具、短代码、正文自动插入、批量任务与日志。

by zhqi9277 · github.com/zhqi9277/ai-post-summary · website

★ 0stars
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/zhqi9277/ai-post-summary/archive/refs/heads/main.zip
Readme github.com/zhqi9277/ai-post-summary ↗

AI Post Summary 是一个面向 WordPress 文章站点的 AI 内容增强插件。
它不只生成文章摘要，还能补全文章标签、SEO 关键词，并提供后台管理、批量任务、失败重试、日志追踪和前端展示能力。

这个插件最初就是按真实运营站点需求做的，不是只演示一次 AI 调用，而是围绕“生成之后怎么展示、怎么批量补、怎么排错、怎么人工修正”整套流程来设计。

这个插件解决什么问题

很多 WordPress 站点在内容运营上会遇到几个典型问题：

  • 文章很多，但摘要没有统一规范，文章页信息密度不够
  • 标签经常漏填，后期归档和推荐效果差
  • SEO 关键词字段经常空着，或者写得很随意
  • 站点里既有人工发文，也有采集或自动发布流程，人工逐篇补内容成本太高
  • AI 调用不是最难的，难的是生成失败以后怎么查、怎么补、怎么重试

ai-post-summary 的目标不是“让 AI 调一下接口”，而是把这条链路做成一个能长期用的后台能力。

核心优势

1. 不只生成摘要，而是生成可运营的文章附加信息

插件现在支持三类内容：

  • AI 摘要
  • WordPress 文章标签 post_tag
  • 文章 SEO 关键词 keywords

这意味着它不是一个单点摘要插件，而是一个针对文章页的 AI 增强工具。

2. 兼顾自动化和人工可控

很多 AI 插件要么完全自动，要么完全手动。这个插件两边都做了：

  • 可以在文章发布或更新后自动排队生成
  • 可以在文章编辑页手动立即生成或重新生成
  • 可以在管理页里手工修改摘要、标签、关键词
  • 可以批量补齐历史文章
  • 可以重试失败任务

这套设计更适合真实运营，而不是只适合演示。

3. 有管理后台，不是“生成完就结束”

插件带完整后台管理能力：

  • 设置页
  • 摘要管理
  • 标签 / 关键词管理
  • 批量任务
  • 日志页

你可以查看、编辑、重试、筛选，不需要每次都进文章编辑页逐篇处理。

4. 前台展示和站点风格融合，而不是独立漂浮组件

摘要模块支持：

  • 小工具插入
  • 短代码插入
  • 正文顶部自动插入

同时已经针对 zibll 主题做过兼容处理，前端卡片样式更接近主题自身模块，而不是一块突兀的默认插件面板。

5. 有日志，方便排错

这类功能如果没有日志，出了问题就很难定位。插件支持：

  • DEBUG
  • INFO
  • WARNING
  • ERROR

并且日志会持久化保存，方便追踪：

  • 自动排队
  • 手动生成
  • 批量补齐
  • 接口调用失败
  • 返回为空
  • 解析失败
  • 生成成功

6. 不是只适配一种 AI 厂商

插件使用兼容 Chat Completions 请求格式的接口，因此可以接入多种兼容服务，例如：

  • OpenAI 兼容接口
  • DeepSeek 兼容接口
  • NVIDIA Integrate
  • 其他支持 Chat Completions 的服务

只要接口、模型名和 API Key 正确即可。

功能清单

内容生成

  • 生成文章 AI 摘要
  • 生成文章标签
  • 生成文章关键词
  • 支持摘要长度上限控制
  • 支持标签数量上限控制
  • 支持关键词数量上限控制

前台展示

  • 文章页小工具展示摘要
  • 短代码 [ai_post_summary]
  • 正文顶部自动插入摘要
  • 标签彩色美化开关
  • 标签样式覆盖文章页和文章列表中的文章标签位置

后台管理

  • 统一设置页 Tab 管理
  • 摘要管理分页
  • 标签 / 关键词管理分页
  • 编辑后再保存
  • 手动重新生成
  • 状态筛选

批量任务

  • 批量补齐历史摘要
  • 批量重试失败摘要
  • 批量补齐历史标签 / 关键词
  • 批量重试失败标签 / 关键词

稳定性与可维护性

  • 异步排队生成
  • 生成结果缓存到文章数据
  • 基于文章内容 hash 判断是否需要重建
  • 错误状态记录
  • 日志持久化保存

与普通“AI 摘要插件”的差异

很多现成插件只做一件事：在前台加载文章时临时调一次 AI，然后把结果显示出来。这样的问题很明显：

  • 首屏变慢
  • 重复消耗 token
  • 请求失败直接影响页面
  • 没有批量补齐能力
  • 没有后台管理能力

ai-post-summary 采用的是另一种思路：

  • 生成走后台或异步任务
  • 前台只读取已生成结果
  • 失败不拖垮文章页
  • 后台可以重试和编辑
  • 支持批量补历史内容

这更像一个“站点内容工作流工具”，而不是一个纯前台展示插件。

适合哪些站点

  • 内容资讯站
  • 博客站
  • 采集站
  • 运营型 SEO 站
  • 需要统一文章信息结构的站点
  • 使用 zibll 主题的站点

如果站点有大量历史文章、标签补全需求、关键词补全需求，这个插件会比只做摘要的工具更有价值。

当前兼容情况

WordPress

  • Requires at least: 6.0
  • Tested up to: 6.9.4
  • Requires PHP: 7.4

主题兼容

当前已针对 zibll 做过实际适配：

  • 兼容 zibll 文章 keywords 字段
  • 兼容 zibll 文章页和文章列表中的标签样式位置
  • 摘要卡片样式已尽量贴合 zibll 风格

插件结构概览

目前插件主要能力都集中在一个主文件中：

  • ai-post-summary.php
  • readme.txt

功能模块包括：

  • 设置页
  • 摘要生成
  • 标签 / 关键词生成
  • 后台管理
  • 批量任务
  • 日志系统
  • 小工具
  • 短代码
  • 前端样式增强

后续如果继续演进，适合进一步拆成：

  • admin
  • frontend
  • services
  • providers
  • logging

安装方式

方式一：直接上传插件目录

  1. 将 ai-post-summary 目录上传到 /wp-content/plugins/
  2. 在 WordPress 后台启用插件
  3. 进入 设置 -> AI 摘要
  4. 填写接口地址、API Key、模型名

方式二：从仓库拉取

git clone https://github.com/zhqi9277/ai-post-summary.git

然后将插件目录放入：

/wp-content/plugins/ai-post-summary

基础配置说明

启用插件后，主要配置项包括：

  • 接口地址
  • API Key
  • 模型名称
  • 摘要样式
  • 摘要上限
  • 自动生成摘要
  • 自动补全标签 / 关键词
  • 标签上限
  • 关键词上限
  • 正文自动插入
  • 标签彩色美化
  • 系统提示词
  • 摘要模板

接口地址说明

插件会直接向你填写的地址发起请求，因此要填写完整接口地址，而不是只填根路径。

例如：

https://api.openai.com/v1/chat/completions

如果接的是 NVIDIA Integrate，也要填完整接口，而不是只填 /v1/。

前台使用方式

1. 小工具

适合主题本身有文章页小工具位的站点。

在后台：

  • 外观 -> 小工具

把：

  • AI 文章摘要

拖到文章页对应位置即可。

2. 短代码

可以手动插入：

[ai_post_summary]

或者：

[ai_post_summary post_id="123"]

3. 正文自动插入

开启后会自动插到文章正文顶部。

后台能力说明

设置

统一入口：

  • 设置 -> AI 摘要

摘要管理

可用于：

  • 查看摘要状态
  • 查看摘要预览
  • 手动编辑摘要
  • 重新生成摘要
  • 分页筛选

标签 / 关键词管理

可用于：

  • 查看当前文章关键词
  • 查看当前文章标签
  • 手动修改关键词
  • 手动修改标签
  • 重新生成标签 / 关键词
  • 分页筛选

任务

可用于批量排队：

  • 历史文章补摘要
  • 失败摘要重试
  • 历史文章补标签 / 关键词
  • 失败标签 / 关键词重试

日志

可用于查看：

  • 请求是否发出
  • 哪篇文章排队了
  • 哪篇文章失败了
  • 失败原因是什么
  • 是否返回空内容
  • 是否使用了自定义 prompt

数据写入方式

摘要

摘要会写入文章 meta，例如：

  • _ai_summary
  • _ai_summary_status
  • _ai_summary_source_hash
  • _ai_summary_updated_at
  • _ai_summary_error

标签

标签写入 WordPress 原生文章标签：

  • post_tag

关键词

关键词写入文章 meta：

  • keywords

这个字段和 zibll 主题的 SEO 关键词逻辑兼容。

生成逻辑说明

摘要

  • 提取文章正文纯文本
  • 去掉脚本、样式、短代码
  • 限制文本长度
  • 调用 AI
  • 对结果做格式清洗
  • 根据设置的上限截断
  • 写回文章 meta

标签 / 关键词

  • 读取文章标题和正文
  • 请求 AI 返回 JSON
  • 解析 keywords 和 tags
  • 清洗重复和空值
  • 控制数量上限
  • 写回关键词 meta 和 WordPress 标签

为什么要支持自定义 Prompt

不同站点的摘要风格和 SEO 策略差异很大：

  • 资讯站更适合导读式摘要
  • 技术站更适合要点式摘要
  • SEO 站更关注关键词覆盖
  • 社区站更关注标签归类

所以插件允许在设置页中配置：

  • 系统提示词
  • 摘要模板

这样你可以根据站点定位调整输出风格，而不需要每次改代码。

日志为什么重要

这类插件上线之后，真正耗时间的不是“第一次生成成功”，而是后续维护：

  • 为什么某篇文章没生成
  • 为什么某个模型返回空内容
  • 为什么某篇文章一直失败
  • 批量任务到底排了多少篇

没有日志，这些问题很难排。
因此插件把日志做成了后台可查看、可筛选、可清空的持久化能力。

当前版本

当前仓库版本：

  • 0.4.2

更新记录

0.4.2

  • 扩大标签美化范围，覆盖文章列表和文章页中的文章标签链接

0.4.1

  • 新增文章页标签彩色美化开关
  • 仅在单篇文章页注入标签样式增强

0.4.0

  • 新增 AI 标签与关键词自动生成
  • 新增标签/关键词管理分页、手动编辑与重新生成
  • 新增标签/关键词批量任务和日志记录
  • 更新插件元信息与功能说明

0.3.0

  • 新增摘要管理
  • 摘要长度改为上限语义
  • 优化文章页摘要卡片样式与布局
  • 新增任务与日志页整合到统一设置页

0.2.0

  • 新增任务页与日志页
  • 新增日志持久化保存
  • 新增批量补摘要与失败重试

0.1.0

  • 初始版本
  • 支持文章摘要生成、小工具展示和正文自动插入

适合继续迭代的方向

  • 标签 / 关键词专用 Prompt 配置
  • 批量生成功能的进度反馈
  • 更细的权限控制
  • 更多前端展示模板
  • 多模型切换策略
  • API 响应缓存优化
  • 独立 provider 抽象层

Star

如果这个项目对你有帮助，欢迎去仓库点一个 Star：

https://github.com/zhqi9277/ai-post-summary