Dev (#78)

* fix(discord): 修复 WebSocket 连接检测并增强跨平台文件处理

修复 Discord WebSocket 连接检测逻辑，使用正确的属性检查连接状态
为跨平台消息处理添加文件类型支持，并增加详细的调试日志
优化附件处理逻辑，确保所有文件类型都能正确识别和转发

* feat(跨平台): 优化消息处理并添加纯文本提取功能

添加 extract_text_only 函数过滤非文本标记
修改翻译逻辑仅处理纯文本内容
完善附件处理和消息内容拼接
修复仅包含表情时的消息处理问题

* refactor(discord-cross): 使用模块专用日志记录器替换全局日志记录器

将各模块中的全局日志记录器替换为模块专用日志记录器，以提供更清晰的日志来源标识
同时在适配器中添加会话状态检查和重连机制，提升消息发送的可靠性

* feat(翻译): 改进翻译功能，同时显示原文和译文

修改翻译功能，不再替换原文而是同时显示原文和翻译内容，方便用户对照
更新 DeepSeek API 配置为官方地址和模型
优化 Discord 适配器的重连逻辑，直接关闭 WebSocket 触发重连
修复 Discord 频道 ID 转换逻辑，简化处理流程

* feat(cross-platform): 添加跨平台功能支持及配置优化

- 新增跨平台配置模型和全局配置支持
- 优化 Discord 适配器的连接管理和错误处理
- 添加 watchdog 和 discord.py 依赖
- 创建 DeepSeek API 配置文档
- 移除重复的同步帮助图片代码
- 改进跨平台插件配置加载逻辑

* fix(jrcd): 修正群组ID检查条件

删除不再使用的示例插件文件

* feat: 改进配置加载逻辑并更新项目配置

当配置文件不存在时自动生成示例配置
添加pyproject.toml作为项目构建配置
更新.gitignore忽略更多文件类型
删除不再使用的反向WebSocket示例文件

* docs: 更新架构文档和项目结构说明

添加反向WebSocket连接模式说明
补充核心管理器文档
更新项目结构文件
在文档首页添加特色功能说明

* fix(discord): 修复WebSocket连接检查并添加错误日志

refactor(config): 更新配置文件的网络和认证信息

feat(cross-platform): 为跨平台消息处理添加异常捕获和日志

docs/core-concepts/architecture.md

@@ -47,9 +47,12 @@ python setup_mypyc.py build_ext --inplace
 
 ## 2. 连接架构
 
-### 正向 WebSocket 连接
+### WebSocket 连接模式
 
-NEO Bot 采用**正向 WebSocket 连接**模式：Bot 主动连接 OneBot 实现（如 NapCatQQ）。
+NEO Bot 支持两种 WebSocket 连接模式，可根据需求在 `config.toml` 中配置：
+
+#### 1. 正向 WebSocket 连接 (默认)
+Bot 主动连接 OneBot 实现（如 NapCatQQ）。
 
 **流程**：
 
@@ -63,6 +66,23 @@ Bot 启动 → 连接到 NapCatQQ (ws://127.0.0.1:3001)
     调用 API 回复
 ```
 
+#### 2. 反向 WebSocket 连接
+OneBot 客户端主动连接 Bot 提供的 WebSocket 服务。
+
+**流程**：
+
+```
+Bot 启动反向 WS 服务 (监听 0.0.0.0:3002)
+        ↓
+NapCatQQ 主动连接到 Bot
+        ↓
+    监听消息事件
+        ↓
+    分发到处理器
+        ↓
+    调用 API 回复
+```
+
 ## 3. 资源管理架构
 
 ### 单例管理器

docs/core-concepts/singleton-managers.md

@@ -65,6 +65,34 @@
     *   **记性好**: 模板用一次就记住，下次直接用缓存。
     *   **自动借还**: 它会自动找 `BrowserManager` 借页面，你只管 `render_template` 就行。
 
+### 8. `BotManager` (`bot_manager`)
+
+*   **怎么找**: `from core.managers.bot_manager import bot_manager`
+*   **管啥**:
+    *   **Bot 实例管理**: 统一管理 Bot 实例，方便在任何地方获取当前运行的 Bot。
+    *   **生命周期**: 协助管理 Bot 的启动和关闭流程。
+
+### 9. `MysqlManager` (`mysql_manager`)
+
+*   **怎么找**: `from core.managers.mysql_manager import mysql_manager`
+*   **管啥**:
+    *   **数据库连接**: 管理与 MySQL 数据库的异步连接池。
+    *   **数据持久化**: 提供执行 SQL 语句的接口，用于需要长期保存的数据。
+
+### 10. `ReverseWsManager` (`reverse_ws_manager`)
+
+*   **怎么找**: `from core.managers.reverse_ws_manager import reverse_ws_manager`
+*   **管啥**:
+    *   **反向 WS 服务**: 启动并管理反向 WebSocket 服务器，允许 OneBot 客户端主动连接 Bot。
+    *   **连接管理**: 处理客户端的连接、断开和消息接收。
+
+### 11. `ThreadManager` (`thread_manager`)
+
+*   **怎么找**: `from core.managers.thread_manager import thread_manager`
+*   **管啥**:
+    *   **线程池管理**: 提供全局的线程池执行器，用于执行阻塞的同步任务。
+    *   **异步桥接**: 方便地将同步函数转换为异步调用，避免阻塞事件循环。
+
 ## 咋用？
 
 `import`