mirror of https://github.com/Mai-with-u/MaiBot.git
227 lines
8.9 KiB
Markdown
227 lines
8.9 KiB
Markdown
# 🔧 配置指南 喵~
|
||
|
||
## 👋 你好呀
|
||
|
||
让咱来告诉你我们要做什么喵：
|
||
|
||
1. 我们要一起设置一个可爱的AI机器人
|
||
2. 这个机器人可以在QQ上陪你聊天玩耍哦
|
||
3. 需要设置两个文件才能让机器人工作呢
|
||
|
||
## 📝 需要设置的文件喵
|
||
|
||
要设置这两个文件才能让机器人跑起来哦：
|
||
|
||
1. `.env.prod` - 这个文件告诉机器人要用哪些AI服务呢
|
||
2. `bot_config.toml` - 这个文件教机器人怎么和你聊天喵
|
||
|
||
## 🔑 密钥和域名的对应关系
|
||
|
||
想象一下，你要进入一个游乐园，需要：
|
||
|
||
1. 知道游乐园的地址（这就是域名 base_url）
|
||
2. 有入场的门票（这就是密钥 key）
|
||
|
||
在 `.env.prod` 文件里，我们定义了三个游乐园的地址和门票喵：
|
||
|
||
```ini
|
||
# 硅基流动游乐园
|
||
SILICONFLOW_KEY=your_key # 硅基流动的门票
|
||
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1/ # 硅基流动的地址
|
||
|
||
# DeepSeek游乐园
|
||
DEEP_SEEK_KEY=your_key # DeepSeek的门票
|
||
DEEP_SEEK_BASE_URL=https://api.deepseek.com/v1 # DeepSeek的地址
|
||
|
||
# ChatAnyWhere游乐园
|
||
CHAT_ANY_WHERE_KEY=your_key # ChatAnyWhere的门票
|
||
CHAT_ANY_WHERE_BASE_URL=https://api.chatanywhere.tech/v1 # ChatAnyWhere的地址
|
||
```
|
||
|
||
然后在 `bot_config.toml` 里，机器人会用这些门票和地址去游乐园玩耍：
|
||
|
||
```toml
|
||
[model.llm_reasoning]
|
||
name = "Pro/deepseek-ai/DeepSeek-R1"
|
||
provider = "SILICONFLOW" # 告诉机器人：去硅基流动游乐园玩，机器人会自动用硅基流动的门票进去
|
||
|
||
[model.llm_normal]
|
||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||
provider = "SILICONFLOW" # 还是去硅基流动游乐园
|
||
```
|
||
|
||
### 🎪 举个例子喵
|
||
|
||
如果你想用DeepSeek官方的服务，就要这样改：
|
||
|
||
```toml
|
||
[model.llm_reasoning]
|
||
name = "deepseek-reasoner" # 改成对应的模型名称，这里为DeepseekR1
|
||
provider = "DEEP_SEEK" # 改成去DeepSeek游乐园
|
||
|
||
[model.llm_normal]
|
||
name = "deepseek-chat" # 改成对应的模型名称，这里为DeepseekV3
|
||
provider = "DEEP_SEEK" # 也去DeepSeek游乐园
|
||
```
|
||
|
||
### 🎯 简单来说
|
||
|
||
- `.env.prod` 文件就像是你的票夹，存放着各个游乐园的门票和地址
|
||
- `bot_config.toml` 就是告诉机器人：用哪张票去哪个游乐园玩
|
||
- 所有模型都可以用同一个游乐园的票，也可以去不同的游乐园玩耍
|
||
- 如果用硅基流动的服务，就保持默认配置不用改呢~
|
||
|
||
记住：门票（key）要保管好，不能给别人看哦，不然别人就可以用你的票去玩了喵！
|
||
|
||
## ---让我们开始吧---
|
||
|
||
### 第一个文件：环境配置 (.env.prod)
|
||
|
||
这个文件就像是机器人的"身份证"呢，告诉它要用哪些AI服务喵~
|
||
|
||
```ini
|
||
# 这些是AI服务的密钥，就像是魔法钥匙一样呢
|
||
# 要把 your_key 换成真正的密钥才行喵
|
||
# 比如说：SILICONFLOW_KEY=sk-123456789abcdef
|
||
SILICONFLOW_KEY=your_key
|
||
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1/
|
||
DEEP_SEEK_KEY=your_key
|
||
DEEP_SEEK_BASE_URL=https://api.deepseek.com/v1
|
||
CHAT_ANY_WHERE_KEY=your_key
|
||
CHAT_ANY_WHERE_BASE_URL=https://api.chatanywhere.tech/v1
|
||
|
||
# 如果你不知道这是什么，那么下面这些不用改，保持原样就好啦
|
||
# 如果使用Docker部署，需要改成0.0.0.0喵，不然听不见群友讲话了喵
|
||
HOST=127.0.0.1
|
||
PORT=8080
|
||
|
||
# 这些是数据库设置，一般也不用改呢
|
||
# 如果使用Docker部署，需要把MONGODB_HOST改成数据库容器的名字喵，默认是mongodb喵
|
||
MONGODB_HOST=127.0.0.1
|
||
MONGODB_PORT=27017
|
||
DATABASE_NAME=MegBot
|
||
# 数据库认证信息，如果需要认证就取消注释并填写下面三行喵
|
||
# MONGODB_USERNAME = ""
|
||
# MONGODB_PASSWORD = ""
|
||
# MONGODB_AUTH_SOURCE = ""
|
||
|
||
# 也可以使用URI连接数据库，取消注释填写在下面这行喵（URI的优先级比上面的高）
|
||
# MONGODB_URI=mongodb://127.0.0.1:27017/MegBot
|
||
|
||
# 这里是机器人的插件列表呢
|
||
PLUGINS=["src2.plugins.chat"]
|
||
```
|
||
|
||
### 第二个文件：机器人配置 (bot_config.toml)
|
||
|
||
这个文件就像是教机器人"如何说话"的魔法书呢！
|
||
|
||
```toml
|
||
[bot]
|
||
qq = "把这里改成你的机器人QQ号喵" # 填写你的机器人QQ号
|
||
nickname = "麦麦" # 机器人的名字，你可以改成你喜欢的任何名字哦，建议和机器人QQ名称/群昵称一样哦
|
||
alias_names = ["小麦", "阿麦"] # 也可以用这个招呼机器人，可以不设置呢
|
||
|
||
[personality]
|
||
# 这里可以设置机器人的性格呢，让它更有趣一些喵
|
||
prompt_personality = [
|
||
"曾经是一个学习地质的女大学生，现在学习心理学和脑科学，你会刷贴吧", # 贴吧风格的性格
|
||
"是一个女大学生，你有黑色头发，你会刷小红书" # 小红书风格的性格
|
||
]
|
||
prompt_schedule = "一个曾经学习地质,现在学习心理学和脑科学的女大学生，喜欢刷qq，贴吧，知乎和小红书" # 用来提示机器人每天干什么的提示词喵
|
||
|
||
[message]
|
||
min_text_length = 2 # 机器人每次至少要说几个字呢
|
||
max_context_size = 15 # 机器人能记住多少条消息喵
|
||
emoji_chance = 0.2 # 机器人使用表情的概率哦（0.2就是20%的机会呢）
|
||
thinking_timeout = 120 # 机器人思考时间，时间越长能思考的时间越多，但是不要太长喵
|
||
|
||
response_willing_amplifier = 1 # 机器人回复意愿放大系数，增大会让他更愿意聊天喵
|
||
response_interested_rate_amplifier = 1 # 机器人回复兴趣度放大系数，听到记忆里的内容时意愿的放大系数喵
|
||
down_frequency_rate = 3.5 # 降低回复频率的群组回复意愿降低系数
|
||
ban_words = ["脏话", "不文明用语"] # 在这里填写不让机器人说的词，要用英文逗号隔开，每个词都要用英文双引号括起来喵
|
||
|
||
[emoji]
|
||
auto_save = true # 是否自动保存看到的表情包呢
|
||
enable_check = false # 是否要检查表情包是不是合适的喵
|
||
check_prompt = "符合公序良俗" # 检查表情包的标准呢
|
||
|
||
[others]
|
||
enable_kuuki_read = true # 让机器人能够"察言观色"喵
|
||
enable_friend_chat = false # 是否启用好友聊天喵
|
||
|
||
[groups]
|
||
talk_allowed = [123456, 789012] # 比如：让机器人在群123456和789012里说话
|
||
talk_frequency_down = [345678] # 比如：在群345678里少说点话
|
||
ban_user_id = [111222] # 比如：不回复QQ号为111222的人的消息
|
||
|
||
# 模型配置部分的详细说明喵~
|
||
|
||
|
||
#下面的模型若使用硅基流动则不需要更改，使用ds官方则改成在.env.prod自己指定的密钥和域名，使用自定义模型则选择定位相似的模型自己填写
|
||
|
||
[model.llm_reasoning] #推理模型R1，用来理解和思考的喵
|
||
name = "Pro/deepseek-ai/DeepSeek-R1" # 模型名字
|
||
# name = "Qwen/QwQ-32B" # 如果想用千问模型，可以把上面那行注释掉，用这个呢
|
||
provider = "SILICONFLOW" # 使用在.env.prod里设置的宏，也就是去掉"_BASE_URL"留下来的字喵
|
||
|
||
[model.llm_reasoning_minor] #R1蒸馏模型，是个轻量版的推理模型喵
|
||
name = "deepseek-ai/DeepSeek-R1-Distill-Qwen-32B"
|
||
provider = "SILICONFLOW"
|
||
|
||
[model.llm_normal] #V3模型，用来日常聊天的喵
|
||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||
provider = "SILICONFLOW"
|
||
|
||
[model.llm_normal_minor] #V2.5模型，是V3的前代版本呢
|
||
name = "deepseek-ai/DeepSeek-V2.5"
|
||
provider = "SILICONFLOW"
|
||
|
||
[model.vlm] #图像识别模型，让机器人能看懂图片喵
|
||
name = "deepseek-ai/deepseek-vl2"
|
||
provider = "SILICONFLOW"
|
||
|
||
[model.embedding] #嵌入模型，帮助机器人理解文本的相似度呢
|
||
name = "BAAI/bge-m3"
|
||
provider = "SILICONFLOW"
|
||
|
||
# 如果选择了llm方式提取主题，就用这个模型配置喵
|
||
[topic.llm_topic]
|
||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||
provider = "SILICONFLOW"
|
||
```
|
||
|
||
## 💡 模型配置说明喵
|
||
|
||
1. **关于模型服务**：
|
||
- 如果你用硅基流动的服务，这些配置都不用改呢
|
||
- 如果用DeepSeek官方API，要把provider改成你在.env.prod里设置的宏喵
|
||
- 如果要用自定义模型，选择一个相似功能的模型配置来改呢
|
||
|
||
2. **主要模型功能**：
|
||
- `llm_reasoning`: 负责思考和推理的大脑喵
|
||
- `llm_normal`: 负责日常聊天的嘴巴呢
|
||
- `vlm`: 负责看图片的眼睛哦
|
||
- `embedding`: 负责理解文字含义的理解力喵
|
||
- `topic`: 负责理解对话主题的能力呢
|
||
|
||
## 🌟 小提示
|
||
|
||
- 如果你刚开始使用，建议保持默认配置呢
|
||
- 不同的模型有不同的特长，可以根据需要调整它们的使用比例哦
|
||
|
||
## 🌟 小贴士喵
|
||
|
||
- 记得要好好保管密钥（key）哦，不要告诉别人呢
|
||
- 配置文件要小心修改，改错了机器人可能就不能和你玩了喵
|
||
- 如果想让机器人更聪明，可以调整 personality 里的设置呢
|
||
- 不想让机器人说某些话，就把那些词放在 ban_words 里面喵
|
||
- QQ群号和QQ号都要用数字填写，不要加引号哦（除了机器人自己的QQ号）
|
||
|
||
## ⚠️ 注意事项
|
||
|
||
- 这个机器人还在测试中呢，可能会有一些小问题喵
|
||
- 如果不知道怎么改某个设置，就保持原样不要动它哦~
|
||
- 记得要先有AI服务的密钥，不然机器人就不能和你说话了呢
|
||
- 修改完配置后要重启机器人才能生效喵~
|