Browse Source

update README.md

Pchen 1 year ago
parent
commit
d5d6d988fe
2 changed files with 102 additions and 5 deletions
  1. 102 5
      README.md
  2. BIN
      images/4.jpg

+ 102 - 5
README.md

@@ -20,7 +20,9 @@
 
 - Wechaty
 
-- Sqlite3
+- SQLite3
+
+- websocket
 
   
 
@@ -55,6 +57,8 @@ WebWechatBot
 
 本项目可在 Linux、MacOS、Windows 系统上运行(在Linux服务器上可实现长期运行、远程控制管理)
 
+此仓库包含已经编译好的前端页面,可不做更改直接使用。如果你想对前端页面进行更改,请前往:[https://github.com/Pchen0/Web-Wechat-Bot-Dashboard](https://github.com/Pchen0/Web-Wechat-Bot-Dashboard)。
+
 #### 0.安装Node.js
 
 Wechaty要求Node.js版本高于10,如果你还没有安装Node.js 或者你的版本低于10, 请参考下面的链接安装最新版本的Node.js:
@@ -97,17 +101,110 @@ module.exports = {
 
 #### 4.配置
 
-通过你的ip地址+端口号进入到机器人的管理界面,默认用户名为`admin`,密码`123456`
+通过你的ip地址+端口号进入到机器人的管理界面,默认用户名为`admin`,密码`123456`
 
-在API设置页面中填入你的接口地址、API Key、模型名称等,你可以自由选择讯飞星火和ChatGPT两个模型,其中兼容openai接口的API可填入ChatGPT的配置中。设置完成后可在对话测试中测试API接口是否能正常使用
+你可在后文的配置填写一节中查看关于配置填写的详细介绍
 
 ![](./images/1.png)
 
-在Wechat Bot设置界面你可以选择使用的语言模型、设置机器人的一些回复规则。
-
 ![](./images/2.png)
 
+
+
+## 📦配置填写
+
+在API设置页面中填入你的接口地址、API Key、模型名称等,你可以自由选择讯飞星火、ChatGPT、通义千问等模型。
+
+
+
+### API接口设置填写说明
+
+#### 讯飞星火
+
+**官方文档:**[https://www.xfyun.cn/doc/spark/Web.html](https://www.xfyun.cn/doc/spark/Web.html)
+
+**API接口地址:**
+
+3.5版本:ws://spark-api.xf-yun.com/v3.5/chat,
+
+3.0版本:ws://spark-api.xf-yun.com/v3.1/chat,
+
+2.0版本:ws://spark-api.xf-yun.com/v2.1/chat,
+
+1.5版本:ws://spark-api.xf-yun.com/v1.1/chat,
+
+讯飞助手的接口地址在助手创作中心获取。
+
+**APIKEY、APISecret、APPID:**在讯飞开放平台创建应用后即可获取,注意不要混淆APIKEY和APISecret。
+
+![](./images/4.jpg)
+
+**模型版本:**选择你所使用的模型版本,请与API接口地址对应的版本一致。
+
+general指向V1.5版本;
+generalv2指向V2版本;
+generalv3指向V3版本;
+generalv3.5指向V3.5版本。
+
+**最大token数:**模型回答的tokens的最大长度。V1.5取值为[1,4096]
+V2.0、V3.0和V3.5取值为[1,8192],默认为2048。
+
+**温度:**核采样阈值。用于决定结果随机性,取值越高随机性越强即相同的问题得到的不同答案的可能性越高。取值范围 (0,1] ,默认值0.5。
+
+
+
+#### ChatGPT
+
+**注:**兼容openai接口的API可填入ChatGPT的配置中。
+
+**官方文档:**[https://platform.openai.com/docs/](https://platform.openai.com/docs/)
+
+**APIKey:**在控制台获取。你的APIKey格式应该为:sk-xxxxxxxxxxxxxxxxxxxx。
+
+**app_code:**该项专为一些兼容openai接口的平台设置,可忽略。
+
+**模型名称:**填写你想使用的模型的名称,如gpt-3.5-turbo。
+
+
+
+#### 通义千问
+
+**API接口地址:**如https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
+
+**APIKey:**请参考https://help.aliyun.com/zh/dashscope/developer-reference/activate-dashscope-and-create-an-api-key
+
+**温度:**用于控制随机性和多样性的程度。取值范围:[0, 2),系统默认值0.85。
+
+**模型名称:**填写你所使用的模型名称,如qwen-turbo、qwen-max、qwen-max-longcontext等。
+
+**最大token:**用于限制模型生成token的数量,max_tokens设置的是生成上限,并不表示一定会生成这么多的token数量。其中qwen-turbo 最大值和默认值为1500, qwen-max、qwen-max-1201 、qwen-max-longcontext 和 qwen-plus最大值和默认值均为2000。
+
+**预设内容:**填写你对机器人的设定和要求,填写越详细效果越好,但会增加token的使用量。
+
+
+
+### WechatBot设置填写说明
+
+**选择模型:**选择你想使用的模型,支持讯飞星火、ChatGPT、通义千问。请预先在API接口设置页面填写好你的配置信息。
+
+**自动回复前缀:**填写的文字会被加到机器人回复消息的最前面,可使用\n换行。能用于区分机器人和真人。群聊和私聊通用。
+
+**自动回复后缀:**填写的文字会被加到机器人回复消息的最后面,可使用\n换行。能用于区分机器人和真人。群聊和私聊通用。
+
+**是否开启私聊自动回复:**关闭后将不回复所有私聊消息。
+
+**私聊黑名单:**填写好友的微信昵称(不是备注),多个名称用英文逗号(,)分隔,系统不会回复被填入黑名单的好友的消息。
+
+**群聊关键字回复:**系统会自动回复含有关键词的群聊消息。多个关键词用英文逗号分隔。
+
+**群聊白名单:**当群聊白名单不为空时,机器人只会回复在白名单中的群聊消息;当群聊白名单为空时,机器人会回复所有群聊的消息。
+
+**是否在被@时回复:**开启后机器人会在自己被@后进行回复。
+
+
+
 至此,本项目的搭建已接近尾声。进入微信登录页面,扫描二维码登录微信,登录成功后你的微信机器人就创建完成了。
 
 ![](./images/3.png)
 
+同时,你也可以进入对话测试页面与大语言模型进行对话,此页面使用的模型、前缀、后缀等与WechatBot设置中的相同。

BIN
images/4.jpg