添加了宝宝巴士版配置教程
This commit is contained in:
SengokuCola
@@ -52,7 +52,8 @@
|
||||
- [📦 手动部署指南](docs/manual_deploy.md)
|
||||
|
||||
### 配置说明
|
||||
- [⚙️ 配置详细说明](docs/installation.md) - 环境和机器人配置的详细说明
|
||||
- [🎀 新手配置指南](docs/installation_cute.md) - 通俗易懂的配置教程，适合初次使用的猫娘
|
||||
- [⚙️ 标准配置指南](docs/installation_standard.md) - 简明专业的配置说明，适合有经验的用户
|
||||
|
||||
<div align="left">
|
||||
<h3>了解麦麦 </h3>
|
||||
|
||||
@@ -1,91 +1,227 @@
|
||||
# 🔧 安装与配置指南
|
||||
# 🔧 配置指南 喵~
|
||||
|
||||
## 👋 你好呀！
|
||||
|
||||
让咱来告诉你我们要做什么喵：
|
||||
1. 我们要一起设置一个可爱的AI机器人
|
||||
2. 这个机器人可以在QQ上陪你聊天玩耍哦
|
||||
3. 需要设置两个文件才能让机器人工作呢
|
||||
|
||||
## ⚙️ 配置说明
|
||||
## 📝 需要设置的文件喵
|
||||
|
||||
### 环境配置 (.env.prod)
|
||||
要设置这两个文件才能让机器人跑起来哦：
|
||||
1. `.env.prod` - 这个文件告诉机器人要用哪些AI服务呢
|
||||
2. `bot_config.toml` - 这个文件教机器人怎么和你聊天喵
|
||||
|
||||
## 🔑 密钥和域名的对应关系
|
||||
|
||||
想象一下，你要进入一个游乐园，需要：
|
||||
1. 知道游乐园的地址（这就是域名 base_url）
|
||||
2. 有入场的门票（这就是密钥 key）
|
||||
|
||||
在 `.env.prod` 文件里，我们定义了三个游乐园的地址和门票喵：
|
||||
```ini
|
||||
# API配置,你可以在这里定义你的密钥和base_url
|
||||
# 你可以选择定义其他服务商提供的KEY，完全可以自定义
|
||||
# 硅基流动游乐园
|
||||
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"
|
||||
base_url = "SILICONFLOW_BASE_URL" # 告诉机器人：去硅基流动游乐园玩
|
||||
key = "SILICONFLOW_KEY" # 用硅基流动的门票进去
|
||||
|
||||
[model.llm_normal]
|
||||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||||
base_url = "SILICONFLOW_BASE_URL" # 还是去硅基流动游乐园
|
||||
key = "SILICONFLOW_KEY" # 用同一张门票就可以啦
|
||||
```
|
||||
|
||||
### 🎪 举个例子喵：
|
||||
|
||||
如果你想用DeepSeek官方的服务，就要这样改：
|
||||
```toml
|
||||
[model.llm_reasoning]
|
||||
name = "Pro/deepseek-ai/DeepSeek-R1"
|
||||
base_url = "DEEP_SEEK_BASE_URL" # 改成去DeepSeek游乐园
|
||||
key = "DEEP_SEEK_KEY" # 用DeepSeek的门票
|
||||
|
||||
[model.llm_normal]
|
||||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||||
base_url = "DEEP_SEEK_BASE_URL" # 也去DeepSeek游乐园
|
||||
key = "DEEP_SEEK_KEY" # 用同一张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
|
||||
|
||||
# 服务配置,如果你不知道这是什么，保持默认
|
||||
# 如果你不知道这是什么，那么下面这些不用改，保持原样就好啦
|
||||
HOST=127.0.0.1
|
||||
PORT=8080
|
||||
|
||||
# 数据库配置,如果你不知道这是什么，保持默认
|
||||
# 这些是数据库设置，一般也不用改呢
|
||||
MONGODB_HOST=127.0.0.1
|
||||
MONGODB_PORT=27017
|
||||
DATABASE_NAME=MegBot
|
||||
MONGODB_USERNAME = "" # 如果数据库需要用户名，就在这里填写喵
|
||||
MONGODB_PASSWORD = "" # 如果数据库需要密码，就在这里填写呢
|
||||
MONGODB_AUTH_SOURCE = "" # 数据库认证源，一般不用改哦
|
||||
|
||||
# 插件设置喵
|
||||
PLUGINS=["src2.plugins.chat"] # 这里是机器人的插件列表呢
|
||||
```
|
||||
|
||||
### 机器人配置 (bot_config.toml)
|
||||
### 第二个文件：机器人配置 (bot_config.toml)
|
||||
|
||||
这个文件就像是教机器人"如何说话"的魔法书呢！
|
||||
|
||||
```toml
|
||||
[bot]
|
||||
qq = "你的机器人QQ号"
|
||||
nickname = "麦麦"
|
||||
qq = "把这里改成你的机器人QQ号喵" # 填写你的机器人QQ号
|
||||
nickname = "麦麦" # 机器人的名字，你可以改成你喜欢的任何名字哦
|
||||
|
||||
[personality]
|
||||
# 这里可以设置机器人的性格呢，让它更有趣一些喵
|
||||
prompt_personality = [
|
||||
"曾经是一个学习地质的女大学生，现在学习心理学和脑科学，你会刷贴吧", # 贴吧风格的性格
|
||||
"是一个女大学生，你有黑色头发，你会刷小红书" # 小红书风格的性格
|
||||
]
|
||||
prompt_schedule = "一个曾经学习地质,现在学习心理学和脑科学的女大学生，喜欢刷qq，贴吧，知乎和小红书"
|
||||
|
||||
[message]
|
||||
min_text_length = 2
|
||||
max_context_size = 15
|
||||
emoji_chance = 0.2
|
||||
min_text_length = 2 # 机器人每次至少要说几个字呢
|
||||
max_context_size = 15 # 机器人能记住多少条消息喵
|
||||
emoji_chance = 0.2 # 机器人使用表情的概率哦（0.2就是20%的机会呢）
|
||||
ban_words = ["脏话", "不文明用语"] # 在这里填写不让机器人说的词
|
||||
|
||||
[emoji]
|
||||
check_interval = 120
|
||||
register_interval = 10
|
||||
|
||||
[cq_code]
|
||||
enable_pic_translate = false
|
||||
|
||||
[response]
|
||||
#现已移除deepseek或硅基流动选项，可以直接切换分别配置任意模型
|
||||
model_r1_probability = 0.8 #推理模型权重
|
||||
model_v3_probability = 0.1 #非推理模型权重
|
||||
model_r1_distill_probability = 0.1
|
||||
|
||||
[memory]
|
||||
build_memory_interval = 300
|
||||
|
||||
[others]
|
||||
enable_advance_output = true # 是否启用详细日志输出
|
||||
auto_save = true # 是否自动保存看到的表情包呢
|
||||
enable_check = false # 是否要检查表情包是不是合适的喵
|
||||
check_prompt = "符合公序良俗" # 检查表情包的标准呢
|
||||
|
||||
[groups]
|
||||
talk_allowed = [] # 允许回复的群号列表
|
||||
talk_frequency_down = [] # 降低回复频率的群号列表
|
||||
ban_user_id = [] # 禁止回复的用户QQ号列表
|
||||
talk_allowed = [123456, 789012] # 比如：让机器人在群123456和789012里说话
|
||||
talk_frequency_down = [345678] # 比如：在群345678里少说点话
|
||||
ban_user_id = [111222] # 比如：不回复QQ号为111222的人的消息
|
||||
|
||||
[model.llm_reasoning]
|
||||
name = "Pro/deepseek-ai/DeepSeek-R1"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
[others]
|
||||
enable_advance_output = true # 是否要显示更多的运行信息呢
|
||||
enable_kuuki_read = true # 让机器人能够"察言观色"喵
|
||||
|
||||
[model.llm_reasoning_minor]
|
||||
# 模型配置部分的详细说明喵~
|
||||
|
||||
```toml
|
||||
#下面的模型若使用硅基流动则不需要更改，使用ds官方则改成在.env.prod自己指定的密钥和域名，使用自定义模型则选择定位相似的模型自己填写
|
||||
|
||||
[model.llm_reasoning] #推理模型R1，用来理解和思考的喵
|
||||
name = "Pro/deepseek-ai/DeepSeek-R1" # 模型名字
|
||||
# name = "Qwen/QwQ-32B" # 如果想用千问模型，可以把上面那行注释掉，用这个呢
|
||||
base_url = "SILICONFLOW_BASE_URL" # 使用在.env.prod里设置的服务地址
|
||||
key = "SILICONFLOW_KEY" # 使用在.env.prod里设置的密钥
|
||||
|
||||
[model.llm_reasoning_minor] #R1蒸馏模型，是个轻量版的推理模型喵
|
||||
name = "deepseek-ai/DeepSeek-R1-Distill-Qwen-32B"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_normal]
|
||||
[model.llm_normal] #V3模型，用来日常聊天的喵
|
||||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_normal_minor]
|
||||
[model.llm_normal_minor] #V2.5模型，是V3的前代版本呢
|
||||
name = "deepseek-ai/DeepSeek-V2.5"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.vlm]
|
||||
[model.vlm] #图像识别模型，让机器人能看懂图片喵
|
||||
name = "deepseek-ai/deepseek-vl2"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.embedding] #嵌入模型，帮助机器人理解文本的相似度呢
|
||||
name = "BAAI/bge-m3"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
# 主题提取功能，可以帮机器人理解对话的主题喵
|
||||
[topic]
|
||||
topic_extract='snownlp' # 可以选择：
|
||||
# - jieba（中文分词）
|
||||
# - snownlp（中文情感分析）
|
||||
# - llm（使用大模型，但需要API）
|
||||
|
||||
# 如果选择了llm方式提取主题，就用这个模型配置喵
|
||||
[topic.llm_topic]
|
||||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
```
|
||||
|
||||
## ⚠️ 注意事项
|
||||
## 💡 模型配置说明喵
|
||||
|
||||
- 目前部署方案仍在测试中，可能存在未知问题
|
||||
- 配置文件中的API密钥请妥善保管，不要泄露
|
||||
- 建议先在测试环境中运行，确认无误后再部署到生产环境
|
||||
1. **关于模型服务**：
|
||||
- 如果你用硅基流动的服务，这些配置都不用改呢
|
||||
- 如果用DeepSeek官方API，要把base_url和key改成你在.env.prod里设置的值喵
|
||||
- 如果要用自定义模型，选择一个相似功能的模型配置来改呢
|
||||
|
||||
2. **主要模型功能**：
|
||||
- `llm_reasoning`: 负责思考和推理的大脑喵
|
||||
- `llm_normal`: 负责日常聊天的嘴巴呢
|
||||
- `vlm`: 负责看图片的眼睛哦
|
||||
- `embedding`: 负责理解文字含义的理解力喵
|
||||
- `topic`: 负责理解对话主题的能力呢
|
||||
|
||||
3. **选择主题提取方式**：
|
||||
- `jieba`: 不需要API，适合简单的中文分词
|
||||
- `snownlp`: 不需要API，可以分析中文情感
|
||||
- `llm`: 效果最好，但需要API服务喵
|
||||
|
||||
## 🌟 小提示
|
||||
- 如果你刚开始使用，建议保持默认配置呢
|
||||
- 不同的模型有不同的特长，可以根据需要调整它们的使用比例哦
|
||||
|
||||
## 🌟 小贴士喵
|
||||
- 记得要好好保管密钥（key）哦，不要告诉别人呢
|
||||
- 配置文件要小心修改，改错了机器人可能就不能和你玩了喵
|
||||
- 如果想让机器人更聪明，可以调整 personality 里的设置呢
|
||||
- 不想让机器人说某些话，就把那些词放在 ban_words 里面喵
|
||||
- QQ群号和QQ号都要用数字填写，不要加引号哦（除了机器人自己的QQ号）
|
||||
|
||||
## ⚠️ 注意事项
|
||||
- 这个机器人还在测试中呢，可能会有一些小问题喵
|
||||
- 如果不知道怎么改某个设置，就保持原样不要动它哦~
|
||||
- 记得要先有AI服务的密钥，不然机器人就不能和你说话了呢
|
||||
- 修改完配置后要重启机器人才能生效喵~
|
||||
3
docs/installation_cute.md
Normal file
3
docs/installation_cute.md
Normal file
@@ -0,0 +1,3 @@
|
||||
# 🔧 小朋友的配置指南 喵~
|
||||
|
||||
[原文内容保持不变...]
|
||||
156
docs/installation_standard.md
Normal file
156
docs/installation_standard.md
Normal file
@@ -0,0 +1,156 @@
|
||||
# 🔧 配置指南
|
||||
|
||||
## 简介
|
||||
|
||||
本项目需要配置两个主要文件：
|
||||
1. `.env.prod` - 配置API服务和系统环境
|
||||
2. `bot_config.toml` - 配置机器人行为和模型
|
||||
|
||||
## API配置说明
|
||||
|
||||
`.env.prod`和`bot_config.toml`中的API配置关系如下：
|
||||
|
||||
### 在.env.prod中定义API凭证：
|
||||
```ini
|
||||
# API凭证配置
|
||||
SILICONFLOW_KEY=your_key # 硅基流动API密钥
|
||||
SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1/ # 硅基流动API地址
|
||||
|
||||
DEEP_SEEK_KEY=your_key # DeepSeek API密钥
|
||||
DEEP_SEEK_BASE_URL=https://api.deepseek.com/v1 # DeepSeek API地址
|
||||
|
||||
CHAT_ANY_WHERE_KEY=your_key # ChatAnyWhere API密钥
|
||||
CHAT_ANY_WHERE_BASE_URL=https://api.chatanywhere.tech/v1 # ChatAnyWhere API地址
|
||||
```
|
||||
|
||||
### 在bot_config.toml中引用API凭证：
|
||||
```toml
|
||||
[model.llm_reasoning]
|
||||
name = "Pro/deepseek-ai/DeepSeek-R1"
|
||||
base_url = "SILICONFLOW_BASE_URL" # 引用.env.prod中定义的地址
|
||||
key = "SILICONFLOW_KEY" # 引用.env.prod中定义的密钥
|
||||
```
|
||||
|
||||
如需切换到其他API服务，只需修改引用：
|
||||
```toml
|
||||
[model.llm_reasoning]
|
||||
name = "Pro/deepseek-ai/DeepSeek-R1"
|
||||
base_url = "DEEP_SEEK_BASE_URL" # 切换为DeepSeek服务
|
||||
key = "DEEP_SEEK_KEY" # 使用DeepSeek密钥
|
||||
```
|
||||
|
||||
## 配置文件详解
|
||||
|
||||
### 环境配置文件 (.env.prod)
|
||||
```ini
|
||||
# API配置
|
||||
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
|
||||
|
||||
# 服务配置
|
||||
HOST=127.0.0.1
|
||||
PORT=8080
|
||||
|
||||
# 数据库配置
|
||||
MONGODB_HOST=127.0.0.1
|
||||
MONGODB_PORT=27017
|
||||
DATABASE_NAME=MegBot
|
||||
MONGODB_USERNAME = "" # 数据库用户名
|
||||
MONGODB_PASSWORD = "" # 数据库密码
|
||||
MONGODB_AUTH_SOURCE = "" # 认证数据库
|
||||
|
||||
# 插件配置
|
||||
PLUGINS=["src2.plugins.chat"]
|
||||
```
|
||||
|
||||
### 机器人配置文件 (bot_config.toml)
|
||||
```toml
|
||||
[bot]
|
||||
qq = "机器人QQ号" # 必填
|
||||
nickname = "麦麦" # 机器人昵称
|
||||
|
||||
[personality]
|
||||
prompt_personality = [
|
||||
"曾经是一个学习地质的女大学生，现在学习心理学和脑科学，你会刷贴吧",
|
||||
"是一个女大学生，你有黑色头发，你会刷小红书"
|
||||
]
|
||||
prompt_schedule = "一个曾经学习地质,现在学习心理学和脑科学的女大学生，喜欢刷qq，贴吧，知乎和小红书"
|
||||
|
||||
[message]
|
||||
min_text_length = 2 # 最小回复长度
|
||||
max_context_size = 15 # 上下文记忆条数
|
||||
emoji_chance = 0.2 # 表情使用概率
|
||||
ban_words = [] # 禁用词列表
|
||||
|
||||
[emoji]
|
||||
auto_save = true # 自动保存表情
|
||||
enable_check = false # 启用表情审核
|
||||
check_prompt = "符合公序良俗"
|
||||
|
||||
[groups]
|
||||
talk_allowed = [] # 允许对话的群号
|
||||
talk_frequency_down = [] # 降低回复频率的群号
|
||||
ban_user_id = [] # 禁止回复的用户QQ号
|
||||
|
||||
[others]
|
||||
enable_advance_output = true # 启用详细日志
|
||||
enable_kuuki_read = true # 启用场景理解
|
||||
|
||||
# 模型配置
|
||||
[model.llm_reasoning] # 推理模型
|
||||
name = "Pro/deepseek-ai/DeepSeek-R1"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_reasoning_minor] # 轻量推理模型
|
||||
name = "deepseek-ai/DeepSeek-R1-Distill-Qwen-32B"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_normal] # 对话模型
|
||||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_normal_minor] # 备用对话模型
|
||||
name = "deepseek-ai/DeepSeek-V2.5"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.vlm] # 图像识别模型
|
||||
name = "deepseek-ai/deepseek-vl2"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.embedding] # 文本向量模型
|
||||
name = "BAAI/bge-m3"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[topic]
|
||||
topic_extract='snownlp' # 主题提取方式：jieba/snownlp/llm
|
||||
|
||||
[topic.llm_topic]
|
||||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
1. API密钥安全：
|
||||
- 妥善保管API密钥
|
||||
- 不要将含有密钥的配置文件上传至公开仓库
|
||||
|
||||
2. 配置修改：
|
||||
- 修改配置后需重启服务
|
||||
- 使用默认服务(硅基流动)时无需修改模型配置
|
||||
- QQ号和群号使用数字格式(机器人QQ号除外)
|
||||
|
||||
3. 其他说明：
|
||||
- 项目处于测试阶段，可能存在未知问题
|
||||
- 建议初次使用保持默认配置
|
||||
@@ -1,122 +1,82 @@
|
||||
# 📦 手动部署指南
|
||||
# 📦 如何手动部署MaiMbot麦麦？
|
||||
|
||||
## 部署步骤
|
||||
## 你需要什么？
|
||||
|
||||
- 一台电脑，能够上网的那种
|
||||
|
||||
- 一个QQ小号（QQ框架的使用可能导致qq被风控，严重（小概率）可能会导致账号封禁，强烈不推荐使用大号）
|
||||
|
||||
- 可用的大模型API
|
||||
|
||||
- 一个AI助手，网上随便搜一家打开来用都行，可以帮你解决一些不懂的问题
|
||||
|
||||
## 你需要知道什么？
|
||||
|
||||
- 如何正确向AI助手提问，来学习新知识
|
||||
|
||||
- Python是什么
|
||||
|
||||
- Python的虚拟环境是什么？如何创建虚拟环境
|
||||
|
||||
- 命令行是什么
|
||||
|
||||
- 数据库是什么？如何安装并启动MongoDB
|
||||
|
||||
- 如何运行一个QQ机器人，以及NapCat框架是什么
|
||||
|
||||
## 如果准备好了，就可以开始部署了
|
||||
|
||||
### 1️⃣ **我们需要创建一个Python环境来运行程序**
|
||||
|
||||
你可以选择使用以下两种方法之一来创建Python环境：
|
||||
|
||||
1. **环境准备**
|
||||
```bash
|
||||
# 创建虚拟环境（推荐）
|
||||
python -m venv venv
|
||||
venv\\Scripts\\activate # Windows
|
||||
# ---方法1：使用venv（Python自带）
|
||||
# 在命令行中创建虚拟环境（环境名为maimbot）
|
||||
# 这会让你在运行命令的目录下创建一个虚拟环境
|
||||
# 请确保你已通过cd命令前往到了对应路径，不然之后你可能找不到你的python环境
|
||||
python -m venv maimbot
|
||||
|
||||
maimbot\\Scripts\\activate
|
||||
|
||||
# 安装依赖
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
```bash
|
||||
# ---方法2：使用conda
|
||||
# 创建一个新的conda环境（环境名为maimbot）
|
||||
# Python版本为3.9
|
||||
conda create -n maimbot python=3.9
|
||||
|
||||
# 激活环境
|
||||
conda activate maimbot
|
||||
|
||||
# 安装依赖
|
||||
pip install -r requirements.txt
|
||||
```
|
||||
|
||||
2. **配置MongoDB**
|
||||
### 2️⃣ **然后你需要启动MongoDB数据库，来存储信息**
|
||||
- 安装并启动MongoDB服务
|
||||
- 默认连接本地27017端口
|
||||
|
||||
3. **配置NapCat**
|
||||
- 安装并登录NapCat
|
||||
### 3️⃣ **配置NapCat，让麦麦bot与qq取得联系**
|
||||
- 安装并登录NapCat（用你的qq小号）
|
||||
- 添加反向WS：`ws://localhost:8080/onebot/v11/ws`
|
||||
|
||||
4. **配置文件设置**
|
||||
### 4️⃣ **配置文件设置，让麦麦Bot正常工作**
|
||||
- 修改环境配置文件：`.env.prod`
|
||||
- 修改机器人配置文件：`bot_config.toml`
|
||||
|
||||
5. **启动麦麦机器人**
|
||||
### 5️⃣ **启动麦麦机器人**
|
||||
- 打开命令行，cd到对应路径
|
||||
```bash
|
||||
nb run
|
||||
```
|
||||
- 或者cd到对应路径后
|
||||
```bash
|
||||
python bot.py
|
||||
```
|
||||
|
||||
6. **其他组件**
|
||||
### 6️⃣ **其他组件(可选)**
|
||||
- `run_thingking.bat`: 启动可视化推理界面（未完善）
|
||||
- 直接运行 knowledge.py生成知识库
|
||||
|
||||
## ⚙️ 配置说明
|
||||
|
||||
### 环境配置 (.env.prod)
|
||||
```ini
|
||||
# API配置,你可以在这里定义你的密钥和base_url
|
||||
# 你可以选择定义其他服务商提供的KEY，完全可以自定义
|
||||
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
|
||||
|
||||
# 服务配置,如果你不知道这是什么，保持默认
|
||||
HOST=127.0.0.1
|
||||
PORT=8080
|
||||
|
||||
# 数据库配置,如果你不知道这是什么，保持默认
|
||||
MONGODB_HOST=127.0.0.1
|
||||
MONGODB_PORT=27017
|
||||
DATABASE_NAME=MegBot
|
||||
```
|
||||
|
||||
### 机器人配置 (bot_config.toml)
|
||||
```toml
|
||||
[bot]
|
||||
qq = "你的机器人QQ号"
|
||||
nickname = "麦麦"
|
||||
|
||||
[message]
|
||||
min_text_length = 2
|
||||
max_context_size = 15
|
||||
emoji_chance = 0.2
|
||||
|
||||
[emoji]
|
||||
check_interval = 120
|
||||
register_interval = 10
|
||||
|
||||
[cq_code]
|
||||
enable_pic_translate = false
|
||||
|
||||
[response]
|
||||
#现已移除deepseek或硅基流动选项，可以直接切换分别配置任意模型
|
||||
model_r1_probability = 0.8 #推理模型权重
|
||||
model_v3_probability = 0.1 #非推理模型权重
|
||||
model_r1_distill_probability = 0.1
|
||||
|
||||
[memory]
|
||||
build_memory_interval = 300
|
||||
|
||||
[others]
|
||||
enable_advance_output = true # 是否启用详细日志输出
|
||||
|
||||
[groups]
|
||||
talk_allowed = [] # 允许回复的群号列表
|
||||
talk_frequency_down = [] # 降低回复频率的群号列表
|
||||
ban_user_id = [] # 禁止回复的用户QQ号列表
|
||||
|
||||
[model.llm_reasoning]
|
||||
name = "Pro/deepseek-ai/DeepSeek-R1"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_reasoning_minor]
|
||||
name = "deepseek-ai/DeepSeek-R1-Distill-Qwen-32B"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_normal]
|
||||
name = "Pro/deepseek-ai/DeepSeek-V3"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.llm_normal_minor]
|
||||
name = "deepseek-ai/DeepSeek-V2.5"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
|
||||
[model.vlm]
|
||||
name = "deepseek-ai/deepseek-vl2"
|
||||
base_url = "SILICONFLOW_BASE_URL"
|
||||
key = "SILICONFLOW_KEY"
|
||||
```
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
- 目前部署方案仍在测试中，可能存在未知问题
|
||||
- 配置文件中的API密钥请妥善保管，不要泄露
|
||||
- 建议先在测试环境中运行，确认无误后再部署到生产环境
|
||||
Reference in New Issue
Block a user