Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

修改qa格式,原版的简直灾难 #3

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -138,3 +138,4 @@ dist
# VitePress
.vitepress/dist
.vitepress/cache
package-lock.json
125 changes: 45 additions & 80 deletions manual/usage/fast_q_a.md
Original file line number Diff line number Diff line change
@@ -1,112 +1,57 @@
# 快速更新Q&A❓

<br>

- 这个文件用来记录一些常见的新手问题。

<br>
这个文件用来记录一些常见的新手问题。

## 完整安装教程

<br>

[MaiMbot简易配置教程](https://www.bilibili.com/video/BV1zsQ5YCEE6)

<br>

## Api相关问题

<br>

<br>

- 为什么显示:"缺失必要的API KEY" ❓

<br>


<img src="/images/API_KEY.png" width=650>


---

<br>

><br>
>
>你需要在 [Silicon Flow Api](https://cloud.siliconflow.cn/account/ak)
>网站上注册一个账号,然后点击这个链接打开API KEY获取页面。
>你需要在 [Silicon Flow Api](https://cloud.siliconflow.cn/account/ak) 网站上注册一个账号,然后点击这个链接打开API KEY获取页面。
>
>点击 "新建API密钥" 按钮新建一个给MaiMBot使用的API KEY。不要忘了点击复制。
>
>之后打开MaiMBot在你电脑上的文件根目录,使用记事本或者其他文本编辑器打开 `.env.prod`
>这个文件。把你刚才复制的API KEY填入到 "SILICONFLOW_KEY=" 这个等号的右边。
>之后打开MaiMBot在你电脑上的文件根目录,使用记事本或者其他文本编辑器打开 `.env.prod` 这个文件。把你刚才复制的API KEY填入到 `SILICONFLOW_KEY=` 这个等号的右边。
>
>在默认情况下,MaiMBot使用的默认Api都是硅基流动的。
>
><br>

<br>

<br>


- 我想使用硅基流动之外的Api网站,我应该怎么做 ❓

---

<br>
- 我想使用硅基流动之外的Api网站,我应该怎么做 ❓

><br>
>
>你需要使用记事本或者其他文本编辑器打开config目录下的 `bot_config.toml`
>然后修改其中的 "provider = " 字段。同时不要忘记模仿 `.env.prod`
>文件的写法添加 Api Key 和 Base URL。
>
>举个例子,如果你写了 " provider = \"ABC\" ",那你需要相应的在 `.env.prod`
>文件里添加形如 " ABC_BASE_URL = https://api.abc.com/v1 " 和 " ABC_KEY = sk-1145141919810 " 的字段。
>然后修改其中的 `provider = ` 字段。同时不要忘记模仿 `.env.prod` 文件的写法添加 Api Key 和 Base URL。
>
>**如果你对AI没有较深的了解,修改识图模型和嵌入模型的provider字段可能会产生bug,因为你从网站调用了一个并不存在的模型**
>举个例子,如果你写了 `provider = "ABC"`,那你需要相应的在 `.env.prod` 文件里添加形如 `ABC_BASE_URL = https://api.abc.com/v1` 和 `ABC_KEY = sk-1145141919810` 的字段。
>
>这个时候,你需要把字段的值改回 "provider = \"SILICONFLOW\" " 以此解决bug。
>**如果你对AI模型没有较深的了解,修改识图模型和嵌入模型的provider字段可能会产生bug,因为你从网站调用了一个并不存在的模型**
>
><br>


<br>
>这个时候,你需要把字段的值改回 `provider = "SILICONFLOW"` 以此解决此问题。

## MongoDB相关问题

<br>

- 我应该怎么清空bot内存储的表情包 ❓

---

<br>

><br>
>
>打开你的MongoDB Compass软件,你会在左上角看到这样的一个界面:
>
><br>
>
><img src="/images/MONGO_DB_0.png" width=250>
>
><br>
>
>点击 "CONNECT" 之后,点击展开 MegBot 标签栏
>
><br>
>
><img src="/images/MONGO_DB_1.png" width=250>
>
><br>
>
>点进 "emoji" 再点击 "DELETE" 删掉所有条目,如图所示
>
><br>
>
><img src="/images/MONGO_DB_2.png" width=450>
>
><br>
Expand All @@ -116,34 +61,54 @@
>MaiMBot的所有图片均储存在 `data` 文件夹内,按类型分为 `data/emoji` 和 `data/image`
>
>在删除服务器数据时不要忘记清空这些图片。
>
><br>

<br>

- 为什么我连接不上MongoDB服务器 ❓

---

- 为什么我连接不上MongoDB服务器 ❓

><br>
>
>这个问题比较复杂,但是你可以按照下面的步骤检查,看看具体是什么问题
>
><br>
>
> 1. 检查有没有把 mongod.exe 所在的目录添加到 path。 具体可参照
>
><br>
>
>&emsp;&emsp;[CSDN-windows10设置环境变量Path详细步骤](https://blog.csdn.net/flame_007/article/details/106401215)
>
><br>
>
>&emsp;&emsp;**需要往path里填入的是 exe 所在的完整目录!不带 exe 本体**
>
><br>
>
> 2. 待完成
>
><br>
> 2. 环境变量添加完之后,可以按下`WIN+R`,在弹出的小框中输入`powershell`,回车,进入到powershell界面后,输入`mongod --version`如果有输出信息,就说明你的环境变量添加成功了。
> 接下来,直接输入`mongod --port 27017`命令(`--port`指定了端口,方便在可视化界面中连接),如果连不上,很大可能会出现
>```shell
>"error":"NonExistentPath: Data directory \\data\\db not found. Create the missing directory or specify another path using (1) the --dbpath command line option, or (2) by adding the 'storage.dbPath' option in the configuration file."
>```
>这是因为你的C盘下没有`data\db`文件夹,mongo不知道将数据库文件存放在哪,不过不建议在C盘中添加,因为这样你的C盘负担会很大,可以通过`mongod --dbpath=PATH --port 27017`来执行,将`PATH`替换成你的自定义文件夹,但是不要放在mongodb的bin文件夹下!例如,你可以在D盘中创建一个mongodata文件夹,然后命令这样写
>```shell
>mongod --dbpath=D:\mongodata --port 27017
>```
>
>如果还是不行,有可能是因为你的27017端口被占用了
>
>通过命令
>```shell
> netstat -ano | findstr :27017
>```
>可以查看当前端口是否被占用,如果有输出,其一般的格式是这样的
>```shell
> TCP 127.0.0.1:27017 0.0.0.0:0 LISTENING 5764
> TCP 127.0.0.1:27017 127.0.0.1:63387 ESTABLISHED 5764
> TCP 127.0.0.1:27017 127.0.0.1:63388 ESTABLISHED 5764
> TCP 127.0.0.1:27017 127.0.0.1:63389 ESTABLISHED 5764
>```
>最后那个数字就是PID,通过以下命令查看是哪些进程正在占用
>```shell
>tasklist /FI "PID eq 5764"
>```
>如果是无关紧要的进程,可以通过`taskkill`命令关闭掉它,例如`Taskkill /F /PID 5764`
>
>如果你对命令行实在不熟悉,可以通过`Ctrl+Shift+Esc`调出任务管理器,在搜索框中输入PID,也可以找到相应的进程。
>如果你害怕关掉重要进程,可以修改`.env.dev`中的`MONGODB_PORT`为其它值,并在启动时同时修改`--port`参数为一样的值
>```ini
>MONGODB_HOST=127.0.0.1
>MONGODB_PORT=27017 #修改这里
>DATABASE_NAME=MegBot
>```