启灵Ai助手
WordPress ai助手插件 支持deepseek 豆包 通义千问 openai Kimi 千帆等模型和智能体应用。
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/wujiit/wp-ai-chat/archive/refs/heads/main.zip启灵Ai助手（wp-ai-chat）
启灵Ai助手 是一个基于 WordPress 的 AI 插件，集成了对话、智能体、文章工具、翻译朗读、AI PPT 等功能。
- 插件版本：
4.0.8 - 插件主文件：
wp-ai-chat.php - 适用场景：站内 AI 助手、文章增强、站点内容生产
- 其他说明：这是原小半WP助手，改下名称，重构了，时隔一年重新开始更新了。
- 联系方式：企鹅群 - 16966111
功能概览
- AI 对话助手（短代码：
[deepseek_chat]） - 智能体应用对话（阿里/腾讯/火山/扣子）
- 对话文件上传（文档分析、图像视频任务）
- 文章 AI 总结（发布后自动标记，首次访问生成）
- 后台文章生成（支持流式输出）
- 经典编辑器文章 AI 分析（标题/SEO/错别字）
- 文章翻译与语音朗读（文章前台控制条）
- AI PPT 生成（短代码：
[docmee_ppt]） - 对话记录与文件列表管理
- 站点知识库检索增强问答（文章/页面、手动知识、上传文件入库）
- 新增硅基流动、OpenRouter、Mistral AI 等 OpenAI 兼容模型平台
- 提示词库与场景模板（后台管理、前台一键使用、系统提示词注入）
- 使用统计与回答反馈（接口/模型分布、耗时、知识库/提示词命中、用户有用/没用反馈）
- 会话管理增强（对话重命名、置顶、Markdown 导出）
环境要求
- WordPress（建议
6.x） - PHP（建议
7.4+） - PHP 扩展：
curl、mbstring、json - 站点可访问外部模型 API（DeepSeek、通义千问、OpenAI 等）
- 如需使用新增平台，请准备对应 API Key：硅基流动、OpenRouter、Mistral AI
- 建议启用 HTTPS
安装方式
- 将
wp-ai-chat文件夹上传到wp-content/plugins/。 - 在 WordPress 后台启用插件。
- 启用后插件会自动创建页面：
启灵Ai助手（包含[deepseek_chat]）和AIPPT生成（包含[docmee_ppt]）。
如果自动创建失败，可手动新建页面并写入对应短代码。
后台菜单
启用后在后台出现主菜单 启灵Ai助手，包含以下子菜单：
- 对话设置
- 对话记录
- 文章生成
- 翻译语音
- PPT生成
- 智能体应用
- 智能体记录
- 文件工作区
- 知识库
- 提示词库
- 使用统计
快速开始（建议顺序）
- 进入
启灵Ai助手 > 对话设置，填写 API Key 和模型参数。 - 在
启用的对话接口中勾选要开放的模型接口，设置默认接口。 - 打开自动创建的
启灵Ai助手页面测试聊天。 - 按需开启：联网搜索、文件上传、智能体入口、文章总结、对话语音等扩展功能。
各模块使用说明
1) AI 对话（[deepseek_chat]）
- 前台显示聊天窗口、历史记录、接口切换、模型参数选择等。
- 支持登录用户和按设备限额开放的游客对话。
- 支持关键词拦截、上下文记忆轮数、公告、自定义提示词、教程入口链接。
- 可启用“在线联网搜索”（按支持模型生效）。
提示：插件仅在“页面（page）且包含 [deepseek_chat]”时加载聊天前端资源。
2) 智能体应用
在 启灵Ai助手 > 智能体应用 配置：
- 提供商：阿里、腾讯、扣子、火山
- 字段：名称、描述、图标、应用 ID
- 腾讯智能体可配置单独 Token
- 可配置开场问题和是否允许该智能体上传文件
前台在聊天页点击“智能体应用”进入对应会话。
3) 文件上传
- 普通对话文件上传：在
对话设置中开启。 - 文档分析模型限制：
Kimi、OpenAI、通义千问 qwen-long。 - 视频任务场景会按模型限制上传为图片。
- 智能体文件上传在当前版本要求登录且具备上传权限。
4) 文章 AI 总结
- 在
对话设置中开启“文章AI总结”并选择总结接口。 - 文章发布后会被标记为“待总结”。
- 首次访问文章页时生成总结，并展示在正文前。
5) 文章生成（后台）
路径：启灵Ai助手 > 文章生成
- 输入关键词，选择接口，按需勾选联网搜索后生成文章。
- 生成完成后可直接发布到选定分类并设置标签。
- 当前版本已增加请求验证（nonce）与后台权限校验。
6) 文章 AI 分析（经典编辑器）
- 在
对话设置中启用“文章分析”后生效。 - 仅在经典编辑器显示分析面板。
- 可输出推荐标题、SEO 描述、错别字检测结果。
7) 翻译语音（文章页）
路径：启灵Ai助手 > 翻译语音
- 可开启文章翻译和文章朗读控制条。
- 翻译支持多语言按钮。
- 朗读支持腾讯云/百度云 TTS 接口。
- 可配置排除文章 ID（这些文章不显示翻译/朗读入口）。
8) AI PPT（[docmee_ppt]）
路径：启灵Ai助手 > PPT生成
- 填写文多多（Docmee）API Key。
- 可设置每个 Token 最大生成次数、容器宽高。
- 前台短代码页默认要求登录后使用。
9) 日志和文件管理
对话记录：查看/删除普通对话历史。智能体记录：查看/删除智能体会话记录。文件工作区：查看、筛选、复用和清理本地文件记录；需要时也可加载通义千问远端文件列表。
10) 知识库
路径：启灵Ai助手 > 知识库
- 支持把站内文章/页面、手动文本、上传文件记录加入知识库。
- 支持按来源类型、对话接口、页面 ID 控制知识库生效范围。
- 对话命中知识库时会在回答中提示引用标记，并在消息底部显示参考来源。
- 文章/页面发布后会自动同步索引；后台也可手动入库或重建全部来源。
11) 新增模型平台
路径：启灵Ai助手 > 接口模型
- 新增硅基流动、OpenRouter、Mistral AI 三个平台配置。
- 前台对话、文章生成、文章总结、经典编辑器文章分析都可使用这些 OpenAI 兼容平台。
- 每个平台的模型参数支持英文逗号分隔，默认使用第一个模型。
12) 提示词库
路径：启灵Ai助手 > 提示词库
- 可新增、编辑、停用、删除提示词模板。
- 模板支持分类、排序、适用接口和系统提示词。
- 前台聊天页会显示可用场景模板，点击后自动填入输入框。
- 发送对话时会把模板的系统提示词注入模型请求，用来固定角色、语气和回答规则。
13) 使用统计
路径：启灵Ai助手 > 使用统计
- 记录对话、图片、视频等调用的接口、模型、状态、耗时和字符量。
- 记录知识库来源命中数和提示词模板命中情况。
- 前台回答下方支持“有用/没用”反馈，后台可查看最近反馈。
14) 会话管理
路径：前台聊天页左侧历史记录
- 支持对话重命名，便于把重要会话整理成清晰标题。
- 支持对话置顶，置顶会话会排在历史记录前面。
- 支持导出 Markdown 文件，方便保存或二次整理。
会员拦截能力
插件提供“关键词命中 + 跳转 URL”的会员提示弹层机制：
- 对话页会员拦截（可选）
- PPT 页会员拦截（可选）
通常用于与站点现有会员系统联动。
数据存储
插件会创建以下数据表：
{$wpdb->prefix}deepseek_chat_logs{$wpdb->prefix}deepseek_agent_chat_logs{$wpdb->prefix}deepseek_settings{$wpdb->prefix}deepseek_file_records{$wpdb->prefix}deepseek_kb_sources{$wpdb->prefix}deepseek_kb_chunks{$wpdb->prefix}deepseek_kb_jobs{$wpdb->prefix}deepseek_prompt_templates{$wpdb->prefix}deepseek_usage_events{$wpdb->prefix}deepseek_message_feedback{$wpdb->prefix}deepseek_conversation_meta
其中插件配置会优先同步到 deepseek_settings，并保留 options 兼容影子；对话/智能体上传文件会统一记录到 deepseek_file_records，前台最近文件复用和后台文件工作区都基于这张表；知识库来源、分段和入库任务分别写入 deepseek_kb_sources、deepseek_kb_chunks、deepseek_kb_jobs；提示词模板写入 deepseek_prompt_templates；调用统计和回答反馈分别写入 deepseek_usage_events、deepseek_message_feedback；会话标题和置顶状态写入 deepseek_conversation_meta；文章总结状态等内容增强数据仍会写入文章 meta。
卸载说明
插件卸载时会清理配置存储、文件记录表、知识库表、提示词库表、使用统计表、反馈表和会话管理表。
历史对话日志表建议按需手动备份或清理。
安全说明
- 关键对话 REST 接口已收紧为 nonce + 登录/游客额度校验。
- 智能体相关请求增加了权限与会话归属校验。
- 文章生成/发布后台 AJAX 增加了 nonce 校验。
- 知识库后台操作仅限管理员，并带 nonce 校验。
- 提示词库后台操作仅限管理员，并带 nonce 校验。
- 回答反馈接口带 nonce 和对话归属校验，游客只能反馈自己的对话。
- 会话重命名、置顶、导出接口带 nonce 和对话归属校验。
- Markdown 输出已增加前端净化，降低脚本注入风险。
常见问题
- 聊天页面不显示样式或脚本？
- 请确认短代码放在“页面（page）”中，而不是文章（post）。
- 调用模型失败或超时？
- 检查 API Key、模型参数、接口 URL、服务器外网连通性。
- 文件上传提示模型不支持？
- 文档分析仅支持指定模型（如
qwen-long、Kimi、OpenAI对应模型）。
- 智能体列表为空？
- 请先在
智能体应用菜单配置至少一个智能体并保存。