6b9bdeeff2
* 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): 为跨平台消息处理添加异常捕获和日志
46 lines
2.4 KiB
Markdown
46 lines
2.4 KiB
Markdown
# NEO Bot 开发文档
|
|
|
|
欢迎来到 NEO Bot Framework 开发文档！
|
|
|
|
这是一个现代化的 Python QQ 机器人框架，基于 OneBot v11 协议，采用异步架构和性能优化技术。无论你是想快速搭建机器人，还是深入了解框架设计，这份文档都能帮助你。
|
|
|
|
|
|
## 📖 文档导览
|
|
|
|
### 🚀 快速开始
|
|
* [快速上手](./getting-started.md) - 5分钟搭建开发环境
|
|
* [项目结构](./project-structure.md) - 了解代码组织方式
|
|
* [生产部署](./deployment.md) - 将Bot部署到服务器
|
|
|
|
### 💡 核心概念
|
|
* [架构设计](./core-concepts/architecture.md) - 了解框架的设计理念
|
|
* [性能优化](./core-concepts/performance.md) - JIT、Mypyc、页面池等优化技术
|
|
* [事件流程](./core-concepts/event-flow.md) - 一条消息从接收到回复的完整流程
|
|
* [核心管理器](./core-concepts/singleton-managers.md) - matcher、权限管理、浏览器池、数据库等
|
|
* [Redis原子操作](./core-concepts/redis-atomic-operations.md) - 权限管理的分布式实现
|
|
* [多线程架构](./core-concepts/multithreading.md) - 线程池和线程安全设计
|
|
* [错误处理](./core-concepts/error-handling.md) - 异常处理和错误码体系
|
|
|
|
### 🔌 API 参考
|
|
* [API 总览](./api/index.md) - API 调用方式和快速导航
|
|
* [消息 API](./api/message.md) - 发送、撤回、转发消息
|
|
* [群组 API](./api/group.md) - 群管理、禁言、踢人等
|
|
* [好友 API](./api/friend.md) - 好友列表、点赞等
|
|
* [账号 API](./api/account.md) - 机器人自身信息获取
|
|
* [媒体 API](./api/media.md) - 图片、语音、视频处理
|
|
|
|
### 🌟 特色功能
|
|
* **多平台互通** - 支持 Discord 与 QQ 频道的跨平台消息互通
|
|
* **本地文件服务** - 内置轻量级 HTTP 文件服务器，方便传输大文件和媒体
|
|
* **多数据库支持** - 同时支持 Redis 缓存和 MySQL 持久化存储
|
|
* **反向 WebSocket** - 支持 OneBot 客户端主动连接 Bot
|
|
|
|
### 📚 插件开发
|
|
* [插件入门](./plugin-development/index.md) - 写你的第一个插件
|
|
* [指令处理](./plugin-development/command-handling.md) - 参数解析、权限控制等
|
|
* [最佳实践](./plugin-development/best-practices.md) - 避免常见的坑
|
|
* [插件案例：状态监控](./plugin-development/status-plugin.md) - 深入学习复杂插件实现
|
|
|
|
### 📋 开发规范
|
|
* [开发规范](./development-standards.md) - 代码风格、异步编程、错误处理规范
|