WordPress ai助手

小半WordPress ai助手插件是一款开源免费的ai对话插件，支持deepseek，通义千问、豆包ai、Kimi、百度千帆、openai等模型对接，插件一开始是为了测试deepseek模型的代码能力，所以最早的代码(deepseek对接和早期的文章总结)是deepseek写的，后面也就干脆跟着deepseek的代码结构继续写的，没有重构。

插件功能：

1. 内置deepseek文本接口
2. 内置阿里通义千问文本接口
3. 内置百度千帆(文心一言)文本接口
4. 内置豆包ai文本接口
5. 内置Kimi文本接口
6. 内置Openai文本接口
7. 内置腾讯混元文本接口
8. 内置Grok文本接口
9. 内置自定义ai文本模型接口
10. 支持阿里智能体应用对接
11. 支持文多多aippt接口生成PPT文件
12. 支持通义千问的图片生成模型
13. 支持通义千问联网搜索(仅部分模型支持)
14. 模型参数是自定义填写
15. 系统会用一个单独的数据表保存对话记录的第一句
16. 用户可以删掉自己的历史对话记录
17. 后台可以删掉用户的对话记录
18. 后台可以删掉用户的智能体应用对话
19. 可以通过关键词生成文章
20. 可以通过ai接口对文章进行总结
21. 前台显示ai助手入口
22. 只允许登录用户使用
23. 支持Markdown格式(需要ai返回的是markdown格式)
24. DeepSeek余额信息
25. 通过ai接口对文章进行翻译
26. 支持对接腾讯云、百度云TTS服务实现语音播放文章内容
27. 可以实现语音播放ai回复的文字内容
28. 可以自定义提示词
29. 自定义提示词教程链接
30. Markdown内容板块自动加载复制按钮
31. 支持违规关键词检测
32. ai生成ppt可以验证会员权限(部分网站可能不行）

如果插件不用了，自己到数据库去删掉这2个数据表：deepseek_chat_logs 、deepseek_agent_chat_logs

插件启用会自动创建一个前台对话页面。如果没有自动创建，就自己手动加短代码：

[deepseek_chat]

主题页面需要支持全宽或者全屏模式，不然很狭窄。如果不支持就自己查看你主题的样式，通过代码实现deepseek助手页面全屏显示。

下面是对接模型教程

插件使用很简单，主要是有的apikey获取、豆包ai模型参数的入口可能不是那么明确，需要提一下。

首先需要注意的点：

说明1：聊天对话需要网站开启REST API服务，有的用户优化wp的时候可能会关掉REST API。
说明2：有的网站缓存配置可能会导致对话无法正常使用，请排除对话页面的缓存。

怎么查看REST API服务是否正常？

访问你的网站：http://你的网站地址/wp-json/wp/v2/posts

也就是在地址后面加：/wp-json/wp/v2/posts

如果REST API正常运行，你应该能看到JSON格式的文章数据，反正就是一大堆内容，如果出现 403、404或500等错误，则不正常。

网站启用REST API服务会泄露网站的用户列表，所以要做好对应的安全防护。

可以查看：REST API服务安全防护

插件环境：

• WordPress6.7系列
• php 8.0
• Linux nginx
• MySQL8.0

如果你的出现错误了，不兼容PHP7.3以下的版本。

前台点击没反应，先自查缓存、查看浏览器控制台，看看有没有什么错误提示，如果是样式错乱，也一样，可能和你主题冲突了，先检查是否和主题冲突。

目前内置的接口，只支持纯文本语言类模型，不支持其他类型，图片模型就内置了阿里的通义千问，模型参数可以设置多个，默认调用第一个参数。

1、deepseek apikey获取

1. 官网https://platform.deepseek.com/usage
2. API keys页面去创建一个Key

deepseek支持的模型：

文本模型参考官方：https://api-docs.deepseek.com/zh-cn/quick_start/pricing

2、豆包ai模型 apikey获取

1. 到官网火山引擎  https://console.volcengine.com/
2. 进入火山方舟 https://console.volcengine.com/ark
3. 在左下角有一个API Key 管理管理，里面去创建api key

2.1、豆包ai模型 参数获取

1. 在火山方舟的菜单找到“在线推理”菜单入口
2. 点击进去创建推理接入点
3. 创建之后，有一个接入点名称，然后下面有一个ep开头的参数，把这个复制粘贴到插件设置里面

豆包ai模型创建推理接入点的时候，在里面选择自己的模型，如果模型你之前没有开通，需要按提示先去开通模型。

注：如果只是免费测试，我不太推荐豆包ai，因为我自己就开发测试，给自己搞欠费了，免费额度太少了。

3、通义千问 apikey获取

1. 进入阿里云官网进入阿里百炼页面 https://bailian.console.aliyun.com
2. 在网页右上角头像图标这里 可以看见一个 api-key
3. 点击进去创建apikey

通义千问支持的模型：

模型列表_大模型服务平台百炼(Model Studio)-阿里云帮助中心

自己到官方去看。

如果要用通义千问生成文章，请选择qwen-long等长文本模型。

4、Kimi apikey获取

1. 进入官网创建 https://platform.moonshot.cn/console/api-keys
2. 文本自动模型参数：moonshot-v1-auto

其他具体模型参数：

• Kimi模型参数

5、Openai apikey获取

1. 进入官网创建 https://platform.openai.com/

具体模型参数：

https://platform.openai.com/docs/models#gpt-4o

6、百度千帆 apikey获取

1. 进入官网创建 https://console.bce.baidu.com/qianfan/overview

具体模型参数：

我推荐到百度云的API在线调试平台-示例代码查看，比在外面的文档清晰一些。

7、自定义模型

可以自定义参数模型，但是一定要支持OpenAI Chat Completions接口的格式和请求方式，比如：https://api.openai.com/v1/chat/completions

比如硅基流动模型说支持OpenAI的方式，文档里面提到请求地址是：https://api.siliconflow.cn/v1

那么你在填写自定义默认请求地址的就填写：https://api.siliconflow.cn/v1/chat/completions

硅基流动官网：cloud.siliconflow.cn

8、腾讯混元 apikey获取

1. 进入官网创建： https://console.cloud.tencent.com/hunyuan/start

具体文本模型参数：

https://cloud.tencent.com/document/product/1729/97765

9、图片生成模型

目前文生图，只支持通义千问的图片模型和pollinations模型。

10、讯飞星火模型

官网：https://xinghuo.xfyun.cn/sparkapi

APIPassword：在控制台http服务接口认证里面有一个APIPassword，他们每一个模型都有一个APIPassword，但可以都用同一个，也可以在星火调试中心看。

不要用Websocket里面的apikey。

模型参数：

lite generalv3 pro-128k generalv3.5 max-32k 4.0Ultra

lite指向Lite版本; generalv3指向Pro版本; pro-128k指向Pro-128K版本; generalv3.5指向Max版本; max-32k指向Max-32K版本; 4.0Ultra指向4.0 Ultra版本;

11、Claude模型

Claude的api并没有完全兼容OpenAI的api模式，所以Claude用了他们自己的api模式。

APIkey获取：控制台创建

模型参数：所有型号概览

12、Gemini模型

Gemini虽然兼容OpenAI的api接口方式，但也是测试版。

apikey获取：控制台

模型参数：Gemini 模型

13、PPT生成模型

ppt用的文多多aiptt开放平台，因为他家相对便宜一点，充值最低档单价0.49元，讯飞的也比较贵，充值最低档单价0.84元，aippt.cn的更贵，接口需要申请，要充值上万才行。

官网：docmee.cn

注册了到开放平台获取apikey

14、文章总结提示

如果ai的接口太慢了，会导致文章加载很慢。文章总结的接口和对话接口绑定一起的，文章总结同模型以第一次为准，避免反复调用接口和严重影响加载速度。

15、文章翻译说明

可以添加多个语言的翻译，前提条件：

1. 你添加的模型支持翻译内容
2. 模型支持长文本（因为文章内容一般很多，而有的模型只支持短文本提交）

16、语音朗读说明

到腾讯云或者百度云官方开通语音合成(TTS)服务

1. 默认支持的短文本语音合成（腾讯云长文本不支持免费试用，然后2家的长文本都很贵）
2. 通过截取字符分段提交合并，实现更低成本朗读内容（效果肯定不如长文本）
3. 音库值可以自定义，就是模拟的发声人
4. 腾讯云音色列表：https://cloud.tencent.com/document/product/1073/92668#55924b56-1a73-4663-a7a1-a8dd82d6e823
5. 百度云音色列表：https://cloud.baidu.com/doc/SPEECH/s/Rluv3uq3d

音库值要根据你自己的资源包来，比如我免费试用，只能调用基础音色，比如腾讯的1001(智瑜)、百度的0(度小美)。

翻译和语音播放都可以排除指定的文章，输入文章id就行。

17、文章生成

比较简单的单文章生成，通过输入关键词生成文章，模型需要支持长文本。

如果你想批量生成文章，建议购买专业的文章生成插件，比如模版兔开发的人工智能AI助手插件。

18、会员验证

很多WordPress网站都有自己的会员体系，有的就可以通过关键词来判断会员和非会员。

如果你是用的模版兔的Modown主题，那么默认关键词就是：升级VIP享受精彩下载

不是会员的用户，才会有这句，是会员的用户就没有这句，所以这是关键判断。

19、智能体应用

阿里智能体：

在阿里百炼里面去创建，和通义千问ai模型一个地方，apikey也可以用一样的。

创建的应用都会有一个应用ID，把这个复制过来。

腾讯元器智能体

官网：https://yuanqi.tencent.com/

腾讯的Token在你创建的应用右下角 – 更多 – 调用api – 从这里进去就能看见当前应用的Token和当前应用id

扣子平台智能体：

个人访问令牌：www.coze.cn/open/oauth/pats

个人访问令牌最多只能设置30天有效期，官方虽然推荐线上环境使用OAuth授权的方式调用，但是我觉得太麻烦了，特别是有多个应用添加的时候。

扣子的应用ID：访问你创建的智能体应用页面，地址/bot/后面的一串数字。

扣子分为智能体和应用2种，只对智能体有效，应用是另外的产品，不要添加应用的ID。

火山引擎智能体：

apikey和模型一样的，创建应用之后，有一个应用id。

扣子和火山引擎都是字节的，如果现在要api调用，我感觉火山引擎更新更快一点，扣子适合直接使用。

20、联网搜索

联网搜索只支持阿里通义千问模型，并且根据通义千问官方介绍，也只是部分模型支持联网搜索。

推荐对接智能体应用实现默认的联网搜索。

21、pollinations模型说明

pollinations的文生图模型，如果你的网站服务器在内地，可能会出现网络错误。

特别是使用了CDN，并且在CDN里面限制了回源时间，一定要去把这个时间延长。

比如腾讯云CDN：

22、视频生成

只支持通义千问的视频模型，文生视频以及图生视频。

• 通义万相-图生视频2.1-Turbo模型：wanx2.1-i2v-turbo、wanx2.1-i2v-plus
• 通义万相-文生视频2.1-Turbo模型：wanx2.1-t2v-turbo、wanx2.1-t2v-plus

i2v是图生视频，t2v是文生视频。

23、页面短代码

插件启用应该会自动创建2个前台页面，对话和ppt生成页面，如果没有就手动创建：代码

[deepseek_chat]
#对话框页面短代码

[docmee_ppt]

#ai生成ppt页面短代码 Copy

24、网站开启调试模式(反馈错误的时候用)

1. 打开 wp-config.php 文件
2. 找到以下代码并修改为：

代码

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

                            

Copy

• 保存文件并重新尝试激活插件。
• 查看 wp-content/debug.log 文件，获取详细的错误信息。