Eridanus
_🎊 基于 OneBot 协议的多功能bot兼python开发框架 🎊_
部署
文档 文档 备用站1 文档 备用站2如使用快捷部署部署失败，请参照文档部署。
交流
QQ群：1050663831 点击加入 telegram群组：点击加入如果您对此项目的开发工作感兴趣，欢迎加入我们🎉。
更新计划
- [x] 接入telegram
- [x] Android 悬浮窗助理 App (Eridanus-Android)
架构与多平台接入 (Architecture & Multi-Platform Hub)
Eridanus 采用基于 OneBot v11 协议标准与事件驱动中心 Hub 的多端统一桥接架构：无需重复启动多份 Bot 核心插件，通过 WebUI 服务端作为 WebSocket Hub 中转，实现 QQ、WebUI、Telegram 以及移动端（如 Android 悬浮窗应用）的无缝接入与共享上下文。
核心架构示意图
┌───────────────────────┐ ┌────────────────────────┐
│ QQ (OneBot v11) │ │ Telegram Bot API │
│ (Snowluma /LLOneBot等) │ │ (长轮询 / sendDocument) │
└───────────┬───────────┘ └───────────┬────────────┘
│ │
(正向/反向 WS) (双向事件与消息转换)
│ │
▼ ▼
┌───────────────────────────────────────────────────────────┐
│ Eridanus Multi-Platform WebSocket Hub │
│ (web/server_new.py) │
│ │
│ * 虚拟路由分发 (Virtual Group Router): │
│ - 真实 QQ 群: 原样透传 │
│ - WebUI 模拟群: 879886836 │
│ - Telegram 群/频道: 11111{chat_id} │
│ - Android 悬浮端: 222222 │
│ │
│ * 来源标记字段 (adapter_source): │
│ - qq / webui / telegram / android │
│ - 支持针对非 QQ 平台关闭图片混淆/灰度与 PDF 加密等限制 │
└─────────────────────────────┬─────────────────────────────┘
│
(OneBot v11 内部总线)
▼
┌───────────────────────────────────────────────────────────┐
│ Eridanus Bot Core & Plugins │
│ │
│ * 插件生态: Mai_Reply / 资源搜索 / 屏幕视觉建议 / 数据库 │
│ * 记忆共享: 跨平台通过 /bind <qq_id> 共享相同用户上下文 │
└───────────────────────────────────────────────────────────┘
▲
│
┌──────────────────┴──────────────────┐
│ │
┌──────────┴──────────┐ ┌──────────┴──────────┐
│ WebUI 前端网页 │ │ Android 悬浮窗应用 │
│ (Vue / WebSocket) │ │ (屏幕识别/翻译/建议) │
└─────────────────────┘ └─────────────────────┘多端协同与路由设计
- 统一适配与无缝透传：
adapter_source（取值 qq、webui、telegram、android），供业务插件优雅识别终端来源。
- 免二次启动插件 (Single Instance Multi-Client)：
- Telegram 增强能力：
/bind 即可将 Telegram 会话与对应的 QQ 用户 ID 关联，实现跨端上下文与长期记忆互通。
派生项目
- Achernar cpolar隧道本地反向代理，kaggle自动切换账号运行指定脚本。(用于在kaggle持久化部署ai绘画等服务)
- vits api 本地部署vits语音合成服务端，已打包。
- Eridanus-dep 一个轻量化、易于上手的onebot v11 python SDK。
- material-dashboard 基于原版material-dashboard项目修改而成的Eridanus webui。
- Eridanus-Android Eridanus Android 悬浮窗副驾驶与多模态屏幕翻译助理。
开源协议
Eridanus is licensed under CC BY-NC-SA 4.0 . Everyone is FREE to access, use, modify, and redistribute this project under the same license, but commercial use is strictly prohibited. Unauthorized commercial usage of Eridanus is explicitly forbidden under this license. If you like the project, please give it a star!
Eridanus 采用 CC BY-NC-SA 4.0 许可证。任何人均可免费获取、使用、修改，并以相同协议重新分发本项目，但仅限于非商业用途。 未经授权的任何商业用途均被禁止。 如果你喜欢这个项目，请给我们一个 Star！
Thanks to all contributors for their efforts
Live2D 模型作者：【免费模型】这么可爱的小狗免费带回家！