整理doc文件夹,添加macos教程

This commit is contained in:
enKl03b
2025-03-20 23:10:33 +08:00
parent 7ccfe464a5
commit 7c5cdb82bc
18 changed files with 297 additions and 190 deletions

View File

@@ -101,7 +101,7 @@
<div align="center"> <div align="center">
<a href="https://www.bilibili.com/video/BV1amAneGE3P" target="_blank"> <a href="https://www.bilibili.com/video/BV1amAneGE3P" target="_blank">
<img src="docs/video.png" width="300" alt="麦麦演示视频"> <img src="docs/pic/video.png" width="300" alt="麦麦演示视频">
<br> <br>
👆 点击观看麦麦演示视频 👆 👆 点击观看麦麦演示视频 👆

View File

@@ -10,7 +10,7 @@
- 为什么显示:"缺失必要的API KEY" ❓ - 为什么显示:"缺失必要的API KEY" ❓
<img src="API_KEY.png" width=650> <img src="./pic/API_KEY.png" width=650>
>你需要在 [Silicon Flow Api](https://cloud.siliconflow.cn/account/ak) 网站上注册一个账号然后点击这个链接打开API KEY获取页面。 >你需要在 [Silicon Flow Api](https://cloud.siliconflow.cn/account/ak) 网站上注册一个账号然后点击这个链接打开API KEY获取页面。
> >
@@ -41,19 +41,19 @@
>打开你的MongoDB Compass软件你会在左上角看到这样的一个界面 >打开你的MongoDB Compass软件你会在左上角看到这样的一个界面
> >
><img src="MONGO_DB_0.png" width=250> ><img src="./pic/MONGO_DB_0.png" width=250>
> >
><br> ><br>
> >
>点击 "CONNECT" 之后,点击展开 MegBot 标签栏 >点击 "CONNECT" 之后,点击展开 MegBot 标签栏
> >
><img src="MONGO_DB_1.png" width=250> ><img src="./pic/MONGO_DB_1.png" width=250>
> >
><br> ><br>
> >
>点进 "emoji" 再点击 "DELETE" 删掉所有条目,如图所示 >点进 "emoji" 再点击 "DELETE" 删掉所有条目,如图所示
> >
><img src="MONGO_DB_2.png" width=450> ><img src="./pic/MONGO_DB_2.png" width=450>
> >
><br> ><br>
> >

View File

@@ -1,48 +1,51 @@
# 面向纯新手的Linux服务器麦麦部署指南 # 面向纯新手的Linux服务器麦麦部署指南
## 你得先有一个服务器
为了能使麦麦在你的电脑关机之后还能运行,你需要一台不间断开机的主机,也就是我们常说的服务器。 ## 事前准备
为了能使麦麦不间断的运行,你需要一台一直开着的主机。
### 如果你想购买服务器
华为云、阿里云、腾讯云等等都是在国内可以选择的选择。 华为云、阿里云、腾讯云等等都是在国内可以选择的选择。
你可以去租一台最低配置的就足敷需要了,按月租大概十几块钱就能租到了。 租一台最低配置的就足敷需要了,按月租大概十几块钱就能租到了。
我们假设你已经租好了一台Linux架构的云服务器。我用的是阿里云ubuntu24.04,其他的原理相似。 ### 如果你不想购买服务器
你可以准备一台可以一直开着的电脑/主机,只需要保证能够正常访问互联网即可
我们假设你已经有了一台Linux架构的服务器。举例使用的是Ubuntu24.04,其他的原理相似。
## 0.我们就从零开始吧 ## 0.我们就从零开始吧
### 网络问题 ### 网络问题
为访问github相关界面推荐去下一款加速器新手可以试试watttoolkit。 为访问Github相关界面推荐去下一款加速器新手可以试试[Watt Toolkit](https://gitee.com/rmbgame/SteamTools/releases/latest)
### 安装包下载 ### 安装包下载
#### MongoDB #### MongoDB
进入[MongoDB下载页](https://www.mongodb.com/try/download/community-kubernetes-operator),并选择版本
对于ubuntu24.04 x86来说是这个 以Ubuntu24.04 x86为例,保持如图所示选项,点击`Download`即可,如果是其他系统,请在`Platform`中自行选择
https://repo.mongodb.org/apt/ubuntu/dists/noble/mongodb-org/8.0/multiverse/binary-amd64/mongodb-org-server_8.0.5_amd64.deb ![](./pic/MongoDB_Ubuntu_guide.png)
如果不是就在这里自行选择对应版本
https://www.mongodb.com/try/download/community-kubernetes-operator 不想使用上述方式?你也可以参考[官方文档](https://www.mongodb.com/zh-cn/docs/manual/administration/install-on-linux/#std-label-install-mdb-community-edition-linux)进行安装,进入后选择自己的系统版本即可
#### Napcat #### QQ可选/Napcat
*如果你使用Napcat的脚本安装可以忽略此步*
在这里选择对应版本。 访问https://github.com/NapNeko/NapCatQQ/releases/latest
在图中所示区域可以找到QQ的下载链接选择对应版本下载即可
https://github.com/NapNeko/NapCatQQ/releases/tag/v4.6.7 从这里下载可以保证你下载到的QQ版本兼容最新版Napcat
![](./pic/QQ_Download_guide_Linux.png)
对于ubuntu24.04 x86来说是这个 如果你不想使用Napcat的脚本安装还需参考[Napcat-Linux手动安装](https://www.napcat.wiki/guide/boot/Shell-Linux-SemiAuto)
https://dldir1.qq.com/qqfile/qq/QQNT/ee4bd910/linuxqq_3.2.16-32793_amd64.deb
#### 麦麦 #### 麦麦
https://github.com/SengokuCola/MaiMBot/archive/refs/tags/0.5.8-alpha.zip 先打开https://github.com/MaiM-with-u/MaiBot/releases
往下滑找到这个
下载这个官方压缩包。 ![下载指引](./pic/linux_beginner_downloadguide.png "")
下载箭头所指这个压缩包。
### 路径 ### 路径
@@ -53,10 +56,10 @@ https://github.com/SengokuCola/MaiMBot/archive/refs/tags/0.5.8-alpha.zip
``` ```
moi moi
└─ mai └─ mai
├─ linuxqq_3.2.16-32793_amd64.deb ├─ linuxqq_3.2.16-32793_amd64.deb # linuxqq安装包
├─ mongodb-org-server_8.0.5_amd64.deb ├─ mongodb-org-server_8.0.5_amd64.deb # MongoDB的安装包
└─ bot └─ bot
└─ MaiMBot-0.5.8-alpha.zip └─ MaiMBot-0.5.8-alpha.zip # 麦麦的压缩包
``` ```
### 网络 ### 网络
@@ -69,7 +72,7 @@ moi
## 2. Python的安装 ## 2. Python的安装
- 导入 Python 的稳定版 PPA - 导入 Python 的稳定版 PPAUbuntu需执行此步Debian可忽略
```bash ```bash
sudo add-apt-repository ppa:deadsnakes/ppa sudo add-apt-repository ppa:deadsnakes/ppa
@@ -92,6 +95,11 @@ sudo apt install python3.12
```bash ```bash
python3.12 --version python3.12 --version
``` ```
- (可选)更新替代方案,设置 python3.12 为默认的 python3 版本:
```bash
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1
sudo update-alternatives --config python3
```
- 在「终端」中,执行以下命令安装 pip - 在「终端」中,执行以下命令安装 pip
@@ -141,23 +149,17 @@ systemctl status mongod #通过这条指令检查运行状态
sudo systemctl enable mongod sudo systemctl enable mongod
``` ```
## 5.napcat的安装 ## 5.Napcat的安装
``` bash ``` bash
# 该脚本适用于支持Ubuntu 20+/Debian 10+/Centos9
curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh
``` ```
执行后脚本会自动帮你部署好QQ及Napcat
上面的不行试试下面的
``` bash
dpkg -i linuxqq_3.2.16-32793_amd64.deb
apt-get install -f
dpkg -i linuxqq_3.2.16-32793_amd64.deb
```
成功的标志是输入``` napcat ```出来炫酷的彩虹色界面 成功的标志是输入``` napcat ```出来炫酷的彩虹色界面
## 6.napcat的运行 ## 6.Napcat的运行
此时你就可以根据提示在```napcat```里面登录你的QQ号了。 此时你就可以根据提示在```napcat```里面登录你的QQ号了。
@@ -170,6 +172,13 @@ napcat status #检查运行状态
```http://<你服务器的公网IP>:6099/webui?token=napcat``` ```http://<你服务器的公网IP>:6099/webui?token=napcat```
如果你部署在自己的电脑上:
```http://127.0.0.1:6099/webui?token=napcat```
> [!WARNING]
> 如果你的麦麦部署在公网,请**务必**修改Napcat的默认密码
第一次是这个后续改了密码之后token就会对应修改。你也可以使用```napcat log <你的QQ号>```来查看webui地址。把里面的```127.0.0.1```改成<你服务器的公网IP>即可。 第一次是这个后续改了密码之后token就会对应修改。你也可以使用```napcat log <你的QQ号>```来查看webui地址。把里面的```127.0.0.1```改成<你服务器的公网IP>即可。
登录上之后在网络配置界面添加websocket客户端名称随便输一个url改成`ws://127.0.0.1:8080/onebot/v11/ws`保存之后点启用,就大功告成了。 登录上之后在网络配置界面添加websocket客户端名称随便输一个url改成`ws://127.0.0.1:8080/onebot/v11/ws`保存之后点启用,就大功告成了。
@@ -178,7 +187,7 @@ napcat status #检查运行状态
### step 1 安装解压软件 ### step 1 安装解压软件
``` ```bash
sudo apt-get install unzip sudo apt-get install unzip
``` ```
@@ -229,138 +238,11 @@ bot
你可以注册一个硅基流动的账号通过邀请码注册有14块钱的免费额度https://cloud.siliconflow.cn/i/7Yld7cfg。 你可以注册一个硅基流动的账号通过邀请码注册有14块钱的免费额度https://cloud.siliconflow.cn/i/7Yld7cfg。
#### 在.env.prod中定义API凭证 #### 修改配置文件
请参考
- [🎀 新手配置指南](./installation_cute.md) - 通俗易懂的配置教程,适合初次使用的猫娘
- [⚙️ 标准配置指南](./installation_standard.md) - 简明专业的配置说明,适合有经验的用户
```
# 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凭证
```
[model.llm_reasoning]
name = "Pro/deepseek-ai/DeepSeek-R1"
base_url = "SILICONFLOW_BASE_URL" # 引用.env.prod中定义的地址
key = "SILICONFLOW_KEY" # 引用.env.prod中定义的密钥
```
如需切换到其他API服务只需修改引用
```
[model.llm_reasoning]
name = "Pro/deepseek-ai/DeepSeek-R1"
base_url = "DEEP_SEEK_BASE_URL" # 切换为DeepSeek服务
key = "DEEP_SEEK_KEY" # 使用DeepSeek密钥
```
#### 配置文件详解
##### 环境配置文件 (.env.prod)
```
# 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 # 如果使用Docker部署需要改成0.0.0.0否则QQ消息无法传入
PORT=8080
# 数据库配置
MONGODB_HOST=127.0.0.1 # 如果使用Docker部署需要改成数据库容器的名字默认是mongodb
MONGODB_PORT=27017
DATABASE_NAME=MegBot
MONGODB_USERNAME = "" # 数据库用户名
MONGODB_PASSWORD = "" # 数据库密码
MONGODB_AUTH_SOURCE = "" # 认证数据库
# 插件配置
PLUGINS=["src2.plugins.chat"]
```
##### 机器人配置文件 (bot_config.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.llm_topic]
name = "Pro/deepseek-ai/DeepSeek-V3"
base_url = "SILICONFLOW_BASE_URL"
key = "SILICONFLOW_KEY"
```
**step # 6** 运行 **step # 6** 运行
@@ -438,7 +320,7 @@ sudo systemctl enable bot.service # 启动bot服务
sudo systemctl status bot.service # 检查bot服务状态 sudo systemctl status bot.service # 检查bot服务状态
``` ```
``` ```python
python bot.py python bot.py # 运行麦麦
``` ```

View File

@@ -6,7 +6,7 @@
- QQ小号QQ框架的使用可能导致qq被风控严重小概率可能会导致账号封禁强烈不推荐使用大号 - QQ小号QQ框架的使用可能导致qq被风控严重小概率可能会导致账号封禁强烈不推荐使用大号
- 可用的大模型API - 可用的大模型API
- 一个AI助手网上随便搜一家打开来用都行可以帮你解决一些不懂的问题 - 一个AI助手网上随便搜一家打开来用都行可以帮你解决一些不懂的问题
- 以下内容假设你对Linux系统有一定的了解如果觉得难以理解请直接用Windows系统部署[Windows系统部署指南](./manual_deploy_windows.md) - 以下内容假设你对Linux系统有一定的了解如果觉得难以理解请直接用Windows系统部署[Windows系统部署指南](./manual_deploy_windows.md)或[使用Windows一键包部署](https://github.com/MaiM-with-u/MaiBot/releases/tag/EasyInstall-windows)
## 你需要知道什么? ## 你需要知道什么?
@@ -24,6 +24,9 @@
--- ---
## 一键部署
请下载并运行项目根目录中的run.sh并按照提示安装部署完成后请参照后续配置指南进行配置
## 环境配置 ## 环境配置
### 1⃣ **确认Python版本** ### 1⃣ **确认Python版本**
@@ -36,17 +39,26 @@ python --version
python3 --version python3 --version
``` ```
如果版本低于3.9请更新Python版本 如果版本低于3.9请更新Python版本目前建议使用python3.12
```bash ```bash
# Ubuntu/Debian # Debian
sudo apt update sudo apt update
sudo apt install python3.9 sudo apt install python3.12
# 如执行了这一步建议在执行时将python3指向python3.9 # Ubuntu
# 更新替代方案,设置 python3.9 为默认的 python3 版本: sudo add-apt-repository ppa:deadsnakes/ppa
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.9 1 sudo apt update
sudo apt install python3.12
# 执行完以上命令后建议在执行时将python3指向python3.12
# 更新替代方案,设置 python3.12 为默认的 python3 版本:
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.12 1
sudo update-alternatives --config python3 sudo update-alternatives --config python3
``` ```
建议再执行以下命令,使后续运行命令中的`python3`等同于`python`
```bash
sudo apt install python-is-python3
```
### 2⃣ **创建虚拟环境** ### 2⃣ **创建虚拟环境**
@@ -73,7 +85,7 @@ pip install -r requirements.txt
### 3⃣ **安装并启动MongoDB** ### 3⃣ **安装并启动MongoDB**
- 安装与启动:Debian参考[官方文档](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-debian/)Ubuntu参考[官方文档](https://docs.mongodb.com/manual/tutorial/install-mongodb-on-ubuntu/) - 安装与启动:参考[官方文档](https://www.mongodb.com/zh-cn/docs/manual/administration/install-on-linux/#std-label-install-mdb-community-edition-linux),进入后选择自己的系统版本即可
- 默认连接本地27017端口 - 默认连接本地27017端口
--- ---
@@ -82,7 +94,11 @@ pip install -r requirements.txt
### 4⃣ **安装NapCat框架** ### 4⃣ **安装NapCat框架**
- 参考[NapCat官方文档](https://www.napcat.wiki/guide/boot/Shell#napcat-installer-linux%E4%B8%80%E9%94%AE%E4%BD%BF%E7%94%A8%E8%84%9A%E6%9C%AC-%E6%94%AF%E6%8C%81ubuntu-20-debian-10-centos9)安装 - 执行NapCat的Linux一键使用脚本(支持Ubuntu 20+/Debian 10+/Centos9)
```bash
curl -o napcat.sh https://nclatest.znin.net/NapNeko/NapCat-Installer/main/script/install.sh && sudo bash napcat.sh
```
- 如果你不想使用Napcat的脚本安装可参考[Napcat-Linux手动安装](https://www.napcat.wiki/guide/boot/Shell-Linux-SemiAuto)
- 使用QQ小号登录添加反向WS地址: `ws://127.0.0.1:8080/onebot/v11/ws` - 使用QQ小号登录添加反向WS地址: `ws://127.0.0.1:8080/onebot/v11/ws`
@@ -91,9 +107,17 @@ pip install -r requirements.txt
## 配置文件设置 ## 配置文件设置
### 5⃣ **配置文件设置让麦麦Bot正常工作** ### 5⃣ **配置文件设置让麦麦Bot正常工作**
可先运行一次
- 修改环境配置文件:`.env.prod` ```bash
- 修改机器人配置文件:`bot_config.toml` # 在项目目录下操作
nb run
# 或
python3 bot.py
```
之后你就可以找到`.env.prod``bot_config.toml`这两个文件了
关于文件内容的配置请参考:
- [🎀 新手配置指南](./installation_cute.md) - 通俗易懂的配置教程,适合初次使用的猫娘
- [⚙️ 标准配置指南](./installation_standard.md) - 简明专业的配置说明,适合有经验的用户
--- ---

201
docs/manual_deploy_macos.md Normal file
View File

@@ -0,0 +1,201 @@
# 📦 macOS系统手动部署MaiMbot麦麦指南
## 准备工作
- 一台搭载了macOS系统的设备macOS 12.0 或以上)
- QQ小号QQ框架的使用可能导致qq被风控严重小概率可能会导致账号封禁强烈不推荐使用大号
- Homebrew包管理器
- 如未安装你可以在https://github.com/Homebrew/brew/releases/latest 找到.pkg格式的安装包
- 可用的大模型API
- 一个AI助手网上随便搜一家打开来用都行可以帮你解决一些不懂的问题
- 以下内容假设你对macOS系统有一定的了解如果觉得难以理解请直接用Windows系统部署[Windows系统部署指南](./manual_deploy_windows.md)或[使用Windows一键包部署](https://github.com/MaiM-with-u/MaiBot/releases/tag/EasyInstall-windows)
- 终端应用iTerm2等
---
## 环境配置
### 1⃣ **Python环境配置**
```bash
# 检查Python版本macOS自带python可能为2.7
python3 --version
# 通过Homebrew安装Python
brew install python@3.12
# 设置环境变量如使用zsh
echo 'export PATH="/usr/local/opt/python@3.12/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 验证安装
python3 --version # 应显示3.12.x
pip3 --version # 应关联3.12版本
```
### 2⃣ **创建虚拟环境**
```bash
# 方法1使用venv推荐
python3 -m venv maimbot-venv
source maimbot-venv/bin/activate # 激活虚拟环境
# 方法2使用conda
brew install --cask miniconda
conda create -n maimbot python=3.9
conda activate maimbot # 激活虚拟环境
# 安装项目依赖
# 请确保已经进入虚拟环境再执行
pip install -r requirements.txt
```
---
## 数据库配置
### 3⃣ **安装MongoDB**
请参考[官方文档](https://www.mongodb.com/zh-cn/docs/manual/tutorial/install-mongodb-on-os-x/#install-mongodb-community-edition)
---
## NapCat
### 4⃣ **安装与配置Napcat**
- 安装
可以使用Napcat官方提供的[macOS安装工具](https://github.com/NapNeko/NapCat-Mac-Installer/releases/)
由于权限问题,补丁过程需要手动替换 package.json请注意备份原文件
- 配置
使用QQ小号登录添加反向WS地址: `ws://127.0.0.1:8080/onebot/v11/ws`
---
## 配置文件设置
### 5⃣ **生成配置文件**
可先运行一次
```bash
# 在项目目录下操作
nb run
# 或
python3 bot.py
```
之后你就可以找到`.env.prod``bot_config.toml`这两个文件了
关于文件内容的配置请参考:
- [🎀 新手配置指南](./installation_cute.md) - 通俗易懂的配置教程,适合初次使用的猫娘
- [⚙️ 标准配置指南](./installation_standard.md) - 简明专业的配置说明,适合有经验的用户
---
## 启动机器人
### 6⃣ **启动麦麦机器人**
```bash
# 在项目目录下操作
nb run
# 或
python3 bot.py
```
## 启动管理
### 7⃣ **通过launchd管理服务**
创建plist文件
```bash
nano ~/Library/LaunchAgents/com.maimbot.plist
```
内容示例(需替换实际路径):
```xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.maimbot</string>
<key>ProgramArguments</key>
<array>
<string>/path/to/maimbot-venv/bin/python</string>
<string>/path/to/MaiMbot/bot.py</string>
</array>
<key>WorkingDirectory</key>
<string>/path/to/MaiMbot</string>
<key>StandardOutPath</key>
<string>/tmp/maimbot.log</string>
<key>StandardErrorPath</key>
<string>/tmp/maimbot.err</string>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
</dict>
</plist>
```
加载服务:
```bash
launchctl load ~/Library/LaunchAgents/com.maimbot.plist
launchctl start com.maimbot
```
查看日志:
```bash
tail -f /tmp/maimbot.log
```
---
## 常见问题处理
1. **权限问题**
```bash
# 遇到文件权限错误时
chmod -R 755 ~/Documents/MaiMbot
```
2. **Python模块缺失**
```bash
# 确保在虚拟环境中
source maimbot-venv/bin/activate # 或 conda 激活
pip install --force-reinstall -r requirements.txt
```
3. **MongoDB连接失败**
```bash
# 检查服务状态
brew services list
# 重置数据库权限
mongosh --eval "db.adminCommand({setFeatureCompatibilityVersion: '5.0'})"
```
---
## 系统优化建议
1. **关闭App Nap**
```bash
# 防止系统休眠NapCat进程
defaults write NSGlobalDomain NSAppSleepDisabled -bool YES
```
2. **电源管理设置**
```bash
# 防止睡眠影响机器人运行
sudo systemsetup -setcomputersleep Never
```
---

View File

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 47 KiB

View File

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

View File

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 27 KiB

View File

Before

Width:  |  Height:  |  Size: 31 KiB

After

Width:  |  Height:  |  Size: 31 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 14 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 37 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

View File

Before

Width:  |  Height:  |  Size: 107 KiB

After

Width:  |  Height:  |  Size: 107 KiB

View File

Before

Width:  |  Height:  |  Size: 208 KiB

After

Width:  |  Height:  |  Size: 208 KiB

View File

Before

Width:  |  Height:  |  Size: 170 KiB

After

Width:  |  Height:  |  Size: 170 KiB

View File

Before

Width:  |  Height:  |  Size: 133 KiB

After

Width:  |  Height:  |  Size: 133 KiB

View File

Before

Width:  |  Height:  |  Size: 27 KiB

After

Width:  |  Height:  |  Size: 27 KiB

View File

@@ -16,7 +16,7 @@
docker-compose.yml: https://github.com/SengokuCola/MaiMBot/blob/main/docker-compose.yml docker-compose.yml: https://github.com/SengokuCola/MaiMBot/blob/main/docker-compose.yml
下载后打开,将 `services-mongodb-image` 修改为 `mongo:4.4.24`。这是因为最新的 MongoDB 强制要求 AVX 指令集,而群晖似乎不支持这个指令集 下载后打开,将 `services-mongodb-image` 修改为 `mongo:4.4.24`。这是因为最新的 MongoDB 强制要求 AVX 指令集,而群晖似乎不支持这个指令集
![](https://raw.githubusercontent.com/ProperSAMA/MaiMBot/refs/heads/debug/docs/synology_docker-compose.png) ![](./pic/synology_docker-compose.png)
bot_config.toml: https://github.com/SengokuCola/MaiMBot/blob/main/template/bot_config_template.toml bot_config.toml: https://github.com/SengokuCola/MaiMBot/blob/main/template/bot_config_template.toml
下载后,重命名为 `bot_config.toml` 下载后,重命名为 `bot_config.toml`
@@ -26,13 +26,13 @@ bot_config.toml: https://github.com/SengokuCola/MaiMBot/blob/main/template/bot_c
下载后,重命名为 `.env.prod` 下载后,重命名为 `.env.prod`
`HOST` 修改为 `0.0.0.0`,确保 maimbot 能被 napcat 访问 `HOST` 修改为 `0.0.0.0`,确保 maimbot 能被 napcat 访问
按下图修改 mongodb 设置,使用 `MONGODB_URI` 按下图修改 mongodb 设置,使用 `MONGODB_URI`
![](https://raw.githubusercontent.com/ProperSAMA/MaiMBot/refs/heads/debug/docs/synology_.env.prod.png) ![](./pic/synology_.env.prod.png)
`bot_config.toml``.env.prod` 放入之前创建的 `MaiMBot`文件夹 `bot_config.toml``.env.prod` 放入之前创建的 `MaiMBot`文件夹
#### 如何下载? #### 如何下载?
点这里!![](https://raw.githubusercontent.com/ProperSAMA/MaiMBot/refs/heads/debug/docs/synology_how_to_download.png) 点这里!![](./pic/synology_how_to_download.png)
### 创建项目 ### 创建项目
@@ -45,7 +45,7 @@ bot_config.toml: https://github.com/SengokuCola/MaiMBot/blob/main/template/bot_c
图例: 图例:
![](https://raw.githubusercontent.com/ProperSAMA/MaiMBot/refs/heads/debug/docs/synology_create_project.png) ![](./pic/synology_create_project.png)
一路点下一步,等待项目创建完成 一路点下一步,等待项目创建完成