Merge pull request #11 from anka-afk/v2

增加部分faq

Author: anka-afk

dev/core/overall_operation_process.md

@@ -96,11 +96,6 @@ async def _process_stages(self, event: AstrMessageEvent, from_stage=0):
             if event.is_stopped():
                 logger.debug(f"阶段 {stage.__class__.__name__} 已终止事件传播。")
                 break
-
-        # 检查整个阶段是否完成后事件是否被停止
-        if event.is_stopped():
-            logger.debug(f"阶段 {stage.__class__.__name__} 已终止事件传播。")
-            break
 ```
 
 这似乎很难理解, 这里提供一个示例进行解释:

faq.md

@@ -1,27 +1,57 @@
 # FAQ
 
-### 插件安装不上
+## 管理面板相关
 
-1. 插件通过 github 安装，在国内访问 github 确实有时候连不上。可以挂代理，然后进 其他配置->HTTP代理 设置代理。或者直接下载插件压缩包，然后上传。
+### 当管理面板打开时遇到 404 错误
 
-### 机器人在群聊无法聊天
+在 [release](https://github.com/Soulter/AstrBot/releases) 页面下载 `dist.zip`，解压拖到 `AstrBot/data` 下。还不行请重启电脑（来自群里的反馈）
 
-1. 群聊情况下，由于防止消息泛滥，不会对每条监听到的消息都回复，请尝试 @ 机器人或者使用唤醒词来聊天，比如默认的 `/`，输入 `/你好`。 
+### 管理面板的密码忘记了
 
-### 没有权限操作管理员指令
+如果你忘记了 AstrBot 的管理面板的密码, 你可以在`AstrBot/data/cmd_config.json`配置文件中找到`"dashboard"`字段进行修改,
+其中`"username"`是你的用户名, `"password"`是你的密码, 经过 md5 加密。
 
-1. /reset, /persona, /dashboard_update, /op, /deop, /wl, /dewl 是默认的管理员指令。可以通过 /sid 指令得到用户的ID，然后在配置->其他配置中添加到管理员ID名单中。
+如果想要修改账号密码, 你可以这样做:
 
-### 当管理面板打开时遇到 404 错误
+1. 修改`"username"`字段, 注意保留`""`, 如果不想修改用户名, 可以不修改
+2. 进入网站:在线 md5 生成
+3. 在转换前文本框输入你的新密码
+4. 选择 MD5 加密(32 位), 请确认选择 32 位选项
+5. 将转换后的字符粘贴至配置文件, 注意保留`""`
+
+## Bot 本体相关
+
+### 机器人在群聊无法聊天
+
+1. 群聊情况下，由于防止消息泛滥，不会对每条监听到的消息都回复，请尝试 @ 机器人或者使用唤醒词来聊天，比如默认的 `/`，输入 `/你好`。
 
-在 [release](https://github.com/Soulter/AstrBot/releases) 页面下载dist.zip，解压拖到 AstrBot/data 下。还不行请重启电脑（来自群里的反馈）
+### 没有权限操作管理员指令
+
+1. `/reset, /persona, /dashboard_update, /op, /deop, /wl, /dewl` 是默认的管理员指令。可以通过 `/sid` 指令得到用户的 ID，然后在配置->其他配置中添加到管理员 ID 名单中。
 
 ### 本地渲染 Markdown 图片(t2i)时中文乱码
 
 可以自定义字体。详见 -> [#957](https://github.com/Soulter/AstrBot/issues/957#issuecomment-2749981802)
 
 推荐 [Maple Mono](https://github.com/subframe7536/maple-font) 字体。
 
+### API 返回的 completion 无法解析 & llm 返回`<empty content>`
+
+这是由于供应商的 API 返回了空文本, 尝试以下步骤:
+
+1. 检查 API-key 是否仍然有效
+2. 检查是否达到 API 调用限制或配额
+3. 检查网络连接
+4. 尝试 reset
+5. 降低最大对话次数设置
+6. 切换使用同一供应商的其他模型/不同供应商的模型
+
+## 插件相关
+
+### 插件安装不上
+
+1. 插件通过 github 安装，在国内访问 github 确实有时候连不上。可以挂代理，然后进 其他配置->HTTP 代理 设置代理。或者直接下载插件压缩包，然后上传。
+
 ### 安装插件后报错 `No module named 'xxx'`
 
 ![](source/images/faq/image.png)
@@ -38,4 +68,4 @@
 
 ![](source/images/faq/image-1.png)
 
-如果发现插件作者没有填写 `requirements.txt` 文件，请在插件仓库提交 issue，提醒作者补充。
+如果发现插件作者没有填写 `requirements.txt` 文件，请在插件仓库提交 issue，提醒作者补充。