启灵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助手页面测试聊天。 - 按需开启：联网搜索、文件上传、智能体入口、文章总结、对话语音等扩展功能。
- 前台显示聊天窗口、历史记录、接口切换、模型参数选择等。
- 支持登录用户和按设备限额开放的游客对话。
- 支持关键词拦截、上下文记忆轮数、公告、自定义提示词、教程入口链接。
- 可启用“在线联网搜索”（按支持模型生效）。
提示：插件仅在“页面（page）且包含 [deepseek_chat]”时加载聊天前端资源。
在 启灵Ai助手 > 智能体应用 配置：
- 提供商：阿里、腾讯、扣子、火山
- 字段：名称、描述、图标、应用 ID
- 腾讯智能体可配置单独 Token
- 可配置开场问题和是否允许该智能体上传文件
前台在聊天页点击“智能体应用”进入对应会话。
- 普通对话文件上传：在
对话设置中开启。 - 文档分析模型限制：
Kimi、OpenAI、通义千问 qwen-long。 - 视频任务场景会按模型限制上传为图片。
- 智能体文件上传在当前版本要求登录且具备上传权限。
- 在
对话设置中开启“文章AI总结”并选择总结接口。 - 文章发布后会被标记为“待总结”。
- 首次访问文章页时生成总结，并展示在正文前。
路径：启灵Ai助手 > 文章生成
- 输入关键词，选择接口，按需勾选联网搜索后生成文章。
- 生成完成后可直接发布到选定分类并设置标签。
- 当前版本已增加请求验证（nonce）与后台权限校验。
- 在
对话设置中启用“文章分析”后生效。 - 仅在经典编辑器显示分析面板。
- 可输出推荐标题、SEO 描述、错别字检测结果。
路径：启灵Ai助手 > 翻译语音
- 可开启文章翻译和文章朗读控制条。
- 翻译支持多语言按钮。
- 朗读支持腾讯云/百度云 TTS 接口。
- 可配置排除文章 ID（这些文章不显示翻译/朗读入口）。
路径：启灵Ai助手 > PPT生成
- 填写文多多（Docmee）API Key。
- 可设置每个 Token 最大生成次数、容器宽高。
- 前台短代码页默认要求登录后使用。
对话记录：查看/删除普通对话历史。智能体记录：查看/删除智能体会话记录。文件工作区：查看、筛选、复用和清理本地文件记录；需要时也可加载通义千问远端文件列表。
路径：启灵Ai助手 > 知识库
- 支持把站内文章/页面、手动文本、上传文件记录加入知识库。
- 支持按来源类型、对话接口、页面 ID 控制知识库生效范围。
- 对话命中知识库时会在回答中提示引用标记，并在消息底部显示参考来源。
- 文章/页面发布后会自动同步索引；后台也可手动入库或重建全部来源。
路径：启灵Ai助手 > 接口模型
- 新增硅基流动、OpenRouter、Mistral AI 三个平台配置。
- 前台对话、文章生成、文章总结、经典编辑器文章分析都可使用这些 OpenAI 兼容平台。
- 每个平台的模型参数支持英文逗号分隔，默认使用第一个模型。
路径：启灵Ai助手 > 提示词库
- 可新增、编辑、停用、删除提示词模板。
- 模板支持分类、排序、适用接口和系统提示词。
- 前台聊天页会显示可用场景模板，点击后自动填入输入框。
- 发送对话时会把模板的系统提示词注入模型请求，用来固定角色、语气和回答规则。
路径：启灵Ai助手 > 使用统计
- 记录对话、图片、视频等调用的接口、模型、状态、耗时和字符量。
- 记录知识库来源命中数和提示词模板命中情况。
- 前台回答下方支持“有用/没用”反馈，后台可查看最近反馈。
路径：前台聊天页左侧历史记录
- 支持对话重命名，便于把重要会话整理成清晰标题。
- 支持对话置顶，置顶会话会排在历史记录前面。
- 支持导出 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对应模型）。
- 智能体列表为空？
- 请先在
智能体应用菜单配置至少一个智能体并保存。