启灵Ai助手（wp-ai-chat）

启灵Ai助手 是一个基于 WordPress 的 AI 插件，集成了对话、智能体、文章工具、翻译朗读、AI PPT 等功能。

• 插件版本：4.0.6
• 插件主文件：wp-ai-chat.php
• 适用场景：站内 AI 助手、文章增强、站点内容生产
• 其他说明：这是原小半WP助手，改下名称，重构了，时隔一年重新开始更新了。
• 联系方式：企鹅群 - 16966111

功能概览

1. AI 对话助手（短代码：[deepseek_chat]）
2. 智能体应用对话（阿里/腾讯/火山/扣子）
3. 对话文件上传（文档分析、图像视频任务）
4. 文章 AI 总结（发布后自动标记，首次访问生成）
5. 后台文章生成（支持流式输出）
6. 经典编辑器文章 AI 分析（标题/SEO/错别字）
7. 文章翻译与语音朗读（文章前台控制条）
8. AI PPT 生成（短代码：[docmee_ppt]）
9. 对话记录与文件列表管理

环境要求

• WordPress（建议 6.x）
• PHP（建议 7.4+）
• PHP 扩展：curl、mbstring、json
• 站点可访问外部模型 API（DeepSeek、通义千问、OpenAI 等）
• 建议启用 HTTPS

安装方式

1. 将 wp-ai-chat 文件夹上传到 wp-content/plugins/。
2. 在 WordPress 后台启用插件。
3. 启用后插件会自动创建页面：启灵Ai助手（包含 [deepseek_chat]）和 AIPPT生成（包含 [docmee_ppt]）。

如果自动创建失败，可手动新建页面并写入对应短代码。

后台菜单

启用后在后台出现主菜单 启灵Ai助手，包含以下子菜单：

• 对话设置
• 对话记录
• 文章生成
• 翻译语音
• PPT生成
• 智能体应用
• 智能体记录
• 文件列表

快速开始（建议顺序）

1. 进入 启灵Ai助手 > 对话设置，填写 API Key 和模型参数。
2. 在 启用的对话接口 中勾选要开放的模型接口，设置默认接口。
3. 打开自动创建的 启灵Ai助手 页面测试聊天。
4. 按需开启：联网搜索、文件上传、智能体入口、文章总结、对话语音等扩展功能。

各模块使用说明

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) 日志和文件管理

• 对话记录：查看/删除普通对话历史。
• 智能体记录：查看/删除智能体会话记录。
• 文件列表：查看并删除已上传到通义千问侧的文件。

会员拦截能力

插件提供“关键词命中 + 跳转 URL”的会员提示弹层机制：

• 对话页会员拦截（可选）
• PPT 页会员拦截（可选）

通常用于与站点现有会员系统联动。

数据存储

插件会创建以下数据表：

• {$wpdb->prefix}deepseek_chat_logs
• {$wpdb->prefix}deepseek_agent_chat_logs

同时会写入多组插件配置项（options）和部分文章 meta（如总结状态）。

卸载说明

插件卸载时会清理大部分配置项（options）。
如果你还需要清理历史对话数据表，请手动处理对应数据表。

安全说明

• 关键对话 REST 接口已收紧为登录用户 + nonce 校验。
• 智能体相关请求增加了权限与会话归属校验。
• 文章生成/发布后台 AJAX 增加了 nonce 校验。
• Markdown 输出已增加前端净化，降低脚本注入风险。

常见问题

1. 聊天页面不显示样式或脚本？

• 请确认短代码放在“页面（page）”中，而不是文章（post）。

2. 调用模型失败或超时？

• 检查 API Key、模型参数、接口 URL、服务器外网连通性。

3. 文件上传提示模型不支持？

• 文档分析仅支持指定模型（如 qwen-long、Kimi、OpenAI 对应模型）。

4. 智能体列表为空？

• 请先在 智能体应用 菜单配置至少一个智能体并保存。

开发者备注

• 该插件当前是“WordPress 一体化”方案：前台、配置、权限、日志都在 WP 内完成。
• 如果后续要拆成“WP 前台 + 独立后端服务”，建议先保留短代码和后台设置页作为兼容层。