From 0b31e44b271be8afa909f0087f1b97f9258c1df8 Mon Sep 17 00:00:00 2001
From: SengokuCola <1026294844@qq.com>
Date: Fri, 7 Mar 2025 10:10:59 +0800
Subject: [PATCH] Update installation_cute.md

---
 docs/installation_cute.md | 228 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 226 insertions(+), 2 deletions(-)

diff --git a/docs/installation_cute.md b/docs/installation_cute.md
index 4da187ec5..a1334a2eb 100644
--- a/docs/installation_cute.md
+++ b/docs/installation_cute.md
@@ -1,3 +1,227 @@
-# 🔧 小朋友的配置指南 喵~
+# 🔧 配置指南 喵~
 
-[原文内容保持不变...] 
\ No newline at end of file
+## 👋 你好呀！
+
+让咱来告诉你我们要做什么喵：
+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"
+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)
+
+这个文件就像是教机器人"如何说话"的魔法书呢！
+
+```toml
+[bot]
+qq = "把这里改成你的机器人QQ号喵"  # 填写你的机器人QQ号
+nickname = "麦麦"  # 机器人的名字，你可以改成你喜欢的任何名字哦
+
+[personality]
+# 这里可以设置机器人的性格呢，让它更有趣一些喵
+prompt_personality = [
+    "曾经是一个学习地质的女大学生，现在学习心理学和脑科学，你会刷贴吧",    # 贴吧风格的性格
+    "是一个女大学生，你有黑色头发，你会刷小红书"    # 小红书风格的性格
+]
+prompt_schedule = "一个曾经学习地质,现在学习心理学和脑科学的女大学生，喜欢刷qq，贴吧，知乎和小红书"
+
+[message]
+min_text_length = 2  # 机器人每次至少要说几个字呢
+max_context_size = 15  # 机器人能记住多少条消息喵
+emoji_chance = 0.2  # 机器人使用表情的概率哦（0.2就是20%的机会呢）
+ban_words = ["脏话", "不文明用语"]  # 在这里填写不让机器人说的词
+
+[emoji]
+auto_save = true  # 是否自动保存看到的表情包呢
+enable_check = false  # 是否要检查表情包是不是合适的喵
+check_prompt = "符合公序良俗"  # 检查表情包的标准呢
+
+[groups]
+talk_allowed = [123456, 789012]      # 比如：让机器人在群123456和789012里说话
+talk_frequency_down = [345678]   # 比如：在群345678里少说点话
+ban_user_id = [111222]      # 比如：不回复QQ号为111222的人的消息
+
+[others]
+enable_advance_output = true  # 是否要显示更多的运行信息呢
+enable_kuuki_read = true  # 让机器人能够"察言观色"喵
+
+# 模型配置部分的详细说明喵~
+
+```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] #V3模型，用来日常聊天的喵
+name = "Pro/deepseek-ai/DeepSeek-V3"
+base_url = "SILICONFLOW_BASE_URL"
+key = "SILICONFLOW_KEY"
+
+[model.llm_normal_minor] #V2.5模型，是V3的前代版本呢
+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（使用大模型，但需要API）
+
+# 如果选择了llm方式提取主题，就用这个模型配置喵
+[topic.llm_topic]
+name = "Pro/deepseek-ai/DeepSeek-V3"
+base_url = "SILICONFLOW_BASE_URL"
+key = "SILICONFLOW_KEY"
+```
+
+## 💡 模型配置说明喵
+
+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服务的密钥，不然机器人就不能和你说话了呢
+- 修改完配置后要重启机器人才能生效喵~
\ No newline at end of file